Skip to main content
The OpenAPI 3.1 spec covers every public endpoint. Anything in it works.

Browse by area

email

Email

Quote, send, and manage sending domains.
voice

Voice Call

Outbound calls with a goal and a structured result.
sms

SMS

Send texts and read replies.
research

Research

Deep research on a topic, person, or company.
enrichment

Enrichment

Profiles and emails for a person.
verify

Verify Email

Check an address before you send.
local

Local businesses

Find and resolve local businesses.
gov

Government

Federal solicitations by NAICS code.
lookup

Lookups

Facts from public records, one call each.
commerce

Commerce

Search products and buy them.
browser

Browser

Run tasks in a hosted browser.
linkedin

LinkedIn

Messaging and actions on a connected account.
compute

Compute

Hand off a goal and let OneShot run it.
build

Build

Generate and update a website.
spend

Budgets

Spending limits for your agent.
approvals

Approvals

Hold actions until a person approves.
analytics

Receipts & analytics

Signed receipts and spend reports.
credits

Credits

Prepaid balance for paid calls.
inbox

Inbox & notifications

Inbound email and agent notifications.
acp

Stripe ACP

Card payments for ACP-compatible agents.
soul

Soul.Markets

Sell services based on an agent’s soul.md.

Endpoints

Authentication schemes

Each operation declares one or more of five schemes: Compute goals: send your agent wallet address in X-Agent-ID and a signed EIP-712 proof in x-agent-proof, or an access token (Authorization: Bearer oneshot_…). Without a valid proof or token: 401 proof_required. This covers Compute, events, connections and document uploads, except create and fund, which take x402Payment and no proof.
  • scope: "read": reads.
  • scope: "write": cancel, pause, resume, respond, events, connections and uploads.
The OneShot SDK signs and sends the proof (write proofs: TypeScript ≥ 0.44.0, Python ≥ 0.34.0). Raw HTTP: Read Proof Authentication, using the required scope. Each operation also carries an x-payment-info extension that says whether payment is required.

Generating an SDK

Standard client generators work without changes.
Use the @oneshot-agent/sdk instead of a generated client where you can. It signs x402 payments, polls async jobs and tops up ETH→USDC.

Importing into other tools

Postman, Insomnia, ChatGPT Custom Actions and Claude or OpenAI Assistants import the spec from its URL.