Quotes and orders for AI agents

Agents cannot register themselves. The account owner creates the key, because a key spends money on the account's behalf (storage, analysis, live carrier rates) and prepares orders that account pays for.

1. Sign in with a customer account whose email address is verified, and open Dashboard → API keys.
2. Name the key, choose its scopes, and confirm with your password.
3. Copy the token into your agent. It is shown once; a lost token is revoked and replaced.

Up to 5 active keys per account. Revoke a key from the same page; every key is revoked automatically when the account password is changed or reset.

Send the token on every request, in the Authorization header and nowhere else:

Authorization: Bearer agk_XXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Base URL: https://3dservicesusa.com/api/agent/v1. Every authentication failure answers the same 401 UNAUTHORIZED, whatever the cause. A call outside the key's scopes answers 403 FORBIDDEN_SCOPE.

1. The account owner creates a key in the dashboard (API keys) and gives it to the agent.
2. GET /options to learn what can be ordered; optionally POST /estimate for a quick price from geometry you already have.
3. POST /files to register an upload, then PUT the bytes once to the returned URL with the returned headers (the declared Content-Length and If-None-Match: *).
4. POST /files/{id}/analyze: the server measures the part.
5. POST /quotes with the analyzed file ids: a priced quote, standard and rush.
6. PATCH /quotes/{id} to change material, color, infill, priority or quantities.
7. POST /quotes/{id}/shipping-rates with the delivery address, then POST /quotes/{id}/shipping-selection with the chosen rate.
8. POST /quotes/{id}/checkout-link and give the returned payUrl to the account owner. They sign in, review and pay. The agent cannot pay.

A quote with a part larger than our build volume is still created, marked requiresManualReview; it cannot be paid until our team prices it. Creating endpoints accept an Idempotency-Key header, so a retried request returns the first result at no charge.

Paths are relative to /api/agent/v1. {id} on a quote accepts its id or its quote number. Every call is also charged to request.

Every response is JSON in one envelope, and every one is Cache-Control: no-store. Branch on error.code, never on the message.

{ "ok": true,  "data": { ... } }
{ "ok": false, "error": { "code": "QUOTE_LOCKED", "message": "...", "reason": "checkout_open" } }

Request bodies are strict: an unknown field is refused, not ignored. In particular the API never accepts geometry for a quote, a parcel, a shipping cost or a tax figure; those come from our own measurement and our carriers.

Budgets are per account (all of its keys together) per UTC day, resetting at 00:00 UTC; the per-minute burst is per key. A spent budget answers 429 RATE_LIMITED with Retry-After. A site-wide ceiling answers 503 CAPACITY for everyone until the day rolls over. GET /me reports today's usage.

$AGENT_KEY holds the token; $FILE_ID, $QUOTE and $UPLOAD_URL come from earlier responses.

curl -s https://3dservicesusa.com/api/agent/v1/me -H "Authorization: Bearer $AGENT_KEY"

curl -s -X POST https://3dservicesusa.com/api/agent/v1/files -H "Authorization: Bearer $AGENT_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: bracket-v3-upload" \
  -d '{"filename":"bracket.stl","sizeBytes":482113}'

curl -s --upload-file bracket.stl -H "If-None-Match: *" "$UPLOAD_URL"

curl -s -X POST https://3dservicesusa.com/api/agent/v1/files/$FILE_ID/analyze -H "Authorization: Bearer $AGENT_KEY"

curl -s -X POST https://3dservicesusa.com/api/agent/v1/quotes -H "Authorization: Bearer $AGENT_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: bracket-v3-quote" \
  -d '{"files":[{"fileId":"'$FILE_ID'","quantity":4}],"technology":"FDM","material":"PETG","color":"Black","infill":20}'

curl -s -X POST https://3dservicesusa.com/api/agent/v1/quotes/$QUOTE/shipping-rates -H "Authorization: Bearer $AGENT_KEY" -H "Content-Type: application/json" \
  -d '{"address":{"name":"Dana Smith","street1":"100 Main St","city":"Austin","state":"TX","zip":"78701"}}'

curl -s -X POST https://3dservicesusa.com/api/agent/v1/quotes/$QUOTE/shipping-selection -H "Authorization: Bearer $AGENT_KEY" -H "Content-Type: application/json" \
  -d '{"rateId":"rate_..."}'

curl -s -X POST https://3dservicesusa.com/api/agent/v1/quotes/$QUOTE/checkout-link -H "Authorization: Bearer $AGENT_KEY"

• OpenAPI 3.1 document (/agents/openapi.json), with every limit in its x-limits extension.
• auth.md: how an agent obtains and uses a key.
• API catalog (RFC 9727, /.well-known/api-catalog).
• Any public page on this site is also available as markdown: request it with Accept: text/markdown.

Questions or a higher limit for a real workload: contact us.