
Get an Origin Label via the API
Read one repository label by name with GET https://api.cursor.com/v1/origin/repos/{ownerSlug}/{repoName}/labels/{labelName}. Official reference: Origin API → Get Label (OpenAPI OriginService_GetLabel). Changelog entry: August 26, 2026.
Origin is in Early Beta and subject to change. Authenticate with an installation access token (oit_…) or a user access token that carries repository:labels:read. Availability: Early Beta per the API overview.
Cost: 1 point against the principal budget (ordinary read).
Path parameters
| Param | Required | Meaning |
|---|---|---|
ownerSlug |
yes | Owning entity's unique slug |
repoName |
yes | Repo name, unique to the owner |
labelName |
yes | Label name; leading/trailing whitespace trimmed before lookup |
An unknown name returns 404. A 404 never distinguishes a missing label from one your installation cannot reach.
curl --request GET \
--url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME/labels/bug' \
--header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'
Response
200 returns a single Label:
{
"id": "lbl_01k2ja2000e0080000000000m1",
"name": "bug",
"color": "d73a4a",
"description": "Something isn't working"
}
color is six-character hex without a leading #. List every definition with List Labels when you need pagination.
Base URL: https://api.cursor.com/v1/origin.