Skip to main content
GET
Go (SDK)

Authorizations

Authorization
string
header
required

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

generation_id
string
required

Response

Successful Response

api.md ยง3's generation record. Built from the row field by field, never from_attributes: the row also carries the image digest (architecture.md ยง2.15).

id
string
required
state
enum<string>
required
Available options:
pending,
running,
publishing,
succeeded,
failed,
cancelling,
cancelled
reason
GenerationReason ยท object | null
required

api.md ยง3 reason.

generator
GeneratorRef ยท object
required
params
Params ยท object
required
params_hash
string
required
output
OutputRef ยท object
required
inputs
Inputs ยท object
required
counts
Counts ยท object | null
required
llm
LlmRef ยท object
required
limits
Limits ยท object
required

api.md ยง2 limits / default_limits on the wire: B.1's contract.Limits, with max_cost optional and deprecated in the schema while every response still carries it as a number (MK1-722, step 1 of MK1-719). The two must otherwise agree field for field.

usage
GenerationUsage ยท object | null
required

api.md ยง3 usage, the shape of the runtime's llm.Usage.

job
JobRef ยท object | null
required
name
string | null
required
derived_from
string[]
required
created_by
CreatedBy ยท object
required
created_at
string<date-time>
required
started_at
string<date-time> | null
required
terminal_at
string<date-time> | null
required