> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pomerado.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an integration's reference

> Everything an agent needs to use one integration, as one Markdown document to read or paste into its context: the site, its MCP URL and keyless URL, how each MCP client connects to it, each tool under the name its MCP gives it with what it does, its effect, the login it needs, its input fields and a sample call, and a link to its OpenAPI document. A public integration, or one your team's list holds; an integration key reaches only its own.

**Authentication:** `Authorization: Bearer <token>` with Dashboard session, Pomerado MCP OAuth token, API key, integration API key.

**Permission:** `tools:read`.

**Effect:** Read: changes nothing.

**Errors:** [`invalid_request`](/errors#invalid_request) (400), [`unauthorized`](/errors#unauthorized) (401), [`reauthentication_required`](/errors#reauthentication_required) (401), [`forbidden`](/errors#forbidden) (403), [`not_found`](/errors#not_found) (404), [`internal_error`](/errors#internal_error) (500), [`temporarily_unavailable`](/errors#temporarily_unavailable) (503). Every error has the same [envelope](/errors).


## OpenAPI

````yaml /api-reference/openapi.json get /v1/integrations/{id}/reference
openapi: 3.1.0
info:
  title: Pomerado API
  version: '1'
  description: >-
    Run and build website tools, follow their jobs, and manage logins, API keys
    and webhooks. Authenticate with a Pomerado API key (pom_…), an MCP OAuth
    token or a Dashboard session as a Bearer token.
servers:
  - url: https://api.pomerado.ai
security: []
tags:
  - name: account
    x-group: Account
  - name: api_keys
    x-group: API keys
  - name: connected_apps
    x-group: Connected apps
  - name: usage
    x-group: Usage
  - name: quota
    x-group: Quota
  - name: billing
    x-group: Billing
  - name: integrations
    x-group: Integrations
  - name: connect
    x-group: Connect
  - name: logins
    x-group: Logins
  - name: tools
    x-group: Tools
  - name: webhooks
    x-group: Webhooks
  - name: runs
    x-group: Runs
  - name: builds
    x-group: Builds
  - name: jobs
    x-group: Jobs
  - name: support
    x-group: Support
paths:
  /v1/integrations/{id}/reference:
    get:
      tags:
        - integrations
      summary: Get an integration's reference
      description: >-
        Everything an agent needs to use one integration, as one Markdown
        document to read or paste into its context: the site, its MCP URL and
        keyless URL, how each MCP client connects to it, each tool under the
        name its MCP gives it with what it does, its effect, the login it needs,
        its input fields and a sample call, and a link to its OpenAPI document.
        A public integration, or one your team's list holds; an integration key
        reaches only its own.
      operationId: integrations.reference
      parameters:
        - name: id
          in: path
          required: true
          description: 'an integration ID: int_ and 32 lowercase hex digits'
          schema:
            type: string
            examples:
              - int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190
      responses:
        '200':
          description: The integration's reference
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationReference'
        '400':
          description: invalid_request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: unauthorized, reauthentication_required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: not_found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: internal_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: temporarily_unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearer: []
components:
  schemas:
    IntegrationReference:
      type: object
      required:
        - format
        - content
      properties:
        format:
          type: string
          enum:
            - markdown
        content:
          type: string
          description: >-
            The integration's reference as Markdown: its site, its MCP URL and
            keyless URL, how each MCP client connects to it, each of its tools
            under the name its MCP gives it with its effect, login, input and a
            sample call, and a link to its OpenAPI document
      additionalProperties: false
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - retryable
            - docs_url
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
            docs_url:
              type: string
            details:
              type: object
              required: []
              properties: {}
              additionalProperties:
                $id: /schemas/unknown
          additionalProperties: false
      additionalProperties: false
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.