v4

latestSwagger 2.02026-07-1333110154.1 KB

Creates or updates a router job.

Creates or updates a router job.

patch/routing/jobs/{jobId}

Path parameters

jobIdstring required

Id of a job.

Query parameters

api-versionstring required

The API version to use for this operation.

Headers

If-Matchstring

The request should only proceed if an entity matches this string.

If-Unmodified-Sincestring date-time-rfc7231

The request should only proceed if the entity was not modified after this time.

Response

The request has succeeded.

etagstring required

The ETag (or entity tag) HTTP response header is an identifier for a specific version of a resource. It lets caches be more efficient and save bandwidth, as a web server does not need to resend a full response if the content was not changed.

It is a string of ASCII characters placed between double quotes, like "675af34563dc-tr34".

idstring required

Id of a job.

channelReferencestring

Reference to an external parent context, eg. call ID.

status'pendingClassification' | 'queued' | 'assigned' | 'completed' | 'closed' | 'cancelled' | 'classificationFailed' | 'created' | 'pendingSchedule' | 'scheduled' | 'scheduleFailed' | 'waitingForActivation'

Describes the various status of a job.

enqueuedAtstring date-time

Timestamp a job was queued in UTC.

channelIdstring

The channel identifier. eg. voice, chat, etc.

classificationPolicyIdstring

Id of a classification policy used for classifying this job.

queueIdstring

Id of a queue that this job is queued to.

priorityinteger

Priority of this job. Value must be between -100 to 100.

dispositionCodestring

Reason code for cancelled or closed jobs.

labelsobject

A set of key/value pairs that are identifying attributes used by the rules engines to make decisions. Values must be primitive values - number, string, boolean.

assignmentsobject

A collection of the assignments of the job. Key is AssignmentId.

tagsobject

A set of non-identifying attributes attached to this job. Values must be primitive values - number, string, boolean.

scheduledAtstring date-time

If set, job will be scheduled to be enqueued at a given time.