Register a staged input | Runstamp Docs

POST/api/v2/execution-inputs

Registers the envelope SHA-256 and exact byte length in the API key's active environment, then returns time-limited non-upsert authority for the private Supabase TUS endpoint. Upload the canonical application/json bytes with the returned token as a Bearer credential in Authorization, then finalize through the operation endpoint with staged_input.

Headers

Authorization string required

Bearer pj_live_… Raw keys are shown only when created. The x-api-key header is an alternative transport.

Key scope: execution:submit.

Body parameters

Registers the SHA-256 content address and exact UTF-8 byte length of a CanonicalOperationExecutionEnvelope. The maximum is 192 MiB (201326592 bytes).

input_hash string (sha256) required
byte_length integer required

Response

201 Created Tenant-bound signed authority for an immutable direct TUS upload.

Headers

Cache-Control const "private, no-store, max-age=0" required

Body

input_hash string (sha256) required
byte_length integer required
storage_path string required
upload object required

Errors

Status	When
`400`	Invalid request.
`401`	Missing, invalid, unentitled, or no-longer-accepted API key.
`403`	The key lacks the required execution scope.
`409`	Legacy job state conflicts with the requested operation.
`413`	The request exceeds its published byte boundary.
`429`	Finite rate limit or durable hosted quota refused the request.
`503`	Launch control is held or execution authority is unavailable.

curl -X POST \
  -H "Authorization: Bearer pj_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input_hash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08","byte_length":1}' \
https://runstamp.com/api/v2/execution-inputs

Response 201 Created

JSON

{
  "input_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "byte_length": 1,
  "storage_path": "STORAGE_PATH",
  "upload": {
    "protocol": "tus",
    "endpoint": "https://…",
    "bucket_name": "execution-inputs",
    "object_name": "OBJECT_NAME",
    "token": "TOKEN",
    "signature_header": "authorization",
    "chunk_size": 6291456,
    "content_type": "application/json",
    "upsert": false,
    "expires_in_seconds": 7200
  }
}

Errors

Status	When
`400`	Invalid request.
`401`	Missing, invalid, unentitled, or no-longer-accepted API key.
`403`	The key lacks the required execution scope.
`409`	Legacy job state conflicts with the requested operation.
`413`	The request exceeds its published byte boundary.
`429`	Finite rate limit or durable hosted quota refused the request.
`503`	Launch control is held or execution authority is unavailable.

curl -X POST \ -H "Authorization: Bearer pj_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"input_hash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08","byte_length":1}' \ https://runstamp.com/api/v2/execution-inputs

{ "input_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08", "byte_length": 1, "storage_path": "STORAGE_PATH", "upload": { "protocol": "tus", "endpoint": "https://…", "bucket_name": "execution-inputs", "object_name": "OBJECT_NAME", "token": "TOKEN", "signature_header": "authorization", "chunk_size": 6291456, "content_type": "application/json", "upsert": false, "expires_in_seconds": 7200 } }