{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/webex/main/json-schema/webex-state-resource-request-schema.json",
  "title": "StateResourceRequest",
  "description": "Request payload to update an agent state.",
  "x-generated": "2026-10-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/webex-agents-api-openapi.yml#/components/schemas/StateResourceRequest",
  "properties": {
    "state": {
      "description": "It represents the current state of the user. Can be set to ```Available``` or ```Idle```.",
      "type": "string"
    },
    "auxCodeId": {
      "description": "Auxiliary Codes are status codes which an agent can select in Webex Contact Center Agent Desktop. They are of two types: ```Idle``` and ```Wrap-Up``` codes, and every agent profile must have one of each for the agent to use. Idle codes are used to explain an agent's unavailability to take customer contacts, such as during a lunch break or a meeting. Wrap-up codes indicate the result of customer contacts, such as successful resolution or escalation of the contact. Creating and managing auxiliary codes requires an administrator role and the appropriate cjp:config_write or cjp:config_read scopes, maximum length 36 characters.",
      "type": "string"
    },
    "lastStateChangeReason": {
      "description": "It represents the reason of the last state change request, maximum length 128 characters.",
      "type": "string"
    },
    "agentId": {
      "description": "User for which state change is initiated, maximum length 36 characters.",
      "type": "string"
    }
  },
  "required": [
    "state",
    "auxCodeId"
  ],
  "type": "object"
}