Get a role

Fetch one role in the curated v1 shape. Scope: roles:read.

GET/api/v1/roles/{id} 🔒 API key

Fetches a single role (job). Scope: roles:read. A role the key cannot see returns 404 (no existence leak).

Path parameters

Parameter	Type	Description
`id`	string	The role id.

curl https://app.talent-ray.com/api/v1/roles/role_eng_be \
  -H "Authorization: Bearer tr_YOUR_KEY"

200 OK — a single role object (same shape as the items in List roles).

Status	Meaning
`200`	Success.
`401`	No valid API key.
`403`	`insufficient_scope` — the key lacks `roles:read`.
`404`	Not found, or not visible to the key.
`429`	Rate limit exceeded.