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

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

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

Makes an agent a collaborator for another agent.

## Path parameters

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

## Request body

- object
  - `agentDescriptor` object, required — An agent descriptor.
    - `aliasArn` string — The agent's alias ARN.
  - `collaboratorName` string, required — A name for the collaborator.
  - `collaborationInstruction` string, password, required — Instruction for the collaborator.
  - `relayConversationHistory` 'TO_COLLABORATOR' | 'DISABLED' — A relay conversation history for the collaborator.
  - `clientToken` string — A client token.

## Response `200`

Success

- AssociateAgentCollaboratorResponse
  - `agentCollaborator` object, required — Details about the collaborator.
    - `agentId` string, required — The collaborator's agent ID.
    - `agentVersion` string, required — The collaborator's agent version.
    - `agentDescriptor` object, required — The collaborator's agent descriptor.
      - `aliasArn` string — The agent's alias ARN.
    - `collaboratorId` string, required — The collaborator's collaborator ID.
    - `collaborationInstruction` string, password, required — The collaborator's instructions.
    - `collaboratorName` string, required — The collaborator's collaborator name.
    - `createdAt` string, date-time, required — When the collaborator was created.
    - `lastUpdatedAt` string, date-time, required — When the collaborator was updated.
    - `relayConversationHistory` 'TO_COLLABORATOR' | 'DISABLED' — The collaborator's relay conversation history.
    - `clientToken` string — The collaborator's client token.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — InternalServerException
- `484` — ResourceNotFoundException
- `485` — ConflictException
- `486` — ServiceQuotaExceededException

---

[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)