---
title: "POST /agents/{agentId}/agentversions/{agentVersion}/agentcollaborators/"
method: POST
path: "/agents/{agentId}/agentversions/{agentVersion}/agentcollaborators/"
---

# POST /agents/{agentId}/agentversions/{agentVersion}/agentcollaborators/

`POST /agents/{agentId}/agentversions/{agentVersion}/agentcollaborators/`

Retrieve a list of an agent's collaborators.

## Path parameters

- `agentId` string, required
- `agentVersion` string, required

## Request body

- object
  - `maxResults` integer — The maximum number of agent collaborators to return in one page of results.
  - `nextToken` string — Specify the pagination token from a previous request to retrieve the next page of results.

## Response `200`

Success

- ListAgentCollaboratorsResponse
  - `agentCollaboratorSummaries` AgentCollaboratorSummary[], required — A list of collaborator summaries.
    - `agentId` string, required — The collaborator's agent ID.
    - `agentVersion` string, required — The collaborator's agent version.
    - `collaboratorId` string, required — The collaborator's ID.
    - `agentDescriptor` object, required — The collaborator's agent descriptor.
      - `aliasArn` string — The agent's alias ARN.
    - `collaborationInstruction` string, password, required — The collaborator's collaboration instruction.
    - `relayConversationHistory` 'TO_COLLABORATOR' | 'DISABLED', required — The collaborator's relay conversation history.
    - `collaboratorName` string, required — The collaborator's name.
    - `createdAt` string, date-time, required — When the collaborator was created.
    - `lastUpdatedAt` string, date-time, required — When the collaborator was last updated.
  - `nextToken` string — Specify the pagination token from a previous request to retrieve the next page of results.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — InternalServerException
- `484` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/bedrock-agent.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agent/versions/a3b2356f17da/schema)