Delete Routing Skill

delete

https://api.regal.ai/v1/routing-skills/{name}

API Details

Deletes a routing skill from the catalog of the brand. Without force, nothing is deleted while agents, queues or routing rule sets use the routing skill, and the response lists them. With force=true, the routing skill is removed from the agents that have it and deleted. Queues and routing rule sets are never changed: the ones that use the routing skill are returned in unclearedReferences, and their detection is best effort because their expressions are free text. These are the routing skills that agents have, and that queues and routing rules use, not Copilot skills.

Rate Limit

Limit Type	Value
Requests per second	10

If you exceed this limit, you will receive a 429 Rate Limit Exceeded response.

Responses

403

The user is not a brand admin.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The routing skill was deleted

400Invalid name or query parameters, or the routing skill is one of the built-in ones (routing_skill_protected), which cannot be deleted with or without force.

404The brand has no routing skill with this name (routing_skill_not_found).

409Agents, queues or routing rule sets use the routing skill and force is not true (routing_skill_in_use). details lists them, up to 25 of each, with the full total.

429Exceeded rate limit.