{"components":{"securitySchemes":{"connection":{"scheme":"bearer","type":"http"}}},"info":{"title":"StarGit scoped account API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/agents":{"get":{"operationId":"list_agents","parameters":[{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"List your configured in-product agents; does not execute paid model calls.","x-stargit-scope":"agents:read"}},"/api/v1/agents/{agent_uuid}":{"get":{"operationId":"get_agent","parameters":[{"in":"path","name":"agent_uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read an owned agent configuration summary without provider secrets.","x-stargit-scope":"agents:read"}},"/api/v1/agents/{agent_uuid}/runs":{"get":{"operationId":"list_agent_runs","parameters":[{"in":"path","name":"agent_uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"List existing in-product execution evidence; separate from external workflow runs.","x-stargit-scope":"agents:read"}},"/api/v1/agents/{agent_uuid}/runs/{execution_uuid}":{"get":{"operationId":"get_agent_run","parameters":[{"in":"path","name":"agent_uuid","required":true,"schema":{"type":"string"}},{"in":"path","name":"execution_uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Inspect public output, recorded model identity, step status and tool names; excludes hidden reasoning.","x-stargit-scope":"agents:read"}},"/api/v1/agents/{agent_uuid}/schedules":{"get":{"operationId":"list_agent_schedules","parameters":[{"in":"path","name":"agent_uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read owned agent schedules without executing them or exposing stored configuration.","x-stargit-scope":"agents:read"}},"/api/v1/agents/{agent_uuid}/threads":{"get":{"operationId":"list_agent_threads","parameters":[{"in":"path","name":"agent_uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"List accessible in-product conversations for your agent.","x-stargit-scope":"agents:read"}},"/api/v1/agents/{agent_uuid}/threads/{thread_uuid}":{"get":{"operationId":"get_agent_thread","parameters":[{"in":"path","name":"agent_uuid","required":true,"schema":{"type":"string"}},{"in":"path","name":"thread_uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read public user/assistant messages with pagination; excludes system/tool internals.","x-stargit-scope":"agents:read"}},"/api/v1/bootstrap":{"get":{"operationId":"bootstrap","parameters":[{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Discover identity, granted permissions, catalog and workflows.","x-stargit-scope":"account:read"}},"/api/v1/hosting/providers":{"get":{"operationId":"list_hosting_providers","parameters":[{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Discover enabled managed hosting destinations and readiness.","x-stargit-scope":"repositories:read"}},"/api/v1/me":{"get":{"operationId":"identity","parameters":[{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read your account identity; never returns secrets.","x-stargit-scope":"account:read"}},"/api/v1/operations/{task_id}":{"get":{"operationId":"get_operation","parameters":[{"in":"path","name":"task_id","required":true,"schema":{"type":"integer"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Inspect an authorized read operation; no arbitrary server task results.","x-stargit-scope":"repositories:read"}},"/api/v1/playbooks":{"get":{"operationId":"playbook_catalog","parameters":[{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Discover current immutable guide versions and SHA-256 hashes.","x-stargit-scope":"account:read"}},"/api/v1/playbooks/{guide}/{version}":{"get":{"operationId":"get_playbook","parameters":[{"in":"path","name":"guide","required":true,"schema":{"type":"string"}},{"in":"path","name":"version","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Retrieve a hash-verifiable versioned data-only playbook.","x-stargit-scope":"account:read"}},"/api/v1/receipts/{key}":{"get":{"operationId":"get_receipt","parameters":[{"in":"path","name":"key","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Recover the durable result of a write after a network interruption.","x-stargit-scope":"account:read"}},"/api/v1/repositories":{"get":{"operationId":"list_repositories","parameters":[{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"List repositories you own or belong to, with pagination and total.","x-stargit-scope":"repositories:read"},"post":{"operationId":"create_repository","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-StarGit-Playbook-Revision","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"default_branch":{"type":"string"},"description":{"type":"string"},"name":{"type":"string"},"provider_id":{"type":"integer"},"readme":{"type":"boolean"},"visibility":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Create a managed repository at an available hosting destination.","x-stargit-scope":"repositories:create"}},"/api/v1/repositories/references":{"post":{"operationId":"register_repository","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-StarGit-Playbook-Revision","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"type":"string"},"remote":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Attach an existing Git remote as a private repository reference.","x-stargit-scope":"repositories:create"}},"/api/v1/repositories/{uuid}":{"get":{"operationId":"get_repository","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read repository metadata and your current role.","x-stargit-scope":"repositories:read"},"patch":{"operationId":"update_repository","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-StarGit-Playbook-Revision","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"description":{"type":"string"},"revision":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Update an owned repository description with an expected revision.","x-stargit-scope":"repositories:write"}},"/api/v1/repositories/{uuid}/branches":{"get":{"operationId":"list_branches","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"List reported branches; includes freshness information.","x-stargit-scope":"repositories:read"}},"/api/v1/repositories/{uuid}/commits":{"get":{"operationId":"list_commits","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read branch history with pagination and snapshot provenance.","x-stargit-scope":"repositories:read"}},"/api/v1/repositories/{uuid}/file":{"get":{"operationId":"get_file","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read a file at an exact commit; returns text and content hash.","x-stargit-scope":"repositories:read"}},"/api/v1/repositories/{uuid}/handovers":{"get":{"operationId":"list_handovers","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"List versioned publications for this repository.","x-stargit-scope":"handovers:read"},"post":{"operationId":"publish_handover","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-StarGit-Playbook-Revision","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"entrypoint":{"type":"string"},"files":{"type":"array"},"parent_id":{"type":"string"},"slug":{"type":"string"},"source":{"type":"object"},"title":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Publish a handover and supporting Markdown with original project paths.","x-stargit-scope":"handovers:write"}},"/api/v1/repositories/{uuid}/handovers/{rid}":{"get":{"operationId":"get_handover","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"path","name":"rid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read publication manifest, source revision and file hashes.","x-stargit-scope":"handovers:read"}},"/api/v1/repositories/{uuid}/handovers/{rid}/document":{"get":{"operationId":"get_handover_document","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"path","name":"rid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read a hash-verified published Markdown document.","x-stargit-scope":"handovers:read"}},"/api/v1/repositories/{uuid}/hosting":{"get":{"operationId":"get_hosting_status","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Inspect managed creation status and clone URLs.","x-stargit-scope":"repositories:read"},"post":{"operationId":"retry_hosting","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-StarGit-Playbook-Revision","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"action":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Retry an owned failed managed repository creation.","x-stargit-scope":"repositories:create"}},"/api/v1/repositories/{uuid}/pulls":{"get":{"operationId":"list_pulls","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"List PRs with pagination and total.","x-stargit-scope":"pulls:read"},"post":{"operationId":"create_pull","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-StarGit-Playbook-Revision","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"base_branch":{"type":"string"},"body":{"type":"string"},"dependencies":{"type":"array"},"draft":{"type":"boolean"},"head_branch":{"type":"string"},"included_prs":{"type":"array"},"title":{"type":"string"},"workstream":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Propose a focused PR with branches and optional dependencies.","x-stargit-scope":"pulls:write"}},"/api/v1/repositories/{uuid}/pulls/{number}":{"get":{"operationId":"get_pull","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"path","name":"number","required":true,"schema":{"type":"integer"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read exact revision, comparison, checks and discussions.","x-stargit-scope":"pulls:read"},"post":{"operationId":"act_on_pull","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"path","name":"number","required":true,"schema":{"type":"integer"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-StarGit-Playbook-Revision","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"action":{"type":"string"},"body":{"type":"string"},"dependencies":{"type":"array"},"details":{"type":"object"},"head_sha":{"type":"string"},"included_prs":{"type":"array"},"line":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string"},"reply_to":{"type":"integer"},"revision":{"type":"integer"},"side":{"type":"string"},"status":{"type":"string"},"title":{"type":"string"},"workstream":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Update intent, refresh, mark ready/draft, comment or report a check. Requires current PR revision.","x-stargit-scope":"pulls:write"}},"/api/v1/repositories/{uuid}/pulls/{number}/revisions/{revision}":{"get":{"operationId":"get_pull_revision","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"path","name":"number","required":true,"schema":{"type":"integer"}},{"in":"path","name":"revision","required":true,"schema":{"type":"integer"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Inspect immutable PR revision evidence.","x-stargit-scope":"pulls:read"}},"/api/v1/repositories/{uuid}/tree":{"get":{"operationId":"get_tree","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read a selected branch tree; remote reads may return a pending operation.","x-stargit-scope":"repositories:read"}},"/api/v1/runs":{"get":{"operationId":"list_runs","parameters":[{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"List public workflow evidence recorded through this connection.","x-stargit-scope":"account:read"},"post":{"operationId":"start_run","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-StarGit-Playbook-Revision","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"metadata":{"type":"object"},"mode":{"type":"string"},"prompt":{"type":"string"},"repository_uuid":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Record public user intent and read or write mode before performing work.","x-stargit-scope":"account:read"}},"/api/v1/runs/{run_id}":{"get":{"operationId":"get_run","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Read public prompt, client-reported metadata and request evidence.","x-stargit-scope":"account:read"}},"/api/v1/runs/{run_id}/finish":{"post":{"operationId":"finish_run","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-StarGit-Playbook-Revision","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"metadata":{"type":"object"},"result":{"type":"string"},"status":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"Record a public outcome with no hidden reasoning, usage or invented costs.","x-stargit-scope":"account:read"}},"/api/v1/servers":{"get":{"operationId":"list_servers","parameters":[{"in":"query","name":"limit","schema":{"type":"string"}},{"in":"query","name":"offset","schema":{"type":"string"}},{"in":"query","name":"branch","schema":{"type":"string"}},{"in":"query","name":"snapshot","schema":{"type":"string"}},{"in":"query","name":"path","schema":{"type":"string"}},{"in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"201":{"description":"Created"},"202":{"description":"Pending operation"},"400":{"description":"Invalid input"},"401":{"description":"Invalid connection"},"403":{"description":"Permission denied"},"404":{"description":"Not accessible"},"409":{"description":"Revision, guide or idempotency conflict"},"413":{"description":"Size limit"},"415":{"description":"Unsupported content"},"429":{"description":"Rate limited"},"500":{"description":"Unexpected failure; recover with request key"},"503":{"description":"Feature or storage unavailable"}},"security":[{"connection":[]}],"summary":"List your connected servers, without host credentials or filesystem paths.","x-stargit-scope":"servers:read"}}},"servers":[{"url":"https://stargit.com"}]}