# Azure Communication Services Job Router API **Canonical:** https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-jobrouter-api/ **Provider:** Microsoft Azure Communication Services — https://apis.io/providers/microsoft-azure-communication-services/ **Base URL:** https://{resource}.communication.azure.com/ **Documentation:** https://learn.microsoft.com/en-us/rest/api/communication/ Azure Communication Services Job Router API is one of 10 APIs that [Microsoft Azure Communication Services](https://apis.io/providers/microsoft-azure-communication-services/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Routing and Contact Center. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas. Job Router API: distribution policies, queues, classification policies, exception policies, jobs and workers for routing work. 33 operations, data-plane version 2023-11-01, served from the customer's Communication Services resource endpoint. ## Operations (33) | Method | Path | Summary | |---|---|---| | GET | `/routing/classificationPolicies` | Retrieves existing classification policies. | | GET | `/routing/classificationPolicies/{classificationPolicyId}` | Retrieves an existing classification policy by Id. | | PATCH | `/routing/classificationPolicies/{classificationPolicyId}` | Creates or updates a classification policy. | | DELETE | `/routing/classificationPolicies/{classificationPolicyId}` | Delete a classification policy by Id. | | GET | `/routing/distributionPolicies` | Retrieves existing distribution policies. | | GET | `/routing/distributionPolicies/{distributionPolicyId}` | Retrieves an existing distribution policy by Id. | | PATCH | `/routing/distributionPolicies/{distributionPolicyId}` | Creates or updates a distribution policy. | | DELETE | `/routing/distributionPolicies/{distributionPolicyId}` | Delete a distribution policy by Id. | | GET | `/routing/exceptionPolicies` | Retrieves existing exception policies. | | GET | `/routing/exceptionPolicies/{exceptionPolicyId}` | Retrieves an existing exception policy by Id. | | PATCH | `/routing/exceptionPolicies/{exceptionPolicyId}` | Creates or updates a exception policy. | | DELETE | `/routing/exceptionPolicies/{exceptionPolicyId}` | Deletes a exception policy by Id. | | GET | `/routing/jobs` | Retrieves list of jobs based on filter parameters. | | GET | `/routing/jobs/{jobId}` | Retrieves an existing job by Id. | | PATCH | `/routing/jobs/{jobId}` | Creates or updates a router job. | | DELETE | `/routing/jobs/{jobId}` | Deletes a job and all of its traces. | | POST | `/routing/jobs/{jobId}:reclassify` | Reclassify a job. | | POST | `/routing/jobs/{jobId}:cancel` | Submits request to cancel an existing job by Id while supplying free-form cancellation reason. | | POST | `/routing/jobs/{jobId}/assignments/{assignmentId}:complete` | Completes an assigned job. | | POST | `/routing/jobs/{jobId}/assignments/{assignmentId}:close` | Closes a completed job. | | POST | `/routing/jobs/{jobId}/assignments/{assignmentId}:unassign` | Unassign a job. | | GET | `/routing/jobs/{jobId}/position` | Gets a job's position details. | | GET | `/routing/queues` | Retrieves existing queues. | | GET | `/routing/queues/{queueId}` | Retrieves an existing queue by Id. | | PATCH | `/routing/queues/{queueId}` | Creates or updates a queue. | | DELETE | `/routing/queues/{queueId}` | Deletes a queue by Id. | | GET | `/routing/queues/{queueId}/statistics` | Retrieves a queue's statistics. | | GET | `/routing/workers` | Retrieves existing workers. | | GET | `/routing/workers/{workerId}` | Retrieves an existing worker by Id. | | PATCH | `/routing/workers/{workerId}` | Creates or updates a worker. | | DELETE | `/routing/workers/{workerId}` | Deletes a worker and all of its traces. | | POST | `/routing/workers/{workerId}/offers/{offerId}:accept` | Accepts an offer to work on a job and returns a 409/Conflict if another agent accepted the job already. | | POST | `/routing/workers/{workerId}/offers/{offerId}:decline` | Declines an offer to work on a job. | ## Machine-readable artifacts (9) - **OpenAPI** — https://artifacts.apis.io/microsoft-azure-communication-services/openapi/microsoft-azure-communication-services-jobrouter-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/communication/data-plane/JobRouter/stable/2023-11-01/communicationservicejobrouter.json - **Documentation** — https://learn.microsoft.com/en-us/azure/communication-services/ - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-router-job-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-router-worker-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-router-job-create-or-update-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-router-worker-create-or-update-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-classification-policy-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-router-queue-schema.json ## Other Microsoft Azure Communication Services APIs (9) - [Azure Communication Services Call Automation API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-callautomation-api/) - [Azure Communication Services Chat API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-chat-api/) - [Azure Communication Services Email API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-email-api/) - [Azure Communication Services Identity API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-identity-api/) - [Azure Communication Services Advanced Messaging API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-messages-api/) - [Azure Communication Services Phone Numbers API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-phonenumbers-api/) - [Azure Communication Services Rooms API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-rooms-api/) - [Azure Communication Services SIP Routing API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-siprouting-api/) - [Azure Communication Services SMS API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-sms-api/) ## Tags Routing, Contact Center --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-jobrouter-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-azure-communication-services/.