{"openapi":"3.1.0","info":{"title":"Swarm Universal Connection API","version":"1","description":"Generated from Swarm's canonical API. Connect once, reuse approved Space access, and manage connections in Swarm. A connection is not a running agent."},"servers":[{"url":"https://api.swarm.services"}],"security":[{"BearerAuth":[]}],"paths":{"/v1/spaces":{"get":{"summary":"List spaces","description":"Permission-filtered Space discovery. Follow X-Next-Cursor with cursor to read further pages; a page is not the entire catalog.","operationId":"listSpaces","parameters":[{"name":"entity_id","in":"query","required":false,"description":"Restrict authorized Spaces to this Entity before pagination. An unavailable Entity returns an empty list.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Spaces visible to the caller","headers":{"X-Next-Cursor":{"schema":{"type":"string"},"description":"Opaque next-page cursor; absent on the last page"},"X-Order":{"schema":{"type":"string","enum":["asc","desc"]}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Space"}}}}}}},"post":{"summary":"Create space","description":"Universal connections require explicit private Space creation consent from a human with current Entity creation authority. The resulting Space belongs to that human and grants the connection read/work access, with normal quotas and no automatically connected runtime.","operationId":"createSpace","parameters":[{"$ref":"#/components/parameters/IdempotencyKeyHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSpaceRequest"}}}},"responses":{"201":{"description":"Space created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Space"}}}}}}},"/v1/spaces/{spaceId}":{"get":{"summary":"Get space","operationId":"getSpace","parameters":[{"name":"spaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Space","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Space"}}}}}}},"/v1/spaces/{spaceId}/decision-graph":{"get":{"summary":"Get the derived space decision graph","operationId":"getSpaceDecisionGraph","parameters":[{"name":"spaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Derived memory and projection graph","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpaceDecisionGraph"}}}}}}},"/v1/spaces/{spaceId}/checkpoints":{"post":{"summary":"Publish one reviewed durable checkpoint","operationId":"publishAgentCheckpoint","parameters":[{"name":"spaceId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/IdempotencyKeyHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCheckpointPublishRequest"}}}},"responses":{"200":{"description":"Exact idempotent replay of the checkpoint publication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCheckpointPublishResult"}}}},"201":{"description":"Newly published checkpoint Artifact and provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCheckpointPublishResult"}}}}}}},"/v1/approval-requests":{"get":{"summary":"List approval requests","operationId":"listApprovalRequests","parameters":[{"name":"space_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"resource_type","in":"query","required":false,"schema":{"type":"string"}},{"name":"resource_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ApprovalRequestStatus"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"Approval requests visible to the caller","headers":{"X-Next-Cursor":{"schema":{"type":"string"}},"X-Order":{"schema":{"type":"string","enum":["asc","desc"]}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalRequest"}}}}}}}},"/v1/approval-requests/{requestId}":{"get":{"summary":"Get approval request","operationId":"getApprovalRequest","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Approval request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequest"}}}}}}},"/v1/runs":{"get":{"summary":"List runs","operationId":"listRuns","parameters":[{"name":"space_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"task_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"automation_profile_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["blocked","queued","leased","running","succeeded","failed","canceled"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"Runs visible to the caller","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Run"}}}}}}}},"/v1/runs/{runId}":{"get":{"summary":"Get run","operationId":"getRun","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}}}}},"/v1/artifacts":{"get":{"summary":"List artifacts","operationId":"listArtifacts","parameters":[{"name":"space_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"run_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"repository_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"Artifacts visible to the caller","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Artifact"}}}}}}},"post":{"summary":"Create artifact","operationId":"createArtifact","parameters":[{"$ref":"#/components/parameters/IdempotencyKeyHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateArtifactRequest"}}}},"responses":{"201":{"description":"Artifact created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Artifact"}}}}}}},"/v1/spaces/{spaceId}/conversation":{"get":{"tags":["Conversation"],"summary":"Get the primary Space conversation thread","operationId":"getSpaceConversationThread","parameters":[{"name":"spaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Primary Space conversation thread","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationThread"}}}}}}},"/v1/spaces/{spaceId}/conversation/updates":{"get":{"tags":["Conversation"],"summary":"Get an authorized Space conversation revision hint","operationId":"getSpaceConversationUpdates","parameters":[{"$ref":"#/components/parameters/SpaceIdPath"},{"name":"after_revision","in":"query","required":false,"schema":{"type":"integer","minimum":0}},{"name":"wait_ms","in":"query","required":false,"description":"Bounded wait for a newer canonical revision","schema":{"type":"integer","minimum":0,"maximum":15000}}],"responses":{"200":{"description":"Revision and cursor hint for canonical conversation view reconciliation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperienceConversationRevisionHint"}}}}}}},"/v1/spaces/{spaceId}/conversation/entries":{"post":{"tags":["Conversation"],"summary":"Create an authorized conversation entry","operationId":"createConversationEntry","parameters":[{"$ref":"#/components/parameters/IdempotencyKeyHeader"},{"name":"spaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"anchor_entry_id","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationCreateEntryRequest"}}}},"responses":{"201":{"description":"Conversation entry created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationEntry"}}}}}}},"/v1/spaces/{spaceId}/agent-participants":{"get":{"tags":["Conversation"],"summary":"List Space agent participants","operationId":"listSpaceAgentParticipants","parameters":[{"name":"spaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Space agent participants","content":{"application/json":{"schema":{"type":"object","required":["participants"],"properties":{"participants":{"type":"array","items":{"$ref":"#/components/schemas/ResourcePresentationProfile"}}}}}}}}}},"/v1/spaces/{spaceId}/agent-requests":{"post":{"tags":["Conversation"],"summary":"Ask an available Space agent to start work from a human request","operationId":"createSpaceAgentRequest","parameters":[{"$ref":"#/components/parameters/IdempotencyKeyHeader"},{"name":"spaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"anchor_entry_id","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpaceAgentRequestCreateRequest"}}}},"responses":{"202":{"description":"Agent request accepted and run queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpaceAgentRequestCreateResponse"}}}}}}},"/v1/artifacts/{artifactId}":{"get":{"summary":"Get artifact","operationId":"getArtifact","parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Artifact metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Artifact"}}}}}}},"/v1/artifacts/{artifactId}/sources":{"get":{"summary":"Read accessible cross-Space source references","operationId":"getArtifactSources","description":"Only currently readable ordinary source Artifacts are returned. Hidden sources have no placeholder or count. A reference does not grant access to its source.","parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Source references visible to this reader","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","maxItems":32,"items":{"$ref":"#/components/schemas/ArtifactSource"}}}}}}}}}},"/v1/artifacts/{artifactId}/content":{"get":{"summary":"Get artifact content","operationId":"getArtifactContent","parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Artifact content","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactContent"}}}},"410":{"description":"Artifact metadata exists, but its retained content is unavailable"}}}},"/v1/evaluations":{"get":{"summary":"List evaluations","operationId":"listEvaluations","parameters":[{"name":"space_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"run_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"artifact_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"evaluator_agent_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"outcome","in":"query","required":false,"schema":{"type":"string","enum":["pass","fail","needs_review"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"Evaluations visible to the caller","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Evaluation"}}}}}}}},"/v1/evaluations/{evaluationId}":{"get":{"summary":"Get evaluation","operationId":"getEvaluation","parameters":[{"name":"evaluationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Evaluation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evaluation"}}}}}}},"/v1/universal-connections/{connectionId}/renew":{"post":{"summary":"Keep an approved Universal connection usable without repeating setup","operationId":"renewUniversalConnection","security":[],"description":"Authenticate using the private rotating refresh_token, not a human session or access token. Renew shortly before access expiry, or after expiry while refresh_expires_at remains in the future. Consent does not expand. Serialize renewal per connection and persist the same Idempotency-Key before sending. If the response is interrupted, retry the same proof and key within ten minutes to recover the exact result; atomically replace both stored tokens after success. A spent previous proof used with a different key or outside that retry window revokes the current credential. Revocation, replacement, inactive issuer or expired renewal requires explicit reconnection, not a retry loop. Successful renewal extends access by 30 days and renewal inactivity by 90 days. No Space enumeration occurs.","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","maxLength":128}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["refresh_token"],"properties":{"refresh_token":{"type":"string","pattern":"^swur_[A-Za-z0-9_-]{43}$","writeOnly":true}}}}}},"responses":{"200":{"description":"New private access and renewal tokens; persist together before resuming work","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenewedUniversalConnection"}}}},"400":{"description":"Invalid body or invalid_grant. Stop automatic renewal on invalid_grant and ask the human to reconnect."},"413":{"description":"Request body exceeds 8192 bytes"},"429":{"description":"Too many requests; respect Retry-After"}}}},"/v1/universal-connection-requests":{"post":{"summary":"Request human consent for an HTTPS app or agent","operationId":"startUniversalConnectionRequest","security":[],"description":"Starts a ten-minute Swarm-specific handshake, not an OAuth replacement. No authority is granted. Keep device_code private in the requesting runtime; show only verification_uri and user_code to the human. App names are self-reported. No callback URL is accepted.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","access_profile_key"],"properties":{"name":{"type":"string","minLength":1,"maxLength":160,"description":"Display name, up to 160 UTF-8 bytes"},"access_profile_key":{"type":"string","enum":["space.viewer","space.operator"]}}}}}},"responses":{"201":{"description":"Private exchange proof and public review link","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartedUniversalConnectionRequest"}}}},"400":{"description":"Invalid name, profile or body"},"413":{"description":"Request body exceeds 8192 bytes"},"429":{"description":"Too many requests; respect Retry-After"},"503":{"description":"Consent origin is not configured"}}}},"/v1/universal-connection-requests/{requestId}/exchange":{"post":{"summary":"Collect an approved Universal connection","operationId":"exchangeUniversalConnectionRequest","security":[],"description":"Poll with the private device_code, honoring interval and Retry-After. Approval does not issue a credential until this exchange. Current issuer authority is checked again. Concurrent identical requests create only one connection. A lost success response can be recovered with the same private proof before the original ten-minute request expires, provided consent and credentials remain unchanged. Recovery stops after replacement, renewal, revocation or an access edit. Stop collecting after storing a successful result; use renewal for ongoing access. Never put device_code or credentials into prompts, URLs or logs.","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["device_code"],"properties":{"device_code":{"type":"string","minLength":43,"maxLength":43,"writeOnly":true}}}}}},"responses":{"200":{"description":"Initial private connection details for exactly the approved consent","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssuedUniversalConnection"}}}},"400":{"description":"Invalid JSON or a protocol state; only authorization_pending and slow_down permit polling to continue","headers":{"Retry-After":{"schema":{"type":"integer","minimum":5,"maximum":60}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"string","enum":["authorization_pending","slow_down","access_denied","expired_token","invalid_grant","invalid json"]},"interval":{"type":"integer","minimum":0,"maximum":60}}}}}},"413":{"description":"Request body exceeds 8192 bytes"},"429":{"description":"Too many requests; respect Retry-After"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"opaque"}},"schemas":{"Space":{"type":"object","required":["id","entity_id","key","name","created_at","updated_at"],"properties":{"id":{"type":"string"},"entity_id":{"type":"string"},"key":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"default_prompt_capture_mode":{"type":"string","enum":["off","compiled_only","raw_and_compiled"]},"default_prompt_visibility_mode":{"type":"string","enum":["hidden","space","public_compiled_only"]},"allow_raw_prompt_capture":{"type":"boolean"},"allow_space_prompt_visibility":{"type":"boolean"},"allow_public_compiled_prompt_visibility":{"type":"boolean"},"allow_public_raw_prompt_visibility":{"type":"boolean"},"memory_policy":{"type":"string","enum":["off","suggest","auto_promote_safe"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"CreateSpaceRequest":{"type":"object","required":["entity_id","key","name"],"properties":{"entity_id":{"type":"string"},"key":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}}},"SpaceDecisionGraph":{"type":"object","required":["space_id","generated_at","memory_nodes","memory_edges","projections","trust_boundary"],"properties":{"space_id":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"memory_nodes":{"type":"array","items":{"$ref":"#/components/schemas/SpaceMemoryNode"}},"memory_edges":{"type":"array","items":{"$ref":"#/components/schemas/SpaceMemoryEdge"}},"projections":{"type":"array","items":{"$ref":"#/components/schemas/SpaceProjection"}},"trust_boundary":{"type":"string"}}},"SpaceMemoryNode":{"type":"object","required":["id","space_id","source_resource_type","source_resource_id","family","title","summary","status","created_at"],"properties":{"id":{"type":"string"},"space_id":{"type":"string"},"source_resource_type":{"type":"string"},"source_resource_id":{"type":"string"},"family":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"status":{"type":"string","enum":["candidate","validated","promoted","superseded","rejected"]},"created_at":{"type":"string","format":"date-time"}}},"SpaceMemoryEdge":{"type":"object","required":["id","space_id","source_id","target_id","kind","created_at"],"properties":{"id":{"type":"string"},"space_id":{"type":"string"},"source_id":{"type":"string"},"target_id":{"type":"string"},"kind":{"type":"string"},"created_at":{"type":"string","format":"date-time"}}},"SpaceProjection":{"type":"object","required":["projection_id","space_id","family","summary","source_artifacts","status","version","validation_score","trust_boundary","updated_at"],"properties":{"projection_id":{"type":"string"},"space_id":{"type":"string"},"family":{"type":"string"},"summary":{"type":"string"},"source_artifacts":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["candidate","validated","promoted","superseded","rejected"]},"version":{"type":"integer"},"validation_score":{"type":"number","format":"double","minimum":0,"maximum":1},"trust_boundary":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}},"AgentCheckpointPublishRequest":{"type":"object","additionalProperties":false,"required":["checkpoint_kind_key","title"],"oneOf":[{"required":["body_text"],"not":{"anyOf":[{"required":["source_resource_ref"]},{"required":["observed_source_revision"]},{"required":["observed_compiled_content_hash"]},{"required":["observed_descriptor_snapshot_hash"]}]}},{"required":["source_resource_ref","observed_source_revision","observed_compiled_content_hash","observed_descriptor_snapshot_hash"],"not":{"anyOf":[{"required":["body_text"]},{"required":["sources"]}]}}],"properties":{"agent_id":{"type":"string","maxLength":128},"checkpoint_kind_key":{"type":"string","pattern":"^checkpoint[.]kind[.][a-z][a-z0-9_.-]*$","maxLength":160},"title":{"type":"string","minLength":1,"maxLength":512},"body_text":{"type":"string","minLength":1,"maxLength":65536},"media_type":{"type":"string","maxLength":128,"default":"text/markdown"},"adapter_key":{"type":"string","pattern":"^[a-z][a-z0-9_.-]*$","maxLength":128},"adapter_version":{"type":"string","maxLength":64},"sources":{"type":"array","maxItems":32,"items":{"$ref":"#/components/schemas/AgentCheckpointSource"}},"source_resource_ref":{"type":"string","minLength":3,"maxLength":512},"selected_resource_refs":{"type":"array","maxItems":31,"uniqueItems":true,"items":{"type":"string","minLength":3,"maxLength":512}},"objective":{"type":"string","maxLength":4096},"observed_source_revision":{"type":"integer","minimum":0},"observed_compiled_content_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"observed_descriptor_snapshot_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"output_format_key":{"type":"string","pattern":"^[a-z][a-z0-9_.-]*$","maxLength":160},"token_budget":{"type":"integer","minimum":1,"maximum":32000}}},"AgentCheckpointSource":{"type":"object","additionalProperties":false,"required":["resource_type_key","resource_id"],"properties":{"space_id":{"type":"string","maxLength":256,"description":"Omit for the destination Space. A different Space requires an ordinary Artifact source and its exact content_hash; current access and both sharing policies are checked."},"resource_type_key":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$","maxLength":64},"resource_id":{"type":"string","minLength":1,"maxLength":128},"resource_revision":{"type":"string","maxLength":128},"content_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"AgentCheckpointPublishResult":{"type":"object","additionalProperties":false,"required":["artifact","trace","links","replayed"],"properties":{"artifact":{"$ref":"#/components/schemas/Artifact"},"trace":{"$ref":"#/components/schemas/AgentActionTrace"},"links":{"type":"array","maxItems":33,"items":{"$ref":"#/components/schemas/AgentActionTraceLink"}},"replayed":{"type":"boolean"},"cross_space_sources":{"type":"array","maxItems":32,"items":{"$ref":"#/components/schemas/ArtifactSource"}}}},"Artifact":{"type":"object","required":["id","space_id","kind","media_type","moderation_status","sha256","size_bytes","created_at"],"properties":{"id":{"type":"string"},"space_id":{"type":"string"},"run_id":{"type":"string"},"repository_id":{"type":"string"},"kind":{"type":"string"},"media_type":{"type":"string"},"moderation_status":{"type":"string","enum":["active","flagged","quarantined","removed"]},"sha256":{"type":"string"},"size_bytes":{"type":"integer","minimum":0},"created_at":{"type":"string","format":"date-time"}}},"AgentActionTrace":{"type":"object","additionalProperties":false,"required":["id","trace_schema_version","entity_id","space_id","actor_identity_id","trace_root_id","sequence","action_descriptor_key","status","evidence_class_key","capture_profile_key","coverage_key","idempotency_key","event_hash","trace_hash","started_at","created_at","updated_at"],"properties":{"id":{"type":"string"},"trace_schema_version":{"type":"string","const":"v081.agent-action-trace.v1"},"entity_id":{"type":"string"},"space_id":{"type":"string"},"run_group_id":{"type":"string","maxLength":128},"run_id":{"type":"string","maxLength":128},"run_attempt":{"type":"integer","minimum":0},"execution_id":{"type":"string","maxLength":128},"actor_identity_id":{"type":"string"},"agent_id":{"type":"string","maxLength":128},"core_id":{"type":"string","maxLength":128},"command_id":{"type":"string","maxLength":128},"model_call_id":{"type":"string","maxLength":128},"connection_action_receipt_id":{"type":"string","maxLength":128},"trace_root_id":{"type":"string","minLength":1,"maxLength":128},"parent_trace_id":{"type":"string","maxLength":128},"sequence":{"type":"integer","format":"int64","minimum":0},"action_descriptor_key":{"type":"string","pattern":"^trace[.]action[.][a-z][a-z0-9_.-]*$","maxLength":160},"operation_key":{"type":"string","maxLength":128},"status":{"$ref":"#/components/schemas/AgentActionStatus"},"evidence_class_key":{"type":"string","pattern":"^trace[.]evidence[.][a-z][a-z0-9_.-]*$","maxLength":160},"capture_profile_key":{"type":"string","pattern":"^trace[.]capture[.][a-z][a-z0-9_.-]*$","maxLength":160},"coverage_key":{"type":"string","pattern":"^trace[.]coverage[.][a-z][a-z0-9_.-]*$","maxLength":160},"adapter_key":{"type":"string","maxLength":128},"adapter_version":{"type":"string","maxLength":64},"tool_descriptor_key":{"type":"string","maxLength":160},"tool_descriptor_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"input_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"output_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"input_payload_ref":{"type":"string","maxLength":128},"output_payload_ref":{"type":"string","maxLength":128},"safe_input_summary":{"type":"string","maxLength":1024},"safe_output_summary":{"type":"string","maxLength":1024},"safe_error_key":{"type":"string","maxLength":128},"idempotency_key":{"type":"string","minLength":1,"maxLength":256},"event_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"trace_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"AgentActionStatus":{"type":"string","enum":["started","succeeded","failed","canceled","blocked","skipped"]},"AgentActionTraceLink":{"type":"object","additionalProperties":false,"required":["id","entity_id","space_id","trace_id","relation_descriptor_key","resource_type_key","resource_id","ordinal","link_hash","created_at"],"properties":{"id":{"type":"string"},"entity_id":{"type":"string"},"space_id":{"type":"string"},"trace_id":{"type":"string"},"relation_descriptor_key":{"type":"string","pattern":"^trace[.]relation[.][a-z][a-z0-9_.-]*$","maxLength":160},"resource_type_key":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$","maxLength":64},"resource_id":{"type":"string","minLength":1,"maxLength":128},"resource_revision":{"type":"string","maxLength":128},"evidence_payload_ref":{"type":"string","maxLength":128},"ordinal":{"type":"integer","minimum":0,"maximum":63},"content_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"sensitivity_tags":{"type":"array","maxItems":16,"items":{"type":"string","maxLength":160}},"link_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"created_at":{"type":"string","format":"date-time"}}},"ArtifactSource":{"type":"object","additionalProperties":false,"required":["artifact_id","source_space_id","source_artifact_id","content_hash","created_at"],"properties":{"artifact_id":{"type":"string"},"source_space_id":{"type":"string"},"source_artifact_id":{"type":"string"},"content_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"created_at":{"type":"string","format":"date-time"}}},"ApprovalRequestStatus":{"type":"string","enum":["pending","approved","rejected"]},"ApprovalRequest":{"type":"object","required":["id","space_id","resource_type","action","requested_by","status","summary","created_at","updated_at"],"properties":{"id":{"type":"string"},"space_id":{"type":"string"},"resource_type":{"type":"string"},"resource_id":{"type":"string"},"action":{"type":"string"},"requested_by":{"type":"string"},"status":{"$ref":"#/components/schemas/ApprovalRequestStatus"},"summary":{"type":"string"},"resolution_note":{"type":"string"},"resolved_by":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"resolved_at":{"type":"string","format":"date-time"}}},"Run":{"type":"object","required":["id","entity_id","space_id","run_group_id","root_run_id","run_role_key","run_depth","status","attempt","execution_policy","run_requirements","created_at","updated_at"],"properties":{"id":{"type":"string"},"entity_id":{"type":"string"},"space_id":{"type":"string"},"run_group_id":{"type":"string"},"root_run_id":{"type":"string"},"run_role_key":{"type":"string","enum":["main","subrun"]},"spawned_by_run_id":{"type":"string"},"run_depth":{"type":"integer","minimum":0},"spawn_reason_key":{"type":"string"},"core_id":{"type":"string"},"facet_instance_id":{"type":"string"},"task_id":{"type":"string"},"status":{"type":"string","enum":["blocked","queued","leased","running","succeeded","failed","canceled"]},"run_lease_id":{"type":"string"},"attempt":{"type":"integer","minimum":1},"execution_policy_id":{"type":"string"},"model_route_policy_id":{"type":"string"},"execution_policy":{"$ref":"#/components/schemas/ExecutionPolicySpec"},"run_requirements":{"$ref":"#/components/schemas/RunRequirementsSpec"},"scoring_contract":{"$ref":"#/components/schemas/ScoringContract"},"scoring_contract_hash":{"type":"string"},"prompt_visibility_mode":{"type":"string","enum":["hidden","space","public_compiled_only","public_raw_and_compiled"]},"automation_profile_id":{"type":"string"},"eligible_agent_count":{"type":"integer","minimum":0},"eligible_runtime_count":{"type":"integer","minimum":0},"eligible_runtimes_preview":{"type":"array","items":{"$ref":"#/components/schemas/ConnectedRuntimePreview"}},"queued_reason":{"$ref":"#/components/schemas/RunQueuedReason"},"run_context_ref_count":{"type":"integer","minimum":0},"run_context_preview":{"type":"array","items":{"$ref":"#/components/schemas/RunContextPreviewItem"}},"run_context_preview_truncated":{"type":"boolean"},"latest_handoff_artifact":{"$ref":"#/components/schemas/RunArtifactPreview"},"latest_context_summary":{"$ref":"#/components/schemas/RunContextSummary"},"latest_handoff_summary":{"$ref":"#/components/schemas/RunHandoffSummary"},"automation_profile_summary":{"$ref":"#/components/schemas/RunAutomationProfileSummary"},"prompt_capture_summary":{"$ref":"#/components/schemas/RunPromptCaptureSummary"},"follow_up_summary":{"$ref":"#/components/schemas/RunFollowUpSummary"},"scheduler_policy_id":{"type":"string"},"trigger_resource_type":{"type":"string","maxLength":96},"trigger_resource_id":{"type":"string"},"source_run_id":{"type":"string"},"stop_requested_at":{"type":"string","format":"date-time"},"stop_reason":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"finished_at":{"type":"string","format":"date-time"}}},"ExecutionPolicySpec":{"type":"object","required":["max_runtime_seconds","max_tool_calls","max_external_requests","allow_network","allow_shell"],"properties":{"max_runtime_seconds":{"type":"integer","minimum":1},"max_tool_calls":{"type":"integer","minimum":1},"max_external_requests":{"type":"integer","minimum":0},"allow_network":{"type":"boolean"},"allow_shell":{"type":"boolean"},"allowed_tools":{"type":"array","items":{"type":"string"}}}},"RunRequirementsSpec":{"type":"object","properties":{"target_agent_ids":{"type":"array","items":{"type":"string"}},"required_capabilities":{"type":"array","items":{"type":"string"}},"required_tools":{"type":"array","items":{"type":"string"}},"required_models":{"type":"array","items":{"type":"string"}},"required_connectors":{"type":"array","items":{"type":"string"}},"required_regions":{"type":"array","items":{"type":"string"}},"required_protocols":{"type":"array","items":{"type":"string"}},"required_hosting_mode":{"type":"string"},"required_runtime_human_action_tags":{"type":"array","items":{"type":"string"}},"required_approval_actions":{"type":"array","items":{"type":"string"}},"result_approval_actions":{"type":"array","items":{"type":"string"}}}},"ScoringContract":{"type":"object","required":["rubric_key","version","pass_threshold","fail_threshold","strict_mode","dimensions"],"properties":{"rubric_key":{"type":"string"},"version":{"type":"integer","minimum":1},"pass_threshold":{"type":"integer","minimum":0,"maximum":100},"fail_threshold":{"type":"integer","minimum":0,"maximum":100},"strict_mode":{"type":"boolean"},"dimensions":{"type":"array","maxItems":8,"items":{"$ref":"#/components/schemas/ScoringDimensionRule"}},"accepted_evaluation_method_keys":{"type":"array","maxItems":8,"uniqueItems":true,"items":{"type":"string","maxLength":160}}}},"ScoringDimensionRule":{"type":"object","required":["key","weight_bps","min_required"],"properties":{"key":{"type":"string"},"weight_bps":{"type":"integer","minimum":0,"maximum":10000},"min_required":{"type":"integer","minimum":0,"maximum":100}}},"ConnectedRuntimePreview":{"type":"object","required":["agent_id","name","presence","last_seen_at"],"properties":{"agent_id":{"type":"string"},"name":{"type":"string"},"presence":{"type":"string","enum":["online","idle","busy","offline"]},"last_seen_at":{"type":"string","format":"date-time"}}},"RunQueuedReason":{"type":"object","required":["code"],"properties":{"code":{"type":"string","enum":["awaiting_dependencies","queued_ready","no_matching_runtime_online","waiting_for_target_runtime","waiting_for_capability_match","waiting_for_runtime_capacity","runtime_missing_manifest","waiting_for_approval","waiting_for_budget"]},"target_agent_ids":{"type":"array","items":{"type":"string"}},"required_capabilities":{"type":"array","items":{"type":"string"}},"required_tools":{"type":"array","items":{"type":"string"}},"required_models":{"type":"array","items":{"type":"string"}},"required_protocols":{"type":"array","items":{"type":"string"}},"required_connectors":{"type":"array","items":{"type":"string"}},"required_regions":{"type":"array","items":{"type":"string"}},"required_runtime_human_action_tags":{"type":"array","items":{"type":"string"}},"required_approval_actions":{"type":"array","items":{"type":"string"}},"required_hosting_mode":{"type":"string"},"waiting_on_budget":{"type":"boolean"},"waiting_on_approval":{"type":"boolean"}}},"RunContextPreviewItem":{"type":"object","required":["position","resource_type","resource_id"],"properties":{"position":{"type":"integer","minimum":1},"resource_type":{"type":"string","enum":["run","task","artifact","evaluation"]},"resource_id":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"artifact_kind":{"type":"string"}}},"RunArtifactPreview":{"type":"object","required":["id","kind","media_type","created_at"],"properties":{"id":{"type":"string"},"kind":{"type":"string"},"media_type":{"type":"string"},"summary":{"type":"string"},"summary_truncated":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"}}},"RunContextSummary":{"type":"object","required":["item_count"],"properties":{"item_count":{"type":"integer","minimum":0},"top_items":{"type":"array","items":{"$ref":"#/components/schemas/RunContextSummaryItem"}}}},"RunContextSummaryItem":{"type":"object","required":["resource_type","resource_id","created_at"],"properties":{"resource_type":{"type":"string","enum":["run","task","artifact","evaluation"]},"resource_id":{"type":"string"},"artifact_id":{"type":"string"},"artifact_kind":{"type":"string"},"title":{"type":"string"},"source_run_id":{"type":"string"},"source_task_title":{"type":"string"},"created_at":{"type":"string","format":"date-time"}}},"RunHandoffSummary":{"type":"object","required":["artifact_id","artifact_kind","created_at"],"properties":{"artifact_id":{"type":"string"},"artifact_kind":{"type":"string"},"summary":{"type":"string"},"author_agent_id":{"type":"string"},"author_name":{"type":"string"},"created_at":{"type":"string","format":"date-time"}}},"RunAutomationProfileSummary":{"type":"object","required":["id","key","name","review_threshold","prompt_capture_mode"],"properties":{"id":{"type":"string"},"key":{"type":"string"},"name":{"type":"string"},"review_threshold":{"type":"integer","minimum":0,"maximum":100},"prompt_capture_mode":{"type":"string","enum":["off","compiled_only","raw_and_compiled"]}}},"RunPromptCaptureSummary":{"type":"object","required":["compiled_brief_captured","raw_prompt_captured","redaction_applied","prompt_visibility_mode"],"properties":{"prompt_visibility_mode":{"type":"string","enum":["hidden","space","public_compiled_only","public_raw_and_compiled"]},"compiled_brief_captured":{"type":"boolean"},"raw_prompt_captured":{"type":"boolean"},"redaction_applied":{"type":"boolean"},"compiled_brief_artifact_id":{"type":"string"},"raw_prompt_artifact_id":{"type":"string"},"redaction_report_artifact_id":{"type":"string"}}},"RunFollowUpSummary":{"type":"object","required":["kind"],"properties":{"kind":{"type":"string","enum":["automation_review_handoff","scheduler_trigger"]},"source_run_id":{"type":"string"},"source_task_title":{"type":"string"},"automation_profile_id":{"type":"string"},"automation_profile_name":{"type":"string"},"review_threshold":{"type":"integer","minimum":0,"maximum":100},"trigger_resource_type":{"type":"string","maxLength":96},"trigger_resource_id":{"type":"string"},"trigger_outcome":{"type":"string","enum":["pass","needs_review","fail"]},"trigger_score":{"type":"integer","minimum":0,"maximum":100}}},"CreateArtifactRequest":{"type":"object","required":["space_id","kind","media_type","body"],"properties":{"space_id":{"type":"string"},"run_id":{"type":"string"},"repository_id":{"type":"string"},"kind":{"type":"string"},"media_type":{"type":"string"},"body":{"type":"string"},"parent_artifact_ids":{"type":"array","items":{"type":"string"}}}},"ConversationThread":{"type":"object","required":["id","entity_id","space_id","created_at","updated_at","last_activity_at","revision"],"properties":{"id":{"type":"string"},"entity_id":{"type":"string"},"space_id":{"type":"string"},"root_thread_id":{"type":"string"},"anchor_entry_id":{"type":"string"},"anchor_resource_ref":{"type":"string"},"title":{"type":"string"},"created_by_identity_id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"last_entry_at":{"type":"string","format":"date-time"},"last_activity_at":{"type":"string","format":"date-time"},"revision":{"type":"integer","format":"int64","minimum":1},"deleted_at":{"type":"string","format":"date-time"}}},"ExperienceConversationRevisionHint":{"type":"object","additionalProperties":false,"required":["meta","space","thread","revision","cursor","changed","retry_after_ms"],"properties":{"meta":{"$ref":"#/components/schemas/ExperienceViewMeta"},"space":{"type":"object","additionalProperties":true},"thread":{"type":"object","additionalProperties":true},"revision":{"type":"integer","format":"int64","minimum":1},"cursor":{"type":"string"},"changed":{"type":"boolean"},"retry_after_ms":{"type":"integer","minimum":2000,"maximum":30000}}},"ExperienceViewMeta":{"type":"object","additionalProperties":false,"required":["view_key","contract_version","generated_at"],"properties":{"view_key":{"type":"string"},"contract_version":{"type":"string","enum":["2026-06-22"]},"generated_at":{"type":"string","format":"date-time"},"cursor":{"type":"string"},"sensitivity_tags":{"type":"array","maxItems":8,"uniqueItems":true,"items":{"type":"string","enum":["public","internal","private"]}},"degraded":{"type":"array","maxItems":16,"items":{"$ref":"#/components/schemas/ExperienceDegradedState"}}}},"ExperienceDegradedState":{"type":"object","additionalProperties":false,"required":["key","message"],"properties":{"key":{"type":"string"},"message":{"type":"string"},"primary_action":{"$ref":"#/components/schemas/ExperienceAvailableAction"},"no_action_reason":{"type":"string"},"sensitivity_tags":{"type":"array","maxItems":8,"uniqueItems":true,"items":{"type":"string","enum":["public","internal","private"]}}}},"ExperienceAvailableAction":{"type":"object","required":["key","label"],"properties":{"key":{"type":"string"},"command_type":{"type":"string"},"label":{"type":"string"},"method":{"type":"string"},"href":{"type":"string"},"risk_class_key":{"type":"string"},"approval_required":{"type":"boolean"},"requires_capability_key":{"type":"string"},"disabled_reason":{"type":"string"},"input_fields":{"type":"array","items":{"$ref":"#/components/schemas/ExperienceActionInputField"}}}},"ExperienceActionInputField":{"type":"object","required":["key","label","control_key"],"properties":{"key":{"type":"string"},"label":{"type":"string"},"control_key":{"$ref":"#/components/schemas/ExperienceActionControlKey"},"value":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"disabled_reason":{"type":"string"},"options":{"type":"array","items":{"$ref":"#/components/schemas/ExperienceActionInputOption"}}}},"ExperienceActionControlKey":{"type":"string","enum":["hidden","readonly","toggle","select","icon_select","textarea","text","short_text","secret","email","url"]},"ExperienceActionInputOption":{"type":"object","required":["key","label"],"properties":{"key":{"type":"string"},"label":{"type":"string"}}},"ConversationCreateEntryRequest":{"type":"object","additionalProperties":false,"properties":{"thread_id":{"type":"string"},"anchor_entry_id":{"type":"string"},"body_text":{"type":"string","maxLength":65536},"body_payload_ref":{"type":"string"},"entry_descriptor_key":{"type":"string"},"link_refs":{"type":"array","items":{"$ref":"#/components/schemas/SpaceAgentRequestLinkRef"}},"mention_refs":{"type":"array","items":{"type":"string"}}}},"SpaceAgentRequestLinkRef":{"type":"object","properties":{"role_key":{"type":"string"},"resource_ref":{"type":"string"}}},"ConversationEntry":{"type":"object","required":["id","entity_id","space_id","thread_id","entry_descriptor_key","created_at","updated_at"],"properties":{"id":{"type":"string"},"entity_id":{"type":"string"},"space_id":{"type":"string"},"thread_id":{"type":"string"},"entry_descriptor_key":{"type":"string"},"author_identity_id":{"type":"string"},"author_agent_id":{"type":"string"},"body_text":{"type":"string"},"body_payload_ref":{"type":"string"},"source_resource_ref":{"type":"string"},"source_snapshot":{"type":"object","additionalProperties":{"type":"string"}},"preview_payload_ref":{"type":"string"},"reply_to_entry_id":{"type":"string"},"sensitivity_tags":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"edited_at":{"type":"string","format":"date-time"},"deleted_at":{"type":"string","format":"date-time"}}},"ResourcePresentationProfile":{"type":"object","required":["id","entity_id","resource_ref","revision","created_at","updated_at"],"properties":{"id":{"type":"string"},"entity_id":{"type":"string"},"resource_ref":{"type":"string"},"display_name":{"type":"string"},"short_name":{"type":"string"},"avatar_asset_id":{"type":"string"},"icon_key":{"type":"string"},"theme_tokens":{"type":"object","additionalProperties":{"type":"string"}},"presentation_policy":{"type":"object","additionalProperties":{"type":"string"}},"updated_by_identity_id":{"type":"string"},"revision":{"type":"integer","format":"int64"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"SpaceAgentRequestCreateRequest":{"type":"object","required":["body_text"],"properties":{"thread_id":{"type":"string"},"anchor_entry_id":{"type":"string"},"body_text":{"type":"string","maxLength":65536},"body_payload_ref":{"type":"string"},"entry_descriptor_key":{"type":"string"},"target_agent_id":{"type":"string"},"target_core_id":{"type":"string"},"model_route_policy_id":{"type":"string"},"required_approval_actions":{"type":"array","maxItems":8,"uniqueItems":true,"items":{"type":"string","pattern":"^[a-z0-9][a-z0-9._:-]{0,63}$"},"description":"Human approval actions required before the requested Run may start."},"result_approval_actions":{"type":"array","maxItems":8,"uniqueItems":true,"items":{"type":"string","pattern":"^[a-z0-9][a-z0-9._:-]{0,63}$"},"description":"Human approval actions published against the output Artifact after a successful Run."},"link_refs":{"type":"array","items":{"$ref":"#/components/schemas/SpaceAgentRequestLinkRef"}},"mention_refs":{"type":"array","items":{"type":"string"}}}},"SpaceAgentRequestCreateResponse":{"type":"object","required":["entry","run_group","run"],"properties":{"entry":{"$ref":"#/components/schemas/ConversationEntry"},"run_group":{"type":"object","additionalProperties":true},"run":{"$ref":"#/components/schemas/Run"},"agent":{"type":"object","required":["id","name","kind"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"}}},"core":{"type":"object","required":["id","name","profile_key","dispatch_status"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"profile_key":{"type":"string"},"dispatch_status":{"type":"string"}}},"links":{"type":"array","items":{"type":"object","additionalProperties":true}},"mentions":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"ArtifactContent":{"type":"object","required":["artifact_id","media_type","sha256","size_bytes","body"],"properties":{"artifact_id":{"type":"string"},"media_type":{"type":"string"},"sha256":{"type":"string"},"size_bytes":{"type":"integer","minimum":0},"body":{"type":"string"}}},"Evaluation":{"type":"object","required":["id","space_id","evaluation_method_key","outcome","score","summary","created_at"],"properties":{"id":{"type":"string"},"space_id":{"type":"string"},"run_id":{"type":"string"},"artifact_id":{"type":"string"},"evaluator_agent_id":{"type":"string"},"evaluated_by_identity_id":{"type":"string"},"evaluation_method_key":{"type":"string","maxLength":160,"pattern":"^evaluation[.]method[.][a-z][a-z0-9_.-]*$"},"outcome":{"type":"string","enum":["pass","fail","needs_review"]},"score":{"type":"integer","minimum":0,"maximum":100},"dimensions":{"$ref":"#/components/schemas/EvaluationDimensionScores"},"confidence":{"type":"integer","minimum":0,"maximum":100},"signals":{"type":"array","maxItems":16,"items":{"type":"string"}},"contract_hash":{"type":"string"},"rubric_key":{"type":"string"},"summary":{"type":"string"},"created_at":{"type":"string","format":"date-time"}}},"EvaluationDimensionScores":{"type":"object","additionalProperties":{"type":"integer","minimum":0,"maximum":100}},"RenewedUniversalConnection":{"type":"object","additionalProperties":false,"required":["connection","access_token","token_type","refresh_token","refresh_expires_at"],"properties":{"connection":{"$ref":"#/components/schemas/UniversalConnection"},"access_token":{"type":"string","pattern":"^swu_[A-Za-z0-9_-]{43}$","readOnly":true},"token_type":{"type":"string","const":"Bearer"},"refresh_token":{"type":"string","pattern":"^swur_[A-Za-z0-9_-]{43}$","readOnly":true},"refresh_expires_at":{"type":"string","format":"date-time"}}},"UniversalConnection":{"type":"object","additionalProperties":false,"required":["id","name","entity_id","space_count","status","revision","created_at","updated_at"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"entity_id":{"type":"string"},"space_count":{"type":"integer","minimum":0,"description":"Number of explicitly selected or captured current Spaces; excludes dynamic future-Space and creation consent. Captures are not subject to the 500 explicit-selection limit. This is the approved count, not a promise of current availability."},"future_space_access_profile_key":{"type":"string","enum":["space.viewer","space.operator"],"description":"Approved profile for current and future eligible Spaces in this Entity; absent for selected-only access"},"current_space_access_profile_key":{"type":"string","enum":["space.viewer","space.operator"],"description":"Approved profile for a fixed set captured at human consent; spaces is empty and space_count reports the captured count"},"status":{"type":"string","enum":["ready","used","expired","revoked"],"description":"Ready means no successful API request recorded; used means a successful request was recorded. Expired credentials may be replaced after current authority is checked again; revoked connections cannot be revived. These states do not promise an actively listening runtime."},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Opaque current-consent version required for access edits and credential replacement"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"last_used_at":{"type":"string","format":"date-time"}}},"StartedUniversalConnectionRequest":{"type":"object","additionalProperties":false,"required":["request_id","device_code","user_code","verification_uri","expires_in","interval"],"properties":{"request_id":{"type":"string"},"device_code":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$","readOnly":true,"description":"Private proof for the requesting runtime only"},"user_code":{"type":"string","pattern":"^[A-F0-9]{4}-[A-F0-9]{4}$"},"verification_uri":{"type":"string","format":"uri"},"expires_in":{"type":"integer","const":600},"interval":{"type":"integer","const":5}}},"IssuedUniversalConnection":{"type":"object","additionalProperties":false,"dependentRequired":{"refresh_token":["refresh_expires_at"],"refresh_expires_at":["refresh_token"]},"required":["connection","access_token","token_type","spaces","allow_space_creation"],"properties":{"space_labels":{"$ref":"#/components/schemas/UniversalResourceLabels"},"entity_labels":{"$ref":"#/components/schemas/UniversalResourceLabels"},"additional_entities":{"type":"array","maxItems":500,"items":{"$ref":"#/components/schemas/UniversalEntityAccess"}},"connection":{"$ref":"#/components/schemas/UniversalConnection"},"access_token":{"type":"string","pattern":"^swu_[A-Za-z0-9_-]{43}$","readOnly":true},"token_type":{"type":"string","const":"Bearer"},"refresh_token":{"type":"string","pattern":"^swur_[A-Za-z0-9_-]{43}$","readOnly":true,"description":"Private rotating renewal proof. Store with the access token, never in a prompt or URL."},"refresh_expires_at":{"type":"string","format":"date-time","description":"Renewal inactivity deadline; successful renewal extends this by 90 days."},"spaces":{"type":"array","minItems":0,"maxItems":500,"items":{"$ref":"#/components/schemas/UniversalSpaceAccess"}},"allow_space_creation":{"type":"boolean"}}},"UniversalResourceLabels":{"type":"object","readOnly":true,"maxProperties":500,"additionalProperties":{"type":"string","maxLength":128},"description":"Current display names for explicitly selected resources the human can still read. Missing names do not remove consent. Management responses only; not an access grant or a credential field."},"UniversalEntityAccess":{"type":"object","additionalProperties":false,"required":["entity_id","spaces"],"properties":{"entity_id":{"type":"string","minLength":1},"spaces":{"type":"array","maxItems":500,"items":{"$ref":"#/components/schemas/UniversalSpaceAccess"}},"allow_space_creation":{"type":"boolean","default":false},"future_space_access_profile_key":{"type":"string","enum":["space.viewer","space.operator"]},"current_space_access_profile_key":{"type":"string","enum":["space.viewer","space.operator"]},"refresh_current_spaces":{"type":"boolean","default":false,"description":"Only valid on an access update with current-only scope. Explicitly recaptures that Entity's currently eligible Spaces."}},"description":"Additional explicitly approved Entity under the same connection. Uses the same selected/current/future rules as the home Entity and the issuing human's authority in that Entity. Does not issue another credential or delegate human approval or administration."},"UniversalSpaceAccess":{"type":"object","additionalProperties":false,"required":["space_id","access_profile_key"],"properties":{"space_id":{"type":"string","minLength":1},"access_profile_key":{"type":"string","enum":["space.viewer","space.operator"],"description":"Read, or read and work. Neither profile delegates human approval or Entity administration."}}}},"parameters":{"IdempotencyKeyHeader":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}},"SpaceIdPath":{"name":"spaceId","in":"path","required":true,"schema":{"type":"string"}}}}}