> ## 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.

# Edit a skipped app

> Changes the bundle ID prefix and the reason of an app that Pulse skips on every Mac in this Workspace. Macs apply the change within six hours.

## Access

This operation needs a Parable token. An MCP token cannot call it. See [Authentication](https://developers.askparable.com/getting-started/authentication.md) 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.


## OpenAPI

````yaml /api-reference/openapi.json patch /api/devices/skipped-apps/{id}
openapi: 3.0.3
info:
  description: >-
    Use the Workspace API to work with artifacts, connectors, Parables, and
    account resources.
  title: Workspace API
  version: v2026.11.20.3
servers: []
security: []
paths:
  /api/devices/skipped-apps/{id}:
    patch:
      tags:
        - Devices
      summary: Edit a skipped app
      description: >-
        Changes the bundle ID prefix and the reason of an app that Pulse skips
        on every Mac in this Workspace. Macs apply the change within six hours.
      operationId: DevicesUpdatePulseSkippedAppHandler
      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
        - description: id parameter
          in: path
          name: id
          required: true
          schema:
            description: UUID v4 with automatic base62 encoding for client-facing APIs
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePulseSkippedAppInput'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/PulseSkippedApp'
                  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'
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: The resource that the path names was not found.
          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 { UpdatePulseSkippedAppInput } 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: UpdatePulseSkippedAppInput = JSON.parse(`{
              "bundleIdPrefix": "example"
            }`);

            const result = await sdk.devices.updatePulseSkippedApp(
              "example",
              input
            );
        - label: Python SDK
          lang: python
          source: |-
            import json
            import os

            from parable_types_web_api import UpdatePulseSkippedAppInput
            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 = UpdatePulseSkippedAppInput.model_validate(
                json.loads("{\"bundleIdPrefix\":\"example\"}"),
            )
            result = sdk.devices.update_pulse_skipped_app('example', 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::UpdatePulseSkippedAppInput =
            serde_json::from_value(
                serde_json::json!({
              "bundleIdPrefix": "example"
            }),

            )?;

            let result = sdk.devices.update_pulse_skipped_app(
                serde_json::from_value(serde_json::json!("example"))?,
                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.UpdatePulseSkippedAppInput\nif err := json.Unmarshal([]byte(`{\"bundleIdPrefix\":\"example\"}`), &input); err != nil {\n\treturn err\n}\nresult, err := sdk.DevicesNamespace.UpdatePulseSkippedApp(ctx, \"example\", input)"
components:
  schemas:
    UpdatePulseSkippedAppInput:
      description: Changes one app that Pulse skips on every device of the Workspace.
      properties:
        bundleIdPrefix:
          description: >-
            The app ID prefix to skip, with the same rules as

            CreatePulseSkippedAppInput.bundleIdPrefix. Parable stores it in
            lower

            case.
          maxLength: 255
          pattern: ^[A-Za-z0-9_-]+(\.[A-Za-z0-9_-]+)+$
          type: string
        reason:
          description: >-
            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.
          maxLength: 500
          nullable: true
          type: string
      required:
        - bundleIdPrefix
      type: object
    PulseSkippedApp:
      description: >-
        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.
      properties:
        bundleIdPrefix:
          description: >-
            A macOS bundle ID prefix, in lower case. Pulse skips every app whose

            bundle ID starts with it: `com.tinyspeck.slackmacgap` skips Slack,
            and

            `com.microsoft` skips every Microsoft app.
          type: string
        createdAt:
          description: >-
            ISO8601 datetime string. Epoch wire values keep this scalar and
            declare x-temporal-format (unix, unix_millis, unix_micros,
            unix_nanos) on the property; the unit is never guessed from digit
            count.
          format: date-time
          type: string
        createdBy:
          description: The person who added the app.
          pattern: ^[0-9A-Za-z]{1,22}$
          type: string
        createdByEmail:
          description: |-
            The email of the person who added the app. Null under the same
            conditions as createdByName.
          format: email
          maxLength: 255
          nullable: true
          type: string
        createdByName:
          description: >-
            The name of the person who added the app. Null when Parable has no
            user

            for createdBy, such as for an app moved from the earlier list.
          maxLength: 80
          minLength: 2
          nullable: true
          type: string
        id:
          description: UUID v4 with automatic base62 encoding for client-facing APIs
          pattern: >-
            ^([0-9A-Za-z]{1,22}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
          type: string
        reason:
          description: Why the admin skips the app. Null when no reason was given.
          nullable: true
          type: string
        updatedAt:
          description: >-
            ISO8601 datetime string. Epoch wire values keep this scalar and
            declare x-temporal-format (unix, unix_millis, unix_micros,
            unix_nanos) on the property; the unit is never guessed from digit
            count.
          format: date-time
          type: string
        updatedBy:
          description: The person who last changed the app.
          pattern: ^[0-9A-Za-z]{1,22}$
          type: string
        updatedByEmail:
          description: >-
            The email of the person who last changed the app. Null under the
            same

            conditions as updatedByName.
          format: email
          maxLength: 255
          nullable: true
          type: string
        updatedByName:
          description: >-
            The name of the person who last changed the app. Null when Parable
            has

            no user for updatedBy.
          maxLength: 80
          minLength: 2
          nullable: true
          type: string
      required:
        - id
        - bundleIdPrefix
        - createdAt
        - createdBy
        - updatedAt
        - updatedBy
      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.