{"openapi":"3.1.0","info":{"title":"Specialty Tokens agent inquiry API","version":"1.0.0","description":"Public, unauthenticated endpoint for AI agents to request bespoke AI development, an internal AI ops platform, or corporate AI training from Specialty Tokens on behalf of a client in DACH, London or Amsterdam.","contact":{"name":"Specialty Tokens","email":"hello@specialtytokens.com","url":"https://specialtytokens.com/agents"}},"servers":[{"url":"https://specialtytokens.com"}],"paths":{"/api/agents/inquiry":{"post":{"operationId":"submitAgentInquiry","summary":"Submit an engagement inquiry on behalf of a principal","description":"Creates a lead the team reviews within one business day. Rate limited per IP. Retries with the same inquiryId are idempotent.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentInquiry"}}}},"responses":{"200":{"description":"Inquiry received","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquiryReceipt"}}}},"400":{"description":"Validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited; honour Retry-After"},"502":{"description":"Lead could not be relayed; retry later or email hello@specialtytokens.com"}}}},"/api/agents/openapi.json":{"get":{"operationId":"getOpenApi","summary":"This document","responses":{"200":{"description":"OpenAPI 3.1 JSON"}}}},"/agents.json":{"get":{"operationId":"getAgentManifest","summary":"Agent manifest (services, regions, endpoints)","responses":{"200":{"description":"JSON manifest"}}}}},"components":{"schemas":{"AgentInquiry":{"type":"object","properties":{"agent":{"type":"object","properties":{"name":{"type":"string","maxLength":120,"description":"Name of the agent or assistant submitting this, e.g. 'Claude', 'Acme Procurement Agent'."},"operator":{"type":"string","maxLength":200},"contactUrl":{"type":"string","format":"uri","maxLength":500}},"required":["name"],"additionalProperties":false,"description":"The software agent making the request."},"principal":{"type":"object","properties":{"name":{"type":"string","maxLength":200,"description":"Full name of the person we should reply to."},"email":{"type":"string","format":"email","maxLength":320,"description":"Work email of the principal. We reply here."},"company":{"type":"string","maxLength":300,"description":"Company or organisation name."},"role":{"type":"string","maxLength":200},"phone":{"type":"string","maxLength":80},"companySize":{"type":"string","enum":["1-25","26-100","101-500","501-5000","5000+"]},"website":{"type":"string","format":"uri","maxLength":500}},"required":["name","email","company"],"additionalProperties":false,"description":"The human decision maker the agent acts for."},"request":{"type":"object","properties":{"service":{"type":"string","enum":["bespoke-ai-development","internal-ai-ops-platform","corporate-ai-training"],"description":"Which engagement the principal is exploring."},"region":{"type":"string","enum":["dach","london","amsterdam"],"description":"Where delivery should happen."},"summary":{"type":"string","maxLength":4000,"description":"What the principal wants, in plain language: systems involved, the workflow, the outcome."},"timeline":{"type":"string","enum":["asap","within-1-month","within-3-months","exploring"]},"budgetBand":{"type":"string","enum":["under-25k-eur","25k-75k-eur","75k-200k-eur","over-200k-eur","undisclosed"]},"language":{"type":"string","enum":["en","de"],"description":"Preferred language for our reply."},"preferredSlots":{"type":"array","items":{"type":"string","format":"date-time"}},"references":{"type":"array","items":{"type":"string","format":"uri","maxLength":500}}},"required":["service","region","summary"],"additionalProperties":false,"description":"The engagement being requested."},"inquiryId":{"type":"string"},"website":{"type":"string","maxLength":200}},"required":["agent","principal","request"],"additionalProperties":false},"InquiryReceipt":{"type":"object","properties":{"ok":{"const":true},"inquiryId":{"type":"string","description":"Echo of the idempotency key; quote it in follow-ups."},"status":{"const":"received"},"nextStep":{"type":"string"},"bookingUrl":{"type":"string","format":"uri","description":"Self-serve intro-call calendar for the principal."},"replyTo":{"type":"string","format":"email"},"responseTime":{"type":"string"}},"required":["ok","inquiryId","status","nextStep","bookingUrl","replyTo","responseTime"]},"Error":{"type":"object","properties":{"error":{"type":"string"},"field":{"type":["string","null"],"description":"Dotted path of the failing field, e.g. request.summary"}},"required":["error"]}}}}