Skip to content

Put logs

PUT
/connector/v1/assignments/{assignment_id}/logs/{source}/{epoch}/{sequence}

Persist one bounded batch, including after the scientific terminal result until durable delivery settlement. Settlement fences fresh batches while preserving verified historical replay. Save source epoch, sequence and exact body before sending. Start at epoch 1/sequence 1; continue the sequence or begin the next epoch at sequence 1. A replacement epoch produces an explicit source_reset discontinuity. Identical retries within the last 64 batches per source replay the original receipt even after payload retention; older consumed identities return log_retry_too_old and cannot insert payloads. Ingestion does not advance execution progress or release capacity.

assignment_id
required
string format: uuid
source
required
string
/^(stdout|stderr|connector|slurm_batch|model\.[a-z][a-z0-9_-]{0,63})$/
epoch
required
integer format: int64
>= 1
sequence
required
integer format: int64
>= 1
X-Connector-Session
required
string format: uuid

Required active session owning the assignment journal.

Strict JSON object, at most 64 KiB or the configured limit. offset and byte_length measure raw source bytes; decoded text length never advances source progress. Text is at most 8192 UTF-8 bytes and excludes NUL. A positive gap count explains bytes omitted before offset; null counts require a reset/unavailable marker starting an epoch. Empty text requires a gap. stdout, stderr, connector, automatic slurm_batch and declared model. sources share these rules. Named sources must belong to the pinned assignment definition.

Media typeapplication/json
object
attempt_id
required
string format: uuid
byte_length
required

Source bytes consumed by text, independent of replacement UTF-8 length.

integer format: int64
<= 8192
gap
One of:
null
offset
required

Start of text, after any omitted bytes, in this epoch.

integer format: int64
text
required
string
<= 8192 characters

Durable batch receipt, or original verified replay.

Media typeapplication/json
object
assignment_id
required
string format: uuid
epoch
required
integer format: int64
position
required
integer format: int64
received_at
required
string format: date-time
sequence
required
integer format: int64
source
required
string
/^(stdout|stderr|connector|slurm_batch|model\.[a-z][a-z0-9_-]{0,63})$/
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Invalid path, query or session header.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Active connector credential required.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Assignment absent or not owned by this connector.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Log_conflict, log_sequence_conflict, log_retry_too_old, invalid_transition after delivery settlement, attempt_conflict, journal_conflict, or session_required. Too-old identities are consumed, but their exact content can no longer be verified; never resend them under fresh identities.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Encoded body exceeds limit.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

JSON required.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Invalid structure or batch bounds.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Assignment_unavailable or assignment_uncertain. Retry the exact identity and body.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

An HTTP request failed; inspect the stable error code and request ID.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Documentation 205dcb3116ea · public sources 8c70356d340f · built .Download documentation identity.