API reference/Projects

List the organisation's projects

GET /v1/orgs/{orgId}/projects

Newest first unless sort says otherwise; sort by one of created_at, updated_at or name. Paginate with cursor.

Authorization

bearer

Authorizationheader · stringrequired

Session token from POST /v1/auth/login with "transport": "bearer". Browsers use the session cookie that login sets instead.

Path

orgIdstringrequired

maxLength: 64

Query

limitinteger

Maximum number of items to return (default 20, max 100)

format: int64minimum: 0maximum: 100

cursorstring

Opaque cursor from a previous response's next_cursor

maxLength: 512

sortstring

Comma-separated sort fields; prefix a field with - for descending order

maxLength: 200

statusstring

Only projects with this status

one of: active, archived

Responses

errors: application/problem+json

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

Unprocessable Entity

500

Internal Server Error

Match errors on the problem's code, which stays the same, not on its message.

req, err := http.NewRequestWithContext(ctx, http.MethodGet, apiURL + "/v1/orgs/" + orgID + "/projects", nil) if err != nil { return err } req.Header.Set("Authorization", "Bearer "+token) res, err := http.DefaultClient.Do(req) if err != nil { return err } defer res.Body.Close()

{ "items": [ { "created_at": "2026-09-15T12:00:00Z", "created_by": "usr_mfrggzdfmztwq2lkmfrggzdfmy", "description": "string", "id": "prj_mfrggzdfmztwq2lkmfrggzdfmy", "name": "string", "status": "active", "updated_at": "2026-09-15T12:00:00Z", "version": 1 } ], "next_cursor": "string" }

{ "code": "string", "status": 422, "title": "Unprocessable Entity", "detail": "string", "errors": [ { "message": "expected length >= 1", "location": "body.name" } ], "request_id": "req_9f86d081884c7d65", "type": "string" }