Codius
APIReference

Create an OpenAI Responses-compatible response

POST
/v1/responses

Responses-compatible adapter for coding agents managed by Codius App. It uses the same model catalog, authorization, metering, limits, and request IDs as Chat Completions. Requires the inference:create scope.

Authorization

apiKey
AuthorizationBearer <token>

A Codius organization API key, sent as Authorization: Bearer codius_live_…. Keys carry a subset of the models:read, inference:create, and usage:read scopes — never billing or admin permissions.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*string
input*string|array<>
instructions?string
stream?boolean
Defaultfalse
tools?array<>
[key: string]?any

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/responses" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "input": "string"  }'
{}

Create a Messages-compatible response POST

Messages-compatible adapter used when Codius App runs Claude Code with Codius models. It uses the same authorization, metering, limits, and request IDs as Chat Completions. Requires the `inference:create` scope.

Get organization usage GET

Returns the five-hour session, weekly, and billing-cycle usage windows for the calling organization. Requires the `usage:read` scope.