{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/webex/main/json-schema/webex-buddy-agent-request-schema.json",
  "title": "BuddyAgentRequest",
  "description": "Request payload to retrieve buddy agents.",
  "x-generated": "2026-10-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/webex-agents-api-openapi.yml#/components/schemas/BuddyAgentRequest",
  "properties": {
    "agentProfileId": {
      "description": "The profile ID of a particular agent. Can be obtained from [Users API](/docs/users), maximum length 36 characters.",
      "type": "string"
    },
    "mediaType": {
      "description": "The media type for the request. The supported values are ```telephony```, ```chat```, ```social```, ```email```, ```workItem``` and ```customMessaging```.",
      "type": "string"
    },
    "state": {
      "description": "It represents the current state of the returned agents which can be either ```Available``` or ```Idle```. If state is omitted from the payload, the API will return a list of both available and idle agents. This is useful for consult scenarios, since consulting an idle agent is also supported.",
      "type": "string"
    }
  },
  "required": [
    "agentProfileId",
    "mediaType"
  ],
  "type": "object"
}