> ## Documentation Index > Fetch the complete documentation index at: https://langchain-5e9cc07a-preview-fjmorr-1782499519-e1e0dbe.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get an integration > Returns a single integration (workspace MCP server) by ID, after ABAC filtering. ## OpenAPI ````yaml /langsmith/headless-fleet-openapi.json get /v1/fleet/integrations/{id} openapi: 3.0.0 info: contact: {} description: > The Fleet API is a headless interface for building and running agents — create and configure agents, manage their connections and secrets, run threads, and wire up triggers. Paths are service-native (e.g. `/v1/fleet/agents`). Self-hosted deployments reach them through the gateway under an `/api` prefix (e.g. `/api/v1/fleet/agents`). ## Authentication Every request must carry **one** credential: | Scheme | Header | Value | | --- | --- | --- | | API key | `X-Api-Key` | A LangSmith API key (`lsv2_…`). | | Session token | `Authorization` | `Bearer `. | Workspace-scoped endpoints additionally require **`X-Tenant-Id`**, set to the workspace (tenant) UUID the request operates in. Organization- and identity-scoped endpoints omit it. ## Errors Errors follow [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) (Problem Details) and use one JSON shape across every endpoint: ```json { "type": "about:blank", "code": "agent_not_found", "detail": "No agent exists with that ID.", "status": 404 } ``` - `type` — URI identifying the error type. Currently always `about:blank` (the RFC 7807 default); branch on `code`, not `type`. - `code` — stable, machine-readable identifier. Branch on this rather than matching `detail`. - `detail` — human-readable explanation. Proxied endpoints also echo it as `message`. - `status` — mirrors the HTTP status code. | Status | Meaning | | --- | --- | | `400` | Malformed request or failed validation. | | `401` | Missing or invalid credentials. | | `403` | Authenticated, but not permitted to access this resource. | | `404` | The resource does not exist or is not visible to your workspace. | | `409` | Conflicts with current state (e.g. a duplicate). | | `422` | Well-formed but semantically invalid. | | `500` | Unexpected server error. | | `502` / `503` | An upstream dependency failed or was unavailable. Retries are usually safe. | ## Pagination List endpoints return a fixed-size page and an opaque cursor: ```json { "items": [ ], "next_cursor": "eyJ…" } ``` - `page_size` — items per page, `1`–`100` (default `20`). - `cursor` — pass the previous response's `next_cursor` to fetch the next page. An absent or empty `next_cursor` means there are no more results. Cursors are opaque — don't construct or parse them. title: Fleet API version: v1 servers: - url: / security: [] tags: - name: agents - name: agent connections - name: threads - name: skills - name: auth - name: integrations - name: secrets - name: models - name: tenants - name: users paths: /v1/fleet/integrations/{id}: get: tags: - integrations summary: Get an integration description: >- Returns a single integration (workspace MCP server) by ID, after ABAC filtering. parameters: - description: Integration id name: id in: path required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/integrations.Integration' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/integrations.ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/integrations.ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/integrations.ErrorResponse' security: - API_Key: [] - Tenant_ID: [] - Bearer_Auth: [] components: schemas: integrations.Integration: type: object properties: auth_methods: type: array items: $ref: '#/components/schemas/integrations.AuthMethod' can_invoke: type: boolean created_at: type: string enabled: type: boolean external_system_id: type: string headers: type: array items: $ref: '#/components/schemas/integrations.HeaderInput' id: type: string name: type: string source: type: string transport: $ref: '#/components/schemas/integrations.Transport' updated_at: type: string url: type: string integrations.ErrorResponse: type: object properties: code: type: string detail: type: string status: type: integer type: type: string integrations.AuthMethod: type: object properties: provider_match: $ref: '#/components/schemas/integrations.ProviderMatch' scopes: type: array items: type: string secret_names: type: array items: type: string type: $ref: '#/components/schemas/integrations.AuthType' integrations.HeaderInput: type: object required: - key properties: key: type: string value: type: string integrations.Transport: type: string enum: - mcp_http x-enum-varnames: - TransportMCPHTTP integrations.ProviderMatch: type: object properties: by: $ref: '#/components/schemas/integrations.MatchBy' value: type: string integrations.AuthType: type: string enum: - oauth2 - headers - api_key - secret - github_app - none x-enum-varnames: - AuthTypeOAuth2 - AuthTypeHeaders - AuthTypeAPIKey - AuthTypeSecret - AuthTypeGithubApp - AuthTypeNone integrations.MatchBy: type: string enum: - kind - id x-enum-varnames: - MatchByKind - MatchByID securitySchemes: API_Key: description: LangSmith API key (`lsv2_...`). type: apiKey name: X-Api-Key in: header Tenant_ID: description: Workspace (tenant) UUID the request operates in. type: apiKey name: X-Tenant-Id in: header Bearer_Auth: description: Session JWT, sent as `Bearer `. type: apiKey name: Authorization in: header ````