{"openapi":"3.1.1","info":{"title":"Universal Tiny AI Provider","description":"Tenant-scoped profiles, durable model runs, private/shared instruction Skills, sessions and SSE events. Vertex AI uses configured ADC routes. Optional Graphiti memory projections and reviewed read-only MCP execution; see capabilities and operator configuration.","version":"0.10.0"},"paths":{"/health/live":{"get":{"tags":["health"],"summary":"Kiểm tra tiến trình","operationId":"live_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}},"description":"Trả200 khi HTTP process hoạt động. Không chứng minh database hoặc Vertex đã sẵn sàng.\n\nPublic endpoint; không yêu cầu API key.","x-required-scopes":[]}},"/health/ready":{"get":{"tags":["health"],"summary":"Kiểm tra sẵn sàng","operationId":"ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"503":{"description":"Service Unavailable","content":{"application/problem+json":{"schema":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"status":{"type":"integer","title":"Status"},"detail":{"type":"string","title":"Detail"},"code":{"type":"string","title":"Code"},"request_id":{"type":"string","title":"Request Id"}},"type":"object","required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails"}}}}},"description":"Kiểm tra PostgreSQL runtime role, migration checksums và FORCE RLS. Trả503 nếu không sẵn sàng; không thực hiện LLM inference.\n\nPublic endpoint; không yêu cầu API key.","x-required-scopes":[]}},"/v1/me":{"get":{"tags":["identity"],"summary":"Xem danh tính hiện tại","operationId":"me_v1_me_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Trả tenant, principal và scopes suy ra từ Bearer credential. Không nhận tenant_id từ client.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.","x-required-scopes":[]}},"/v1/capabilities":{"get":{"tags":["platform"],"summary":"Xem khả năng được cấu hình","operationId":"capabilities_v1_capabilities_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Công bố các module và adapter đang bật. Flag phản ánh cấu hình, không bảo đảm upstream luôn healthy. MCP mặc định tắt nếu chưa có origin allowlist.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.","x-required-scopes":[]}},"/v1/agents":{"post":{"tags":["agents"],"summary":"Tạo Agent Profile","operationId":"create_agent_v1_agents_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgent"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tạo profile draft trong tenant. Chưa chạy model; cần tạo và publish configuration version trước khi tạo run.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `agents:write`.","x-required-scopes":["agents:write"]},"get":{"tags":["agents"],"summary":"Liệt kê Agent Profiles","operationId":"list_agents_v1_agents_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentListResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Danh sách có cursor pagination, chỉ trong tenant hiện tại. Giữ cùng bộ lọc khi dùng next_cursor.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `agents:read`.","x-required-scopes":["agents:read"]}},"/v1/agents/{agent_id}":{"get":{"tags":["agents"],"summary":"Đọc Agent Profile","operationId":"get_agent_v1_agents__agent_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Trả profile, revision và active version. Response ETag dùng cho các action thay đổi cấu hình tiếp theo.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `agents:read`.","x-required-scopes":["agents:read"]}},"/v1/agents/{agent_id}/versions":{"post":{"tags":["agents"],"summary":"Tạo configuration version","operationId":"create_version_v1_agents__agent_id__versions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id"}},{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVersion"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedVersionResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tạo phiên bản bất biến; If-Match dùng ETag profile hiện tại. Có thể cấu hình model_route/model_name, instructions, memory_scope_ids, mcp_enabled và output_schema. Không tự publish.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `agents:write`.","x-required-scopes":["agents:write"]}},"/v1/agents/{agent_id}/versions/{version_id}":{"get":{"tags":["agents"],"summary":"Đọc configuration version","operationId":"get_version_v1_agents__agent_id__versions__version_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id"}},{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Version Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đọc đúng phiên bản của profile trong tenant; không tự thay bằng latest. Dùng để audit cấu hình đã pin trong run.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `agents:read`.","x-required-scopes":["agents:read"]}},"/v1/agents/{agent_id}/versions/{version_id}:publish":{"post":{"tags":["agents"],"summary":"Publish configuration version","operationId":"publish_version_v1_agents__agent_id__versions__version_id__publish_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id"}},{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Version Id"}},{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Command"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Chuyển active version bằng compare-and-swap với If-Match. Model route phải được operator cho phép. Run đang chạy vẫn giữ version đã pin.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `agents:publish`.","x-required-scopes":["agents:publish"]}},"/v1/webhooks":{"post":{"tags":["webhooks"],"summary":"Đăng ký webhook","operationId":"create_webhook_v1_webhooks_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookInput"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Webhook V1 Webhooks Post"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đăng ký hoặc xoay secret của subscription do actor sở hữu. Origin HTTPS phải được operator allowlist; secret mã hóa bằng AES-GCM. Yêu cầu Idempotency-Key; cùng key với payload khác trả409. Chỉ nhận terminal run events; không tự cấp quyền tới subscription khác.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `events:dispatch`.","x-required-scopes":["events:dispatch"]},"get":{"tags":["webhooks"],"summary":"Liệt kê webhook","operationId":"list_webhooks_v1_webhooks_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":36,"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},{"type":"null"}],"title":"Cursor"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Webhooks V1 Webhooks Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Liệt kê subscriptions của actor trong tenant hiện tại. Không trả secret hoặc ciphertext. API trả503 khi webhook chưa bật; worker dùng credential dispatcher riêng, không dùng credential tenant.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `events:dispatch`.","x-required-scopes":["events:dispatch"]}},"/v1/webhooks/{subscription_id}":{"delete":{"tags":["webhooks"],"summary":"Tắt webhook","operationId":"delete_webhook_v1_webhooks__subscription_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Subscription Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Webhook V1 Webhooks Subscription Id Delete"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tắt subscription thuộc actor hiện tại, giữ lịch sử delivery. Yêu cầu Idempotency-Key. Worker không bắt đầu gửi mới tới subscription đã tắt; request đã dispatch có thể hoàn tất. Trả404 nếu subscription không thuộc actor.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `events:dispatch`.","x-required-scopes":["events:dispatch"]}},"/v1/webhooks/{subscription_id}/deliveries":{"get":{"tags":["webhooks"],"summary":"Xem delivery","operationId":"list_webhook_deliveries_v1_webhooks__subscription_id__deliveries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Subscription Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":36,"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},{"type":"null"}],"title":"Cursor"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Webhook Deliveries V1 Webhooks Subscription Id Deliveries Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Xem trạng thái và số lần thử delivery của subscription thuộc actor. Delivery ít nhất một lần; receiver cần deduplicate bằng X-Webhook-Delivery và kiểm tra HMAC-SHA256 trên body gốc. Retry tối đa5 lần, không follow redirect.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `events:dispatch`.","x-required-scopes":["events:dispatch"]}},"/v1/sessions":{"post":{"tags":["sessions"],"summary":"Tạo session","operationId":"create_session_v1_sessions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSession"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tạo session thuộc actor hiện tại và Agent Profile. Response gồm session revision/ETag; chỉ một run writer được hoạt động trên session.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `sessions:write`.","x-required-scopes":["sessions:write"]}},"/v1/sessions/{session_id}":{"get":{"tags":["sessions"],"summary":"Đọc session","operationId":"get_session_v1_sessions__session_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đọc session thuộc actor hiện tại, active_run_id và revision. Session khác actor/tenant không được trả nội dung.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `sessions:read`.","x-required-scopes":["sessions:read"]}},"/v1/sessions/{session_id}/messages":{"get":{"tags":["sessions"],"summary":"Đọc working messages","operationId":"session_messages_v1_sessions__session_id__messages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionMessagesResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Trả lịch sử hữu hạn và thông tin truncation. Đây là session working context, không phải toàn bộ knowledge graph hoặc transcript không giới hạn.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `sessions:read`.","x-required-scopes":["sessions:read"]}},"/v1/sessions/{session_id}:compact":{"post":{"tags":["sessions"],"summary":"Compact session bằng summary","operationId":"compact_session_v1_sessions__session_id__compact_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}},{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompactSession"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionCompactionResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Client cung cấp summary và If-Match session. Không được compact khi có run hoạt động. Giữ watermark cùng transitive Skill/memory/tool authority lineage; chưa có AI auto-summary hoặc rollback API.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `sessions:write`.","x-required-scopes":["sessions:write"]}},"/v1/agent-runs":{"post":{"tags":["runs"],"summary":"Chạy Agent bất đồng bộ","operationId":"create_run_v1_agent_runs_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRun"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Commit run/session trước khi trả202. Poll run hoặc đọc SSE. Request model.name override cần models:select; project, ADC và allowed models thuộc server policy. Dùng If-Match khi tiếp tục session hiện có. Skills/memory/tools được pin và kiểm quyền hiện tại.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `runs:execute`, `sessions:write`.","x-required-scopes":["runs:execute","sessions:write"]},"get":{"tags":["runs"],"summary":"Liệt kê Agent Runs","operationId":"list_runs_v1_agent_runs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunListResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Liệt kê runs thuộc actor hiện tại với cursor và optional agent_id. Không trả runs của actor khác trong cùng tenant.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `runs:read`.","x-required-scopes":["runs:read"]}},"/v1/agent-runs/{run_id}":{"get":{"tags":["runs"],"summary":"Đọc trạng thái và kết quả run","operationId":"get_run_v1_agent_runs__run_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Trả queued/running/completed/failed/canceled/expired, resolved model, output và usage. Unknown usage được giữ riêng; completed không cho phép vượt current authorization của context phụ thuộc.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `runs:read`.","x-required-scopes":["runs:read"]}},"/v1/agent-runs/{run_id}:cancel":{"post":{"tags":["runs"],"summary":"Yêu cầu hủy run","operationId":"cancel_run_v1_agent_runs__run_id__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Hủy run đang queued hoặc yêu cầu worker dừng. Không bảo đảm rollback external operation đã dispatch; unknown outcome được giữ để kiểm tra.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `runs:cancel`.","x-required-scopes":["runs:cancel"]}},"/v1/agent-runs/{run_id}/events":{"get":{"tags":["runs"],"summary":"Theo dõi run qua SSE","operationId":"run_events_v1_agent_runs__run_id__events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"last-event-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last-Event-Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Stream text/event-stream gồm metadata và sequence IDs. Hỗ trợ Last-Event-ID và bounded replay. Chưa stream token hoặc chain-of-thought; proxy phải tắt response buffering.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `runs:read`.","x-required-scopes":["runs:read"]}},"/v1/agent-runs/{run_id}/context":{"get":{"tags":["context"],"summary":"Liệt kê context snapshots","operationId":"list_run_context_v1_agent_runs__run_id__context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ContextSnapshotMetadata"},"title":"Response List Run Context V1 Agent Runs Run Id Context Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Metadata snapshots theo attempt; list tránh đọc payload lớn. Quyền hiện tại được kiểm tra, nội dung restricted/purged được đánh dấu đúng trạng thái.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `runs:read`.","x-required-scopes":["runs:read"]}},"/v1/agent-runs/{run_id}/context/{snapshot_id}":{"get":{"tags":["context"],"summary":"Đọc context snapshot","operationId":"get_run_context_snapshot_v1_agent_runs__run_id__context__snapshot_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Snapshot Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextSnapshotDetail"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"408":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Timeout"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Trả instructions/messages/memory/tool/schema thực tế Agent đã dùng ở attempt đó. Không phải private chain-of-thought. Nếu dependency bị revoke thì payload bị redacted/restricted, không tái dựng bằng graph hiện tại.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `runs:read`.","x-required-scopes":["runs:read"]}},"/v1/skills":{"post":{"tags":["skills"],"summary":"Tạo instruction Skill","operationId":"create_skill_v1_skills_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSkill"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tạo private hoặc tenant-shared instruction Skill. Tenant scope cần skills:admin. Chưa import package/scripts/resources; private ownership hiện theo principal.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:write`.","x-required-scopes":["skills:write"]},"get":{"tags":["skills"],"summary":"Liệt kê Skills","operationId":"list_skills_v1_skills_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillList"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Liệt kê Skill mà actor được phép đọc, có pagination. Không preload toàn bộ nội dung vào mỗi Agent context.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:read`.","x-required-scopes":["skills:read"]}},"/v1/skills/{skill_id}":{"get":{"tags":["skills"],"summary":"Đọc Skill metadata","operationId":"get_skill_v1_skills__skill_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đọc Skill trong access domain hiện tại và ETag dùng cho version/publish actions.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:read`.","x-required-scopes":["skills:read"]}},"/v1/skills/{skill_id}/versions":{"post":{"tags":["skills"],"summary":"Tạo Skill version","operationId":"version_skill_v1_skills__skill_id__versions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"}},{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSkillVersion"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionCreated"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tạo immutable instructions và configuration_schema với If-Match. Instructions tối đa8192 bytes. Không thực thi code trong Skill.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:write`.","x-required-scopes":["skills:write"]}},"/v1/skills/{skill_id}/versions/{version_id}":{"get":{"tags":["skills"],"summary":"Đọc Skill version","operationId":"get_version_v1_skills__skill_id__versions__version_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"}},{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Version Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillVersionResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đọc đúng phiên bản được phép; revoked content không tự thay bằng latest.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:read`.","x-required-scopes":["skills:read"]}},"/v1/skills/{skill_id}/versions/{version_id}:publish":{"post":{"tags":["skills"],"summary":"Publish Skill version","operationId":"publish_skill_v1_skills__skill_id__versions__version_id__publish_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"}},{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Version Id"}},{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Command"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Publish phiên bản bằng If-Match. Run pin version/hash và không tự chuyển version khi session tiếp tục.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:publish`.","x-required-scopes":["skills:publish"]}},"/v1/skills/{skill_id}/versions/{version_id}:revoke":{"post":{"tags":["skills"],"summary":"Revoke Skill version","operationId":"revoke_skill_v1_skills__skill_id__versions__version_id__revoke_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"}},{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Version Id"}},{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Command"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Thu hồi phiên bản bằng If-Match. Context/compaction chứa dependency đó được kiểm quyền lại; không xóa lịch sử audit.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:publish`.","x-required-scopes":["skills:publish"]}},"/v1/skills/{skill_id}/versions/{version_id}/SKILL.md":{"get":{"tags":["skills"],"summary":"Xuất SKILL.md","operationId":"export_skill_v1_skills__skill_id__versions__version_id__SKILL_md_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"}},{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Version Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Xuất instruction Skill theo định dạng Markdown. Đây không phải complete package export có scripts/assets.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:read`.","x-required-scopes":["skills:read"]}},"/v1/skill-bindings":{"post":{"tags":["skills"],"summary":"Gắn Skill vào Agent/user","operationId":"bind_skill_v1_skill_bindings_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBinding"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BindingResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tạo binding với configuration riêng; shared/mandatory binding có thêm skills:admin và agents:write tùy loại. Binding không trao MCP permissions.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:write`.","x-required-scopes":["skills:write"]}},"/v1/skill-bindings/{binding_id}":{"patch":{"tags":["skills"],"summary":"Cập nhật Skill binding","operationId":"patch_binding_v1_skill_bindings__binding_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"binding_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Binding Id"}},{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchBinding"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BindingResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Bật/tắt hoặc đổi configuration bằng If-Match binding. Thay đổi có kiểm soát và current-authority recheck ở runtime/trace.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:write`.","x-required-scopes":["skills:write"]}},"/v1/agents/{agent_id}/skill-bindings":{"get":{"tags":["skills"],"summary":"Liệt kê Agent Skill bindings","operationId":"bindings_v1_agents__agent_id__skill_bindings_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BindingResponse"},"title":"Response Bindings V1 Agents Agent Id Skill Bindings Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Xem bindings actor được phép đọc cho Agent. Không giả định mọi shared binding cho phép đọc private Skill khác user.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `skills:read`.","x-required-scopes":["skills:read"]}},"/v1/agent-runs/{run_id}/skills":{"get":{"tags":["skills"],"summary":"Xem Skill lockset của run","operationId":"run_skills_v1_agent_runs__run_id__skills_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SkillUseResponse"},"title":"Response Run Skills V1 Agent Runs Run Id Skills Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Xem đúng Skill version/hash/config đã pin. Kiểm tra quyền và trạng thái revoke hiện tại trước khi trả nội dung.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `runs:read`, `skills:read`.","x-required-scopes":["runs:read","skills:read"]}},"/v1/artifacts":{"post":{"tags":["artifacts"],"summary":"Tạo artifact","operationId":"create_artifact_v1_artifacts_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateArtifact"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Upload JSON với content_base64 và metadata; optional run_id phải thuộc actor/subject được phép. Blob lưu persistent volume. Không tự download arbitrary URL. Mutation này chưa có idempotency-key contract.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `artifacts:write`.","x-required-scopes":["artifacts:write"]},"get":{"tags":["artifacts"],"summary":"Liệt kê artifacts","operationId":"list_artifacts_v1_artifacts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactListResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"List artifact metadata có pagination và optional run_id trong access domain hiện tại; không đưa binary vào prompt.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `artifacts:read`.","x-required-scopes":["artifacts:read"]}},"/v1/artifacts/{artifact_id}":{"get":{"tags":["artifacts"],"summary":"Đọc artifact metadata","operationId":"get_artifact_v1_artifacts__artifact_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đọc media type, size, checksum, retention và trạng thái sau authorization. Không trả host storage path.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `artifacts:read`.","x-required-scopes":["artifacts:read"]},"delete":{"tags":["artifacts"],"summary":"Purge artifact","operationId":"delete_artifact_v1_artifacts__artifact_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Xóa binary và cập nhật metadata/audit, trả204. Không phải tenant offboarding hoặc global lineage erasure workflow.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `artifacts:write`.","x-required-scopes":["artifacts:write"]}},"/v1/artifacts/{artifact_id}/content":{"get":{"tags":["artifacts"],"summary":"Tải artifact binary","operationId":"get_artifact_content_v1_artifacts__artifact_id__content_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Trả binary theo Content-Type, Content-Length và hash ETag. Kiểm expiry/integrity trước khi đọc; artifact hết hạn/purged trả410.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `artifacts:read`.","x-required-scopes":["artifacts:read"]}},"/v1/users":{"post":{"tags":["users"],"summary":"Đăng ký external user","operationId":"create_user_v1_users_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUser"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Ánh xạ issuer + external_subject sang internal user ID trong tenant. Email optional. Endpoint này chưa có idempotency-key contract đồng đều với profile mutations; không giả định tự động upsert.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `identity:write`.","x-required-scopes":["identity:write"]},"get":{"tags":["users"],"summary":"Liệt kê users","operationId":"list_users_v1_users_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserListResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Danh sách user thuộc tenant với cursor pagination; identity records không tự cấp quyền act-on-behalf-of.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `identity:read`.","x-required-scopes":["identity:read"]}},"/v1/users/{user_id}":{"get":{"tags":["users"],"summary":"Đọc user","operationId":"get_user_v1_users__user_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đọc user theo internal ID trong tenant. ID không tồn tại hoặc ngoài tenant bị che bằng404.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `identity:read`.","x-required-scopes":["identity:read"]}},"/v1/organizations":{"post":{"tags":["organizations"],"summary":"Tạo organization","operationId":"create_organization_v1_organizations_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganization"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tạo organization với slug/name và optional parent_id trong cùng tenant. Không tự tạo memberships hoặc kế thừa quyền toàn bộ tổ chức con.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `identity:write`.","x-required-scopes":["identity:write"]},"get":{"tags":["organizations"],"summary":"Liệt kê organizations","operationId":"list_organizations_v1_organizations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationListResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Liệt kê tổ chức trong tenant với cursor pagination. Đây là identity metadata, không phải graph traversal API.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `identity:read`.","x-required-scopes":["identity:read"]}},"/v1/organizations/{org_id}":{"get":{"tags":["organizations"],"summary":"Đọc organization","operationId":"get_organization_v1_organizations__org_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đọc organization theo internal ID trong tenant, bao gồm parent nếu có.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `identity:read`.","x-required-scopes":["identity:read"]}},"/v1/organizations/{org_id}/members":{"post":{"tags":["organizations"],"summary":"Thêm organization membership","operationId":"add_membership_v1_organizations__org_id__members_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMembership"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembershipResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Gắn internal user vào organization với role member/admin/lead. Cả hai phải thuộc cùng tenant. Membership không thay thế delegation grant.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `identity:write`.","x-required-scopes":["identity:write"]},"get":{"tags":["organizations"],"summary":"Liệt kê organization memberships","operationId":"list_memberships_v1_organizations__org_id__members_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MembershipResponse"},"title":"Response List Memberships V1 Organizations Org Id Members Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Trả các memberships của organization trong tenant; không truy vấn membership xuyên tenant.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `identity:read`.","x-required-scopes":["identity:read"]}},"/v1/delegations":{"post":{"tags":["delegations"],"summary":"Cấp delegation","operationId":"grant_delegation_v1_delegations_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDelegation"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegationResponse"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Cho actor hiện tại hành động thay subject user, optional organization/Agent giới hạn và expires_at. Gửi X-On-Behalf-Of và X-Organization-Id khi sử dụng grant; membership phải còn hiệu lực. Chưa có blanket impersonation theo user ID client tự khai.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `delegations:manage`.","x-required-scopes":["delegations:manage"]}},"/v1/delegations/{delegation_id}":{"delete":{"tags":["delegations"],"summary":"Thu hồi delegation","operationId":"revoke_delegation_v1_delegations__delegation_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"delegation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Delegation Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Revoke delegation trong tenant, trả204. Runtime kiểm tra current authority để chặn context/run tiếp tục với grant đã thu hồi.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `delegations:manage`.","x-required-scopes":["delegations:manage"]}},"/v1/memory-scopes":{"post":{"tags":["memory"],"summary":"Tạo memory scope","operationId":"create_scope_v1_memory_scopes_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateScope"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Scope V1 Memory Scopes Post"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tạo explicit user/tenant/organization/agent scope, độc lập với bốn memory_type. Scope khác user cần memories:admin. Giới hạn32 scopes/tenant; chưa có automatic hierarchy resolver API.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `memories:write`.","x-required-scopes":["memories:write"]},"get":{"tags":["memory"],"summary":"Liệt kê memory scopes","operationId":"scopes_v1_memory_scopes_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Scopes V1 Memory Scopes Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Chỉ trả scope actor/subject hiện tại được phép đọc. Không công khai physical Graphiti namespace hoặc tự mở toàn tenant graph.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `memories:read`.","x-required-scopes":["memories:read"]}},"/v1/memories/search":{"post":{"tags":["memory"],"summary":"Tìm memory lexical/hybrid","operationId":"search_v1_memories_search_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchMemory"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Search V1 Memories Search Post"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Truy vấn tối đa4 scope_ids được cấp quyền, limit tối đa8. Lexical dùng PostgreSQL FTS; hybrid dùng Graphiti/Falkor RRF. Projection chưa current trả409, không silent fallback; kết quả kèm canonical source references.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `memories:read`.","x-required-scopes":["memories:read"]}},"/v1/memory-scopes/{scope_id}/memories":{"put":{"tags":["memory"],"summary":"Upsert canonical memory","operationId":"write_v1_memory_scopes__scope_id__memories_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scope Id"}},{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WriteMemory"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Write V1 Memory Scopes Scope Id Memories Put"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Upsert theo external_id. Record hiện có cần If-Match: \"memory:N\". Content tối đa8192 UTF-8 bytes; reference_time phải có timezone. Trả202 và projection job nếu Graphiti bật. Tối đa16 records/scope và64 revisions/record.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `memories:write`.","x-required-scopes":["memories:write"]}},"/v1/memories/{record_id}":{"get":{"tags":["memory"],"summary":"Đọc canonical memory","operationId":"get_v1_memories__record_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Record Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get V1 Memories Record Id Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đọc memory và ETag sau scope authorization. Tombstone trả410; graph projection không phải source of truth của record.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `memories:read`.","x-required-scopes":["memories:read"]},"delete":{"tags":["memory"],"summary":"Tombstone canonical memory","operationId":"delete_v1_memories__record_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Record Id"}},{"name":"if-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-Match"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete V1 Memories Record Id Delete"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Yêu cầu If-Match: \"memory:N\"; ghi revision/tombstone và reproject. Chặn đọc ngay. Chưa phải physical erasure toàn bộ backups/indexes/artifact lineage.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `memories:write`.","x-required-scopes":["memories:write"]}},"/v1/memory-scopes/{scope_id}:project":{"post":{"tags":["memory"],"summary":"Yêu cầu projection mới","operationId":"project_v1_memory_scopes__scope_id__project_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scope Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Project V1 Memory Scopes Scope Id Project Post"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Tạo job và namespace thế hệ mới cho scope. Chỉ publish sau lease/source-revision CAS. Không replay mutation vào graph đang quarantined; Graphiti tắt trả409.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `memories:write`.","x-required-scopes":["memories:write"]}},"/v1/memory-jobs/{job_id}":{"get":{"tags":["memory"],"summary":"Đọc projection job","operationId":"job_v1_memory_jobs__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Job V1 Memory Jobs Job Id Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Theo dõi queued/running/completed/obsolete/failed/quarantined và error_code. Job lỗi không tự publish dữ liệu một phần; Graphiti/model quota lỗi có thể cần retry bằng project action.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `memories:read`.","x-required-scopes":["memories:read"]}},"/v1/mcp/servers":{"post":{"tags":["mcp"],"summary":"Đăng ký MCP server","operationId":"register_v1_mcp_servers_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterServer"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Register V1 Mcp Servers Post"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"502":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Gateway"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đăng ký Streamable HTTP endpoint; operator phải cho phép exact origin/network. Registry chỉ lưu secret_ref, không bearer token. Chưa tự discovery hoặc cấp tool grants; gọi sync rồi review/bind.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `mcp:manage`.","x-required-scopes":["mcp:manage"]},"get":{"tags":["mcp"],"summary":"Liệt kê MCP servers","operationId":"servers_v1_mcp_servers_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Servers V1 Mcp Servers Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"502":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Gateway"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Liệt kê registry trong tenant. Không trả secret value hoặc MCP client session state.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `mcp:read`.","x-required-scopes":["mcp:read"]}},"/v1/mcp/servers/{server_id}:sync":{"post":{"tags":["mcp"],"summary":"Đồng bộ MCP tool catalog","operationId":"sync_v1_mcp_servers__server_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"server_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Server Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Sync V1 Mcp Servers Server Id Sync Post"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"502":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Gateway"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Discover paginated catalog tối đa64 tools/server rồi publish snapshot nguyên tử. Tool/schema hash đổi làm stale grant cũ. Tool mới không tự được cấp quyền; chưa periodic auto-sync.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `mcp:manage`.","x-required-scopes":["mcp:manage"]}},"/v1/mcp/servers/{server_id}":{"patch":{"tags":["mcp"],"summary":"Bật/tắt MCP server","operationId":"policy_v1_mcp_servers__server_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"server_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Server Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Policy"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Policy V1 Mcp Servers Server Id Patch"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"502":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Gateway"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"CAS bằng body revision và enabled. Disable chặn resolve/execution hiện tại; không chỉ ẩn tool khỏi UI. Endpoint này dùng revision trong body, không If-Match.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `mcp:manage`.","x-required-scopes":["mcp:manage"]}},"/v1/mcp/tools":{"get":{"tags":["mcp"],"summary":"Liệt kê MCP tool definitions","operationId":"tools_v1_mcp_tools_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"server_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Server Id"}},{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Tools V1 Mcp Tools Get"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"502":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Gateway"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Đọc schema/hash/catalog version; optional server_id. Tool registry là authority cho definitions và grants, không dùng Procedural Memory để tự cấp tool.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `mcp:read`.","x-required-scopes":["mcp:read"]}},"/v1/mcp/bindings":{"post":{"tags":["mcp"],"summary":"Cấp MCP tool binding","operationId":"bind_v1_mcp_bindings_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Binding"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Bind V1 Mcp Bindings Post"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"502":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Gateway"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Bind Agent với tool_id và schema_hash đã review. context_arguments inject trusted tenant/actor/subject/org và chặn spoofing. risk do admin xác nhận; write execution hiện bị chặn dù tạo được binding.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `mcp:manage`, `agents:write`.","x-required-scopes":["mcp:manage","agents:write"]}},"/v1/mcp/tool-invocations":{"post":{"tags":["mcp"],"summary":"Thực thi MCP read tool","operationId":"execute_v1_mcp_tool_invocations_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-On-Behalf-Of","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-On-Behalf-Of"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteTool"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Execute V1 Mcp Tool Invocations Post"}}}},"400":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Not Found"},"409":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Conflict"},"410":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Gone"},"412":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Failed"},"413":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Request Entity Too Large"},"415":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unsupported Media Type"},"422":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Unprocessable Entity"},"428":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Precondition Required"},"500":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Internal Server Error"},"502":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Bad Gateway"},"503":{"content":{"application/problem+json":{"schema":{"properties":{"type":{"title":"Type","type":"string"},"title":{"title":"Title","type":"string"},"status":{"title":"Status","type":"integer"},"detail":{"title":"Detail","type":"string"},"code":{"title":"Code","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemDetails","type":"object"}}},"description":"Service Unavailable"}},"description":"Gọi approved read binding với input schema validation và Idempotency-Key. Ghi queued/dispatched trước remote call. Completed replay từ ledger; failed/unknown không tự gọi lại. Write trả403 mcp_write_approval_required; chưa có approval/reconciliation workflow.\n\nYêu cầu `Authorization: Bearer `. Tenant được suy ra từ credential.\n\n**Required scopes:** `mcp:execute`.","x-required-scopes":["mcp:execute"]}}},"components":{"schemas":{"AgentConfiguration":{"properties":{"model_route":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z0-9][a-z0-9_.-]*$","title":"Model Route"},"model_name":{"anyOf":[{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},{"type":"null"}],"title":"Model Name"},"allowed_models":{"items":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$"},"type":"array","maxItems":16,"title":"Allowed Models"},"instructions":{"type":"string","maxLength":4096,"minLength":1,"title":"Instructions"},"max_steps":{"type":"integer","maximum":8.0,"minimum":1.0,"title":"Max Steps","default":8},"max_input_tokens":{"type":"integer","maximum":8192.0,"minimum":256.0,"title":"Max Input Tokens","default":8192},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"},"memory_scope_ids":{"items":{"type":"string"},"type":"array","maxItems":4,"title":"Memory Scope Ids"},"memory_strategy":{"type":"string","enum":["lexical","hybrid"],"title":"Memory Strategy","default":"lexical"},"mcp_enabled":{"type":"boolean","title":"Mcp Enabled","default":false}},"additionalProperties":false,"type":"object","required":["model_route","instructions"],"title":"AgentConfiguration"},"AgentListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AgentResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"consistency":{"type":"string","title":"Consistency","default":"live"}},"type":"object","required":["items","next_cursor"],"title":"AgentListResponse"},"AgentResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"revision":{"type":"integer","title":"Revision"},"active_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Active Version Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","slug","name","revision","active_version_id","created_at"],"title":"AgentResponse"},"ArtifactListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ArtifactResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","next_cursor"],"title":"ArtifactListResponse"},"ArtifactResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"owner_id":{"type":"string","format":"uuid","title":"Owner Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"media_type":{"type":"string","title":"Media Type"},"size":{"type":"integer","title":"Size"},"content_hash":{"type":"string","title":"Content Hash"},"retention_days":{"type":"integer","title":"Retention Days"},"status":{"type":"string","title":"Status"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","owner_id","media_type","size","content_hash","retention_days","status","metadata","created_at"],"title":"ArtifactResponse"},"AsyncExecution":{"properties":{"mode":{"type":"string","const":"async","title":"Mode","default":"async"}},"additionalProperties":false,"type":"object","title":"AsyncExecution"},"Binding":{"properties":{"agent_id":{"type":"string","format":"uuid","title":"Agent Id"},"tool_id":{"type":"string","format":"uuid","title":"Tool Id"},"schema_hash":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Schema Hash"},"risk":{"type":"string","enum":["read","write"],"title":"Risk"},"enabled":{"type":"boolean","title":"Enabled","default":true},"revision":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Revision"},"context_arguments":{"additionalProperties":{"type":"string","enum":["tenant_id","actor_id","subject_id","organization_id"]},"type":"object","maxProperties":4,"title":"Context Arguments"}},"additionalProperties":false,"type":"object","required":["agent_id","tool_id","schema_hash","risk"],"title":"Binding"},"BindingResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"owner_id":{"type":"string","format":"uuid","title":"Owner Id"},"agent_id":{"type":"string","format":"uuid","title":"Agent Id"},"skill_id":{"type":"string","format":"uuid","title":"Skill Id"},"scope":{"type":"string","title":"Scope"},"enabled":{"type":"boolean","title":"Enabled"},"mandatory":{"type":"boolean","title":"Mandatory"},"activation":{"type":"string","title":"Activation"},"configuration":{"additionalProperties":true,"type":"object","title":"Configuration"},"revision":{"type":"integer","title":"Revision"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","owner_id","agent_id","skill_id","scope","enabled","mandatory","activation","configuration","revision","created_at"],"title":"BindingResponse"},"CapabilitiesResponse":{"properties":{"stage":{"type":"string","title":"Stage","default":"memory-mcp-runtime"},"agent_profiles":{"type":"boolean","title":"Agent Profiles","default":true},"profile_versions":{"type":"boolean","title":"Profile Versions","default":true},"agent_execution":{"type":"boolean","title":"Agent Execution","default":false},"graphiti_memory":{"type":"boolean","title":"Graphiti Memory","default":false},"dynamic_skills":{"type":"boolean","title":"Dynamic Skills","default":true},"skill_package_import":{"type":"boolean","title":"Skill Package Import","default":false},"skill_scripts":{"type":"boolean","title":"Skill Scripts","default":false},"delegated_identity":{"type":"boolean","title":"Delegated Identity","default":true},"mcp_execution":{"type":"boolean","title":"Mcp Execution","default":false},"mcp_write_execution":{"type":"boolean","title":"Mcp Write Execution","default":false},"memory_lexical":{"type":"boolean","title":"Memory Lexical","default":true},"durable_runs":{"type":"boolean","title":"Durable Runs","default":true},"sessions":{"type":"boolean","title":"Sessions","default":true},"run_event_stream":{"type":"boolean","title":"Run Event Stream","default":true},"artifact_store":{"type":"boolean","title":"Artifact Store","default":true}},"type":"object","title":"CapabilitiesResponse"},"Command":{"properties":{},"additionalProperties":false,"type":"object","title":"Command"},"CompactSession":{"properties":{"summary":{"type":"string","maxLength":8192,"minLength":1,"title":"Summary"}},"additionalProperties":false,"type":"object","required":["summary"],"title":"CompactSession"},"ContextSnapshotDetail":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"run_id":{"type":"string","format":"uuid","title":"Run Id"},"session_id":{"type":"string","format":"uuid","title":"Session Id"},"attempt_number":{"type":"integer","title":"Attempt Number"},"status":{"type":"string","enum":["prepared","attempted","responded","unknown","redacted","expired"],"title":"Status"},"access":{"type":"string","enum":["full","restricted"],"title":"Access"},"payload_hash":{"type":"string","title":"Payload Hash"},"byte_size":{"type":"integer","title":"Byte Size"},"included_skills_count":{"type":"integer","title":"Included Skills Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"payload":{"anyOf":[{"$ref":"#/components/schemas/ContextSnapshotPayload"},{"type":"null"}]}},"type":"object","required":["id","run_id","session_id","attempt_number","status","access","payload_hash","byte_size","included_skills_count","created_at"],"title":"ContextSnapshotDetail"},"ContextSnapshotMetadata":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"run_id":{"type":"string","format":"uuid","title":"Run Id"},"session_id":{"type":"string","format":"uuid","title":"Session Id"},"attempt_number":{"type":"integer","title":"Attempt Number"},"status":{"type":"string","enum":["prepared","attempted","responded","unknown","redacted","expired"],"title":"Status"},"access":{"type":"string","enum":["full","restricted"],"title":"Access"},"payload_hash":{"type":"string","title":"Payload Hash"},"byte_size":{"type":"integer","title":"Byte Size"},"included_skills_count":{"type":"integer","title":"Included Skills Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","run_id","session_id","attempt_number","status","access","payload_hash","byte_size","included_skills_count","created_at"],"title":"ContextSnapshotMetadata"},"ContextSnapshotPayload":{"properties":{"system_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Instructions"},"memories":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Memories"},"tools":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tools"},"messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Messages"},"skills":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Skills"},"model_route":{"type":"string","title":"Model Route"},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"}},"additionalProperties":false,"type":"object","required":["messages","skills","model_route"],"title":"ContextSnapshotPayload"},"CreateAgent":{"properties":{"slug":{"type":"string","maxLength":63,"minLength":1,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Slug"},"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"}},"additionalProperties":false,"type":"object","required":["slug","name"],"title":"CreateAgent"},"CreateArtifact":{"properties":{"media_type":{"type":"string","maxLength":128,"minLength":1,"title":"Media Type"},"content_base64":{"type":"string","minLength":1,"title":"Content Base64"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"retention_days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Retention Days","default":30}},"additionalProperties":false,"type":"object","required":["media_type","content_base64"],"title":"CreateArtifact"},"CreateBinding":{"properties":{"agent_id":{"type":"string","format":"uuid","title":"Agent Id"},"skill_id":{"type":"string","format":"uuid","title":"Skill Id"},"scope":{"type":"string","enum":["user","agent"],"title":"Scope","default":"user"},"mandatory":{"type":"boolean","title":"Mandatory","default":false},"activation":{"type":"string","enum":["auto","always"],"title":"Activation","default":"auto"},"configuration":{"additionalProperties":true,"type":"object","title":"Configuration"}},"additionalProperties":false,"type":"object","required":["agent_id","skill_id"],"title":"CreateBinding"},"CreateDelegation":{"properties":{"subject_id":{"type":"string","format":"uuid","title":"Subject Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"additionalProperties":false,"type":"object","required":["subject_id"],"title":"CreateDelegation"},"CreateMembership":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"role":{"type":"string","pattern":"^(member|admin|lead)$","title":"Role","default":"member"}},"additionalProperties":false,"type":"object","required":["user_id"],"title":"CreateMembership"},"CreateOrganization":{"properties":{"slug":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Slug"},"name":{"type":"string","maxLength":256,"minLength":1,"title":"Name"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"}},"additionalProperties":false,"type":"object","required":["slug","name"],"title":"CreateOrganization"},"CreateRun":{"properties":{"agent_id":{"type":"string","format":"uuid","title":"Agent Id"},"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id"},"input":{"$ref":"#/components/schemas/TextInput"},"execution":{"$ref":"#/components/schemas/AsyncExecution"},"model":{"anyOf":[{"$ref":"#/components/schemas/ModelSelection"},{"type":"null"}]},"skills":{"$ref":"#/components/schemas/SkillSelection"}},"additionalProperties":false,"type":"object","required":["agent_id","input"],"title":"CreateRun"},"CreateScope":{"properties":{"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"},"scope_type":{"type":"string","enum":["user","tenant","organization","agent"],"title":"Scope Type","default":"user"},"target_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target Id"},"memory_type":{"type":"string","enum":["user","agent","business","procedural"],"title":"Memory Type"}},"additionalProperties":false,"type":"object","required":["name","memory_type"],"title":"CreateScope"},"CreateSession":{"properties":{"agent_id":{"type":"string","format":"uuid","title":"Agent Id"}},"additionalProperties":false,"type":"object","required":["agent_id"],"title":"CreateSession"},"CreateSkill":{"properties":{"slug":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Slug"},"description":{"type":"string","maxLength":1024,"minLength":1,"title":"Description"},"scope":{"type":"string","enum":["user","tenant"],"title":"Scope","default":"user"}},"additionalProperties":false,"type":"object","required":["slug","description"],"title":"CreateSkill"},"CreateSkillVersion":{"properties":{"instructions":{"type":"string","maxLength":8192,"minLength":1,"title":"Instructions"},"configuration_schema":{"additionalProperties":true,"type":"object","title":"Configuration Schema"}},"additionalProperties":false,"type":"object","required":["instructions"],"title":"CreateSkillVersion"},"CreateUser":{"properties":{"external_subject":{"type":"string","maxLength":256,"minLength":1,"title":"External Subject"},"name":{"type":"string","maxLength":256,"minLength":1,"title":"Name"},"issuer":{"type":"string","maxLength":128,"minLength":1,"title":"Issuer","default":"default"},"email":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Email"}},"additionalProperties":false,"type":"object","required":["external_subject","name"],"title":"CreateUser"},"CreateVersion":{"properties":{"configuration":{"$ref":"#/components/schemas/AgentConfiguration"}},"additionalProperties":false,"type":"object","required":["configuration"],"title":"CreateVersion"},"CreatedVersionResponse":{"properties":{"version":{"$ref":"#/components/schemas/VersionResponse"},"profile":{"$ref":"#/components/schemas/AgentResponse"}},"type":"object","required":["version","profile"],"title":"CreatedVersionResponse"},"DelegationResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id"},"actor_id":{"type":"string","format":"uuid","title":"Actor Id"},"subject_id":{"type":"string","format":"uuid","title":"Subject Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id"},"status":{"type":"string","title":"Status"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","tenant_id","actor_id","subject_id","organization_id","agent_id","status","expires_at","created_at"],"title":"DelegationResponse"},"ExecuteTool":{"properties":{"binding_id":{"type":"string","format":"uuid","title":"Binding Id"},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments"}},"additionalProperties":false,"type":"object","required":["binding_id"],"title":"ExecuteTool"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"HealthResponse"},"IdentityResponse":{"properties":{"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id"},"actor_id":{"type":"string","format":"uuid","title":"Actor Id"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"authorization_epoch":{"type":"integer","title":"Authorization Epoch"},"subject_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Subject Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"}},"type":"object","required":["tenant_id","actor_id","scopes","authorization_epoch"],"title":"IdentityResponse"},"MembershipResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"role":{"type":"string","title":"Role"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","tenant_id","user_id","organization_id","role","status","created_at"],"title":"MembershipResponse"},"ModelSelection":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]*$","title":"Name"},"temperature":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Temperature"},"max_output_tokens":{"anyOf":[{"type":"integer","maximum":4096.0,"minimum":64.0},{"type":"null"}],"title":"Max Output Tokens"}},"additionalProperties":false,"type":"object","required":["name"],"title":"ModelSelection"},"OrganizationListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrganizationResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","next_cursor"],"title":"OrganizationListResponse"},"OrganizationResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","tenant_id","slug","name","parent_id","status","created_at"],"title":"OrganizationResponse"},"PatchBinding":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"configuration":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Configuration"}},"additionalProperties":false,"type":"object","required":["enabled"],"title":"PatchBinding"},"Policy":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"revision":{"type":"integer","minimum":1.0,"title":"Revision"}},"additionalProperties":false,"type":"object","required":["enabled","revision"],"title":"Policy"},"RegisterServer":{"properties":{"slug":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z0-9][a-z0-9-]*$","title":"Slug"},"endpoint":{"type":"string","maxLength":2048,"minLength":1,"title":"Endpoint"},"secret_ref":{"anyOf":[{"type":"string","maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},{"type":"null"}],"title":"Secret Ref"},"transport":{"type":"string","const":"streamable_http","title":"Transport","default":"streamable_http"}},"additionalProperties":false,"type":"object","required":["slug","endpoint"],"title":"RegisterServer"},"ResolvedModelResponse":{"properties":{"provider":{"type":"string","const":"vertex_ai","title":"Provider"},"route":{"type":"string","title":"Route"},"name":{"type":"string","title":"Name"},"temperature":{"type":"number","title":"Temperature"},"max_output_tokens":{"type":"integer","title":"Max Output Tokens"}},"type":"object","required":["provider","route","name","temperature","max_output_tokens"],"title":"ResolvedModelResponse"},"RunListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/RunSummaryResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","next_cursor"],"title":"RunListResponse"},"RunResponse":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id"},"agent_id":{"type":"string","format":"uuid","title":"Agent Id"},"profile_version_id":{"type":"string","format":"uuid","title":"Profile Version Id"},"model":{"$ref":"#/components/schemas/ResolvedModelResponse"},"session_id":{"type":"string","format":"uuid","title":"Session Id"},"status":{"type":"string","title":"Status"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"usage":{"$ref":"#/components/schemas/RunUsage"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"deadline":{"type":"string","format":"date-time","title":"Deadline"},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links"},"output":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output"}},"type":"object","required":["run_id","agent_id","profile_version_id","model","session_id","status","error_code","usage","created_at","deadline","links","output"],"title":"RunResponse"},"RunSummaryResponse":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id"},"agent_id":{"type":"string","format":"uuid","title":"Agent Id"},"profile_version_id":{"type":"string","format":"uuid","title":"Profile Version Id"},"model":{"$ref":"#/components/schemas/ResolvedModelResponse"},"session_id":{"type":"string","format":"uuid","title":"Session Id"},"status":{"type":"string","title":"Status"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"usage":{"$ref":"#/components/schemas/RunUsage"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"deadline":{"type":"string","format":"date-time","title":"Deadline"},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links"}},"type":"object","required":["run_id","agent_id","profile_version_id","model","session_id","status","error_code","usage","created_at","deadline","links"],"title":"RunSummaryResponse"},"RunUsage":{"properties":{"status":{"type":"string","enum":["pending","actual","unknown"],"title":"Status"},"attempts":{"type":"integer","title":"Attempts"},"input_tokens":{"type":"integer","title":"Input Tokens"},"output_tokens":{"type":"integer","title":"Output Tokens"},"reserved_input_tokens":{"type":"integer","title":"Reserved Input Tokens"},"reserved_output_tokens":{"type":"integer","title":"Reserved Output Tokens"},"unknown_attempts":{"type":"integer","title":"Unknown Attempts"}},"type":"object","required":["status","attempts","input_tokens","output_tokens","reserved_input_tokens","reserved_output_tokens","unknown_attempts"],"title":"RunUsage"},"SearchMemory":{"properties":{"scope_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":4,"minItems":1,"title":"Scope Ids"},"query":{"type":"string","maxLength":1024,"minLength":1,"title":"Query"},"mode":{"type":"string","enum":["lexical","hybrid"],"title":"Mode","default":"lexical"},"limit":{"type":"integer","maximum":8.0,"minimum":1.0,"title":"Limit","default":5}},"additionalProperties":false,"type":"object","required":["scope_ids","query"],"title":"SearchMemory"},"SessionCompactionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"session_id":{"type":"string","format":"uuid","title":"Session Id"},"watermark_run_id":{"type":"string","format":"uuid","title":"Watermark Run Id"},"compacted_runs_count":{"type":"integer","title":"Compacted Runs Count"},"summary":{"type":"string","title":"Summary"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","session_id","watermark_run_id","compacted_runs_count","summary","created_at"],"title":"SessionCompactionResponse"},"SessionMessagesResponse":{"properties":{"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"},"window":{"type":"integer","title":"Window","default":32},"byte_limit":{"type":"integer","title":"Byte Limit","default":262144},"has_older":{"type":"boolean","title":"Has Older"}},"type":"object","required":["items","has_older"],"title":"SessionMessagesResponse"},"SessionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"agent_id":{"type":"string","format":"uuid","title":"Agent Id"},"revision":{"type":"integer","title":"Revision"},"active_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Active Run Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","agent_id","revision","active_run_id","created_at"],"title":"SessionResponse"},"SkillList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SkillResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","next_cursor"],"title":"SkillList"},"SkillResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"owner_id":{"type":"string","format":"uuid","title":"Owner Id"},"scope":{"type":"string","title":"Scope"},"slug":{"type":"string","title":"Slug"},"description":{"type":"string","title":"Description"},"revision":{"type":"integer","title":"Revision"},"active_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Active Version Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","owner_id","scope","slug","description","revision","active_version_id","created_at"],"title":"SkillResponse"},"SkillSelection":{"properties":{"mode":{"type":"string","enum":["auto","explicit","none"],"title":"Mode","default":"auto"},"binding_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":2,"title":"Binding Ids"}},"additionalProperties":false,"type":"object","title":"SkillSelection"},"SkillUseResponse":{"properties":{"binding_id":{"type":"string","format":"uuid","title":"Binding Id"},"skill_id":{"type":"string","format":"uuid","title":"Skill Id"},"version_id":{"type":"string","format":"uuid","title":"Version Id"},"content_hash":{"type":"string","title":"Content Hash"},"slug":{"type":"string","title":"Slug"},"configuration":{"additionalProperties":true,"type":"object","title":"Configuration"}},"type":"object","required":["binding_id","skill_id","version_id","content_hash","slug","configuration"],"title":"SkillUseResponse"},"SkillVersionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"skill_id":{"type":"string","format":"uuid","title":"Skill Id"},"number":{"type":"integer","title":"Number"},"instructions":{"type":"string","title":"Instructions"},"configuration_schema":{"additionalProperties":true,"type":"object","title":"Configuration Schema"},"content_hash":{"type":"string","title":"Content Hash"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","skill_id","number","instructions","configuration_schema","content_hash","published_at","revoked_at","created_at"],"title":"SkillVersionResponse"},"TextInput":{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"},"content":{"type":"string","maxLength":8192,"minLength":1,"title":"Content"}},"additionalProperties":false,"type":"object","required":["content"],"title":"TextInput"},"UserListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/UserResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","next_cursor"],"title":"UserListResponse"},"UserResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id"},"external_subject":{"type":"string","title":"External Subject"},"issuer":{"type":"string","title":"Issuer"},"name":{"type":"string","title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","tenant_id","external_subject","issuer","name","email","status","created_at"],"title":"UserResponse"},"VersionCreated":{"properties":{"skill":{"$ref":"#/components/schemas/SkillResponse"},"version":{"$ref":"#/components/schemas/SkillVersionResponse"}},"type":"object","required":["skill","version"],"title":"VersionCreated"},"VersionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"agent_id":{"type":"string","format":"uuid","title":"Agent Id"},"number":{"type":"integer","title":"Number"},"configuration":{"$ref":"#/components/schemas/AgentConfiguration"},"content_hash":{"type":"string","title":"Content Hash"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","agent_id","number","configuration","content_hash","created_at"],"title":"VersionResponse"},"WebhookInput":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":10,"title":"Url"},"event_types":{"items":{"type":"string"},"type":"array","maxItems":4,"minItems":1,"title":"Event Types"},"secret":{"type":"string","maxLength":256,"minLength":16,"format":"password","title":"Secret","writeOnly":true}},"additionalProperties":false,"type":"object","required":["url","event_types","secret"],"title":"WebhookInput"},"WriteMemory":{"properties":{"external_id":{"type":"string","maxLength":160,"minLength":1,"title":"External Id"},"content":{"type":"string","maxLength":8192,"minLength":1,"title":"Content"},"source":{"additionalProperties":true,"type":"object","title":"Source"},"reference_time":{"type":"string","format":"date-time","title":"Reference Time"}},"additionalProperties":false,"type":"object","required":["external_id","content","reference_time"],"title":"WriteMemory"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}},"tags":[{"name":"health","description":"Liveness và readiness của backend.","x-displayName":"Health"},{"name":"platform","description":"Capabilities đang cấu hình và giới hạn triển khai.","x-displayName":"Platform"},{"name":"identity","description":"Credential, tenant và actor hiện tại.","x-displayName":"Current identity"},{"name":"users","description":"Đồng bộ external identities trong tenant.","x-displayName":"Users"},{"name":"organizations","description":"Tổ chức và membership.","x-displayName":"Organizations"},{"name":"delegations","description":"Quyền hành động thay mặt user và thu hồi grant.","x-displayName":"Delegations"},{"name":"agents","description":"Draft, configuration versions và publish bằng CAS.","x-displayName":"Agent Profiles"},{"name":"runs","description":"Async execution, dynamic model, cancellation và SSE.","x-displayName":"Agent Runs"},{"name":"sessions","description":"Working messages, revision và manual compaction.","x-displayName":"Sessions"},{"name":"context","description":"Snapshots thực tế và current authorization.","x-displayName":"Context Trace"},{"name":"skills","description":"Instruction Skills, versions, bindings và revoke.","x-displayName":"Skills"},{"name":"memory","description":"Canonical memory, scopes, projections và hybrid search.","x-displayName":"Memory & Graphiti"},{"name":"mcp","description":"Server registry, discovery, reviewed bindings và read tool execution.","x-displayName":"Dynamic MCP"},{"name":"artifacts","description":"Upload, metadata, binary download, retention và purge.","x-displayName":"Artifacts"},{"name":"webhooks","description":"Subscriptions, encrypted signing keys và durable terminal run delivery.","x-displayName":"Webhooks"}]}