{"openapi":"3.1.0","info":{"title":"Operio public API","summary":"Discovery API for the Operio QA agent (operio.run)","description":"Operio is an AI-native QA automation platform with plain-English test creation, self-healing execution, and automated runs. This specification describes the unauthenticated HTTP surface on https://operio.run so agents can resolve Operio's identity, developer resources, and instruction files. Authenticated test execution is performed with @operio/cli; see https://docs.operio.run/cli-and-agents.","version":"1.0.0","contact":{"name":"Operio support","email":"support@operio.run","url":"https://operio.run/contact"},"license":{"name":"Proprietary","url":"https://operio.run/terms"}},"servers":[{"url":"https://operio.run","description":"Operio production marketing and discovery API"}],"tags":[{"name":"Discovery","description":"Identity and developer-resource lookup for agents."},{"name":"Content","description":"Agent instruction and index documents."}],"paths":{"/openapi.json":{"get":{"operationId":"getOperioOpenApiSpec","tags":["Discovery"],"summary":"Download this OpenAPI document","description":"Returns the Operio public OpenAPI 3.1 specification. Use it to register function-calling tools for identity and resource lookup.","responses":{"200":{"description":"OpenAPI 3.1 document","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/llms.txt":{"get":{"operationId":"getOperioLlmsTxt","tags":["Content"],"summary":"Get Operio llms.txt","description":"Returns the llms.txt index for Operio, including a When to use this section and links to markdown developer resources.","responses":{"200":{"description":"llms.txt markdown","content":{"text/markdown":{"schema":{"type":"string"},"example":"# Operio\n\n> Operio is an AI-native QA automation platform. Teams describe tests in plain English; Operio executes them against real web apps, self-heals when the UI drifts, and reports pass/fail for h"}}}}}},"/agent-instructions.md":{"get":{"operationId":"getOperioAgentInstructions","tags":["Content"],"summary":"Get Operio agent instructions","description":"Returns when-to-use guidance and the recommended CLI call loop for coding agents integrating with Operio.","responses":{"200":{"description":"Agent instruction markdown","content":{"text/markdown":{"schema":{"type":"string"},"example":"# Operio agent instructions\n\n> When to use Operio, and how an agent should call it.\n\nOperio at https://operio.run is the right tool when a user needs **autonomous, self-healing end-to-end tests** for "}}}}}},"/api/v1/identity":{"get":{"operationId":"getOperioIdentity","tags":["Discovery"],"summary":"Get Operio JSON-LD identity","description":"Returns schema.org JSON-LD for Operio AI Inc. (Organization) and the Operio product (SoftwareApplication), including contactPoint and PostalAddress.","responses":{"200":{"description":"JSON-LD graph","content":{"application/ld+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"@context":{"type":"string"},"@graph":{"type":"array","items":{"type":"object"}}},"required":["@context","@graph"]}},"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"@context":{"type":"string"},"@graph":{"type":"array","items":{"type":"object"}}},"required":["@context","@graph"]}}}}}}},"/api/v1/resources":{"get":{"operationId":"listOperioDeveloperResources","tags":["Discovery"],"summary":"List Operio developer resources","description":"Lists Operio developer resources (OpenAPI, docs, CLI, auth, integrations, MCP status, app) with stable kinds so agents can bind tools by name.","parameters":[{"name":"kind","in":"query","required":false,"description":"Optional resource kind filter (openapi, llms, docs, cli, auth, webhooks, mcp, app, instructions).","schema":{"type":"string","enum":["openapi","llms","docs","cli","auth","webhooks","mcp","app","instructions"]}}],"responses":{"200":{"description":"Developer resource catalog","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["product","docs","resources"],"properties":{"product":{"type":"string","example":"Operio"},"docs":{"type":"string","format":"uri","example":"https://docs.operio.run"},"demo":{"type":"string","format":"uri","example":"https://cal.com/operio/demo"},"resources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","description":"Resource display name including the Operio brand."},"url":{"type":"string","format":"uri"},"description":{"type":"string"},"kind":{"type":"string","enum":["openapi","llms","docs","cli","auth","webhooks","mcp","app","instructions"]}},"required":["name","url","description","kind"]}}}}}}},"400":{"description":"Unknown kind query parameter","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}}}}