Skip to main content

Applications API

All URIs are relative to http://localhost:1000

MethodHTTP requestDescription
applicationsExternalRelatedGET /applications/external/related/applications/external/related [GET]
applicationsExternalSnapshotGET /applications/external/applications/external [GET]
applicationsRegister - (Deprecated)POST /applications/register/applications/register [POST]
applicationsSessionClose - (Deprecated)POST /applications/session/close/applications/session/close [POST]
applicationsSessionOpen - (Deprecated)POST /applications/session/open/applications/session/open [POST]
applicationsSessionSnapshot - (Deprecated)GET /applications/sessions/{session}/applications/sessions/{session} [GET]
applicationsSnapshotGET /applications/applications [GET]
applicationsSpecificApplicationSnapshotGET /applications/{application}/applications/{application} [GET]
applicationsUsageEngagementInteraction - (Deprecated)POST /applications/usage/engagement/interaction/applications/usage/engagement/interaction [POST] Scoped to Apps
applicationsUsageEngagementKeyboard - (Deprecated)POST /applications/usage/engagement/keyboard/applications/usage/engagement/keyboard [POST] Scoped to Apps
applicationsUsageInstallation - (Deprecated)POST /applications/usage/installation/applications/usage/installation [POST]
postApplicationsUsageUpdated - (Deprecated)POST /applications/usage/updated/applications/usage/updated [POST]

applicationsExternalRelated

DetectedExternalApplications applicationsExternalRelated()

Retrieves a list of external applications installed on the user's machine that have potential integrations with Pieces, including those not yet installed by the user and those anticipated to be supported in the future.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

