Skip to main content
POST
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-012: This Workspace already skips this bundle ID prefix. Edit the skipped app that has this prefix.
  • WA-DEV-013: This Workspace already skips 200 apps, the most it can skip. Remove a skipped app, or use a shorter prefix that covers several apps.
  • 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"

Body

application/json

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

bundleIdPrefix
string
required

The app ID prefix to skip: a macOS bundle ID prefix, or a Windows app ID prefix such as windows.exe.slack. It has at least two dot-separated parts of letters, digits, hyphens, and underscores, so a one-part entry such as com cannot skip almost every app. A Windows app ID keeps the underscores of its program name. Parable stores the prefix 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. Parable removes white space at the start and end, and stores an empty note as null.

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