{"openapi":"3.1.0","info":{"title":"strata-web","version":"0.0.1"},"paths":{"/api/v1/auth/signup":{"post":{"tags":["auth"],"summary":"Signup","description":"Create an account and auto-create a session (cookies on the response).\n\nWhen ``REQUIRE_EMAIL_VERIFICATION`` is true, also sends the verification\nemail — the session is created regardless, so an unverified user can\nstill sign in (only workspace creation is gated, WP-7).","operationId":"signup_api_v1_auth_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Signup Api V1 Auth Signup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/signin":{"post":{"tags":["auth"],"summary":"Signin","description":"Verify credentials and start a session; any failure is a generic 401.","operationId":"signin_api_v1_auth_signin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SigninRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Signin Api V1 Auth Signin Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/signout":{"post":{"tags":["auth"],"summary":"Signout","description":"Delete the server-side session and expire both auth cookies.","operationId":"signout_api_v1_auth_signout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Signout Api V1 Auth Signout Post"}}}}}}},"/api/v1/auth/me":{"get":{"tags":["auth"],"summary":"Me","description":"The authenticated user, or 401 ``unauthorized``.","operationId":"me_api_v1_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Me Api V1 Auth Me Get"}}}}}}},"/api/v1/auth/verify-email":{"post":{"tags":["auth"],"summary":"Verify Email","description":"Redeem a verification token; invalid/expired/used all → 400 ``invalid_token``.","operationId":"verify_email_api_v1_auth_verify_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify Email Api V1 Auth Verify Email Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/resend-verification":{"post":{"tags":["auth"],"summary":"Resend Verification","description":"Mint + send a fresh verification link, subject to a per-user cooldown.\n\n409 ``conflict`` if already verified; 404 ``not_found`` if\n``REQUIRE_EMAIL_VERIFICATION`` is off (nothing to resend).","operationId":"resend_verification_api_v1_auth_resend_verification_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Resend Verification Api V1 Auth Resend Verification Post"}}}}}}},"/api/v1/auth/forgot-password":{"post":{"tags":["auth"],"summary":"Forgot Password","description":"Mail a password-reset link if the account exists (issue #30, WP-H1).\n\nAlways 202 with no account-existence oracle — a registered address is\nmailed a link, an unregistered one is a silent no-op, and the response is\nidentical either way. 404 ``not_found`` when no SMTP sender is configured\n(the feature is off, same posture as email verification): with nothing to\nsend, this route has no work to do. Authenticated via nothing — the caller\nis by definition locked out — so no session/CSRF, exactly like verify-email.","operationId":"forgot_password_api_v1_auth_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Forgot Password Api V1 Auth Forgot Password Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/reset-password":{"post":{"tags":["auth"],"summary":"Reset Password","description":"Redeem a reset token: set the new password, drop all existing sessions.\n\nInvalid/expired/used tokens all → the same generic 400 ``invalid_token``.\n404 ``not_found`` when no SMTP sender is configured (no token could ever\nhave been minted). The token is the credential here, so no session/CSRF.","operationId":"reset_password_api_v1_auth_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Reset Password Api V1 Auth Reset Password Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/providers":{"get":{"tags":["auth"],"summary":"Oauth Providers","description":"The enabled OAuth providers (public, no auth). ``[]`` when none configured.\n\nReveals only server configuration — which providers are wired up — never\nuser data, so it is safe to serve anonymously. The Console reads it to show\nonly the enabled \"Continue with ...\" buttons.","operationId":"oauth_providers_api_v1_auth_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Oauth Providers Api V1 Auth Providers Get"}}}}}}},"/api/v1/auth/oauth/{provider}/start":{"get":{"tags":["auth"],"summary":"Oauth Start","description":"Begin the authorization-code flow: 302 to the provider with a CSRF state.\n\n404 for an unconfigured/unknown provider (same posture as the other gated\nauth surfaces). No session/CSRF header — the caller is signing in — but a\nsigned, httponly, browser-bound ``state`` cookie is set here and verified on\nthe callback.","operationId":"oauth_start_api_v1_auth_oauth__provider__start_get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/oauth/{provider}/callback":{"get":{"tags":["auth"],"summary":"Oauth Callback","description":"Complete the flow: validate state, exchange the code, resolve the account.\n\nOn success sets the ``strata_session`` + ``strata_csrf`` cookies exactly\nlike signin and redirects to the Console (``/workspaces``); on any failure\nredirects to ``/signin?error=...``. A missing/mismatched/expired/replayed\nstate is rejected before the code is ever exchanged. The state cookie is\nsingle-use — cleared on every outcome — so a replayed callback finds no\ncookie and is rejected.","operationId":"oauth_callback_api_v1_auth_oauth__provider__callback_get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces":{"get":{"tags":["workspaces"],"summary":"List Workspaces","operationId":"list_workspaces_api_v1_workspaces_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Workspaces Api V1 Workspaces Get"}}}}}},"post":{"tags":["workspaces"],"summary":"Create Workspace","operationId":"create_workspace_api_v1_workspaces_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/strata_web__api__console__workspaces__CreateWorkspaceRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Workspace Api V1 Workspaces Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}":{"get":{"tags":["workspaces"],"summary":"Get Workspace","operationId":"get_workspace_api_v1_workspaces__workspace_id__get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Workspace Api V1 Workspaces  Workspace Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["workspaces"],"summary":"Rename Workspace","operationId":"rename_workspace_api_v1_workspaces__workspace_id__patch","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameWorkspaceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Rename Workspace Api V1 Workspaces  Workspace Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["workspaces"],"summary":"Delete Workspace","description":"Soft delete: ``pending_delete`` + 7-day ``delete_after``; restorable until purged.","operationId":"delete_workspace_api_v1_workspaces__workspace_id__delete","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Workspace Api V1 Workspaces  Workspace Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/archive":{"post":{"tags":["workspaces"],"summary":"Archive Workspace","operationId":"archive_workspace_api_v1_workspaces__workspace_id__archive_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Archive Workspace Api V1 Workspaces  Workspace Id  Archive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/restore":{"post":{"tags":["workspaces"],"summary":"Restore Workspace","operationId":"restore_workspace_api_v1_workspaces__workspace_id__restore_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Restore Workspace Api V1 Workspaces  Workspace Id  Restore Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/export":{"get":{"tags":["workspaces"],"summary":"Export Workspace","description":"Download the workspace as a zip — itself a valid local Strata workspace (§3.1).","operationId":"export_workspace_api_v1_workspaces__workspace_id__export_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/members":{"get":{"tags":["members"],"summary":"List Members","operationId":"list_members_api_v1_workspaces__workspace_id__members_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Members Api V1 Workspaces  Workspace Id  Members Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["members"],"summary":"Invite Member","operationId":"invite_member_api_v1_workspaces__workspace_id__members_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteMemberRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Invite Member Api V1 Workspaces  Workspace Id  Members Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/members/{member_id}/remove":{"post":{"tags":["members"],"summary":"Remove Member","operationId":"remove_member_api_v1_workspaces__workspace_id__members__member_id__remove_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"member_id","in":"path","required":true,"schema":{"type":"string","title":"Member Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Remove Member Api V1 Workspaces  Workspace Id  Members  Member Id  Remove Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/me/invites":{"get":{"tags":["members"],"summary":"List My Invites","operationId":"list_my_invites_api_v1_me_invites_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List My Invites Api V1 Me Invites Get"}}}}}}},"/api/v1/me/invites/{member_id}/accept":{"post":{"tags":["members"],"summary":"Accept Invite","operationId":"accept_invite_api_v1_me_invites__member_id__accept_post","parameters":[{"name":"member_id","in":"path","required":true,"schema":{"type":"string","title":"Member Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Accept Invite Api V1 Me Invites  Member Id  Accept Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/agents":{"get":{"tags":["agents"],"summary":"List Agents","operationId":"list_agents_api_v1_workspaces__workspace_id__agents_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Agents Api V1 Workspaces  Workspace Id  Agents Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["agents"],"summary":"Create Agent","operationId":"create_agent_api_v1_workspaces__workspace_id__agents_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Agent Api V1 Workspaces  Workspace Id  Agents Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/agents/{agent_id}":{"get":{"tags":["agents"],"summary":"Get Agent","operationId":"get_agent_api_v1_workspaces__workspace_id__agents__agent_id__get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Agent Api V1 Workspaces  Workspace Id  Agents  Agent Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["agents"],"summary":"Update Agent","operationId":"update_agent_api_v1_workspaces__workspace_id__agents__agent_id__patch","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAgentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Agent Api V1 Workspaces  Workspace Id  Agents  Agent Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["agents"],"summary":"Delete Agent","operationId":"delete_agent_api_v1_workspaces__workspace_id__agents__agent_id__delete","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Agent Api V1 Workspaces  Workspace Id  Agents  Agent Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/agents/{agent_id}/keys":{"post":{"tags":["agents"],"summary":"Mint Key","operationId":"mint_key_api_v1_workspaces__workspace_id__agents__agent_id__keys_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MintKeyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mint Key Api V1 Workspaces  Workspace Id  Agents  Agent Id  Keys Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/agents/{agent_id}/keys/{key_id}/revoke":{"post":{"tags":["agents"],"summary":"Revoke Key","operationId":"revoke_key_api_v1_workspaces__workspace_id__agents__agent_id__keys__key_id__revoke_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Key Api V1 Workspaces  Workspace Id  Agents  Agent Id  Keys  Key Id  Revoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/enrollment-codes":{"get":{"tags":["enrollment-codes"],"summary":"List Enrollment Codes","operationId":"list_enrollment_codes_api_v1_workspaces__workspace_id__enrollment_codes_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Enrollment Codes Api V1 Workspaces  Workspace Id  Enrollment Codes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["enrollment-codes"],"summary":"Create Enrollment Code","operationId":"create_enrollment_code_api_v1_workspaces__workspace_id__enrollment_codes_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEnrollmentCodeRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Enrollment Code Api V1 Workspaces  Workspace Id  Enrollment Codes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/enrollment-codes/{code_id}/revoke":{"post":{"tags":["enrollment-codes"],"summary":"Revoke Enrollment Code","operationId":"revoke_enrollment_code_api_v1_workspaces__workspace_id__enrollment_codes__code_id__revoke_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"code_id","in":"path","required":true,"schema":{"type":"string","title":"Code Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Enrollment Code Api V1 Workspaces  Workspace Id  Enrollment Codes  Code Id  Revoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/fleet":{"get":{"tags":["fleet"],"summary":"Get Fleet","operationId":"get_fleet_api_v1_workspaces__workspace_id__fleet_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Fleet Api V1 Workspaces  Workspace Id  Fleet Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["fleet"],"summary":"Put Fleet","operationId":"put_fleet_api_v1_workspaces__workspace_id__fleet_put","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutFleetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Put Fleet Api V1 Workspaces  Workspace Id  Fleet Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/scopes":{"get":{"tags":["scopes"],"summary":"List Scopes","operationId":"list_scopes_api_v1_workspaces__workspace_id__scopes_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Scopes Api V1 Workspaces  Workspace Id  Scopes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/scopes/{scope_id}/summary":{"get":{"tags":["scopes"],"summary":"Get Scope Summary","operationId":"get_scope_summary_api_v1_workspaces__workspace_id__scopes__scope_id__summary_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Scope Summary Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Summary Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/scopes/{scope_id}/perspective":{"get":{"tags":["scopes"],"summary":"Get Scope Perspective","description":"The scope's composed perspective (issue #83) — view-as at the scope level.\n\nSame engine code path as the per-agent view-as, keyed on the scope alone\n(the perspective is skill-independent today); logs no read receipt.","operationId":"get_scope_perspective_api_v1_workspaces__workspace_id__scopes__scope_id__perspective_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Scope Perspective Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Perspective Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/scopes/{scope_id}/record":{"get":{"tags":["scopes"],"summary":"Get Scope Record","operationId":"get_scope_record_api_v1_workspaces__workspace_id__scopes__scope_id__record_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Scope Record Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Record Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/scopes/{scope_id}/publication":{"get":{"tags":["scopes"],"summary":"Get Scope Publication","operationId":"get_scope_publication_api_v1_workspaces__workspace_id__scopes__scope_id__publication_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Scope Publication Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Publication Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/scopes/{scope_id}/operator":{"get":{"tags":["scopes"],"summary":"Get Scope Operator","operationId":"get_scope_operator_api_v1_workspaces__workspace_id__scopes__scope_id__operator_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Scope Operator Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Operator Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["scopes"],"summary":"Publish Operator Item","operationId":"publish_operator_item_api_v1_workspaces__workspace_id__scopes__scope_id__operator_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishOperatorItemRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Publish Operator Item Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Operator Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/scopes/{scope_id}/operator/{item_id}/supersede":{"post":{"tags":["scopes"],"summary":"Supersede Operator Item","operationId":"supersede_operator_item_api_v1_workspaces__workspace_id__scopes__scope_id__operator__item_id__supersede_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}},{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupersedeOperatorItemRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Supersede Operator Item Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Operator  Item Id  Supersede Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/scopes/{scope_id}/operator/{item_id}/retire":{"post":{"tags":["scopes"],"summary":"Retire Operator Item","operationId":"retire_operator_item_api_v1_workspaces__workspace_id__scopes__scope_id__operator__item_id__retire_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}},{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Retire Operator Item Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Operator  Item Id  Retire Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/scopes/{scope_id}/skill-body":{"get":{"tags":["scopes"],"summary":"Get Skill Body","operationId":"get_skill_body_api_v1_workspaces__workspace_id__scopes__scope_id__skill_body_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Skill Body Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Skill Body Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["scopes"],"summary":"Put Skill Body","description":"Save the scope's skill (D7) — the whole pair when ``skill`` is present.\n\nWith ``skill`` in the request the save is the D7 pair act\n(:func:`~strata_web.services.skill_bodies.save_skill`): the name lands in\n``fleet.yaml`` as the scope's ``default_skill`` and the body in\n``scope_skill_bodies``, or a 422 refuses a name with no body. With the field\nomitted the save is body-only, exactly as before, so a client that has not\nlearned the pair cannot silently drop a scope's declared skill.","operationId":"put_skill_body_api_v1_workspaces__workspace_id__scopes__scope_id__skill_body_put","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutSkillBodyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Put Skill Body Api V1 Workspaces  Workspace Id  Scopes  Scope Id  Skill Body Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/agents/{agent_id}/view-as":{"get":{"tags":["transparency"],"summary":"View As","operationId":"view_as_api_v1_workspaces__workspace_id__agents__agent_id__view_as_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response View As Api V1 Workspaces  Workspace Id  Agents  Agent Id  View As Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/agents/{agent_id}/receipts":{"get":{"tags":["transparency"],"summary":"Agent Receipts","operationId":"agent_receipts_api_v1_workspaces__workspace_id__agents__agent_id__receipts_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent Receipts Api V1 Workspaces  Workspace Id  Agents  Agent Id  Receipts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/receipts/staleness":{"get":{"tags":["transparency"],"summary":"Receipts Staleness","operationId":"receipts_staleness_api_v1_workspaces__workspace_id__receipts_staleness_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Receipts Staleness Api V1 Workspaces  Workspace Id  Receipts Staleness Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/setup":{"get":{"tags":["connect"],"summary":"Get Setup","operationId":"get_setup_api_v1_workspaces__workspace_id__setup_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Setup Api V1 Workspaces  Workspace Id  Setup Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/usage":{"get":{"tags":["usage"],"summary":"Get Usage","operationId":"get_usage_api_v1_workspaces__workspace_id__usage_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Usage Api V1 Workspaces  Workspace Id  Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/activity":{"get":{"tags":["usage"],"summary":"Get Activity","operationId":"get_activity_api_v1_workspaces__workspace_id__activity_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"scope_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Get Activity Api V1 Workspaces  Workspace Id  Activity Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/value":{"get":{"tags":["value"],"summary":"Get Value","operationId":"get_value_api_v1_workspaces__workspace_id__value_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"window_days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Window Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Value Api V1 Workspaces  Workspace Id  Value Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/me":{"get":{"tags":["admin"],"summary":"Me","operationId":"me_api_v1_admin_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Me Api V1 Admin Me Get"}}}}}}},"/api/v1/admin/users":{"get":{"tags":["admin"],"summary":"List Users","operationId":"list_users_api_v1_admin_users_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Users Api V1 Admin Users Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}/disable":{"post":{"tags":["admin"],"summary":"Disable User","operationId":"disable_user_api_v1_admin_users__user_id__disable_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Disable User Api V1 Admin Users  User Id  Disable Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}/enable":{"post":{"tags":["admin"],"summary":"Enable User","operationId":"enable_user_api_v1_admin_users__user_id__enable_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Enable User Api V1 Admin Users  User Id  Enable Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}/quota":{"put":{"tags":["admin"],"summary":"Set Quota","operationId":"set_quota_api_v1_admin_users__user_id__quota_put","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaOverrideRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Quota Api V1 Admin Users  User Id  Quota Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}/comp":{"post":{"tags":["admin"],"summary":"Grant Comp","operationId":"grant_comp_api_v1_admin_users__user_id__comp_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompGrantRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Grant Comp Api V1 Admin Users  User Id  Comp Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Clear Comp","operationId":"clear_comp_api_v1_admin_users__user_id__comp_delete","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Clear Comp Api V1 Admin Users  User Id  Comp Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/workspaces":{"get":{"tags":["admin"],"summary":"List Workspaces","operationId":"list_workspaces_api_v1_admin_workspaces_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Workspaces Api V1 Admin Workspaces Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/workspaces/{workspace_id}":{"get":{"tags":["admin"],"summary":"Get Workspace","operationId":"get_workspace_api_v1_admin_workspaces__workspace_id__get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Workspace Api V1 Admin Workspaces  Workspace Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/workspaces/{workspace_id}/archive":{"post":{"tags":["admin"],"summary":"Archive Workspace","operationId":"archive_workspace_api_v1_admin_workspaces__workspace_id__archive_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Archive Workspace Api V1 Admin Workspaces  Workspace Id  Archive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/workspaces/{workspace_id}/force-delete":{"post":{"tags":["admin"],"summary":"Force Delete Workspace","operationId":"force_delete_workspace_api_v1_admin_workspaces__workspace_id__force_delete_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Force Delete Workspace Api V1 Admin Workspaces  Workspace Id  Force Delete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/metrics/usage":{"get":{"tags":["admin"],"summary":"Usage Over Time","description":"Platform-wide judge token spend bucketed by day, plus the\n``quota_exceeded`` rejection count for the window. ``bucket`` is\nreserved for future granularity — only ``day`` is supported today.","operationId":"usage_over_time_api_v1_admin_metrics_usage_get","parameters":[{"name":"window","in":"query","required":false,"schema":{"enum":["7d","30d","90d"],"type":"string","default":"30d","title":"Window"}},{"name":"bucket","in":"query","required":false,"schema":{"const":"day","type":"string","default":"day","title":"Bucket"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Usage Over Time Api V1 Admin Metrics Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/metrics/top-workspaces":{"get":{"tags":["admin"],"summary":"Top Workspaces","description":"Per-workspace spend ranking over ``window``, with the OWNER's resolved\njudge-token budget and current-month pooled headroom (capacity is per user,\nADR 0007 — same resolution as ``services.quota.check_quota``).","operationId":"top_workspaces_api_v1_admin_metrics_top_workspaces_get","parameters":[{"name":"window","in":"query","required":false,"schema":{"enum":["7d","30d","90d"],"type":"string","default":"30d","title":"Window"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Top Workspaces Api V1 Admin Metrics Top Workspaces Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/metrics/signup-sources":{"get":{"tags":["admin"],"summary":"Signup Sources","description":"Signup counts grouped by source tag (issue #95), most-used tag first.\n\nUntagged signups are omitted — see ``services.admin.signup_sources``.","operationId":"signup_sources_api_v1_admin_metrics_signup_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response Signup Sources Api V1 Admin Metrics Signup Sources Get"}}}}}}},"/api/v1/admin/audit":{"get":{"tags":["admin"],"summary":"List Audit","operationId":"list_audit_api_v1_admin_audit_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Audit Api V1 Admin Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/owner-tokens":{"get":{"tags":["owner-tokens"],"summary":"List Owner Tokens","operationId":"list_owner_tokens_api_v1_owner_tokens_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OwnerTokenList"}}}}}}},"/api/v1/owner-tokens/{token_id}/revoke":{"post":{"tags":["owner-tokens"],"summary":"Revoke Owner Token","operationId":"revoke_owner_token_api_v1_owner_tokens__token_id__revoke_post","parameters":[{"name":"token_id","in":"path","required":true,"schema":{"type":"string","title":"Token Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Owner Token Api V1 Owner Tokens  Token Id  Revoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/device/code":{"post":{"tags":["device"],"summary":"Create Code","description":"Start the device flow: mint a device-code / user-code pair (unauthenticated).","operationId":"create_code_api_v1_device_code_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceCodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Code Api V1 Device Code Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/device/token":{"post":{"tags":["device"],"summary":"Poll Token","description":"Poll for the owner token (unauthenticated); pending/slow_down/expired/success.","operationId":"poll_token_api_v1_device_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceTokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Poll Token Api V1 Device Token Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/device/lookup":{"post":{"tags":["device"],"summary":"Lookup","description":"Preview what a user code is asking for, before approval (session-authenticated).","operationId":"lookup_api_v1_device_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Lookup Api V1 Device Lookup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/device/approve":{"post":{"tags":["device"],"summary":"Approve","description":"Approve a device code, binding it to the signed-in owner (session + CSRF).","operationId":"approve_api_v1_device_approve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Approve Api V1 Device Approve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manage/workspaces":{"get":{"tags":["manage"],"summary":"List Workspaces","operationId":"list_workspaces_api_v1_manage_workspaces_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Workspaces Api V1 Manage Workspaces Get"}}}}}},"post":{"tags":["manage"],"summary":"Create Workspace","operationId":"create_workspace_api_v1_manage_workspaces_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/strata_web__api__manage__CreateWorkspaceRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Workspace Api V1 Manage Workspaces Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manage/workspaces/{workspace_id}/setup":{"get":{"tags":["manage"],"summary":"Get Setup","description":"Recommended-agent-setup blocks — the owner-token mirror of the Console\nConnect route (:mod:`strata_web.api.console.connect`).\n\nThin over the SAME :func:`connect_setup.setup_blocks` the Console route\nserves — no new rendering. The tenant gate is identical (``(id, owner)`` /\n404-no-oracle, §9); the blocks are workspace-generic and **secret-free** (no\nAgent key), so this is one workspace-level read. It exists so the\n``memfleet`` CLI's owner-token path can fetch the hosted Stop-hook blocks it\ninstalls, without the Console's cookie+CSRF plane.","operationId":"get_setup_api_v1_manage_workspaces__workspace_id__setup_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Setup Api V1 Manage Workspaces  Workspace Id  Setup Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manage/workspaces/{workspace_id}/scopes":{"get":{"tags":["manage"],"summary":"List Scopes","operationId":"list_scopes_api_v1_manage_workspaces__workspace_id__scopes_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Scopes Api V1 Manage Workspaces  Workspace Id  Scopes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["manage"],"summary":"Define Scope","operationId":"define_scope_api_v1_manage_workspaces__workspace_id__scopes_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefineScopeRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Define Scope Api V1 Manage Workspaces  Workspace Id  Scopes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manage/workspaces/{workspace_id}/scopes/{scope_id}/skill-body":{"get":{"tags":["manage"],"summary":"Get Skill Body","description":"The scope's skill body — the owner-token mirror of the Console GET (#73).\n\nThin over the SAME :func:`skill_bodies.get_skill_body` service; identical\ntenant gate (``(id, owner)`` / 404-no-oracle) and payload (``skill`` from the\nscope's declaration, ``content``/``updated_at`` or ``None``). This is the\nfetch the ``memfleet`` CLI's owner-token path makes at connect to install the\nbody alongside the Stop-hook. Secret-free — plain owner-authored text only.","operationId":"get_skill_body_api_v1_manage_workspaces__workspace_id__scopes__scope_id__skill_body_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Skill Body Api V1 Manage Workspaces  Workspace Id  Scopes  Scope Id  Skill Body Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manage/workspaces/{workspace_id}/agents":{"get":{"tags":["manage"],"summary":"List Agents","operationId":"list_agents_api_v1_manage_workspaces__workspace_id__agents_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Agents Api V1 Manage Workspaces  Workspace Id  Agents Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["manage"],"summary":"Create Agent","operationId":"create_agent_api_v1_manage_workspaces__workspace_id__agents_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Agent Api V1 Manage Workspaces  Workspace Id  Agents Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manage/workspaces/{workspace_id}/agents/{agent_id}/keys":{"post":{"tags":["manage"],"summary":"Mint Agent Key","description":"Mint a key for an EXISTING Registered Agent — the owner-token mirror of the\nConsole mint (:func:`strata_web.api.console.agents.mint_key`).\n\nThin over the SAME :func:`agents_service.mint_agent_key`, so the tenant gate\n(``(id, owner)`` / 404-no-oracle for a foreign or unknown workspace or agent),\nthe ADR 0004 expiry semantics, and the ``agent.key.mint`` audit row are\nidentical to the Console action. The response carries the plaintext Agent key\nexactly once — it is never stored (only its SHA-256 hash is) and never logged.\nThis is the mint the ``memfleet`` client's ``run`` uses to bind a session to an\nagent that already exists but has no local key.","operationId":"mint_agent_key_api_v1_manage_workspaces__workspace_id__agents__agent_id__keys_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MintAgentKeyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mint Agent Key Api V1 Manage Workspaces  Workspace Id  Agents  Agent Id  Keys Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manage/workspaces/{workspace_id}/agents/{agent_id}/revoke":{"post":{"tags":["manage"],"summary":"Revoke Agent","description":"Revoke (soft-delete) a Registered Agent — receipts/provenance survive (§10).","operationId":"revoke_agent_api_v1_manage_workspaces__workspace_id__agents__agent_id__revoke_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Agent Api V1 Manage Workspaces  Workspace Id  Agents  Agent Id  Revoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manage/workspaces/{workspace_id}/enrollment-codes":{"get":{"tags":["manage"],"summary":"List Enrollment Codes","operationId":"list_enrollment_codes_api_v1_manage_workspaces__workspace_id__enrollment_codes_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Enrollment Codes Api V1 Manage Workspaces  Workspace Id  Enrollment Codes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["manage"],"summary":"Create Enrollment Code","operationId":"create_enrollment_code_api_v1_manage_workspaces__workspace_id__enrollment_codes_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEnrollmentCodeRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Enrollment Code Api V1 Manage Workspaces  Workspace Id  Enrollment Codes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manage/workspaces/{workspace_id}/enrollment-codes/{code_id}/revoke":{"post":{"tags":["manage"],"summary":"Revoke Enrollment Code","operationId":"revoke_enrollment_code_api_v1_manage_workspaces__workspace_id__enrollment_codes__code_id__revoke_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"code_id","in":"path","required":true,"schema":{"type":"string","title":"Code Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Enrollment Code Api V1 Manage Workspaces  Workspace Id  Enrollment Codes  Code Id  Revoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/billing":{"get":{"tags":["billing"],"summary":"Get Billing","operationId":"get_billing_api_v1_billing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Billing Api V1 Billing Get"}}}}}}},"/api/v1/billing/checkout":{"post":{"tags":["billing"],"summary":"Start Checkout","operationId":"start_checkout_api_v1_billing_checkout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Start Checkout Api V1 Billing Checkout Post"}}}}}}},"/api/v1/billing/portal":{"post":{"tags":["billing"],"summary":"Open Portal","operationId":"open_portal_api_v1_billing_portal_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Open Portal Api V1 Billing Portal Post"}}}}}}},"/api/v1/billing/webhook":{"post":{"tags":["billing-webhook"],"summary":"Billing Webhook","operationId":"billing_webhook_api_v1_billing_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Billing Webhook Api V1 Billing Webhook Post"}}}}}}},"/agent/v1/register":{"post":{"tags":["agent"],"summary":"Register","operationId":"register_agent_v1_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Register Agent V1 Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent/v1/me":{"get":{"tags":["agent"],"summary":"Me","operationId":"me_agent_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Me Agent V1 Me Get"}}}}}}},"/agent/v1/scopes":{"get":{"tags":["agent"],"summary":"List Scopes","description":"Active fleet topology — exactly ``strata_list_scopes``' shape (§6.2).","operationId":"list_scopes_agent_v1_scopes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Scopes Agent V1 Scopes Get"}}}}}}},"/agent/v1/skill-body":{"get":{"tags":["agent"],"summary":"Read Skill Body","description":"This agent's BOUND scope's skill body — ``{skill, content, updated_at}``.\n\nThe Agent-key door onto the same payload the Console and manage GETs serve\n(:func:`~strata_web.services.skill_bodies.read_scope_skill_body`), so the\n``memfleet`` client can install the skill at bind time with no owner token\nand a hand-wired session can fetch it directly. The bearer key resolves both\nthe workspace and the scope, so there is nothing for the caller to name.\n\nLogs **no read receipt**: a skill body is a hosting artifact, not memory\n(ADR 0005) — receipts record what an agent has seen of a scope's *memory*.","operationId":"read_skill_body_agent_v1_skill_body_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Read Skill Body Agent V1 Skill Body Get"}}}}}}},"/agent/v1/perspective":{"get":{"tags":["agent"],"summary":"Read Perspective","operationId":"read_perspective_agent_v1_perspective_get","parameters":[{"name":"scope_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Read Perspective Agent V1 Perspective Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent/v1/scopes/{scope_id}/summary":{"get":{"tags":["agent"],"summary":"Read Summary","operationId":"read_summary_agent_v1_scopes__scope_id__summary_get","parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Read Summary Agent V1 Scopes  Scope Id  Summary Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent/v1/scopes/{scope_id}/record":{"get":{"tags":["agent"],"summary":"Read Record","operationId":"read_record_agent_v1_scopes__scope_id__record_get","parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Read Record Agent V1 Scopes  Scope Id  Record Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent/v1/contribute":{"post":{"tags":["agent"],"summary":"Contribute","description":"Thin layer over :func:`~strata_web.services.contribution.submit_contribution`\n(architecture §6: \"Both doors are thin layers over one service\") — the\n``/mcp`` ``strata_contribute`` tool calls the exact same function.","operationId":"contribute_agent_v1_contribute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Contribute Agent V1 Contribute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent/v1/publish":{"post":{"tags":["agent"],"summary":"Publish","description":"Propose publishing content from this agent's bound scope's own memory.\n\nThin layer over :func:`~strata_web.services.publication.submit_publish` —\nthe ``/mcp`` ``strata_publish`` tool calls the exact same function.","operationId":"publish_agent_v1_publish_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Publish Agent V1 Publish Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent/v1/withdraw":{"post":{"tags":["agent"],"summary":"Withdraw","description":"Propose withdrawing a published item from this agent's bound scope.\n\nThin layer over :func:`~strata_web.services.publication.submit_withdraw` —\nthe ``/mcp`` ``strata_withdraw`` tool calls the exact same function.","operationId":"withdraw_agent_v1_withdraw_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Withdraw Agent V1 Withdraw Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent/v1/session-stats":{"get":{"tags":["agent"],"summary":"Get Session Stats","description":"This agent's read/contribute asymmetry counters + the engine nudge.\n\nThe hosted analogue of ``strata_session_stats`` (Strata #110): a cheap,\nmechanical self-query the agent runs with its OWN bearer key — the bearer\ndependency resolves the agent, so a key only ever sees its own counters.\nFeeds the consumer-side turn-boundary hook (#51).","operationId":"get_session_stats_agent_v1_session_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Session Stats Agent V1 Session Stats Get"}}}}}}},"/agent/v1/session-closeout":{"post":{"tags":["agent"],"summary":"Post Session Closeout","description":"Record that this agent has nothing to contribute — a MECHANICAL act.\n\nMirrors ``strata.mcp.server.strata_session_closeout``: NO scope-manager, NO\njudge call, zero judge-token cost, nothing enters any scope's memory. It only\nappends a ``session_closeouts`` row — the asymmetry's release valve — which\nresets the read/contribute gap and silences the read-time nudge. Returns the\nnow-reset counters (the same shape as ``/session-stats``).","operationId":"post_session_closeout_agent_v1_session_closeout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionCloseoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Session Closeout Agent V1 Session Closeout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/":{"get":{"summary":"Spa Root","operationId":"spa_root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/{full_path}":{"get":{"summary":"Spa Fallback","operationId":"spa_fallback__full_path__get","parameters":[{"name":"full_path","in":"path","required":true,"schema":{"type":"string","title":"Full Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CompGrantRequest":{"properties":{"plan":{"type":"string","title":"Plan"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["plan"],"title":"CompGrantRequest","description":"Grant a comp: a paid plan id, optionally expiring at an ISO8601 time\n(``null`` = no expiry). Both are validated in the service layer (422)."},"ContributeRequest":{"properties":{"scope_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope Id"},"content":{"type":"string","minLength":1,"title":"Content"},"proposed_classification":{"type":"string","enum":["directive","context"],"title":"Proposed Classification"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"supersedes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supersedes"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["content","proposed_classification"],"title":"ContributeRequest","description":"A proposed write (§6.1) — provenance is always server-derived (§5.2)."},"CreateAgentRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"scope_id":{"type":"string","minLength":1,"title":"Scope Id"},"skill":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skill"}},"type":"object","required":["name","scope_id"],"title":"CreateAgentRequest"},"CreateEnrollmentCodeRequest":{"properties":{"allowed_scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Scopes"},"default_skill":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Skill"},"max_uses":{"type":"integer","minimum":1.0,"title":"Max Uses","default":1},"ttl_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Hours"}},"type":"object","title":"CreateEnrollmentCodeRequest"},"DefineScopeRequest":{"properties":{"id":{"type":"string","maxLength":200,"minLength":1,"title":"Id"},"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"stratum_id":{"type":"string","maxLength":200,"minLength":1,"title":"Stratum Id"},"default_skill":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Skill"},"permitted_skills":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Permitted Skills"},"parent_scope_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Scope Id"}},"type":"object","required":["id","name","stratum_id"],"title":"DefineScopeRequest"},"DeviceCodeRequest":{"properties":{"client_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Client Name"}},"type":"object","title":"DeviceCodeRequest","description":"Optional label the client gives itself; shown at approval and becomes the\nowner token's name."},"DeviceTokenRequest":{"properties":{"device_code":{"type":"string","minLength":1,"title":"Device Code"}},"type":"object","required":["device_code"],"title":"DeviceTokenRequest"},"ForgotPasswordRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"ForgotPasswordRequest","description":"The email to send a reset link to — deliberately unvalidated beyond\nshape (like ``SigninRequest``), so the route reveals nothing about whether\nthe address is registered. Normalised to match how emails are stored."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InviteMemberRequest":{"properties":{"email":{"type":"string","maxLength":320,"minLength":1,"title":"Email"},"role":{"type":"string","title":"Role","default":"collaborator"}},"type":"object","required":["email"],"title":"InviteMemberRequest"},"MintAgentKeyRequest":{"properties":{"revoke_others":{"type":"boolean","title":"Revoke Others","default":false},"expires_in_days":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Expires In Days","default":90}},"type":"object","title":"MintAgentKeyRequest"},"MintKeyRequest":{"properties":{"revoke_others":{"type":"boolean","title":"Revoke Others","default":false},"expires_in_days":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Expires In Days","default":90}},"type":"object","title":"MintKeyRequest"},"OwnerTokenList":{"properties":{"tokens":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tokens"}},"type":"object","required":["tokens"],"title":"OwnerTokenList"},"PublishOperatorItemRequest":{"properties":{"content":{"type":"string","minLength":1,"title":"Content"},"kind":{"type":"string","enum":["directive","context"],"title":"Kind"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"}},"type":"object","required":["content","kind"],"title":"PublishOperatorItemRequest"},"PublishRequest":{"properties":{"content":{"type":"string","minLength":1,"title":"Content"},"kind":{"type":"string","enum":["directive","context"],"title":"Kind"},"anchors":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Anchors"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["content","kind","anchors"],"title":"PublishRequest","description":"A proposed publish act (ADR 0007 D2) on the agent's OWN bound scope.\n\nNo ``scope_id`` — there is no publishing upward or sideways (ADR 0007 D2);\nthe act always targets the caller's bound scope. Mirrors the engine's\n``strata_publish`` tool shape."},"PutFleetRequest":{"properties":{"yaml":{"type":"string","minLength":0,"title":"Yaml"}},"type":"object","required":["yaml"],"title":"PutFleetRequest"},"PutSkillBodyRequest":{"properties":{"content":{"type":"string","title":"Content"},"skill":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skill"}},"type":"object","required":["content"],"title":"PutSkillBodyRequest"},"QuotaOverrideRequest":{"properties":{"quota_daily_tokens":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Quota Daily Tokens"},"quota_monthly_tokens":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Quota Monthly Tokens"}},"type":"object","required":["quota_daily_tokens","quota_monthly_tokens"],"title":"QuotaOverrideRequest","description":"Full-replace capacity override in weighted judge tokens (ADR 0007):\n``null`` clears that field back to the user's plan budget."},"RegisterRequest":{"properties":{"code":{"type":"string","minLength":1,"title":"Code"},"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"scope_id":{"type":"string","minLength":1,"title":"Scope Id"},"skill":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skill"}},"type":"object","required":["code","name","scope_id"],"title":"RegisterRequest","description":"Enrollment-code redemption (§5.2, no bearer token yet)."},"RenameWorkspaceRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"}},"type":"object","required":["name"],"title":"RenameWorkspaceRequest"},"ResetPasswordRequest":{"properties":{"token":{"type":"string","title":"Token"},"new_password":{"type":"string","maxLength":1024,"minLength":8,"title":"New Password"}},"type":"object","required":["token","new_password"],"title":"ResetPasswordRequest","description":"The opaque token from the ``{PUBLIC_BASE_URL}/reset-password?token=...``\nlink plus the new password (same minimum as signup)."},"SessionCloseoutRequest":{"properties":{"reason":{"type":"string","minLength":1,"title":"Reason"}},"type":"object","required":["reason"],"title":"SessionCloseoutRequest","description":"A mechanical \"nothing to record\" decline (strata-web #50 deliverable 2).\n\nMirrors ``strata.mcp.server.strata_session_closeout``: a required ``reason``\nkeeps the decline a deliberate act. No judge, no quota, no metering."},"SigninRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"SigninRequest","description":"Signin credentials — deliberately unvalidated beyond shape, so every\nfailure is the same generic 401 ``invalid_credentials``."},"SignupRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","maxLength":1024,"minLength":8,"title":"Password"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["email","password"],"title":"SignupRequest","description":"Signup credentials: valid email shape, password of at least 8 chars.\n\n``source`` is the optional signup source tag (issue #95) the Console read\nfrom the landing URL's ``?src=``. It is attribution, never a credential or\na permission, and it arrives from a URL anyone can edit — so a tag that\nfails validation is silently dropped to ``None`` instead of raising: a\nmalformed or hostile ``?src=`` must never cost a real signup."},"SupersedeOperatorItemRequest":{"properties":{"content":{"type":"string","minLength":1,"title":"Content"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"}},"type":"object","required":["content"],"title":"SupersedeOperatorItemRequest"},"UpdateAgentRequest":{"properties":{"status":{"anyOf":[{"type":"string","enum":["active","disabled"]},{"type":"null"}],"title":"Status"},"name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Name"}},"type":"object","title":"UpdateAgentRequest"},"UserCodeRequest":{"properties":{"user_code":{"type":"string","maxLength":64,"minLength":1,"title":"User Code"}},"type":"object","required":["user_code"],"title":"UserCodeRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyEmailRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"VerifyEmailRequest","description":"The opaque token from the ``{PUBLIC_BASE_URL}/verify-email?token=...`` link."},"WithdrawRequest":{"properties":{"item_id":{"type":"string","minLength":1,"title":"Item Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["item_id"],"title":"WithdrawRequest","description":"A proposed withdraw act (ADR 0007 D2) on the agent's OWN bound scope."},"strata_web__api__console__workspaces__CreateWorkspaceRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"template":{"type":"string","enum":["minimal","dev-team","support-org","research-group"],"title":"Template","default":"minimal"}},"type":"object","required":["name"],"title":"CreateWorkspaceRequest","description":"Workspace creation: display name + bundled Strata template (§7.1)."},"strata_web__api__manage__CreateWorkspaceRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"template":{"type":"string","title":"Template","default":"minimal"}},"type":"object","required":["name"],"title":"CreateWorkspaceRequest"}}}}