Prisma

Prisma Integrations API

Operations for managing third-party integrations

Documentation GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/integrations List integrations filtered by workspace · Get list of integrations #

Ask an LLM

“Which integrations are connected to a workspace?”

“Can I list integrations by passing the workspace as a filter?”

Tell an agent

List integrations filtered to workspace {workspaceId}.

Show {limit} integrations for workspace filter {workspaceId}.

GET /v1/integrations/{id} Get an integration by ID · Get integration by ID #

Ask an LLM

“What details are available for a single integration?”

“How do I look up one integration by its ID?”

Tell an agent

Get integration {id}.

Show the details of integration {id}.

DELETE /v1/integrations/{id} Revoke an integration's tokens by ID · Delete integration #

Ask an LLM

“Can I revoke an integration's tokens using its integration ID?”

“What does deleting an integration actually revoke?”

Tell an agent destructive · confirm first

Delete integration {id}.

Revoke the tokens of integration {id}.

GET /v1/workspaces/{workspaceId}/integrations List a workspace's integrations · Get list of integrations #

Ask an LLM

“What integrations does my workspace have, browsing from the workspace itself?”

“Can I page through the integrations under one workspace?”

Tell an agent

List the integrations under workspace {workspaceId}.

Page through workspace {workspaceId}'s integrations starting at {cursor}.

DELETE /v1/workspaces/{workspaceId}/integrations/{clientId} Revoke integration tokens by client ID · Revoke integration tokens #

Ask an LLM

“How do I revoke an integration's tokens when I only know its client ID?”

“Can I cut off an OAuth client's access to one workspace?”

Tell an agent destructive · confirm first

Revoke tokens for client {clientId} in workspace {workspaceId}.

Remove client {clientId}'s integration from {workspaceId}.

GET /integrations List configured third-party integrations · Prisma List configured integrations #

Ask an LLM

“Which third-party integrations are configured for my current project?”

“Is there a quick list of every third-party service I've hooked up?”

Tell an agent

List the third-party integrations configured here.

Show every configured integration for the current project.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/prisma:prisma-integrations-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Prisma Integrations API
  version: '1.0'
  description: 'Operations tagged Integrations across 2 of this provider''s published API definitions: prisma-postgres-management-api-openapi.json, prisma-postgres-management-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.prisma.io
- url: https://api.prisma.io/v1
  description: Prisma Management API production server
