API / get-origin-label-via-api

API

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.