Overview

Programmatic access to issues, conversations, products, and releases. Authenticate with an API key from your workspace settings.

Base URL

https://app.getresolved.ai/api/v1

Authentication

Send your key in the Authorization header. Keys start with gr_ and are scoped to a single workspace — every response is filtered to that workspace.

curl https://app.getresolved.ai/api/v1/issues?status=pending \
  -H "Authorization: Bearer gr_..."

Response format

List endpoints return:

{
  "data": [],
  "pagination": { "total": 0, "limit": 50, "offset": 0 }
}

Single-resource endpoints return:

{ "data": { } }

Errors return:

{ "error_code": "...", "detail": "..." }

Pagination

All list endpoints accept limit (default 50, max 200) and offset (default 0).

Status flows

• Issues: pending → in_progress → done → released | dismissed. released is set automatically when the issue is linked to a release via POST /releases. icebox is also a valid status, for parking issues you want to keep without committing to.
• Conversations: open → in_progress → resolved | dismissed.

Discovery

• OpenAPI 3.1 spec — machine-readable schema for tooling and SDK generation.
• llms.txt — full endpoint reference in plain markdown, optimized for AI agents.

Deprecated aliases

• /api/v1/actions is a deprecated alias for /api/v1/issues and works identically.
• /api/v1/items is a deprecated alias for /api/v1/conversations and works identically.