---
title: "List deployment adapters"
method: GET
path: "/v2/projects/{projectId}/endpoints/{endpointId}/deployments/{deploymentId}/adapters"
tags: ["DeploymentService"]
---

# List deployment adapters

`GET /v2/projects/{projectId}/endpoints/{endpointId}/deployments/{deploymentId}/adapters`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v2/projects/{projectId}/endpoints/{endpointId}/deployments/{deploymentId}/adapters`
- Auth: HTTP bearer

Lists LoRA adapters attached to a deployment with per-cluster load state.

## Path parameters

- `projectId` string, required: Project identifier.
- `endpointId` string, required: Endpoint identifier.
- `deploymentId` string, required: Deployment identifier.

## Query parameters

- `limit` integer: Maximum number of adapters to return.
- `after` string: Cursor from a previous adapter list response.

## Response `200`

OK

- DEListAdaptersResponse: Response containing attached adapters and pagination metadata.
  - `data` DEAdapterEntry[], required: Adapters attached to the deployment.
    - `adapterModelId` string, required: Adapter model identifier attached to the deployment.
    - `desiredRevisionId` string, required: Adapter revision pinned on the deployment.
    - `perCluster` DEDeploymentAdapterStatus[], required: Per-cluster adapter load state reported by the controller.
      - `adapterModelId` string, required: Adapter model identifier for this status row.
      - `clusterId` string, required: Cluster reporting this adapter status.
      - `realizedRevisionId` string: Adapter revision currently loaded on pods in this cluster.
      - `realizedEtag` string: Adapter row etag observed by the controller when it wrote this status.
      - `state` 'ADAPTER_LOAD_STATE_PENDING' | 'ADAPTER_LOAD_STATE_LOADING' | 'ADAPTER_LOAD_STATE_READY' | 'ADAPTER_LOAD_STATE_REMOVING' | 'ADAPTER_LOAD_STATE_FAILED', required: Current adapter load state in this cluster.
      - `reason` string: Stable reason code for the current adapter state.
      - `message` string: Human-readable details about the current adapter state.
      - `readyPodCount` integer, required: Number of pods with the adapter ready to serve.
      - `failedPodCount` integer, required: Number of pods that failed to load the adapter.
      - `totalPodCount` integer, required: Total pods expected to report adapter load state.
      - `loadedAt` string, date-time: Time when the adapter first reached READY in this cluster.
      - `updatedAt` string, date-time: Time when this adapter status was last updated.
      - `adapterModel` string: Resource name of the adapter model, using projects/{projectId}/models/{adapterModelId}.
      - `realizedRevision` string: Resource name of the adapter model revision currently loaded in this cluster, using projects/{projectId}/models/{adapterModelId}/revisions/{revisionId}.
      - `adapterValid` boolean: Optional inference-probe verdict for this adapter on this cluster; absent until validation concludes.
      - `adapterValidReason` string: Human-readable probe rejection detail when adapterValid is false.
    - `etag` string, required: Row-level etag required for UpdateAdapter and RemoveAdapter.
    - `adapterModel` string: Resource name of the adapter model, using projects/{projectId}/models/{adapterModelId}.
    - `desiredRevision` string: Resource name of the adapter model revision pinned on the deployment, using projects/{projectId}/models/{adapterModelId}/revisions/{revisionId}.
    - `id` string, required: Adapter attachment `dad_` id used by get, update, and remove; stale ids never address a replacement after remove and re-add.
  - `next_cursor` string: Cursor for the next page. Null if there are no more results.
  - `object` 'list', required: Object type. Always `list`.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v2/projects/:projectId/endpoints/:endpointId/deployments/:deploymentId/adapters/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)