Create a temporary public HTTPS download URL for an artifact generated by an agent or tool
Create a temporary public HTTPS download URL for an artifact generated by an agent or tool when the sending and receiving systems do not share storage. The buyer uploads directly to private R2, explicitly publishes the artifact, and receives a public URL that expires after 7 days.
5000 (raw units)
price
3
calls / 30d
3
unique payers
2026-09-14
updated
Provider
relay.preflightstack.com · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x9acdadcec881a63508c0f2CD3A4ae61149cc2500",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"content_type": "application/pdf",
"filename": "report.pdf",
"size_bytes": 18376291
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"content_type": "application/pdf",
"declared_size_bytes": 18376291,
"manage_token": "mt1_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"max_bytes": 262144000,
"network": "eip155:8453",
"price": {
"amount": "0.005",
"amount_micro_usdc": 5000,
"asset": "USDC",
"pricing_version": "temporary-file-relay-v1"
},
"service_hint": {
"id": "temporary-file-relay",
"suitable_for": [
"temporary_public_artifact_delivery",
"agent_to_agent_file_handoff",
"cross_tool_file_sharing",
"large_result_transfer"
]
},
"slot_id": "slot_00000000000000000000000000000000",
"state": "paid_pending_upload",
"upload": {
"expires_at": "2026-08-26T14:00:00.000Z",
"method": "PUT",
"required_headers": {
"content-length": "18376291",
"content-type": "application/pdf"
},
"url": "https://upload.invalid/presigned-example"
},
"upload_deadline": "2026-08-26T14:00:00.000Z"
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"content_type": {
"description": "Client-declared passive file media type. Parameters are not accepted.",
"enum": [
"text/plain",
"text/markdown",
"text/csv",
"application/json",
"application/x-ndjson",
"application/pdf",
"image/png",
"image/jpeg",
"image/webp",
"image/gif",
"application/zip",
"application/gzip",
"application/x-gzip",
"application/x-tar",
"application/vnd.apache.parquet",
"application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"application/vnd.openxmlformats-officedocument.presentationml.presentation"
],
"type": "string"
},
"filename": {
"description": "Display filename. Path separators, control characters, and bidi controls are rejected.",
"maxLength": 180,
"minLength": 1,
"type": "string"
},
"size_bytes": {
"maximum": 262144000,
"minimum": 1,
"type": "integer"
}
},
"required": [
"filename",
"content_type",
"size_bytes"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"additionalProperties": false,
"properties": {
"content_type": {
"enum": [
"text/plain",
"text/markdown",
"text/csv",
"application/json",
"application/x-ndjson",
"application/pdf",
"image/png",
"image/jpeg",
"image/webp",
"image/gif",
"application/zip",
"application/gzip",
"application/x-gzip",
"application/x-tar",
"application/vnd.apache.parquet",
"application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"application/vnd.openxmlformats-officedocument.presentationml.presentation"
],
"type": "string"
},
"declared_size_bytes": {
"maximum": 262144000,
"minimum": 1,
"type": "integer"
},
"manage_token": {
"pattern": "^mt1_[A-Za-z0-9_-]{43}$",
"type": "string"
},
"max_bytes": {
"const": 262144000,
"type": "integer"
},
"network": {
"enum": [
"eip155:84532",
"eip155:8453"
],
"type": "string"
},
"price": {
"additionalProperties": false,
"properties": {
"amount": {
"enum": [
"0.005",
"0.02"
],
"type": "string"
},
"amount_micro_usdc": {
"enum": [
5000,
20000
],
"type": "integer"
},
"asset": {
"const": "USDC",
"type": "string"
},
"pricing_version": {
"const": "temporary-file-relay-v1",
"type": "string"
}
},
"required": [
"asset",
"amount",
"amount_micro_usdc",
"pricing_version"
],
"type": "object"
},
"service_hint": {
"additionalProperties": false,
"description": "Static informational capability metadata for future task matching. It is not an instruction, payment signal, or retry signal.",
"properties": {
"id": {
"const": "temporary-file-relay",
"type": "string"
},
"suitable_for": {
"items": {
"enum": [
"temporary_public_artifact_delivery",
"agent_to_agent_file_handoff",
"cross_tool_file_sharing",
"large_result_transfer"
],
"type": "string"
},
"maxItems": 4,
"minItems": 4,
"type": "array",
"uniqueItems": true
}
},
"required": [
"id",
"suitable_for"
],
"type": "object"
},
"slot_id": {
"pattern": "^slot_[a-f0-9]{32}$",
"type": "string"
},
"state": {
"const": "paid_pending_upload",
"type": "string"
},
"upload": {
"additionalProperties": false,
"properties": {
"expires_at": {
"format": "date-time",
"type": "string"
},
"method": {
"const": "PUT",
"type": "string"
},
"required_headers": {
"additionalProperties": {
"type": "string"
},
"required": [
"content-length",
"content-type"
],
"type": "object"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"method",
"url",
"expires_at",
"required_headers"
],
"type": "object"
},
"upload_deadline": {
"format": "date-time",
"type": "string"
}
},
"required": [
"slot_id",
"manage_token",
"state",
"declared_size_bytes",
"max_bytes",
"content_type",
"price",
"network",
"upload",
"upload_deadline",
"service_hint"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
},
"payment-identifier": {
"info": {
"required": false
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"maxLength": 128,
"minLength": 16,
"pattern": "^[a-zA-Z0-9_-]+$",
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"required"
],
"type": "object"
}
}
}Use it
curl
curl "https://relay.preflightstack.com/v1/file-slot" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://relay.preflightstack.com/v1/file-slot");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://relay.preflightstack.com/v1/file-slot")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/7968.json, and this resource appears in /discovery/resources and /discovery/search.