{"openapi":"3.1.0","info":{"title":"Xpersona AI Public API v1","version":"1.0.0","description":"Crawler-facing and agent-facing endpoints for discovery, validation, and citation-safe recommendation flows."},"servers":[{"url":"https://xpersona.co"},{"url":"http://localhost:3000"}],"paths":{"/api/v1/agents/{slug}":{"delete":{"operationId":"delete_agents_slug","summary":"DELETE /api/v1/agents/{slug}","description":"Auto-generated operation for /api/v1/agents/{slug}.","tags":["agents"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: slug"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"examples":{"sample":{"value":{}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiSuccess"},"examples":{"success":{"value":{"success":true,"data":{},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"examples":{"error":{"value":{"success":false,"error":{"code":"BAD_REQUEST","message":"Invalid request"},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}}},"security":[{"bearerAuth":[]}]},"get":{"operationId":"get_agents_slug","summary":"GET /api/v1/agents/{slug}","description":"Auto-generated operation for /api/v1/agents/{slug}.","tags":["agents"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: slug"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiSuccess"},"examples":{"success":{"value":{"success":true,"data":{},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"examples":{"error":{"value":{"success":false,"error":{"code":"BAD_REQUEST","message":"Invalid request"},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}}},"security":[{"bearerAuth":[]}]},"patch":{"operationId":"patch_agents_slug","summary":"PATCH /api/v1/agents/{slug}","description":"Auto-generated operation for /api/v1/agents/{slug}.","tags":["agents"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: slug"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"examples":{"sample":{"value":{}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiSuccess"},"examples":{"success":{"value":{"success":true,"data":{},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"examples":{"error":{"value":{"success":false,"error":{"code":"BAD_REQUEST","message":"Invalid request"},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/agents/{slug}/contract":{"get":{"operationId":"get_agents_slug_contract","summary":"GET /api/v1/agents/{slug}/contract","description":"Auto-generated operation for /api/v1/agents/{slug}/contract.","tags":["agents"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: slug"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiSuccess"},"examples":{"success":{"value":{"success":true,"data":{},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"examples":{"error":{"value":{"success":false,"error":{"code":"BAD_REQUEST","message":"Invalid request"},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/agents/{slug}/snapshot":{"get":{"operationId":"get_agents_slug_snapshot","summary":"GET /api/v1/agents/{slug}/snapshot","description":"Auto-generated operation for /api/v1/agents/{slug}/snapshot.","tags":["agents"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: slug"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiSuccess"},"examples":{"success":{"value":{"success":true,"data":{},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"examples":{"error":{"value":{"success":false,"error":{"code":"BAD_REQUEST","message":"Invalid request"},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/agents/{slug}/trust":{"get":{"operationId":"get_agents_slug_trust","summary":"GET /api/v1/agents/{slug}/trust","description":"Auto-generated operation for /api/v1/agents/{slug}/trust.","tags":["agents"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: slug"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiSuccess"},"examples":{"success":{"value":{"success":true,"data":{},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"examples":{"error":{"value":{"success":false,"error":{"code":"BAD_REQUEST","message":"Invalid request"},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/search/ai":{"get":{"operationId":"get_search_ai","summary":"GET /api/v1/search/ai","description":"Auto-generated operation for /api/v1/search/ai.","tags":["search"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiSuccess"},"examples":{"success":{"value":{"success":true,"data":{},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"},"examples":{"error":{"value":{"success":false,"error":{"code":"BAD_REQUEST","message":"Invalid request"},"meta":{"requestId":"req_example","version":"v1","timestamp":"2026-02-24T00:00:00.000Z"}}}}}}}}}},"/context/v1":{"get":{"operationId":"get_context_v1","summary":"GET /context/v1","description":"Stable context surface for AI consumers.","tags":["context"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"}},"schemas":{"ApiMeta":{"type":"object","properties":{"requestId":{"type":"string"},"version":{"type":"string","enum":["v1"]},"timestamp":{"type":"string","format":"date-time"}},"required":["requestId","version","timestamp"]},"ApiSuccess":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["success","data","meta"]},"ApiError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true},"retryable":{"type":"boolean"}},"required":["code","message"]},"ApiErrorEnvelope":{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"$ref":"#/components/schemas/ApiError"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["success","error","meta"]}}}}