| \n\nassignment\n\n | \n\nRequired for new assignments. Object containing information about the assignment.Data type: Object\n\n```\n{ \n \"after_timeout_presence\": \"String\",\n \"agent_sys_id\": \"String\", \n \"allowed_to_decline\": Boolean,\n \"display_option\": \"String\", \n \"enable_auto_assign\": Boolean, \n \"offered_on\": \"String\",\n \"timeout\": Number \n} \n```\n\n |
| \n\nassignment.after\\_timeout\\_presence\n\n | \n\nSys\\_id of the presence state that the agent switches to if the **timeout** parameter expires.If the **timeout** parameter isn't passed, this parameter is ignored.\n\nFor additional information on presence states, see [Configure agent presence states](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/conversational-interfaces/awa-configure-agent-presence.md).\n\nData type: String\n\nDefault: Empty string \\(Agent presence state doesn't change\\).\n\nTable: AWA Presence State \\[awa\\_presence\\_state\\]\n\n |
| \n\nassignment.agent\\_sys\\_id\n\n | \n\nRequired for new assignments. Sys\\_id of the available agent to receive the work item. The agent must have the awa\\_agent and awa\\_external\\_user roles.For information on how to determine if an agent is available, refer to [Agent Inbox controls](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/conversational-interfaces/agent-experience.md).\n\nData type: String\n\nTable: User \\[sys\\_user\\]\n\n |
| \n\nassignment.allowed\\_to\\_decline\n\n | \n\nFlag that indicates whether agents are allowed to reject work items. If this parameter is `true`, the inbox card displays both the **Accept** and **Reject** buttons on the inbox card.Valid values:\n\n- true/yes/1: Agent can reject work items.\n- false/no/0: Agent can't reject work items.\n\nData type: Boolean\n\nDefault: true\n\n |
| \n\nassignment.display\\_option\n\n | \n\nDisplay option for the card and tab when a work item is automatically assigned. This parameter is only valid if **enable\\_auto\\_assign** is `true`.\n\nValid values:\n\n- card\\_and\\_tab: Display both the card and tab.\n- card\\_only: Display only the card.\n\nData type: String\n\nDefault: card\\_only\n\n |
| \n\nassignment.enable\\_auto\\_assign\n\n | \n\nFlag that indicates whether the work item should be automatically accepted or should allow the agent to manually accept or reject the work item.Valid values:\n\n- true/yes/1: Automatically accept.\n- false/no/0: Allow agent to manually accept or reject.\n\nData type: Boolean\n\nDefault: false\n\n |
| \n\nassignment.offered\\_on\n\n | \n\nWork item offer time. The offer time is used to calculate the remaining time the agent has left to accept the work item in the inbox. It helps account for the discrepancy between the time when the API request gets processed, and when the third-party routing system invokes the API request. This parameter allows external systems calling this endpoint to configure the offer time of the work item so that it stays in synchronization with the external system’s internal tracking of the work item.For example, if the work item was offered on 11:30:30, the timeout is 30 seconds, and the current time is 11:30:45, the countdown timer displays 00:15 \\(as in 15 seconds remaining\\).\n\nThis value is stored in the offered\\_on field on the work item.\n\nThis parameter is ignored if the **timeout** parameter isn't passed.\n\nData type: String\n\nFormat: UTC timestamp \\(yyyy-MM-dd'T'HH:mm:ss.SSS\\)\n\n |
| \n\nassignment.timeout\n\n | \n\nAmount of time that the work item stays in the agent’s inbox waiting for the agent to accept the work assignment.Data type: Number\n\nUnit: Seconds\n\nDefault: Empty string \\(No time limit\\).\n\n |
| \n\nexternal\\_segment\\_id\n\n | \n\nExternal identifier from the CCAAS system of the call segment offered to the agent.Data type: String\n\n |
| \n\nqueue\\_id\n\n | \n\nRequired for new assignments. Sys\\_id of the queue record or the queue identifier in an external system.If using a queue\\_id from an external system, it must be mapped to the Provider queue ID \\(external\\_id\\) field on the awa\\_queue record.\n\nData type: String\n\nTable: Queue \\[awa\\_queue\\]\n\n |
| \n\ntransfer\n\n | \n\nRequired for transfer assignments. Object containing information about the transfer.If a value is provided for this parameter, the assignment is considered a transfer assignment.\n\nData type: Object\n\n```\n{\n \"source_queue_id\": \"String\",\n \"target_id\": \"String\",\n \"target_type\": \"String\",\n \"transfer_type\": \"String\"\n}\n```\n\n |
| \n\ntransfer.source\\_queue\\_id\n\n | \n\nRequired for transfer assignments.Source queue from where the transfer is initiated. Sys\\_id of the queue record or the queue identifier in an external system.\n\nIf using a queue\\_id from an external system, it must be mapped to the Provider queue ID \\(external\\_id\\) field on the awa\\_queue record.\n\nThis parameter is used to create a work item before initiating the transfer if an active work item is not found. It enables transfers to be performed if the original interaction was created without any routing, such as for outbound calls.\n\nData type: String\n\nTable: Queue \\[awa\\_queue\\]\n\n |
| \n\ntransfer.target\\_id\n\n | \n\nRequired for transfer assignments. Sys\\_id of the agent or queue record to transfer the assignment to.- If **target\\_type** is `agent`, **target\\_id** is the sys\\_id of the agent user record in the User \\[sys\\_user\\] table.\n- If **target\\_type** is `queue`, **target\\_id** is the sys\\_id of the queue record in the Queue \\[awa\\_queue\\] table or the queue identifier in an external system.\n\nData type: String\n\n |
| \n\ntransfer.target\\_type\n\n | \n\nRequired for transfer assignments. Type of record to transfer the assignment to.Valid values:\n\n- agent\n- queue\n\nData type: String\n\n |
| \n\ntransfer.transfer\\_type\n\n | \n\nRequired for transfer assignments. Type of transfer.Valid values:\n\n- blind\n- consult\n\nData type: String\n\n |
\n