list_agent_skill_assignments
Read-onlyIdempotent
Retrieve the skills and queues assigned to a Zendesk agent via user ID, returned as paginated routing-attribute values.
Instructions
Returns the routing-attribute values an agent holds (i.e. which skills/queues that user is eligible for) as paginated skeletons. Backed by /api/v2/users/{user_id}/instance_values.json, the canonical SBR-assignment endpoint. Plan-gated, degrades to upstream_error when omnichannel routing is off. Scope-gated because it touches user data (config_plus_audits or full). For attribute/value catalogs (not assignments), use list_routing_attributes / list_routing_attribute_values.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max items to return. Default 100. The full corpus is fetched and cached server-side; this only limits what the response carries. | |
| cursor | No | Opaque pagination token from a previous response. Slices the next page from the cached corpus. Stale cursors (older than the cache TTL) auto-reset to offset 0 and set cursor_invalidated: true. | |
| fields | No | Whitelist of field names. Overrides the default projection. Use to opt into extra fields (e.g. ["id","title","active","position","category_id","updated_at"]) without going fully verbose. | |
| filter | No | Structured filter applied to the cached corpus before slicing. Supported keys: active (bool), category_id (number/string), title_contains (string, case-insensitive), updated_since (ISO timestamp). Unsupported keys are ignored with a note in the response. | |
| refresh | No | Bypass cache and re-fetch | |
| user_id | Yes | Agent (Zendesk user) ID | |
| verbose | No | Return full value objects | |
| instance | No | Override the sticky instance |