apiInstance.applicationsExternalRelated().then((data: DetectedExternalApplications) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

This endpoint does not need any parameters.

Return type

DetectedExternalApplications

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json, text/plain

HTTP response details

Status codeDescriptionResponse headers
200OK-
500Internal Server Error-

applicationsExternalSnapshot

DetectedExternalApplications applicationsExternalSnapshot()

Provides a snapshot of all external applications detected on the user's machine, such as Microsoft Teams classic, Google Chat, Obsidian, etc.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

apiInstance.applicationsExternalSnapshot().then((data: DetectedExternalApplications) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

This endpoint does not need any parameters.

Return type

DetectedExternalApplications

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json, text/plain

HTTP response details

Status codeDescriptionResponse headers
200OK-
500Internal Server Error-

applicationsRegister - (Deprecated)

Application applicationsRegister()

Registers a new application within the Pieces ecosystem.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

const body: Pieces.ApplicationsRegisterRequest = {
// Application | This will accept a application. (optional)
application: ,
};

apiInstance.applicationsRegister(body).then((data: Application) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

NameTypeDescriptionNotes
applicationApplicationThis will accept a application.

Return type

Application

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-

applicationsSessionClose - (Deprecated)

Session applicationsSessionClose()

Closes an active session, identified by a session UUID, marking the end of the user's current interaction with the Pieces application.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

const body: Pieces.ApplicationsSessionCloseRequest = {
// string | This will accept a required session uuid. (optional)
body: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
};

apiInstance.applicationsSessionClose(body).then((data: Session) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

NameTypeDescriptionNotes
bodystringThis will accept a required session uuid.

Return type

Session

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-

applicationsSessionOpen - (Deprecated)

Session applicationsSessionOpen()

Initiates a new session, marking the start of a user's interaction with the Pieces application.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

apiInstance.applicationsSessionOpen().then((data: Session) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

This endpoint does not need any parameters.

Return type

Session

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-

applicationsSessionSnapshot - (Deprecated)

Session applicationsSessionSnapshot()

Fetches detailed information about a specific session, identified by a session UUID, including application usage and engagement data.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

const body: Pieces.ApplicationsSessionSnapshotRequest = {
// string | This is a uuid that points to a session.
session: session_example,
};

apiInstance.applicationsSessionSnapshot(body).then((data: Session) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

NameTypeDescriptionNotes
session[string]This is a uuid that points to a session.defaults to undefined

Return type

Session

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-

applicationsSnapshot

Applications applicationsSnapshot()

Retrieves a comprehensive overview of all applications tracked by the Pieces system, including status, version, and engagement metrics.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

apiInstance.applicationsSnapshot().then((data: Applications) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

This endpoint does not need any parameters.

Return type

Applications

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-

applicationsSpecificApplicationSnapshot

Application applicationsSpecificApplicationSnapshot()

Obtains a snapshot with information about a specific application, identified by its UUID.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

const body: Pieces.ApplicationsSpecificApplicationSnapshotRequest = {
// string | This is a uuid that represents an application
application: application_example,
};

apiInstance.applicationsSpecificApplicationSnapshot(body).then((data: Application) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

NameTypeDescriptionNotes
application[string]This is a uuid that represents an applicationdefaults to undefined

Return type

Application

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-

applicationsUsageEngagementInteraction - (Deprecated)

TrackedInteractionEvent applicationsUsageEngagementInteraction()

Records user interaction events within applications, such as clicks or taps, to analyze engagement patterns and user behavior.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

const body: Pieces.ApplicationsUsageEngagementInteractionRequest = {
// SeededTrackedInteractionEvent | (optional)
seededTrackedInteractionEvent: ,
};

apiInstance.applicationsUsageEngagementInteraction(body).then((data: TrackedInteractionEvent) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

NameTypeDescriptionNotes
seededTrackedInteractionEventSeededTrackedInteractionEvent

Return type

TrackedInteractionEvent

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-

applicationsUsageEngagementKeyboard - (Deprecated)

TrackedKeyboardEvent applicationsUsageEngagementKeyboard()

Captures keyboard interaction events, including shortcuts, within applications to monitor user engagement and productivity enhancements.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

const body: Pieces.ApplicationsUsageEngagementKeyboardRequest = {
// SeededTrackedKeyboardEvent | (optional)
seededTrackedKeyboardEvent: ,
};

apiInstance.applicationsUsageEngagementKeyboard(body).then((data: TrackedKeyboardEvent) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

NameTypeDescriptionNotes
seededTrackedKeyboardEventSeededTrackedKeyboardEvent

Return type

TrackedKeyboardEvent

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-

applicationsUsageInstallation - (Deprecated)

applicationsUsageInstallation()

Logs the installation events of the Pieces application.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

const body: Pieces.ApplicationsUsageInstallationRequest = {
// TrackedApplicationInstall | (optional)
trackedApplicationInstall: ,
};

apiInstance.applicationsUsageInstallation(body).then((data: void (empty response body)) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

NameTypeDescriptionNotes
trackedApplicationInstallTrackedApplicationInstall

Return type

void (empty response body)

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

HTTP response details

Status codeDescriptionResponse headers
200OK-

postApplicationsUsageUpdated - (Deprecated)

postApplicationsUsageUpdated()

Tracks updates to the Pieces application, including version changes.

Example

import * as Pieces from '@pieces.app/pieces-os-client'

const configuration = Pieces.Configuration()
const apiInstance = new Pieces.ApplicationsApi(configuration)

const body: Pieces.PostApplicationsUsageUpdatedRequest = {
// TrackedApplicationUpdate | Sending over the previous application version, the current version, and the user. (optional)
trackedApplicationUpdate: ,
};

apiInstance.postApplicationsUsageUpdated(body).then((data: void (empty response body)) => {
console.log('API called successfully. Returned data: ' + data)
}).catch((error: unknown) => console.error(error))

Parameters

NameTypeDescriptionNotes
trackedApplicationUpdateTrackedApplicationUpdateSending over the previous application version, the current version, and the user.

Return type

void (empty response body)

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

HTTP response details

Status codeDescriptionResponse headers
200OK-