tags:
- name: Integrations
paths:
  /v1/integrations:
    get:
      responses:
        '200':
          description: Returned the integrations for the given workspace.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        url:
                          type: string
                          format: uri
                        createdAt:
                          type: string
                          format: date-time
                        scopes:
                          type: array
                          items:
                            type: string
                        client:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            createdAt:
                              type: string
                              format: date-time
                          required:
                          - id
                          - name
                          - createdAt
                        createdByUser:
                          type: object
                          properties:
                            id:
                              type: string
                            email:
                              type: string
                            displayName:
                              type:
                              - string
                              - 'null'
                          required:
                          - id
                          - email
                          - displayName
                      required:
                      - id
                      - url
                      - createdAt
                      - scopes
                      - client
                      - createdByUser
                  pagination:
                    type: object
                    properties:
                      nextCursor:
                        type:
                        - string
                        - 'null'
                        description: Next cursor to continue pagination
                      hasMore:
                        type: boolean
                        description: Whether there are more items to paginate
                    required:
                    - nextCursor
                    - hasMore
                required:
                - data
                - pagination
        '401':
          description: Missing or invalid authorization token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      hint:
                        type: string
                    required:
                    - code
                    - message
                required:
                - error
      operationId: getV1Integrations
      tags:
      - Integrations
      parameters:
      - in: query
        name: cursor
        schema:
          type:
          - string
          - 'null'
          description: Cursor for pagination
        required: false
      - in: query
        name: limit
        schema:
          type: number
          default: 100
          description: Limit for pagination
        required: false
      - in: query
        name: workspaceId
        schema:
          type: string
          pattern: ^(wksp_)?([cC][^\s-]{8,}|[a-z0-9]+)$
        required: true
      summary: Get list of integrations
      description: Returns integrations filtered by workspace ID.
      security:
      - OAuth2:
        - workspace:admin
        - offline_access
      - Bearer: []
    servers:
    - url: https://api.prisma.io
  /v1/integrations/{id}:
    get:
      responses:
        '200':
          description: Returned the integration.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      url:
                        type: string
                        format: uri
                      createdAt:
                        type: string
                        format: date-time
                      scopes:
                        type: array
                        items:
                          type: string
                      client:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          createdAt:
                            type: string
                            format: date-time
                        required:
                        - id
                        - name
                        - createdAt
                      createdByUser:
                        type: object
                        properties:
                          id:
                            type: string
                          email:
                            type: string
                          displayName:
                            type:
                            - string
                            - 'null'
                        required:
                        - id
                        - email
                        - displayName
                    required:
                    - id
                    - url
                    - createdAt
                    - scopes
                    - client
                    - createdByUser
                required:
                - data
        '401':
          description: Missing or invalid authorization token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      hint:
                        type: string
                    required:
                    - code
                    - message
                required:
                - error
        '404':
          description: Integration with the given ID was not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      hint:
                        type: string
                    required:
                    - code
                    - message
                required:
                - error
      operationId: getV1IntegrationsById
      tags:
      - Integrations
      parameters:
      - in: path
        name: id
        schema:
          type: string
          pattern: ^(itgr_)?([cC][^\s-]{8,}|[a-z0-9]+)$
        required: true
      summary: Get integration by ID
      description: Returns a single integration by its ID.
      security:
      - OAuth2:
        - workspace:admin
        - offline_access
      - Bearer: []
    delete:
      responses:
        '204':
          description: Revoked the integration tokens.
        '401':
          description: Missing or invalid authorization token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      hint:
                        type: string
                    required:
                    - code
                    - message
                required:
                - error
        '404':
          description: Integration with the given ID was not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      hint:
                        type: string
                    required:
                    - code
                    - message
                required:
                - error
      operationId: deleteV1IntegrationsById
      tags:
      - Integrations
      parameters:
      - in: path
        name: id
        schema:
          type: string
          pattern: ^(itgr_)?([cC][^\s-]{8,}|[a-z0-9]+)$
        required: true
      summary: Delete integration
      description: Revokes the integration tokens by integration ID.
      security:
      - OAuth2:
        - workspace:admin
        - offline_access
      - Bearer: []
    servers:
    - url: https://api.prisma.io
  /v1/workspaces/{workspaceId}/integrations:
    get:
      responses:
        '200':
          description: Returned the integrations for the given workspace ID.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        url:
                          type: string
                          format: uri
                        createdAt:
                          type: string
                          format: date-time
                        scopes:
                          type: array
                          items:
                            type: string
                        client:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            createdAt:
                              type: string
                              format: date-time
                          required:
                          - id
                          - name
                          - createdAt
                        createdByUser:
                          type: object
                          properties:
                            id:
                              type: string
                            email:
                              type: string
                            displayName:
                              type:
                              - string
                              - 'null'
                          required:
                          - id
                          - email
                          - displayName
                      required:
                      - id
                      - url
                      - createdAt
                      - scopes
                      - client
                      - createdByUser
                  pagination:
                    type: object
                    properties:
                      nextCursor:
                        type:
                        - string
                        - 'null'
                        description: Next cursor to continue pagination
                      hasMore:
                        type: boolean
                        description: Whether there are more items to paginate
                    required:
                    - nextCursor
                    - hasMore
                required:
                - data
                - pagination
        '401':
          description: Missing or invalid authorization token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      hint:
                        type: string
                    required:
                    - code
                    - message
                required:
                - error
        '404':
          description: Workspace with the given ID was not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      hint:
                        type: string
                    required:
                    - code
                    - message
                required:
                - error
      operationId: getV1WorkspacesByWorkspaceIdIntegrations
      tags:
      - Integrations
      parameters:
      - in: path
        name: workspaceId
        schema:
          type: string
          pattern: ^(wksp_)?([cC][^\s-]{8,}|[a-z0-9]+)$
        required: true
      - in: query
        name: cursor
        schema:
          type:
          - string
          - 'null'
          description: Cursor for pagination
      - in: query
        name: limit
        schema:
          type: number
          default: 100
          description: Limit for pagination
      summary: Get list of integrations
      description: Returns integrations for the given workspace.
      security:
      - OAuth2:
        - workspace:admin
        - offline_access
      - Bearer: []
    servers:
    - url: https://api.prisma.io
  /v1/workspaces/{workspaceId}/integrations/{clientId}:
    delete:
      responses:
        '204':
          description: Revoked the integration tokens.
        '401':
          description: Missing or invalid authorization token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      hint:
                        type: string
                    required:
                    - code
                    - message
                required:
                - error
        '404':
          description: Integration with the given client ID was not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      hint:
                        type: string
                    required:
                    - code
                    - message
                required:
                - error
      operationId: deleteV1WorkspacesByWorkspaceIdIntegrationsByClientId
      tags:
      - Integrations
      parameters:
      - in: path
        name: clientId
        schema:
          type: string
          pattern: ^(itgr_)?([cC][^\s-]{8,}|[a-z0-9]+)$
        required: true
      - in: path
        name: workspaceId
        schema:
          type: string
          pattern: ^(wksp_)?([cC][^\s-]{8,}|[a-z0-9]+)$
        required: true
      summary: Revoke integration tokens
      description: Revokes the integration tokens with the given client ID.
      security:
      - OAuth2:
        - workspace:admin
        - offline_access
      - Bearer: []
    servers:
    - url: https://api.prisma.io
  /integrations:
    get:
      operationId: listIntegrations
      summary: Prisma List configured integrations
      description: Retrieves all third-party integrations configured for the current workspace or project.
      tags:
      - Integrations
      responses:
        '200':
          description: Successfully retrieved list of integrations
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Integration'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - bearerAuth: []
    servers:
    - url: https://api.prisma.io/v1
      description: Prisma Management API production server
