GET

Boards

Read boards with your API key. Use these endpoints to find where a card can go before you create or move it.

List boards

GET /api/v1/boards

Returns every board your key can access, newest first.

Field	Type	Required	Description
`organizationId`	string	No	Only return boards in this organization.

curl https://projavo.com/api/v1/boards \
  -H "Authorization: Bearer $PROJAVO_API_KEY"

Response 200

{
  "boards": [
    {
      "id": "<board-id>",
      "key": "<board-key>",
      "name": "Sprint 24",
      "description": "Platform team sprint board",
      "color": null,
      "project": { "id": "<project-id>", "key": "PLT", "name": "Platform" },
      "organization": { "id": "<organization-id>", "slug": "northwind", "name": "Northwind Studio" }
    }
  ]
}

Get one board

GET /api/v1/boards/:boardId

One call returns the board, its lists (the columns or categories), and the parent project's labels (tags). Use it to choose a destination before you create or move a card.

curl https://projavo.com/api/v1/boards/<board-id> \
  -H "Authorization: Bearer $PROJAVO_API_KEY"

Response 200

{
  "board": { "id": "<board-id>", "key": "<board-key>", "name": "Sprint 24", "description": "Platform team sprint board", "color": null },
  "project": { "id": "<project-id>", "key": "PLT", "name": "Platform" },
  "lists": [
    { "id": "<list-id>", "name": "Backlog", "position": 0, "icon": "circle", "iconColor": "#6b7280" },
    { "id": "<list-id-2>", "name": "In progress", "position": 1, "icon": "loader", "iconColor": "#f0a012" }
  ],
  "labels": [
    { "id": "<label-id>", "name": "Bug", "color": "#d6402a" },
    { "id": "<label-id-2>", "name": "Backend", "color": "#2350d0" }
  ]
}

Note

Pass a lists[].id as the listId when you create a card or move a card. Pass any labels[].id values as labelIds. To read cards, filter by boardId, listId, and optionally a labelId, such as the Bug label.

Errors

Status	Code	Meaning
`401`	`missing_key`	No API key was sent.
`403`	`insufficient_scope`	The key lacks the read permission.
`404`	`not_found`	The board does not exist or is not accessible to this key.
`429`	Rate limit	The key passed 60 requests per minute.

The list endpoint has no 404 case. It returns only the boards your key can access.