agent-paste.sh
Get started
Docs

REST API

Use REST when the CLI is the wrong runtime for your agent or service.

Docs indexMarkdownFull text

Hosts

HostPurpose
https://api.agent-paste.shControl plane, Agent View, web API, ephemeral provision/claim, billing routes, and OpenAPI.
https://upload.agent-paste.shUpload Sessions and signed file PUT URLs.
https://usercontent.agent-paste.shSigned content and Bundle reads from isolated untrusted-content origin.
https://app.agent-paste.shDashboard, Access Link viewer, claim page, and billing UI.
https://mcp.agent-paste.shOAuth-only MCP transport.

Authentication

API clients send Authorization: Bearer ap_pk_.... Use dashboard-created keys or the key minted by agent-paste login. Public Agent View, Access Link resolve, signed content, and signed Bundle URLs use signed tokens instead of API Keys.

Publish flow

  1. Create an Upload Session with file metadata and an Idempotency-Key.
  2. PUT each file to the returned signed upload-worker URL.
  3. Finalize the Upload Session with an Idempotency-Key.
  4. Publish the finalized Revision. The response includes human and agent URLs.

Common routes

RouteUse
GET /v1/whoamiVerify API Key identity and Workspace.
GET /v1/usage-policyRead effective limits for the caller's Workspace.
GET /v1/artifacts/{id}/agent-viewRead latest authenticated Agent View.
GET /v1/artifacts/{id}/revisions/{revision_id}/agent-viewRead Revision-pinned authenticated Agent View.
GET /v1/public/agent-view/{token}Read public signed Agent View.
POST /v1/ephemeral/provisionProvision an Ephemeral Workspace and short-lived key.