> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.rookoo.ai/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 /openapi/application.json post /api/v1/accounts/{account_id}/conversations/{conversation_id}/assignments openapi: 3.0.4 info: title: Rookoo Application API description: >- Manage conversations, contacts, inboxes, planning, knowledge bases, MCP, and account settings on behalf of a user. version: 1.1.0 termsOfService: https://www.rookoo.ai/terms-of-service/ contact: email: hello@rookoo.ai license: name: MIT License url: https://opensource.org/licenses/MIT servers: - url: https://app.rookoo.ai/ security: [] tags: - name: Account AgentBots description: Account-specific Agent Bots - name: Agents description: Agent management APIs - 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: 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: OAuth Applications description: Account-scoped OAuth 2.0 clients - name: Automation Rule description: Workflow automation rules - name: Help Center description: Knowledge base management - name: Knowledge Bases description: Searchable knowledge bases and records - name: Planning Events description: Event planning and inquiries - name: Planning Allocations description: Space allocations and availability - name: Planning Quotes description: Quotes for planning events - name: Planning Rates description: Rate catalogue and prices - name: Planning Pricing description: Pricing plans, discount codes, and price preview/lock - name: Spaces description: Bookable spaces and rooms - name: Rookoo Agents description: Rookoo AI agent configuration - name: Copilot description: Copilot JWT and settings - name: MCP description: Model Context Protocol server endpoints 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: - 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 nullable: true message_signature: type: string nullable: true email: type: string hmac_identifier: type: string inviter_id: type: number 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 nullable: true 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 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 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: userApiKey: type: apiKey in: header name: api_access_token description: >- This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user. agentBotApiKey: type: apiKey in: header name: api_access_token description: >- This token should be provided by system admin or obtained via rails console. This token can be used to build bot integrations and can only access limited apis. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.