> ## Documentation Index > Fetch the complete documentation index at: https://developers.askparable.com/llms.txt > Use this file to discover all available pages before exploring further. # Set skipped apps > Replaces the list of apps that Pulse skips on every Mac in this Workspace. Give each app as a bundle ID prefix, such as com.tinyspeck.slackmacgap. Pulse records only which skipped app was in front and for how long. Macs apply the change within six hours. ## Access This operation needs a Parable token. An MCP token cannot call it. See [Authentication](/getting-started/authentication.md) 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. ## OpenAPI ````yaml /api-reference/openapi.json put /api/devices/capture-policy openapi: 3.0.3 info: description: >- Use the Workspace API to work with artifacts, connectors, Parables, and account resources. title: Workspace API version: v2026.10.22.1 servers: [] security: [] paths: /api/devices/capture-policy: put: tags: - Devices summary: Set skipped apps description: >- Replaces the list of apps that Pulse skips on every Mac in this Workspace. Give each app as a bundle ID prefix, such as com.tinyspeck.slackmacgap. Pulse records only which skipped app was in front and for how long. Macs apply the change within six hours. operationId: DevicesSetPulseCapturePolicyHandler parameters: - description: >- Workspace slug. Overrides subdomain-based workspace resolution when provided. in: header name: X-Tenant required: false schema: example: acme type: string - description: Optional request correlation ID echoed back in the response. in: header name: X-Request-ID required: false schema: example: 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SetPulseCapturePolicyInput' required: true responses: '200': content: application/json: schema: properties: data: $ref: '#/components/schemas/PulseCapturePolicy' links: $ref: '#/components/schemas/ResponseLinks' meta: $ref: '#/components/schemas/ResponseMeta' required: - data - meta type: object description: Successful response headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' '400': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' description: >- The request is not valid. `detail` says why. A value that breaks a field rule gives the code `WA-VL-001` and an `errors` member that names each field. headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' '401': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' description: The token is missing, malformed, revoked, or expired. headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' '403': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' description: >- The token cannot make this request. For example, the roles of its owner do not allow the operation. headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' '500': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' description: The request failed on the server. headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' security: - bearerAuth: [] x-codeSamples: - label: TypeScript SDK lang: typescript source: >- import { WebApiSDK } from "@parable-platform/web-api-sdk"; import type { SetPulseCapturePolicyInput } from "@parable-platform/web-api-types"; const sdk = new WebApiSDK({ baseUrl: process.env.PARABLE_API_URL!, auth: { token: process.env.PARABLE_API_TOKEN! }, requestInterceptor: (config) => ({ ...config, headers: { ...config.headers, "X-Tenant": process.env.PARABLE_WORKSPACE! }, }), }); const input: SetPulseCapturePolicyInput = JSON.parse(`{ "skippedBundleIdPrefixes": [] }`); const result = await sdk.devices.setPulseCapturePolicy( input ); - label: Python SDK lang: python source: |- import json import os from parable_types_web_api import SetPulseCapturePolicyInput from parable_web_api_sdk import ClientConfig, WebApiSDK sdk = WebApiSDK( ClientConfig( base_url=os.environ["PARABLE_API_URL"], auth_token=os.environ["PARABLE_API_TOKEN"], default_headers={"X-Tenant": os.environ["PARABLE_WORKSPACE"]}, ) ) input_data = SetPulseCapturePolicyInput.model_validate( json.loads("{\"skippedBundleIdPrefixes\":[]}"), ) result = sdk.devices.set_pulse_capture_policy(input_data) - label: Rust SDK lang: rust source: >- use parable_web_api_sdk::{types, ClientConfig, RequestOptions, WebApiSdk}; let sdk = WebApiSdk::new(ClientConfig::with_base_url( std::env::var("PARABLE_API_URL")?, Some(std::env::var("PARABLE_API_TOKEN")?), None, ))?; let options = RequestOptions::with_header("X-Tenant", std::env::var("PARABLE_WORKSPACE")?, None, None); let input: types::SetPulseCapturePolicyInput = serde_json::from_value( serde_json::json!({ "skippedBundleIdPrefixes": [] }), )?; let result = sdk.devices.set_pulse_capture_policy( input, Some(&options) ).await?; - label: Go SDK lang: go source: "sdk, err := webapisdk.New(webapisdk.SDKConfig{\n\tBaseURL: os.Getenv(\"PARABLE_API_URL\"),\n\tAuth: &webapisdk.AuthConfig{Token: os.Getenv(\"PARABLE_API_TOKEN\")},\n\tRequestInterceptor: func(ctx context.Context, req *http.Request) error {\n\t\treq.Header.Set(\"X-Tenant\", os.Getenv(\"PARABLE_WORKSPACE\"))\n\t\treturn nil\n\t},\n})\nif err != nil {\n\treturn err\n}\n\nvar input webapitypes.SetPulseCapturePolicyInput\nif err := json.Unmarshal([]byte(`{\"skippedBundleIdPrefixes\":[]}`), &input); err != nil {\n\treturn err\n}\nresult, err := sdk.DevicesNamespace.SetPulseCapturePolicy(ctx, input)" components: schemas: SetPulseCapturePolicyInput: description: Replaces a Workspace's Pulse capture policy. properties: skippedBundleIdPrefixes: description: >- 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. items: maxLength: 255 pattern: ^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)+$ type: string maxItems: 200 type: array required: - skippedBundleIdPrefixes type: object PulseCapturePolicy: description: >- 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. properties: skippedBundleIdPrefixes: description: >- macOS bundle ID prefixes, lower case and sorted. An entry skips every app whose bundle ID starts with it: `com.tinyspeck.slackmacgap` skips Slack, and `com.microsoft` skips every Microsoft app. items: type: string type: array required: - skippedBundleIdPrefixes type: object ResponseLinks: properties: first: nullable: true type: string last: nullable: true type: string next: nullable: true type: string prev: nullable: true type: string type: object ResponseMeta: properties: requestId: description: Unique identifier for the request type: string totalCount: description: Total count of items for paginated responses nullable: true type: integer required: - requestId type: object ProblemDetails: description: An error response in the Problem Details format (RFC 9457). properties: code: description: The stable error code, when the problem has one. example: WA-VL-001 type: string detail: description: What went wrong with this request. type: string details: description: >- Structured facts about the refusal, such as the entity or the path it concerns. Only some refusals have it. errors: description: >- The fields or filters that failed validation. Only a validation or filter error has it. requestId: description: >- The ID of the request, when the problem has one. The `X-Request-ID` response header always has it. type: string status: description: The HTTP status code. example: 400 type: integer title: description: A short summary, usually the text of the HTTP status. example: Bad Request type: string type: description: >- The problem type. It is `about:blank`: the status and `code` identify the problem. example: about:blank type: string required: - type - title - status - detail type: object headers: X-Request-ID: description: >- The ID of the request. It is the `X-Request-ID` value that you sent, or an ID that the server made. Give it when you report a problem. schema: type: string securitySchemes: bearerAuth: description: >- 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. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.