{"openapi":"3.1.0","info":{"title":"Almost Impossible API","version":"1.0.0","summary":"Read-only access to the published case studies, team and pages of almostimpossible.agency.","description":"A public, read-only API over the Almost Impossible website. No sign-in and no API key: every endpoint returns published content only. Guide: https://www.almostimpossible.agency/developers. The same data is available over MCP at https://www.almostimpossible.agency/mcp. Sandbox: every endpoint is read-only, so the production API is safe to call while you build; there is nothing to break and no data to clean up. Versioning: the version is in the path (/api/v1). Within v1 changes only add fields or endpoints. A breaking change ships as /api/v2; v1 then answers with Deprecation and Sunset headers (RFC 9745, RFC 8594) for at least 90 days before it is removed, and the change is announced on the developer guide first.","contact":{"name":"Almost Impossible","url":"https://www.almostimpossible.agency/developers"}},"externalDocs":{"description":"Developer guide","url":"https://www.almostimpossible.agency/developers"},"servers":[{"url":"https://www.almostimpossible.agency","description":"Production. Every endpoint is read-only, so it doubles as the sandbox."}],"x-api-versioning":{"strategy":"url-path","current":"v1","policy":"Versioning: the version is in the path (/api/v1). Within v1 changes only add fields or endpoints. A breaking change ships as /api/v2; v1 then answers with Deprecation and Sunset headers (RFC 9745, RFC 8594) for at least 90 days before it is removed, and the change is announced on the developer guide first.","deprecationHeaders":["Deprecation","Sunset"]},"security":[],"tags":[{"name":"Work","description":"Published case studies."},{"name":"Team","description":"The published team."},{"name":"Search","description":"Natural-language search over the site (NLWeb)."}],"paths":{"/api/v1/work":{"get":{"operationId":"listWork","tags":["Work"],"summary":"List published case studies","description":"Case studies in the agency's own order, 20 at most per page. Page with cursor: pass next_cursor from one page to get the next; it is null on the last page. total is the number of matches.","parameters":[{"name":"q","in":"query","description":"Optional text matched against title, client and summary.","schema":{"type":"string","maxLength":100}},{"name":"cursor","in":"query","description":"next_cursor from the previous page. Leave out for the first page.","schema":{"type":"string"}},{"name":"offset","in":"query","description":"How many matches to skip, if you page by position instead of cursor.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","description":"Page size, 1 to 20.","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}}],"responses":{"200":{"description":"A page of case studies.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkListing"}}}},"404":{"description":"An error, as RFC 9457 problem details.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/work/{slug}":{"get":{"operationId":"getWork","tags":["Work"],"summary":"Get one case study","parameters":[{"name":"slug","in":"path","required":true,"description":"The case study slug, as in /work/{slug}.","schema":{"type":"string"}}],"responses":{"200":{"description":"The case study.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Work"}}}},"404":{"description":"An error, as RFC 9457 problem details.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/team":{"get":{"operationId":"listTeam","tags":["Team"],"summary":"List the team","description":"Names, roles and short bios. No email addresses or photos.","responses":{"200":{"description":"The team.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Team"}}}}}}},"/ask":{"get":{"operationId":"ask","tags":["Search"],"summary":"Ask a question about the agency (NLWeb)","description":"Keyword search over pages, case studies, news and articles, answered as schema.org items (NLWeb v0.55). POST with {\"query\": {\"text\": \"...\"}} is also accepted; ask for text/event-stream to stream.","parameters":[{"name":"query","in":"query","required":true,"description":"The question.","schema":{"type":"string","maxLength":500}},{"name":"mode","in":"query","description":"summarize adds a one-line SearchSummary item first.","schema":{"type":"string","enum":["list","summarize"]}},{"name":"streaming","in":"query","description":"true streams the results as server-sent events.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Results, or an NLWeb failure object when the query is missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskResponse"}},"text/event-stream":{"schema":{"type":"string"}}}}}},"post":{"operationId":"askPost","tags":["Search"],"summary":"Ask a question about the agency (NLWeb, POST)","description":"The NLWeb request body. /ask never changes anything, so any request is safe to retry; an Idempotency-Key is accepted and ignored.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional. Accepted for clients that always send one; retries are already safe.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":500}}},"prefer":{"type":"object","properties":{"streaming":{"type":"boolean"},"mode":{"type":"string","enum":["list","summarize"]},"response_format":{"type":"string","enum":["conversational_search"]}}}}}}}},"responses":{"200":{"description":"Results, or an NLWeb failure object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskResponse"}},"text/event-stream":{"schema":{"type":"string"}}}},"400":{"description":"The body is not a JSON object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskResponse"}}}}}}}},"components":{"schemas":{"WorkSummary":{"type":"object","required":["slug","title","url"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"client":{"type":["string","null"]},"year":{"type":["integer","null"]},"summary":{"type":["string","null"]},"url":{"type":"string","format":"uri"}}},"WorkListing":{"type":"object","required":["total","offset","limit","next_cursor","items"],"properties":{"total":{"type":"integer","description":"Number of matching case studies."},"offset":{"type":"integer","description":"Position of the first item on this page."},"limit":{"type":"integer","description":"Page size."},"next_cursor":{"type":["string","null"],"description":"Pass as cursor for the next page; null on the last page."},"items":{"type":"array","items":{"$ref":"#/components/schemas/WorkSummary"}}}},"Work":{"type":"object","required":["slug","title","url"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"client":{"type":["string","null"]},"year":{"type":["integer","null"]},"services":{"type":"array","items":{"type":"string"}},"summary":{"type":["string","null"]},"tldr":{"type":["string","null"]},"url":{"type":"string","format":"uri"}}},"Team":{"type":"object","required":["url","members"],"properties":{"url":{"type":"string","format":"uri"},"members":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"role":{"type":["string","null"]},"founder":{"type":"boolean"},"summary":{"type":["string","null"]},"linkedin":{"type":["string","null"]}}}}}},"AskResponse":{"type":"object","required":["_meta"],"properties":{"_meta":{"type":"object","properties":{"response_type":{"type":"string","enum":["answer","failure"]},"version":{"type":"string"},"response_format":{"type":"string"}}},"results":{"type":"array","items":{"type":"object","description":"A schema.org item: @type, name, url, description."}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Problem":{"type":"object","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri-reference"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"error":{"type":"string","description":"Short machine code, e.g. not_found."}}}}}}