{"slug":"api-relaystation-ai-v1-baton-d987db","title":"A baton is a durable storage object agents create, append, read, and cryptograph","host":"api.relaystation.ai","method":"POST","resource":"https://api.relaystation.ai/v1/baton","category":"market","description":"A baton is a durable storage object agents create, append, read, and cryptographically prove — then hand off to other agents or people. Presets: file drop, burn-after-read pass, shared scratchpad, state checkpoint, tamper-evident ledger. Metered by bytes, time, egress, writes; price frozen at purcha","price_listed":0.01,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"contentEncoding":"utf-8","contentType":"string","customShape":{"durationSeconds":{},"maxEgressBytes":{},"readsAllowed":0,"sizeBytes":{},"writesAllowed":0},"description":"string","name":"string","preset":"drop","tags":["string"],"tier":"femto"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"acl":{"additionalProperties":{"enum":["editor","reader"],"type":"string"},"description":"Collaborator ACL keyed by customer UUID.","type":"object"},"content":{"description":"Inline initial content (base64-encoded when contentEncoding is base64/binary). Omit for an empty baton.","type":"string"},"contentEncoding":{"enum":["utf-8","base64","binary"],"type":"string"},"contentType":{"maxLength":255,"type":"string"},"customShape":{"properties":{"durationSeconds":{"description":"Lifetime in seconds (number or stringified bigint)."},"maxEgressBytes":{"description":"Egress budget in bytes (number or stringified bigint)."},"readsAllowed":{"minimum":0,"type":"integer"},"sizeBytes":{"description":"Capacity in bytes (number or stringified bigint)."},"writesAllowed":{"minimum":0,"type":"integer"}},"required":["sizeBytes","durationSeconds","maxEgressBytes"],"type":"object"},"deleteOnAllTokensConsumed":{"type":"boolean"},"description":{"maxLength":2000,"type":"string"},"eventTriggers":{"description":"Webhook event triggers; each { url, events[], description? }. The secret is server-minted and returned ONCE.","items":{"type":"object"},"type":"array"},"flags":{"description":"flags.hashChaining: true auto-commits a prepaid witness (an explicit witness: false alongside it → 422 FLAG_DEPENDENCY_UNMET).","properties":{"hashChaining":{"type":"boolean"},"witness":{"type":"boolean"}},"type":"object"},"name":{"maxLength":255,"type":"string"},"onExpiration":{"enum":["hard_delete","tombstone_then_delete"],"type":"string"},"preset":{"description":"Named preconfig prefill. The LIVE active set is GET /v1/baton/prices.","enum":["drop","pass","scratchpad","checkpoint","ledger","witness"],"type":"string"},"rateLimits":{"type":"object"},"requestPresignedUpload":{"description":"Mint a presigned-PUT URL for an out-of-band initial upload instead of inline content.","type":"boolean"},"schemaRef":{"maxLength":255,"type":"string"},"tags":{"items":{"maxLength":64,"type":"string"},"maxItems":32,"type":"array"},"tier":{"description":"Bundled resource tier, or \"custom\" (requires customShape).","enum":["femto","pico","nano","micro","standard","big","custom"],"type":"string"},"tokens":{"description":"Create-time collaborator tokens; each entry follows the POST /v1/baton/{id}/tokens body.","items":{"type":"object"},"type":"array"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"A baton is a durable storage object agents create, append, read, and cryptographically prove — then hand off to other agents or people. Presets: file drop, burn-after-read pass, shared scratchpad, state checkpoint, tamper-evident ledger. Metered by bytes, time, egress, writes; price frozen at purchase. 155 tools, one balance — relaystation.ai","last_updated":"2026-09-05T15:51:48.105Z","schemes":["exact"]}