BUILD WITH INFERMAX
Legacy / Simulated API
Compatibility routes for deferred instance access and simulated occupancy. Use current Compute Access and project usage for product workflows.
Access status; transport integration deferred until provider access arrives
Compatibility API. This route reports deferred access or simulated occupancy only. It does not establish live GPU access, measured utilization or provider billing.
Authorization: Bearer · project scope · management access required
Parameters
| Name / location | Requirement | Definition |
|---|---|---|
idpath | Required | {
"type": "string"
} |
Responses
200 Successful operation.
application/json
{
"type": "object",
"properties": {
"instanceId": {
"type": "string",
"format": "uuid"
},
"status": {
"type": "string",
"enum": [
"DEFERRED"
]
},
"executionMode": {
"type": "string"
},
"connection": {
"type": "string",
"nullable": true
},
"reason": {
"type": "string"
}
}
}400 Invalid request
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}401 Missing or revoked API key
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}403 Role or policy denied
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}404 Resource absent or not visible
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}409 Idempotency, capacity, quota or state conflict
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}413 Request body exceeds 64 KiB
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}422 Invalid reference
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}429 Rate limit; honor Retry-After
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}503 Dependency unavailable
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}Finalized sandbox occupancy after release; not an invoice or live GPU measurement
Compatibility API. This route reports deferred access or simulated occupancy only. It does not establish live GPU access, measured utilization or provider billing.
Authorization: Bearer · project scope · management access required
Parameters
| Name / location | Requirement | Definition |
|---|---|---|
limitquery | Optional | {
"maximum": 100,
"default": 50,
"type": "number"
} |
afterquery | Optional | {
"type": "string"
} |
Responses
200 Successful operation.
application/json
{
"type": "object",
"required": [
"items",
"nextCursor"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"project_id": {
"type": "string",
"format": "uuid"
},
"instance_id": {
"type": "string",
"format": "uuid"
},
"source_event_id": {
"type": "string"
},
"started_at": {
"type": "string",
"format": "date-time"
},
"ended_at": {
"type": "string",
"format": "date-time"
},
"gpu_seconds": {
"type": "string"
},
"unit_seconds": {
"type": "string"
},
"execution_mode": {
"type": "string",
"enum": [
"SIMULATED"
]
}
}
}
},
"nextCursor": {
"type": "string",
"format": "uuid",
"nullable": true
}
}
}400 Invalid request
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}401 Missing or revoked API key
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}403 Role or policy denied
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}404 Resource absent or not visible
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}409 Idempotency, capacity, quota or state conflict
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}413 Request body exceeds 64 KiB
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}422 Invalid reference
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}429 Rate limit; honor Retry-After
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}503 Dependency unavailable
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}Incremental simulated occupancy intervals, unknown rates; do not add to final lifetime totals
Compatibility API. This route reports deferred access or simulated occupancy only. It does not establish live GPU access, measured utilization or provider billing.
Authorization: Bearer · project scope · management access required
Parameters
| Name / location | Requirement | Definition |
|---|---|---|
limitquery | Optional | {
"maximum": 100,
"default": 50,
"type": "number"
} |
afterquery | Optional | {
"type": "string"
} |
Responses
200 Successful operation.
application/json
{
"type": "object",
"required": [
"items",
"nextCursor"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"project_id": {
"type": "string",
"format": "uuid"
},
"instance_id": {
"type": "string",
"format": "uuid"
},
"source_event_id": {
"type": "string"
},
"started_at": {
"type": "string",
"format": "date-time"
},
"ended_at": {
"type": "string",
"format": "date-time"
},
"gpu_seconds": {
"type": "string"
},
"unit_seconds": {
"type": "string"
},
"execution_mode": {
"type": "string",
"enum": [
"SIMULATED"
]
},
"resource_id": {
"type": "string",
"format": "uuid"
},
"rate_status": {
"type": "string",
"enum": [
"UNKNOWN"
]
},
"quantity_kind": {
"type": "string",
"enum": [
"OCCUPANCY"
]
},
"final_interval": {
"type": "boolean"
}
}
}
},
"nextCursor": {
"type": "string",
"format": "uuid",
"nullable": true
}
}
}400 Invalid request
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}401 Missing or revoked API key
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}403 Role or policy denied
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}404 Resource absent or not visible
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}409 Idempotency, capacity, quota or state conflict
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}413 Request body exceeds 64 KiB
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}422 Invalid reference
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}429 Rate limit; honor Retry-After
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}503 Dependency unavailable
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}Schema definitions
Expand a named definition to resolve #/components/schemas/… references in this contract. These definitions contain only schemas reachable from the published Customer operations.
ProductCatalogPage
{
"type": "object",
"additionalProperties": false,
"required": [
"items",
"nextCursor"
],
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ProductCatalogItem"
},
"maxItems": 100
},
"nextCursor": {
"type": "string",
"nullable": true
}
}
}ProductCatalogItem
{
"type": "object",
"additionalProperties": false,
"required": [
"id",
"displayName",
"family",
"modalities",
"capabilities",
"limits",
"visibility",
"entitled",
"availability",
"qualification",
"metadataSource",
"price"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"displayName": {
"type": "string"
},
"family": {
"type": "string",
"nullable": true
},
"modalities": {
"type": "array",
"items": {
"type": "string",
"enum": [
"text",
"image",
"audio",
"video"
]
},
"nullable": true
},
"capabilities": {
"$ref": "#/components/schemas/ProductCatalogCapabilities"
},
"limits": {
"$ref": "#/components/schemas/ProductCatalogLimits"
},
"visibility": {
"type": "string",
"enum": [
"PUBLISHED"
]
},
"entitled": {
"type": "boolean"
},
"availability": {
"$ref": "#/components/schemas/ProductCatalogAvailability"
},
"qualification": {
"$ref": "#/components/schemas/ProductCatalogQualification"
},
"metadataSource": {
"type": "string",
"nullable": true
},
"price": {
"type": "object",
"additionalProperties": false,
"required": [
"amount",
"currency",
"unit",
"source",
"version",
"approvedAt"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^[0-9]{1,18}([.][0-9]{1,12})?$"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"unit": {
"type": "string",
"enum": [
"MILLION_INPUT_TOKENS",
"MILLION_OUTPUT_TOKENS",
"REQUEST"
]
},
"source": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"approvedAt": {
"type": "string",
"format": "date-time"
}
},
"nullable": true
}
}
}ProductCatalogCapabilities
{
"type": "object",
"additionalProperties": false,
"required": [
"tools",
"streaming",
"structuredOutput"
],
"properties": {
"tools": {
"type": "boolean",
"nullable": true
},
"streaming": {
"type": "boolean",
"nullable": true
},
"structuredOutput": {
"type": "boolean",
"nullable": true
}
}
}ProductCatalogLimits
{
"type": "object",
"additionalProperties": false,
"required": [
"contextTokens",
"maxOutputTokens"
],
"properties": {
"contextTokens": {
"type": "integer",
"minimum": 1
},
"maxOutputTokens": {
"type": "integer",
"minimum": 1
}
}
}ProductCatalogAvailability
{
"type": "object",
"additionalProperties": false,
"required": [
"status",
"reason",
"executionMode"
],
"properties": {
"status": {
"type": "string",
"enum": [
"AVAILABLE",
"UNAVAILABLE"
]
},
"reason": {
"type": "string",
"enum": [
"NOT_ENTITLED",
"REVISION_PROOF_CURRENT",
"NO_FRESH_READY_REVISION"
]
},
"executionMode": {
"type": "string",
"enum": [
"SIMULATED",
"REAL",
null
],
"nullable": true
}
}
}ProductCatalogQualification
{
"type": "object",
"additionalProperties": false,
"required": [
"status"
],
"properties": {
"status": {
"type": "string",
"enum": [
"REAL_PROOF_CURRENT",
"FIXTURE_PROOF_CURRENT",
"UNVERIFIED"
]
}
}
}ProductManagementErrorEnvelope
{
"oneOf": [
{
"$ref": "#/components/schemas/ProductManagementFilterError"
},
{
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code"
],
"properties": {
"code": {
"enum": [
"RATE_LIMITED"
],
"type": "string"
}
}
}
}
}
]
}ProductManagementFilterError
{
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"type",
"requestId",
"retryable",
"dispatched"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"server_error",
"rate_limit_error",
"invalid_request_error"
]
},
"requestId": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"dispatched": {
"enum": [
false
],
"type": "boolean"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}ProductCatalogDetail
{
"type": "object",
"additionalProperties": false,
"required": [
"id",
"displayName",
"family",
"modalities",
"capabilities",
"limits",
"visibility",
"entitled",
"availability",
"qualification",
"metadataSource",
"price",
"apiExample",
"configurationGuidance"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"displayName": {
"type": "string"
},
"family": {
"type": "string",
"nullable": true
},
"modalities": {
"type": "array",
"items": {
"type": "string",
"enum": [
"text",
"image",
"audio",
"video"
]
},
"nullable": true
},
"capabilities": {
"$ref": "#/components/schemas/ProductCatalogCapabilities"
},
"limits": {
"$ref": "#/components/schemas/ProductCatalogLimits"
},
"visibility": {
"type": "string",
"enum": [
"PUBLISHED"
]
},
"entitled": {
"type": "boolean"
},
"availability": {
"$ref": "#/components/schemas/ProductCatalogAvailability"
},
"qualification": {
"$ref": "#/components/schemas/ProductCatalogQualification"
},
"metadataSource": {
"type": "string",
"nullable": true
},
"price": {
"type": "object",
"additionalProperties": false,
"required": [
"amount",
"currency",
"unit",
"source",
"version",
"approvedAt"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^[0-9]{1,18}([.][0-9]{1,12})?$"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"unit": {
"type": "string",
"enum": [
"MILLION_INPUT_TOKENS",
"MILLION_OUTPUT_TOKENS",
"REQUEST"
]
},
"source": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"approvedAt": {
"type": "string",
"format": "date-time"
}
},
"nullable": true
},
"apiExample": {
"type": "object",
"additionalProperties": false,
"required": [
"method",
"path",
"body"
],
"properties": {
"method": {
"type": "string",
"enum": [
"POST"
]
},
"path": {
"type": "string",
"enum": [
"/v1/chat/completions"
]
},
"body": {
"type": "object",
"additionalProperties": false,
"required": [
"model",
"messages",
"stream",
"max_tokens"
],
"properties": {
"model": {
"type": "string"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"role",
"content"
],
"properties": {
"role": {
"type": "string",
"enum": [
"user"
]
},
"content": {
"type": "string"
}
}
},
"minItems": 1,
"maxItems": 1
},
"stream": {
"enum": [
false
],
"type": "boolean"
},
"max_tokens": {
"type": "integer",
"minimum": 1,
"maximum": 128
}
}
}
},
"nullable": true
},
"configurationGuidance": {
"type": "array",
"items": {
"type": "string"
}
}
}
}ManagedQuoteInput
{
"type": "object",
"properties": {
"offerId": {
"type": "string"
},
"requestedEndAt": {
"type": "string"
}
},
"required": [
"offerId",
"requestedEndAt"
]
}WaitlistInput
{
"type": "object",
"properties": {
"intentId": {
"type": "string"
},
"email": {
"type": "boolean"
}
},
"required": [
"intentId",
"email"
]
}ReservationInput
{
"type": "object",
"properties": {
"acceptedQuoteId": {
"type": "string",
"description": "Exact immutable liability quote accepted for a budget-controlled allocation."
},
"acceptedPolicyId": {
"type": "string",
"description": "Exact approved compute policy accepted by customer; required for policy-backed supply."
},
"offerId": {
"type": "string"
},
"units": {
"type": "number",
"example": 1,
"description": "Whole allocation units, not fractional GPUs."
},
"requestedEndAt": {
"type": "string",
"example": "2026-11-01T12:00:00Z",
"description": "UTC end time, within 31 days. Expiry triggers operator review, not automatic destruction."
}
},
"required": [
"offerId",
"units",
"requestedEndAt"
]
}InstanceInput
{
"type": "object",
"properties": {
"reservationId": {
"type": "string"
}
},
"required": [
"reservationId"
]
}Object
{
"type": "object",
"properties": {}
}