Skip to main content
These rules apply to all Teams OpenAPI endpoints unless an endpoint doc says otherwise.

Base URL

Production: https://api.qoder.com Example full URL: https://api.qoder.com/v1/organizations/{organization_id}/members

Field naming

JSON uses lowerCamelCase, for example: organizationId, repositoryUrl, createdAt, maxResults, nextToken

Timestamps

Use ISO 8601 (RFC 3339), e.g. 2025-01-01T00:00:00Z. Some query parameters also accept Unix time in milliseconds—check each endpoint.

Cursor pagination

List endpoints typically use cursor pagination:

Query parameters

ParameterTypeRequiredDefaultDescription
maxResultsintegerNo20Page size, max 100
nextTokenstringNoCursor from the previous response; omit on the first page
Some usage endpoints use a dedicated cursor such as nextCredits—see that endpoint’s docs.

Response fields

FieldTypeDescription
maxResultsintegerPage size used for this response
nextTokenstringNext page cursor; empty or omitted means end of list
Do not rely on a global totalCount; page until the cursor is empty.

Error responses

On failure, HTTP status is non-2xx and the body is JSON without a top-level status field. Shape:
{
  "requestId": "req_abc123",
  "code": "NotFound",
  "message": "resource not found",
  "details": ["the requested resource does not exist"]
}

Error object fields

FieldTypeRequiredDescription
requestIdstringYesCorrelation ID—include when contacting support
codestringYesStable code for programmatic handling
messagestringYesHuman-readable summary
detailsarrayNoOptional extra context

Common HTTP status and code values

HTTPExample codeMeaning
400BadRequestInvalid input
401UnauthorizedMissing or invalid API key
403ForbiddenNot allowed for this org or resource
404NotFoundResource not found
409AlreadyExistsConflict
500InternalErrorServer error
After gateway or service mapping, the pair of HTTP status and code is defined by the actual response—do not rely on status alone.

Authentication

Send:
Authorization: Bearer <api_key>
Use the key created in the console. Never ship real keys in public clients or repositories.

Organization path prefix

Most routes extend: /v1/organizations/{organization_id} organization_id is a path parameter. See Member, Usage, and AI code metrics sections for subpaths.