---
title: "Get an integration's reference"
method: GET
path: "/v1/integrations/{id}/reference"
tags: ["integrations"]
---

# Get an integration's reference

`GET /v1/integrations/{id}/reference`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/integrations/{id}/reference`
- Auth: HTTP bearer

Get an integration's reference: one Markdown document an agent can read to use it.

- It covers the site, its MCP URLs, how each MCP client connects, and each tool under its MCP name with its effect, login, input and a sample call.
- You can read a public integration or one your team's list holds. An integration key reaches only its own.

## Path parameters

- `id` string, required

## Response `200`

The integration's reference

- IntegrationReference
  - `format` 'markdown', required
  - `content` string, required: The integration's reference as Markdown

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `404`: not_found
- `500`: internal_error
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/48dac2a3143e?raw)