Skip to main content
PATCH
Python SDK

Access

This operation needs a Parable token. An MCP token cannot call it. See Authentication for the kinds of token. Your roles must grant tenant.connectors.taps.write.

Errors

  • WA-DEV-011: The skipped app does not exist in this Workspace or was removed. Choose a skipped app that the list returns for this Workspace.
  • WA-DEV-012: Another skipped app of this Workspace has this bundle ID prefix. Edit or remove the skipped app that has this prefix.
  • HTTP 400: The prefix is not a bundle ID prefix or is longer than 255 characters, or the reason is longer than 500 characters. Give the app as a bundle ID with at least two parts, such as com.example.app.
  • HTTP 403: You cannot change Pulse settings in this Workspace. Select a Workspace where you can manage connector taps.

Authorizations

Authorization
string
header
required

A personal access token, which starts with pat_. A Parable token can call each operation that the roles of its owner allow. An MCP token can call only the read operations that are open to agents. A SQL token does not work on this API.

Headers

X-Tenant
string

Workspace slug. Overrides subdomain-based workspace resolution when provided.

Example:

"acme"

X-Request-ID
string<uuid>

Optional request correlation ID echoed back in the response.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

id
string
required

id parameter UUID v4 with automatic base62 encoding for client-facing APIs

Body

application/json

Changes one app that Pulse skips on every device of the Workspace.

bundleIdPrefix
string
required

The app ID prefix to skip, with the same rules as CreatePulseSkippedAppInput.bundleIdPrefix. Parable stores it in lower case.

Maximum string length: 255
Pattern: ^[A-Za-z0-9_-]+(\.[A-Za-z0-9_-]+)+$
reason
string | null

An optional note that says why Pulse skips the app. Leave it out to keep the stored reason. Null, or a note with only white space, removes the stored reason. Parable removes white space at the start and end.

Maximum string length: 500

Response

Successful response

data
object
required

One app that Pulse skips on every Mac of the Workspace, in addition to the protected list built into Pulse (password managers, banking, health). This list cannot remove an app from the protected list. Pulse records which skipped app was in front and for how long, and never its window title, UI tree, or screen text.

meta
object
required