The Get skill endpoint returns details for a single routing skill.

Requirements: Base URL, Authentication, Error codes

Scope: routing.queues.read

What this does

When you send a Get skill request with a skill ID,

When to use it

• Display skill details in an admin or reporting tool
• Validate a skill ID returned by Get list of skills

Prerequisites

• The skill must exist in the contact center.
• You must have access to the skill.

Endpoint

GET /api/v4/routing/skills/{skill_id}

Path parameters

• skill_id
  The unique identifier of the skill.

Examples

Minimal request

curl -X GET "https://{cluster_id}.voiso.com/api/v4/routing/skills/1" \
  -H "Authorization: Bearer <contact_center_api_key>" \
  -H "Content-Type: application/json"

Response

If successful, the API returns a skill object.

{
  "skill": {
    "id": 1,
    "name": "Sales"
  }
}

Troubleshooting

401 Unauthorized

What to check:

• You are sending Authorization: Bearer <contact_center_api_key>.
• Your Base URL includes the correct {cluster_id}.

403 Forbidden

What to check:

• The API key is valid, but does not have access to this skill.

404 Not found

This usually means the skill ID does not exist, or you do not have access to it.

What to check:

• Confirm the skill ID using Get list of skills.

Example response:

{ "error": "Not found" }

429 Too many requests

What to do:

• Reduce request frequency and retry with backoff.

Example response:

{ "error": "Too many requests" }