Skip to main content
PUT
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

  • HTTP 400: An entry is not a bundle ID prefix, an entry is longer than 255 characters, or the list has more than 200 entries. Give each app as a bundle ID with at least two parts, such as com.example.app, and send at most 200 entries.
  • 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

Replaces a Workspace's Pulse capture policy.

skippedBundleIdPrefixes
string[]
required

The whole list of macOS bundle ID prefixes Pulse skips. An empty list leaves only the built-in protected list. Each entry has at least two dot-separated parts of letters, digits, and hyphens, as a bundle ID does, so a one-part entry such as com cannot skip almost every app. Parable stores the entries in lower case, sorted, with duplicates removed.

Maximum array length: 200
Maximum string length: 255
Pattern: ^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)+$

Response

Successful response

data
object
required

A Workspace's Pulse capture policy: the apps Pulse skips on every Mac of the Workspace. The protected list built into Pulse (password managers, banking, health) always applies too, and this policy cannot remove an app from it. 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