--- title: Session Events | Luma Agents --- GET /v1/sessions/{session\_id}/events Select code samplecURL (shell:curl) ```js const url = 'https://agents.lumalabs.ai/v1/sessions/example/events'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```sh curl --request GET \ --url https://agents.lumalabs.ai/v1/sessions/example/events \ --header 'Authorization: Bearer ' ``` - Productionagents.lumalabs.ai/v1/sessions/{session\_id}/events One page of the session's event log, in `seq` order. ## Authorizations - **[BearerAuth](/api/agents/index.md#bearerauth)** ## Parameters ### Path Parameters **session\_id** required *Session Id* string ### Query Parameters **after\_seq** Any of: - [string](#tab-panel-0-0) - [null](#tab-panel-0-1) string null JSON page: return events with seq greater than this. Default 0. **limit** Any of: - [string](#tab-panel-1-0) - [null](#tab-panel-1-1) string null JSON page: page size, 1-500. Default 100. **types** Any of: - [string](#tab-panel-2-0) - [null](#tab-panel-2-1) string null JSON page: comma-separated wire event types to include. **run\_id** Any of: - [string](#tab-panel-3-0) - [null](#tab-panel-3-1) string null JSON page: only this run's events. ## Responses ### 200 One page of the session's event log, in seq order. Media typeapplication/json *SessionEventListResponse* One page of a session's event log, in seq order. object **data** required *Data* Array Any of: - [TruncatedSessionEvent](#tab-panel-4-0) - [object](#tab-panel-4-1) *TruncatedSessionEvent* An over-cap recorded event: the envelope, its identity fields, and truncated. object **abandoned\_invocation\_ids** *Abandoned Invocation Ids* Tool calls the stopped attempt started that got no result. Empty when it started none. Array\ **agent** *Agent* string **artifact\_rsid** *Artifact Rsid* Durable id of the generated artifact. string **asset\_id** *Asset Id* string **attachment\_id** *Attachment Id* The attachment id returned by POST /v1/attachments. string **code** *Code* Registered SESSION.\* error code. string **continuation** *Continuation* True when the server resumed after its own jobs finished. boolean **created\_at** required *Created At* ISO-8601 time the event was recorded. string **credits\_remaining** *Credits Remaining* Remaining credit balance at the time of this warning. integer **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **hold\_credits** *Hold Credits* Credits this quote would add to the run, held on accept. integer **id** required *Id* Opaque event id (sevt\_…). string **input\_seq** *Input Seq* The seq of the recorded input this failure answers. integer **interaction** *Interaction* Discriminated by 'kind': approve | select | text\_input | confirm for an ask\_user question (see InteractionRequest in the SDK types for the full shape), or review for an app's review gate, which carries the tool and params it presented. object ***key*** additional properties any **invocation\_id** *Invocation Id* string **is\_error** *Is Error* boolean **job\_id** *Job Id* string **kind** *Kind* string **mutated\_by** *Mutated By* Tool/stage that performed the mutation, e.g. plan\_storyboard. string **operation** *Operation* The command the app authorizes the call as. string **pending\_event\_id** *Pending Event Id* Identifier of the event that failed delivery. string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **quote\_id** *Quote Id* Identifier of the offered quote, echoed back on accept. string **reason** *Reason* string **retry\_status** *Retry Status* Retrying — the server is retrying; exhausted — this turn is over, a new input may succeed; terminal — the session cannot continue. string Allowed values: retrying exhausted terminal **revision** *Revision* New artifact revision after this mutation. integer **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **skill\_name** *Skill Name* Skill name (durable slug, inline playbook name, or the name of a partner skill the session attached). string **source** *Source* Where the skill came from: a partner skill the session attached (client), or a durable slug on the same menu (slug). inline is reserved and not emitted: inline playbooks are injected, never read. string Allowed values: slug inline client **stage** *Stage* string **state** *State* string **status** *Status* string **stop\_reason** *StopReason* Why the session went idle. pending is present only for requires\_action; code, message and retryable only for error. object **code** *Code* Error only: the registered session error code. string **message** *Message* Error only: a message safe to show the user. string **pending** *Pending* Array\ *PendingAction* One thing the session is waiting on the caller for. Answer it by its domain id. object **action\_id** *Action Id* Connector\_action: answer with user.connector\_action. string **answer\_format** *GateAnswerFormat* Gate: the verdict a typed answer takes and the revision targets it may name. object **revision\_targets** required *Revision Targets* What a revise verdict may name, each sample included; empty when the gate names none. Array\ **verdict\_schema** required *Verdict Schema* JSON schema of the verdict. object ***key*** additional properties any **answer\_type** *Answer Type* The input type that answers it. Send this type; kind alone does not determine it. string Allowed values: user.tool\_result user.gate\_verdict user.consent **event\_id** *Event Id* Id of the blocking event (agent.custom\_tool\_use, agent.gate, session.consent\_required, connector.action\_required), for display and de-duplication. Absent when that event is not in the log; key answers on invocation\_id, quote\_id or action\_id. string **expires\_at** *Expires At* string **hold\_credits** *Hold Credits* Consent: credits held on accept. integer **how\_to\_answer** *How To Answer* Gate: how to get the answer from the user and send it. string **invocation\_id** *Invocation Id* Custom\_tool and gate: the id the answer echoes. answer\_type names the input that answers it. string **kind** required *Kind* string Allowed values: custom\_tool gate consent connector\_action **offer** *ConsentOffer* Consent: which offer it is. finals is the review's first paid commitment; top\_up adds credits to a run that already has one. string Allowed values: finals top\_up **quote\_id** *Quote Id* Consent: answer with user.consent. string **run\_id** *Run Id* string **show** *Show* Gate: the rendered samples the review asks about. Show them to the user before asking. Array\ *GateShownAsset* One rendered sample a review gate asks about, named by the revision target a revise verdict uses for it. object **asset\_id** required *Asset Id* The sample render's asset id. string **target** required *Target* The revision target that names this sample in answer\_format.revision\_targets. string **unit** *Unit* The ad unit or format the sample was rendered for, e.g. square. string **text** *Text* Gate: the source and translated copy the review asks about, as it stands now. Show it to the user before asking. Array\ *GateReviewText* One line of copy a review gate asks a person to approve: text to show, not instructions. object **label** required *Label* The language and role of the copy, e.g. English · headline. string **target** required *Target* The revision target that owns this copy in answer\_format.revision\_targets. string **text** required *Text* The current copy to approve, including the user's own edits. string **units** *Units* Consent: the priced lines hold\_credits is the sum of. Array\ *QuotedUnitRef* One priced line of a quote: a batch of planned finals that share a tier and a set of pricing dimensions. The pricing policy id the server rates against is deliberately not on the wire — it is an internal join key. object **dimensions** required *Dimensions* Pricing dimensions for this line, as a flat map of dimension name to value, e.g. resolution to 1080p. object ***key*** additional properties any **quantity** required *Quantity* Number of units on this line. integer **rate\_credits** required *Rate Credits* Credits per unit. Zero means unpriced in this environment, never free. integer **tier** required *Tier* Pricing tier these units are rated against, e.g. the app-declared action type. string **retryable** *Retryable* Error only: whether sending the request again could succeed. The session stays open. boolean **type** required *Type* string Allowed values: end\_turn requires\_action budget\_reached interrupted error **tool** *Tool* string **tree** *Tree* boolean **truncated** required *Truncated* Always true: only identity fields were kept. boolean **turn\_id** *Turn Id* string **type** required *Type* The wire type. string One of: discriminator: type - [AgentCustomToolUseRecord](#tab-panel-5-0) - [AgentDoneRecord](#tab-panel-5-1) - [AgentGateRecord](#tab-panel-5-2) - [AgentMessageRecord](#tab-panel-5-3) - [AgentPreviewRecord](#tab-panel-5-4) - [AgentSkillActivatedRecord](#tab-panel-5-5) - [AgentStartedRecord](#tab-panel-5-6) - [AgentToolResultRecord](#tab-panel-5-7) - [AgentToolUseRecord](#tab-panel-5-8) - [ArtifactAttachmentReadyRecord](#tab-panel-5-9) - [ArtifactReadyRecord](#tab-panel-5-10) - [JobCompletedRecord](#tab-panel-5-11) - [JobFailedRecord](#tab-panel-5-12) - [JobStartedRecord](#tab-panel-5-13) - [PlanUpdatedRecord](#tab-panel-5-14) - [RunCompletedRecord](#tab-panel-5-15) - [RunStartedRecord](#tab-panel-5-16) - [SessionBudgetWarningRecord](#tab-panel-5-17) - [SessionConfigChangedRecord](#tab-panel-5-18) - [SessionConsentRequiredRecord](#tab-panel-5-19) - [SessionContextCompactingRecord](#tab-panel-5-20) - [SessionErrorRecord](#tab-panel-5-21) - [SessionInputFailedRecord](#tab-panel-5-22) - [SessionStatusIdleRecord](#tab-panel-5-23) - [SessionStatusRunningRecord](#tab-panel-5-24) - [SessionStatusTerminatedRecord](#tab-panel-5-25) - [SessionTurnRetriedRecord](#tab-panel-5-26) - [SessionUsageRecord](#tab-panel-5-27) - [StageDoneRecord](#tab-panel-5-28) - [StageStartedRecord](#tab-panel-5-29) - [UserMessageRecord](#tab-panel-5-30) - [UserInterruptRecord](#tab-panel-5-31) - [UserToolResultRecord](#tab-panel-5-32) - [UserGateVerdictRecord](#tab-panel-5-33) - [UserCommandRecord](#tab-panel-5-34) - [UserConsentRecord](#tab-panel-5-35) *AgentCustomToolUseRecord* A client-side tool invocation. The SDK must call the registered clientToolHandler and answer with the input answer\_type names (POST /v1/sessions/{session\_id}/events) carrying this invocation\_id. The optional run\_id correlates explicit executions. object **agent** *Agent* string **answer\_type** *Answer Type* The input type that answers this invocation. On a webhook tool call, the type the reply to its delivery takes. string Allowed values: user.tool\_result user.gate\_verdict **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **invocation\_id** required *Invocation Id* Must be echoed back on the input that answers it. string **params** required *Params* Input parameters. object ***key*** additional properties any **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **tool** required *Tool* Tool name as registered in createSession(). string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: agent.custom\_tool\_use *AgentDoneRecord* A sub-agent finished its delegated task. object **agent** required *Agent* string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **summary** required *Summary* One-sentence summary of what the sub-agent accomplished. string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: agent.done *AgentGateRecord* The agent is requesting user input to continue. Render the appropriate UI widget and answer with the input answer\_type names (POST /v1/sessions/{session\_id}/events) carrying interaction.invocation\_id. The optional run\_id correlates explicit executions. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **answer\_type** *Answer Type* The input type that answers this request. string Allowed values: user.tool\_result user.gate\_verdict **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **interaction** required *Interaction* Discriminated by 'kind': approve | select | text\_input | confirm for an ask\_user question (see InteractionRequest in the SDK types for the full shape), or review for an app's review gate, which carries the tool and params it presented. object ***key*** additional properties any **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: agent.gate *AgentMessageRecord* The full final text of the most recent assistant turn. Use for replacement if delta accumulation diverged. object **agent** *Agent* string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **text** required *Text* Complete text of the assistant message. string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: agent.message *AgentPreviewRecord* The agent is presenting a grid of generated options for user selection. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **assets** required *Assets* Options to display. Array\ *PreviewAsset* A single option in a preview grid. object **asset\_id** required *Asset Id* string **state** required *State* string Allowed values: generating ready failed **thumbnail\_url** *Thumbnail Url* string **type** required *Type* Asset media type. string Allowed values: image video model3d **url** *Url* string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **select\_mode** required *Select Mode* Whether the user should pick one or multiple. string Allowed values: single multi **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: agent.preview *AgentSkillActivatedRecord* The agent read a skill for the first time in this session. Fires once per skill per session, on its first successful read or read\_skill, and only in a session that attached partner skills; other sessions never emit it. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **skill\_id** *Skill Id* The id of the partner skill that was read. Absent for every other source. string **skill\_name** required *Skill Name* Skill name (durable slug, inline playbook name, or the name of a partner skill the session attached). string **source** required *Source* Where the skill came from: a partner skill the session attached (client), or a durable slug on the same menu (slug). inline is reserved and not emitted: inline playbooks are injected, never read. string Allowed values: slug inline client **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: agent.skill\_activated **version** *Version* The pinned version of the partner skill that was read. Absent for every other source. integer *AgentStartedRecord* The orchestrator delegated work to a named sub-agent. object **agent** required *Agent* Sub-agent name as defined in createSession().agents. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **task** required *Task* Brief description of the delegated task. string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: agent.started *AgentToolResultRecord* A tool the server ran finished, successfully or not. object **agent** *Agent* string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **error** *Error* string **id** required *Id* Opaque event id (sevt\_…). string **invocation\_id** required *Invocation Id* string **is\_error** required *Is Error* boolean **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **result** *Result* **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: agent.tool\_result *AgentToolUseRecord* A tool the server runs itself began executing. No client action required — a tool the caller answers announces as agent.custom\_tool\_use instead. object **agent** *Agent* string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **invocation\_id** required *Invocation Id* Stable identifier for this invocation; matches agent.tool\_result. string **params** required *Params* Input parameters passed to the tool. object ***key*** additional properties any **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **tool** required *Tool* Tool name. string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: agent.tool\_use *ArtifactAttachmentReadyRecord* The artifact ingest pipeline for an uploaded attachment reached a terminal state. status='ready' means moderation passed. status='rejected' means it failed. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **attachment\_id** required *Attachment Id* The attachment id returned by POST /v1/attachments. string **content\_type** required *Content Type* string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **session\_id** required *Session Id* string **status** required *Status* 'ready' = pipeline passed; 'rejected' = moderation failed. string Allowed values: ready rejected **thumbnail\_url** *Thumbnail Url* Presigned URL to thumbnail variant, if generated. string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: artifact.attachment\_ready **url** required *Url* Presigned GET URL. Expires in 1 hour. string *ArtifactReadyRecord* A generated artifact landed at its plan-artifact coordinates (keyframe image, segment video, reference image, or stitched output). object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **artifact\_rsid** required *Artifact Rsid* Durable id of the generated artifact. string **coords** required *StageCoords* Where in the plan artifact this asset landed. object **keyframe\_index** *Keyframe Index* integer **layer\_index** *Layer Index* integer **reference\_id** *Reference Id* string **segment\_index** *Segment Index* integer **source\_rsid** *Source Rsid* string **stage** required *Stage* Stage that produced the artifact, e.g. render\_keyframes. string **variant\_index** *Variant Index* integer **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **thumbnail\_url** *Thumbnail Url* Presigned URL to a thumbnail variant. string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: artifact.ready **url** required *Url* Presigned URL to the asset. Expires; re-fetch via GET. string *JobCompletedRecord* A GPU job finished. The server will automatically continue the agent turn. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **credits\_charged** *Credits Charged* Credits this job cost. The settled value when a settlement row exists, otherwise the dispatch estimate. Absent when neither exists yet. integer **credits\_estimated** *Credits Estimated* True when credits\_charged is the dispatch estimate rather than a settled charge. boolean **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **duration\_s** *Duration S* Wall-clock seconds from submission to completion. number **id** required *Id* Opaque event id (sevt\_…). string **job\_id** required *Job Id* string **model** *Model* Model id that produced the outputs. string **outputs** required *Outputs* Generated assets. Array\ *OutputRef* A reference to a generated asset ready for delivery. object **asset\_id** *Asset Id* Durable artifact identifier for this output. string **duration\_s** *Duration S* Duration in seconds, for video outputs. number **height** *Height* Pixel height, for image and video outputs. integer **job\_id** *Job Id* Backend job identifier that produced this output. string **layer** *OutputLayer* Per-layer semantics, on the outputs of a layering job: run.completed, job.completed, turn outputs, and the run and job reads. Outputs are ordered front to back; the last is the background. object **alpha\_hint** required *Alpha Hint* Edge treatment of the layer's transparency — soft (hair/fur/glass), hard (solid edges), or none (the opaque background). string Allowed values: soft hard none **bounds** *OutputLayerBounds* Placement of this layer's pixels within the composite canvas. Absent only when the output's dimensions could not be resolved. object **canvas\_height** required *Canvas Height* Height of the full composite canvas the layers reassemble into. integer **canvas\_width** required *Canvas Width* Width of the full composite canvas the layers reassemble into. integer **height** required *Height* Pixel height of the returned layer image. integer **width** required *Width* Pixel width of the returned layer image. integer **x** required *X* Left offset of this layer's pixels within the composite canvas. integer **y** required *Y* Top offset of this layer's pixels within the composite canvas. integer **contains\_text** *Contains Text* Whether the layer was planned as typeset text (a headline, caption, or label) rather than an image element. Absent when not reported for this output. boolean **description** required *Description* Complete-element caption for the layer's content. string **index** required *Index* Layer position, front-to-back; the last layer is the background. integer **label** required *Label* Short (1-2 word) layer name. string **text** *OutputLayerText* The text read off a contains\_text layer, so it can be re-typeset as live text inside bounds. Absent when the layer holds no text, or its lettering could not be read or is a logo / wordmark. Final whenever the job is. A layering job is not reported finished until reading its text has finished or timed out. object **content** required *Content* The text as shown, preserving capitalization, with a line break between lines. string **decorated** required *Decorated* True when the lettering is ornamental (outlines, patterned fills, bevels, drop shadows), so plain typeset text will not reproduce its look. boolean **font** *OutputLayerFont* Described typeface traits. Absent when they could not be read. object **category** required *Category* Letterform style. string Allowed values: sans serif serif slab serif display sans display serif display slab display decorative handwriting monospace **families** required *Families* Up to three Google Fonts family names that resemble the lettering, closest first. Empty when none of the offered families fit. Array\ **italic** required *Italic* Whether the letters are slanted or cursive. boolean **match** *OutputLayerFontMatch* The font in your font catalog that the lettering matches, so you can re-set the text in it. Absent when no catalog font matches closely enough, or matching is not enabled. The image itself is not rendered in this font. object **face\_id** required *Face Id* Typed ref of the matched face (one weight and style), font\_face:, as typeset actions take it. string **family\_id** required *Family Id* Typed ref of the matched font family, font\_family:. string **family\_name** required *Family Name* Name of the matched font family. string **style** required *Style* Style of the matched face. string Allowed values: normal italic **weight** required *Weight* CSS font weight of the matched face, e.g. 400 or 700. integer **weight** required *Weight* Stroke weight. string Allowed values: thin light regular medium bold black **width** required *Width* Letter width for its height. string Allowed values: condensed normal wide **mime** *Mime* Exact MIME type of the asset, e.g. image/png. Narrower than type, which is a coarse bucket. string **model** *Model* Model id that produced this output. string **size\_bytes** *Size Bytes* Size of the asset in bytes. integer **thumbnail\_url** *Thumbnail Url* Presigned URL to a thumbnail variant. string **type** required *Type* Asset media type. string Allowed values: image video audio model3d text **url** required *Url* Presigned URL to the asset. string **width** *Width* Pixel width, for image and video outputs. integer **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: job.completed *JobFailedRecord* A GPU job failed. The server will continue the agent turn so it can inform the user. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **category** *Category* Bucket derived from failure\_code — what the caller can do about it. string Allowed values: user moderation rate\_limit transient internal **created\_at** required *Created At* ISO-8601 time the event was recorded. string **credits\_charged** *Credits Charged* Credits charged for the failed job. Zero unless it settled. integer **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **error** required *Error* string **failure\_code** *Failure Code* Error-taxonomy code, e.g. USER.MODERATION.UNSAFE\_CONTENT. string **id** required *Id* Opaque event id (sevt\_…). string **job\_id** required *Job Id* string **model** *Model* Model id the job dispatched to. string **moderation\_reason** *Moderation Reason* Moderation verdict detail. Present only on moderation failures. string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **retryable** *Retryable* Whether resubmitting the same job could succeed. boolean **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: job.failed *JobStartedRecord* A long-running GPU generation job was submitted. The agent is waiting for it to complete. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **estimated\_credits** *Estimated Credits* Pre-dispatch credit estimate for this job. integer **estimated\_duration\_s** *Estimated Duration S* Rough estimate in seconds. number **id** required *Id* Opaque event id (sevt\_…). string **invocation\_id** *Invocation Id* Tool invocation that submitted this job; matches agent.tool\_use / agent.tool\_result. string **job\_id** required *Job Id* Backend job identifier. A continuation session.status\_running names it in job\_ids when its completion resumes the session. string **model** *Model* Model id the job dispatched to. string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **state** *State* Job state at submission. Always queued today. string Allowed values: queued running **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: job.started *PlanUpdatedRecord* The session plan artifact was mutated. Carries the new revision and the mutator — fetch the snapshot via GET /v1/sessions/{id}, it is not inlined. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **mutated\_by** required *Mutated By* Tool/stage that performed the mutation, e.g. plan\_storyboard. string **patch\_summary** *Patch Summary* Human-readable one-liner describing the mutation. string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **revision** required *Revision* New artifact revision after this mutation. integer **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: plan.updated *RunCompletedRecord* A run reached a terminal state. No further event carries this run\_id. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **error\_code** *Error Code* Set when state is failed: the error code the run failed with, as GET /v1/sessions/{session\_id}/runs/{run\_id} reports it. string **id** required *Id* Opaque event id (sevt\_…). string **kind** required *Kind* string Allowed values: brief generate capability **outputs** *Outputs* Assets this run produced. Array\ *OutputRef* A reference to a generated asset ready for delivery. object **asset\_id** *Asset Id* Durable artifact identifier for this output. string **duration\_s** *Duration S* Duration in seconds, for video outputs. number **height** *Height* Pixel height, for image and video outputs. integer **job\_id** *Job Id* Backend job identifier that produced this output. string **layer** *OutputLayer* Per-layer semantics, on the outputs of a layering job: run.completed, job.completed, turn outputs, and the run and job reads. Outputs are ordered front to back; the last is the background. object **alpha\_hint** required *Alpha Hint* Edge treatment of the layer's transparency — soft (hair/fur/glass), hard (solid edges), or none (the opaque background). string Allowed values: soft hard none **bounds** *OutputLayerBounds* Placement of this layer's pixels within the composite canvas. Absent only when the output's dimensions could not be resolved. object **canvas\_height** required *Canvas Height* Height of the full composite canvas the layers reassemble into. integer **canvas\_width** required *Canvas Width* Width of the full composite canvas the layers reassemble into. integer **height** required *Height* Pixel height of the returned layer image. integer **width** required *Width* Pixel width of the returned layer image. integer **x** required *X* Left offset of this layer's pixels within the composite canvas. integer **y** required *Y* Top offset of this layer's pixels within the composite canvas. integer **contains\_text** *Contains Text* Whether the layer was planned as typeset text (a headline, caption, or label) rather than an image element. Absent when not reported for this output. boolean **description** required *Description* Complete-element caption for the layer's content. string **index** required *Index* Layer position, front-to-back; the last layer is the background. integer **label** required *Label* Short (1-2 word) layer name. string **text** *OutputLayerText* The text read off a contains\_text layer, so it can be re-typeset as live text inside bounds. Absent when the layer holds no text, or its lettering could not be read or is a logo / wordmark. Final whenever the job is. A layering job is not reported finished until reading its text has finished or timed out. object **content** required *Content* The text as shown, preserving capitalization, with a line break between lines. string **decorated** required *Decorated* True when the lettering is ornamental (outlines, patterned fills, bevels, drop shadows), so plain typeset text will not reproduce its look. boolean **font** *OutputLayerFont* Described typeface traits. Absent when they could not be read. object **category** required *Category* Letterform style. string Allowed values: sans serif serif slab serif display sans display serif display slab display decorative handwriting monospace **families** required *Families* Up to three Google Fonts family names that resemble the lettering, closest first. Empty when none of the offered families fit. Array\ **italic** required *Italic* Whether the letters are slanted or cursive. boolean **match** *OutputLayerFontMatch* The font in your font catalog that the lettering matches, so you can re-set the text in it. Absent when no catalog font matches closely enough, or matching is not enabled. The image itself is not rendered in this font. object **face\_id** required *Face Id* Typed ref of the matched face (one weight and style), font\_face:, as typeset actions take it. string **family\_id** required *Family Id* Typed ref of the matched font family, font\_family:. string **family\_name** required *Family Name* Name of the matched font family. string **style** required *Style* Style of the matched face. string Allowed values: normal italic **weight** required *Weight* CSS font weight of the matched face, e.g. 400 or 700. integer **weight** required *Weight* Stroke weight. string Allowed values: thin light regular medium bold black **width** required *Width* Letter width for its height. string Allowed values: condensed normal wide **mime** *Mime* Exact MIME type of the asset, e.g. image/png. Narrower than type, which is a coarse bucket. string **model** *Model* Model id that produced this output. string **size\_bytes** *Size Bytes* Size of the asset in bytes. integer **thumbnail\_url** *Thumbnail Url* Presigned URL to a thumbnail variant. string **type** required *Type* Asset media type. string Allowed values: image video audio model3d text **url** required *Url* Presigned URL to the asset. string **width** *Width* Pixel width, for image and video outputs. integer **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **result** *Result* Typed named-operation result, present only after successful completion. object ***key*** additional properties any **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **settled\_with** *Settled With* Set when this run settled together with another run: the run\_id of that run, which holds its work and results. string **state** required *State* Which terminal state the run reached. string Allowed values: completed failed cancelled **summary** *Summary* One-line account of what the run did. string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: run.completed *RunStartedRecord* A run began inside this session. Every later event carrying this run\_id belongs to it. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **app** *App* Capability slug, for a capability run. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **kind** required *Kind* What kind of work this run is. string Allowed values: brief generate capability **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: run.started *SessionBudgetWarningRecord* The session is approaching its credit budget. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **credits\_remaining** required *Credits Remaining* Remaining credit balance at the time of this warning. integer **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: session.budget\_warning *SessionConfigChangedRecord* Luma changed what the session's agent holds since the session was created or since the last such event: a platform tool, platform skill or app tool was switched off, or came back. Sent as the first turn that runs with the change starts. Each list is the session's whole answer now, the same as effective on GET /v1/sessions/{id}. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **app\_tools** required *App Tools* The workflow-app tools the agent holds now. Array\ **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **platform\_skills** required *Platform Skills* The platform skills on the agent's menu now, by slug. Array\ **platform\_tools** required *Platform Tools* The platform tools the agent holds now, by name. Array\ **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: session.config\_changed *SessionConsentRequiredRecord* A top-up quote the run needs accepted before it can continue; until then the run is paused at its current cap. The session's pending names it by quote\_id. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **expires\_at** *Expires At* RFC 3339 UTC instant after which the quote can no longer be accepted. Absent means it lives as long as the session. string **hold\_credits** required *Hold Credits* Credits this quote would add to the run, held on accept. integer **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **quote\_id** required *Quote Id* Identifier of the offered quote, echoed back on accept. string **reason** required *Reason* Why more money is being asked for. string Allowed values: regenerate command overrun **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: session.consent\_required **units** required *Units* The priced lines the hold is the sum of. Array\ *QuotedUnitRef* One priced line of a quote: a batch of planned finals that share a tier and a set of pricing dimensions. The pricing policy id the server rates against is deliberately not on the wire — it is an internal join key. object **dimensions** required *Dimensions* Pricing dimensions for this line, as a flat map of dimension name to value, e.g. resolution to 1080p. object ***key*** additional properties any **quantity** required *Quantity* Number of units on this line. integer **rate\_credits** required *Rate Credits* Credits per unit. Zero means unpriced in this environment, never free. integer **tier** required *Tier* Pricing tier these units are rated against, e.g. the app-declared action type. string *SessionContextCompactingRecord* The session is summarizing its older history so it fits the model's context window; the turn's model call waits until it finishes. A start is followed by complete or failed. On failed the turn continues with the full history. Recorded, so a client that connects or resumes mid-wait sees the start, and its created\_at says when the wait began. A start with neither after 1200 seconds belongs to a worker that died and should be read as failed. Informational only — no client action. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **phase** required *Phase* Where the compaction is: started, finished with a stored summary, or abandoned. string Allowed values: start complete failed **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: session.context\_compacting *SessionErrorRecord* A turn failed. retry\_status says what happens next. object **code** required *Code* Registered SESSION.\* error code. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **message** required *Message* string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **retry\_status** required *Retry Status* Retrying — the server is retrying; exhausted — this turn is over, a new input may succeed; terminal — the session cannot continue. string Allowed values: retrying exhausted terminal **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: session.error *SessionInputFailedRecord* An input or event the server accepted could not be processed. input\_seq names the recorded input it answers. object **created\_at** required *Created At* ISO-8601 time the event was recorded. string **detail** required *Detail* Human-readable explanation of the failure. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **input\_seq** *Input Seq* The seq of the recorded input this failure answers. integer **pending\_event\_id** required *Pending Event Id* Identifier of the event that failed delivery. string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: session.input\_failed *SessionStatusIdleRecord* The session stopped and is waiting. requires\_action lists every pending item; a partial answer re-emits it with the remainder. object **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **stop\_reason** required *StopReason* Why the session went idle. pending is present only for requires\_action; code, message and retryable only for error. object **code** *Code* Error only: the registered session error code. string **message** *Message* Error only: a message safe to show the user. string **pending** *Pending* Array\ *PendingAction* One thing the session is waiting on the caller for. Answer it by its domain id. object **action\_id** *Action Id* Connector\_action: answer with user.connector\_action. string **answer\_format** *GateAnswerFormat* Gate: the verdict a typed answer takes and the revision targets it may name. object **revision\_targets** required *Revision Targets* What a revise verdict may name, each sample included; empty when the gate names none. Array\ **verdict\_schema** required *Verdict Schema* JSON schema of the verdict. object ***key*** additional properties any **answer\_type** *Answer Type* The input type that answers it. Send this type; kind alone does not determine it. string Allowed values: user.tool\_result user.gate\_verdict user.consent **event\_id** *Event Id* Id of the blocking event (agent.custom\_tool\_use, agent.gate, session.consent\_required, connector.action\_required), for display and de-duplication. Absent when that event is not in the log; key answers on invocation\_id, quote\_id or action\_id. string **expires\_at** *Expires At* string **hold\_credits** *Hold Credits* Consent: credits held on accept. integer **how\_to\_answer** *How To Answer* Gate: how to get the answer from the user and send it. string **invocation\_id** *Invocation Id* Custom\_tool and gate: the id the answer echoes. answer\_type names the input that answers it. string **kind** required *Kind* string Allowed values: custom\_tool gate consent connector\_action **offer** *ConsentOffer* Consent: which offer it is. finals is the review's first paid commitment; top\_up adds credits to a run that already has one. string Allowed values: finals top\_up **quote\_id** *Quote Id* Consent: answer with user.consent. string **run\_id** *Run Id* string **show** *Show* Gate: the rendered samples the review asks about. Show them to the user before asking. Array\ *GateShownAsset* One rendered sample a review gate asks about, named by the revision target a revise verdict uses for it. object **asset\_id** required *Asset Id* The sample render's asset id. string **target** required *Target* The revision target that names this sample in answer\_format.revision\_targets. string **unit** *Unit* The ad unit or format the sample was rendered for, e.g. square. string **text** *Text* Gate: the source and translated copy the review asks about, as it stands now. Show it to the user before asking. Array\ *GateReviewText* One line of copy a review gate asks a person to approve: text to show, not instructions. object **label** required *Label* The language and role of the copy, e.g. English · headline. string **target** required *Target* The revision target that owns this copy in answer\_format.revision\_targets. string **text** required *Text* The current copy to approve, including the user's own edits. string **units** *Units* Consent: the priced lines hold\_credits is the sum of. Array\ *QuotedUnitRef* One priced line of a quote: a batch of planned finals that share a tier and a set of pricing dimensions. The pricing policy id the server rates against is deliberately not on the wire — it is an internal join key. object **dimensions** required *Dimensions* Pricing dimensions for this line, as a flat map of dimension name to value, e.g. resolution to 1080p. object ***key*** additional properties any **quantity** required *Quantity* Number of units on this line. integer **rate\_credits** required *Rate Credits* Credits per unit. Zero means unpriced in this environment, never free. integer **tier** required *Tier* Pricing tier these units are rated against, e.g. the app-declared action type. string **retryable** *Retryable* Error only: whether sending the request again could succeed. The session stays open. boolean **type** required *Type* string Allowed values: end\_turn requires\_action budget\_reached interrupted error **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: session.status\_idle *SessionStatusRunningRecord* The session started working: a turn, or a continuation after server-side jobs landed. object **app** *AppRef* The workflow app a session is running, frozen at creation. package\_digest is the sealed digest of the release that served the session's configuration — the identity two runs are compared by, since a version label can be reused. object **package\_digest** required *Package Digest* Sealed package digest of that release. string **slug** required *Slug* Registered app slug, as named in POST /v1/sessions {app}. string **version** required *Version* SemVer of the release that was active at session creation. string **continuation** required *Continuation* True when the server resumed after its own jobs finished. boolean **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **job\_ids** *Job Ids* Continuation only: the jobs whose completion resumed the session. Array\ **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **turn\_id** *Turn Id* string **type** required *Type* string Allowed value: session.status\_running *SessionStatusTerminatedRecord* The session ended. No further events follow. object **created\_at** required *Created At* ISO-8601 time the event was recorded. string **detail** *Detail* string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **reason** required *Reason* string Allowed values: completed error expired closed **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: session.status\_terminated *SessionTurnRetriedRecord* The previous attempt at this turn stopped before it ended, and the server is running the turn again from the same history. Comes before the retry's session.status\_running. Every invocation\_id in abandoned\_invocation\_ids belongs to the stopped attempt and is never answerable: drop any card or spinner for it. The retry may ask the same tool again under a new invocation\_id. Informational only — no client action. object **abandoned\_invocation\_ids** required *Abandoned Invocation Ids* Tool calls the stopped attempt started that got no result. Empty when it started none. Array\ **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **reason** required *Reason* `worker_lost`: the process running the attempt died. `attempt_failed`: the attempt stopped, by an error or a worker shutdown, and the server retries it. string Allowed values: worker\_lost attempt\_failed **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: session.turn\_retried *SessionUsageRecord* What the turn that just ended consumed and produced. Always immediately precedes session.status\_idle. object **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **jobs** required *Jobs* Array\ *TurnJob* One generation job the turn dispatched or landed, with its state at turn end. object **job\_id** required *Job Id* string **state** required *State* Job state at the moment the turn ended. string Allowed values: queued running completed failed **outputs** *Outputs* Array\ *OutputRef* A reference to a generated asset ready for delivery. object **asset\_id** *Asset Id* Durable artifact identifier for this output. string **duration\_s** *Duration S* Duration in seconds, for video outputs. number **height** *Height* Pixel height, for image and video outputs. integer **job\_id** *Job Id* Backend job identifier that produced this output. string **layer** *OutputLayer* Per-layer semantics, on the outputs of a layering job: run.completed, job.completed, turn outputs, and the run and job reads. Outputs are ordered front to back; the last is the background. object **alpha\_hint** required *Alpha Hint* Edge treatment of the layer's transparency — soft (hair/fur/glass), hard (solid edges), or none (the opaque background). string Allowed values: soft hard none **bounds** *OutputLayerBounds* Placement of this layer's pixels within the composite canvas. Absent only when the output's dimensions could not be resolved. object **canvas\_height** required *Canvas Height* Height of the full composite canvas the layers reassemble into. integer **canvas\_width** required *Canvas Width* Width of the full composite canvas the layers reassemble into. integer **height** required *Height* Pixel height of the returned layer image. integer **width** required *Width* Pixel width of the returned layer image. integer **x** required *X* Left offset of this layer's pixels within the composite canvas. integer **y** required *Y* Top offset of this layer's pixels within the composite canvas. integer **contains\_text** *Contains Text* Whether the layer was planned as typeset text (a headline, caption, or label) rather than an image element. Absent when not reported for this output. boolean **description** required *Description* Complete-element caption for the layer's content. string **index** required *Index* Layer position, front-to-back; the last layer is the background. integer **label** required *Label* Short (1-2 word) layer name. string **text** *OutputLayerText* The text read off a contains\_text layer, so it can be re-typeset as live text inside bounds. Absent when the layer holds no text, or its lettering could not be read or is a logo / wordmark. Final whenever the job is. A layering job is not reported finished until reading its text has finished or timed out. object **content** required *Content* The text as shown, preserving capitalization, with a line break between lines. string **decorated** required *Decorated* True when the lettering is ornamental (outlines, patterned fills, bevels, drop shadows), so plain typeset text will not reproduce its look. boolean **font** *OutputLayerFont* Described typeface traits. Absent when they could not be read. object **category** required *Category* Letterform style. string Allowed values: sans serif serif slab serif display sans display serif display slab display decorative handwriting monospace **families** required *Families* Up to three Google Fonts family names that resemble the lettering, closest first. Empty when none of the offered families fit. Array\ **italic** required *Italic* Whether the letters are slanted or cursive. boolean **match** *OutputLayerFontMatch* The font in your font catalog that the lettering matches, so you can re-set the text in it. Absent when no catalog font matches closely enough, or matching is not enabled. The image itself is not rendered in this font. object **face\_id** required *Face Id* Typed ref of the matched face (one weight and style), font\_face:, as typeset actions take it. string **family\_id** required *Family Id* Typed ref of the matched font family, font\_family:. string **family\_name** required *Family Name* Name of the matched font family. string **style** required *Style* Style of the matched face. string Allowed values: normal italic **weight** required *Weight* CSS font weight of the matched face, e.g. 400 or 700. integer **weight** required *Weight* Stroke weight. string Allowed values: thin light regular medium bold black **width** required *Width* Letter width for its height. string Allowed values: condensed normal wide **mime** *Mime* Exact MIME type of the asset, e.g. image/png. Narrower than type, which is a coarse bucket. string **model** *Model* Model id that produced this output. string **size\_bytes** *Size Bytes* Size of the asset in bytes. integer **thumbnail\_url** *Thumbnail Url* Presigned URL to a thumbnail variant. string **type** required *Type* Asset media type. string Allowed values: image video audio model3d text **url** required *Url* Presigned URL to the asset. string **width** *Width* Pixel width, for image and video outputs. integer **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **turn\_id** *Turn Id* string **type** required *Type* string Allowed value: session.usage **usage** *TurnUsage* Token and credit consumption for a single turn. object **completion\_tokens** required *Completion Tokens* Completion tokens produced. integer **credits\_charged** *Credits Charged* Luma credits charged. Present when billing is enabled. integer **prompt\_tokens** required *Prompt Tokens* Prompt tokens consumed. integer *StageDoneRecord* An orchestration stage reached a terminal state. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **job\_ids** required *Job Ids* Array\ **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **stage** required *Stage* string **status** required *Status* Terminal stage status: 'completed' | 'failed'. string **tool\_name** required *Tool Name* string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: stage.done *StageStartedRecord* An orchestration stage began — its tool dispatched one or more jobs. object **agent** *Agent* Sub-agent name, present when the event originates from a sub-agent. string **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **job\_ids** required *Job Ids* Backend job identifiers dispatched for this stage. Array\ **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **stage** required *Stage* Stage name, e.g. render\_keyframes. string **status** required *Status* Stage status, e.g. 'running'. string **tool\_name** required *Tool Name* Catalog tool that drives this stage. string **truncated** *Truncated* True when the recorded event exceeded the size cap and only its identity fields were kept. Refetch the resource it names. boolean **type** required *Type* string Allowed value: stage.started *UserMessageRecord* A message from the caller; opens or joins a run. object **asset\_ids** *Asset Ids* Array\ **attachment\_ids** *Attachment Ids* Array\ **capability** *CapabilityRequest* Run this capability on the message. The result's run\_id is the capability run. object **app** required *App* The capability's slug from GET /v1/apps, or 'slug\@version' to pin the release. string <= 128 characters **input** *Input* Typed fields matching the capability's intake input\_schema. Absent, the message content is the brief. object ***key*** additional properties any **system\_context** *System Context* Extra standing instructions for the capability's own work. string <= 32768 characters **content** required *Content* string **context\_refs** *Context Refs* Things of your team for the session's agent to follow on this message and the work it orders, each by the id its own list prints: brand\_kit: from GET /v1/brand-kits. Up to 4. Each is read as the message is sent, and what it says is stored ahead of your words as part of the message. One this team cannot read is not found. Naming the same kit again is how a session picks up an edit; a kit it already holds unchanged is named but not repeated. Array\ **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **idempotency\_key** *Idempotency Key* string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **type** required *Type* string Allowed value: user.message *UserInterruptRecord* Stop the current turn, or with target\_run\_id that one run. tree also stops descendant sessions. object **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **idempotency\_key** *Idempotency Key* string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **target\_run\_id** *Target Run Id* The run to cancel: a brief, a generate run or a capability run on this session. Absent, the current turn is interrupted. string **tree** *Tree* boolean **type** required *Type* string Allowed value: user.interrupt *UserToolResultRecord* The result of a custom tool the session asked the caller to run. object **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **error** *ToolResultError* Present only on an answer the platform recorded because the webhook tool failed; a caller cannot send it. object **code** required *Code* WEBHOOK.NON\_2XX, WEBHOOK.NOT\_JSON, WEBHOOK.TIMEOUT, WEBHOOK.TOO\_LARGE, WEBHOOK.DESTINATION\_REFUSED, WEBHOOK.INVALID\_REPLY, WEBHOOK.DISPATCH\_FAILED or TOOL.DEADLINE\_EXCEEDED. string **message** required *Message* string **id** required *Id* Opaque event id (sevt\_…). string **idempotency\_key** *Idempotency Key* string **invocation\_id** required *Invocation Id* string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **result** required *Result* **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **type** required *Type* string Allowed value: user.tool\_result *UserGateVerdictRecord* The caller's answer to a review gate. object **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **idempotency\_key** *Idempotency Key* string **invocation\_id** required *Invocation Id* string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **type** required *Type* string Allowed value: user.gate\_verdict **verdict** required *Verdict* object ***key*** additional properties any *UserCommandRecord* One of the app's typed commands, run against the session outside a turn. object **command** required *Command* The command body in the app's command schema. Unless the body's own schema declares them, expected\_revision must match the plan artifact's revision before the command runs, and it and operation\_id are left out of the recorded input and its idempotency comparison. object ***key*** additional properties any **created\_at** required *Created At* ISO-8601 time the event was recorded. string **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **idempotency\_key** *Idempotency Key* string **operation** required *Operation* The command the app authorizes the call as. string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **type** required *Type* string Allowed value: user.command *UserConsentRecord* The caller's answer to a billing offer the session's pending names by quote\_id. Names only the quote, never an amount: the server holds the offer's frozen terms. object **created\_at** required *Created At* ISO-8601 time the event was recorded. string **decision** required *Decision* string Allowed values: accept decline **direction** required *Direction* In = a caller input; out = the platform. string Allowed values: in out **id** required *Id* Opaque event id (sevt\_…). string **idempotency\_key** *Idempotency Key* string **producer** *EventProducer* Who produced an outbound event: the session itself, or a capability working for it. Absent on inputs. object **app** *App* App only: the capability's slug. string **kind** required *Kind* string Allowed values: root app **run\_id** *Run Id* App only: the capability run the event belongs to: a run ref (`run:`) when the session spells refs typed, else the bare run id. string **quote\_id** required *Quote Id* Identifier of the offered quote, echoed back on accept. string **run\_id** *Run Id* The run this event belongs to. string **seq** required *Seq* Per-feed ordinal. integer **type** required *Type* string Allowed value: user.consent **has\_more** required *Has More* True when events after next\_after\_seq exist. boolean **next\_after\_seq** required *Next After Seq* Pass as after\_seq to read the next page. integer ##### Example ```json { "data": [ { "direction": "in", "producer": { "kind": "root" }, "retry_status": "retrying", "source": "slug", "stop_reason": { "pending": [ { "answer_type": "user.tool_result", "kind": "custom_tool", "offer": "finals" } ], "type": "end_turn" }, "truncated": true } ] } ``` ### 422 Validation Error Media typeapplication/json *HTTPValidationError* object **detail** *Detail* Array\ *ValidationError* object **ctx** *Context* object **input** *Input* **loc** required *Location* Array **msg** required *Message* string **type** required *Error Type* string ##### Examplegenerated ```json { "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ] } ```