GET

Labels

List every label your key can use. Pass the full tag list to an AI assistant before it creates cards, so it picks from labels that already exist.

Request

GET /api/v1/labels

Field	Type	Required	Description
`projectId`	string	No	Only return labels in this project.
`organizationId`	string	No	Only return labels in this organization.

curl "https://projavo.com/api/v1/labels?organizationId=<organization-id>" \
  -H "Authorization: Bearer $PROJAVO_API_KEY"

Response

Response 200

{
  "labels": [
    {
      "id": "<label-id>",
      "name": "Bug",
      "color": "#6B7280",
      "projectId": "<project-id>",
      "projectKey": "PLT",
      "projectName": "Public"
    }
  ]
}

Caution

Labels belong to a project. A card can only use labels from the project that its list belongs to. If you create a card with labels from another project, the API returns 422.

Errors

Status	Code	Meaning
`401`	`missing_key`	No API key was sent.
`403`	`insufficient_scope`	The key lacks the read permission.
`429`	Rate limit	The key passed 60 requests per minute.