v29

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-13511526891.2 KB
Skill Based Routing
Job Statuses

Bulk Set Agent Attribute Values Job

Adds, replaces or removes multiple attributes for up to 100 agents.

Allowed For

Available Parameters

The request takes a data object with the following properties:

NameTypeRequiredDescription
actionstringtrueThe action to perform on the attribute values. One of the following: "upsert", "update", "delete"
attributesobjecttrueThe attribute values to update. See Attribute Values
itemsarraytrueThe list of agent ids

Action can be one of the following:

  • upsert: Adds new attribute values to the agents
  • update: Replaces all the current attribute values of the agents with the new values
  • delete: Removes specified attribute values from the agents

This endpoint returns a job_status JSON object and queues a background job to do the work. Use the Show Job Status endpoint to check for the job's completion.

post/api/v2/routing/agents/instance_values/job

Request body

Response

Success response