{"openapi":"3.1.0","info":{"title":"Needwing API","version":"3.0.0","description":"Research and recommendation tasks use a bounded model-directed tool loop with durable evidence and outcomes. Research is read-only and never contacts Agents; retired task fields such as agent_authorization and adopt_deliveries are rejected as unknown properties. Recommendations may carry a runtime-derived subject (catalog ids or web url). Account-session and operator APIs use the private listener."},"servers":[{"url":"/"}],"paths":{"/v3/network/openapi.json":{"get":{"operationId":"get_v3_network_openapi_json","security":[],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/health":{"get":{"operationId":"get_health","security":[],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/account":{"get":{"operationId":"get_v3_network_account","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/account_view"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/account/terms":{"get":{"operationId":"get_v3_network_account_terms","security":[],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/account_terms"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/account/sign-up":{"post":{"operationId":"post_v3_network_account_sign_up","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/account_sign_up_input"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/account_sign_up_result"}}}},"202":{"description":"A code was sent, or the address already has an account and a sign-in mail was sent instead; the two answers are identical. Trial accounts only (a limited or verified account gets 409 not_trial). 400 terms_required / terms_outdated, 429 sign_up_rate_limited, 503 sign_up_unavailable when no mail sender is configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/account_sign_up_result"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/account/verify":{"post":{"operationId":"post_v3_network_account_verify","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/account_verify_input"}}}},"responses":{"200":{"description":"The trial account became a limited person account; the same tokens now carry the provider scopes. 400 invalid_code (wrong, burned, or an address that already had an account), 410 code_expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/account_verify_result"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/.well-known/agent-card.json":{"get":{"operationId":"get_well_known_agent_card_json","security":[],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/.well-known/agent.json":{"get":{"operationId":"get_well_known_agent_json","security":[],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/a2a":{"post":{"operationId":"post_v3_agent_a2a","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Explicit A2A-Version 1.0 or 0.3 standard request. JSON-RPC and REST use their version-specific protocol envelopes."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"get":{"operationId":"get_v3_agent_a2a","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/a2a/rest/message:send":{"get":{"operationId":"get_v3_agent_a2a_rest_message_send","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_agent_a2a_rest_message_send","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Explicit A2A-Version 1.0 or 0.3 standard request. JSON-RPC and REST use their version-specific protocol envelopes."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/a2a/rest/message:stream":{"get":{"operationId":"get_v3_agent_a2a_rest_message_stream","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_agent_a2a_rest_message_stream","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Explicit A2A-Version 1.0 or 0.3 standard request. JSON-RPC and REST use their version-specific protocol envelopes."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/a2a/rest/tasks":{"get":{"operationId":"get_v3_agent_a2a_rest_tasks","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_agent_a2a_rest_tasks","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Explicit A2A-Version 1.0 or 0.3 standard request. JSON-RPC and REST use their version-specific protocol envelopes."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/a2a/rest/tasks/{task}":{"get":{"operationId":"get_v3_agent_a2a_rest_tasks_task","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[{"name":"task","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_agent_a2a_rest_tasks_task","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[{"name":"task","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Explicit A2A-Version 1.0 or 0.3 standard request. JSON-RPC and REST use their version-specific protocol envelopes."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/a2a/rest/extendedAgentCard":{"get":{"operationId":"get_v3_agent_a2a_rest_extendedAgentCard","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_agent_a2a_rest_extendedAgentCard","description":"A2A transport with standard version-specific errors, bounded streams, and optional Needwing extensions. Task completion does not prove grounded success.","security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Explicit A2A-Version 1.0 or 0.3 standard request. JSON-RPC and REST use their version-specific protocol envelopes."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/device":{"get":{"operationId":"get_v3_access_device","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/device_authorization_view"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_access_device","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/device_decision"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/device_decision_result"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/trial-accounts":{"post":{"operationId":"post_v3_network_trial_accounts","description":"Create a trial account and receive its OAuth tokens (client needwing-agent, resource /v3, scope research engage agent:register agent:engage; the provider scopes take effect only after the account signs up in chat): bounded research plus a few limited supplier conversations that the trial account opens itself (visibility own), under small daily caps. Send {request_id, client_name?}: request_id is a secret you generate (32-128 characters of A-Z a-z 0-9 _ -); only its sha256 is stored. Send no Authorization header (a header is refused with 400). 201 returns trial_account_id, level, the token pair, the limits and next steps. The same request_id within 24 hours returns 200 with the same account and a fresh token pair, revokes the previous refresh tokens and charges no budget again. Refresh at /v3/agent/oauth/token with client_id needwing-agent. The tokens work on /v3/network/* only, not on the MCP addresses. Registration budgets are per source and global (429 trial_quota_exceeded); trial budgets reset at 00:00 UTC. Registering or publishing Agents, provider replies, supply and proposal acceptance are unavailable.","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/trial_account_input"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/trial_account_result"}}}},"201":{"description":"New trial account created, with its token pair","content":{"application/json":{"schema":{"$ref":"#/components/schemas/trial_account_result"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/agent-providers/endpoint-challenges":{"post":{"operationId":"post_v3_access_agent_providers_endpoint_challenges","security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/agent_endpoint_challenge"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/agent-providers":{"post":{"operationId":"post_v3_access_agent_providers","security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/agent_registration"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/agent-providers/{id}/credential":{"post":{"operationId":"post_v3_access_agent_providers_id_credential","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/agent_credential_write"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/agent-capabilities/{id}/revisions/{revision}/probe":{"post":{"operationId":"post_v3_access_agent_capabilities_id_revisions_revision_probe","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"202":{"description":"Durable canned channel probe queued; not yet verified"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/agent-probes/{id}/confirm":{"post":{"operationId":"post_v3_access_agent_probes_id_confirm","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/agent-capabilities/{id}/revisions/{revision}/publish":{"post":{"operationId":"post_v3_access_agent_capabilities_id_revisions_revision_publish","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements":{"post":{"operationId":"post_v3_network_engagements","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_open"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"get":{"operationId":"get_v3_network_engagements","security":[{"apiKey":[]}],"parameters":[{"name":"before","in":"query","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"pa_linked","in":"query","schema":{"type":"boolean"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}":{"get":{"operationId":"get_v3_network_engagements_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"delete":{"operationId":"delete_v3_network_engagements_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"204":{"description":"Engagement hidden from account lists and closed if open; normal evidence retention applies."},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/entries":{"get":{"operationId":"get_v3_network_engagements_id_entries","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"since_seq","in":"query","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":256}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/messages":{"post":{"operationId":"post_v3_network_engagements_id_messages","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_message"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/entries/{seq}/resend":{"post":{"operationId":"post_v3_network_engagements_id_entries_seq_resend","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"seq","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_message"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/entries/{seq}/skip":{"post":{"operationId":"post_v3_network_engagements_id_entries_seq_skip","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"seq","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/close":{"post":{"operationId":"post_v3_network_engagements_id_close","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/inbox":{"get":{"operationId":"get_v3_network_inbox","security":[{"apiKey":[]}],"parameters":[{"name":"since_pos","in":"query","schema":{"type":"integer","minimum":0}},{"name":"from","in":"query","schema":{"enum":["bookmark"]},"description":"Mutually exclusive with since_pos; reading never acknowledges."},{"name":"wait_ms","in":"query","schema":{"type":"integer","minimum":0,"maximum":25000}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":256}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/inbox/ack":{"post":{"operationId":"post_v3_network_inbox_ack","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_inbox_ack"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-authorizations":{"get":{"operationId":"get_v3_access_provider_authorizations","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/delegation-settings":{"get":{"operationId":"get_v3_access_delegation_settings","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"put":{"operationId":"put_v3_access_delegation_settings","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_delegation_settings"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/engagements/{id}/continue":{"post":{"operationId":"post_v3_access_engagements_id_continue","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-authorizations/{id}/enable":{"post":{"operationId":"post_v3_access_provider_authorizations_id_enable","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-authorizations/{id}/revoke":{"post":{"operationId":"post_v3_access_provider_authorizations_id_revoke","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/provider-authorizations":{"get":{"operationId":"get_v3_network_provider_authorizations","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/provider-authorizations/{id}/revoke":{"post":{"operationId":"post_v3_network_provider_authorizations_id_revoke","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/block":{"post":{"operationId":"post_v3_network_engagements_id_block","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/proposals/{id}":{"get":{"operationId":"get_v3_access_proposals_id","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/proposals/{id}/answer":{"post":{"operationId":"post_v3_access_proposals_id_answer","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_proposal_answer"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-engagements/{id}/proposals/{pid}/approve":{"post":{"operationId":"post_v3_access_provider_engagements_id_proposals_pid_approve","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_owner_approval"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-engagements/{id}/proposals/{pid}/reject":{"post":{"operationId":"post_v3_access_provider_engagements_id_proposals_pid_reject","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_owner_reject"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-engagements/{id}/proposals/{pid}":{"get":{"operationId":"get_v3_access_provider_engagements_id_proposals_pid","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-engagements/{id}/agreements/{aid}":{"get":{"operationId":"get_v3_access_provider_engagements_id_agreements_aid","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"aid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/proposals/{pid}":{"get":{"operationId":"get_v3_network_engagements_id_proposals_pid","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/agreements/{id}":{"get":{"operationId":"get_v3_network_agreements_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/proposals":{"post":{"operationId":"post_v3_network_engagements_id_proposals","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_proposal"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/proposals/{pid}/withdraw":{"post":{"operationId":"post_v3_network_engagements_id_proposals_pid_withdraw","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/proposals/{pid}/answer":{"post":{"operationId":"post_v3_network_engagements_id_proposals_pid_answer","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_proposal_answer"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/notifications/subscriptions":{"get":{"operationId":"get_v3_network_notifications_subscriptions","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/notification_subscription_list"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_network_notifications_subscriptions","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/notification_subscription_input"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/notification_subscription"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/notifications/subscriptions/{id}":{"delete":{"operationId":"delete_v3_network_notifications_subscriptions_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Own subscription revoked and its stored destination cleared; another key's subscription is 404.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/notification_subscription_revoked"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/engagements/{id}/cases":{"get":{"operationId":"get_v3_access_engagements_id_cases","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_access_engagements_id_cases","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_case_open"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/engagements/{id}/cases/{cid}/statements":{"post":{"operationId":"post_v3_access_engagements_id_cases_cid_statements","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"cid","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_case_statement"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/cases":{"get":{"operationId":"get_v3_network_engagements_id_cases","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_network_engagements_id_cases","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_case_open"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/engagements/{id}/cases/{cid}/statements":{"post":{"operationId":"post_v3_network_engagements_id_cases_cid_statements","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"cid","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_case_statement"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/operator/cases":{"get":{"operationId":"get_v3_operator_cases","security":[{"operatorBearer":[]}],"x-private-listener-only":true,"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/operator/cases/{id}":{"get":{"operationId":"get_v3_operator_cases_id","security":[{"operatorBearer":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/operator/cases/{id}/decision":{"post":{"operationId":"post_v3_operator_cases_id_decision","security":[{"operatorBearer":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/engagement_case_decision"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-engagements":{"get":{"operationId":"get_v3_access_provider_engagements","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"provider_id","in":"query","schema":{"type":"string","format":"uuid"},"description":"Only conversations with this provider, which the session account must own."},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque next_cursor from the previous page."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/owner_provider_engagement_page"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-engagements/{id}":{"get":{"operationId":"get_v3_access_provider_engagements_id","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/owner_provider_engagement"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-engagements/{id}/entries":{"get":{"operationId":"get_v3_access_provider_engagements_id_entries","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"since_seq","in":"query","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":256}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/owner_provider_engagement_entry_page"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-engagements/{id}/close":{"post":{"operationId":"post_v3_access_provider_engagements_id_close","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/owner_provider_engagement"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/provider-engagements/{id}/block":{"post":{"operationId":"post_v3_access_provider_engagements_id_block","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/providers/{id}/standing-approval":{"get":{"operationId":"get_v3_access_providers_id_standing_approval","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"put":{"operationId":"put_v3_access_providers_id_standing_approval","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/provider_standing_approval"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"delete":{"operationId":"delete_v3_access_providers_id_standing_approval","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Standing approval revoked (idempotent); approvals already recorded are unchanged. No body."},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/providers":{"get":{"operationId":"get_v3_access_providers","security":[{"apiKey":[]}],"parameters":[{"name":"include_retired","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Retired providers (superseded personal providers kept for history) are omitted unless true."}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/providers/{id}":{"get":{"operationId":"get_v3_access_providers_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/providers/{id}/capabilities":{"get":{"operationId":"get_v3_access_providers_id_capabilities","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_access_providers_id_capabilities","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability_manifest"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"201":{"description":"Resource created"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/capabilities/{id}/revisions":{"post":{"operationId":"post_v3_access_capabilities_id_revisions","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability_manifest"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"201":{"description":"Resource created"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/capabilities/{id}/revisions/{revision}":{"get":{"operationId":"get_v3_access_capabilities_id_revisions_revision","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"put":{"operationId":"put_v3_access_capabilities_id_revisions_revision","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"If-Match","in":"header","required":true,"description":"Current draft row_version, as returned by the revision read.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability_manifest"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/capabilities/{id}/discovery-card":{"get":{"operationId":"get_v3_access_capabilities_id_discovery_card","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/discovery_card_response"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"put":{"operationId":"put_v3_access_capabilities_id_discovery_card","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/discovery_card_write"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/discovery_card_response"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/capabilities/{id}/revisions/{revision}/validate":{"post":{"operationId":"post_v3_access_capabilities_id_revisions_revision_validate","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/capabilities/{id}/revisions/{revision}/dry-run":{"post":{"operationId":"post_v3_access_capabilities_id_revisions_revision_dry_run","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability_check"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/capabilities/{id}/revisions/{revision}/trials":{"post":{"operationId":"post_v3_access_capabilities_id_revisions_revision_trials","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability_check"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"201":{"description":"Resource created"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/capabilities/{id}/revisions/{revision}/publish":{"post":{"operationId":"post_v3_access_capabilities_id_revisions_revision_publish","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"revision","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/trials/{id}":{"get":{"operationId":"get_v3_access_trials_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/capabilities/{id}/pause":{"post":{"operationId":"post_v3_access_capabilities_id_pause","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/capabilities/{id}/resume":{"post":{"operationId":"post_v3_access_capabilities_id_resume","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/service-types":{"get":{"operationId":"get_v3_access_service_types","security":[{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_access_service_types","security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/service_type_registration"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"201":{"description":"Resource created"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/service-types/{key}/versions":{"post":{"operationId":"post_v3_access_service_types_key_versions","security":[{"apiKey":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/service_type_version"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"201":{"description":"Resource created"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/providers/{id}/contacts":{"get":{"operationId":"get_v3_access_providers_id_contacts","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_access_providers_id_contacts","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/provider_contact"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/providers/{id}/contacts/{contact_id}":{"put":{"operationId":"put_v3_access_providers_id_contacts_contact_id","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"contact_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/provider_contact"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"delete":{"operationId":"delete_v3_access_providers_id_contacts_contact_id","security":[{"accountSession":[]}],"x-private-listener-only":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"contact_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact configured Homepage origin."},{"name":"X-CSRF-Token","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Contact removed; earlier approvals keep their sealed copy. No body."},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/capabilities/discover":{"post":{"operationId":"post_v3_network_capabilities_discover","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/discovery_request"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/discovery_observation"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/services/discover":{"post":{"operationId":"post_v3_network_services_discover","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/discovery_request"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/discovery_observation"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/capabilities/discovery-schema":{"get":{"operationId":"get_v3_network_capabilities_discovery_schema","security":[{},{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/integrations":{"get":{"operationId":"get_v3_network_integrations","security":[{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque next_cursor from the previous page of the same list."},{"name":"role","in":"query","schema":{"type":"string","enum":["agent","tool"]},"description":"Optional filter: agent returns Agent providers; tool returns trusted connectors such as web search and Needwing Helper. Reuse the same role with next_cursor."},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/integration_page"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/capabilities":{"get":{"operationId":"get_v3_network_capabilities","security":[{},{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque next_cursor from the previous page of the same list."},{"name":"role","in":"query","schema":{"type":"string","enum":["agent","tool"]},"description":"Optional filter: agent returns Agent providers; tool returns trusted connectors such as web search and Needwing Helper. Reuse the same role with next_cursor."},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability_page"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/service-types":{"get":{"operationId":"get_v3_network_service_types","security":[{},{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/service_type_page"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/service-types/{key}":{"get":{"operationId":"get_v3_network_service_types_key","security":[{},{"apiKey":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/service_type_v3"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/sessions":{"post":{"operationId":"post_v3_network_sessions","security":[{"apiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_session_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_session_receipt"}}}},"201":{"description":"Session created and first run admitted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_session_receipt"}}}},"202":{"description":"Processing admitted; read the returned resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_session_receipt"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"get":{"operationId":"get_v3_network_sessions","security":[{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/sessions/{id}":{"get":{"operationId":"get_v3_network_sessions_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Session-Token","in":"header","required":false,"description":"Required for a private session (created with private_token); a missing or wrong value is the same 404 as an unknown session. Ignored for a normal session.","schema":{"type":"string","minLength":43,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{43,128}$"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/session_snapshot"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"delete":{"operationId":"delete_v3_network_sessions_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Session-Token","in":"header","required":false,"description":"Required for a private session (created with private_token); a missing or wrong value is the same 404 as an unknown session. Ignored for a normal session.","schema":{"type":"string","minLength":43,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{43,128}$"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"204":{"description":"Private session purged (or already purged); no body. Normal sessions cannot be deleted: 404."},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/sessions/{id}/submissions":{"post":{"operationId":"post_v3_network_sessions_id_submissions","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Session-Token","in":"header","required":false,"description":"Required for a private session (created with private_token); a missing or wrong value is the same 404 as an unknown session. Ignored for a normal session.","schema":{"type":"string","minLength":43,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{43,128}$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/submission"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_session_receipt"}}}},"202":{"description":"Processing admitted; read the returned resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_session_receipt"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/sessions/{id}/runs/{run_id}":{"get":{"operationId":"get_v3_network_sessions_id_runs_run_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Session-Token","in":"header","required":false,"description":"Required for a private session (created with private_token); a missing or wrong value is the same 404 as an unknown session. Ignored for a normal session.","schema":{"type":"string","minLength":43,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{43,128}$"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/run_snapshot"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/sessions/{id}/runs/{run_id}/stop":{"post":{"operationId":"post_v3_network_sessions_id_runs_run_id_stop","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Session-Token","in":"header","required":false,"description":"Required for a private session (created with private_token); a missing or wrong value is the same 404 as an unknown session. Ignored for a normal session.","schema":{"type":"string","minLength":43,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{43,128}$"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/run_snapshot"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/sessions/{id}/events":{"get":{"operationId":"get_v3_network_sessions_id_events","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"after","in":"query","schema":{"type":"integer","minimum":0,"maximum":2147483647,"default":0},"description":"Last consumed event ID."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"X-Session-Token","in":"header","required":false,"description":"Required for a private session (created with private_token); a missing or wrong value is the same 404 as an unknown session. Ignored for a normal session.","schema":{"type":"string","minLength":43,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{43,128}$"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/event_page"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/sessions/{id}/evidence/{evidence_id}":{"get":{"operationId":"get_v3_network_sessions_id_evidence_evidence_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"evidence_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Session-Token","in":"header","required":false,"description":"Required for a private session (created with private_token); a missing or wrong value is the same 404 as an unknown session. Ignored for a normal session.","schema":{"type":"string","minLength":43,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{43,128}$"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/feedback":{"post":{"operationId":"post_v3_network_feedback","security":[{"apiKey":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"description":"Required for a private session (created with private_token); a missing or wrong value is the same 404 as an unknown session. Ignored for a normal session.","schema":{"type":"string","minLength":43,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{43,128}$"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/feedback"}}}},"responses":{"201":{"description":"Feedback recorded"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/network/usage":{"get":{"operationId":"get_v3_network_usage","security":[{"apiKey":[]}],"parameters":[{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/providers/{id}/capability-understandings/{understanding_id}":{"get":{"operationId":"get_v3_access_providers_id_capability_understandings_understanding_id","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"understanding_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/understanding_record"}}}},"202":{"description":"Original interpretation is pending; read the same resource. No automatic resend.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/understanding_record"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/access/providers/{id}/capability-understandings":{"post":{"operationId":"post_v3_access_providers_id_capability_understandings","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}},{"name":"x-af-consumer-id","in":"header","required":false,"description":"Ignored for full-access account API keys. Reserved for managed service credentials; trial accounts use the fixed default partition.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability_understanding_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/understanding_record"}}}},"202":{"description":"Original interpretation is pending; read the same resource. No automatic resend.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/understanding_record"}}}},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/.well-known/oauth-authorization-server":{"get":{"operationId":"get_well_known_oauth_authorization_server","security":[],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/.well-known/oauth-authorization-server/v3/agent/oauth":{"get":{"operationId":"get_well_known_oauth_authorization_server_v3_agent_oauth","security":[],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/.well-known/oauth-protected-resource/mcp":{"get":{"operationId":"get_well_known_oauth_protected_resource_mcp","security":[],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/.well-known/oauth-protected-resource/mcp/trial":{"get":{"operationId":"get_well_known_oauth_protected_resource_mcp_trial","security":[],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/oauth/authorize":{"get":{"operationId":"get_v3_agent_oauth_authorize","security":[],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"post":{"operationId":"post_v3_agent_oauth_authorize","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","additionalProperties":{"type":"string"},"description":"OAuth authorization-code + S256 PKCE, resource-bound tokens, the RFC 8628 device authorization grant (device_authorization starts it with client_id, optional scope and resource; the token endpoint then takes grant_type=urn:ietf:params:oauth:grant-type:device_code with device_code and client_id), or RFC 7009 revocation; see authorization-server metadata."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/oauth/token":{"post":{"operationId":"post_v3_agent_oauth_token","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","additionalProperties":{"type":"string"},"description":"OAuth authorization-code + S256 PKCE, resource-bound tokens, the RFC 8628 device authorization grant (device_authorization starts it with client_id, optional scope and resource; the token endpoint then takes grant_type=urn:ietf:params:oauth:grant-type:device_code with device_code and client_id), or RFC 7009 revocation; see authorization-server metadata."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/oauth/register":{"post":{"operationId":"post_v3_agent_oauth_register","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/empty_body"}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/oauth/device_authorization":{"post":{"operationId":"post_v3_agent_oauth_device_authorization","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","additionalProperties":{"type":"string"},"description":"OAuth authorization-code + S256 PKCE, resource-bound tokens, the RFC 8628 device authorization grant (device_authorization starts it with client_id, optional scope and resource; the token endpoint then takes grant_type=urn:ietf:params:oauth:grant-type:device_code with device_code and client_id), or RFC 7009 revocation; see authorization-server metadata."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/v3/agent/oauth/revoke":{"post":{"operationId":"post_v3_agent_oauth_revoke","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","additionalProperties":{"type":"string"},"description":"OAuth authorization-code + S256 PKCE, resource-bound tokens, the RFC 8628 device authorization grant (device_authorization starts it with client_id, optional scope and resource; the token endpoint then takes grant_type=urn:ietf:params:oauth:grant-type:device_code with device_code and client_id), or RFC 7009 revocation; see authorization-server metadata."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/mcp":{"post":{"operationId":"post_mcp","description":"Needwing MCP account address: caller tools needwing_* (scope research) and provider tools (agent:register, agent:engage); scopes are enforced per tool. Sign in or sign up in the host's window; named account keys work here too. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]},{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"MCP JSON-RPC request. 2026-07-28 (server/discover) needs matching protocol/method/name headers and _meta; the earlier 2025-06-18/2025-11-25 era (initialize) is served statelessly without them. Notifications return 202. Authenticate with Authorization: Bearer: at /mcp an OAuth access token whose resource is /mcp, or a named account key (afk_...); at /mcp/trial only an OAuth access token whose resource is /mcp/trial. A token of another resource, or a key at /mcp/trial, is a 401 whose WWW-Authenticate names this address's own protected-resource document."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"get":{"operationId":"get_mcp","description":"Needwing MCP account address: caller tools needwing_* (scope research) and provider tools (agent:register, agent:engage); scopes are enforced per tool. Sign in or sign up in the host's window; named account keys work here too. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]},{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"delete":{"operationId":"delete_mcp","description":"Needwing MCP account address: caller tools needwing_* (scope research) and provider tools (agent:register, agent:engage); scopes are enforced per tool. Sign in or sign up in the host's window; named account keys work here too. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]},{"apiKey":[]}],"parameters":[],"responses":{"204":{"description":"Private session purged (or already purged); no body. Normal sessions cannot be deleted: 404."},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"put":{"operationId":"put_mcp","description":"Needwing MCP account address: caller tools needwing_* (scope research) and provider tools (agent:register, agent:engage); scopes are enforced per tool. Sign in or sign up in the host's window; named account keys work here too. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]},{"apiKey":[]}],"parameters":[{"name":"If-Match","in":"header","required":true,"description":"Current draft row_version, as returned by the revision read.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"MCP JSON-RPC request. 2026-07-28 (server/discover) needs matching protocol/method/name headers and _meta; the earlier 2025-06-18/2025-11-25 era (initialize) is served statelessly without them. Notifications return 202. Authenticate with Authorization: Bearer: at /mcp an OAuth access token whose resource is /mcp, or a named account key (afk_...); at /mcp/trial only an OAuth access token whose resource is /mcp/trial. A token of another resource, or a key at /mcp/trial, is a 401 whose WWW-Authenticate names this address's own protected-resource document."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"patch":{"operationId":"patch_mcp","description":"Needwing MCP account address: caller tools needwing_* (scope research) and provider tools (agent:register, agent:engage); scopes are enforced per tool. Sign in or sign up in the host's window; named account keys work here too. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]},{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"MCP JSON-RPC request. 2026-07-28 (server/discover) needs matching protocol/method/name headers and _meta; the earlier 2025-06-18/2025-11-25 era (initialize) is served statelessly without them. Notifications return 202. Authenticate with Authorization: Bearer: at /mcp an OAuth access token whose resource is /mcp, or a named account key (afk_...); at /mcp/trial only an OAuth access token whose resource is /mcp/trial. A token of another resource, or a key at /mcp/trial, is a 401 whose WWW-Authenticate names this address's own protected-resource document."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}},"/mcp/trial":{"post":{"operationId":"post_mcp_trial","description":"Needwing MCP trial address: the same handler and tools as /mcp. With a Needwing web session the sign-in window shows the normal approve screen for that account; without one it creates a trial account after an invisible human check. Only OAuth tokens of resource /mcp/trial are accepted, no keys. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"MCP JSON-RPC request. 2026-07-28 (server/discover) needs matching protocol/method/name headers and _meta; the earlier 2025-06-18/2025-11-25 era (initialize) is served statelessly without them. Notifications return 202. Authenticate with Authorization: Bearer: at /mcp an OAuth access token whose resource is /mcp, or a named account key (afk_...); at /mcp/trial only an OAuth access token whose resource is /mcp/trial. A token of another resource, or a key at /mcp/trial, is a 401 whose WWW-Authenticate names this address's own protected-resource document."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"get":{"operationId":"get_mcp_trial","description":"Needwing MCP trial address: the same handler and tools as /mcp. With a Needwing web session the sign-in window shows the normal approve screen for that account; without one it creates a trial account after an invisible human check. Only OAuth tokens of resource /mcp/trial are accepted, no keys. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]}],"parameters":[],"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"delete":{"operationId":"delete_mcp_trial","description":"Needwing MCP trial address: the same handler and tools as /mcp. With a Needwing web session the sign-in window shows the normal approve screen for that account; without one it creates a trial account after an invisible human check. Only OAuth tokens of resource /mcp/trial are accepted, no keys. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]}],"parameters":[],"responses":{"204":{"description":"Private session purged (or already purged); no body. Normal sessions cannot be deleted: 404."},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"put":{"operationId":"put_mcp_trial","description":"Needwing MCP trial address: the same handler and tools as /mcp. With a Needwing web session the sign-in window shows the normal approve screen for that account; without one it creates a trial account after an invisible human check. Only OAuth tokens of resource /mcp/trial are accepted, no keys. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]}],"parameters":[{"name":"If-Match","in":"header","required":true,"description":"Current draft row_version, as returned by the revision read.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"MCP JSON-RPC request. 2026-07-28 (server/discover) needs matching protocol/method/name headers and _meta; the earlier 2025-06-18/2025-11-25 era (initialize) is served statelessly without them. Notifications return 202. Authenticate with Authorization: Bearer: at /mcp an OAuth access token whose resource is /mcp, or a named account key (afk_...); at /mcp/trial only an OAuth access token whose resource is /mcp/trial. A token of another resource, or a key at /mcp/trial, is a 401 whose WWW-Authenticate names this address's own protected-resource document."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"patch":{"operationId":"patch_mcp_trial","description":"Needwing MCP trial address: the same handler and tools as /mcp. With a Needwing web session the sign-in window shows the normal approve screen for that account; without one it creates a trial account after an invisible human check. Only OAuth tokens of resource /mcp/trial are accepted, no keys. GET/DELETE/PUT/PATCH return protocol method refusal.","security":[{"mailboxOAuth":["research"]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"MCP JSON-RPC request. 2026-07-28 (server/discover) needs matching protocol/method/name headers and _meta; the earlier 2025-06-18/2025-11-25 era (initialize) is served statelessly without them. Notifications return 202. Authenticate with Authorization: Bearer: at /mcp an OAuth access token whose resource is /mcp, or a named account key (afk_...); at /mcp/trial only an OAuth access token whose resource is /mcp/trial. A token of another resource, or a key at /mcp/trial, is a 401 whose WWW-Authenticate names this address's own protected-resource document."}}}},"responses":{"200":{"description":"Read, completed operation, or idempotent replay"},"400":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"401":{"description":"Missing or inactive credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"403":{"description":"Insufficient scope or grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"404":{"description":"Not found or outside ownership boundary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"409":{"description":"State/revision or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"410":{"description":"Expired result; no automatic reinvocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"412":{"description":"Draft If-Match precondition failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"413":{"description":"Input exceeds size limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"422":{"description":"Structured input validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"429":{"description":"Admission quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}}}},"components":{"securitySchemes":{"accountSession":{"type":"apiKey","in":"cookie","name":"af_v3_session","description":"Private Homepage session; writes also require exact Origin and X-CSRF-Token"},"operatorBearer":{"type":"http","scheme":"bearer","description":"Independent operator credential; never an account API key"},"mailboxOAuth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/v3/agent/oauth/authorize","tokenUrl":"/v3/agent/oauth/token","scopes":{"research":"Run Needwing research on the owner's behalf (sessions, evidence, catalog)","engage":"Open and use engagements as this client (own engagements only)","agent:register":"Register owned agent cards","agent:engage":"Participate in owned provider engagements"}}}},"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"Needwing API key"}},"schemas":{"trial_account_input":{"type":"object","additionalProperties":false,"required":["request_id"],"properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"},"client_name":{"type":"string","minLength":1,"maxLength":80,"pattern":"\\S"}}},"trial_account_result":{"type":"object","additionalProperties":false,"required":["trial_account_id","level","token","engagement_access","trial_limits","next"],"properties":{"trial_account_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"level":{"const":"trial"},"token":{"type":"object","additionalProperties":false,"required":["access_token","token_type","expires_in","refresh_token","scope"],"properties":{"access_token":{"type":"string","minLength":43,"maxLength":128},"token_type":{"const":"Bearer"},"expires_in":{"type":"integer","minimum":1},"refresh_token":{"type":"string","minLength":43,"maxLength":128},"scope":{"type":"string","minLength":1}}},"engagement_access":{"type":"object","additionalProperties":false,"required":["enabled","allowed_actions","opens_per_day","source_opens_per_day","global_opens_per_day","active_engagements","messages_per_engagement","authorization_ttl_seconds"],"properties":{"enabled":{"type":"boolean"},"allowed_actions":{"type":"array","items":{"enum":["open","read","send","ack","close","revoke"]}},"opens_per_day":{"type":"integer","minimum":1},"source_opens_per_day":{"type":"integer","minimum":1},"global_opens_per_day":{"type":"integer","minimum":1},"active_engagements":{"type":"integer","minimum":1},"messages_per_engagement":{"type":"integer","minimum":1},"authorization_ttl_seconds":{"type":"integer","minimum":1}}},"trial_limits":{"type":"object","additionalProperties":false,"required":["runs_per_day","source_runs_per_day","global_runs_per_day","allowed_operations"],"properties":{"runs_per_day":{"type":"integer","minimum":1},"source_runs_per_day":{"type":"integer","minimum":1},"global_runs_per_day":{"type":"integer","minimum":1},"allowed_operations":{"type":"array","minItems":1,"maxItems":1,"items":{"const":"query"}}}},"next":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["action","hint"],"properties":{"action":{"type":"string","minLength":1,"maxLength":40},"method":{"enum":["GET","POST","DELETE"]},"path":{"type":"string","minLength":1,"maxLength":200},"hint":{"type":"string","minLength":1,"maxLength":300}}}}}},"account_view":{"type":"object","additionalProperties":false,"required":["account_id","level","email","limits","can","next"],"properties":{"account_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"level":{"enum":["trial","limited","verified"]},"email":{"type":["string","null"],"maxLength":254},"limits":{"type":"object","additionalProperties":false,"required":["runs_per_day","active_runs","conversations_per_day","active_conversations","messages_per_conversation"],"properties":{"runs_per_day":{"type":"integer","minimum":1},"active_runs":{"type":["integer","null"],"minimum":1},"conversations_per_day":{"type":"integer","minimum":1},"active_conversations":{"type":"integer","minimum":1},"messages_per_conversation":{"type":["integer","null"],"minimum":1}}},"can":{"type":"object","additionalProperties":false,"required":["register_provider","publish_provider"],"properties":{"register_provider":{"type":"boolean"},"publish_provider":{"type":"boolean"}}},"next":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["action"],"properties":{"action":{"type":"string","minLength":1,"maxLength":40},"tool":{"type":"string","minLength":1,"maxLength":60},"method":{"enum":["GET","POST","DELETE"]},"path":{"type":"string","minLength":1,"maxLength":200},"url":{"type":"string","minLength":1,"maxLength":300},"hint":{"type":"string","minLength":1,"maxLength":300}}}}}},"account_terms":{"type":"object","additionalProperties":false,"required":["version","terms_url","privacy_url"],"properties":{"version":{"type":"string","minLength":1,"maxLength":64},"terms_url":{"type":"string","minLength":1,"maxLength":300},"privacy_url":{"type":"string","minLength":1,"maxLength":300}}},"account_sign_up_input":{"type":"object","additionalProperties":false,"required":["email","accept_terms","terms_version"],"properties":{"email":{"type":"string","minLength":3,"maxLength":254},"accept_terms":{"type":"boolean"},"terms_version":{"type":"string","minLength":1,"maxLength":64},"locale":{"type":"string","minLength":2,"maxLength":16}}},"account_sign_up_result":{"type":"object","additionalProperties":false,"required":["status","expires_in","resend_after"],"properties":{"status":{"const":"code_sent"},"expires_in":{"type":"integer","minimum":1},"resend_after":{"type":"integer","minimum":1}}},"account_verify_input":{"type":"object","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","minLength":1,"maxLength":16}}},"account_verify_result":{"type":"object","additionalProperties":false,"required":["account_id","level","email","next"],"properties":{"account_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"level":{"const":"limited"},"email":{"type":"string","minLength":3,"maxLength":254},"next":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["action"],"properties":{"action":{"type":"string","minLength":1,"maxLength":40},"tool":{"type":"string","minLength":1,"maxLength":60},"method":{"enum":["GET","POST","DELETE"]},"path":{"type":"string","minLength":1,"maxLength":200},"url":{"type":"string","minLength":1,"maxLength":300},"hint":{"type":"string","minLength":1,"maxLength":300}}}}}},"personal_provider_source_write":{"type":"object","additionalProperties":false,"required":["material","display_name","description","expected_generation","approve_material"],"properties":{"material":{"type":"string","minLength":1,"maxLength":20000,"pattern":"\\S"},"display_name":{"type":"string","minLength":1,"maxLength":128,"pattern":"\\S"},"description":{"type":"string","minLength":1,"maxLength":500,"pattern":"\\S"},"expected_generation":{"type":"integer","minimum":0,"maximum":2147483646},"approve_material":{"const":true}}},"agent_registration":{"type":"object","additionalProperties":false,"required":["provider_external_id","display_name","capability_external_id","description","keywords","reply_window_seconds","visibility","channel"],"properties":{"provider_external_id":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,62}$"},"capability_external_id":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,62}$"},"display_name":{"type":"string","minLength":1,"maxLength":128,"pattern":"\\S"},"description":{"type":"string","minLength":1,"maxLength":500,"pattern":"\\S"},"keywords":{"type":"array","maxItems":16,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":32,"pattern":"\\S"}},"reply_window_seconds":{"type":"integer","minimum":60,"maximum":86400},"visibility":{"enum":["private","network","public"]},"channel":{"enum":["mcp","a2a"]},"card_url":{"type":"string","minLength":1,"maxLength":2000},"endpoint_challenge_id":{"type":"string","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}$"},"skill_id":{"type":"string","minLength":1,"maxLength":128},"protocol_version":{"enum":["1.0","0.3"]},"engagement":{"type":"object","additionalProperties":false,"required":["max_concurrent","accepts_proposals"],"properties":{"max_concurrent":{"type":"integer","minimum":1,"maximum":10000},"accepts_proposals":{"type":"boolean"},"outbox_extension":{"type":"boolean"}}}},"anyOf":[{"type":"object","additionalProperties":false,"required":["provider_external_id","display_name","capability_external_id","description","keywords","reply_window_seconds","visibility","channel"],"properties":{"provider_external_id":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,62}$"},"capability_external_id":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,62}$"},"display_name":{"type":"string","minLength":1,"maxLength":128,"pattern":"\\S"},"description":{"type":"string","minLength":1,"maxLength":500,"pattern":"\\S"},"keywords":{"type":"array","maxItems":16,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":32,"pattern":"\\S"}},"reply_window_seconds":{"type":"integer","minimum":60,"maximum":86400},"visibility":{"enum":["private","network","public"]},"channel":{"const":"mcp"},"engagement":{"type":"object","additionalProperties":false,"required":["max_concurrent","accepts_proposals"],"properties":{"max_concurrent":{"type":"integer","minimum":1,"maximum":10000},"accepts_proposals":{"type":"boolean"},"outbox_extension":{"const":false}}}}},{"type":"object","additionalProperties":false,"required":["provider_external_id","display_name","capability_external_id","description","keywords","reply_window_seconds","visibility","channel","card_url","endpoint_challenge_id","skill_id","protocol_version"],"properties":{"provider_external_id":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,62}$"},"capability_external_id":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,62}$"},"display_name":{"type":"string","minLength":1,"maxLength":128,"pattern":"\\S"},"description":{"type":"string","minLength":1,"maxLength":500,"pattern":"\\S"},"keywords":{"type":"array","maxItems":16,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":32,"pattern":"\\S"}},"reply_window_seconds":{"type":"integer","minimum":60,"maximum":86400},"visibility":{"enum":["private","network","public"]},"channel":{"const":"a2a"},"card_url":{"type":"string","minLength":1,"maxLength":2000},"endpoint_challenge_id":{"type":"string","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}$"},"skill_id":{"type":"string","minLength":1,"maxLength":128},"protocol_version":{"enum":["1.0","0.3"]},"engagement":{"type":"object","additionalProperties":false,"required":["max_concurrent","accepts_proposals"],"properties":{"max_concurrent":{"type":"integer","minimum":1,"maximum":10000},"accepts_proposals":{"type":"boolean"},"outbox_extension":{"type":"boolean"}}}}}]},"agent_reply":{"type":"object","additionalProperties":false,"required":["answer","claims","items","questions","gaps"],"description":"agent.reply@1 output: untrusted provider-declared data. Grounding, constraint and validation rules apply unchanged; provider text never establishes retrieved evidence.","properties":{"answer":{"type":"string","minLength":1,"maxLength":20000,"description":"bounded prose answer"},"claims":{"type":"array","maxItems":32,"items":{"type":"object","additionalProperties":false,"required":["text","sources"],"properties":{"text":{"type":"string","minLength":1,"maxLength":2000},"sources":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":2048,"description":"provider-declared source reference; not network evidence"}}}}},"items":{"type":"array","maxItems":32,"items":{"type":"object","additionalProperties":false,"required":["id","title","facts"],"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.:@-]{1,128}$","description":"stable item identity within this reply; unique item identity is what candidate hard-constraint checks require"},"title":{"type":"string","minLength":1,"maxLength":256},"url":{"type":"string","minLength":1,"maxLength":2048,"description":"provider-declared URL; never fetched automatically"},"facts":{"type":"object","maxProperties":64,"description":"direct fields on this item, as data"}}}},"questions":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["id","question"],"properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"question":{"type":"string","minLength":1,"maxLength":1000}}}},"gaps":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":1000}}}},"agent_disclosure":{"type":"object","additionalProperties":false,"required":["brief"],"properties":{"brief":{"type":"string","minLength":1,"maxLength":8000,"description":"model-written focused brief for this delivery; never the raw session history"},"constraints":{"type":"object","additionalProperties":false,"properties":{"hard":{"type":"object","maxProperties":64,"description":"bounded structured map; keys are domain identifiers, values bounded JSON"},"preferences":{"type":"object","maxProperties":64,"description":"bounded structured map; keys are domain identifiers, values bounded JSON"}}},"facts":{"type":"object","maxProperties":64,"description":"bounded structured map; keys are domain identifiers, values bounded JSON"},"verbatim_request":{"type":"string","minLength":1,"maxLength":20000,"description":"verbatim request text; included only when the caller explicitly selected it"}}},"account_key_name":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"\\S"}}},"account_key_create":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"\\S"},"scopes":{"type":"array","minItems":1,"maxItems":10,"uniqueItems":true,"items":{"enum":["research","engage","understanding:read","understanding:observe","email:send_self","supply:read","supply:write","supply:publish","agent:register","agent:engage"]}},"engage_visibility":{"enum":["own","all"]}}},"account_key_update":{"type":"object","additionalProperties":false,"anyOf":[{"required":["name"]},{"required":["scopes"]},{"required":["engage_visibility"]}],"properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"\\S"},"scopes":{"type":"array","minItems":1,"maxItems":10,"uniqueItems":true,"items":{"enum":["research","engage","understanding:read","understanding:observe","email:send_self","supply:read","supply:write","supply:publish","agent:register","agent:engage"]}},"engage_visibility":{"enum":["own","all"]}}},"account_key":{"type":"object","additionalProperties":false,"required":["id","name","public_id","is_default","scopes","engage_visibility","created_at","last_used_at","revoked_at"],"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"\\S"},"public_id":{"type":"string","pattern":"^[0-9a-f]{16}$"},"is_default":{"type":"boolean"},"scopes":{"type":"array","minItems":1,"items":{"type":"string","maxLength":64}},"engage_visibility":{"enum":["own","all"]},"created_at":{"type":"string","format":"date-time"},"last_used_at":{"type":["string","null"],"format":"date-time"},"revoked_at":{"type":["string","null"],"format":"date-time"}}},"account_key_list":{"type":"object","additionalProperties":false,"required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","name","public_id","is_default","scopes","engage_visibility","created_at","last_used_at","revoked_at"],"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"\\S"},"public_id":{"type":"string","pattern":"^[0-9a-f]{16}$"},"is_default":{"type":"boolean"},"scopes":{"type":"array","minItems":1,"items":{"type":"string","maxLength":64}},"engage_visibility":{"enum":["own","all"]},"created_at":{"type":"string","format":"date-time"},"last_used_at":{"type":["string","null"],"format":"date-time"},"revoked_at":{"type":["string","null"],"format":"date-time"}}}}}},"account_key_renamed":{"type":"object","additionalProperties":false,"required":["key"],"properties":{"key":{"type":"object","additionalProperties":false,"required":["id","name","public_id","is_default","scopes","engage_visibility","created_at","last_used_at","revoked_at"],"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"\\S"},"public_id":{"type":"string","pattern":"^[0-9a-f]{16}$"},"is_default":{"type":"boolean"},"scopes":{"type":"array","minItems":1,"items":{"type":"string","maxLength":64}},"engage_visibility":{"enum":["own","all"]},"created_at":{"type":"string","format":"date-time"},"last_used_at":{"type":["string","null"],"format":"date-time"},"revoked_at":{"type":["string","null"],"format":"date-time"}}}}},"account_key_revoked":{"type":"object","additionalProperties":false,"required":["revoked","revoked_at"],"properties":{"revoked":{"const":true},"revoked_at":{"type":"string","format":"date-time"}}},"account_usage":{"type":"object","additionalProperties":false,"required":["account_id","active_keys","providers","published_capabilities","dispatches_24h"],"properties":{"account_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"active_keys":{"type":"integer","minimum":0},"providers":{"type":"integer","minimum":0},"published_capabilities":{"type":"integer","minimum":0},"dispatches_24h":{"type":"integer","minimum":0}}},"public_profile":{"type":"object","additionalProperties":false,"required":["public_id","public_name","name_is_default","bio","revision","updated_at","renames_available","rename_limit","rename_window_days"],"properties":{"public_id":{"type":"string","pattern":"^pub_[a-z2-7]{10}$"},"public_name":{"type":"string","minLength":1,"maxLength":240},"name_is_default":{"type":"boolean"},"bio":{"type":["string","null"],"maxLength":1120},"revision":{"type":"integer","minimum":0},"updated_at":{"type":"string","format":"date-time"},"renames_available":{"type":"integer","minimum":0,"maximum":3},"rename_limit":{"const":3},"rename_window_days":{"const":30}}},"public_profile_update":{"type":"object","additionalProperties":false,"required":["expected_revision"],"properties":{"expected_revision":{"type":"integer","minimum":0,"maximum":2147483647},"public_name":{"type":"string","minLength":1,"maxLength":240},"bio":{"type":["string","null"],"maxLength":1120}}},"discovery_request":{"type":"object","additionalProperties":false,"properties":{"description":{"type":"string","minLength":1,"maxLength":1000,"pattern":"\\S"},"filter":{"$ref":"#/components/schemas/discovery_request/$defs/expr0"},"limit":{"type":"integer","minimum":1,"maximum":64}},"required":[],"$defs":{"leaf":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"field":{"const":"service_type.key"},"op":{"const":"eq"},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"service_type.key"},"op":{"const":"in"},"value":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":256}}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"service_type.version"},"op":{"const":"eq"},"value":{"type":"integer"}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"service_type.version"},"op":{"const":"in"},"value":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"integer"}}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"service_type.version"},"op":{"const":"gte"},"value":{"type":"integer"}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"service_type.version"},"op":{"const":"lte"},"value":{"type":"integer"}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"provider_id"},"op":{"const":"eq"},"value":{"type":"string","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}$"}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"provider_id"},"op":{"const":"in"},"value":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","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}$"}}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"capability_id"},"op":{"const":"eq"},"value":{"type":"string","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}$"}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"capability_id"},"op":{"const":"in"},"value":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","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}$"}}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"provider_external_id"},"op":{"const":"eq"},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"provider_external_id"},"op":{"const":"in"},"value":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":256}}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"capability_external_id"},"op":{"const":"eq"},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"capability_external_id"},"op":{"const":"in"},"value":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":256}}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"operations"},"op":{"const":"contains"},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"role"},"op":{"const":"eq"},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["field","op","value"]},{"type":"object","additionalProperties":false,"properties":{"field":{"const":"role"},"op":{"const":"in"},"value":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":256}}},"required":["field","op","value"]}]},"expr4":{"$ref":"#/components/schemas/discovery_request/$defs/leaf"},"expr3":{"oneOf":[{"$ref":"#/components/schemas/discovery_request/$defs/leaf"},{"type":"object","additionalProperties":false,"properties":{"all":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/components/schemas/discovery_request/$defs/expr4"}}},"required":["all"]},{"type":"object","additionalProperties":false,"properties":{"any":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/components/schemas/discovery_request/$defs/expr4"}}},"required":["any"]}]},"expr2":{"oneOf":[{"$ref":"#/components/schemas/discovery_request/$defs/leaf"},{"type":"object","additionalProperties":false,"properties":{"all":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/components/schemas/discovery_request/$defs/expr3"}}},"required":["all"]},{"type":"object","additionalProperties":false,"properties":{"any":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/components/schemas/discovery_request/$defs/expr3"}}},"required":["any"]}]},"expr1":{"oneOf":[{"$ref":"#/components/schemas/discovery_request/$defs/leaf"},{"type":"object","additionalProperties":false,"properties":{"all":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/components/schemas/discovery_request/$defs/expr2"}}},"required":["all"]},{"type":"object","additionalProperties":false,"properties":{"any":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/components/schemas/discovery_request/$defs/expr2"}}},"required":["any"]}]},"expr0":{"oneOf":[{"$ref":"#/components/schemas/discovery_request/$defs/leaf"},{"type":"object","additionalProperties":false,"properties":{"all":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/components/schemas/discovery_request/$defs/expr1"}}},"required":["all"]},{"type":"object","additionalProperties":false,"properties":{"any":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/components/schemas/discovery_request/$defs/expr1"}}},"required":["any"]}]}},"description":"Optional literal lexical description (not a provider query or DSL), hard all/any filter, limit (default 8; exact {} browses 64). At most 4 Boolean levels, 32 leaves, 64 nodes, 16 children/group, 16384 UTF-8 bytes. Every branch is validated. Only root pass qualifies. Metadata is declared, never verified business suitability."},"discovery_observation":{"type":"object","additionalProperties":false,"properties":{"discovery_call_id":{"type":"string","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}$"},"discovery_version":{"const":1},"evaluator_version":{"const":1},"truncated":{"type":"boolean"},"catalog_complete":{"type":"boolean"},"capabilities":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"properties":{"capability_id":{"type":"string","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}$"},"revision":{"type":"integer","minimum":1},"name":{"type":"string"},"role":{"enum":["agent","tool"]},"provider_id":{"type":"string","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}$"},"provider_external_id":{"type":"string","minLength":1,"maxLength":256},"capability_external_id":{"type":"string","minLength":1,"maxLength":256},"service_type":{"type":"object","additionalProperties":false,"properties":{"key":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"integer","minimum":1}},"required":["key","version"]},"service_type_digest":{"type":"string"},"operations":{"type":"array","items":{"type":"string"}},"verification":{"type":"object"},"input_support":{"type":"object"},"engagement":{"type":"object","additionalProperties":false,"properties":{"accepts_proposals":{"type":"boolean"}},"required":["accepts_proposals"]},"card_revision":{"type":["integer","null"],"minimum":1},"card":{"type":"object","additionalProperties":false,"properties":{"card_revision":{"type":"integer","minimum":1},"capability_revision":{"type":"integer","minimum":1},"description":{"type":"string","maxLength":500},"keywords":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":32}}},"required":["card_revision","capability_revision","description","keywords"]},"owner":{"type":"object","additionalProperties":false,"required":["public_name","public_id"],"properties":{"public_name":{"type":"string","minLength":1,"maxLength":120},"public_id":{"type":"string","pattern":"^pub_[a-z2-7]{10}$"}}},"filter_state":{"enum":["pass","mismatch","unknown",null]},"checks":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string"},"state":{"enum":["pass","mismatch","unknown"]},"field":{"type":"string"},"reason":{"type":"string"}},"required":["path","state","reason"]}},"checks_truncated":{"type":"boolean"},"lexical_matches":{"type":"integer","minimum":0,"maximum":64}},"required":["capability_id","revision","name","role","provider_id","provider_external_id","capability_external_id","service_type","service_type_digest","operations","verification","card_revision","filter_state","checks","checks_truncated","lexical_matches"]}}},"required":["discovery_version","evaluator_version","truncated","catalog_complete","capabilities"]},"discovery_card_write":{"type":"object","additionalProperties":false,"properties":{"capability_revision":{"type":"integer","minimum":1,"maximum":2147483647},"expected_card_revision":{"type":"integer","minimum":0,"maximum":2147483646},"description":{"type":"string","maxLength":500},"keywords":{"type":"array","maxItems":16,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":32,"pattern":"\\S"}}},"required":["capability_revision","expected_card_revision","description","keywords"]},"discovery_card_response":{"type":"object","additionalProperties":false,"properties":{"card":{"anyOf":[{"type":"null"},{"type":"object","additionalProperties":false,"properties":{"card_revision":{"type":"integer","minimum":1},"capability_revision":{"type":"integer","minimum":1},"description":{"type":"string","maxLength":500},"keywords":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":32}}},"required":["card_revision","capability_revision","description","keywords"]}]},"latest_card_revision":{"type":"integer","minimum":0},"current_revision":{"type":["integer","null"],"minimum":1}},"required":["card","latest_card_revision","current_revision"]},"task_input":{"type":"object","additionalProperties":false,"properties":{"request":{"type":"string","minLength":1,"maxLength":20000,"description":"natural-language request; nonblank, kept verbatim, at most 20000 UTF-16 units"},"constraints":{"type":"object","additionalProperties":false,"properties":{"hard":{"type":"object","maxProperties":64,"description":"caller-owned hard constraints; satisfaction is checkable, never assumed"},"preferences":{"type":"object","maxProperties":64,"description":"bounded JSON object; keys are domain identifiers, values bounded JSON"}}},"facts":{"type":"object","maxProperties":64,"description":"bounded JSON object; keys are domain identifiers, values bounded JSON"},"output":{"type":"object","additionalProperties":false,"properties":{"format":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,63}$","description":"requested result format slug"}}},"integration":{"type":"object","additionalProperties":false,"required":["capability_id"],"properties":{"capability_id":{"type":"string","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}$","description":"id of one published network capability pinned as the task's integration"}}}}},"create_session_body":{"type":"object","additionalProperties":false,"required":["client_submission_id","task"],"properties":{"client_submission_id":{"type":"string","pattern":"^[A-Za-z0-9_.:@-]{1,128}$","description":"caller-owned idempotency identity; a replay with the same id is detected, never double-applied"},"consumer_id":{"type":"string","minLength":1,"maxLength":128,"description":"optional explicit consumer partition; must equal the authenticated caller's partition when present"},"private_token":{"type":"string","minLength":43,"maxLength":128,"pattern":"^[A-Za-z0-9_-]{43,128}$","description":"optional client-generated random secret that makes the session private: every per-session route then requires the same value in the X-Session-Token header (404 otherwise), the session is excluded from listings and views, and it is purged by DELETE or after an idle TTL. Only a hash is stored; the value is never echoed"},"task":{"type":"object","additionalProperties":false,"properties":{"request":{"type":"string","minLength":1,"maxLength":20000,"description":"natural-language request; nonblank, kept verbatim, at most 20000 UTF-16 units"},"constraints":{"type":"object","additionalProperties":false,"properties":{"hard":{"type":"object","maxProperties":64,"description":"caller-owned hard constraints; satisfaction is checkable, never assumed"},"preferences":{"type":"object","maxProperties":64,"description":"bounded JSON object; keys are domain identifiers, values bounded JSON"}}},"facts":{"type":"object","maxProperties":64,"description":"bounded JSON object; keys are domain identifiers, values bounded JSON"},"output":{"type":"object","additionalProperties":false,"properties":{"format":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,63}$","description":"requested result format slug"}}},"integration":{"type":"object","additionalProperties":false,"required":["capability_id"],"properties":{"capability_id":{"type":"string","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}$","description":"id of one published network capability pinned as the task's integration"}}}}}}},"submission":{"type":"object","additionalProperties":false,"required":["client_submission_id","expected_state_version","kind"],"properties":{"client_submission_id":{"type":"string","pattern":"^[A-Za-z0-9_.:@-]{1,128}$"},"expected_state_version":{"type":"integer","minimum":1,"description":"the session state version this submission expects"},"kind":{"enum":["request","task_update","clarification_answer"]},"request":{"type":"string","minLength":1,"maxLength":20000,"description":"kind request: new bounded request text"},"task":{"type":"object","additionalProperties":false,"properties":{"request":{"type":"string","minLength":1,"maxLength":20000,"description":"natural-language request; nonblank, kept verbatim, at most 20000 UTF-16 units"},"constraints":{"type":"object","additionalProperties":false,"properties":{"hard":{"type":"object","maxProperties":64,"description":"caller-owned hard constraints; satisfaction is checkable, never assumed"},"preferences":{"type":"object","maxProperties":64,"description":"bounded JSON object; keys are domain identifiers, values bounded JSON"}}},"facts":{"type":"object","maxProperties":64,"description":"bounded JSON object; keys are domain identifiers, values bounded JSON"},"output":{"type":"object","additionalProperties":false,"properties":{"format":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,63}$","description":"requested result format slug"}}},"integration":{"type":"object","additionalProperties":false,"required":["capability_id"],"properties":{"capability_id":{"type":"string","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}$","description":"id of one published network capability pinned as the task's integration"}}}},"description":"kind task_update: the full replacement task"},"answers":{"type":"object","maxProperties":64,"description":"kind clarification_answer: answers keyed by question id"},"integration":{"anyOf":[{"type":"object","additionalProperties":false,"required":["capability_id"],"properties":{"capability_id":{"type":"string","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}$","description":"id of one published network capability pinned as the task's integration"}}},{"type":"null"}],"description":"kind request only: pinned integration selection; null resets to automatic selection; other kinds must not carry it"}},"allOf":[{"if":{"required":["kind"],"properties":{"kind":{"const":"request"}}},"then":{"required":["request"],"properties":{"task":{"type":"null"},"answers":{"type":"null"}}}},{"if":{"required":["kind"],"properties":{"kind":{"const":"task_update"}}},"then":{"required":["task"],"additionalProperties":false,"properties":{"client_submission_id":{},"expected_state_version":{},"kind":{},"task":{},"request":{"type":"null"},"answers":{"type":"null"}}}},{"if":{"required":["kind"],"properties":{"kind":{"const":"clarification_answer"}}},"then":{"required":["answers"],"additionalProperties":false,"properties":{"client_submission_id":{},"expected_state_version":{},"kind":{},"answers":{},"request":{"type":"null"},"task":{"type":"null"}}}}]},"create_session_receipt":{"type":"object","additionalProperties":false,"required":["session_id","run_id","state_version"],"properties":{"session_id":{"type":"string","minLength":1,"maxLength":128},"run_id":{"type":"string","minLength":1,"maxLength":128},"state_version":{"type":"integer","minimum":1}}},"session_snapshot":{"type":"object","additionalProperties":false,"required":["session_id","state","state_version","task_revision","task","active_run_id","latest_run","clarifications","created_at","updated_at"],"properties":{"session_id":{"type":"string","minLength":1,"maxLength":128},"state":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,31}$","description":"bounded machine token; frozen by the tasks lane"},"state_version":{"type":"integer","minimum":1},"task_revision":{"type":"integer","minimum":1},"task":{"type":"object","additionalProperties":false,"properties":{"request":{"type":"string","minLength":1,"maxLength":20000,"description":"natural-language request; nonblank, kept verbatim, at most 20000 UTF-16 units"},"constraints":{"type":"object","additionalProperties":false,"properties":{"hard":{"type":"object","maxProperties":64,"description":"caller-owned hard constraints; satisfaction is checkable, never assumed"},"preferences":{"type":"object","maxProperties":64,"description":"bounded JSON object; keys are domain identifiers, values bounded JSON"}}},"facts":{"type":"object","maxProperties":64,"description":"bounded JSON object; keys are domain identifiers, values bounded JSON"},"output":{"type":"object","additionalProperties":false,"properties":{"format":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,63}$","description":"requested result format slug"}}},"integration":{"type":"object","additionalProperties":false,"required":["capability_id"],"properties":{"capability_id":{"type":"string","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}$","description":"id of one published network capability pinned as the task's integration"}}}}},"active_run_id":{"type":["string","null"],"description":"the run currently executing; null when none"},"latest_run":{"type":["object","null"],"additionalProperties":false,"required":["run_id","session_id","status","final","usage","created_at","finished_at","outcome"],"properties":{"run_id":{"type":"string","minLength":1,"maxLength":128},"session_id":{"type":"string","minLength":1,"maxLength":128},"status":{"enum":["queued","running","completed","partial","needs_input","failed","stopped","interrupted"]},"final":{"type":"boolean"},"usage":{"type":"object","additionalProperties":false,"required":["modelTurns","toolCalls","tokens","outputBytes"],"properties":{"modelTurns":{"type":"integer","minimum":0,"description":"completed agent-model turns"},"toolCalls":{"type":"integer","minimum":0,"description":"tool invocations dispatched"},"tokens":{"type":"integer","minimum":0,"description":"total model tokens across turns"},"outputBytes":{"type":"integer","minimum":0,"description":"bytes of tool/model output retained"}}},"created_at":{"type":"string","format":"date-time"},"finished_at":{"type":["string","null"],"format":"date-time","description":"null while queued/running"},"outcome":{"type":["object","null"],"additionalProperties":false,"required":["status","evidence_refs","gaps","reason_code"],"properties":{"status":{"enum":["completed","partial"],"description":"the finish payload's own claim; run-level failure/needs_input are run states, not finish payloads"},"answer":{"type":"string","minLength":1,"maxLength":50000,"description":"the synthesized deliverable; required for completed outcomes (or at least one recommendation), optional for partial ones"},"claims":{"type":"array","maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["text","evidence_refs"],"properties":{"text":{"type":"string","minLength":1,"maxLength":8000},"evidence_refs":{"type":"array","maxItems":256,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,255}$"}}}}},"recommendations":{"type":"array","maxItems":128,"items":{"type":"object","additionalProperties":false,"required":["candidate_id","title","rank","reason","tradeoffs","evidence_refs"],"properties":{"candidate_id":{"type":"string","minLength":1,"maxLength":256},"title":{"type":"string","minLength":1,"maxLength":500},"rank":{"type":"integer","minimum":1,"maximum":128},"reason":{"type":"string","minLength":1,"maxLength":4000},"tradeoffs":{"type":"array","maxItems":32,"items":{"type":"string","minLength":1,"maxLength":2000}},"evidence_refs":{"type":"array","maxItems":256,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,255}$"}},"subject":{"type":"object","additionalProperties":false,"required":["kind"],"properties":{"kind":{"enum":["catalog","web"]},"capability_id":{"type":"string","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}$"},"provider_id":{"type":"string","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}$"},"url":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^https?://"}}}}}},"evidence_refs":{"type":"array","maxItems":256,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,255}$"}},"gaps":{"type":"array","maxItems":64,"items":{"type":"string","minLength":1,"maxLength":2000}},"reason_code":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"}},"description":"the finish payload once completed; null otherwise"},"model_profile":{"type":"string","enum":["deepseek_flash","self_hosted"],"description":"model profile pinned at admission"}},"description":"newest run projection; null before the first run"},"clarifications":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["id","question"],"properties":{"id":{"type":"string","minLength":1,"maxLength":128},"question":{"type":"string","minLength":1,"maxLength":2000},"created_at":{"type":"string","format":"date-time"}}}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"run_snapshot":{"type":"object","additionalProperties":false,"required":["run_id","session_id","status","final","usage","created_at","finished_at","outcome"],"properties":{"run_id":{"type":"string","minLength":1,"maxLength":128},"session_id":{"type":"string","minLength":1,"maxLength":128},"status":{"enum":["queued","running","completed","partial","needs_input","failed","stopped","interrupted"]},"final":{"type":"boolean"},"usage":{"type":"object","additionalProperties":false,"required":["modelTurns","toolCalls","tokens","outputBytes"],"properties":{"modelTurns":{"type":"integer","minimum":0,"description":"completed agent-model turns"},"toolCalls":{"type":"integer","minimum":0,"description":"tool invocations dispatched"},"tokens":{"type":"integer","minimum":0,"description":"total model tokens across turns"},"outputBytes":{"type":"integer","minimum":0,"description":"bytes of tool/model output retained"}}},"created_at":{"type":"string","format":"date-time"},"finished_at":{"type":["string","null"],"format":"date-time","description":"null while queued/running"},"outcome":{"type":["object","null"],"additionalProperties":false,"required":["status","evidence_refs","gaps","reason_code"],"properties":{"status":{"enum":["completed","partial"],"description":"the finish payload's own claim; run-level failure/needs_input are run states, not finish payloads"},"answer":{"type":"string","minLength":1,"maxLength":50000,"description":"the synthesized deliverable; required for completed outcomes (or at least one recommendation), optional for partial ones"},"claims":{"type":"array","maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["text","evidence_refs"],"properties":{"text":{"type":"string","minLength":1,"maxLength":8000},"evidence_refs":{"type":"array","maxItems":256,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,255}$"}}}}},"recommendations":{"type":"array","maxItems":128,"items":{"type":"object","additionalProperties":false,"required":["candidate_id","title","rank","reason","tradeoffs","evidence_refs"],"properties":{"candidate_id":{"type":"string","minLength":1,"maxLength":256},"title":{"type":"string","minLength":1,"maxLength":500},"rank":{"type":"integer","minimum":1,"maximum":128},"reason":{"type":"string","minLength":1,"maxLength":4000},"tradeoffs":{"type":"array","maxItems":32,"items":{"type":"string","minLength":1,"maxLength":2000}},"evidence_refs":{"type":"array","maxItems":256,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,255}$"}},"subject":{"type":"object","additionalProperties":false,"required":["kind"],"properties":{"kind":{"enum":["catalog","web"]},"capability_id":{"type":"string","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}$"},"provider_id":{"type":"string","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}$"},"url":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^https?://"}}}}}},"evidence_refs":{"type":"array","maxItems":256,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,255}$"}},"gaps":{"type":"array","maxItems":64,"items":{"type":"string","minLength":1,"maxLength":2000}},"reason_code":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"}},"description":"the finish payload once completed; null otherwise"},"model_profile":{"type":"string","enum":["deepseek_flash","self_hosted"],"description":"model profile pinned at admission"}}},"event_page":{"type":"object","additionalProperties":false,"required":["items","next_after","has_more"],"properties":{"items":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["id","run_id","kind","summary","created_at"],"properties":{"id":{"type":"integer","minimum":1,"description":"monotonic server-assigned sequence number; the page cursor"},"run_id":{"type":"string","minLength":1,"maxLength":128},"kind":{"enum":["run_queued","run_started","model_started","tool_started","tool_finished","evidence_added","candidate_updated","clarification_requested","verification_finished","run_finished"]},"summary":{"type":"string","minLength":1,"maxLength":500},"data":{"description":"bounded structured detail; never hidden reasoning or credentials"},"created_at":{"type":"string","format":"date-time"}}}},"next_after":{"type":"integer","minimum":0,"description":"pass back as ?after= to continue; the last returned event id, 0 when none"},"has_more":{"type":"boolean"}}},"task_outcome":{"type":"object","additionalProperties":false,"required":["status","evidence_refs","gaps","reason_code"],"properties":{"status":{"enum":["completed","partial"],"description":"the finish payload's own claim; run-level failure/needs_input are run states, not finish payloads"},"answer":{"type":"string","minLength":1,"maxLength":50000,"description":"the synthesized deliverable; required for completed outcomes (or at least one recommendation), optional for partial ones"},"claims":{"type":"array","maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["text","evidence_refs"],"properties":{"text":{"type":"string","minLength":1,"maxLength":8000},"evidence_refs":{"type":"array","maxItems":256,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,255}$"}}}}},"recommendations":{"type":"array","maxItems":128,"items":{"type":"object","additionalProperties":false,"required":["candidate_id","title","rank","reason","tradeoffs","evidence_refs"],"properties":{"candidate_id":{"type":"string","minLength":1,"maxLength":256},"title":{"type":"string","minLength":1,"maxLength":500},"rank":{"type":"integer","minimum":1,"maximum":128},"reason":{"type":"string","minLength":1,"maxLength":4000},"tradeoffs":{"type":"array","maxItems":32,"items":{"type":"string","minLength":1,"maxLength":2000}},"evidence_refs":{"type":"array","maxItems":256,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,255}$"}},"subject":{"type":"object","additionalProperties":false,"required":["kind"],"properties":{"kind":{"enum":["catalog","web"]},"capability_id":{"type":"string","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}$"},"provider_id":{"type":"string","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}$"},"url":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^https?://"}}}}}},"evidence_refs":{"type":"array","maxItems":256,"uniqueItems":true,"items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:@/-]{0,255}$"}},"gaps":{"type":"array","maxItems":64,"items":{"type":"string","minLength":1,"maxLength":2000}},"reason_code":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"}}},"feedback":{"type":"object","additionalProperties":false,"required":["session_id","run_id","rating"],"properties":{"session_id":{"type":"string","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}$"},"run_id":{"type":"string","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}$"},"rating":{"type":"integer","minimum":1,"maximum":5},"comment":{"type":"string","minLength":1,"maxLength":2000}}},"capability_page":{"type":"object","additionalProperties":false,"required":["items","has_more","next_cursor"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["capability_id","capability_revision","provider_id","provider_external_id","capability_external_id","capability_display_name","role","service_type","service_type_digest","operations","visibility","status","published_at","verification","limits"],"properties":{"discovery_card":{"type":"object","additionalProperties":false,"properties":{"card_revision":{"type":"integer","minimum":1},"capability_revision":{"type":"integer","minimum":1},"description":{"type":"string","maxLength":500},"keywords":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":32}}},"required":["card_revision","capability_revision","description","keywords"]},"capability_id":{"type":"string","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}$"},"capability_revision":{"type":"integer","minimum":1},"provider_id":{"type":"string","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}$"},"provider_external_id":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,62}$"},"capability_external_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"capability_display_name":{"type":"string","minLength":1,"maxLength":200},"role":{"enum":["agent","tool"]},"owner":{"type":"object","additionalProperties":false,"required":["public_name","public_id"],"properties":{"public_name":{"type":"string","minLength":1,"maxLength":120},"public_id":{"type":"string","pattern":"^pub_[a-z2-7]{10}$"}}},"service_type":{"type":"object","additionalProperties":false,"required":["key","version"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"version":{"type":"integer","minimum":1,"maximum":1000}}},"service_type_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"visibility":{"enum":["private","network","public"]},"status":{"enum":["active","paused"]},"published_at":{"type":"string","format":"date-time"},"verification":{"type":"object","additionalProperties":false,"required":["declared","schema_validated","trial_passed","last_trial_passed_at"],"properties":{"declared":{"type":"boolean"},"schema_validated":{"type":"boolean"},"trial_passed":{"type":"boolean"},"last_trial_passed_at":{"type":["string","null"],"format":"date-time"}}},"input_support":{"type":"object","maxProperties":32},"engagement":{"type":"object","additionalProperties":false,"required":["accepts_proposals"],"properties":{"accepts_proposals":{"type":"boolean"}}},"limits":{"type":"object","additionalProperties":false,"required":["timeout_ms","max_output_bytes"],"properties":{"timeout_ms":{"type":"integer","minimum":1,"maximum":30000},"max_output_bytes":{"type":"integer","minimum":1,"maximum":262144},"max_input_bytes":{"type":"integer","minimum":1,"maximum":262144}}}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"],"description":"null while catalogs are fully materialized in one page"}}},"integration_page":{"type":"object","additionalProperties":false,"required":["items","has_more","next_cursor"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["capability_id","capability_revision","provider_id","provider_external_id","capability_external_id","capability_display_name","role","service_type","service_type_digest","operations","visibility","status","published_at","verification","limits"],"properties":{"discovery_card":{"type":"object","additionalProperties":false,"properties":{"card_revision":{"type":"integer","minimum":1},"capability_revision":{"type":"integer","minimum":1},"description":{"type":"string","maxLength":500},"keywords":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":32}}},"required":["card_revision","capability_revision","description","keywords"]},"capability_id":{"type":"string","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}$"},"capability_revision":{"type":"integer","minimum":1},"provider_id":{"type":"string","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}$"},"provider_external_id":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,62}$"},"capability_external_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"capability_display_name":{"type":"string","minLength":1,"maxLength":200},"role":{"enum":["agent","tool"]},"owner":{"type":"object","additionalProperties":false,"required":["public_name","public_id"],"properties":{"public_name":{"type":"string","minLength":1,"maxLength":120},"public_id":{"type":"string","pattern":"^pub_[a-z2-7]{10}$"}}},"service_type":{"type":"object","additionalProperties":false,"required":["key","version"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"version":{"type":"integer","minimum":1,"maximum":1000}}},"service_type_digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"visibility":{"enum":["private","network","public"]},"status":{"enum":["active","paused"]},"published_at":{"type":"string","format":"date-time"},"verification":{"type":"object","additionalProperties":false,"required":["declared","schema_validated","trial_passed","last_trial_passed_at"],"properties":{"declared":{"type":"boolean"},"schema_validated":{"type":"boolean"},"trial_passed":{"type":"boolean"},"last_trial_passed_at":{"type":["string","null"],"format":"date-time"}}},"input_support":{"type":"object","maxProperties":32},"engagement":{"type":"object","additionalProperties":false,"required":["accepts_proposals"],"properties":{"accepts_proposals":{"type":"boolean"}}},"limits":{"type":"object","additionalProperties":false,"required":["timeout_ms","max_output_bytes"],"properties":{"timeout_ms":{"type":"integer","minimum":1,"maximum":30000},"max_output_bytes":{"type":"integer","minimum":1,"maximum":262144},"max_input_bytes":{"type":"integer","minimum":1,"maximum":262144}}}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"],"description":"null while catalogs are fully materialized in one page"}}},"service_type_page":{"type":"object","additionalProperties":false,"required":["items","has_more","next_cursor"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["key","version","namespace","owner_account_id","visibility","effect","operations","definition","digest","published_at"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"version":{"type":"integer","minimum":1,"maximum":1000},"namespace":{"type":"string","minLength":1,"maxLength":64},"owner_account_id":{"type":["string","null"],"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}$"},"visibility":{"enum":["public","private"]},"effect":{"enum":["information"]},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"definition":{"type":"object","additionalProperties":false,"required":["input_schema","requirements_schema","output_schema","semantics","comparisons"],"properties":{"input_schema":{},"requirements_schema":{},"output_schema":{},"exchange_schema":{},"semantics":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"required":["path","kind"],"properties":{"path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"kind":{"enum":["text","number","boolean","enum","datetime","url","set"]},"label":{"type":"string","minLength":1,"maxLength":128},"unit":{"type":"string","minLength":1,"maxLength":32}}}},"comparisons":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"required":["id","operator","request_path","offer_path"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"operator":{"enum":["covers","at_least","at_most","equals","is_true","includes"]},"request_path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"offer_path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"unit":{"type":"string","minLength":1,"maxLength":32},"when":{"type":"object","maxProperties":16}}}},"projection":{"type":"object","additionalProperties":false,"required":["fields"],"properties":{"fields":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":128}},"order":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["field","direction"],"properties":{"field":{"type":"string","minLength":1,"maxLength":128},"direction":{"enum":["asc","desc"]}}}}}}}},"digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"published_at":{"type":"string","format":"date-time"}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"],"description":"null while catalogs are fully materialized in one page"}}},"provider_request_v3":{"type":"object","additionalProperties":false,"required":["protocol_version","correlation_id","service_type","operation","input","deadline_ms"],"properties":{"protocol_version":{"const":3},"correlation_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"},"service_type":{"type":"object","additionalProperties":false,"required":["key","version"],"properties":{"key":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"integer","minimum":1,"maximum":1000}}},"operation":{"enum":["query","exchange"]},"exchange_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"},"sequence":{"type":"integer","minimum":1,"maximum":1000},"reply_to":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"},"input":{"type":"object","additionalProperties":false,"required":["kind","values"],"properties":{"kind":{"enum":["query","clarification_request","clarification_answer","proposal","proposal_response","evidence_update"]},"values":{"type":"object","maxProperties":64},"reply_to":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"}}},"deadline_ms":{"type":"integer","minimum":1,"maximum":60000}},"allOf":[{"if":{"required":["operation"],"properties":{"operation":{"const":"exchange"}}},"then":{"required":["exchange_id","sequence"]}}]},"provider_response_v3":{"type":"object","additionalProperties":false,"required":["protocol_version","correlation_id","service_type","status"],"properties":{"protocol_version":{"const":3},"correlation_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"},"service_type":{"type":"object","additionalProperties":false,"required":["key","version"],"properties":{"key":{"type":"string","minLength":1,"maxLength":128},"version":{"type":"integer","minimum":1,"maximum":1000}}},"status":{"enum":["ok","partial","error"]},"data":{},"provenance":{"type":"array","maxItems":32,"items":{"type":"object","additionalProperties":false,"required":["kind"],"properties":{"kind":{"enum":["provider_declared","retrieved","derived"]},"source_id":{"type":"string","minLength":1,"maxLength":128},"observed_at":{"type":"string","format":"date-time"},"source_recorded_at":{"type":"string","format":"date-time"}}}},"issues":{"type":"array","maxItems":32,"items":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","minLength":1,"maxLength":64},"message":{"type":"string","minLength":1,"maxLength":500},"field_path":{"type":"string","minLength":1,"maxLength":256},"retryable":{"type":"boolean"}}}}}},"service_type_v3":{"type":"object","additionalProperties":false,"required":["key","version","effect","operations","input_schema","requirements_schema","output_schema","semantics","comparisons"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"version":{"type":"integer","minimum":1,"maximum":1000},"effect":{"enum":["information"]},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"input_schema":{},"requirements_schema":{},"output_schema":{},"exchange_schema":{},"semantics":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"required":["path","kind"],"properties":{"path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"kind":{"enum":["text","number","boolean","enum","datetime","url","set"]},"label":{"type":"string","minLength":1,"maxLength":128},"unit":{"type":"string","minLength":1,"maxLength":32}}}},"comparisons":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"required":["id","operator","request_path","offer_path"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"operator":{"enum":["covers","at_least","at_most","equals","is_true","includes"]},"request_path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"offer_path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"unit":{"type":"string","minLength":1,"maxLength":32},"when":{"type":"object","maxProperties":16}}}},"projection":{"type":"object","additionalProperties":false,"required":["fields"],"properties":{"fields":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":128}},"order":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["field","direction"],"properties":{"field":{"type":"string","minLength":1,"maxLength":128},"direction":{"enum":["asc","desc"]}}}}}}}},"capability_manifest":{"type":"object","additionalProperties":false,"required":["manifest_version","provider","capability"],"properties":{"manifest_version":{"const":1},"provider":{"type":"object","additionalProperties":false,"required":["external_id","kind","display_name"],"properties":{"external_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"kind":{"enum":["native","pseudo","agent"]},"display_name":{"type":"string","minLength":1,"maxLength":128}}},"capability":{"type":"object","additionalProperties":false,"required":["external_id","service_type","effect","operations","visibility","limits","binding"],"properties":{"external_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"service_type":{"type":"object","additionalProperties":false,"required":["key","version"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"version":{"type":"integer","minimum":1,"maximum":1000}}},"effect":{"enum":["information"]},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"visibility":{"enum":["private","network","public"]},"input_support":{"type":"object","maxProperties":32},"limits":{"type":"object","additionalProperties":false,"required":["timeout_ms","max_output_bytes"],"properties":{"timeout_ms":{"type":"integer","minimum":1,"maximum":30000},"max_output_bytes":{"type":"integer","minimum":1,"maximum":262144},"max_input_bytes":{"type":"integer","minimum":1,"maximum":262144}}},"binding":{"type":"object","additionalProperties":false,"required":["adapter","transport_binding_id","transport_binding_revision"],"properties":{"adapter":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"version":{"type":"integer","minimum":1,"maximum":1000}}},"transport_binding_id":{"type":"string","minLength":1,"maxLength":128},"transport_binding_revision":{"type":"integer","minimum":1,"maximum":1000}}}}}}},"capability_understanding_body":{"type":"object","additionalProperties":false,"required":["description"],"properties":{"description":{"type":"string","minLength":1,"maxLength":8000,"description":"what the capability does; nonblank, at most 8000 UTF-16 units"},"documents":{"type":"array","minItems":1,"maxItems":4,"items":{"type":"object","additionalProperties":false,"required":["name","content"],"properties":{"name":{"type":"string","minLength":1,"maxLength":128},"content":{"type":"string","minLength":1,"maxLength":16000}}},"description":"supporting documents; never fetched from URLs"},"examples":{"type":"array","minItems":1,"maxItems":3,"items":{"type":"object","additionalProperties":false,"required":["input","output"],"properties":{"input":{"type":"object","maxProperties":32,"description":"example input values; a plain JSON object"},"output":{"type":"object","maxProperties":32,"description":"example output values; a plain JSON object"}}}},"target":{"description":"publication target fragment (external_id, visibility, limits, binding); server-controlled, never sent to the model","type":"object","additionalProperties":false,"required":["external_id","visibility","limits","binding"],"properties":{"external_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"visibility":{"enum":["private","network","public"]},"limits":{"type":"object","additionalProperties":false,"required":["timeout_ms","max_output_bytes"],"properties":{"timeout_ms":{"type":"integer","minimum":1,"maximum":30000},"max_output_bytes":{"type":"integer","minimum":1,"maximum":262144},"max_input_bytes":{"type":"integer","minimum":1,"maximum":262144}}},"binding":{"type":"object","additionalProperties":false,"required":["adapter","transport_binding_id","transport_binding_revision"],"properties":{"adapter":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"version":{"type":"integer","minimum":1,"maximum":1000}}},"transport_binding_id":{"type":"string","minLength":1,"maxLength":128},"transport_binding_revision":{"type":"integer","minimum":1,"maximum":1000}}}}}}},"capability_understanding_outcome":{"type":"object","additionalProperties":false,"required":["decision","reason_code","verification"],"properties":{"decision":{"enum":["draft","request_input","unsupported"]},"reason_code":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"draft":{"type":"object","additionalProperties":false,"required":["summary","operations","constraints","verification_requirements"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":1000},"service_type":{"type":"object","additionalProperties":false,"required":["key","version"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"version":{"type":"integer","minimum":1,"maximum":1000}}},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"input_schema":{},"output_schema":{},"input_support":{"type":"object","maxProperties":32},"constraints":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":500}},"verification_requirements":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":500}}}},"questions":{"type":"array","minItems":1,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":500}},"manifest":{"type":"object","additionalProperties":false,"required":["manifest_version","provider","capability"],"properties":{"manifest_version":{"const":1},"provider":{"type":"object","additionalProperties":false,"required":["external_id","kind","display_name"],"properties":{"external_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"kind":{"enum":["native","pseudo","agent"]},"display_name":{"type":"string","minLength":1,"maxLength":128}}},"capability":{"type":"object","additionalProperties":false,"required":["external_id","service_type","effect","operations","visibility","limits","binding"],"properties":{"external_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"service_type":{"type":"object","additionalProperties":false,"required":["key","version"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"version":{"type":"integer","minimum":1,"maximum":1000}}},"effect":{"enum":["information"]},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"visibility":{"enum":["private","network","public"]},"input_support":{"type":"object","maxProperties":32},"limits":{"type":"object","additionalProperties":false,"required":["timeout_ms","max_output_bytes"],"properties":{"timeout_ms":{"type":"integer","minimum":1,"maximum":30000},"max_output_bytes":{"type":"integer","minimum":1,"maximum":262144},"max_input_bytes":{"type":"integer","minimum":1,"maximum":262144}}},"binding":{"type":"object","additionalProperties":false,"required":["adapter","transport_binding_id","transport_binding_revision"],"properties":{"adapter":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"version":{"type":"integer","minimum":1,"maximum":1000}}},"transport_binding_id":{"type":"string","minLength":1,"maxLength":128},"transport_binding_revision":{"type":"integer","minimum":1,"maximum":1000}}}}}}},"verification":{"type":"object","additionalProperties":false,"required":["schema_validated","trial_passed"],"properties":{"schema_validated":{"const":false},"trial_passed":{"const":false}},"description":"constant: an understanding draft is never schema-validated or trial-passed"}},"allOf":[{"if":{"required":["decision"],"properties":{"decision":{"const":"draft"}}},"then":{"required":["draft"],"properties":{"questions":{"type":"null"}}}},{"if":{"required":["decision"],"properties":{"decision":{"const":"request_input"}}},"then":{"required":["questions"],"properties":{"draft":{"type":"null"},"manifest":{"type":"null"}}}},{"if":{"required":["decision"],"properties":{"decision":{"const":"unsupported"}}},"then":{"properties":{"draft":{"type":"null"},"questions":{"type":"null"},"manifest":{"type":"null"}}}}]},"understanding_record":{"type":"object","additionalProperties":false,"required":["understanding_id","kind","status","created_at"],"properties":{"understanding_id":{"type":"string","minLength":1,"maxLength":128},"kind":{"const":"capability"},"status":{"enum":["completed","failed","pending"]},"created_at":{"type":"string","format":"date-time"},"outcome":{"type":"object","description":"capability outcome; present exactly when status is completed"},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"message":{"type":"string","minLength":1,"maxLength":500}}}},"allOf":[{"if":{"required":["status"],"properties":{"status":{"const":"completed"}}},"then":{"required":["outcome"],"properties":{"outcome":{"type":"object","additionalProperties":false,"required":["decision","reason_code","verification"],"properties":{"decision":{"enum":["draft","request_input","unsupported"]},"reason_code":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"draft":{"type":"object","additionalProperties":false,"required":["summary","operations","constraints","verification_requirements"],"properties":{"summary":{"type":"string","minLength":1,"maxLength":1000},"service_type":{"type":"object","additionalProperties":false,"required":["key","version"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"version":{"type":"integer","minimum":1,"maximum":1000}}},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"input_schema":{},"output_schema":{},"input_support":{"type":"object","maxProperties":32},"constraints":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":500}},"verification_requirements":{"type":"array","maxItems":16,"items":{"type":"string","minLength":1,"maxLength":500}}}},"questions":{"type":"array","minItems":1,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":500}},"manifest":{"type":"object","additionalProperties":false,"required":["manifest_version","provider","capability"],"properties":{"manifest_version":{"const":1},"provider":{"type":"object","additionalProperties":false,"required":["external_id","kind","display_name"],"properties":{"external_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"kind":{"enum":["native","pseudo","agent"]},"display_name":{"type":"string","minLength":1,"maxLength":128}}},"capability":{"type":"object","additionalProperties":false,"required":["external_id","service_type","effect","operations","visibility","limits","binding"],"properties":{"external_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"service_type":{"type":"object","additionalProperties":false,"required":["key","version"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"version":{"type":"integer","minimum":1,"maximum":1000}}},"effect":{"enum":["information"]},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"visibility":{"enum":["private","network","public"]},"input_support":{"type":"object","maxProperties":32},"limits":{"type":"object","additionalProperties":false,"required":["timeout_ms","max_output_bytes"],"properties":{"timeout_ms":{"type":"integer","minimum":1,"maximum":30000},"max_output_bytes":{"type":"integer","minimum":1,"maximum":262144},"max_input_bytes":{"type":"integer","minimum":1,"maximum":262144}}},"binding":{"type":"object","additionalProperties":false,"required":["adapter","transport_binding_id","transport_binding_revision"],"properties":{"adapter":{"type":"object","additionalProperties":false,"required":["id","version"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"version":{"type":"integer","minimum":1,"maximum":1000}}},"transport_binding_id":{"type":"string","minLength":1,"maxLength":128},"transport_binding_revision":{"type":"integer","minimum":1,"maximum":1000}}}}}}},"verification":{"type":"object","additionalProperties":false,"required":["schema_validated","trial_passed"],"properties":{"schema_validated":{"const":false},"trial_passed":{"const":false}},"description":"constant: an understanding draft is never schema-validated or trial-passed"}},"allOf":[{"if":{"required":["decision"],"properties":{"decision":{"const":"draft"}}},"then":{"required":["draft"],"properties":{"questions":{"type":"null"}}}},{"if":{"required":["decision"],"properties":{"decision":{"const":"request_input"}}},"then":{"required":["questions"],"properties":{"draft":{"type":"null"},"manifest":{"type":"null"}}}},{"if":{"required":["decision"],"properties":{"decision":{"const":"unsupported"}}},"then":{"properties":{"draft":{"type":"null"},"questions":{"type":"null"},"manifest":{"type":"null"}}}}]},"error":{"type":"null"}}}},{"if":{"required":["status"],"properties":{"status":{"const":"failed"}}},"then":{"required":["error"],"properties":{"outcome":{"type":"null"}}}},{"if":{"required":["status"],"properties":{"status":{"const":"pending"}}},"then":{"properties":{"outcome":{"type":"null"},"error":{"type":"null"}}}}]},"engagement_open":{"type":"object","additionalProperties":false,"required":["client_engagement_id","capability_id","first_message"],"description":"open an engagement with one agent provider capability; goal_ref groups contacts of one goal (5 new providers per goal)","properties":{"client_engagement_id":{"type":"string","pattern":"^[A-Za-z0-9_.:@-]{1,128}$"},"capability_id":{"type":"string","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}$"},"capability_revision":{"type":"integer","minimum":1,"maximum":9007199254740991},"first_message":{"type":"object","additionalProperties":false,"required":["client_message_id","parts"],"description":"one caller entry; client_message_id is the idempotency identity — an exact replay returns the original receipt","properties":{"client_message_id":{"type":"string","pattern":"^[A-Za-z0-9_.:@-]{1,128}$"},"parts":{"type":"array","minItems":1,"maxItems":32,"items":{"type":"object","anyOf":[{"type":"object","additionalProperties":false,"required":["kind","text"],"properties":{"kind":{"const":"text"},"text":{"type":"string","minLength":1,"maxLength":16384}}},{"type":"object","additionalProperties":false,"required":["kind","data"],"properties":{"kind":{"const":"data"},"data":{"type":"object","maxProperties":64}}}]}}}},"goal_ref":{"type":"string","minLength":1,"maxLength":128}}},"engagement_message":{"type":"object","additionalProperties":false,"required":["client_message_id","parts"],"description":"one caller entry; client_message_id is the idempotency identity — an exact replay returns the original receipt","properties":{"client_message_id":{"type":"string","pattern":"^[A-Za-z0-9_.:@-]{1,128}$"},"parts":{"type":"array","minItems":1,"maxItems":32,"items":{"type":"object","anyOf":[{"type":"object","additionalProperties":false,"required":["kind","text"],"properties":{"kind":{"const":"text"},"text":{"type":"string","minLength":1,"maxLength":16384}}},{"type":"object","additionalProperties":false,"required":["kind","data"],"properties":{"kind":{"const":"data"},"data":{"type":"object","maxProperties":64}}}]}}}},"engagement_proposal":{"type":"object","additionalProperties":false,"required":["client_message_id","conditions"],"properties":{"client_message_id":{"type":"string","pattern":"^[A-Za-z0-9_.:@-]{1,128}$"},"conditions":{"type":"object","minProperties":1,"maxProperties":128,"description":"bounded JSON object; leaves are strings, booleans or null — JSON numbers are rejected. kind=agreement needs scope, total_amount (exact decimal string) and currency; kind=disclosure needs purpose, lifetime_hours and fields."},"kind":{"enum":["agreement","disclosure"],"description":"defaults to agreement"},"valid_until":{"type":"string","minLength":20,"maxLength":40,"description":"ISO-8601 instant, at most 30 days ahead; defaults to 72 hours after posting"}}},"engagement_proposal_answer":{"type":"object","additionalProperties":false,"required":["answer","conditions_digest"],"properties":{"answer":{"enum":["accept","reject"]},"conditions_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"bare lowercase sha256 hex of the exact stored conditions; parties only echo it"},"disclosure":{"type":"object","additionalProperties":false,"required":["fields"],"properties":{"fields":{"type":"array","minItems":1,"maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["name","value"],"properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z][A-Za-z0-9_.-]{0,63}$"},"value":{"type":"string","minLength":1,"maxLength":1024}}}},"purpose":{"type":"string","minLength":1,"maxLength":280},"lifetime_hours":{"type":"integer","minimum":1,"maximum":2160}}}}},"engagement_owner_approval":{"type":"object","additionalProperties":false,"required":["conditions_digest"],"properties":{"conditions_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"bare lowercase sha256 hex of the exact stored proposal; the owner echoes it"},"contact_id":{"type":["string","null"],"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}$","description":"One of the owner's saved business contacts, released only into the agreement"}}},"engagement_owner_reject":{"type":"object","additionalProperties":false,"required":["conditions_digest"],"properties":{"conditions_digest":{"type":"string","pattern":"^[0-9a-f]{64}$"}}},"provider_contact":{"type":"object","additionalProperties":false,"required":["kind","value","label"],"properties":{"kind":{"enum":["phone","wechat","email","contact_person","url"]},"value":{"type":"string","minLength":1,"maxLength":256},"label":{"type":"string","minLength":1,"maxLength":64}}},"provider_standing_approval":{"type":"object","additionalProperties":false,"required":["currency","max_total_amount","max_valid_days"],"properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"max_total_amount":{"type":"string","minLength":1,"maxLength":19},"max_valid_days":{"type":"integer","minimum":1,"maximum":30},"contact_id":{"type":["string","null"],"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}$"}}},"engagement_inbox_ack":{"type":"object","additionalProperties":false,"required":["pos"],"properties":{"pos":{"type":"integer","minimum":1,"maximum":9007199254740991}}},"engagement_case_open":{"type":"object","additionalProperties":false,"required":["kind","statement"],"properties":{"kind":{"enum":["report","dispute"]},"statement":{"type":"string","minLength":1,"maxLength":4096}}},"engagement_case_statement":{"type":"object","additionalProperties":false,"required":["statement"],"properties":{"statement":{"type":"string","minLength":1,"maxLength":4096}}},"engagement_case_decision":{"type":"object","additionalProperties":false,"required":["decision"],"properties":{"decision":{"enum":["no_action","recommend_end"]},"note":{"type":"string","minLength":1,"maxLength":4096},"suspend":{"enum":["initiator","provider"]}}},"engagement_delegation_settings":{"type":"object","additionalProperties":false,"required":["direct_delegation"],"properties":{"direct_delegation":{"type":"boolean"}}},"engagement_confirmation_required":{"type":"object","additionalProperties":false,"required":["proposal_id","confirm_url"],"properties":{"proposal_id":{"type":"string","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}$"},"confirm_url":{"type":"string","minLength":1,"maxLength":512,"format":"uri"}}},"owner_provider_engagement":{"type":"object","additionalProperties":false,"required":["id","purpose","provider_id","provider_display_name","capability_id","capability_revision","channel","initiator_pseudonym","initiator_label","requester","state","close_reason","open_proposal_id","agreement_ids","hold","last_seq","last_activity_at","counters"],"properties":{"id":{"type":"string","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}$"},"purpose":{"enum":["runtime"]},"provider_id":{"type":"string","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}$"},"provider_display_name":{"type":["string","null"],"maxLength":200},"conversation_title":{"type":["string","null"],"maxLength":160},"capability_id":{"type":"string","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}$"},"capability_revision":{"type":"integer","minimum":1},"channel":{"enum":["personal","mcp","a2a",null]},"initiator_pseudonym":{"type":"string","minLength":1,"maxLength":128},"initiator_label":{"type":"string","minLength":1,"maxLength":128},"requester":{"type":"object","additionalProperties":false,"required":["public_name","public_id"],"properties":{"public_name":{"type":"string","minLength":1,"maxLength":120},"public_id":{"type":["string","null"],"pattern":"^pub_[a-z2-7]{10}$"}}},"state":{"enum":["introduced","active","paused","closed","expired"]},"close_reason":{"enum":["declined","initiator_closed","provider_closed","blocked","idle","revoked","dispute_terminated","not_allowed",null]},"open_proposal_id":{"type":["string","null"],"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}$"},"agreement_ids":{"type":"array","maxItems":64,"items":{"type":"string","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}$"}},"hold":{"enum":["none","dispute","report"]},"last_seq":{"type":"integer","minimum":0},"last_activity_at":{"type":"string","format":"date-time"},"counters":{"type":"object","additionalProperties":false,"required":["initiator","provider"],"properties":{"initiator":{"type":"object","additionalProperties":false,"required":["messages","bytes"],"properties":{"messages":{"type":"integer","minimum":0},"bytes":{"type":"integer","minimum":0}}},"provider":{"type":"object","additionalProperties":false,"required":["messages","bytes"],"properties":{"messages":{"type":"integer","minimum":0},"bytes":{"type":"integer","minimum":0}}}}}}},"owner_provider_engagement_page":{"type":"object","additionalProperties":false,"required":["items","next_cursor"],"properties":{"items":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["id","purpose","provider_id","provider_display_name","capability_id","capability_revision","channel","initiator_pseudonym","initiator_label","requester","state","close_reason","open_proposal_id","agreement_ids","hold","last_seq","last_activity_at","counters"],"properties":{"id":{"type":"string","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}$"},"purpose":{"enum":["runtime"]},"provider_id":{"type":"string","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}$"},"provider_display_name":{"type":["string","null"],"maxLength":200},"conversation_title":{"type":["string","null"],"maxLength":160},"capability_id":{"type":"string","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}$"},"capability_revision":{"type":"integer","minimum":1},"channel":{"enum":["personal","mcp","a2a",null]},"initiator_pseudonym":{"type":"string","minLength":1,"maxLength":128},"initiator_label":{"type":"string","minLength":1,"maxLength":128},"requester":{"type":"object","additionalProperties":false,"required":["public_name","public_id"],"properties":{"public_name":{"type":"string","minLength":1,"maxLength":120},"public_id":{"type":["string","null"],"pattern":"^pub_[a-z2-7]{10}$"}}},"state":{"enum":["introduced","active","paused","closed","expired"]},"close_reason":{"enum":["declined","initiator_closed","provider_closed","blocked","idle","revoked","dispute_terminated","not_allowed",null]},"open_proposal_id":{"type":["string","null"],"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}$"},"agreement_ids":{"type":"array","maxItems":64,"items":{"type":"string","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}$"}},"hold":{"enum":["none","dispute","report"]},"last_seq":{"type":"integer","minimum":0},"last_activity_at":{"type":"string","format":"date-time"},"counters":{"type":"object","additionalProperties":false,"required":["initiator","provider"],"properties":{"initiator":{"type":"object","additionalProperties":false,"required":["messages","bytes"],"properties":{"messages":{"type":"integer","minimum":0},"bytes":{"type":"integer","minimum":0}}},"provider":{"type":"object","additionalProperties":false,"required":["messages","bytes"],"properties":{"messages":{"type":"integer","minimum":0},"bytes":{"type":"integer","minimum":0}}}}}}}},"next_cursor":{"type":["string","null"],"maxLength":256}}},"owner_provider_engagement_entry_page":{"type":"object","additionalProperties":false,"required":["items","next_seq","has_more"],"properties":{"items":{"type":"array","maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["engagement_id","seq","kind","side","received_at","size_bytes","delivery"],"properties":{"engagement_id":{"type":"string","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}$"},"seq":{"type":"integer","minimum":1},"kind":{"enum":["message","proposal","proposal_answer","system"]},"side":{"enum":["initiator","provider","system"]},"received_at":{"type":"string","format":"date-time"},"size_bytes":{"type":"integer","minimum":0},"delivery":{"enum":["held","queued","released","delivered","undelivered","canceled","unknown"]},"supersedes_seq":{"type":"integer","minimum":1},"body_expired":{"enum":[true]},"error":{"enum":["body_expired"]},"content":{"type":["object","null"]}}}},"next_seq":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}},"engagement_a2a_open":{"type":"object","additionalProperties":false,"required":["capability_id","client_engagement_id"],"description":"engagement extension payload on the opening SendMessage; follow-ups on the task are plain A2A","properties":{"capability_id":{"type":"string","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}$"},"client_engagement_id":{"type":"string","pattern":"^[A-Za-z0-9_.:@-]{1,128}$"},"capability_revision":{"type":"integer","minimum":1,"maximum":9007199254740991}}},"engagement_a2a_outbox_request":{"type":"object","additionalProperties":false,"required":["since"],"properties":{"since":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"read items with pos > since; 0 reads from the beginning"}}},"engagement_a2a_outbox_response":{"type":"object","additionalProperties":false,"required":["items","next"],"description":"ordered provider outbox page; nonempty pages set next to the last item's pos, empty pages echo the request since","properties":{"items":{"type":"array","maxItems":256,"items":{"type":"object","additionalProperties":false,"required":["pos","message"],"properties":{"pos":{"type":"integer","minimum":1,"maximum":9007199254740991},"message":{"type":"object","maxProperties":32}}}},"next":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"engagement_a2a_proposal_part":{"type":"object","additionalProperties":false,"minProperties":1,"description":"provider proposal part on engagement reads: either {conditions} (a proposal, provider-authenticated) or {proposal_id, answer, conditions_digest} (an answer)","properties":{"conditions":{"type":"object","minProperties":1,"maxProperties":128},"proposal_id":{"type":"string","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}$"},"answer":{"enum":["accept","reject"]},"conditions_digest":{"type":"string","pattern":"^[0-9a-f]{64}$"}}},"account_key_created":{"type":"object","additionalProperties":false,"required":["key","secret"],"properties":{"key":{"type":"object","additionalProperties":false,"required":["id","name","public_id","is_default","scopes","engage_visibility","created_at","last_used_at","revoked_at"],"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"\\S"},"public_id":{"type":"string","pattern":"^[0-9a-f]{16}$"},"is_default":{"type":"boolean"},"scopes":{"type":"array","minItems":1,"items":{"type":"string","maxLength":64}},"engage_visibility":{"enum":["own","all"]},"created_at":{"type":"string","format":"date-time"},"last_used_at":{"type":["string","null"],"format":"date-time"},"revoked_at":{"type":["string","null"],"format":"date-time"}}},"secret":{"type":"string","pattern":"^afk_[0-9a-f]{16}_[A-Za-z0-9_-]{43}$","maxLength":64}}},"account_key_revealed":{"type":"object","additionalProperties":false,"required":["secret"],"properties":{"secret":{"type":"string","pattern":"^afk_[0-9a-f]{16}_[A-Za-z0-9_-]{43}$","maxLength":64}}},"capability_check":{"type":"object","additionalProperties":false,"properties":{"sample_input":{"type":"object","description":"Input values validated against the pinned service type's query or exchange schema."},"operation":{"enum":["query","exchange"],"description":"Defaults to query when supported, otherwise exchange."},"input_kind":{"enum":["query","clarification_request","clarification_answer","proposal","proposal_response","evidence_update"]}}},"agent_endpoint_challenge":{"type":"object","additionalProperties":false,"required":["card_url"],"properties":{"card_url":{"type":"string","maxLength":2000}}},"agent_credential_write":{"type":"object","additionalProperties":false,"required":["credential"],"properties":{"credential":{"type":"string","minLength":1,"maxLength":4096,"writeOnly":true}}},"notification_subscription_input":{"type":"object","additionalProperties":false,"required":["client_subscription_id","mode","url","secret"],"properties":{"client_subscription_id":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,128}$","description":"Stable identifier; posting the same preferences again renews the lifetime."},"mode":{"enum":["webhook","mcp_events"],"description":"webhook sends Authorization: Bearer <secret>; mcp_events signs with a Standard Webhooks whsec_ secret and verifies the destination with a signed challenge. polling is not offered: long-poll GET /v3/network/inbox?from=bookmark&wait_ms=25000."},"url":{"type":"string","maxLength":2048,"description":"Public HTTPS destination."},"secret":{"type":"string","minLength":16,"maxLength":1024,"writeOnly":true},"engagement_id":{"type":"string","format":"uuid","description":"Only wake for this engagement; it must be visible to the calling grant."},"expires_in_seconds":{"type":"integer","minimum":300,"maximum":604800,"default":86400}}},"notification_subscription":{"type":"object","required":["id","client_subscription_id","mode","status","event","expires_at","verified"],"properties":{"id":{"type":"string","format":"uuid"},"client_subscription_id":{"type":"string"},"mode":{"type":"string"},"status":{"type":"string"},"event":{"const":"engagement.updated"},"engagement_id":{"type":["string","null"],"format":"uuid"},"expires_at":{"type":"string","format":"date-time"},"verified":{"type":"boolean"},"verification":{"enum":["challenge","delivery_only","not_applicable"]},"destination_origin":{"type":["string","null"],"description":"Origin only; the path, query and secret are never returned."},"next_pos":{"type":"integer"}}},"notification_subscription_list":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/notification_subscription"}}}},"notification_subscription_revoked":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string","format":"uuid"},"status":{"const":"revoked"}}},"device_decision":{"type":"object","additionalProperties":false,"required":["user_code","decision","csrf_token"],"properties":{"user_code":{"type":"string","maxLength":64,"description":"The code the Agent showed, for example WDJB-MJHT; case and hyphen are ignored."},"decision":{"enum":["approve","deny"]},"csrf_token":{"type":"string","minLength":16,"maxLength":128,"description":"Single-use token returned by the latest GET for this code and session."}}},"device_authorization_view":{"type":"object","required":["client_name","client_id","client_registration","scope","resource","expires_in","csrf_token"],"properties":{"client_name":{"type":"string","description":"Display name of the client; for dcr and cimd clients an unverified claim."},"client_id":{"type":"string"},"client_registration":{"enum":["preregistered","dcr","cimd"]},"scope":{"type":"array","items":{"type":"string"}},"resource":{"type":"string"},"expires_in":{"type":"integer"},"csrf_token":{"type":"string"}}},"device_decision_result":{"type":"object","required":["status","client_name"],"properties":{"status":{"enum":["approved","denied"]},"client_name":{"type":"string"}}},"empty_body":{"type":"object","additionalProperties":false},"error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","request_id"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"details":{},"next":{"type":"array","description":"Machine-readable next steps on a level refusal (account_required, verification_required, trial_converted, a trial limit): each has an action and, as applicable, an MCP tool, an HTTP method and path, a page url for the person, and a hint.","items":{"type":"object","required":["action"],"properties":{"action":{"type":"string"},"tool":{"type":"string"},"method":{"type":"string"},"path":{"type":"string"},"url":{"type":"string"},"hint":{"type":"string"}}}}}}}},"service_type_registration":{"type":"object","additionalProperties":false,"required":["key","operations","input_schema","requirements_schema","output_schema","semantics","comparisons","visibility"],"properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.-]{0,62}[a-z0-9]\\.[a-z0-9][a-z0-9_.-]{0,63}$"},"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"input_schema":{},"requirements_schema":{},"output_schema":{},"exchange_schema":{},"semantics":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"required":["path","kind"],"properties":{"path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"kind":{"enum":["text","number","boolean","enum","datetime","url","set"]},"label":{"type":"string","minLength":1,"maxLength":128},"unit":{"type":"string","minLength":1,"maxLength":32}}}},"comparisons":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"required":["id","operator","request_path","offer_path"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"operator":{"enum":["covers","at_least","at_most","equals","is_true","includes"]},"request_path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"offer_path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"unit":{"type":"string","minLength":1,"maxLength":32},"when":{"type":"object","maxProperties":16}}}},"projection":{"type":"object","additionalProperties":false,"required":["fields"],"properties":{"fields":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":128}},"order":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["field","direction"],"properties":{"field":{"type":"string","minLength":1,"maxLength":128},"direction":{"enum":["asc","desc"]}}}}}},"visibility":{"enum":["public","private"]}}},"service_type_version":{"type":"object","additionalProperties":false,"required":["operations","input_schema","requirements_schema","output_schema","semantics","comparisons"],"properties":{"operations":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"enum":["query","exchange"]}},"input_schema":{},"requirements_schema":{},"output_schema":{},"exchange_schema":{},"semantics":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"required":["path","kind"],"properties":{"path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"kind":{"enum":["text","number","boolean","enum","datetime","url","set"]},"label":{"type":"string","minLength":1,"maxLength":128},"unit":{"type":"string","minLength":1,"maxLength":32}}}},"comparisons":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"required":["id","operator","request_path","offer_path"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"operator":{"enum":["covers","at_least","at_most","equals","is_true","includes"]},"request_path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"offer_path":{"type":"string","pattern":"^/[A-Za-z0-9_*./\\[\\]-]{0,128}$"},"unit":{"type":"string","minLength":1,"maxLength":32},"when":{"type":"object","maxProperties":16}}}},"projection":{"type":"object","additionalProperties":false,"required":["fields"],"properties":{"fields":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":128}},"order":{"type":"array","maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["field","direction"],"properties":{"field":{"type":"string","minLength":1,"maxLength":128},"direction":{"enum":["asc","desc"]}}}}}}}}}}}