components:
  responses:
    RateLimited:
      description: Too many requests - rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Authentication is required or the provided credentials are invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: An unexpected error occurred on the server
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Integration:
      type: object
      description: A third-party integration configuration
      properties:
        id:
          type: string
          description: Unique identifier for the integration
        name:
          type: string
          description: Name of the integration
        provider:
          type: string
          description: Integration provider identifier
        status:
          type: string
          description: Current status of the integration
          enum:
          - active
          - inactive
          - error
        createdAt:
          type: string
          format: date-time
          description: Timestamp when the integration was configured
      required:
      - id
      - name
      - provider
      - status
      - createdAt
    Error:
      type: object
      description: Standard error response
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Machine-readable error code
            message:
              type: string
              description: Human-readable error message
            details:
              type: object
              description: Additional error context
              additionalProperties: true
          required:
          - code
          - message
  securitySchemes:
    OAuth2:
      type: oauth2
      description: OAuth2 authentication
      flows:
        authorizationCode:
          authorizationUrl: https://auth.prisma.io/authorize
          tokenUrl: https://auth.prisma.io/token
          refreshUrl: https://auth.prisma.io/token
          scopes:
            workspace:admin: Full access to workspace resources
            offline_access: Offline access
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: OAuth2 token for API authentication
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Authentication via service token or OAuth 2.0 access token. Service tokens are created in the Prisma Console under Settings > Service Tokens. OAuth 2.0 tokens are obtained via the authorization endpoint at https://auth.prisma.io/authorize with token exchange at https://auth.prisma.io/token. PKCE is supported with S256 code challenge method.
externalDocs:
  description: Prisma Postgres Management API Documentation
  url: https://www.prisma.io/docs/postgres/introduction/management-api
x-refined-from:
- prisma-postgres-management-api-openapi.json
- prisma-postgres-management-openapi.yml

Prisma Integrations API

Operations 6

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification