> ## Documentation Index > Fetch the complete documentation index at: https://developers.chatwoot.com/llms.txt > Use this file to discover all available pages before exploring further. # Assign Conversation > Assign a conversation to an agent or a team ## OpenAPI ````yaml https://raw.githubusercontent.com/chatwoot/chatwoot/develop/swagger/tag_groups/application_swagger.json post /api/v1/accounts/{account_id}/conversations/{conversation_id}/assignments openapi: 3.1.0 info: title: Chatwoot description: This is the API documentation for Chatwoot server. version: 1.1.0 termsOfService: https://www.chatwoot.com/terms-of-service/ contact: email: hello@chatwoot.com license: name: MIT License url: https://opensource.org/licenses/MIT servers: - url: https://app.chatwoot.com/ security: [] tags: - name: Account AgentBots description: Account-specific Agent Bots - name: Agents description: Agent management APIs - name: Campaigns description: >- Create, schedule, and manage campaigns. Requires an account administrator and API access enabled for the account. - name: Canned Responses description: Pre-defined responses for common queries - name: Contacts description: Contact management APIs - name: Contact Labels description: Manage contact labels - name: Conversation Assignments description: Manage conversation assignments - name: Conversation Labels description: Manage conversation labels - name: Conversations description: Conversation management APIs - name: Custom Attributes description: Custom fields for contacts and conversations - name: Custom Filters description: Saved filters for conversations - name: Inboxes description: Communication channels setup - name: Integrations description: Third-party integrations - name: Labels description: Account label management APIs - name: Messages description: Message management APIs - name: Profile description: User profile APIs - name: Reports description: Analytics and reporting APIs - name: Teams description: Team management APIs - name: Webhooks description: Event notification webhooks - name: Automation Rule description: Workflow automation rules - name: Help Center description: Knowledge base management paths: /api/v1/accounts/{account_id}/conversations/{conversation_id}/assignments: parameters: - $ref: '#/components/parameters/account_id' - $ref: '#/components/parameters/conversation_id' post: tags: - Conversation Assignments summary: Assign Conversation description: Assign a conversation to an agent or a team operationId: assign-a-conversation requestBody: required: true content: application/json: schema: type: object properties: assignee_id: type: number description: Id of the assignee user example: 1 team_id: type: number description: >- Id of the team. If the assignee_id is present, this param would be ignored example: 1 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/user' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/bad_request_error' '404': description: Conversation not found content: application/json: schema: $ref: '#/components/schemas/bad_request_error' security: - userBearerAuth: [] - agentBotBearerAuth: [] - userApiKey: [] - agentBotApiKey: [] components: parameters: account_id: in: path name: account_id schema: type: integer required: true description: The numeric ID of the account conversation_id: in: path name: conversation_id schema: type: integer required: true description: The numeric ID of the conversation schemas: user: type: object properties: id: type: number access_token: type: string account_id: type: number available_name: type: string avatar_url: type: string confirmed: type: boolean display_name: type: - string - 'null' message_signature: type: - string - 'null' email: type: string hmac_identifier: type: string inviter_id: type: - number - 'null' name: type: string provider: type: string pubsub_token: type: string role: type: string enum: - agent - administrator ui_settings: type: object uid: type: string type: type: - string - 'null' custom_attributes: type: object description: >- Available for users who are created through platform APIs and has custom attributes associated. accounts: type: array items: type: object properties: id: type: number name: type: string status: type: string active_at: type: - string - 'null' format: date-time role: type: string enum: - administrator - agent permissions: type: array items: type: string availability: type: string availability_status: type: string auto_offline: type: boolean custom_role_id: type: - number - 'null' custom_role: type: - object - 'null' bad_request_error: title: data type: object properties: description: type: string errors: type: array items: $ref: '#/components/schemas/request_error' request_error: type: object properties: field: type: string message: type: string code: type: string securitySchemes: userBearerAuth: type: http scheme: bearer description: >- Authenticate with `Authorization: Bearer ` using a user API token from **Profile Settings**. Available in Chatwoot `v4.19.0` and later. agentBotBearerAuth: type: http scheme: bearer description: >- Authenticate with `Authorization: Bearer ` using an agent bot token from **Settings → Agent Bots**. Available in Chatwoot `v4.19.0` and later. userApiKey: type: apiKey in: header name: api_access_token description: >- Find your API token in **Profile Settings**. The `api_access_token` header remains supported, but will be deprecated in a future release. For new integrations, use Bearer authentication. agentBotApiKey: type: apiKey in: header name: api_access_token description: >- Find your agent bot token in **Settings → Agent Bots**. For new integrations, use Bearer authentication in Chatwoot `v4.19.0` and later. Agent bot tokens can access only bot-permitted APIs. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.