> ## Documentation Index > Fetch the complete documentation index at: https://docs.watahub.dev/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.1.0 info: title: API de Yampi description: >- API de cuenta de Yampi: chats, inventario, negocios, contratos, tesorería y Livia. Autenticación con el header `api_access_token`. version: 1.2.0 termsOfService: https://yampi.ai/terms/ contact: email: hola@yampi.ai license: name: MIT License url: https://opensource.org/licenses/MIT servers: - url: https://app.yampi.ai description: Producción security: [] tags: - 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: Automation Rule description: Workflow automation rules - name: Help Center description: Knowledge base management - name: Account description: Current account profile and settings - name: Audit Logs description: Account audit log - name: Properties description: Property portfolio APIs - name: Companies description: Company CRM APIs - name: Opportunities description: Opportunity CRM APIs - name: Opportunity Reminders description: Reminders on opportunities - name: Contract Templates description: Contract template library - name: Contract Submissions description: Contract sending and tracking - name: Contract Imports description: Import signed contracts into the account - name: Livia description: Asistentes de Livia - name: Livia Tareas description: Tareas one-shot de Livia - name: SLA Policies description: SLA policy management - name: Applied SLAs description: SLA instances applied to conversations - name: SAML Settings description: Account SAML SSO settings - name: Treasury Subscriptions description: Recurring treasury subscriptions - name: Treasury Rent Readjustments description: Proposed rent raises reviewed before the tenant is notified - name: Treasury Payments description: Treasury payment recording - name: Treasury Adjustments description: Debit and credit adjustments - name: Treasury Adjustment Concepts description: Catálogo de conceptos de la agencia para cargos y descuentos. - name: Treasury Rules description: Notification, retry, collection and tax rules - name: Treasury Dashboard description: Treasury dashboard - name: Treasury Settings description: Treasury account settings - name: Treasury Owners description: Owner statements - name: Treasury Reports description: Aging and commission reports - name: Livia Documentos description: Documentos de conocimiento de Livia - name: Livia Escenarios description: Escenarios de un asistente de Livia - name: Livia Herramientas description: Herramientas HTTP de Livia - name: Livia Desk description: Hilos y mensajes de Livia Desk - name: Client Qualifications description: >- Criterios con los que un asistente califica a un cliente a partir de una conversación, y las bandas en las que cae. - name: Livia Preferencias description: Preferencias de Livia a nivel de cuenta - name: Documents description: Account document library - name: Document Folders description: Document library folders - name: Calendar Events description: Account calendar, availability and booking links - name: Agent Tasks description: Agent task inbox and lifecycle - name: Labels description: Account labels - name: Notifications description: User notifications and notification settings - name: Search description: Account search and AI search - name: Macros description: Conversation macros - name: Campaigns description: Outbound campaigns - name: Flow Definitions description: Livia flow builder - name: Custom Roles description: Custom agent roles - name: Assignment Policies description: Conversation assignment policies - name: Requirements description: Capture requirements - name: Zones description: Location zones and cities - name: Geocoding description: Authenticated geocoding - name: Domains description: Account custom domains - name: Connector Clients description: MCP connector client identifiers - name: Presigned Contracts description: Already-signed contracts uploaded to the account - name: Contract Webhooks description: Outbound contract webhook URLs - name: Contracts Settings description: Account contracts settings - name: Treasury Collections description: Collection steps, notices, agreements and exceptions - name: Treasury Guarantees description: Rental guarantees and claims - name: Treasury E-Invoices description: Electronic invoicing - name: Treasury Available Contracts description: Completed contracts that can seed subscriptions - name: Opportunity Pipelines description: CRM funnels - name: Opportunity Columns description: CRM kanban columns - name: Opportunity Lose Reasons description: CRM lose reasons - name: Requirement Quotes description: Priced quotes on capture requirements - name: Conversation Participants description: Agents participating in a conversation - name: Conversation Draft Messages description: Per-conversation composer drafts - name: MCP description: Account-scoped MCP JSON-RPC server - name: Treasury Bank Batches description: Bank payout files and beneficiary account confirmation - name: Treasury Bank Statements description: Imported bank statements and matching of their lines - name: Treasury Third Parties description: >- Propietarios, administraciones, proveedores y aliados a los que la agencia les paga o les cobra. - name: Treasury Giros description: What each recipient receives, by date and channel - name: Contract Drafts description: Contracts being written before they are sent - name: Contract Reviews description: Review rounds, versions and comments on a contract - name: Contact Assignment Requests description: Requests to be assigned a contact - name: Onboarding description: Account onboarding details - name: Owner Portal Invites description: Owner portal invite, eligibility and revoke - name: Channel Authorizations description: Start OAuth or embedded signup for inbox channels - name: CSAT Survey Responses description: Account CSAT responses, metrics and review notes - name: Dashboard description: Account dashboard summary and trends - name: Dashboard Apps description: Embedded dashboard apps - name: Bulk Actions description: Bulk conversation and contact actions - name: Assignable Agents description: Agents assignable across a set of inboxes - name: Tracking Pixels description: Advertising tracking pixels - name: Calls description: Account call history - name: WhatsApp Calls description: WhatsApp voice calls - name: WhatsApp Groups description: WhatsApp Cloud group management on an inbox 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: [] 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 grants: type: object description: >- Permisos efectivos en esta cuenta. Cada llave es un permiso; el valor es `true` si no tiene alcance, o uno de `own`, `team`, `suite`, `all`. Omite las llaves de módulos apagados. Convive con `permissions` mientras los módulos migran. additionalProperties: description: >- `true` (sin alcance) o alcance `own` / `team` / `suite` / `all`. oneOf: - type: boolean enum: - true - type: string enum: - own - team - suite - all availability: type: string availability_status: type: string auto_offline: type: boolean custom_role_id: type: number nullable: true custom_role: type: object nullable: true system_role: type: string nullable: true enum: - commercial - marketing - service - legal - treasury - accounting - commercial_admin - service_admin - administrative_admin description: >- Rol de sistema del miembro en la cuenta. Convive con `role` (`agent` | `administrator`) y `custom_role_id`. Null ok. invite_system_roles: type: array items: type: string enum: - commercial - commercial_admin - service - service_admin - treasury - accounting - administrative_admin description: >- Roles de sistema que el miembro puede asignar al invitar agentes en esta cuenta. El primero es el rol por defecto de la invitación. Solo aparece cuando el miembro es administrador de una suite (`system_role` `commercial_admin`, `service_admin` o `administrative_admin`) y no es administrador de la cuenta. Valores según `system_role`: `commercial_admin` → `commercial`, `commercial_admin`; `service_admin` → `service`, `service_admin`; `administrative_admin` → `treasury`, `accounting`, `administrative_admin`. edit_system_roles: type: array items: type: string enum: - commercial - commercial_admin - service - service_admin - treasury - accounting - administrative_admin description: >- Roles de sistema de los agentes nativos (sin rol personalizado) que el miembro puede editar en esta cuenta. Solo aparece cuando el miembro es administrador de una suite (`system_role` `commercial_admin`, `service_admin` o `administrative_admin`) y no es administrador de la cuenta. Valores según `system_role`: `commercial_admin` → `commercial`, `commercial_admin`; `service_admin` → `service`, `service_admin`; `administrative_admin` → `treasury`, `accounting`, `administrative_admin`. delete_system_roles: type: array items: type: string enum: - commercial - commercial_admin - service - service_admin - treasury - accounting - administrative_admin description: >- Roles de sistema de los agentes nativos (sin rol personalizado) que el miembro puede eliminar de esta cuenta. Solo aparece cuando el miembro es administrador de una suite (`system_role` `commercial_admin`, `service_admin` o `administrative_admin`) y no es administrador de la cuenta. Valores según `system_role`: `commercial_admin` → `commercial`, `commercial_admin`; `service_admin` → `service`, `service_admin`; `administrative_admin` → `treasury`, `accounting`, `administrative_admin`. 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: >- Token de usuario. Envía el valor en el header `api_access_token`. Lo obtienes en el perfil (`GET /api/v1/profile`) o al regenerarlo. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.