Skip to main content

CreateStatusConfig creates a new custom status configuration.

POST 
/api/v1/voice/agent-status-configs

Creates a custom status that agents can select. The queue_behavior determines how the status affects call routing.

Parameters​

  • name: Required, status display name (1-50 characters)
  • queue_behavior: Required, routing behavior (offline, online, available, paused)
  • color: Optional, hex color code (7 characters, e.g., #FF5733)
  • icon: Optional, icon identifier for UI
  • display_order: Optional, sort order in status list

Errors​

  • ALREADY_EXISTS: Status with same name exists
  • INVALID_ARGUMENT: Invalid queue_behavior or color format
  • PERMISSION_DENIED: Caller lacks voice:status:write permission

Request​

Responses​

A successful response.