{"openapi":"3.1.0","info":{"title":"ZeroDB API","description":"ZeroDB — the AI-native serverless database. Vector search, agent memory, NoSQL tables, event streaming, file storage, embeddings, and managed PostgreSQL in one unified API.","version":"1.0.0"},"paths":{"/api/v1/auth/register":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Register User","description":"Register new user with email verification\n\n- Validates password strength (with structured error messages)\n- Hashes password with bcrypt (cost factor 12)\n- Stores user in ZeroDB (atomic INSERT with ON CONFLICT)\n- Sends verification email (non-blocking)\n- Sets SSO cookie for cross-subdomain auth\n- Returns JWT access token + refresh token\n\nFixes #2973: 49% signup error rate caused by:\n1. Unhandled email service exceptions crashing registration\n2. Race condition on email uniqueness (check-then-insert)\n3. NULL workspace_id when workspaces table is empty\n4. Overly strict password validation without clear feedback\n5. Required 'name' field when frontend sometimes sends empty string","operationId":"register_user_api_v1_auth_register_post","parameters":[{"name":"x-internal-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Internal-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__auth__TokenResponse"}}}},"400":{"description":"Password does not meet strength requirements","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"402":{"description":"Card-gated trial fraud screen blocked signup","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"409":{"description":"An account with this email already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Signup rejected as bot or undeliverable email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Registration failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/create-trial-checkout":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Create Trial Checkout","description":"Create a Stripe Checkout session for a card-gated 3-day free trial (Refs #5761).\n\nFlow: /signup collects email/password -> calls this -> redirect user to the\nreturned checkout_url (card required) -> on success Stripe returns to\n/signup?stripe_session_id={CHECKOUT_SESSION_ID} to finalize the account.\n(The landing page is /signup — it reads stripe_session_id and calls\nregister(). There is no /auth/register page on the website; using it 404'd\nthe user right after they paid. Refs #6418)\n\nThe Stripe price follows the SELECTED plan (``body.plan``): normalized via\nPLAN_ALIASES → STRIPE_PRICE_IDS, defaulting to Hobbyist $5/mo when no/unknown\nplan is sent (so callers that don't pass a plan keep the prior behavior).\nPreviously this was hardcoded to Hobbyist, so a user picking Pro/Business was\nunder-charged and landed on the wrong tier (Refs #6618). The subscription tier\nis derived downstream from this price by the Stripe webhook, so the chosen plan\nflows to the DB subscription row. 3-day trial (#128) for all plans. Card is\nforced up front and the trial cancels if no card is attached (anti-farming,\nhandled inside stripe_service.create_checkout_session — Refs #5171, #5499).","operationId":"create_trial_checkout_api_v1_auth_create_trial_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTrialCheckoutResponse"}}}},"400":{"description":"Invalid provider or missing required Builder plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"502":{"description":"Could not start trial checkout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/create-trial-checkout-embedded":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Create Trial Checkout Embedded","description":"Create an EMBEDDED Stripe Checkout session for the card-gated trial (#5964 Phase 2).\n\nSame trial + card-forcing + customer-dedup as /create-trial-checkout, but in\n``ui_mode='embedded'`` — returns a ``client_secret`` the website mounts with\nStripe's so card entry (with Link one-click) never leaves\nour domain. On completion Stripe redirects to the return_url with the session\nid, which /signup verifies exactly as the hosted flow does — so the\n#5843 session verify + #5955 velocity guard are unchanged.\n\nThe Stripe price follows the selected ``body.plan`` (Refs #6618), defaulting to\nHobbyist when unset/unknown — same resolution as the hosted flow.","operationId":"create_trial_checkout_embedded_api_v1_auth_create_trial_checkout_embedded_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTrialCheckoutEmbeddedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"502":{"description":"Could not start trial checkout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/merge-identity":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Merge Identity","description":"Merge a temporary InstantDB identity into the authenticated user's account.\n\nMigrates all projects, API keys, and data from the temp user to the real user,\nthen deactivates the temp user. Requires the tmp_ API key as proof of ownership.\n\nRefs #5029","operationId":"merge_identity_api_v1_auth_merge_identity_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MergeIdentityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MergeIdentityResponse"}}}},"400":{"description":"Invalid key, inactive user, or identity cannot be merged into itself","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Temporary API key not found or already deactivated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Identity merge failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Authentication temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/login":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Login User","description":"Login user with email/username and password\n\nAccepts both 'email' and 'username' fields for maximum flexibility (Issue #993).\n\n- Verifies password hash\n- Checks email verified status\n- Generates JWT tokens (access + refresh)\n- Sets SSO cookie for cross-subdomain auth\n- Returns tokens + user info","operationId":"login_user_api_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__auth__LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__auth__TokenResponse"}}}},"401":{"description":"Incorrect email or password","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Email not verified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/send-phone-otp":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Send Phone Otp","description":"Send a 6-digit SMS verification code to a phone number (Refs #8459).\n\n`purpose` must be \"register\" or \"login\" — register-phone/login-phone each\nverify against the matching purpose's code only, so a code issued for one\ncannot be replayed for the other. Rate-limited per-IP (decorator) AND\nper-phone-number (PhoneOtpService, independent of caller IP) since an\nattacker can rotate IPs but not phone numbers as cheaply.","operationId":"send_phone_otp_api_v1_auth_send_phone_otp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendPhoneOtpRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendPhoneOtpResponse"}}}},"400":{"description":"Invalid phone number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too many codes requested for this number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to send verification code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"SMS verification is not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/register-phone":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Register Phone","description":"Register a new user with ONLY a verified phone number — no email, no\npassword (Refs #8459). Returns the SAME TokenResponse shape as /register\n(access + refresh JWT) so downstream session handling is unchanged.\n\nHonors signup_source/ext attribution the same way /register does\n(resolve_signup_client_id, core#8280/#8424) so Builder's ad-attribution\npipeline keeps working for phone-identity signups.","operationId":"register_phone_api_v1_auth_register_phone_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneRegisterRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__auth__TokenResponse"}}}},"400":{"description":"Invalid phone number or OTP code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"409":{"description":"An account with this phone already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Registration failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/login-phone":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Login Phone","description":"Log in with a verified phone number + OTP code instead of a password\n(Refs #8459). Issues the same JWT pair /login does.","operationId":"login_phone_api_v1_auth_login_phone_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__auth__TokenResponse"}}}},"400":{"description":"Invalid OTP code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No account found for this phone number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/logout":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Logout User","description":"Logout user by blacklisting token\n\n- Adds token to blacklist in ZeroDB\n- Clears SSO cookie\n- Clears any sessions","operationId":"logout_user_api_v1_auth_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogoutResponse"}}}},"401":{"description":"Not authenticated or token invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/refresh":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Refresh Token","description":"Refresh access token\n\n- Verifies refresh token validity\n- Generates new access token\n- Updates SSO cookie\n- Returns new token","operationId":"refresh_token_api_v1_auth_refresh_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenRefreshRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshTokenResponse"}}}},"401":{"description":"Invalid or expired refresh token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/magic-link":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Send Magic Link","description":"Send a passwordless magic link email via Stytch (Issue #3866)\n\n- Looks up active Stytch config in auth_provider_configs for the user's tenant\n- Calls Stytch API to send the magic link email\n- Returns confirmation that the email was sent","operationId":"send_magic_link_api_v1_auth_magic_link_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MagicLinkRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MagicLinkSentResponse"}}}},"400":{"description":"Missing email or Stytch not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to send magic link","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"502":{"description":"Stytch magic link send failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/magic-link/verify":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Verify Magic Link","description":"Verify a Stytch magic link token and issue AINative JWT tokens (Issue #3866)\n\n- Authenticates the token with Stytch API\n- Finds or creates the user by email\n- Issues AINative access + refresh tokens\n- Sets SSO cookie for cross-subdomain auth","operationId":"verify_magic_link_api_v1_auth_magic_link_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MagicLinkVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__auth__TokenResponse"}}}},"400":{"description":"Missing token, Stytch not configured, or email not resolvable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Invalid or expired magic link token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Magic link verification failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/me":{"get":{"tags":["Authentication v1","Authentication"],"summary":"Get Current User Info","description":"Get current authenticated user.\n\nAccepts JWT Bearer token OR X-API-Key (for trial keys issued by provision-trial).\nReturns full user profile including plan and trial_expires_at (Refs #2962).","operationId":"get_current_user_info_api_v1_auth_me_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__auth_v1__CurrentUserResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/me/profile":{"put":{"tags":["Authentication v1","Authentication"],"summary":"Update Profile","description":"Update current user's profile settings.\n\nSupports partial updates — only provided fields are changed.\nUse profile_visibility='public' to appear on the community page.\n\nRefs #2395","operationId":"update_profile_api_v1_auth_me_profile_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProfileResponse"}}}},"400":{"description":"No fields to update or invalid field value","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to update profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/me/email-change/request":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Request Email Change","description":"Begin an email change: generates a confirmation token, emails a\nconfirmation link to the NEW address (never the current one — this is\nwhat proves the caller actually controls the new inbox), and stores the\ntoken so it can be marked used exactly once.\n\nThe account's email is NOT changed yet. That only happens once\n/me/email-change/confirm is called with a valid, unused, unexpired\ntoken — matching reset_password's \"token proves the request, a\nseparate step applies it\" shape.\n\nRefs ainative-ax#167","operationId":"request_email_change_api_v1_auth_me_email_change_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestEmailChangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestEmailChangeResponse"}}}},"400":{"description":"New email already in use, or same as current email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/me/email-change/confirm":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Confirm Email Change","description":"Confirm a pending email change using the token from the confirmation\nemail, and apply it to the account.\n\nDeliberately NOT behind get_current_user: the confirmation link is\nclicked from an email client, which has no reason to carry the user's\nAX Audit session — same reasoning as reset_password, which verifies the\ncaller via the signed token alone, not a bearer session.\n\nRefs ainative-ax#167","operationId":"confirm_email_change_api_v1_auth_me_email_change_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmEmailChangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmEmailChangeResponse"}}}},"400":{"description":"Invalid, expired, or already-used confirmation token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/verify-email":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Verify Email","description":"Verify user email with token (JSON body). Used by the frontend page.","operationId":"verify_email_api_v1_auth_verify_email_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerificationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailResponse"}}}},"400":{"description":"Invalid verification token or already verified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Verification token expired or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"get":{"tags":["Authentication v1","Authentication"],"summary":"Verify Email Link","description":"Verify via a direct email-link click (GET with ?token=). The verification\nemail link is a browser GET, so this must exist — a POST-only endpoint\nreturned 405 and blocked every signup. Redirects to the frontend success or\nfailure page so the user sees a proper screen (not raw JSON). Refs #5578.","operationId":"verify_email_link_api_v1_auth_verify_email_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"307":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/resend-verification":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Resend Verification","description":"Resend the email-verification link (Refs #5508).\n\nPaired with the login gate: an unverified user is told to \"request a new\none\" — this is that endpoint. Privacy-preserving: always returns the same\nmessage whether or not the email exists / is already verified, so it can't\nbe used to enumerate accounts. No-op for already-verified or unknown emails.","operationId":"resend_verification_api_v1_auth_resend_verification_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendVerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/forgot-password":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Forgot Password","description":"Request password reset\n\n- Generates reset token\n- Sends reset email\n- Stores token in ZeroDB with expiry\n\nNote: Always returns success for security (don't reveal if email exists)","operationId":"forgot_password_api_v1_auth_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/reset-password":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Reset Password","description":"Reset password with token\n\n- Verifies reset token\n- Validates password strength\n- Hashes new password\n- Updates user in ZeroDB\n- Invalidates reset token","operationId":"reset_password_api_v1_auth_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__auth__ResetPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordResponse"}}}},"400":{"description":"Invalid, expired, or already-used reset token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Reset token invalid or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/linkedin/callback":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Linkedin Oauth Callback","description":"Handle LinkedIn OAuth callback (Issue #413)\n\nExchange authorization code for access token and user info.\nCreates or updates user account with LinkedIn information.\n\nLinkedIn uses OpenID Connect (OIDC) for authentication:\n- Token endpoint: https://www.linkedin.com/oauth/v2/accessToken\n- UserInfo endpoint: https://api.linkedin.com/v2/userinfo\n\nRequired scopes: openid, profile, email","operationId":"linkedin_oauth_callback_api_v1_auth_linkedin_callback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__auth__LinkedInOAuthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__auth__LinkedInUserResponse"}}}},"400":{"description":"Invalid code, token exchange failed, or missing LinkedIn email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"LinkedIn OAuth not configured or callback failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/github/callback":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Github Oauth Callback","description":"Handle GitHub OAuth callback\n\nExchange authorization code for access token and user info.\nCreates or updates user account with GitHub information.","operationId":"github_oauth_callback_api_v1_auth_github_callback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__auth__GitHubOAuthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__auth__GitHubUserResponse"}}}},"400":{"description":"Invalid code, token exchange failed, or missing GitHub email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"GitHub OAuth not configured or callback failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/google/callback":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Google Oauth Callback","description":"Handle Google OAuth callback.\nExchange authorization code for access token and user info.\nCreates or updates user account with Google information.","operationId":"google_oauth_callback_api_v1_auth_google_callback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleOAuthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__auth__GitHubUserResponse"}}}},"400":{"description":"Invalid code, token exchange failed, or missing Google email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Google OAuth not configured or callback failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/change-password":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Change Password","description":"Change user password (Issue #1013)\n\nSecurity features:\n- Requires authentication\n- Verifies current password\n- Validates new password strength\n- Prevents reuse of current password\n- Rate limited to 5 changes per hour\n- Logs password change events\n\nReturns:\n PasswordChangeResponse with success message and timestamp\n\nRaises:\n 401: Current password is incorrect\n 400: New password is weak or same as current\n 429: Rate limit exceeded","operationId":"change_password_api_v1_auth_change_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordChangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordChangeResponse"}}}},"400":{"description":"New password weak or same as current","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Not authenticated, or current password incorrect","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to change password","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/security-settings":{"get":{"tags":["Authentication v1","Authentication"],"summary":"Get Security Settings","description":"Get comprehensive security settings for current user (Issue #1013)\n\nReturns:\n - Email and verification status\n - 2FA configuration (masked phone, status, backup codes count)\n - Last password change timestamp\n - Account creation date\n\nSecurity:\n - Requires authentication\n - Only returns current user's settings\n - Sensitive data (passwords, full phone numbers) is never exposed\n - Phone numbers are masked (shows last 4 digits only)","operationId":"get_security_settings_api_v1_auth_security_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecuritySettingsResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to retrieve security settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/provision-trial":{"post":{"tags":["Authentication v1","Authentication"],"summary":"Provision Trial Endpoint","description":"Provision a 72-hour trial account for Cody CLI users.\n\nNo authentication required. Creates a real user record, issues an API key,\nand enforces one-trial-per-email / one-trial-per-device deduplication.\n\nRate limited to 3 requests per hour per IP to prevent abuse.\n\nRefs #2963","operationId":"provision_trial_endpoint_api_v1_auth_provision_trial_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialProvisionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialProvisionResponse"}}}},"409":{"description":"A trial account already exists for this email or device","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Missing email or device_id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Trial provisioning failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/mfa/setup":{"post":{"tags":["MFA","MFA"],"summary":"Setup Mfa","description":"Start MFA/TOTP setup for the current user.\n\nReturns:\n- TOTP secret (base32, show once)\n- QR code URI for authenticator apps\n- 10 backup codes (store securely, shown once)\n\nThe user must call /auth/mfa/verify-setup with a valid code\nto finalize activation.\n\nRefs #3860","operationId":"setup_mfa_api_v1_auth_mfa_setup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFASetupResponse"}}}},"401":{"description":"No or invalid authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"409":{"description":"MFA already set up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"MFA setup failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/mfa/verify-setup":{"post":{"tags":["MFA","MFA"],"summary":"Verify Mfa Setup","description":"Verify the first TOTP code to confirm MFA setup.\n\nThe user must enter a code from their authenticator app\nto prove they have correctly configured it.\n\nRefs #3860","operationId":"verify_mfa_setup_api_v1_auth_mfa_verify_setup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFAVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFAVerifyResponse"}}}},"400":{"description":"Invalid verify-setup request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No or invalid authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"MFA verification failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/mfa/verify":{"post":{"tags":["MFA","MFA"],"summary":"Verify Mfa Login","description":"Verify TOTP code during login.\n\nAccepts the short-lived MFA challenge token from the login response.\nOn success, returns full access + refresh tokens.\n\nAlso accepts backup codes as a fallback.\n\nRefs #3860","operationId":"verify_mfa_login_api_v1_auth_mfa_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFAVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFAVerifyResponse"}}}},"401":{"description":"No, invalid, or expired MFA challenge/access token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"MFA locked due to too many failed attempts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"MFA verification failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/mfa/backup-codes":{"post":{"tags":["MFA","MFA"],"summary":"Regenerate Backup Codes","description":"Regenerate backup codes (invalidates old ones).\n\nReturns 10 new codes. Store securely — they will not be shown again.\n\nRefs #3860","operationId":"regenerate_backup_codes_api_v1_auth_mfa_backup_codes_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFABackupCodesResponse"}}}},"400":{"description":"Invalid request (e.g. MFA not enabled)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No or invalid authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Backup code regeneration failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/mfa":{"delete":{"tags":["MFA","MFA"],"summary":"Disable Mfa","description":"Disable MFA for the current user.\n\nRequires password confirmation for security.\n\nRefs #3860","operationId":"disable_mfa_api_v1_auth_mfa_delete","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFADisableRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFADisableResponse"}}}},"400":{"description":"Invalid disable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No or invalid authentication credentials, or incorrect password","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to disable MFA","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/projects/{project_id}/rlhf/interactions":{"post":{"tags":["RLHF Feedback"],"summary":"Log AI interaction","description":"Log an AI interaction for RLHF tracking","operationId":"log_interaction_api_v1_projects__project_id__rlhf_interactions_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__rlhf__InteractionRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InteractionResponse"}}}},"400":{"description":"Malformed authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No valid authentication credentials provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to log interaction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Authentication service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/rlhf/feedback":{"post":{"tags":["RLHF Feedback"],"summary":"Collect user feedback","description":"Collect user feedback on an AI interaction","operationId":"collect_feedback_api_v1_projects__project_id__rlhf_feedback_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__rlhf__FeedbackRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__rlhf__FeedbackResponse"}}}},"400":{"description":"Malformed authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No valid authentication credentials provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Invalid feedback data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to collect feedback","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Authentication service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/rlhf/sessions/{session_id}":{"get":{"tags":["RLHF Feedback"],"summary":"Get session interactions","description":"Get all interactions for a session","operationId":"get_session_interactions_api_v1_projects__project_id__rlhf_sessions__session_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__rlhf__SessionInteractionsResponse"}}}},"400":{"description":"Malformed authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No valid authentication credentials provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to get session interactions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Authentication service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/rlhf/summary":{"get":{"tags":["RLHF Feedback"],"summary":"Get feedback summary","description":"Get aggregate feedback statistics for project","operationId":"get_feedback_summary_api_v1_projects__project_id__rlhf_summary_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Start date (ISO format)","title":"Start Date"},"description":"Start date (ISO format)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"End date (ISO format)","title":"End Date"},"description":"End date (ISO format)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__rlhf__FeedbackSummaryResponse"}}}},"400":{"description":"Malformed authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No valid authentication credentials provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to get feedback summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Authentication service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/rlhf/recommendations/{feature}":{"get":{"tags":["RLHF Feedback"],"summary":"Get feature recommendations","description":"Get RLHF-based recommendations for a specific feature","operationId":"get_feature_recommendations_api_v1_projects__project_id__rlhf_recommendations__feature__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"feature","in":"path","required":true,"schema":{"type":"string","title":"Feature"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{},"title":"Response Get Feature Recommendations Api V1 Projects Project Id Rlhf Recommendations Feature Get"}}}},"400":{"description":"Malformed authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No valid authentication credentials provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to get feature recommendations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Authentication service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/rlhf/reports/generate":{"post":{"tags":["RLHF Feedback"],"summary":"Generate improvement report","description":"Generate improvement report based on feedback analysis","operationId":"generate_improvement_report_api_v1_projects__project_id__rlhf_reports_generate_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImprovementReportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__rlhf__ImprovementReportResponse"}}}},"400":{"description":"Malformed authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"No valid authentication credentials provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to generate improvement report","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Authentication service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/public/code-context-engine/embeddings/{project_id}/{chunk_id}":{"get":{"tags":["Public API","Code Context Engine"],"summary":"Get Embedding","description":"Get embedding for a specific chunk.\n\nGIVEN a chunk ID\nWHEN retrieving its embedding\nTHEN return vector representation","operationId":"get_embedding_api_v1_public_code_context_engine_embeddings__project_id___chunk_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"chunk_id","in":"path","required":true,"schema":{"type":"string","description":"Chunk ID","title":"Chunk Id"},"description":"Chunk ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Embedding Api V1 Public Code Context Engine Embeddings Project Id Chunk Id Get"}}}},"400":{"description":"Inactive user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Embedding not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects":{"get":{"tags":["ZeroDB Projects"],"summary":"List Projects","description":"List all projects for the current user with pagination and filtering\n\nThis endpoint provides comprehensive project listing with:\n- Pagination support (skip/limit)\n- Status and tier filtering\n- Workspace/organization filtering (org_id)\n- Soft-delete awareness\n- Usage metrics included","operationId":"list_projects_api_v1_projects_get","parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of projects to skip","default":0,"title":"Skip"},"description":"Number of projects to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Max projects to return","default":100,"title":"Limit"},"description":"Max projects to return"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(ACTIVE|SUSPENDED|DELETED)$"},{"type":"null"}],"description":"Filter by status","title":"Status"},"description":"Filter by status"},{"name":"tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(free|pro|scale|enterprise)$"},{"type":"null"}],"description":"Filter by tier","title":"Tier"},"description":"Filter by tier"},{"name":"org_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by workspace/organization ID (Refs #4699)","title":"Org Id"},"description":"Filter by workspace/organization ID (Refs #4699)"},{"name":"include_deleted","in":"query","required":false,"schema":{"type":"boolean","description":"Include soft-deleted projects","default":false,"title":"Include Deleted"},"description":"Include soft-deleted projects"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProjectResponse"},"title":"Response List Projects Api V1 Projects Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ZeroDB Projects"],"summary":"Create Project","description":"Create a new project with unified database features\n\nThis endpoint creates a project with:\n- Tier-based feature enablement\n- Automatic quantum/MCP configuration\n- Usage limit validation\n- Database feature initialization","operationId":"create_project_api_v1_projects_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/":{"get":{"tags":["Compatibility Layer","Projects"],"summary":"Api V1 Projects List","description":"List projects with trailing slash - actual implementation (not redirect)","operationId":"api_v1_projects_list_api_v1_projects__get","parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"}},{"name":"org_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"}},{"name":"include_deleted","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Deleted"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ProjectResponse"}},{"$ref":"#/components/schemas/ProjectsFallbackResponse"}],"title":"Response Api V1 Projects List Api V1 Projects Get"}}}},"401":{"description":"No valid authentication credentials provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/list":{"get":{"tags":["Compatibility Layer","Projects"],"summary":"Api V1 Projects List Keyword","description":"Alternative projects list endpoint - actual implementation (not redirect)","operationId":"api_v1_projects_list_keyword_api_v1_projects_list_get","parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"}},{"name":"org_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"}},{"name":"include_deleted","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Deleted"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ProjectResponse"}},{"$ref":"#/components/schemas/ProjectsFallbackResponse"}],"title":"Response Api V1 Projects List Keyword Api V1 Projects List Get"}}}},"401":{"description":"No valid authentication credentials provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Provision Dedicated PostgreSQL Instance","description":"Create a dedicated PostgreSQL instance for the project via Railway","operationId":"provision_dedicated_postgres_api_v1_projects__project_id__postgres_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLProvisionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionPostgresResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not permitted for this project or plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Project or resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"get":{"tags":["ZeroDB PostgreSQL"],"summary":"Get PostgreSQL Instance Status","description":"Get the status and details of the dedicated PostgreSQL instance","operationId":"get_postgres_instance_status_api_v1_projects__project_id__postgres_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLInstanceResponse"}}}},"404":{"description":"Project or resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"delete":{"tags":["ZeroDB PostgreSQL"],"summary":"Delete PostgreSQL Instance","description":"Delete the dedicated PostgreSQL instance and all data","operationId":"delete_postgres_instance_api_v1_projects__project_id__postgres_delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Confirm"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletePostgresResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/connection":{"get":{"tags":["ZeroDB PostgreSQL"],"summary":"Get PostgreSQL Connection Details","description":"Get connection string and credentials for direct SQL access","operationId":"get_postgres_connection_details_api_v1_projects__project_id__postgres_connection_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"credential_type","in":"query","required":false,"schema":{"type":"string","default":"primary","title":"Credential Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLConnectionResponse"}}}},"404":{"description":"Project or resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/postgres/rotate":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Rotate PostgreSQL Credentials","description":"Generate new credentials for the PostgreSQL instance","operationId":"rotate_postgres_credentials_api_v1_projects__project_id__postgres_rotate_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLCredentialRotateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotatePostgresCredentialsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/usage":{"get":{"tags":["ZeroDB PostgreSQL"],"summary":"Get PostgreSQL Usage Statistics","description":"Get detailed usage statistics and billing information","operationId":"get_postgres_usage_statistics_api_v1_projects__project_id__postgres_usage_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLUsageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/restart":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Restart PostgreSQL Instance","description":"Restart the dedicated PostgreSQL instance via Railway deployment restart","operationId":"restart_postgres_instance_api_v1_projects__project_id__postgres_restart_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestartPostgresResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/stop":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Stop PostgreSQL Instance","description":"Stop the dedicated PostgreSQL instance to save costs. Data is preserved.","operationId":"stop_postgres_instance_api_v1_projects__project_id__postgres_stop_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopPostgresResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/start":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Start PostgreSQL Instance","description":"Start a previously stopped PostgreSQL instance.","operationId":"start_postgres_instance_api_v1_projects__project_id__postgres_start_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartPostgresResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/scale":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Scale PostgreSQL Instance","description":"Change the tier (CPU/memory/storage) of a dedicated PostgreSQL instance.","operationId":"scale_postgres_instance_api_v1_projects__project_id__postgres_scale_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLScaleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScalePostgresResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/upgrade":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Upgrade PostgreSQL Version","description":"Upgrade the dedicated PostgreSQL instance to a new major version.","operationId":"upgrade_postgres_version_api_v1_projects__project_id__postgres_upgrade_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLUpgradeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpgradePostgresResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/logs":{"get":{"tags":["ZeroDB PostgreSQL"],"summary":"Get PostgreSQL Query Logs","description":"Get recent SQL query logs and performance data","operationId":"get_postgres_query_logs_api_v1_projects__project_id__postgres_logs_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"query_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgresQueryLogsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/backups":{"get":{"tags":["ZeroDB PostgreSQL"],"summary":"List PostgreSQL Backups","description":"List available backups for a dedicated PostgreSQL instance.","operationId":"list_postgres_backups_api_v1_projects__project_id__postgres_backups_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListPostgresBackupsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Create PostgreSQL Backup","description":"Create an on-demand backup of a dedicated PostgreSQL instance.","operationId":"create_postgres_backup_api_v1_projects__project_id__postgres_backups_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLBackupCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePostgresBackupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/backups/restore":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Restore PostgreSQL Backup","description":"Restore a backup onto the instance (same project + environment).","operationId":"restore_postgres_backup_api_v1_projects__project_id__postgres_backups_restore_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLBackupRestoreRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestorePostgresBackupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/backups/schedule":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Set PostgreSQL Backup Schedule","description":"Enable automated DAILY/WEEKLY/MONTHLY backups (empty list clears).","operationId":"set_postgres_backup_schedule_api_v1_projects__project_id__postgres_backups_schedule_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLBackupScheduleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetPostgresBackupScheduleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/postgres/pitr-restore":{"post":{"tags":["ZeroDB PostgreSQL"],"summary":"Point-in-Time Restore","description":"Restore to a timestamp within the WAL window. Provisions a new sibling instance; source is untouched. Requires PITR enabled.","operationId":"pitr_restore_postgres_api_v1_projects__project_id__postgres_pitr_restore_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostgreSQLPITRRestoreRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PITRRestorePostgresResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}":{"get":{"tags":["ZeroDB Projects"],"summary":"Get Project","description":"Get a specific project by ID\n\nReturns detailed project information including:\n- All configuration settings\n- Usage metrics\n- Database features status\n- Tier limits","operationId":"get_project_api_v1_projects__project_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"include_deleted","in":"query","required":false,"schema":{"type":"boolean","description":"Include soft-deleted project","default":false,"title":"Include Deleted"},"description":"Include soft-deleted project"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["ZeroDB Projects"],"summary":"Update Project","description":"Update a project\n\nSupports updating:\n- Basic project information (name, description)\n- Tier (with automatic feature reconfiguration)\n- Status (ACTIVE, SUSPENDED, DELETED)\n- Database settings\n\nSecurity:\n- Users can only update their own projects\n- A project-scoped API key can only update its OWN project (Refs #7344)\n- Input validation prevents SQL injection\n- Audit log created for all update operations","operationId":"update_project_api_v1_projects__project_id__patch","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Projects"],"summary":"Delete Project","description":"Delete a project (soft delete by default) - Refs #2121\n\n- Soft delete: Sets status to DELETED and deleted_at timestamp\n- Hard delete: Permanently removes from database (admin only)\n- Projects with data cannot be hard-deleted without force=true\n- Soft deleted projects can be restored\n\nSecurity:\n- Users can only delete their own projects\n- Hard delete requires admin role\n- Projects with data require force=true for hard delete\n- Audit log created for all delete operations\n- Rate limiting applied to prevent abuse","operationId":"delete_project_api_v1_projects__project_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"hard_delete","in":"query","required":false,"schema":{"type":"boolean","description":"Permanently delete (cannot be restored). Requires admin role.","default":false,"title":"Hard Delete"},"description":"Permanently delete (cannot be restored). Requires admin role."},{"name":"force","in":"query","required":false,"schema":{"type":"boolean","description":"Required alongside hard_delete for projects that contain data","default":false,"title":"Force"},"description":"Required alongside hard_delete for projects that contain data"},{"name":"cascade","in":"query","required":false,"schema":{"type":"boolean","description":"Cascade delete related data (vectors, tables, files, events)","default":true,"title":"Cascade"},"description":"Cascade delete related data (vectors, tables, files, events)"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/transfer":{"post":{"tags":["ZeroDB Projects"],"summary":"Transfer Project","description":"Transfer a project to a different workspace.\n\nRequires:\n- Caller owns the project\n- Caller is OWNER or ADMIN of the target workspace\n\nRefs #5027","operationId":"transfer_project_api_v1_projects__project_id__transfer_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectTransferRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/restore":{"post":{"tags":["ZeroDB Projects"],"summary":"Restore Project","description":"Restore a soft-deleted project\n\nSets status back to ACTIVE and clears deleted_at timestamp.\nOnly works on soft-deleted projects.","operationId":"restore_project_api_v1_projects__project_id__restore_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/usage":{"get":{"tags":["ZeroDB Projects"],"summary":"Get Project Usage","description":"Get detailed usage metrics for a project\n\nReturns:\n- Current usage counts (vectors, tables, events, etc.)\n- Tier-based limits\n- Usage percentages","operationId":"get_project_usage_api_v1_projects__project_id__usage_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__project_router__ProjectUsage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/stats/summary":{"get":{"tags":["ZeroDB Projects"],"summary":"Get Projects Summary","description":"Get summary statistics for all user projects\n\nReturns:\n- Total projects by tier\n- Total usage across all projects \n- Overall tier limits","operationId":"get_projects_summary_api_v1_projects_stats_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsSummaryResponse"}}}}}}},"/api/v1/projects/bulk-stats":{"post":{"tags":["ZeroDB Projects"],"summary":"Get Bulk Project Stats","description":"Get statistics for multiple projects in a single API call\n\nThis endpoint significantly reduces API calls by returning stats for multiple\nprojects at once. It uses a single optimized database query with JOINs.\n\n**Performance Benefits:**\n- Single database query instead of N queries\n- Batch processing for large project lists\n- Pagination support for results\n\n**Returns:**\n- table_count: Number of NoSQL tables in project\n- row_count: Total rows across all tables (placeholder, requires table query)\n- vector_count: Number of vectors stored\n- memory_count: Number of memory entries (stored in events_count)\n- event_count: Number of events\n- storage_used_bytes: Storage used in bytes (memory_usage_mb * 1024 * 1024)\n\n**Example:**\n```json\n{\n \"project_ids\": [\"uuid1\", \"uuid2\", \"uuid3\"]\n}\n```","operationId":"get_bulk_project_stats_api_v1_projects_bulk_stats_post","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Items per page (max 100)","default":50,"title":"Page Size"},"description":"Items per page (max 100)"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkStatsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/api-registry":{"get":{"tags":["ZeroDB Projects"],"summary":"Get Project Api Registry","description":"Get all APIs and their enabled/disabled status for a project.","operationId":"get_project_api_registry_api_v1_projects__project_id__api_registry_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectApiRegistryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/api-registry/{api_name}/enable":{"post":{"tags":["ZeroDB Projects"],"summary":"Enable Project Api","description":"Enable an API for a project.","operationId":"enable_project_api_api_v1_projects__project_id__api_registry__api_name__enable_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"api_name","in":"path","required":true,"schema":{"type":"string","title":"Api Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiToggleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/api-registry/{api_name}/disable":{"post":{"tags":["ZeroDB Projects"],"summary":"Disable Project Api","description":"Disable an API for a project.","operationId":"disable_project_api_api_v1_projects__project_id__api_registry__api_name__disable_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"api_name","in":"path","required":true,"schema":{"type":"string","title":"Api Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiToggleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/api-registry/provision-defaults":{"post":{"tags":["ZeroDB Projects"],"summary":"Provision Default Apis","description":"Provision default APIs for a project based on tier.","operationId":"provision_default_apis_api_v1_projects__project_id__api_registry_provision_defaults_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"tier","in":"query","required":false,"schema":{"type":"string","description":"Subscription tier for default API set","default":"free","title":"Tier"},"description":"Subscription tier for default API set"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionDefaultsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/batch/query":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Execute batch query operations","description":"Execute multiple table operations (query, insert, update, delete) in a single request. Supports up to 50 operations per batch with optional parallel execution. MongoDB-style filters are supported for query/update/delete operations.","operationId":"batch_query_operations_api_v1_projects__project_id__database_batch_query_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchQueryRequest","description":"Batch query request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/memory/batch/upsert":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Batch upsert memory records","description":"Create or update multiple memory records in a single atomic transaction. Supports up to 500 records per batch with automatic rollback on failure.","operationId":"batch_upsert_memories_api_v1_projects__project_id__database_memory_batch_upsert_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryUpsertRequest","description":"Batch memory upsert request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryUpsertResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/memory/batch/delete":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Batch delete memory records","description":"Delete multiple memory records by ID in a single request. Supports up to 500 IDs per batch.","operationId":"batch_delete_memories_api_v1_projects__project_id__database_memory_batch_delete_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryDeleteRequest","description":"Batch memory delete request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/memory/batch/update":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Batch update memory records","description":"Update multiple memory records with partial field updates. Supports up to 500 updates per batch.","operationId":"batch_update_memories_api_v1_projects__project_id__database_memory_batch_update_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryUpdatesRequest","description":"Batch memory update request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryUpdatesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/events/batch":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Batch publish events","description":"Publish multiple events in a single request for high-throughput event streaming. Supports up to 100 events per batch with individual validation.","operationId":"batch_publish_events_api_v1_projects__project_id__database_events_batch_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEventPublishRequest","description":"Batch event publish request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEventPublishResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/embeddings/generate":{"post":{"tags":["ZeroDB Embeddings"],"summary":"Generate Project Embeddings","description":"Generate embeddings within a ZeroDB project context (Issue #310: Multi-Model Support)\n\n**FREE - No usage costs!**\nUses Railway self-hosted HuggingFace service\n\n**Supported Models:**\n- `BAAI/bge-small-en-v1.5` (384-dim) - Default, fastest\n- `BAAI/bge-base-en-v1.5` (768-dim) - Better quality\n- `BAAI/bge-large-en-v1.5` (1024-dim) - Best quality\n\n**Parameters:**\n- `texts`: List of texts to embed (1-100)\n- `model`: Model to use (optional, defaults to BAAI/bge-small-en-v1.5)\n- `normalize`: Normalize embeddings to unit length (default: true)\n\n**Returns:**\n- `embeddings`: List of embedding vectors\n- `model`: Model used\n- `dimensions`: Vector dimensions (384, 768, or 1024)\n- `count`: Number of embeddings generated\n- `processing_time_ms`: Generation time in milliseconds\n- `project_id`: Project UUID\n\n**Example:**\n```python\nPOST /v1/{project_id}/embeddings/generate\n{\n \"texts\": [\"ZeroDB is a vector database\"],\n \"model\": \"BAAI/bge-base-en-v1.5\" # Optional, uses small by default\n}\n```\n\n**Backward Compatible:** Calls without `model` parameter use default (384-dim)","operationId":"generate_project_embeddings_api_v1_projects__project_id__embeddings_generate_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__GenerateEmbeddingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__GenerateEmbeddingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/embeddings/embed-and-store":{"post":{"tags":["ZeroDB Embeddings"],"summary":"Embed And Store In Project","description":"Generate embeddings and automatically store in ZeroDB project\nwith automatic dimension detection and routing (Issues #309, #310)\n\n**Optimized for RAG workflows:**\n1. Generate embeddings (FREE via Railway service)\n2. Auto-detect dimension (384, 768, 1024, or 1536)\n3. Route to correct database column (vector_384, vector_768, etc.)\n4. Store vectors in project's ZeroDB database\n5. Ready for semantic search immediately\n\n**Supported Models:**\n- `BAAI/bge-small-en-v1.5` (384-dim) - Default, fastest, FREE\n- `BAAI/bge-base-en-v1.5` (768-dim) - Better quality, FREE\n- `BAAI/bge-large-en-v1.5` (1024-dim) - Best quality, FREE\n- Custom 1536-dim (OpenAI compatible)\n\n**Parameters:**\n- `texts`: List of texts to embed and store (1-100)\n- `model`: Model to use (optional, defaults to BAAI/bge-small-en-v1.5)\n- `metadata_list`: Optional metadata for each text\n- `namespace`: Vector namespace (default: \"default\")\n\n**Returns:**\n- `success`: Boolean indicating success\n- `vectors_stored`: Number of vectors stored\n- `embeddings_generated`: Number of embeddings generated\n- `model`: Model used\n- `dimensions`: Detected dimension (384, 768, 1024, or 1536)\n- `target_column`: Database column where vectors are stored\n- `namespace`: Namespace used\n- `project_id`: Project UUID\n- `processing_time_ms`: Total processing time\n\n**Example:**\n```python\nPOST /v1/{project_id}/embeddings/embed-and-store\n{\n \"texts\": [\"Document 1\", \"Document 2\"],\n \"model\": \"BAAI/bge-base-en-v1.5\", # Optional\n \"namespace\": \"my_docs\"\n}\n\n# Response\n{\n \"success\": true,\n \"vectors_stored\": 2,\n \"dimensions\": 768,\n \"target_column\": \"vector_768\", # Auto-detected routing\n ...\n}\n```\n\n**Backward Compatible:** Calls without `model` parameter use default (384-dim)","operationId":"embed_and_store_in_project_api_v1_projects__project_id__embeddings_embed_and_store_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__EmbedAndStoreRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__EmbedAndStoreResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/embeddings/search":{"post":{"tags":["ZeroDB Embeddings"],"summary":"Semantic Search In Project","description":"Semantic search within a ZeroDB project with dimension-aware routing (Issues #309, #310)\n\n**Optimized for RAG:**\n1. Generate query embedding (FREE via Railway service)\n2. Auto-detect dimension and search correct column\n3. Return most relevant documents\n\n**Parameters:**\n- `query`: Search query text\n- `model`: Model to use (must match stored vectors' model, defaults to BAAI/bge-small-en-v1.5)\n- `limit`: Maximum results (1-100, default: 10)\n- `threshold`: Similarity threshold (0.0-1.0, default: 0.7)\n- `namespace`: Vector namespace (default: \"default\")\n- `filter_metadata`: Optional metadata filters\n\n**Returns:**\n- `results`: List of matching vectors with metadata\n- `query`: Original search query\n- `total_results`: Total number of results\n- `model`: Model used for query embedding\n- `project_id`: Project UUID\n- `processing_time_ms`: Search time in milliseconds\n\n**Important:** Use the same model you used when storing vectors!\n- If you stored with `BAAI/bge-base-en-v1.5` (768-dim), search with same model\n- Mixing dimensions will result in poor search quality\n\n**Example:**\n```python\nPOST /v1/{project_id}/embeddings/search\n{\n \"query\": \"What is ZeroDB?\",\n \"model\": \"BAAI/bge-base-en-v1.5\", # Match your stored vectors' model\n \"limit\": 5,\n \"threshold\": 0.75\n}\n\n# Response\n{\n \"results\": [\n {\n \"id\": \"vec_123\",\n \"document\": \"ZeroDB is a vector database...\",\n \"similarity\": 0.92,\n \"metadata\": {...}\n }\n ],\n \"total_results\": 5,\n \"model\": \"BAAI/bge-base-en-v1.5\",\n ...\n}\n```\n\n**Backward Compatible:** Calls without `model` parameter use default (384-dim)","operationId":"semantic_search_in_project_api_v1_projects__project_id__embeddings_search_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__SemanticSearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__SemanticSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/embeddings/models":{"get":{"tags":["ZeroDB Embeddings"],"summary":"List Available Embedding Models","description":"List available embedding models for a ZeroDB project (Issue #310)\n\n**Supported Models:**\n- BAAI/bge-small-en-v1.5 (384-dim) - Default, fastest, FREE\n- BAAI/bge-base-en-v1.5 (768-dim) - Better quality, FREE\n- BAAI/bge-large-en-v1.5 (1024-dim) - Best quality, FREE\n\n**Use Cases:**\n- **384-dim**: General-purpose, cost-sensitive (80% of users)\n- **768-dim**: Higher quality search (15% of users)\n- **1024-dim**: Mission-critical search (5% of users)\n\nReturns:\n List of available models with metadata","operationId":"list_available_embedding_models_api_v1_projects__project_id__embeddings_models_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__EmbeddingModelInfo"},"title":"Response List Available Embedding Models Api V1 Projects Project Id Embeddings Models Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/events/subscriptions":{"get":{"tags":["ZeroDB Vector Operations","Event Subscriptions","Event Subscriptions"],"summary":"List event subscriptions","description":"Get all event subscriptions for a project","operationId":"list_subscriptions_api_v1_projects__project_id__database_events_subscriptions_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ZeroDB Vector Operations","Event Subscriptions","Event Subscriptions"],"summary":"Create event subscription","description":"Create a new event subscription for a project","operationId":"create_subscription_api_v1_projects__project_id__database_events_subscriptions_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/events/subscriptions/{subscription_id}":{"delete":{"tags":["ZeroDB Vector Operations","Event Subscriptions","Event Subscriptions"],"summary":"Delete event subscription","description":"Delete an event subscription by ID","operationId":"delete_subscription_api_v1_projects__project_id__database_events_subscriptions__subscription_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Subscription ID","title":"Subscription Id"},"description":"Subscription ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/agent-logs/metrics":{"get":{"tags":["ZeroDB Vector Operations","Agent Logs","Agent Logs"],"summary":"Get Agent Logs Metrics","description":"Get comprehensive agent logs metrics\n\nReturns:\n- active_agents: Number of unique agents with activity in time range\n- completed_tasks: Tasks completed successfully\n- error_rate: Percentage of ERROR level logs\n- avg_duration_ms: Average task duration in milliseconds\n- total_logs: Total log entries\n- logs_by_level: Breakdown by log level\n- recent_errors: Recent error messages","operationId":"get_agent_logs_metrics_api_v1_projects__project_id__agent_logs_metrics_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"time_range_hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"description":"Time range in hours (1-168)","default":24,"title":"Time Range Hours"},"description":"Time range in hours (1-168)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAgentLogsMetricsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/agent-logs/recent-activity":{"get":{"tags":["ZeroDB Vector Operations","Agent Logs","Agent Logs"],"summary":"Get Recent Activity","description":"Get recent agent activity logs\n\nReturns chronologically ordered list of recent agent activities\nwith detailed information for debugging and monitoring","operationId":"get_recent_activity_api_v1_projects__project_id__agent_logs_recent_activity_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum number of activities","default":50,"title":"Limit"},"description":"Maximum number of activities"},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by agent ID","title":"Agent Id"},"description":"Filter by agent ID"},{"name":"log_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by log level","title":"Log Level"},"description":"Filter by log level"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRecentActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/agent-logs/trace":{"get":{"tags":["ZeroDB Vector Operations","Agent Logs","Agent Logs"],"summary":"Get Agent Trace","description":"Get live trace visualization data for agent execution\n\nReturns structured trace data suitable for timeline visualization\nincluding execution flow, state transitions, and error tracking","operationId":"get_agent_trace_api_v1_projects__project_id__agent_logs_trace_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by session ID","title":"Session Id"},"description":"Filter by session ID"},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by agent ID","title":"Agent Id"},"description":"Filter by agent ID"},{"name":"time_window_minutes","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"description":"Time window in minutes","default":5,"title":"Time Window Minutes"},"description":"Time window in minutes"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAgentTraceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/agent-logs/sessions/{session_id}":{"get":{"tags":["ZeroDB Vector Operations","Agent Logs","Agent Logs"],"summary":"Get Session Details","description":"Get detailed logs and metrics for a specific agent session","operationId":"get_session_details_api_v1_projects__project_id__agent_logs_sessions__session_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","description":"Session ID","title":"Session Id"},"description":"Session ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSessionDetailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/agent-logs/subscribe":{"post":{"tags":["ZeroDB Vector Operations","Agent Logs","Agent Logs"],"summary":"Subscribe to live agent log streaming","description":"Create a durable subscription handle, then return the WebSocket URL\nthe client connects to for the actual real-time log stream.","operationId":"subscribe_agent_logs_api_v1_projects__project_id__database_agent_logs_subscribe_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogSubscribeRequest","default":{"filter":{}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogSubscribeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/agent-logs/subscribe/{subscription_id}":{"delete":{"tags":["ZeroDB Vector Operations","Agent Logs","Agent Logs"],"summary":"Unsubscribe from live agent log streaming","operationId":"unsubscribe_agent_logs_api_v1_projects__project_id__database_agent_logs_subscribe__subscription_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Subscription ID","title":"Subscription Id"},"description":"Subscription ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files/upload":{"post":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Upload File Binary","description":"Upload binary file to MinIO storage with metadata tracking\n\nThis endpoint:\n1. Uploads the file to MinIO object storage\n2. Stores file metadata in the database\n3. Updates project storage usage\n4. Returns file details including URLs\n\nFixed Issues:\n- Corrected method call from upload_file() to upload_file_metadata()\n- Added proper error handling and rollback\n- Improved metadata parsing","operationId":"upload_file_binary_api_v1_projects__project_id__files_upload_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_file_binary_api_v1_projects__project_id__files_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__file_storage_responses__UploadFileBinaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files/presign-upload":{"post":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Presign Upload","description":"Step 1: return a presigned MinIO PUT URL so the client uploads DIRECT to\nobject storage, bypassing the gateway body buffer (Refs #6215).\n\nThe bucket is ensured to exist here so the subsequent PUT can't 404. The\nclient then PUTs the raw bytes to `upload_url`, and calls confirm-upload with\nthe returned `file_key` to record metadata.","operationId":"presign_upload_api_v1_projects__project_id__files_presign_upload_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_presign_upload_api_v1_projects__project_id__files_presign_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files/confirm-upload":{"post":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Confirm Upload","description":"Step 3: verify the object landed in MinIO (stat_object) and record its\nmetadata row (Refs #6215). Call this after the client's direct PUT succeeds.\n\nReturns 404 if the object isn't actually in storage (client never PUT it or\nthe key is wrong) — so we never record a metadata row for a phantom file.","operationId":"confirm_upload_api_v1_projects__project_id__files_confirm_upload_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_confirm_upload_api_v1_projects__project_id__files_confirm_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files/metadata":{"post":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Upload File Metadata","description":"Upload file metadata only (no binary file)\n\nUse this endpoint when you've already uploaded the file to MinIO\nand just need to register the metadata in the database","operationId":"upload_file_metadata_api_v1_projects__project_id__files_metadata_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files":{"get":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"List Files","description":"List all files in project storage.\nReturns { files, total, page, page_size, has_more } for frontend compatibility.","operationId":"list_files_api_v1_projects__project_id__files_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of files to skip","default":0,"title":"Skip"},"description":"Number of files to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum files to return","default":100,"title":"Limit"},"description":"Maximum files to return"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":20,"title":"Page Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFilesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/files/storage-status":{"get":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Project Storage Status","description":"Readiness signal for a project's File Storage bucket (Refs #6206).\n\nA new project's per-project bucket is provisioned asynchronously\n(provision_project_storage) right after creation. This endpoint lets clients\npoll for readiness instead of blindly uploading into a 503/504:\n - 'ready' → bucket exists, uploads will work\n - 'provisioning' → bucket is still being created; retry shortly\n - 'failed' → provisioning failed (uploads fall back to lazy create)\n - 'unknown' → no status recorded yet (older project); treat as ready-ish\nVerifies live against MinIO so the answer is authoritative, not just the flag.","operationId":"project_storage_status_api_v1_projects__project_id__files_storage_status_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectStorageStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files/{file_id}":{"get":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Get File","description":"Get file metadata by ID","operationId":"get_file_api_v1_projects__project_id__files__file_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"File ID","title":"File Id"},"description":"File ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Delete File","description":"Delete file metadata and optionally the file from storage","operationId":"delete_file_api_v1_projects__project_id__files__file_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"File ID","title":"File Id"},"description":"File ID"},{"name":"delete_from_storage","in":"query","required":false,"schema":{"type":"boolean","description":"Also delete from MinIO storage","default":true,"title":"Delete From Storage"},"description":"Also delete from MinIO storage"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__file_storage_responses__DeleteFileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files/{file_id}/download":{"get":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Download File","description":"Download file from MinIO storage\n\nReturns presigned URL for direct download","operationId":"download_file_api_v1_projects__project_id__files__file_id__download_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"File ID","title":"File Id"},"description":"File ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__file_storage_responses__DownloadFileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files/{file_id}/content":{"get":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Stream File Content","description":"Stream file content directly from MinIO storage.\n\nThis endpoint acts as a proxy, fetching the file from MinIO using\nserver-side authentication and streaming it to the client.\n\nUse this endpoint for displaying images when presigned URLs don't work\ndue to proxy/edge network issues.\n\nExample usage in HTML:\n ","operationId":"stream_file_content_api_v1_projects__project_id__files__file_id__content_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"File ID","title":"File Id"},"description":"File ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files/{file_id}/presigned-url":{"post":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Generate File Presigned Url","description":"Generate a presigned URL for direct file access.\n\nReturns a time-limited URL that can be used to access the file\ndirectly from storage without authentication. Useful for serving\nimages in frontends where proxy streaming is not feasible.\n\n- **expiration**: URL validity in seconds (default: 3600 = 1 hour)\n- **operation**: 'download' or 'upload' (default: download)","operationId":"generate_file_presigned_url_api_v1_projects__project_id__files__file_id__presigned_url_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"File ID","title":"File Id"},"description":"File ID"},{"name":"expiration","in":"query","required":false,"schema":{"type":"integer","default":3600,"title":"Expiration"}},{"name":"operation","in":"query","required":false,"schema":{"type":"string","default":"download","title":"Operation"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateFilePresignedUrlResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/files/stats/summary":{"get":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Get File Stats","description":"Get file storage statistics for project","operationId":"get_file_stats_api_v1_projects__project_id__files_stats_summary_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__file_storage_responses__GetFileStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/_storage/health":{"get":{"tags":["ZeroDB Vector Operations","File Storage","File Storage"],"summary":"Storage Health","description":"Object-store (MinIO) health probe for monitoring/alerting.\n\nReturns 200 with status='healthy' when the object store answers, or 503 when\nit is unreachable/degraded — so downloads/uploads don't silently 503 without\nthe storage layer itself being observable (Refs #6207). Uses the same\nshort-timeout client as the data path, so a hung MinIO fast-fails here too.","operationId":"storage_health_api_v1_projects__storage_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageHealthResponse"}}}}}}},"/api/v1/projects/{project_id}/database/metrics":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Database Management"],"summary":"Get database performance metrics","description":"Get real-time database performance metrics for monitoring and optimization.\n\n **Metrics Included:**\n - Active database connections\n - Queries per second (QPS)\n - Cache hit rate (0.0 - 1.0)\n - Average query latency in milliseconds\n\n **Use Cases:**\n - Database Settings page monitoring\n - Performance dashboards\n - Alerting on threshold breaches\n - Capacity planning","operationId":"get_database_metrics_api_v1_projects__project_id__database_metrics_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__DatabaseMetricsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/maintenance/vacuum":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Settings & Maintenance","ZeroDB Database Management"],"summary":"Run VACUUM on database","description":"Execute PostgreSQL VACUUM operation to reclaim storage and optimize performance.\n\n **VACUUM Operations:**\n - `VACUUM`: Standard vacuum operation (reclaim space from deleted rows)\n - `VACUUM ANALYZE`: Vacuum + update statistics for query planner\n - `VACUUM FULL`: Complete table rewrite (locks tables, reclaims maximum space)\n\n **When to Use:**\n - After bulk deletions\n - Regular maintenance (weekly/monthly)\n - When disk space is needed\n - Query performance degradation\n\n **Note:** VACUUM FULL requires exclusive table locks and may take longer.","operationId":"vacuum_database_api_v1_projects__project_id__database_maintenance_vacuum_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_vacuum_database_api_v1_projects__project_id__database_maintenance_vacuum_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VacuumDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/maintenance/analyze":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Settings & Maintenance","ZeroDB Database Management"],"summary":"Run ANALYZE to update statistics","description":"Execute PostgreSQL ANALYZE operation to update query planner statistics.\n\n **What it Does:**\n - Collects statistics about table contents\n - Updates query planner optimization data\n - Improves query performance by enabling better execution plans\n\n **When to Use:**\n - After bulk INSERT/UPDATE/DELETE operations\n - When query plans are suboptimal\n - Regular maintenance (weekly)\n - After schema changes\n\n **Note:** This operation is lightweight and doesn't lock tables.","operationId":"analyze_database_api_v1_projects__project_id__database_maintenance_analyze_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_analyze_database_api_v1_projects__project_id__database_maintenance_analyze_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/maintenance/reindex":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Settings & Maintenance","ZeroDB Database Management"],"summary":"Rebuild database indexes","description":"Execute PostgreSQL REINDEX operation to rebuild corrupted or bloated indexes.\n\n **What it Does:**\n - Rebuilds all indexes from scratch\n - Fixes index corruption\n - Reduces index bloat\n - Improves query performance\n\n **When to Use:**\n - Suspected index corruption\n - Significant index bloat after many updates\n - Performance degradation despite VACUUM/ANALYZE\n - After major data changes\n\n **Note:** REINDEX requires exclusive table locks and may take time.","operationId":"reindex_database_api_v1_projects__project_id__database_maintenance_reindex_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_reindex_database_api_v1_projects__project_id__database_maintenance_reindex_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReindexDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/settings/quantum-compression":{"put":{"tags":["ZeroDB Vector Operations","ZeroDB Settings & Maintenance","ZeroDB Database Management"],"summary":"Toggle quantum compression for project","description":"Enable or disable TurboQuant compression for vector storage.\n\n **TurboQuant Compression Benefits:**\n - Up to 60% reduction in vector storage size\n - Preserved similarity relationships\n - Faster vector searches (smaller index)\n - Lower memory footprint\n\n **Algorithms Available:**\n - `quantum_harmonic`: Frequency domain compression (recommended) — maps to TurboQuant frequency transform\n - `sparse_encode`: Sparsity-based compression — maps to TurboQuant sparse quantization\n - `entropy_reduce`: PCA-based compression — maps to TurboQuant dimensionality reduction\n\n **Note:** Enabling compression will compress future vectors.\n Existing vectors can be compressed using the batch compression endpoint.","operationId":"toggle_quantum_compression_api_v1_projects__project_id__database_settings_quantum_compression_put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_toggle_quantum_compression_api_v1_projects__project_id__database_settings_quantum_compression_put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToggleQuantumCompressionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Database Management"],"summary":"Enable Database","description":"Enable ZeroDB for an existing project\nCreates database instance and returns configuration","operationId":"enable_database_api_v1_projects__project_id__database_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnableDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Vector Operations","ZeroDB Database Management"],"summary":"Get Database Status","description":"Get database status and configuration for a project","operationId":"get_database_status_api_v1_projects__project_id__database_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDatabaseStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["ZeroDB Vector Operations","ZeroDB Database Management"],"summary":"Update Database Config","description":"Update database configuration for a project\n\nSupports updating both top-level fields and database_config dictionary:\n- quantum_enabled: bool - Enable/disable quantum compression\n- vector_dimensions: int - Set vector embedding dimensions\n- mcp_enabled: bool - Enable/disable MCP features\n- database_config: dict - Additional configuration options","operationId":"update_database_config_api_v1_projects__project_id__database_put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Config"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDatabaseConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","ZeroDB Database Management"],"summary":"Disable Database","description":"Disable database features for a project","operationId":"disable_database_api_v1_projects__project_id__database_delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisableDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/tables":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Table Management"],"summary":"Create Table","description":"Create a new table in project database","operationId":"create_table_api_v1_projects__project_id__database_tables_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBTableCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBTableResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Vector Operations","ZeroDB Table Management"],"summary":"List Tables","description":"List all tables in project database with pagination metadata\n\nReturns paginated response with:\n- total: Total number of tables in project\n- skip: Number of tables skipped\n- limit: Maximum tables per page\n- has_more: Whether more tables are available\n- data: List of table objects","operationId":"list_tables_api_v1_projects__project_id__database_tables_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedTablesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/tables/{table_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Table Management"],"summary":"Get Table","description":"Get table details","operationId":"get_table_api_v1_projects__project_id__database_tables__table_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Table Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBTableResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/tables/{table_name}/rows":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Row Operations"],"summary":"Create Row","description":"Insert a new row into a table","operationId":"create_row_api_v1_projects__project_id__database_tables__table_name__rows_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"get":{"tags":["ZeroDB Vector Operations","ZeroDB Row Operations"],"summary":"List Rows","description":"Read all rows from a table with pagination metadata\n\nReturns paginated response with:\n- total: Total number of rows in table\n- skip: Number of rows skipped\n- limit: Maximum rows per page\n- has_more: Whether more rows are available\n- data: List of row objects\n\nUse `exclude_data=true` for list views that only need metadata (Refs #4713).\nUse `filter` to narrow results server-side (Refs #7471) — pass a JSON object,\nsame shape and operators as `POST .../query`'s `filter` field.","operationId":"list_rows_api_v1_projects__project_id__database_tables__table_name__rows_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"exclude_data","in":"query","required":false,"schema":{"type":"boolean","description":"Exclude row_data from response (metadata only). Refs #4713","default":false,"title":"Exclude Data"},"description":"Exclude row_data from response (metadata only). Refs #4713"},{"name":"filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"JSON object of field->value (direct equality) or field->{$op: value} (MongoDB-style operator) conditions, applied server-side against row_data. Refs #7471: this endpoint accepted a filter parameter in name only — every consumer got every row back and had to re-filter client-side, which is both a correctness/tenant-isolation risk and the source of full-table-scan latency on busy tables. Same operator set and semantics as POST .../query's filter (see MongoFilterTranslator).","title":"Filter"},"description":"JSON object of field->value (direct equality) or field->{$op: value} (MongoDB-style operator) conditions, applied server-side against row_data. Refs #7471: this endpoint accepted a filter parameter in name only — every consumer got every row back and had to re-filter client-side, which is both a correctness/tenant-isolation risk and the source of full-table-scan latency on busy tables. Same operator set and semantics as POST .../query's filter (see MongoFilterTranslator)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedRowsResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Project or resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/database/tables/{table_name}/rows/batch":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Bulk Operations"],"summary":"Create Rows Batch","description":"Insert many rows into a table in a single request.\n\nSo an agent populating a table does not need to loop one\n`POST .../rows` call per row (AX audit,\nRefs AINative-Studio/ainative-website#2211).\n\n**Partial-failure semantics:** each row is inserted independently. A row\nthat fails (e.g. a per-row storage-limit violation) is reported in\n`errors` (with its index into the request `rows` array) and does **not**\nfail the rest of the batch — this matches the existing\n`POST .../vectors/upsert-batch` endpoint. A request-level failure (the\ntable itself does not exist) still fails the whole request with a 404,\nsince there is nowhere to insert any row.\n\n**Example Request:**\n```json\n{\n \"rows\": [\n {\"row_data\": {\"name\": \"Alice\", \"status\": \"active\"}},\n {\"row_data\": {\"name\": \"Bob\", \"status\": \"pending\"}}\n ]\n}\n```\n\n**Returns:**\n- `created` - successfully inserted rows, in request order\n- `errors` - per-row `{index, error}` entries for rows that failed\n- `success_count` / `error_count`\n- `total_time_ms` - total operation time","operationId":"create_rows_batch_api_v1_projects__project_id__database_tables__table_name__rows_batch_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkRowCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkRowCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/tables/{table_name}/query":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Row Operations"],"summary":"Query Rows Mongo Style","description":"Query table rows using MongoDB-style filters and operators\n\n**Supported Filter Operators:**\n- `$eq`: Equals (e.g., {\"status\": {\"$eq\": \"active\"}})\n- `$ne`: Not equals (e.g., {\"status\": {\"$ne\": \"deleted\"}})\n- `$gt`: Greater than (e.g., {\"age\": {\"$gt\": 18}})\n- `$gte`: Greater than or equal (e.g., {\"age\": {\"$gte\": 18}})\n- `$lt`: Less than (e.g., {\"price\": {\"$lt\": 100}})\n- `$lte`: Less than or equal (e.g., {\"price\": {\"$lte\": 100}})\n- `$in`: Value in array (e.g., {\"status\": {\"$in\": [\"active\", \"pending\"]}})\n- `$nin`: Value not in array (e.g., {\"status\": {\"$nin\": [\"deleted\", \"banned\"]}})\n- `$contains`: String/array contains (e.g., {\"tags\": {\"$contains\": \"premium\"}})\n- `$regex`: Regex pattern match (e.g., {\"email\": {\"$regex\": \".*@gmail\\.com$\"}})\n- `$elemMatch`: Match inside a JSONB array field — returns rows where any\n array element satisfies all inner conditions (e.g.,\n {\"arts_and_ranks\": {\"$elemMatch\": {\"art\": {\"$icontains\": \"Judo\"}}}}).\n Inner conditions accept the same operators ($eq, $ne, $icontains,\n $contains, $in, $gt, $gte, $lt, $lte, $regex, $ieq).\n\n**Sort Specification:**\n- Use 1 for ascending order, -1 for descending order\n- Example: {\"created_at\": -1, \"name\": 1}\n\n**Security Features:**\n- Automatic SQL injection prevention via parameterized queries\n- Field name validation (alphanumeric, underscore, dot only)\n- Maximum result limit enforcement (10,000 rows)\n- Operator whitelist validation\n\n**Example Request:**\n```json\n{\n \"filter\": {\n \"age\": {\"$gte\": 18},\n \"status\": {\"$in\": [\"active\", \"pending\"]},\n \"tags\": {\"$contains\": \"premium\"},\n \"email\": {\"$regex\": \".*@gmail\\.com$\"}\n },\n \"sort\": {\"created_at\": -1},\n \"limit\": 50,\n \"skip\": 0\n}\n```\n\n**Example Response:**\n```json\n{\n \"total\": 245,\n \"skip\": 0,\n \"limit\": 50,\n \"has_more\": true,\n \"filter_summary\": {\n \"age\": {\"$gte\": 18},\n \"status\": {\"$in\": [\"active\", \"pending\"]}\n },\n \"execution_time_ms\": 45.23,\n \"data\": [\n {\n \"row_id\": \"uuid\",\n \"project_id\": \"uuid\",\n \"table_id\": \"uuid\",\n \"table_name\": \"users\",\n \"row_data\": {\"age\": 25, \"status\": \"active\", ...},\n \"created_at\": \"2025-12-03T10:00:00Z\",\n \"updated_at\": \"2025-12-03T10:00:00Z\"\n }\n ]\n}\n```\n\n**Error Codes:**\n- 400: Invalid filter operator, field name, or dangerous pattern detected\n- 404: Table not found\n- 500: Query execution error","operationId":"query_rows_mongo_style_api_v1_projects__project_id__database_tables__table_name__query_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MongoQueryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MongoQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/tables/{table_name}/count":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Row Operations"],"summary":"Count Rows Get","description":"Get total row count for a table (no filter, no body required).\nReturns: {\"count\": N, \"table\": \"table_name\"}\n\nRefs #4969","operationId":"count_rows_get_api_v1_projects__project_id__database_tables__table_name__count_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountRowsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ZeroDB Vector Operations","ZeroDB Row Operations"],"summary":"Count Rows","description":"Count rows matching a filter without returning the rows themselves.\nUseful for pagination metadata and analytics on large tables.\n\nReturns: {\"count\": N, \"table\": \"table_name\", \"filter_summary\": {...}}","operationId":"count_rows_api_v1_projects__project_id__database_tables__table_name__count_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MongoQueryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountRowsFilteredResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/tables/{table_name}/rows/bulk":{"put":{"tags":["ZeroDB Vector Operations","ZeroDB Bulk Operations"],"summary":"Bulk Update Rows","description":"Bulk update rows in a table using MongoDB-style operators\n\n**Supported Update Operators:**\n- `$set` - Set field values\n- `$inc` - Increment numeric fields\n- `$push` - Add to array fields\n- `$pull` - Remove from array fields\n- `$unset` - Remove fields\n\n**Filter Operators:**\n- `$eq` - Equal to\n- `$ne` - Not equal to\n- `$gt` - Greater than\n- `$gte` - Greater than or equal\n- `$lt` - Less than\n- `$lte` - Less than or equal\n- `$in` - Value in array\n- `$nin` - Value not in array\n\n**Example Request:**\n```json\n{\n \"filter\": {\n \"status\": \"pending\",\n \"created_at\": {\"$lt\": \"2025-01-01\"}\n },\n \"update\": {\n \"$set\": {\n \"status\": \"active\",\n \"updated_at\": \"2025-12-03T10:00:00Z\"\n },\n \"$inc\": {\n \"login_count\": 1\n },\n \"$push\": {\n \"notifications\": \"Account activated\"\n }\n },\n \"confirm_large_operation\": false\n}\n```\n\n**Safety Features:**\n- Requires non-empty filter to prevent accidental updates\n- Confirmation required for operations affecting >100 rows\n- Transaction support with automatic rollback on errors\n- Validation of all update operators\n\n**Returns:**\n- `matched_count` - Number of rows matched by filter\n- `modified_count` - Number of rows actually modified\n- `filter_used` - Filter criteria applied\n- `update_operators` - Update operators applied\n- `execution_time_ms` - Operation execution time\n- `warnings` - Any warnings during operation","operationId":"bulk_update_rows_api_v1_projects__project_id__database_tables__table_name__rows_bulk_put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","ZeroDB Bulk Operations"],"summary":"Bulk Delete Rows","description":"Bulk delete rows from a table using MongoDB-style filters\n\n**Filter Operators:**\n- `$eq` - Equal to\n- `$ne` - Not equal to\n- `$gt` - Greater than\n- `$gte` - Greater than or equal\n- `$lt` - Less than\n- `$lte` - Less than or equal\n- `$in` - Value in array\n- `$nin` - Value not in array\n\n**Example Request:**\n```json\n{\n \"filter\": {\n \"status\": \"inactive\",\n \"last_login\": {\"$lt\": \"2024-01-01\"}\n },\n \"confirm_large_operation\": false\n}\n```\n\n**Safety Features:**\n- Requires non-empty filter to prevent accidental deletion of all rows\n- Confirmation required for operations affecting >100 rows\n- Transaction support with automatic rollback on errors\n\n**Returns:**\n- `deleted_count` - Number of rows deleted\n- `filter_used` - Filter criteria applied\n- `execution_time_ms` - Operation execution time\n- `warnings` - Any warnings during operation","operationId":"bulk_delete_rows_api_v1_projects__project_id__database_tables__table_name__rows_bulk_delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__BulkDeleteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/tables/{table_name}/rows/{row_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Row Operations"],"summary":"Get Row","description":"Get a specific row by ID","operationId":"get_row_api_v1_projects__project_id__database_tables__table_name__rows__row_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"row_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Row Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["ZeroDB Vector Operations","ZeroDB Row Operations"],"summary":"Update Row","description":"Update an existing row","operationId":"update_row_api_v1_projects__project_id__database_tables__table_name__rows__row_id__put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"row_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Row Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","ZeroDB Row Operations"],"summary":"Delete Row","description":"Delete a row from a table","operationId":"delete_row_api_v1_projects__project_id__database_tables__table_name__rows__row_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"row_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Row Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteRowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/tables/{table_name}":{"delete":{"tags":["ZeroDB Vector Operations","ZeroDB Table Operations"],"summary":"Delete Table","description":"Delete a table and all its data","operationId":"delete_table_api_v1_projects__project_id__database_tables__table_name__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTableResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/vectors/upsert":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Upsert Vector","description":"Upsert a vector into project database","operationId":"upsert_vector_api_v1_projects__project_id__database_vectors_upsert_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/database/vectors/upsert-batch":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Upsert Vectors Batch","description":"Batch upsert vectors","operationId":"upsert_vectors_batch_api_v1_projects__project_id__database_vectors_upsert_batch_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VectorCreate"},"title":"Vectors"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkOperationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/vectors/search":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Search Vectors","description":"Search vectors using similarity","operationId":"search_vectors_api_v1_projects__project_id__database_vectors_search_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__VectorSearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__VectorSearchResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/database/vectors":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"List Vectors","description":"List all vectors in a project with pagination\n\nReturns vectors with optional filtering by namespace.\nUse detailed=false (default) to exclude full embeddings and save bandwidth.\nUse detailed=true to include full vector embeddings in the response.","operationId":"list_vectors_api_v1_projects__project_id__database_vectors_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of vectors to skip","default":0,"title":"Offset"},"description":"Number of vectors to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum vectors to return","default":100,"title":"Limit"},"description":"Maximum vectors to return"},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by namespace","title":"Namespace"},"description":"Filter by namespace"},{"name":"detailed","in":"query","required":false,"schema":{"type":"boolean","description":"Include full embeddings (default: false for bandwidth efficiency)","default":false,"title":"Detailed"},"description":"Include full embeddings (default: false for bandwidth efficiency)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedVectorsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/vectors/stats":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Get Vector Stats","description":"Get vector statistics for a project\n\nReturns:\n- total_vectors: Total count of vectors\n- namespaces: List of unique namespaces\n- avg_dimensions: Average embedding dimensions\n- total_size_mb: Estimated storage size","operationId":"get_vector_stats_api_v1_projects__project_id__database_vectors_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by namespace","title":"Namespace"},"description":"Filter by namespace"},{"name":"detailed","in":"query","required":false,"schema":{"type":"boolean","description":"Include detailed statistics","default":false,"title":"Detailed"},"description":"Include detailed statistics"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/vectors/{vector_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Get Vector","description":"Get a specific vector by ID","operationId":"get_vector_api_v1_projects__project_id__database_vectors__vector_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"vector_id","in":"path","required":true,"schema":{"type":"string","title":"Vector Id"}},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by namespace","title":"Namespace"},"description":"Filter by namespace"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Delete Vector","description":"Delete a specific vector by ID","operationId":"delete_vector_api_v1_projects__project_id__database_vectors__vector_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"vector_id","in":"path","required":true,"schema":{"type":"string","title":"Vector Id"}},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by namespace","title":"Namespace"},"description":"Filter by namespace"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__DeleteVectorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/vectors/quantum-compress":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Quantum Compress Vector","description":"Compress a vector using TurboQuant (PolarQuant + QJL)\n\nThis endpoint provides vector compression using algorithms based on\nGoogle's TurboQuant (ICLR 2026):\n- **turboquant** (or quantum_harmonic): PolarQuant + QJL (~3.5x compression, cosine > 0.9999)\n- **polarquant** (or sparse_encode): PolarQuant only (~2.6x compression, cosine > 0.9999)\n- **qjl** (or entropy_reduce): QJL sign-bit only (~27x compression, cosine ~0.80)\n\nFeatures:\n- 3.5x compression at 8-bit precision with 0.99999 cosine similarity\n- Data-oblivious: no per-dataset calibration needed\n- Binary serialization (no JSON/zlib overhead)\n- Adjustable precision (8, 16, or 32-bit radius quantization)\n\nRefs #1563, #1564","operationId":"quantum_compress_vector_api_v1_projects__project_id__database_vectors_quantum_compress_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuantumCompressRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuantumCompressResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/vectors/analytics":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Get advanced vector analytics","description":"Get comprehensive vector analytics including similarity metrics, storage stats, and quality indicators.\n\n **Features:**\n - Total vector counts and namespace distribution\n - Average cosine similarity analysis (sample-based for performance)\n - Detailed storage metrics (bytes, MB, GB)\n - Quality metrics (magnitude, sparsity, variance)\n - Dimension statistics and distribution\n\n **Performance:**\n - Samples up to 1000 vectors for similarity calculations\n - Uses efficient SQL aggregations for counts\n - Results are cached for improved performance\n\n **Use Cases:**\n - Monitor vector quality and consistency\n - Identify storage optimization opportunities\n - Analyze vector clustering potential\n - Track vector statistics over time\n\n Args:\n project_id: UUID of the project\n namespace: Optional namespace filter\n sample_size: Maximum vectors to analyze (default: 1000, max: 10000)\n\n Returns:\n VectorAnalyticsResponse with comprehensive analytics","operationId":"get_vector_analytics_api_v1_projects__project_id__database_vectors_analytics_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional namespace filter","title":"Namespace"},"description":"Optional namespace filter"},{"name":"sample_size","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":10,"description":"Maximum vectors to analyze","default":1000,"title":"Sample Size"},"description":"Maximum vectors to analyze"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorAnalyticsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/vectors/cluster":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Run clustering on vectors","description":"Run clustering algorithms on project vectors to identify groups and patterns.\n\n **Algorithms:**\n\n 1. **KMeans** (default)\n - Best for: Well-separated, spherical clusters\n - Parameters: n_clusters (2-100)\n - Returns: Cluster centroids and inertia\n\n 2. **DBSCAN**\n - Best for: Arbitrary shapes, noise detection\n - Parameters: eps (distance threshold), min_samples\n - Returns: Variable clusters + noise points\n\n 3. **Hierarchical**\n - Best for: Nested cluster structures\n - Parameters: n_clusters (2-100)\n - Returns: Hierarchical cluster tree\n\n **Features:**\n - Analyzes up to 100,000 vectors (configurable)\n - Returns cluster centroids (first 10 dimensions)\n - Lists vector IDs per cluster (first 50)\n - Provides algorithm-specific metrics\n\n **Performance:**\n - Uses cosine distance for similarity\n - Optimized for high-dimensional embeddings\n - Samples large datasets for efficiency\n\n **Example Request:**\n ```json\n {\n \"algorithm\": \"kmeans\",\n \"n_clusters\": 5,\n \"namespace\": \"embeddings\",\n \"max_vectors\": 5000\n }\n ```\n\n Args:\n project_id: UUID of the project\n request: Clustering configuration\n\n Returns:\n VectorClusteringResponse with cluster assignments and metrics\n\n Raises:\n HTTPException: 400 for invalid parameters, 500 for clustering failures","operationId":"run_vector_clustering_api_v1_projects__project_id__database_vectors_cluster_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorClusteringRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorClusteringResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/memory":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Memory Operations"],"summary":"Create Memory Record","description":"Create a memory record","operationId":"create_memory_record_api_v1_projects__project_id__database_memory_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRecordCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Vector Operations","ZeroDB Memory Operations"],"summary":"List Memories","description":"List memory records for a project","operationId":"list_memories_api_v1_projects__project_id__database_memory_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMemoriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/memory/search":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Memory Operations"],"summary":"Search Memory","description":"Search memory records","operationId":"search_memory_api_v1_projects__project_id__database_memory_search_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_search_memory_api_v1_projects__project_id__database_memory_search_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__MemorySearchResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/memory/{memory_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Memory Operations"],"summary":"Get Memory Record","description":"Get a specific memory record by ID","operationId":"get_memory_record_api_v1_projects__project_id__database_memory__memory_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Memory Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["ZeroDB Vector Operations","ZeroDB Memory Operations"],"summary":"Update Memory Record","description":"Update a memory record","operationId":"update_memory_record_api_v1_projects__project_id__database_memory__memory_id__put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Memory Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_update_memory_record_api_v1_projects__project_id__database_memory__memory_id__put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","ZeroDB Memory Operations"],"summary":"Delete Memory Record","description":"Delete a memory record","operationId":"delete_memory_record_api_v1_projects__project_id__database_memory__memory_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Memory Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteMemoryRecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/events":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Event Operations"],"summary":"Create Event","description":"Create an event record","operationId":"create_event_api_v1_projects__project_id__database_events_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__EventCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__EventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"get":{"tags":["ZeroDB Vector Operations","ZeroDB Event Operations"],"summary":"List Events","description":"List events for a project with optional topic filter","operationId":"list_events_api_v1_projects__project_id__database_events_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by event topic","title":"Topic"},"description":"Filter by event topic"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Skip"},"description":"Number of records to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum number of records to return","default":100,"title":"Limit"},"description":"Maximum number of records to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/app__zerodb__schemas__database__EventResponse"},"title":"Response List Events Api V1 Projects Project Id Database Events Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/database/events/stats":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Event Operations"],"summary":"Get Event Stats","description":"Get event statistics for a project","operationId":"get_event_stats_api_v1_projects__project_id__database_events_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"time_range","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Time range: hour, day, week, month","default":"day","title":"Time Range"},"description":"Time range: hour, day, week, month"},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by event topic","title":"Topic"},"description":"Filter by event topic"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetEventStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/events/{event_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Event Operations"],"summary":"Get Event","description":"Get a specific event by ID","operationId":"get_event_api_v1_projects__project_id__database_events__event_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__EventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/files":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB File Operations"],"summary":"Upload File","description":"Upload a file to project storage","operationId":"upload_file_api_v1_projects__project_id__database_files_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Vector Operations","ZeroDB File Operations"],"summary":"List Files","description":"List all files in project storage","operationId":"list_files_api_v1_projects__project_id__database_files_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FileResponse"},"title":"Response List Files Api V1 Projects Project Id Database Files Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/files/stats":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB File Operations"],"summary":"Get File Stats","description":"Get file storage statistics for project","operationId":"get_file_stats_api_v1_projects__project_id__database_files_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__GetFileStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/files/{file_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB File Operations"],"summary":"Get File","description":"Get file metadata by ID","operationId":"get_file_api_v1_projects__project_id__database_files__file_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","ZeroDB File Operations"],"summary":"Delete File","description":"Delete a file from project storage","operationId":"delete_file_api_v1_projects__project_id__database_files__file_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__DeleteFileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/files/{file_id}/download":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB File Operations"],"summary":"Download File","description":"Download file content","operationId":"download_file_api_v1_projects__project_id__database_files__file_id__download_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__DownloadFileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/files/{file_id}/presigned-url":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB File Operations"],"summary":"Generate Presigned Url","description":"Generate presigned URL for file access","operationId":"generate_presigned_url_api_v1_projects__project_id__database_files__file_id__presigned_url_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_generate_presigned_url_api_v1_projects__project_id__database_files__file_id__presigned_url_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneratePresignedUrlResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/storage/upload":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB File Operations"],"summary":"Upload File Binary","description":"Upload binary file to MinIO storage","operationId":"upload_file_binary_api_v1_projects__project_id__database_storage_upload_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_file_binary_api_v1_projects__project_id__database_storage_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__UploadFileBinaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Create Rlhf Dataset","description":"Create RLHF dataset","operationId":"create_rlhf_dataset_api_v1_projects__project_id__database_rlhf_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFDatasetCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFDatasetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/interactions":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Log Rlhf Interaction","description":"Log RLHF interaction for learning","operationId":"log_rlhf_interaction_api_v1_projects__project_id__database_rlhf_interactions_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Interaction Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFInteractionLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"List Rlhf Interactions","description":"List RLHF interactions for project with optional filters","operationId":"list_rlhf_interactions_api_v1_projects__project_id__database_rlhf_interactions_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"feedback","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback"}},{"name":"model","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"reward_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward Min"}},{"name":"reward_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward Max"}},{"name":"tags","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"}},{"name":"start_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Time"}},{"name":"end_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFInteractionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/interactions/{interaction_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Get Rlhf Interaction","description":"Get specific RLHF interaction","operationId":"get_rlhf_interaction_api_v1_projects__project_id__database_rlhf_interactions__interaction_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"interaction_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Interaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFInteractionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Delete Rlhf Interaction","description":"Delete an RLHF interaction","operationId":"delete_rlhf_interaction_api_v1_projects__project_id__database_rlhf_interactions__interaction_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"interaction_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Interaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFInteractionDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/interactions/{interaction_id}/feedback":{"put":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Update Rlhf Feedback","description":"Update feedback for an RLHF interaction","operationId":"update_rlhf_feedback_api_v1_projects__project_id__database_rlhf_interactions__interaction_id__feedback_put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"interaction_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Interaction Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Feedback Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFInteractionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/stats":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Get Rlhf Stats","description":"Get RLHF statistics for project","operationId":"get_rlhf_stats_api_v1_projects__project_id__database_rlhf_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"time_range","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Range"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/export":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Export Rlhf Data","description":"Export RLHF training data in multiple formats\n\n**Supported Formats:**\n- **json**: Standard JSON array format\n- **csv**: Comma-separated values for spreadsheets\n- **parquet**: Apache Parquet columnar format (requires pandas and pyarrow)\n- **openai**: OpenAI fine-tuning JSONL format (compatible with GPT-3.5/4 fine-tuning)\n- **anthropic**: Anthropic Claude fine-tuning format (experimental)\n\n**Filters:**\n- start_date: ISO format date (e.g., \"2025-01-01T00:00:00Z\")\n- end_date: ISO format date\n- feedback: Filter by feedback type (positive, negative, mixed)\n- model: Filter by model name\n- session_id: Filter by session ID\n\n**Example Request (OpenAI format):**\n```json\n{\n \"format\": \"openai\",\n \"start_date\": \"2025-12-01T00:00:00Z\",\n \"feedback\": \"positive\"\n}\n```\n\n**CSV Format:**\nReturns CSV string with columns: interaction_id, prompt, response, feedback, reward, model, session_id, agent_id, human_feedback, created_at\n\n**Parquet Format:**\nReturns base64-encoded Parquet binary data with full schema information\n\n**OpenAI Format:**\nReturns JSONL with format: {\"messages\": [{\"role\": \"user\", \"content\": \"...\"}, {\"role\": \"assistant\", \"content\": \"...\"}]}","operationId":"export_rlhf_data_api_v1_projects__project_id__database_rlhf_export_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_export_rlhf_data_api_v1_projects__project_id__database_rlhf_export_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFExportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/interactions/batch":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Batch Create Rlhf Interactions","description":"Batch create multiple RLHF interactions\n\n**Use Case:** Import interactions from CSV, JSON, or other sources\n\n**Request Body:**\n```json\n[\n {\n \"prompt\": \"What is machine learning?\",\n \"response\": \"Machine learning is...\",\n \"feedback\": \"positive\",\n \"reward\": 0.9,\n \"model\": \"claude-opus-4-8\",\n \"session_id\": \"session-123\",\n \"agent_id\": \"agent-456\",\n \"human_feedback\": \"Great explanation!\",\n \"tags\": [\"ml\", \"education\"],\n \"context\": \"Educational context\",\n \"metadata\": {\"source\": \"import\"}\n }\n]\n```\n\n**Response:**\n```json\n{\n \"project_id\": \"uuid\",\n \"created_count\": 5,\n \"failed_count\": 0,\n \"created_interactions\": [\n {\"interaction_id\": \"uuid1\", \"status\": \"created\"},\n {\"interaction_id\": \"uuid2\", \"status\": \"created\"}\n ],\n \"errors\": []\n}\n```","operationId":"batch_create_rlhf_interactions_api_v1_projects__project_id__database_rlhf_interactions_batch_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Array of interaction objects to create","title":"Interactions"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFInteractionBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/interactions/compare":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Create Comparison Interaction","description":"Create comparison-based RLHF interaction\n\n**Use Case:** A/B testing of responses where user selects preferred response\n\n**Example Request:**\n```json\n{\n \"prompt\": \"Explain neural networks\",\n \"response_a\": \"Neural networks are computational models...\",\n \"response_b\": \"Neural networks are brain-inspired algorithms...\",\n \"preferred_response\": \"B\",\n \"model_a\": \"gpt-oss-120b\",\n \"model_b\": \"claude-opus-4-8\",\n \"feedback_comment\": \"Response B is more intuitive\",\n \"session_id\": \"session-123\"\n}\n```\n\n**Creates Two Interactions:**\n- Preferred response gets positive feedback (reward 1.0)\n- Non-preferred response gets negative feedback (reward -1.0)","operationId":"create_comparison_interaction_api_v1_projects__project_id__database_rlhf_interactions_compare_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_create_comparison_interaction_api_v1_projects__project_id__database_rlhf_interactions_compare_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFComparisonResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/interactions/single-review":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Create Single Review Interaction","description":"Create single review RLHF interaction with rating\n\n**Use Case:** Simple thumbs up/down or 5-star rating of a response\n\n**Example Request:**\n```json\n{\n \"prompt\": \"How do I deploy to production?\",\n \"response\": \"Here are the steps...\",\n \"rating\": 5,\n \"feedback_comment\": \"Very helpful and detailed!\",\n \"model\": \"claude-opus-4-8\",\n \"tags\": [\"deployment\", \"helpful\"],\n \"session_id\": \"session-123\"\n}\n```\n\n**Rating to Feedback Mapping:**\n- 5: positive (reward 1.0)\n- 4: positive (reward 0.5)\n- 3: mixed (reward 0.0)\n- 2: negative (reward -0.5)\n- 1: negative (reward -1.0)","operationId":"create_single_review_interaction_api_v1_projects__project_id__database_rlhf_interactions_single_review_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_create_single_review_interaction_api_v1_projects__project_id__database_rlhf_interactions_single_review_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSingleReviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/sessions":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"List Rlhf Sessions","description":"List RLHF sessions for project with optional filters","operationId":"list_rlhf_sessions_api_v1_projects__project_id__database_rlhf_sessions_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"start_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Time"}},{"name":"end_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Create Rlhf Session","description":"Create a new RLHF session","operationId":"create_rlhf_session_api_v1_projects__project_id__database_rlhf_sessions_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFSessionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/sessions/{session_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Get Rlhf Session","description":"Get specific RLHF session details","operationId":"get_rlhf_session_api_v1_projects__project_id__database_rlhf_sessions__session_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFSessionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Update Rlhf Session","description":"Update an existing RLHF session","operationId":"update_rlhf_session_api_v1_projects__project_id__database_rlhf_sessions__session_id__put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFSessionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Delete Rlhf Session","description":"Delete an RLHF session","operationId":"delete_rlhf_session_api_v1_projects__project_id__database_rlhf_sessions__session_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/sessions/{session_id}/start":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Start Rlhf Session","description":"Start an RLHF session (set status to active)","operationId":"start_rlhf_session_api_v1_projects__project_id__database_rlhf_sessions__session_id__start_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/sessions/{session_id}/stop":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Stop Rlhf Session","description":"Stop an RLHF session (set status to stopped)","operationId":"stop_rlhf_session_api_v1_projects__project_id__database_rlhf_sessions__session_id__stop_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/start":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Start Rlhf Session Simple","description":"Start a new RLHF session or resume existing one","operationId":"start_rlhf_session_simple_api_v1_projects__project_id__database_rlhf_start_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/rlhf/stop":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB RLHF Operations"],"summary":"Stop Rlhf Session Simple","description":"Stop an RLHF session","operationId":"stop_rlhf_session_simple_api_v1_projects__project_id__database_rlhf_stop_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/agent-logs":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Agent Operations"],"summary":"Create Agent Log","description":"Create agent execution log","operationId":"create_agent_log_api_v1_projects__project_id__database_agent_logs_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Vector Operations","ZeroDB Agent Operations"],"summary":"List Agent Logs","description":"List agent logs with optional filtering","operationId":"list_agent_logs_api_v1_projects__project_id__database_agent_logs_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id"}},{"name":"log_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Log Level"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentLogResponse"},"title":"Response List Agent Logs Api V1 Projects Project Id Database Agent Logs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/agent-logs/stats":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Agent Operations"],"summary":"Get Agent Logs Stats","description":"Get agent logs statistics","operationId":"get_agent_logs_stats_api_v1_projects__project_id__database_agent_logs_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAgentLogsStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/agent-logs/{log_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Agent Operations"],"summary":"Get Agent Log","description":"Get a specific agent log by ID","operationId":"get_agent_log_api_v1_projects__project_id__database_agent_logs__log_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"log_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Log Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Vector Operations","ZeroDB Agent Operations"],"summary":"Delete Agent Log","description":"Delete an agent log entry\n\nNOTE (pre-existing bug, out of scope -- Refs AINative-Studio/ainative-website#2191\ntyping pass, not fixed here per surgical-changes rule): this handler does not\ndelete anything. It returns the same aggregate stats payload as\nget_agent_logs_stats (apparent copy/paste). The response_model documents the\nREAL current shape so OpenAPI stays accurate; it does not endorse the behavior.","operationId":"delete_agent_log_api_v1_projects__project_id__database_agent_logs__log_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"log_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Log Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAgentLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/agents/active":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Agent Operations"],"summary":"List Active Agents","description":"List active agents for project","operationId":"list_active_agents_api_v1_projects__project_id__database_agents_active_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListActiveAgentsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/agents/traces":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Agent Operations"],"summary":"List Agent Traces","description":"List agent execution traces","operationId":"list_agent_traces_api_v1_projects__project_id__database_agents_traces_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAgentTracesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/agent-logs/export":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Agent Operations"],"summary":"Export Agent Logs","description":"Export agent logs in specified format","operationId":"export_agent_logs_api_v1_projects__project_id__database_agent_logs_export_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_export_agent_logs_api_v1_projects__project_id__database_agent_logs_export_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportAgentLogsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/query":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB SQL Query Execution"],"summary":"Execute Sql Query","description":"Execute SQL query against project's dedicated PostgreSQL instance\n\n**Security Features:**\n- Automatic SQL injection detection using pattern matching\n- Dangerous command blacklist (DROP DATABASE, TRUNCATE, ALTER SYSTEM, etc.)\n- Configurable timeout enforcement (30s default, 5min max)\n- Read-only mode option for SELECT-only queries\n- Query complexity scoring for accurate billing\n\n**Billing:**\n- Base cost: 0.1 credits per query\n- Execution time: 0.01 credits per 100ms\n- Complexity factor: 0.01 credits per complexity point\n\n**Query Types Supported:**\n- SELECT: Read data from tables\n- INSERT: Add new records\n- UPDATE: Modify existing records\n- DELETE: Remove records\n\n**Usage Examples:**\n\nSimple SELECT:\n```json\n{\n \"sql\": \"SELECT * FROM users LIMIT 10\",\n \"timeout_seconds\": 30,\n \"max_rows\": 100\n}\n```\n\nComplex Analytics:\n```json\n{\n \"sql\": \"SELECT DATE(created_at) as date, COUNT(*) as count FROM orders WHERE created_at > NOW() - INTERVAL '30 days' GROUP BY DATE(created_at) ORDER BY date DESC\",\n \"timeout_seconds\": 60,\n \"max_rows\": 1000\n}\n```\n\nRead-Only Mode:\n```json\n{\n \"sql\": \"SELECT * FROM products\",\n \"read_only\": true,\n \"timeout_seconds\": 30\n}\n```\n\n**Error Codes:**\n- 400: SQL validation failed (dangerous command or injection detected)\n- 404: No PostgreSQL instance found (provision one first)\n- 408: Query timeout exceeded\n- 500: Query execution error\n\n**Rate Limits:**\n- 100 queries per minute per user (future implementation)\n- 500 queries per minute per project (future implementation)","operationId":"execute_sql_query_api_v1_projects__project_id__database_query_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryExecutionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/export":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Database Operations"],"summary":"Create database export job","description":"Start an async database export job. Supports JSON, CSV, Parquet, and PostgreSQL dump formats.","operationId":"export_database_api_v1_projects__project_id__database_export_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseExportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseExportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/exports/{export_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Database Operations"],"summary":"Get export job status","description":"Check the status of an export job and get the download URL when completed.","operationId":"get_export_status_api_v1_projects__project_id__database_exports__export_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"export_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Export Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseExportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/import":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Database Operations"],"summary":"Start database import","description":"Import data from various sources (JSON, CSV, URL, PostgreSQL backup, or previous export).\n\n **Import Sources:**\n - `json`: Import from JSON data (requires `file_content` as base64)\n - `csv`: Import from CSV data (requires `file_content` as base64)\n - `file_url`: Download and import from URL (requires `file_url`)\n - `export_id`: Re-import from previous export (requires `export_id`)\n - `postgresql_backup`: Restore from PostgreSQL backup (requires `backup_id`)\n\n **Merge Strategies:**\n - `skip`: Skip existing records (default)\n - `overwrite`: Replace existing records\n - `merge`: Merge metadata, keep latest embedding\n\n **Process:**\n 1. Creates import job and validates request\n 2. Validates schema if `validate_schema=true`\n 3. Creates rollback snapshot if `overwrite_existing=true`\n 4. Imports records with chosen merge strategy\n 5. Returns import job status (poll GET endpoint for progress)\n\n **Security:**\n - File URLs must be from allowed domains\n - Maximum file size: 500MB\n - SQL injection protection for PostgreSQL imports","operationId":"import_database_api_v1_projects__project_id__database_import_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseImportRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/imports/{import_id}":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Database Operations"],"summary":"Get import status","description":"Get the current status of a database import operation.\n\n **Status Values:**\n - `pending`: Import job created, waiting to start\n - `validating`: Validating data schema\n - `in_progress`: Actively importing data\n - `completed`: Import finished successfully\n - `failed`: Import failed (check error_message)\n - `rollback`: Import being rolled back\n\n **Progress Tracking:**\n - `progress_percent`: 0-100 completion percentage\n - `records_imported`: Number of records successfully imported\n - `records_failed`: Number of records that failed\n - `records_skipped`: Number of records skipped (duplicates)\n - `records_total`: Total records to import\n\n **Polling Recommendation:**\n - Poll every 2-5 seconds while status is `validating` or `in_progress`\n - Stop polling when status is `completed`, `failed`, or `rollback`","operationId":"get_import_status_api_v1_projects__project_id__database_imports__import_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"import_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Import Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/imports/{import_id}/rollback":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Database Operations"],"summary":"Rollback import","description":"Rollback a failed or unwanted database import.\n\n **Requirements:**\n - Import must have `rollback_available=true`\n - Rollback snapshot must exist\n\n **Process:**\n 1. Changes import status to `rollback`\n 2. Deletes records created during import\n 3. Restores database state from snapshot\n 4. Marks import as `failed` with rollback message\n\n **Note:** Rollback is only available for imports with `overwrite_existing=true`","operationId":"rollback_import_api_v1_projects__project_id__database_imports__import_id__rollback_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"import_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Import Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/analytics/stats":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Analytics"],"summary":"Get project analytics statistics","description":"Get comprehensive analytics for the project including vector stats, query metrics, and performance data. Used by Analytics dashboard.","operationId":"get_project_analytics_stats_api_v1_projects__project_id__analytics_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetProjectAnalyticsStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/stats":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Analytics"],"summary":"Get overall project statistics","description":"Get comprehensive project statistics including counts of all resources. Used by main Dashboard overview.","operationId":"get_project_stats_api_v1_projects__project_id__stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetProjectStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/public/{project_id}/database/agents/types":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Agent Operations"],"summary":"Get list of agent types","description":"Get list of unique agent types for filtering in Agent Logs page. Public endpoint for frontend filtering.","operationId":"get_agent_types_api_v1_projects_public__project_id__database_agents_types_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAgentTypesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/namespaces":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Get list of vector namespaces","description":"Get list of available vector namespaces with counts. Used by Semantic Search page for namespace filtering.","operationId":"get_vector_namespaces_api_v1_projects__project_id__database_namespaces_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetVectorNamespacesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/namespaces/{name}":{"delete":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Flush all vectors in a namespace","description":"Delete all vectors in a namespace for clean re-indexing. Requires confirm=true query parameter.","operationId":"flush_namespace_api_v1_projects__project_id__database_namespaces__name__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","description":"Must be true to confirm deletion","default":false,"title":"Confirm"},"description":"Must be true to confirm deletion"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlushNamespaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/namespaces/{name}/deduplicate":{"post":{"tags":["ZeroDB Vector Operations","ZeroDB Vector Operations"],"summary":"Deduplicate vectors in a namespace","description":"Remove duplicate vectors (by document content MD5) keeping the newest copy of each.","operationId":"deduplicate_namespace_api_v1_projects__project_id__database_namespaces__name__deduplicate_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeduplicateNamespaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/connection":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Database Management"],"summary":"Get database connection information","description":"Get database connection details for the project's PostgreSQL instance.\n\n **Information Included:**\n - Database host and port\n - Database name\n - Connection status (active, inactive, provisioning)\n - Masked connection string (password hidden)\n\n **Status Values:**\n - `active`: Database is running and accessible\n - `inactive`: Database is stopped or unreachable\n - `provisioning`: Database is being provisioned\n\n **Use Cases:**\n - Database Settings page display\n - Connection string generation for clients\n - Status monitoring","operationId":"get_database_connection_api_v1_projects__project_id__database_connection_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseConnectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/backups":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Database Management"],"summary":"Get database backups","description":"Get list of database backups for the project.\n\n **Backup Information:**\n - Backup ID (unique identifier)\n - Creation timestamp\n - Size in megabytes\n - Status (completed, failed, in_progress)\n\n **Pagination:**\n - Use `skip` and `limit` query parameters\n - Default: skip=0, limit=50\n - Maximum limit: 1000\n\n **Use Cases:**\n - Database Settings page backup listing\n - Backup restoration workflows\n - Storage usage monitoring","operationId":"get_database_backups_api_v1_projects__project_id__database_backups_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of backups to skip","default":0,"title":"Skip"},"description":"Number of backups to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum backups to return","default":50,"title":"Limit"},"description":"Maximum backups to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseBackupsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/extensions":{"get":{"tags":["ZeroDB Vector Operations","ZeroDB Database Management"],"summary":"Get PostgreSQL extensions","description":"Get list of installed PostgreSQL extensions for the project.\n\n **Extension Information:**\n - Extension name (e.g., pg_vector, uuid-ossp)\n - Version number\n - Description\n\n **Common Extensions:**\n - `pg_vector`: Vector similarity search\n - `uuid-ossp`: UUID generation\n - `pg_stat_statements`: Query performance tracking\n - `pg_trgm`: Trigram matching for text search\n\n **Use Cases:**\n - Database Settings page extensions listing\n - Feature availability checking\n - Extension installation guidance","operationId":"get_database_extensions_api_v1_projects__project_id__database_extensions_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseExtensionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/{project_id}/embeddings/generate":{"post":{"tags":["ZeroDB Embeddings - Public"],"summary":"Generate Project Embeddings","description":"Generate embeddings within a ZeroDB project context (Issue #310: Multi-Model Support)\n\n**FREE - No usage costs!**\nUses Railway self-hosted HuggingFace service\n\n**Supported Models:**\n- `BAAI/bge-small-en-v1.5` (384-dim) - Default, fastest\n- `BAAI/bge-base-en-v1.5` (768-dim) - Better quality\n- `BAAI/bge-large-en-v1.5` (1024-dim) - Best quality\n\n**Parameters:**\n- `texts`: List of texts to embed (1-100)\n- `model`: Model to use (optional, defaults to BAAI/bge-small-en-v1.5)\n- `normalize`: Normalize embeddings to unit length (default: true)\n\n**Returns:**\n- `embeddings`: List of embedding vectors\n- `model`: Model used\n- `dimensions`: Vector dimensions (384, 768, or 1024)\n- `count`: Number of embeddings generated\n- `processing_time_ms`: Generation time in milliseconds\n- `project_id`: Project UUID\n\n**Example:**\n```python\nPOST /v1/{project_id}/embeddings/generate\n{\n \"texts\": [\"ZeroDB is a vector database\"],\n \"model\": \"BAAI/bge-base-en-v1.5\" # Optional, uses small by default\n}\n```\n\n**Backward Compatible:** Calls without `model` parameter use default (384-dim)","operationId":"generate_project_embeddings_api_v1_public__project_id__embeddings_generate_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__GenerateEmbeddingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__GenerateEmbeddingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/public/{project_id}/embeddings/embed-and-store":{"post":{"tags":["ZeroDB Embeddings - Public"],"summary":"Embed And Store In Project","description":"Generate embeddings and automatically store in ZeroDB project\nwith automatic dimension detection and routing (Issues #309, #310)\n\n**Optimized for RAG workflows:**\n1. Generate embeddings (FREE via Railway service)\n2. Auto-detect dimension (384, 768, 1024, or 1536)\n3. Route to correct database column (vector_384, vector_768, etc.)\n4. Store vectors in project's ZeroDB database\n5. Ready for semantic search immediately\n\n**Supported Models:**\n- `BAAI/bge-small-en-v1.5` (384-dim) - Default, fastest, FREE\n- `BAAI/bge-base-en-v1.5` (768-dim) - Better quality, FREE\n- `BAAI/bge-large-en-v1.5` (1024-dim) - Best quality, FREE\n- Custom 1536-dim (OpenAI compatible)\n\n**Parameters:**\n- `texts`: List of texts to embed and store (1-100)\n- `model`: Model to use (optional, defaults to BAAI/bge-small-en-v1.5)\n- `metadata_list`: Optional metadata for each text\n- `namespace`: Vector namespace (default: \"default\")\n\n**Returns:**\n- `success`: Boolean indicating success\n- `vectors_stored`: Number of vectors stored\n- `embeddings_generated`: Number of embeddings generated\n- `model`: Model used\n- `dimensions`: Detected dimension (384, 768, 1024, or 1536)\n- `target_column`: Database column where vectors are stored\n- `namespace`: Namespace used\n- `project_id`: Project UUID\n- `processing_time_ms`: Total processing time\n\n**Example:**\n```python\nPOST /v1/{project_id}/embeddings/embed-and-store\n{\n \"texts\": [\"Document 1\", \"Document 2\"],\n \"model\": \"BAAI/bge-base-en-v1.5\", # Optional\n \"namespace\": \"my_docs\"\n}\n\n# Response\n{\n \"success\": true,\n \"vectors_stored\": 2,\n \"dimensions\": 768,\n \"target_column\": \"vector_768\", # Auto-detected routing\n ...\n}\n```\n\n**Backward Compatible:** Calls without `model` parameter use default (384-dim)","operationId":"embed_and_store_in_project_api_v1_public__project_id__embeddings_embed_and_store_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__EmbedAndStoreRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__EmbedAndStoreResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/{project_id}/embeddings/search":{"post":{"tags":["ZeroDB Embeddings - Public"],"summary":"Semantic Search In Project","description":"Semantic search within a ZeroDB project with dimension-aware routing (Issues #309, #310)\n\n**Optimized for RAG:**\n1. Generate query embedding (FREE via Railway service)\n2. Auto-detect dimension and search correct column\n3. Return most relevant documents\n\n**Parameters:**\n- `query`: Search query text\n- `model`: Model to use (must match stored vectors' model, defaults to BAAI/bge-small-en-v1.5)\n- `limit`: Maximum results (1-100, default: 10)\n- `threshold`: Similarity threshold (0.0-1.0, default: 0.7)\n- `namespace`: Vector namespace (default: \"default\")\n- `filter_metadata`: Optional metadata filters\n\n**Returns:**\n- `results`: List of matching vectors with metadata\n- `query`: Original search query\n- `total_results`: Total number of results\n- `model`: Model used for query embedding\n- `project_id`: Project UUID\n- `processing_time_ms`: Search time in milliseconds\n\n**Important:** Use the same model you used when storing vectors!\n- If you stored with `BAAI/bge-base-en-v1.5` (768-dim), search with same model\n- Mixing dimensions will result in poor search quality\n\n**Example:**\n```python\nPOST /v1/{project_id}/embeddings/search\n{\n \"query\": \"What is ZeroDB?\",\n \"model\": \"BAAI/bge-base-en-v1.5\", # Match your stored vectors' model\n \"limit\": 5,\n \"threshold\": 0.75\n}\n\n# Response\n{\n \"results\": [\n {\n \"id\": \"vec_123\",\n \"document\": \"ZeroDB is a vector database...\",\n \"similarity\": 0.92,\n \"metadata\": {...}\n }\n ],\n \"total_results\": 5,\n \"model\": \"BAAI/bge-base-en-v1.5\",\n ...\n}\n```\n\n**Backward Compatible:** Calls without `model` parameter use default (384-dim)","operationId":"semantic_search_in_project_api_v1_public__project_id__embeddings_search_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__SemanticSearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__SemanticSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/{project_id}/embeddings/models":{"get":{"tags":["ZeroDB Embeddings - Public"],"summary":"List Available Embedding Models","description":"List available embedding models for a ZeroDB project (Issue #310)\n\n**Supported Models:**\n- BAAI/bge-small-en-v1.5 (384-dim) - Default, fastest, FREE\n- BAAI/bge-base-en-v1.5 (768-dim) - Better quality, FREE\n- BAAI/bge-large-en-v1.5 (1024-dim) - Best quality, FREE\n\n**Use Cases:**\n- **384-dim**: General-purpose, cost-sensitive (80% of users)\n- **768-dim**: Higher quality search (15% of users)\n- **1024-dim**: Mission-critical search (5% of users)\n\nReturns:\n List of available models with metadata","operationId":"list_available_embedding_models_api_v1_public__project_id__embeddings_models_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/app__zerodb__api__embeddings__EmbeddingModelInfo"},"title":"Response List Available Embedding Models Api V1 Public Project Id Embeddings Models Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/batch/query":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Execute batch query operations","description":"Execute multiple table operations (query, insert, update, delete) in a single request. Supports up to 50 operations per batch with optional parallel execution. MongoDB-style filters are supported for query/update/delete operations.","operationId":"batch_query_operations_api_v1_public_zerodb__project_id__database_batch_query_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchQueryRequest","description":"Batch query request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/memory/batch/upsert":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Batch upsert memory records","description":"Create or update multiple memory records in a single atomic transaction. Supports up to 500 records per batch with automatic rollback on failure.","operationId":"batch_upsert_memories_api_v1_public_zerodb__project_id__database_memory_batch_upsert_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryUpsertRequest","description":"Batch memory upsert request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryUpsertResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/memory/batch/delete":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Batch delete memory records","description":"Delete multiple memory records by ID in a single request. Supports up to 500 IDs per batch.","operationId":"batch_delete_memories_api_v1_public_zerodb__project_id__database_memory_batch_delete_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryDeleteRequest","description":"Batch memory delete request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/memory/batch/update":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Batch update memory records","description":"Update multiple memory records with partial field updates. Supports up to 500 updates per batch.","operationId":"batch_update_memories_api_v1_public_zerodb__project_id__database_memory_batch_update_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryUpdatesRequest","description":"Batch memory update request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMemoryUpdatesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/events/batch":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Batch Operations","ZeroDB Batch Operations"],"summary":"Batch publish events","description":"Publish multiple events in a single request for high-throughput event streaming. Supports up to 100 events per batch with individual validation.","operationId":"batch_publish_events_api_v1_public_zerodb__project_id__database_events_batch_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEventPublishRequest","description":"Batch event publish request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEventPublishResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/events/subscriptions":{"get":{"tags":["ZeroDB Database - Public","Event Subscriptions","Event Subscriptions"],"summary":"List event subscriptions","description":"Get all event subscriptions for a project","operationId":"list_subscriptions_api_v1_public_zerodb__project_id__database_events_subscriptions_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ZeroDB Database - Public","Event Subscriptions","Event Subscriptions"],"summary":"Create event subscription","description":"Create a new event subscription for a project","operationId":"create_subscription_api_v1_public_zerodb__project_id__database_events_subscriptions_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/events/subscriptions/{subscription_id}":{"delete":{"tags":["ZeroDB Database - Public","Event Subscriptions","Event Subscriptions"],"summary":"Delete event subscription","description":"Delete an event subscription by ID","operationId":"delete_subscription_api_v1_public_zerodb__project_id__database_events_subscriptions__subscription_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Subscription ID","title":"Subscription Id"},"description":"Subscription ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/agent-logs/subscribe":{"post":{"tags":["ZeroDB Database - Public","Agent Logs","Agent Logs"],"summary":"Subscribe to live agent log streaming","description":"Create a durable subscription handle, then return the WebSocket URL\nthe client connects to for the actual real-time log stream.","operationId":"subscribe_agent_logs_api_v1_public_zerodb__project_id__database_agent_logs_subscribe_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogSubscribeRequest","default":{"filter":{}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogSubscribeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/agent-logs/subscribe/{subscription_id}":{"delete":{"tags":["ZeroDB Database - Public","Agent Logs","Agent Logs"],"summary":"Unsubscribe from live agent log streaming","operationId":"unsubscribe_agent_logs_api_v1_public_zerodb__project_id__database_agent_logs_subscribe__subscription_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Project ID","title":"Project Id"},"description":"Project ID"},{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Subscription ID","title":"Subscription Id"},"description":"Subscription ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventSubscriptionDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/metrics":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Database Management"],"summary":"Get database performance metrics","description":"Get real-time database performance metrics for monitoring and optimization.\n\n **Metrics Included:**\n - Active database connections\n - Queries per second (QPS)\n - Cache hit rate (0.0 - 1.0)\n - Average query latency in milliseconds\n\n **Use Cases:**\n - Database Settings page monitoring\n - Performance dashboards\n - Alerting on threshold breaches\n - Capacity planning","operationId":"get_database_metrics_api_v1_public_zerodb__project_id__database_metrics_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__DatabaseMetricsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/maintenance/vacuum":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Settings & Maintenance","ZeroDB Database Management"],"summary":"Run VACUUM on database","description":"Execute PostgreSQL VACUUM operation to reclaim storage and optimize performance.\n\n **VACUUM Operations:**\n - `VACUUM`: Standard vacuum operation (reclaim space from deleted rows)\n - `VACUUM ANALYZE`: Vacuum + update statistics for query planner\n - `VACUUM FULL`: Complete table rewrite (locks tables, reclaims maximum space)\n\n **When to Use:**\n - After bulk deletions\n - Regular maintenance (weekly/monthly)\n - When disk space is needed\n - Query performance degradation\n\n **Note:** VACUUM FULL requires exclusive table locks and may take longer.","operationId":"vacuum_database_api_v1_public_zerodb__project_id__database_maintenance_vacuum_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_vacuum_database_api_v1_public_zerodb__project_id__database_maintenance_vacuum_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VacuumDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/maintenance/analyze":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Settings & Maintenance","ZeroDB Database Management"],"summary":"Run ANALYZE to update statistics","description":"Execute PostgreSQL ANALYZE operation to update query planner statistics.\n\n **What it Does:**\n - Collects statistics about table contents\n - Updates query planner optimization data\n - Improves query performance by enabling better execution plans\n\n **When to Use:**\n - After bulk INSERT/UPDATE/DELETE operations\n - When query plans are suboptimal\n - Regular maintenance (weekly)\n - After schema changes\n\n **Note:** This operation is lightweight and doesn't lock tables.","operationId":"analyze_database_api_v1_public_zerodb__project_id__database_maintenance_analyze_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_analyze_database_api_v1_public_zerodb__project_id__database_maintenance_analyze_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/maintenance/reindex":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Settings & Maintenance","ZeroDB Database Management"],"summary":"Rebuild database indexes","description":"Execute PostgreSQL REINDEX operation to rebuild corrupted or bloated indexes.\n\n **What it Does:**\n - Rebuilds all indexes from scratch\n - Fixes index corruption\n - Reduces index bloat\n - Improves query performance\n\n **When to Use:**\n - Suspected index corruption\n - Significant index bloat after many updates\n - Performance degradation despite VACUUM/ANALYZE\n - After major data changes\n\n **Note:** REINDEX requires exclusive table locks and may take time.","operationId":"reindex_database_api_v1_public_zerodb__project_id__database_maintenance_reindex_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_reindex_database_api_v1_public_zerodb__project_id__database_maintenance_reindex_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReindexDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/settings/quantum-compression":{"put":{"tags":["ZeroDB Database - Public","ZeroDB Settings & Maintenance","ZeroDB Database Management"],"summary":"Toggle quantum compression for project","description":"Enable or disable TurboQuant compression for vector storage.\n\n **TurboQuant Compression Benefits:**\n - Up to 60% reduction in vector storage size\n - Preserved similarity relationships\n - Faster vector searches (smaller index)\n - Lower memory footprint\n\n **Algorithms Available:**\n - `quantum_harmonic`: Frequency domain compression (recommended) — maps to TurboQuant frequency transform\n - `sparse_encode`: Sparsity-based compression — maps to TurboQuant sparse quantization\n - `entropy_reduce`: PCA-based compression — maps to TurboQuant dimensionality reduction\n\n **Note:** Enabling compression will compress future vectors.\n Existing vectors can be compressed using the batch compression endpoint.","operationId":"toggle_quantum_compression_api_v1_public_zerodb__project_id__database_settings_quantum_compression_put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_toggle_quantum_compression_api_v1_public_zerodb__project_id__database_settings_quantum_compression_put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToggleQuantumCompressionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Database Management"],"summary":"Enable Database","description":"Enable ZeroDB for an existing project\nCreates database instance and returns configuration","operationId":"enable_database_api_v1_public_zerodb__project_id__database_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnableDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Database - Public","ZeroDB Database Management"],"summary":"Get Database Status","description":"Get database status and configuration for a project","operationId":"get_database_status_api_v1_public_zerodb__project_id__database_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDatabaseStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["ZeroDB Database - Public","ZeroDB Database Management"],"summary":"Update Database Config","description":"Update database configuration for a project\n\nSupports updating both top-level fields and database_config dictionary:\n- quantum_enabled: bool - Enable/disable quantum compression\n- vector_dimensions: int - Set vector embedding dimensions\n- mcp_enabled: bool - Enable/disable MCP features\n- database_config: dict - Additional configuration options","operationId":"update_database_config_api_v1_public_zerodb__project_id__database_put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Config"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDatabaseConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Database - Public","ZeroDB Database Management"],"summary":"Disable Database","description":"Disable database features for a project","operationId":"disable_database_api_v1_public_zerodb__project_id__database_delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisableDatabaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/tables":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Table Management"],"summary":"Create Table","description":"Create a new table in project database","operationId":"create_table_api_v1_public_zerodb__project_id__database_tables_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBTableCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBTableResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Database - Public","ZeroDB Table Management"],"summary":"List Tables","description":"List all tables in project database with pagination metadata\n\nReturns paginated response with:\n- total: Total number of tables in project\n- skip: Number of tables skipped\n- limit: Maximum tables per page\n- has_more: Whether more tables are available\n- data: List of table objects","operationId":"list_tables_api_v1_public_zerodb__project_id__database_tables_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedTablesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/tables/{table_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Table Management"],"summary":"Get Table","description":"Get table details","operationId":"get_table_api_v1_public_zerodb__project_id__database_tables__table_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Table Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBTableResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/tables/{table_name}/rows":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Row Operations"],"summary":"Create Row","description":"Insert a new row into a table","operationId":"create_row_api_v1_public_zerodb__project_id__database_tables__table_name__rows_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"get":{"tags":["ZeroDB Database - Public","ZeroDB Row Operations"],"summary":"List Rows","description":"Read all rows from a table with pagination metadata\n\nReturns paginated response with:\n- total: Total number of rows in table\n- skip: Number of rows skipped\n- limit: Maximum rows per page\n- has_more: Whether more rows are available\n- data: List of row objects\n\nUse `exclude_data=true` for list views that only need metadata (Refs #4713).\nUse `filter` to narrow results server-side (Refs #7471) — pass a JSON object,\nsame shape and operators as `POST .../query`'s `filter` field.","operationId":"list_rows_api_v1_public_zerodb__project_id__database_tables__table_name__rows_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"exclude_data","in":"query","required":false,"schema":{"type":"boolean","description":"Exclude row_data from response (metadata only). Refs #4713","default":false,"title":"Exclude Data"},"description":"Exclude row_data from response (metadata only). Refs #4713"},{"name":"filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"JSON object of field->value (direct equality) or field->{$op: value} (MongoDB-style operator) conditions, applied server-side against row_data. Refs #7471: this endpoint accepted a filter parameter in name only — every consumer got every row back and had to re-filter client-side, which is both a correctness/tenant-isolation risk and the source of full-table-scan latency on busy tables. Same operator set and semantics as POST .../query's filter (see MongoFilterTranslator).","title":"Filter"},"description":"JSON object of field->value (direct equality) or field->{$op: value} (MongoDB-style operator) conditions, applied server-side against row_data. Refs #7471: this endpoint accepted a filter parameter in name only — every consumer got every row back and had to re-filter client-side, which is both a correctness/tenant-isolation risk and the source of full-table-scan latency on busy tables. Same operator set and semantics as POST .../query's filter (see MongoFilterTranslator)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedRowsResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Project or resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/tables/{table_name}/rows/batch":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Bulk Operations"],"summary":"Create Rows Batch","description":"Insert many rows into a table in a single request.\n\nSo an agent populating a table does not need to loop one\n`POST .../rows` call per row (AX audit,\nRefs AINative-Studio/ainative-website#2211).\n\n**Partial-failure semantics:** each row is inserted independently. A row\nthat fails (e.g. a per-row storage-limit violation) is reported in\n`errors` (with its index into the request `rows` array) and does **not**\nfail the rest of the batch — this matches the existing\n`POST .../vectors/upsert-batch` endpoint. A request-level failure (the\ntable itself does not exist) still fails the whole request with a 404,\nsince there is nowhere to insert any row.\n\n**Example Request:**\n```json\n{\n \"rows\": [\n {\"row_data\": {\"name\": \"Alice\", \"status\": \"active\"}},\n {\"row_data\": {\"name\": \"Bob\", \"status\": \"pending\"}}\n ]\n}\n```\n\n**Returns:**\n- `created` - successfully inserted rows, in request order\n- `errors` - per-row `{index, error}` entries for rows that failed\n- `success_count` / `error_count`\n- `total_time_ms` - total operation time","operationId":"create_rows_batch_api_v1_public_zerodb__project_id__database_tables__table_name__rows_batch_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkRowCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkRowCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/tables/{table_name}/query":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Row Operations"],"summary":"Query Rows Mongo Style","description":"Query table rows using MongoDB-style filters and operators\n\n**Supported Filter Operators:**\n- `$eq`: Equals (e.g., {\"status\": {\"$eq\": \"active\"}})\n- `$ne`: Not equals (e.g., {\"status\": {\"$ne\": \"deleted\"}})\n- `$gt`: Greater than (e.g., {\"age\": {\"$gt\": 18}})\n- `$gte`: Greater than or equal (e.g., {\"age\": {\"$gte\": 18}})\n- `$lt`: Less than (e.g., {\"price\": {\"$lt\": 100}})\n- `$lte`: Less than or equal (e.g., {\"price\": {\"$lte\": 100}})\n- `$in`: Value in array (e.g., {\"status\": {\"$in\": [\"active\", \"pending\"]}})\n- `$nin`: Value not in array (e.g., {\"status\": {\"$nin\": [\"deleted\", \"banned\"]}})\n- `$contains`: String/array contains (e.g., {\"tags\": {\"$contains\": \"premium\"}})\n- `$regex`: Regex pattern match (e.g., {\"email\": {\"$regex\": \".*@gmail\\.com$\"}})\n- `$elemMatch`: Match inside a JSONB array field — returns rows where any\n array element satisfies all inner conditions (e.g.,\n {\"arts_and_ranks\": {\"$elemMatch\": {\"art\": {\"$icontains\": \"Judo\"}}}}).\n Inner conditions accept the same operators ($eq, $ne, $icontains,\n $contains, $in, $gt, $gte, $lt, $lte, $regex, $ieq).\n\n**Sort Specification:**\n- Use 1 for ascending order, -1 for descending order\n- Example: {\"created_at\": -1, \"name\": 1}\n\n**Security Features:**\n- Automatic SQL injection prevention via parameterized queries\n- Field name validation (alphanumeric, underscore, dot only)\n- Maximum result limit enforcement (10,000 rows)\n- Operator whitelist validation\n\n**Example Request:**\n```json\n{\n \"filter\": {\n \"age\": {\"$gte\": 18},\n \"status\": {\"$in\": [\"active\", \"pending\"]},\n \"tags\": {\"$contains\": \"premium\"},\n \"email\": {\"$regex\": \".*@gmail\\.com$\"}\n },\n \"sort\": {\"created_at\": -1},\n \"limit\": 50,\n \"skip\": 0\n}\n```\n\n**Example Response:**\n```json\n{\n \"total\": 245,\n \"skip\": 0,\n \"limit\": 50,\n \"has_more\": true,\n \"filter_summary\": {\n \"age\": {\"$gte\": 18},\n \"status\": {\"$in\": [\"active\", \"pending\"]}\n },\n \"execution_time_ms\": 45.23,\n \"data\": [\n {\n \"row_id\": \"uuid\",\n \"project_id\": \"uuid\",\n \"table_id\": \"uuid\",\n \"table_name\": \"users\",\n \"row_data\": {\"age\": 25, \"status\": \"active\", ...},\n \"created_at\": \"2025-12-03T10:00:00Z\",\n \"updated_at\": \"2025-12-03T10:00:00Z\"\n }\n ]\n}\n```\n\n**Error Codes:**\n- 400: Invalid filter operator, field name, or dangerous pattern detected\n- 404: Table not found\n- 500: Query execution error","operationId":"query_rows_mongo_style_api_v1_public_zerodb__project_id__database_tables__table_name__query_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MongoQueryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MongoQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/tables/{table_name}/count":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Row Operations"],"summary":"Count Rows Get","description":"Get total row count for a table (no filter, no body required).\nReturns: {\"count\": N, \"table\": \"table_name\"}\n\nRefs #4969","operationId":"count_rows_get_api_v1_public_zerodb__project_id__database_tables__table_name__count_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountRowsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ZeroDB Database - Public","ZeroDB Row Operations"],"summary":"Count Rows","description":"Count rows matching a filter without returning the rows themselves.\nUseful for pagination metadata and analytics on large tables.\n\nReturns: {\"count\": N, \"table\": \"table_name\", \"filter_summary\": {...}}","operationId":"count_rows_api_v1_public_zerodb__project_id__database_tables__table_name__count_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MongoQueryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountRowsFilteredResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/tables/{table_name}/rows/bulk":{"put":{"tags":["ZeroDB Database - Public","ZeroDB Bulk Operations"],"summary":"Bulk Update Rows","description":"Bulk update rows in a table using MongoDB-style operators\n\n**Supported Update Operators:**\n- `$set` - Set field values\n- `$inc` - Increment numeric fields\n- `$push` - Add to array fields\n- `$pull` - Remove from array fields\n- `$unset` - Remove fields\n\n**Filter Operators:**\n- `$eq` - Equal to\n- `$ne` - Not equal to\n- `$gt` - Greater than\n- `$gte` - Greater than or equal\n- `$lt` - Less than\n- `$lte` - Less than or equal\n- `$in` - Value in array\n- `$nin` - Value not in array\n\n**Example Request:**\n```json\n{\n \"filter\": {\n \"status\": \"pending\",\n \"created_at\": {\"$lt\": \"2025-01-01\"}\n },\n \"update\": {\n \"$set\": {\n \"status\": \"active\",\n \"updated_at\": \"2025-12-03T10:00:00Z\"\n },\n \"$inc\": {\n \"login_count\": 1\n },\n \"$push\": {\n \"notifications\": \"Account activated\"\n }\n },\n \"confirm_large_operation\": false\n}\n```\n\n**Safety Features:**\n- Requires non-empty filter to prevent accidental updates\n- Confirmation required for operations affecting >100 rows\n- Transaction support with automatic rollback on errors\n- Validation of all update operators\n\n**Returns:**\n- `matched_count` - Number of rows matched by filter\n- `modified_count` - Number of rows actually modified\n- `filter_used` - Filter criteria applied\n- `update_operators` - Update operators applied\n- `execution_time_ms` - Operation execution time\n- `warnings` - Any warnings during operation","operationId":"bulk_update_rows_api_v1_public_zerodb__project_id__database_tables__table_name__rows_bulk_put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Database - Public","ZeroDB Bulk Operations"],"summary":"Bulk Delete Rows","description":"Bulk delete rows from a table using MongoDB-style filters\n\n**Filter Operators:**\n- `$eq` - Equal to\n- `$ne` - Not equal to\n- `$gt` - Greater than\n- `$gte` - Greater than or equal\n- `$lt` - Less than\n- `$lte` - Less than or equal\n- `$in` - Value in array\n- `$nin` - Value not in array\n\n**Example Request:**\n```json\n{\n \"filter\": {\n \"status\": \"inactive\",\n \"last_login\": {\"$lt\": \"2024-01-01\"}\n },\n \"confirm_large_operation\": false\n}\n```\n\n**Safety Features:**\n- Requires non-empty filter to prevent accidental deletion of all rows\n- Confirmation required for operations affecting >100 rows\n- Transaction support with automatic rollback on errors\n\n**Returns:**\n- `deleted_count` - Number of rows deleted\n- `filter_used` - Filter criteria applied\n- `execution_time_ms` - Operation execution time\n- `warnings` - Any warnings during operation","operationId":"bulk_delete_rows_api_v1_public_zerodb__project_id__database_tables__table_name__rows_bulk_delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__BulkDeleteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/tables/{table_name}/rows/{row_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Row Operations"],"summary":"Get Row","description":"Get a specific row by ID","operationId":"get_row_api_v1_public_zerodb__project_id__database_tables__table_name__rows__row_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"row_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Row Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["ZeroDB Database - Public","ZeroDB Row Operations"],"summary":"Update Row","description":"Update an existing row","operationId":"update_row_api_v1_public_zerodb__project_id__database_tables__table_name__rows__row_id__put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"row_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Row Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroDBRowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Database - Public","ZeroDB Row Operations"],"summary":"Delete Row","description":"Delete a row from a table","operationId":"delete_row_api_v1_public_zerodb__project_id__database_tables__table_name__rows__row_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"row_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Row Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteRowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/tables/{table_name}":{"delete":{"tags":["ZeroDB Database - Public","ZeroDB Table Operations"],"summary":"Delete Table","description":"Delete a table and all its data","operationId":"delete_table_api_v1_public_zerodb__project_id__database_tables__table_name__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTableResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/vectors/upsert":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Upsert Vector","description":"Upsert a vector into project database","operationId":"upsert_vector_api_v1_public_zerodb__project_id__database_vectors_upsert_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/vectors/upsert-batch":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Upsert Vectors Batch","description":"Batch upsert vectors","operationId":"upsert_vectors_batch_api_v1_public_zerodb__project_id__database_vectors_upsert_batch_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VectorCreate"},"title":"Vectors"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkOperationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/vectors/search":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Search Vectors","description":"Search vectors using similarity","operationId":"search_vectors_api_v1_public_zerodb__project_id__database_vectors_search_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__VectorSearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__VectorSearchResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/vectors":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"List Vectors","description":"List all vectors in a project with pagination\n\nReturns vectors with optional filtering by namespace.\nUse detailed=false (default) to exclude full embeddings and save bandwidth.\nUse detailed=true to include full vector embeddings in the response.","operationId":"list_vectors_api_v1_public_zerodb__project_id__database_vectors_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of vectors to skip","default":0,"title":"Offset"},"description":"Number of vectors to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum vectors to return","default":100,"title":"Limit"},"description":"Maximum vectors to return"},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by namespace","title":"Namespace"},"description":"Filter by namespace"},{"name":"detailed","in":"query","required":false,"schema":{"type":"boolean","description":"Include full embeddings (default: false for bandwidth efficiency)","default":false,"title":"Detailed"},"description":"Include full embeddings (default: false for bandwidth efficiency)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedVectorsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/vectors/stats":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Get Vector Stats","description":"Get vector statistics for a project\n\nReturns:\n- total_vectors: Total count of vectors\n- namespaces: List of unique namespaces\n- avg_dimensions: Average embedding dimensions\n- total_size_mb: Estimated storage size","operationId":"get_vector_stats_api_v1_public_zerodb__project_id__database_vectors_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by namespace","title":"Namespace"},"description":"Filter by namespace"},{"name":"detailed","in":"query","required":false,"schema":{"type":"boolean","description":"Include detailed statistics","default":false,"title":"Detailed"},"description":"Include detailed statistics"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/vectors/{vector_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Get Vector","description":"Get a specific vector by ID","operationId":"get_vector_api_v1_public_zerodb__project_id__database_vectors__vector_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"vector_id","in":"path","required":true,"schema":{"type":"string","title":"Vector Id"}},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by namespace","title":"Namespace"},"description":"Filter by namespace"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Delete Vector","description":"Delete a specific vector by ID","operationId":"delete_vector_api_v1_public_zerodb__project_id__database_vectors__vector_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"vector_id","in":"path","required":true,"schema":{"type":"string","title":"Vector Id"}},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by namespace","title":"Namespace"},"description":"Filter by namespace"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__DeleteVectorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/vectors/quantum-compress":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Quantum Compress Vector","description":"Compress a vector using TurboQuant (PolarQuant + QJL)\n\nThis endpoint provides vector compression using algorithms based on\nGoogle's TurboQuant (ICLR 2026):\n- **turboquant** (or quantum_harmonic): PolarQuant + QJL (~3.5x compression, cosine > 0.9999)\n- **polarquant** (or sparse_encode): PolarQuant only (~2.6x compression, cosine > 0.9999)\n- **qjl** (or entropy_reduce): QJL sign-bit only (~27x compression, cosine ~0.80)\n\nFeatures:\n- 3.5x compression at 8-bit precision with 0.99999 cosine similarity\n- Data-oblivious: no per-dataset calibration needed\n- Binary serialization (no JSON/zlib overhead)\n- Adjustable precision (8, 16, or 32-bit radius quantization)\n\nRefs #1563, #1564","operationId":"quantum_compress_vector_api_v1_public_zerodb__project_id__database_vectors_quantum_compress_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuantumCompressRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuantumCompressResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/vectors/analytics":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Get advanced vector analytics","description":"Get comprehensive vector analytics including similarity metrics, storage stats, and quality indicators.\n\n **Features:**\n - Total vector counts and namespace distribution\n - Average cosine similarity analysis (sample-based for performance)\n - Detailed storage metrics (bytes, MB, GB)\n - Quality metrics (magnitude, sparsity, variance)\n - Dimension statistics and distribution\n\n **Performance:**\n - Samples up to 1000 vectors for similarity calculations\n - Uses efficient SQL aggregations for counts\n - Results are cached for improved performance\n\n **Use Cases:**\n - Monitor vector quality and consistency\n - Identify storage optimization opportunities\n - Analyze vector clustering potential\n - Track vector statistics over time\n\n Args:\n project_id: UUID of the project\n namespace: Optional namespace filter\n sample_size: Maximum vectors to analyze (default: 1000, max: 10000)\n\n Returns:\n VectorAnalyticsResponse with comprehensive analytics","operationId":"get_vector_analytics_api_v1_public_zerodb__project_id__database_vectors_analytics_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional namespace filter","title":"Namespace"},"description":"Optional namespace filter"},{"name":"sample_size","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":10,"description":"Maximum vectors to analyze","default":1000,"title":"Sample Size"},"description":"Maximum vectors to analyze"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorAnalyticsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/vectors/cluster":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Run clustering on vectors","description":"Run clustering algorithms on project vectors to identify groups and patterns.\n\n **Algorithms:**\n\n 1. **KMeans** (default)\n - Best for: Well-separated, spherical clusters\n - Parameters: n_clusters (2-100)\n - Returns: Cluster centroids and inertia\n\n 2. **DBSCAN**\n - Best for: Arbitrary shapes, noise detection\n - Parameters: eps (distance threshold), min_samples\n - Returns: Variable clusters + noise points\n\n 3. **Hierarchical**\n - Best for: Nested cluster structures\n - Parameters: n_clusters (2-100)\n - Returns: Hierarchical cluster tree\n\n **Features:**\n - Analyzes up to 100,000 vectors (configurable)\n - Returns cluster centroids (first 10 dimensions)\n - Lists vector IDs per cluster (first 50)\n - Provides algorithm-specific metrics\n\n **Performance:**\n - Uses cosine distance for similarity\n - Optimized for high-dimensional embeddings\n - Samples large datasets for efficiency\n\n **Example Request:**\n ```json\n {\n \"algorithm\": \"kmeans\",\n \"n_clusters\": 5,\n \"namespace\": \"embeddings\",\n \"max_vectors\": 5000\n }\n ```\n\n Args:\n project_id: UUID of the project\n request: Clustering configuration\n\n Returns:\n VectorClusteringResponse with cluster assignments and metrics\n\n Raises:\n HTTPException: 400 for invalid parameters, 500 for clustering failures","operationId":"run_vector_clustering_api_v1_public_zerodb__project_id__database_vectors_cluster_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorClusteringRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorClusteringResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/memory":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Memory Operations"],"summary":"Create Memory Record","description":"Create a memory record","operationId":"create_memory_record_api_v1_public_zerodb__project_id__database_memory_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRecordCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Database - Public","ZeroDB Memory Operations"],"summary":"List Memories","description":"List memory records for a project","operationId":"list_memories_api_v1_public_zerodb__project_id__database_memory_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMemoriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/memory/search":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Memory Operations"],"summary":"Search Memory","description":"Search memory records","operationId":"search_memory_api_v1_public_zerodb__project_id__database_memory_search_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_search_memory_api_v1_public_zerodb__project_id__database_memory_search_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__MemorySearchResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/memory/{memory_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Memory Operations"],"summary":"Get Memory Record","description":"Get a specific memory record by ID","operationId":"get_memory_record_api_v1_public_zerodb__project_id__database_memory__memory_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Memory Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["ZeroDB Database - Public","ZeroDB Memory Operations"],"summary":"Update Memory Record","description":"Update a memory record","operationId":"update_memory_record_api_v1_public_zerodb__project_id__database_memory__memory_id__put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Memory Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_update_memory_record_api_v1_public_zerodb__project_id__database_memory__memory_id__put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Database - Public","ZeroDB Memory Operations"],"summary":"Delete Memory Record","description":"Delete a memory record","operationId":"delete_memory_record_api_v1_public_zerodb__project_id__database_memory__memory_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Memory Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteMemoryRecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/events":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Event Operations"],"summary":"Create Event","description":"Create an event record","operationId":"create_event_api_v1_public_zerodb__project_id__database_events_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__EventCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__EventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"get":{"tags":["ZeroDB Database - Public","ZeroDB Event Operations"],"summary":"List Events","description":"List events for a project with optional topic filter","operationId":"list_events_api_v1_public_zerodb__project_id__database_events_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by event topic","title":"Topic"},"description":"Filter by event topic"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Skip"},"description":"Number of records to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum number of records to return","default":100,"title":"Limit"},"description":"Maximum number of records to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/app__zerodb__schemas__database__EventResponse"},"title":"Response List Events Api V1 Public Zerodb Project Id Database Events Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/events/stats":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Event Operations"],"summary":"Get Event Stats","description":"Get event statistics for a project","operationId":"get_event_stats_api_v1_public_zerodb__project_id__database_events_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"time_range","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Time range: hour, day, week, month","default":"day","title":"Time Range"},"description":"Time range: hour, day, week, month"},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by event topic","title":"Topic"},"description":"Filter by event topic"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetEventStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/events/{event_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Event Operations"],"summary":"Get Event","description":"Get a specific event by ID","operationId":"get_event_api_v1_public_zerodb__project_id__database_events__event_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__EventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/files":{"post":{"tags":["ZeroDB Database - Public","ZeroDB File Operations"],"summary":"Upload File","description":"Upload a file to project storage","operationId":"upload_file_api_v1_public_zerodb__project_id__database_files_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Database - Public","ZeroDB File Operations"],"summary":"List Files","description":"List all files in project storage","operationId":"list_files_api_v1_public_zerodb__project_id__database_files_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FileResponse"},"title":"Response List Files Api V1 Public Zerodb Project Id Database Files Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/files/stats":{"get":{"tags":["ZeroDB Database - Public","ZeroDB File Operations"],"summary":"Get File Stats","description":"Get file storage statistics for project","operationId":"get_file_stats_api_v1_public_zerodb__project_id__database_files_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__GetFileStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/files/{file_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB File Operations"],"summary":"Get File","description":"Get file metadata by ID","operationId":"get_file_api_v1_public_zerodb__project_id__database_files__file_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Database - Public","ZeroDB File Operations"],"summary":"Delete File","description":"Delete a file from project storage","operationId":"delete_file_api_v1_public_zerodb__project_id__database_files__file_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__DeleteFileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/files/{file_id}/download":{"get":{"tags":["ZeroDB Database - Public","ZeroDB File Operations"],"summary":"Download File","description":"Download file content","operationId":"download_file_api_v1_public_zerodb__project_id__database_files__file_id__download_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__DownloadFileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/files/{file_id}/presigned-url":{"post":{"tags":["ZeroDB Database - Public","ZeroDB File Operations"],"summary":"Generate Presigned Url","description":"Generate presigned URL for file access","operationId":"generate_presigned_url_api_v1_public_zerodb__project_id__database_files__file_id__presigned_url_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_generate_presigned_url_api_v1_public_zerodb__project_id__database_files__file_id__presigned_url_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneratePresignedUrlResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/storage/upload":{"post":{"tags":["ZeroDB Database - Public","ZeroDB File Operations"],"summary":"Upload File Binary","description":"Upload binary file to MinIO storage","operationId":"upload_file_binary_api_v1_public_zerodb__project_id__database_storage_upload_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_file_binary_api_v1_public_zerodb__project_id__database_storage_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__UploadFileBinaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Create Rlhf Dataset","description":"Create RLHF dataset","operationId":"create_rlhf_dataset_api_v1_public_zerodb__project_id__database_rlhf_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFDatasetCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFDatasetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/interactions":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Log Rlhf Interaction","description":"Log RLHF interaction for learning","operationId":"log_rlhf_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Interaction Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFInteractionLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"List Rlhf Interactions","description":"List RLHF interactions for project with optional filters","operationId":"list_rlhf_interactions_api_v1_public_zerodb__project_id__database_rlhf_interactions_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"feedback","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback"}},{"name":"model","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"reward_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward Min"}},{"name":"reward_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward Max"}},{"name":"tags","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"}},{"name":"start_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Time"}},{"name":"end_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFInteractionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/interactions/{interaction_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Get Rlhf Interaction","description":"Get specific RLHF interaction","operationId":"get_rlhf_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions__interaction_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"interaction_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Interaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFInteractionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Delete Rlhf Interaction","description":"Delete an RLHF interaction","operationId":"delete_rlhf_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions__interaction_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"interaction_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Interaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFInteractionDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/interactions/{interaction_id}/feedback":{"put":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Update Rlhf Feedback","description":"Update feedback for an RLHF interaction","operationId":"update_rlhf_feedback_api_v1_public_zerodb__project_id__database_rlhf_interactions__interaction_id__feedback_put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"interaction_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Interaction Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Feedback Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFInteractionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/stats":{"get":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Get Rlhf Stats","description":"Get RLHF statistics for project","operationId":"get_rlhf_stats_api_v1_public_zerodb__project_id__database_rlhf_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"time_range","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Range"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/export":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Export Rlhf Data","description":"Export RLHF training data in multiple formats\n\n**Supported Formats:**\n- **json**: Standard JSON array format\n- **csv**: Comma-separated values for spreadsheets\n- **parquet**: Apache Parquet columnar format (requires pandas and pyarrow)\n- **openai**: OpenAI fine-tuning JSONL format (compatible with GPT-3.5/4 fine-tuning)\n- **anthropic**: Anthropic Claude fine-tuning format (experimental)\n\n**Filters:**\n- start_date: ISO format date (e.g., \"2025-01-01T00:00:00Z\")\n- end_date: ISO format date\n- feedback: Filter by feedback type (positive, negative, mixed)\n- model: Filter by model name\n- session_id: Filter by session ID\n\n**Example Request (OpenAI format):**\n```json\n{\n \"format\": \"openai\",\n \"start_date\": \"2025-12-01T00:00:00Z\",\n \"feedback\": \"positive\"\n}\n```\n\n**CSV Format:**\nReturns CSV string with columns: interaction_id, prompt, response, feedback, reward, model, session_id, agent_id, human_feedback, created_at\n\n**Parquet Format:**\nReturns base64-encoded Parquet binary data with full schema information\n\n**OpenAI Format:**\nReturns JSONL with format: {\"messages\": [{\"role\": \"user\", \"content\": \"...\"}, {\"role\": \"assistant\", \"content\": \"...\"}]}","operationId":"export_rlhf_data_api_v1_public_zerodb__project_id__database_rlhf_export_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_export_rlhf_data_api_v1_public_zerodb__project_id__database_rlhf_export_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFExportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/interactions/batch":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Batch Create Rlhf Interactions","description":"Batch create multiple RLHF interactions\n\n**Use Case:** Import interactions from CSV, JSON, or other sources\n\n**Request Body:**\n```json\n[\n {\n \"prompt\": \"What is machine learning?\",\n \"response\": \"Machine learning is...\",\n \"feedback\": \"positive\",\n \"reward\": 0.9,\n \"model\": \"claude-opus-4-8\",\n \"session_id\": \"session-123\",\n \"agent_id\": \"agent-456\",\n \"human_feedback\": \"Great explanation!\",\n \"tags\": [\"ml\", \"education\"],\n \"context\": \"Educational context\",\n \"metadata\": {\"source\": \"import\"}\n }\n]\n```\n\n**Response:**\n```json\n{\n \"project_id\": \"uuid\",\n \"created_count\": 5,\n \"failed_count\": 0,\n \"created_interactions\": [\n {\"interaction_id\": \"uuid1\", \"status\": \"created\"},\n {\"interaction_id\": \"uuid2\", \"status\": \"created\"}\n ],\n \"errors\": []\n}\n```","operationId":"batch_create_rlhf_interactions_api_v1_public_zerodb__project_id__database_rlhf_interactions_batch_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Array of interaction objects to create","title":"Interactions"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFInteractionBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/interactions/compare":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Create Comparison Interaction","description":"Create comparison-based RLHF interaction\n\n**Use Case:** A/B testing of responses where user selects preferred response\n\n**Example Request:**\n```json\n{\n \"prompt\": \"Explain neural networks\",\n \"response_a\": \"Neural networks are computational models...\",\n \"response_b\": \"Neural networks are brain-inspired algorithms...\",\n \"preferred_response\": \"B\",\n \"model_a\": \"gpt-oss-120b\",\n \"model_b\": \"claude-opus-4-8\",\n \"feedback_comment\": \"Response B is more intuitive\",\n \"session_id\": \"session-123\"\n}\n```\n\n**Creates Two Interactions:**\n- Preferred response gets positive feedback (reward 1.0)\n- Non-preferred response gets negative feedback (reward -1.0)","operationId":"create_comparison_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions_compare_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_create_comparison_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions_compare_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFComparisonResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/interactions/single-review":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Create Single Review Interaction","description":"Create single review RLHF interaction with rating\n\n**Use Case:** Simple thumbs up/down or 5-star rating of a response\n\n**Example Request:**\n```json\n{\n \"prompt\": \"How do I deploy to production?\",\n \"response\": \"Here are the steps...\",\n \"rating\": 5,\n \"feedback_comment\": \"Very helpful and detailed!\",\n \"model\": \"claude-opus-4-8\",\n \"tags\": [\"deployment\", \"helpful\"],\n \"session_id\": \"session-123\"\n}\n```\n\n**Rating to Feedback Mapping:**\n- 5: positive (reward 1.0)\n- 4: positive (reward 0.5)\n- 3: mixed (reward 0.0)\n- 2: negative (reward -0.5)\n- 1: negative (reward -1.0)","operationId":"create_single_review_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions_single_review_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_create_single_review_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions_single_review_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSingleReviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/sessions":{"get":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"List Rlhf Sessions","description":"List RLHF sessions for project with optional filters","operationId":"list_rlhf_sessions_api_v1_public_zerodb__project_id__database_rlhf_sessions_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"start_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Time"}},{"name":"end_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Create Rlhf Session","description":"Create a new RLHF session","operationId":"create_rlhf_session_api_v1_public_zerodb__project_id__database_rlhf_sessions_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFSessionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/sessions/{session_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Get Rlhf Session","description":"Get specific RLHF session details","operationId":"get_rlhf_session_api_v1_public_zerodb__project_id__database_rlhf_sessions__session_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFSessionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Update Rlhf Session","description":"Update an existing RLHF session","operationId":"update_rlhf_session_api_v1_public_zerodb__project_id__database_rlhf_sessions__session_id__put","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFSessionResponse__2"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Delete Rlhf Session","description":"Delete an RLHF session","operationId":"delete_rlhf_session_api_v1_public_zerodb__project_id__database_rlhf_sessions__session_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/sessions/{session_id}/start":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Start Rlhf Session","description":"Start an RLHF session (set status to active)","operationId":"start_rlhf_session_api_v1_public_zerodb__project_id__database_rlhf_sessions__session_id__start_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/sessions/{session_id}/stop":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Stop Rlhf Session","description":"Stop an RLHF session (set status to stopped)","operationId":"stop_rlhf_session_api_v1_public_zerodb__project_id__database_rlhf_sessions__session_id__stop_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/start":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Start Rlhf Session Simple","description":"Start a new RLHF session or resume existing one","operationId":"start_rlhf_session_simple_api_v1_public_zerodb__project_id__database_rlhf_start_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/rlhf/stop":{"post":{"tags":["ZeroDB Database - Public","ZeroDB RLHF Operations"],"summary":"Stop Rlhf Session Simple","description":"Stop an RLHF session","operationId":"stop_rlhf_session_simple_api_v1_public_zerodb__project_id__database_rlhf_stop_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Session Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RLHFSessionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/agent-logs":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Agent Operations"],"summary":"Create Agent Log","description":"Create agent execution log","operationId":"create_agent_log_api_v1_public_zerodb__project_id__database_agent_logs_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ZeroDB Database - Public","ZeroDB Agent Operations"],"summary":"List Agent Logs","description":"List agent logs with optional filtering","operationId":"list_agent_logs_api_v1_public_zerodb__project_id__database_agent_logs_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id"}},{"name":"log_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Log Level"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentLogResponse"},"title":"Response List Agent Logs Api V1 Public Zerodb Project Id Database Agent Logs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/agent-logs/stats":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Agent Operations"],"summary":"Get Agent Logs Stats","description":"Get agent logs statistics","operationId":"get_agent_logs_stats_api_v1_public_zerodb__project_id__database_agent_logs_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAgentLogsStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/agent-logs/{log_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Agent Operations"],"summary":"Get Agent Log","description":"Get a specific agent log by ID","operationId":"get_agent_log_api_v1_public_zerodb__project_id__database_agent_logs__log_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"log_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Log Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ZeroDB Database - Public","ZeroDB Agent Operations"],"summary":"Delete Agent Log","description":"Delete an agent log entry\n\nNOTE (pre-existing bug, out of scope -- Refs AINative-Studio/ainative-website#2191\ntyping pass, not fixed here per surgical-changes rule): this handler does not\ndelete anything. It returns the same aggregate stats payload as\nget_agent_logs_stats (apparent copy/paste). The response_model documents the\nREAL current shape so OpenAPI stays accurate; it does not endorse the behavior.","operationId":"delete_agent_log_api_v1_public_zerodb__project_id__database_agent_logs__log_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"log_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Log Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAgentLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/agents/active":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Agent Operations"],"summary":"List Active Agents","description":"List active agents for project","operationId":"list_active_agents_api_v1_public_zerodb__project_id__database_agents_active_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListActiveAgentsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/agents/traces":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Agent Operations"],"summary":"List Agent Traces","description":"List agent execution traces","operationId":"list_agent_traces_api_v1_public_zerodb__project_id__database_agents_traces_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAgentTracesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/agent-logs/export":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Agent Operations"],"summary":"Export Agent Logs","description":"Export agent logs in specified format","operationId":"export_agent_logs_api_v1_public_zerodb__project_id__database_agent_logs_export_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_export_agent_logs_api_v1_public_zerodb__project_id__database_agent_logs_export_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportAgentLogsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/query":{"post":{"tags":["ZeroDB Database - Public","ZeroDB SQL Query Execution"],"summary":"Execute Sql Query","description":"Execute SQL query against project's dedicated PostgreSQL instance\n\n**Security Features:**\n- Automatic SQL injection detection using pattern matching\n- Dangerous command blacklist (DROP DATABASE, TRUNCATE, ALTER SYSTEM, etc.)\n- Configurable timeout enforcement (30s default, 5min max)\n- Read-only mode option for SELECT-only queries\n- Query complexity scoring for accurate billing\n\n**Billing:**\n- Base cost: 0.1 credits per query\n- Execution time: 0.01 credits per 100ms\n- Complexity factor: 0.01 credits per complexity point\n\n**Query Types Supported:**\n- SELECT: Read data from tables\n- INSERT: Add new records\n- UPDATE: Modify existing records\n- DELETE: Remove records\n\n**Usage Examples:**\n\nSimple SELECT:\n```json\n{\n \"sql\": \"SELECT * FROM users LIMIT 10\",\n \"timeout_seconds\": 30,\n \"max_rows\": 100\n}\n```\n\nComplex Analytics:\n```json\n{\n \"sql\": \"SELECT DATE(created_at) as date, COUNT(*) as count FROM orders WHERE created_at > NOW() - INTERVAL '30 days' GROUP BY DATE(created_at) ORDER BY date DESC\",\n \"timeout_seconds\": 60,\n \"max_rows\": 1000\n}\n```\n\nRead-Only Mode:\n```json\n{\n \"sql\": \"SELECT * FROM products\",\n \"read_only\": true,\n \"timeout_seconds\": 30\n}\n```\n\n**Error Codes:**\n- 400: SQL validation failed (dangerous command or injection detected)\n- 404: No PostgreSQL instance found (provision one first)\n- 408: Query timeout exceeded\n- 500: Query execution error\n\n**Rate Limits:**\n- 100 queries per minute per user (future implementation)\n- 500 queries per minute per project (future implementation)","operationId":"execute_sql_query_api_v1_public_zerodb__project_id__database_query_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryExecutionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/export":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Database Operations"],"summary":"Create database export job","description":"Start an async database export job. Supports JSON, CSV, Parquet, and PostgreSQL dump formats.","operationId":"export_database_api_v1_public_zerodb__project_id__database_export_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseExportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseExportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/exports/{export_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Database Operations"],"summary":"Get export job status","description":"Check the status of an export job and get the download URL when completed.","operationId":"get_export_status_api_v1_public_zerodb__project_id__database_exports__export_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"export_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Export Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseExportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/import":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Database Operations"],"summary":"Start database import","description":"Import data from various sources (JSON, CSV, URL, PostgreSQL backup, or previous export).\n\n **Import Sources:**\n - `json`: Import from JSON data (requires `file_content` as base64)\n - `csv`: Import from CSV data (requires `file_content` as base64)\n - `file_url`: Download and import from URL (requires `file_url`)\n - `export_id`: Re-import from previous export (requires `export_id`)\n - `postgresql_backup`: Restore from PostgreSQL backup (requires `backup_id`)\n\n **Merge Strategies:**\n - `skip`: Skip existing records (default)\n - `overwrite`: Replace existing records\n - `merge`: Merge metadata, keep latest embedding\n\n **Process:**\n 1. Creates import job and validates request\n 2. Validates schema if `validate_schema=true`\n 3. Creates rollback snapshot if `overwrite_existing=true`\n 4. Imports records with chosen merge strategy\n 5. Returns import job status (poll GET endpoint for progress)\n\n **Security:**\n - File URLs must be from allowed domains\n - Maximum file size: 500MB\n - SQL injection protection for PostgreSQL imports","operationId":"import_database_api_v1_public_zerodb__project_id__database_import_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseImportRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/imports/{import_id}":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Database Operations"],"summary":"Get import status","description":"Get the current status of a database import operation.\n\n **Status Values:**\n - `pending`: Import job created, waiting to start\n - `validating`: Validating data schema\n - `in_progress`: Actively importing data\n - `completed`: Import finished successfully\n - `failed`: Import failed (check error_message)\n - `rollback`: Import being rolled back\n\n **Progress Tracking:**\n - `progress_percent`: 0-100 completion percentage\n - `records_imported`: Number of records successfully imported\n - `records_failed`: Number of records that failed\n - `records_skipped`: Number of records skipped (duplicates)\n - `records_total`: Total records to import\n\n **Polling Recommendation:**\n - Poll every 2-5 seconds while status is `validating` or `in_progress`\n - Stop polling when status is `completed`, `failed`, or `rollback`","operationId":"get_import_status_api_v1_public_zerodb__project_id__database_imports__import_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"import_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Import Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/imports/{import_id}/rollback":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Database Operations"],"summary":"Rollback import","description":"Rollback a failed or unwanted database import.\n\n **Requirements:**\n - Import must have `rollback_available=true`\n - Rollback snapshot must exist\n\n **Process:**\n 1. Changes import status to `rollback`\n 2. Deletes records created during import\n 3. Restores database state from snapshot\n 4. Marks import as `failed` with rollback message\n\n **Note:** Rollback is only available for imports with `overwrite_existing=true`","operationId":"rollback_import_api_v1_public_zerodb__project_id__database_imports__import_id__rollback_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"import_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Import Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/namespaces":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Get list of vector namespaces","description":"Get list of available vector namespaces with counts. Used by Semantic Search page for namespace filtering.","operationId":"get_vector_namespaces_api_v1_public_zerodb__project_id__database_namespaces_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetVectorNamespacesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/namespaces/{name}":{"delete":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Flush all vectors in a namespace","description":"Delete all vectors in a namespace for clean re-indexing. Requires confirm=true query parameter.","operationId":"flush_namespace_api_v1_public_zerodb__project_id__database_namespaces__name__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","description":"Must be true to confirm deletion","default":false,"title":"Confirm"},"description":"Must be true to confirm deletion"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlushNamespaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/namespaces/{name}/deduplicate":{"post":{"tags":["ZeroDB Database - Public","ZeroDB Vector Operations"],"summary":"Deduplicate vectors in a namespace","description":"Remove duplicate vectors (by document content MD5) keeping the newest copy of each.","operationId":"deduplicate_namespace_api_v1_public_zerodb__project_id__database_namespaces__name__deduplicate_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeduplicateNamespaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/connection":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Database Management"],"summary":"Get database connection information","description":"Get database connection details for the project's PostgreSQL instance.\n\n **Information Included:**\n - Database host and port\n - Database name\n - Connection status (active, inactive, provisioning)\n - Masked connection string (password hidden)\n\n **Status Values:**\n - `active`: Database is running and accessible\n - `inactive`: Database is stopped or unreachable\n - `provisioning`: Database is being provisioned\n\n **Use Cases:**\n - Database Settings page display\n - Connection string generation for clients\n - Status monitoring","operationId":"get_database_connection_api_v1_public_zerodb__project_id__database_connection_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseConnectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/backups":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Database Management"],"summary":"Get database backups","description":"Get list of database backups for the project.\n\n **Backup Information:**\n - Backup ID (unique identifier)\n - Creation timestamp\n - Size in megabytes\n - Status (completed, failed, in_progress)\n\n **Pagination:**\n - Use `skip` and `limit` query parameters\n - Default: skip=0, limit=50\n - Maximum limit: 1000\n\n **Use Cases:**\n - Database Settings page backup listing\n - Backup restoration workflows\n - Storage usage monitoring","operationId":"get_database_backups_api_v1_public_zerodb__project_id__database_backups_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of backups to skip","default":0,"title":"Skip"},"description":"Number of backups to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum backups to return","default":50,"title":"Limit"},"description":"Maximum backups to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseBackupsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/zerodb/{project_id}/database/extensions":{"get":{"tags":["ZeroDB Database - Public","ZeroDB Database Management"],"summary":"Get PostgreSQL extensions","description":"Get list of installed PostgreSQL extensions for the project.\n\n **Extension Information:**\n - Extension name (e.g., pg_vector, uuid-ossp)\n - Version number\n - Description\n\n **Common Extensions:**\n - `pg_vector`: Vector similarity search\n - `uuid-ossp`: UUID generation\n - `pg_stat_statements`: Query performance tracking\n - `pg_trgm`: Trigram matching for text search\n\n **Use Cases:**\n - Database Settings page extensions listing\n - Feature availability checking\n - Extension installation guidance","operationId":"get_database_extensions_api_v1_public_zerodb__project_id__database_extensions_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseExtensionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/sync/import":{"post":{"tags":["ZeroDB Cloud Sync","ZeroDB Cloud Sync"],"summary":"Upload and apply sync bundle to cloud","description":"Upload a sync bundle from ZeroDB Local and apply it across all cloud services.\nSyncs vectors, tables, memory, events, and file metadata.\nRefs #1612","operationId":"upload_sync_bundle_api_v1_projects__project_id__sync_import_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BundleUploadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BundleUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/sync/export/{bundle_id}":{"get":{"tags":["ZeroDB Cloud Sync","ZeroDB Cloud Sync"],"summary":"Download sync bundle from cloud","description":"Download a sync bundle. Use 'full' as bundle_id to get a live export\nof all project data across all ZeroDB services.\nRefs #1612","operationId":"download_sync_bundle_api_v1_projects__project_id__sync_export__bundle_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"bundle_id","in":"path","required":true,"schema":{"type":"string","description":"Bundle ID, or 'latest' for most recent, or 'full' for live export","title":"Bundle Id"},"description":"Bundle ID, or 'latest' for most recent, or 'full' for live export"},{"name":"include_metadata","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Metadata"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BundleDownloadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/sync/state":{"get":{"tags":["ZeroDB Cloud Sync","ZeroDB Cloud Sync"],"summary":"Get cloud sync status","description":"Get cloud sync state for a project. Refs #1612","operationId":"get_sync_state_api_v1_projects__project_id__sync_state_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudSyncStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/sync/bundles":{"get":{"tags":["ZeroDB Cloud Sync","ZeroDB Cloud Sync"],"summary":"List available cloud bundles","description":"List sync bundles for a project. Refs #1612","operationId":"list_sync_bundles_api_v1_projects__project_id__sync_bundles_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"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":{"$ref":"#/components/schemas/ListBundlesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/cors-origins":{"post":{"tags":["Project CORS Origins"],"summary":"Register a CORS origin for a project","operationId":"create_cors_origin_api_v1_projects__project_id__cors_origins_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorsOriginCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorsOriginResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Project not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"409":{"description":"Origin already registered for this project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Project CORS Origins"],"summary":"List CORS origins for a project","operationId":"get_cors_origins_api_v1_projects__project_id__cors_origins_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorsOriginListResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/cors-origins/{origin_id}":{"delete":{"tags":["Project CORS Origins"],"summary":"Remove a CORS origin","operationId":"remove_cors_origin_api_v1_projects__project_id__cors_origins__origin_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"origin_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Origin Id"}}],"responses":{"204":{"description":"Successful Response"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"CORS origin not found for this project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-keys":{"get":{"tags":["API Keys"],"summary":"List Api Keys","description":"List API keys\n\n- Admin/Superuser: Can view all users' API keys (with user_id filter)\n- Regular users: Can only view their own API keys\n- Optional project_id filter to show keys scoped to a specific project\n\nRefs #7344 (SECURITY): if the AUTHENTICATING key itself is project-scoped,\nthe result is always forced to that project regardless of what the caller\npasses as project_id — a project-scoped key must never enumerate keys\nbelonging to a different project on the same account.","operationId":"list_api_keys_api_v1_api_keys_get","parameters":[{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by user ID (admin only)","title":"User Id"},"description":"Filter by user ID (admin only)"},{"name":"project_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by project ID","title":"Project Id"},"description":"Filter by project ID"},{"name":"is_active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by active status","title":"Is Active"},"description":"Filter by active status"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeysListResponse"}}}},"400":{"description":"Invalid user_id or project_id format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Cannot view other users' API keys","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["API Keys"],"summary":"Create Api Key","description":"Create new API key\n\n- All authenticated users can create API keys for themselves\n- Returns full API key only once","operationId":"create_api_key_api_v1_api_keys_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyCreateResponse"}}}},"400":{"description":"Invalid project_id format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Project not found or access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-keys/{key_id}":{"get":{"tags":["API Keys"],"summary":"Get Api Key","description":"Get API key details\n\n- Users can view their own API keys\n- Admins can view any API key","operationId":"get_api_key_api_v1_api_keys__key_id__get","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyResponse"}}}},"400":{"description":"Invalid API key ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Cannot view other users' API keys","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"API key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["API Keys"],"summary":"Update Api Key","description":"Update mutable fields on an API key.\n\nCurrently supports ``billing_mode`` ('credits' default, or 'pay_per_use'\nfor x402 micropayments) — the toggle backing the dashboard's billing-mode\ncontrol. Refs #9256. This endpoint persists the choice only; it does not\nwire x402 charging into any request path.\n\n- Users can update their own API keys\n- Admins can update any API key","operationId":"update_api_key_api_v1_api_keys__key_id__patch","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyResponse"}}}},"400":{"description":"Invalid API key ID format or billing_mode value","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Cannot update other users' API keys","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"API key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["API Keys"],"summary":"Delete Api Key","description":"Delete API key permanently\n\n- Users can delete their own API keys\n- Admins can delete any API key","operationId":"delete_api_key_api_v1_api_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"204":{"description":"Successful Response"},"400":{"description":"Invalid API key ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Cannot delete other users' API keys","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"API key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-keys/{key_id}/revoke":{"patch":{"tags":["API Keys"],"summary":"Revoke Api Key","description":"Revoke API key (set is_active=False)\n\n- Users can revoke their own API keys\n- Admins can revoke any API key","operationId":"revoke_api_key_api_v1_api_keys__key_id__revoke_patch","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyRevokeResponse"}}}},"400":{"description":"Invalid API key ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Cannot revoke other users' API keys","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"API key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-keys/{key_id}/rotate":{"post":{"tags":["API Keys"],"summary":"Rotate Api Key","description":"Rotate (regenerate) an API key\n\nGenerates a new key value while preserving the key's name, permissions,\nand metadata. The old key is immediately invalidated.\n\n- Users can rotate their own API keys\n- Admins can rotate any API key\n- Returns the new full key only once","operationId":"rotate_api_key_api_v1_api_keys__key_id__rotate_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyCreateResponse"}}}},"400":{"description":"Invalid API key ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Cannot rotate other users' API keys","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"API key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-keys/{key_id}/health":{"get":{"tags":["API Keys"],"summary":"Check Api Key Health","description":"Check if an API key is compatible with a specific project.\n\nReturns green/yellow/red health status:\n- green: Key is scoped to this project and workspace\n- yellow: Key belongs to this user but is scoped to a different project\n- red: Key authenticates as a different user or can't access this workspace\n\nRefs #5032","operationId":"check_api_key_health_api_v1_api_keys__key_id__health_get","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"project_id","in":"query","required":true,"schema":{"type":"string","description":"Project ID to check compatibility against","title":"Project Id"},"description":"Project ID to check compatibility against"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyHealthResponse"}}}},"400":{"description":"Invalid API key ID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Cannot check other users' API keys","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"API key or project not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-keys/verify":{"post":{"tags":["API Keys"],"summary":"Verify Api Key","description":"Verify an API key and return its tier, credits, and capabilities.\n\nAuthenticate with the API key in the Authorization header:\n Authorization: Bearer sk_...\n\nReturns the key's plan tier, remaining credits, and which\ncapabilities (chat, embeddings, etc.) are available. This lets\nclients (e.g. Claude Code) pre-check a key before attempting\noperations that require a paid tier.\n\nStatus values:\n- READY: Key can perform chat completions\n- insufficient_credits: Paid tier but credits exhausted\n- trial_expired: Instant DB temp key — claim account to keep data\n- upgrade_required: Free tier — register or upgrade for chat\n\nRefs #7453: the several sequential db.execute() calls resolving plan/\nproject/org/subscription are blocking SQLAlchemy work. They are done in\n`_verify_api_key_lookup` and dispatched via run_in_threadpool so they run\noff the event loop, same fix pattern as get_current_user_or_api_key.","operationId":"verify_api_key_api_v1_api_keys_verify_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyVerifyResponse"}}}},"401":{"description":"Missing or invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/2fa/enable":{"post":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Enable Two-Factor Authentication","description":"Enable 2FA for authenticated user. Returns 10 backup codes (one-time display).","operationId":"enable_2fa_api_v1_auth_2fa_enable_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFAEnableRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFAEnableResponse"}}}},"400":{"description":"Invalid phone number or validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"SMS verification or 2FA is not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/disable":{"post":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Disable Two-Factor Authentication","description":"Disable 2FA for authenticated user. Requires verification code or backup code.","operationId":"disable_2fa_api_v1_auth_2fa_disable_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFADisableRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"Invalid verification code or backup code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to disable two-factor authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/verify":{"post":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Verify Two-Factor Authentication Code","description":"Verify 2FA code during login. Returns auth token if valid.","operationId":"verify_2fa_code_api_v1_auth_2fa_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFAVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFAVerifyResponse"}}}},"400":{"description":"Invalid code or code expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Account locked due to too many failed attempts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to verify code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/send-code":{"post":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Send New Verification Code","description":"Send new 2FA code via SMS to user's registered phone number.","operationId":"send_2fa_code_api_v1_auth_2fa_send_code_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFASendCodeResponse"}}}},"400":{"description":"2FA not enabled or SMS delivery failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"429":{"description":"Account is locked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to send verification code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"SMS verification or 2FA is not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/status":{"get":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Get Two-Factor Authentication Status","description":"Get user's 2FA status including phone number (masked) and backup codes count.","operationId":"get_2fa_status_api_v1_auth_2fa_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFAStatusResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to retrieve 2FA status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/backup-codes/generate":{"post":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Generate New Backup Codes","description":"Generate 10 new backup codes. Requires current 2FA code verification.","operationId":"generate_backup_codes_api_v1_auth_2fa_backup_codes_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupCodesGenerateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupCodesGenerateResponse"}}}},"400":{"description":"Invalid verification code or 2FA not enabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to generate backup codes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/backup-codes":{"get":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Get Backup Codes Status","description":"Get remaining backup codes count and last generation timestamp.","operationId":"get_backup_codes_status_api_v1_auth_2fa_backup_codes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupCodesStatusResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to retrieve backup codes status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/backup-codes/verify":{"post":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Verify and Consume Backup Code","description":"Verify backup code and consume it (one-time use).","operationId":"verify_backup_code_api_v1_auth_2fa_backup_codes_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupCodeVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupCodeVerifyResponse"}}}},"400":{"description":"Invalid backup code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to verify backup code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/phone":{"put":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Update Phone Number","description":"Update phone number for 2FA. Requires verification code.","operationId":"update_phone_number_api_v1_auth_2fa_phone_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"Invalid phone number or verification code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to update phone number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"SMS verification or 2FA is not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/attempts":{"get":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Get Failed Attempts Status","description":"Get failed verification attempts count and lockout status.","operationId":"get_attempts_status_api_v1_auth_2fa_attempts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttemptsStatusResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to retrieve attempts status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/unlock":{"post":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Unlock Account (Admin Only)","description":"Admin endpoint to unlock a user's 2FA account.","operationId":"unlock_account_api_v1_auth_2fa_unlock_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnlockAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Admin privileges required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"User not found or 2FA not enabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to unlock account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/2fa/sessions":{"delete":{"tags":["🔐 Two-Factor Authentication","Two-Factor Authentication"],"summary":"Revoke All 2FA Sessions","description":"Revoke all active 2FA sessions. Requires verification code.","operationId":"revoke_2fa_sessions_api_v1_auth_2fa_sessions_delete","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionsRevokeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionsRevokeResponse"}}}},"400":{"description":"Invalid verification code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to revoke sessions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sessions/":{"get":{"tags":["🔑 Session Management"],"summary":"List User Sessions","description":"List all active sessions for the current user","operationId":"list_user_sessions_api_v1_auth_sessions__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/app__api__api_v1__endpoints__sessions__SessionResponse"},"type":"array","title":"Response List User Sessions Api V1 Auth Sessions Get"}}}},"401":{"description":"Authentication required or invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to list sessions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"post":{"tags":["🔑 Session Management"],"summary":"Create Session","description":"Create a new user session with preferences and metadata","operationId":"create_session_api_v1_auth_sessions__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionCreateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__api_v1__endpoints__sessions__SessionResponse"}}}},"400":{"description":"Invalid user: missing user ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"User authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to create session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sessions/{session_id}":{"get":{"tags":["🔑 Session Management"],"summary":"Get Session","description":"Get session details by session ID","operationId":"get_session_api_v1_auth_sessions__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__api_v1__endpoints__sessions__SessionResponse"}}}},"401":{"description":"Authentication required or invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Access denied to this session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Session not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to retrieve session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"put":{"tags":["🔑 Session Management"],"summary":"Update Session","description":"Update session preferences and metadata","operationId":"update_session_api_v1_auth_sessions__session_id__put","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__api_v1__endpoints__sessions__SessionResponse"}}}},"401":{"description":"Authentication required or invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Access denied to this session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Session not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to update session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"delete":{"tags":["🔑 Session Management"],"summary":"Terminate Session","description":"Terminate a session (logout)","operationId":"terminate_session_api_v1_auth_sessions__session_id__delete","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionTerminateResponse"}}}},"401":{"description":"Authentication required or invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Access denied to this session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Session not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to terminate session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sessions/{session_id}/valid":{"get":{"tags":["🔑 Session Management"],"summary":"Check Session Validity","description":"Check if a session is valid and active","operationId":"check_session_validity_api_v1_auth_sessions__session_id__valid_get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionValidityResponse"}}}},"401":{"description":"Authentication required or invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Access denied to this session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to check session validity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sessions/{session_id}/events":{"get":{"tags":["🔑 Session Management"],"summary":"Get Session Events","description":"Get all events for a session","operationId":"get_session_events_api_v1_auth_sessions__session_id__events_get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/app__api__api_v1__endpoints__sessions__SessionEventResponse"},"title":"Response Get Session Events Api V1 Auth Sessions Session Id Events Get"}}}},"401":{"description":"Authentication required or invalid credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Access denied to this session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Session not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Failed to retrieve session events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sessions/analytics/summary":{"get":{"tags":["🔑 Session Management"],"summary":"Get Session Analytics","description":"Get session analytics summary (admin only)","operationId":"get_session_analytics_api_v1_auth_sessions_analytics_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__api_v1__endpoints__sessions__SessionAnalyticsResponse"}}}},"401":{"description":"User authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Admin privileges required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"Failed to retrieve session analytics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/projects/{project_id}/database/lakehouse/query":{"post":{"tags":["ZeroDB Lakehouse","ZeroDB Lakehouse"],"summary":"Execute SQL query against the lakehouse","description":"Execute a read-only SQL query confined to the caller's project partition.\n\nThe caller must own ``project_id``. The query is validated (SELECT-only, no\nraw path access) and rewritten so logical sensor tables resolve to\n``tenant={project_id}/...`` globs only — a customer can never read another\nproject's data (Refs #5270, #5271).","operationId":"query_lakehouse_api_v1_projects__project_id__database_lakehouse_query_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LakehouseQueryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LakehouseQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/lakehouse/ingest":{"post":{"tags":["ZeroDB Lakehouse","ZeroDB Lakehouse"],"summary":"Ingest records into the project's lakehouse partition","description":"Write records into *this project's* lakehouse partition.\n\nThe caller must own ``project_id``. Records are written under\n``tenant={project_id}/{sensor_type}/date=…`` and flushed immediately, so they\nare queryable via the project-scoped query endpoint right away and are never\nvisible to another project (Refs #5275, #5270).","operationId":"ingest_lakehouse_api_v1_projects__project_id__database_lakehouse_ingest_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LakehouseIngestRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LakehouseIngestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/lakehouse/data":{"delete":{"tags":["ZeroDB Lakehouse","ZeroDB Lakehouse"],"summary":"Delete lakehouse data from the project's partition","description":"Delete this project's lakehouse data.\n\nDeletes objects under ``tenant={project_id}/{sensor_type}/`` (or the whole\n``tenant={project_id}/`` partition when ``sensor_type`` is omitted and\n``confirm=true``). Ownership-checked and physically scoped to the project's\nown prefix — a project can never delete another tenant's data (Refs #5291).","operationId":"delete_lakehouse_data_api_v1_projects__project_id__database_lakehouse_data_delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"sensor_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sensor/table to delete. Omit + confirm=true to delete ALL project data.","title":"Sensor Type"},"description":"Sensor/table to delete. Omit + confirm=true to delete ALL project data."},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","description":"Required to delete the whole project partition when sensor_type is omitted.","default":false,"title":"Confirm"},"description":"Required to delete the whole project partition when sensor_type is omitted."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LakehouseDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/lakehouse/tables":{"get":{"tags":["ZeroDB Lakehouse","ZeroDB Lakehouse"],"summary":"List lakehouse tables (sensor types)","description":"List sensor type tables in *this project's* lakehouse partition.","operationId":"list_lakehouse_tables_api_v1_projects__project_id__database_lakehouse_tables_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LakehouseTableInfo"},"title":"Response List Lakehouse Tables Api V1 Projects Project Id Database Lakehouse Tables Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/lakehouse/stats":{"get":{"tags":["ZeroDB Lakehouse","ZeroDB Lakehouse"],"summary":"Lakehouse data volume statistics","description":"Get aggregate statistics for *this project's* lakehouse partition.","operationId":"lakehouse_stats_api_v1_projects__project_id__database_lakehouse_stats_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LakehouseStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/database/lakehouse/connectors":{"get":{"tags":["ZeroDB Lakehouse","ZeroDB Lakehouse"],"summary":"Connector ingestion status","description":"Get status of data connectors writing to *this project's* partition.","operationId":"connector_status_api_v1_projects__project_id__database_lakehouse_connectors_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConnectorStatusResponse"},"title":"Response Connector Status Api V1 Projects Project Id Database Lakehouse Connectors Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/activation/activate":{"post":{"tags":["🔐 Activation","activation"],"summary":"Activate Account","description":"Activate user account and set password\n\nThis endpoint is used when users click the activation link from the\n\"Claim 30 Days Free\" email campaign.\n\nSteps:\n1. Validate activation token\n2. Check token hasn't expired\n3. Hash the provided password\n4. Update user account (set password, activate account)\n5. Mark token as used\n6. Return success with trial info","operationId":"activate_account_api_v1_auth_activation_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateAccountResponse"}}}},"400":{"description":"Activation link already used, expired, or account already activated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Invalid activation token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/activation/validate/{token}":{"get":{"tags":["🔐 Activation","activation"],"summary":"Validate Token","description":"Validate an activation token without using it\n\nUsed by the frontend to check if a token is valid before\nshowing the password setup form.","operationId":"validate_token_api_v1_auth_activation_validate__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/activation/resend-activation":{"post":{"tags":["🔐 Activation","activation"],"summary":"Resend Activation","description":"Resend activation email for a user\n\nThis can be used if the original activation link expired.","operationId":"resend_activation_api_v1_auth_activation_resend_activation_post","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","format":"email","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendActivationResponse"}}}},"400":{"description":"Account already activated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/sso/config":{"post":{"tags":["Enterprise SSO"],"summary":"Create Sso Config","description":"Create a new SSO configuration for a tenant. Requires tenant ADMIN or OWNER role.","operationId":"create_sso_config_api_v1_auth_sso_config_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SSOConfigCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SSOConfigResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not a tenant admin or owner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"409":{"description":"SSO configuration already exists for this tenant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Missing required protocol-specific fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Authentication temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sso/config/{tenant_id}":{"get":{"tags":["Enterprise SSO"],"summary":"Get Sso Config","description":"Get the SSO configuration for a tenant. Requires tenant membership.","operationId":"get_sso_config_api_v1_auth_sso_config__tenant_id__get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SSOConfigResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not a member of this tenant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"No SSO configuration found for this tenant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Authentication temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sso/config/{config_id}":{"put":{"tags":["Enterprise SSO"],"summary":"Update Sso Config","description":"Update an SSO configuration. Requires tenant ADMIN or OWNER role.","operationId":"update_sso_config_api_v1_auth_sso_config__config_id__put","parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"string","title":"Config Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SSOConfigUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SSOConfigResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not a tenant admin or owner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"SSO config not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"No valid fields to update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Authentication temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"delete":{"tags":["Enterprise SSO"],"summary":"Delete Sso Config","description":"Delete an SSO configuration. Requires tenant ADMIN or OWNER role.\n\nRefs #8683: this was a soft delete (`SET deleted_at = NOW()`), but\ntenant_sso_configs has no deleted_at column, so the statement could\nnever run. It is a hard DELETE now, which is also what the real\nuq_tenant_sso_protocol constraint on (tenant_id, protocol) requires --\na retained soft-deleted row would permanently block re-creating a\nconfig for the same tenant and protocol.","operationId":"delete_sso_config_api_v1_auth_sso_config__config_id__delete","parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"string","title":"Config Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"204":{"description":"Successful Response"},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not a tenant admin or owner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"SSO config not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Authentication temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sso/config/{config_id}/test":{"post":{"tags":["Enterprise SSO"],"summary":"Test Sso Connection","description":"Test SSO configuration connectivity. Requires tenant ADMIN or OWNER role.","operationId":"test_sso_connection_api_v1_auth_sso_config__config_id__test_post","parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"string","title":"Config Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SSOTestResult"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not a tenant admin or owner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"SSO config not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"Authentication temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sso/login/{tenant_slug}":{"get":{"tags":["Enterprise SSO"],"summary":"Initiate Sso Login","description":"Initiate SSO login by redirecting to the IdP.\n\nFor SAML: redirects to IdP SSO URL with SAMLRequest parameters.\nFor OIDC: redirects to IdP authorization endpoint with code flow parameters.\n\n!!! KNOWN BROKEN -- DO NOT PARTIALLY FIX. Refs #8683. !!!\n\nThis endpoint 500s on every call in production today. It has TWO\nindependent blockers, and fixing only the first makes things worse,\nnot better:\n\n 1. The lookup query below selects c.idp_sso_url / c.oidc_client_id /\n c.oidc_discovery_url / c.oidc_scopes and filters on\n c.deleted_at -- none of those columns exist on\n tenant_sso_configs. It also compares c.status to lowercase\n 'active' when the real values are uppercase.\n 2. The very next statement INSERTs into `sso_login_sessions`, a\n table that exists nowhere in scripts/sync-production-schema.py or\n app/models/. saml_callback/oidc_callback additionally need\n `sso_auth_events`, equally nonexistent.\n\n#8683 fixed blocker 1 everywhere it appears in the config CRUD +\nSP-metadata surface, but left this handler alone on purpose: repairing\nthe query here would only move the identical 500 one statement\ndownstream, producing an endpoint that looks fixed and still cannot\ncomplete a single login.\n\nUnblocking this needs a human decision first -- whether SSO login was\never used by a real customer at all, or whether the feature should be\ndeprecated instead of built out -- plus a designed schema for SSO\nsession/state storage going through the schema dry-run gate (CLAUDE.md\nrule 6). The proposed table shapes are in #8683's PR body.","operationId":"initiate_sso_login_api_v1_auth_sso_login__tenant_slug__get","parameters":[{"name":"tenant_slug","in":"path","required":true,"schema":{"type":"string","title":"Tenant Slug"}},{"name":"redirect_uri","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Where to redirect after SSO completes","title":"Redirect Uri"},"description":"Where to redirect after SSO completes"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Unsupported SSO protocol","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"SSO configuration is not active","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"SSO not configured for this tenant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/sso/saml/callback":{"post":{"tags":["Enterprise SSO"],"summary":"Saml Callback","description":"SAML Assertion Consumer Service (ACS) endpoint.\n\nReceives the SAML Response from the IdP, validates the assertion,\nextracts user attributes, JIT-provisions if needed, and returns a JWT.","operationId":"saml_callback_api_v1_auth_sso_saml_callback_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Missing/invalid SAML response or session state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"SAML authentication failed at IdP","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"User not found and auto-provisioning is disabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"500":{"description":"SSO config not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sso/oidc/callback":{"get":{"tags":["Enterprise SSO"],"summary":"Oidc Callback","description":"OIDC callback endpoint.\n\nExchanges the authorization code for tokens, validates the id_token,\nextracts user claims, JIT-provisions if needed, and returns a JWT.","operationId":"oidc_callback_api_v1_auth_sso_oidc_callback_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"Authorization code from IdP","title":"Code"},"description":"Authorization code from IdP"},{"name":"state","in":"query","required":true,"schema":{"type":"string","description":"State parameter for CSRF validation","title":"State"},"description":"State parameter for CSRF validation"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid/expired session state or could not extract email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"401":{"description":"OIDC token exchange failed or no token returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"User not found and auto-provisioning is disabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"SSO config not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"502":{"description":"Failed to reach IdP token endpoint","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"504":{"description":"IdP token endpoint timed out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/sso/saml/metadata/{tenant_id}":{"get":{"tags":["Enterprise SSO"],"summary":"Get Saml Metadata","description":"Return SAML Service Provider metadata XML for IdP configuration.","operationId":"get_saml_metadata_api_v1_auth_sso_saml_metadata__tenant_id__get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"SAML Service Provider metadata document","content":{"application/xml":{"schema":{"type":"string"}}}},"404":{"description":"No SAML SSO config found for this tenant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/sso/check-domain/{email}":{"get":{"tags":["Enterprise SSO"],"summary":"Check Domain Sso","description":"Check whether an email domain requires SSO login.\n\nCalled before password login to enforce SSO for configured domains.\nThis endpoint is intentionally unauthenticated to support pre-login checks.","operationId":"check_domain_sso_api_v1_auth_sso_check_domain__email__get","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SSODomainCheck"}}}},"422":{"description":"Invalid email format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/agents/register":{"post":{"tags":["Agent Identity (AAP)"],"summary":"Register Agent","description":"Register a new agent under the authenticated user.\n\nThe agent receives a unique ID and is bound to the user's account.\nCapabilities are validated against the platform taxonomy.","operationId":"register_agent_api_v1_auth_agents_register_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_auth__AgentRegisterRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Invalid capabilities requested","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"429":{"description":"Maximum of 50 agents per user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/agents":{"get":{"tags":["Agent Identity (AAP)"],"summary":"List Agents","description":"List all registered agents for the authenticated user.","operationId":"list_agents_api_v1_auth_agents_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/AgentStatus-Input"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentResponse"},"title":"Response List Agents Api V1 Auth Agents Get"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/agents/{agent_id}":{"get":{"tags":["Agent Identity (AAP)"],"summary":"Get Agent","description":"Get details for a specific agent.","operationId":"get_agent_api_v1_auth_agents__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not authorized to access this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Agent Identity (AAP)"],"summary":"Update Agent","description":"Update an agent's configuration. Only the agent owner can update.","operationId":"update_agent_api_v1_auth_agents__agent_id__put","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not authorized to access this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"No valid fields to update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"delete":{"tags":["Agent Identity (AAP)"],"summary":"Delete Agent","description":"Revoke and soft-delete an agent. Also revokes all its API keys.","operationId":"delete_agent_api_v1_auth_agents__agent_id__delete","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"204":{"description":"Successful Response"},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not authorized to access this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/agents/{agent_id}/token":{"post":{"tags":["Agent Identity (AAP)"],"summary":"Generate Agent Token","description":"Generate an AAP-extended JWT for an agent.\n\nThe token includes agent identity, capabilities, oversight level,\nand delegation chain. Supports capability subset restriction.","operationId":"generate_agent_token_api_v1_auth_agents__agent_id__token_post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTokenRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTokenResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not authorized to access this agent, or agent is not active","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Invalid capability subset or delegation chain","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}}},"/api/v1/auth/agents/{agent_id}/keys":{"post":{"tags":["Agent Identity (AAP)"],"summary":"Create Agent Key","description":"Create a capability-scoped API key for an agent.\n\nThe raw key is returned only once at creation time. Store it securely.\nKey format: ak_{agent_id_prefix}_{random_token}","operationId":"create_agent_key_api_v1_auth_agents__agent_id__keys_post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_auth__AgentKeyCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_auth__AgentKeyCreatedResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not authorized to access this agent, or agent is inactive","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Capabilities not granted to this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"429":{"description":"Maximum of 20 active keys per agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"get":{"tags":["Agent Identity (AAP)"],"summary":"List Agent Keys","description":"List all API keys for an agent. Raw keys are not returned.","operationId":"list_agent_keys_api_v1_auth_agents__agent_id__keys_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_auth__AgentKeyResponse"},"title":"Response List Agent Keys Api V1 Auth Agents Agent Id Keys Get"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not authorized to access this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/agents/{agent_id}/keys/{key_id}":{"delete":{"tags":["Agent Identity (AAP)"],"summary":"Revoke Agent Key","description":"Revoke a specific API key for an agent.","operationId":"revoke_agent_key_api_v1_auth_agents__agent_id__keys__key_id__delete","parameters":[{"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"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"204":{"description":"Successful Response"},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not authorized to access this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Agent not found, key not found, or already revoked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/agents/{agent_id}/audit":{"get":{"tags":["Agent Identity (AAP)"],"summary":"Get Agent Audit","description":"Get audit logs for a specific agent.","operationId":"get_agent_audit_api_v1_auth_agents__agent_id__audit_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"action","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by action type","title":"Action"},"description":"Filter by action type"},{"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"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentAuditEntry"},"title":"Response Get Agent Audit Api V1 Auth Agents Agent Id Audit Get"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"403":{"description":"Not authorized to access this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/capabilities":{"get":{"tags":["Agent Identity (AAP)"],"summary":"List Capabilities","description":"List all available capability scopes in the platform taxonomy.","operationId":"list_capabilities_api_v1_auth_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CapabilityInfo"},"type":"array","title":"Response List Capabilities Api V1 Auth Capabilities Get"}}}}}}},"/api/v1/auth/keys":{"post":{"tags":["Agent API Keys"],"summary":"Create agent-scoped API key","description":"Create a new API key with TTL and namespace-restricted scopes. The raw key is returned **once** — store it immediately.","operationId":"create_key_api_v1_auth_keys_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_keys__AgentKeyCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_keys__AgentKeyCreatedResponse"}}}},"401":{"description":"Authentication required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Invalid scopes or permissions manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}}},"get":{"tags":["Agent API Keys"],"summary":"List agent-scoped API keys","description":"List all active API keys for the authenticated user.","operationId":"list_keys_api_v1_auth_keys_get","parameters":[{"name":"include_inactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include revoked/inactive keys in the response.","default":false,"title":"Include Inactive"},"description":"Include revoked/inactive keys in the response."},{"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"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_keys__AgentKeyResponse"},"title":"Response List Keys Api V1 Auth Keys Get"}}}},"401":{"description":"Authentication required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/keys/{key_id}":{"delete":{"tags":["Agent API Keys"],"summary":"Revoke agent-scoped API key","description":"Permanently revoke a key. This cannot be undone.","operationId":"revoke_key_api_v1_auth_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"204":{"description":"Successful Response"},"401":{"description":"Authentication required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Key not found or already revoked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/keys/{key_id}/permissions":{"get":{"tags":["Agent API Keys"],"summary":"Get RBAC permission manifest for an agent API key","description":"Returns the fine-grained RBAC permission manifest attached to the key. The key must belong to the authenticated user. An empty object `{}` means the key has unrestricted access. Refs #2891.","operationId":"get_permissions_api_v1_auth_keys__key_id__permissions_get","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Permissions Api V1 Auth Keys Key Id Permissions Get"}}}},"401":{"description":"Authentication required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Key not found or does not belong to the authenticated user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/keys/{key_id}/check-permission":{"post":{"tags":["Agent API Keys"],"summary":"Check whether an agent API key is allowed to perform an action","description":"Evaluates the key's RBAC manifest against the supplied tool, namespace, and/or route and returns whether the action is permitted. The key must belong to the authenticated user. Refs #2891.","operationId":"check_key_permission_api_v1_auth_keys__key_id__check_permission_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckPermissionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckPermissionResponse"}}}},"401":{"description":"Authentication required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"404":{"description":"Key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-keys/create_api_key":{"post":{"tags":["API Keys","OAuth API Keys"],"summary":"Create Api Key","description":"Create a new API key for the authenticated user.\n\n- Generates a random key with ``sk-`` prefix.\n- Stores the SHA-256 hash in the ``api_keys`` table (never the plaintext).\n- Rate-limited to 5 keys per hour per user.\n- Keys expire after 90 days by default.","operationId":"create_api_key_api_v1_api_keys_create_api_key_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyRequest","default":{"name":"claude-cli"}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyResponse"}}}},"401":{"description":"Could not validate credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Rate limit exceeded: maximum 5 API keys per hour","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database connection or API key storage unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/api-keys/roles":{"get":{"tags":["API Keys","OAuth API Keys"],"summary":"Get Roles","description":"Return roles and permissions for the authenticated user.\n\nCurrently all authenticated users receive the ``user`` role with\n``read``, ``write``, and ``execute`` permissions.","operationId":"get_roles_api_v1_api_keys_roles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RolesResponse"}}}},"401":{"description":"Could not validate credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}},"503":{"description":"Database connection unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}}},"components":{"schemas":{"A2AFeedbackAck":{"properties":{"received":{"type":"boolean","title":"Received"},"agent_id":{"type":"string","title":"Agent Id"},"actions":{"items":{},"type":"array","title":"Actions"}},"type":"object","required":["received","agent_id","actions"],"title":"A2AFeedbackAck","description":"Ack returned by the inbound feedback endpoint."},"A2AInteractionItem":{"properties":{"id":{"type":"string","title":"Id"},"caller_agent_id":{"type":"string","title":"Caller Agent Id"},"target_agent_id":{"type":"string","title":"Target Agent Id"},"message_type":{"type":"string","title":"Message Type"},"correlation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Correlation Id"},"status":{"$ref":"#/components/schemas/A2AInteractionStatus","description":"Canonical A2A interaction status (pending/delivered/expired/failed)."},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"credit_cost":{"type":"number","title":"Credit Cost","default":0},"request_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Request Summary"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"routed_by_capability":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Routed By Capability"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","caller_agent_id","target_agent_id","message_type","status","created_at"],"title":"A2AInteractionItem","description":"Single row in an interaction-history response."},"A2AInteractionListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/A2AInteractionItem"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"},"pages":{"type":"integer","title":"Pages"}},"type":"object","required":["items","total","page","per_page","pages"],"title":"A2AInteractionListResponse","description":"Paginated list of A2A interactions."},"A2AInteractionStatus":{"type":"string","enum":["pending","delivered","expired","failed"],"title":"A2AInteractionStatus","description":"Single canonical vocabulary for an A2A interaction's outcome.\n\nThis is the ONE source of truth shared by the backend response\n(A2AInteractionItem.status) and the frontend / A2AMessage domain model.\nHistorically the router persisted HTTP-flavoured values\n({success, timeout, error}) which drifted from the documented delivery\nlifecycle the UI renders ({pending, delivered, failed, expired}). New rows\nare written with these canonical values; legacy rows are normalized on read\nvia ``normalize``."},"A2AMessageRequest":{"properties":{"message_type":{"type":"string","maxLength":64,"minLength":1,"title":"Message Type","description":"Type of message: task_request, task_response, status_check, etc."},"content":{"additionalProperties":true,"type":"object","title":"Content","description":"Arbitrary payload forwarded to the target agent."}},"type":"object","required":["message_type","content"],"title":"A2AMessageRequest","description":"Body for POST /a2a/{agent_id}/message (direct message)."},"A2AMessageResponse":{"properties":{"result":{"additionalProperties":true,"type":"object","title":"Result","description":"Payload returned by the target agent."},"correlation_id":{"type":"string","title":"Correlation Id","description":"UUID correlating this request/response pair."}},"type":"object","required":["result","correlation_id"],"title":"A2AMessageResponse","description":"Response for a direct A2A message."},"A2AReceiveResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"action":{"type":"string","title":"Action"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["success","action","data"],"title":"A2AReceiveResponse","description":"Success body returned to the A2A deliverer.\n\nAgentA2ARouterService.route_direct() only requires HTTP 200 + a JSON\nobject; it stores this verbatim as A2AMessageResponse.result. Shaped as\n{success, action, data} so a human (or another agent) reading the A2A\ninteraction log sees a predictable, self-describing result."},"A2ARouteRequest":{"properties":{"capability":{"type":"string","maxLength":255,"minLength":1,"title":"Capability","description":"Capability slug to match against agent registrations."},"message":{"$ref":"#/components/schemas/A2AMessageRequest","description":"The message to deliver to the matched agent."},"preferences":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Preferences","description":"Optional routing preferences: protocol, max_latency_ms, etc."}},"type":"object","required":["capability","message"],"title":"A2ARouteRequest","description":"Body for POST /a2a/route (capability-based routing)."},"A2ARouteResponse":{"properties":{"result":{"additionalProperties":true,"type":"object","title":"Result","description":"Payload returned by the matched agent."},"routed_to":{"type":"string","title":"Routed To","description":"agent_id of the agent that handled the request."},"correlation_id":{"type":"string","title":"Correlation Id","description":"UUID correlating this request/response pair."}},"type":"object","required":["result","routed_to","correlation_id"],"title":"A2ARouteResponse","description":"Response for a capability-routed A2A message."},"A2ATaskResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"agent_id":{"type":"string","title":"Agent Id"},"status":{"type":"string","title":"Status"},"output":{"type":"string","title":"Output"},"context_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["task_id","agent_id","status","output"],"title":"A2ATaskResponse","description":"Stored/enriched task record (see a2a_service.create_task/get_task)."},"ABTestCreatedResponse":{"properties":{"message":{"type":"string","title":"Message"},"test_id":{"type":"string","title":"Test Id"},"test_name":{"type":"string","title":"Test Name"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["message","test_id","test_name","created_at"],"title":"ABTestCreatedResponse","description":"Response for POST /prompts/ab-test."},"ABTestDetailResponse":{"properties":{"test_id":{"type":"string","title":"Test Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"test_type":{"type":"string","title":"Test Type"},"variants":{"items":{"$ref":"#/components/schemas/ABTestVariantDetail"},"type":"array","title":"Variants"},"target_metrics":{"items":{"type":"string"},"type":"array","title":"Target Metrics"},"success_criteria":{"additionalProperties":true,"type":"object","title":"Success Criteria"},"statistical_config":{"$ref":"#/components/schemas/ABTestStatisticalConfig"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"created_by":{"type":"string","title":"Created By"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"},"analysis_result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Analysis Result"}},"additionalProperties":true,"type":"object","required":["test_id","name","description","test_type","variants","target_metrics","success_criteria","statistical_config","created_at","created_by"],"title":"ABTestDetailResponse","description":"Response for GET /ab-testing/tests/{test_id}."},"ABTestMetadata":{"properties":{"variant":{"type":"string","pattern":"^[AB]$","title":"Variant","description":"Variant identifier (A or B)"},"test_id":{"type":"string","title":"Test Id","description":"Unique test session identifier"}},"type":"object","required":["variant","test_id"],"title":"ABTestMetadata","description":"Schema for A/B test metadata\nIssue #563: Ad Serving - Response Generation\n\nContains A/B testing information when campaign uses A_B_TEST strategy.","example":{"test_id":"test_abc123xyz789","variant":"A"}},"ABTestRequest":{"properties":{"test_name":{"type":"string","title":"Test Name","description":"Name of the A/B test"},"prompt_a":{"type":"string","title":"Prompt A","description":"First prompt variation"},"prompt_b":{"type":"string","title":"Prompt B","description":"Second prompt variation"},"test_cases":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Test Cases","description":"Test cases to evaluate"},"providers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Providers","description":"AI providers to test against"}},"type":"object","required":["test_name","prompt_a","prompt_b","test_cases"],"title":"ABTestRequest","description":"Request to create A/B test"},"ABTestResponse":{"properties":{"test_id":{"type":"string","title":"Test Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"test_type":{"type":"string","title":"Test Type"},"status":{"type":"string","title":"Status"},"variants_count":{"type":"integer","title":"Variants Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"created_by":{"type":"string","title":"Created By"}},"type":"object","required":["test_id","name","description","test_type","status","variants_count","created_at","created_by"],"title":"ABTestResponse"},"ABTestRunResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"ABTestRunResponse","description":"Response for POST /prompts/ab-test/{test_id}/run.\n\nReal shape is PromptFooService.run_ab_test()'s own result dict."},"ABTestStatisticalConfig":{"properties":{"statistical_power":{"type":"number","title":"Statistical Power"},"confidence_level":{"type":"number","title":"Confidence Level"},"minimum_sample_size":{"type":"integer","title":"Minimum Sample Size"},"maximum_duration_days":{"type":"integer","title":"Maximum Duration Days"}},"type":"object","required":["statistical_power","confidence_level","minimum_sample_size","maximum_duration_days"],"title":"ABTestStatisticalConfig"},"ABTestSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"progress":{"type":"number","title":"Progress"}},"type":"object","required":["id","name","status","progress"],"title":"ABTestSummary"},"ABTestVariantDetail":{"properties":{"variant_id":{"type":"string","title":"Variant Id"},"name":{"type":"string","title":"Name"},"prompt_version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Version Id"},"prompt_content":{"type":"string","title":"Prompt Content"},"traffic_allocation":{"type":"number","title":"Traffic Allocation"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"performance_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Performance Data"}},"additionalProperties":true,"type":"object","required":["variant_id","name","prompt_content","traffic_allocation","metadata"],"title":"ABTestVariantDetail"},"ABTestVersionResponse":{"properties":{"version_id":{"type":"string","title":"Version Id"}},"type":"object","required":["version_id"],"title":"ABTestVersionResponse","description":"Response for GET /ab-tests/{template_id}/version."},"ABTestingHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"timestamp":{"type":"string","title":"Timestamp"},"features":{"items":{"type":"string"},"type":"array","title":"Features"}},"type":"object","required":["status","service","timestamp","features"],"title":"ABTestingHealthResponse","description":"Response for GET /ab-testing/health."},"ACPAllowance":{"properties":{"max_amount":{"type":"integer","exclusiveMinimum":0,"title":"Max Amount"},"currency":{"type":"string","title":"Currency"},"expires_at":{"type":"string","title":"Expires At"},"reason":{"type":"string","title":"Reason","default":"one_time"}},"type":"object","required":["max_amount","currency","expires_at"],"title":"ACPAllowance"},"ACPCheckoutItem":{"properties":{"id":{"type":"string","title":"Id","description":"Plan name, e.g. 'Pro', 'Starter'."},"quantity":{"type":"integer","minimum":1,"title":"Quantity","default":1}},"type":"object","required":["id"],"title":"ACPCheckoutItem"},"ACPCheckoutSessionRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ACPCheckoutItem"},"type":"array","title":"Items"},"buyer":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Buyer"},"fulfillment_address":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fulfillment Address"}},"type":"object","required":["items"],"title":"ACPCheckoutSessionRequest"},"ACPDelegatePaymentRequest":{"properties":{"payment_method":{"$ref":"#/components/schemas/ACPPaymentMethod"},"allowance":{"$ref":"#/components/schemas/ACPAllowance"},"risk_signals":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Risk Signals"},"metadata":{"additionalProperties":{"type":"string"},"type":"object","title":"Metadata"},"billing_address":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Billing Address"}},"type":"object","required":["payment_method","allowance"],"title":"ACPDelegatePaymentRequest"},"ACPPaymentMethod":{"properties":{"type":{"type":"string","title":"Type"},"id":{"type":"string","title":"Id"}},"type":"object","required":["type","id"],"title":"ACPPaymentMethod"},"AIAssessment":{"properties":{"confidence":{"type":"number","maximum":1,"minimum":0,"title":"Confidence","description":"AI confidence score (0.0-1.0)"},"flags":{"items":{"type":"string"},"type":"array","title":"Flags","description":"List of detected issues"},"checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checked At","description":"Timestamp of AI check"},"details":{"additionalProperties":true,"type":"object","title":"Details","description":"Additional assessment details"}},"type":"object","required":["confidence","flags"],"title":"AIAssessment","description":"AI moderation assessment data"},"AIContextCreate":{"properties":{"context_type":{"type":"string","title":"Context Type","description":"Type of context (e.g., preference, history)"},"data":{"additionalProperties":true,"type":"object","title":"Data","description":"Context data"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"priority":{"type":"integer","title":"Priority","description":"Priority of the context (higher = more important)","default":0},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["context_type","data"],"title":"AIContextCreate","description":"Schema for creating an AI context"},"AIContextRead":{"properties":{"context_type":{"type":"string","title":"Context Type","description":"Type of context (e.g., preference, history)"},"data":{"additionalProperties":true,"type":"object","title":"Data","description":"Context data"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"priority":{"type":"integer","title":"Priority","description":"Priority of the context (higher = more important)","default":0},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"id":{"type":"string","format":"uuid","title":"Id","description":"Unique identifier"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Timestamp"}},"type":"object","required":["context_type","data","id","created_at","updated_at"],"title":"AIContextRead","description":"Schema for reading an AI context"},"AIContextRequest":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User ID to get context for"},"hackathon_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Hackathon Id","description":"Optional hackathon ID filter"},"context_type":{"type":"string","minLength":1,"title":"Context Type","description":"Type of context (judge_scoring, organizer_workflow, etc.)"},"max_tokens":{"anyOf":[{"type":"integer","maximum":10000,"minimum":100},{"type":"null"}],"title":"Max Tokens","description":"Maximum tokens for context","default":2000}},"type":"object","required":["user_id","context_type"],"title":"AIContextRequest","description":"Request schema for getting AI context"},"AIContextResponse":{"properties":{"context":{"type":"string","title":"Context","description":"Formatted context for AI"},"memories":{"items":{"$ref":"#/components/schemas/MemoryEntry"},"type":"array","title":"Memories","description":"Retrieved memories"},"token_count":{"type":"integer","title":"Token Count","description":"Estimated token count"}},"type":"object","required":["context","memories","token_count"],"title":"AIContextResponse","description":"Response schema for AI context retrieval"},"AIContextUpdate":{"properties":{"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"priority":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Priority"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","title":"AIContextUpdate"},"AIConversationCreate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"}},"type":"object","title":"AIConversationCreate","description":"Schema for creating an AI conversation"},"AIConversationDetail":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"},"id":{"type":"string","format":"uuid","title":"Id","description":"Unique identifier"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Timestamp"},"message_count":{"type":"integer","title":"Message Count","default":0},"messages":{"items":{"$ref":"#/components/schemas/AIMessageRead"},"type":"array","title":"Messages","default":[]}},"type":"object","required":["id","is_active","created_at","updated_at"],"title":"AIConversationDetail","description":"Detailed conversation schema with messages"},"AIConversationRead":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"},"id":{"type":"string","format":"uuid","title":"Id","description":"Unique identifier"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Timestamp"},"message_count":{"type":"integer","title":"Message Count","default":0}},"type":"object","required":["id","is_active","created_at","updated_at"],"title":"AIConversationRead","description":"Schema for reading an AI conversation"},"AIConversationUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"}},"type":"object","title":"AIConversationUpdate"},"AIFeedbackAnalyticsByType":{"properties":{"content_type":{"type":"string","title":"Content Type","description":"Type of AI-generated content"},"total_feedback":{"type":"integer","minimum":0,"title":"Total Feedback","description":"Total number of feedback items"},"avg_rating":{"type":"number","maximum":5,"minimum":1,"title":"Avg Rating","description":"Average rating"},"rating_1_count":{"type":"integer","minimum":0,"title":"Rating 1 Count","description":"Count of 1-star ratings"},"rating_2_count":{"type":"integer","minimum":0,"title":"Rating 2 Count","description":"Count of 2-star ratings"},"rating_3_count":{"type":"integer","minimum":0,"title":"Rating 3 Count","description":"Count of 3-star ratings"},"rating_4_count":{"type":"integer","minimum":0,"title":"Rating 4 Count","description":"Count of 4-star ratings"},"rating_5_count":{"type":"integer","minimum":0,"title":"Rating 5 Count","description":"Count of 5-star ratings"}},"type":"object","required":["content_type","total_feedback","avg_rating","rating_1_count","rating_2_count","rating_3_count","rating_4_count","rating_5_count"],"title":"AIFeedbackAnalyticsByType","description":"Schema for feedback analytics by content type","example":{"avg_rating":4.2,"content_type":"video_description","rating_1_count":5,"rating_2_count":10,"rating_3_count":20,"rating_4_count":50,"rating_5_count":65,"total_feedback":150}},"AIFeedbackCreate":{"properties":{"content_type":{"type":"string","maxLength":50,"minLength":1,"title":"Content Type","description":"Type of AI-generated content (video_description, chapter, tag, etc.)","examples":["video_description"]},"content_id":{"type":"string","format":"uuid","title":"Content Id","description":"ID of the content being rated","examples":["550e8400-e29b-41d4-a716-446655440000"]},"rating":{"type":"integer","maximum":5,"minimum":1,"title":"Rating","description":"User rating from 1 to 5 stars","examples":[5]},"comment":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Comment","description":"Optional user comment explaining the rating","examples":["Great AI-generated description!"]},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata (model_version, prompt_tokens, etc.)","examples":[{"model_version":"v1.0","prompt_tokens":150}]}},"type":"object","required":["content_type","content_id","rating"],"title":"AIFeedbackCreate","description":"Schema for creating new AI feedback","example":{"comment":"Excellent AI-generated content!","content_id":"550e8400-e29b-41d4-a716-446655440000","content_type":"video_description","metadata":{"completion_tokens":300,"model_version":"v1.0","prompt_tokens":150},"rating":5}},"AIFeedbackListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AIFeedbackResponse"},"type":"array","title":"Items","description":"List of feedback items"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Total number of feedback items"},"page":{"type":"integer","minimum":1,"title":"Page","description":"Current page number"},"size":{"type":"integer","maximum":100,"minimum":1,"title":"Size","description":"Page size"},"pages":{"type":"integer","minimum":0,"title":"Pages","description":"Total number of pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"AIFeedbackListResponse","description":"Schema for paginated feedback list","example":{"items":[{"comment":"Great description!","content_id":"550e8400-e29b-41d4-a716-446655440000","content_type":"video_description","created_at":"2025-01-20T10:30:00Z","id":"650e8400-e29b-41d4-a716-446655440000","metadata":{"model_version":"v1.0"},"organization_id":"850e8400-e29b-41d4-a716-446655440000","rating":5,"user_id":"750e8400-e29b-41d4-a716-446655440000"}],"page":1,"pages":1,"size":50,"total":42}},"AIFeedbackResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique feedback ID"},"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User who provided feedback"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id","description":"Organization ID"},"content_type":{"type":"string","title":"Content Type","description":"Type of AI-generated content"},"content_id":{"type":"string","format":"uuid","title":"Content Id","description":"ID of the content being rated"},"rating":{"type":"integer","maximum":5,"minimum":1,"title":"Rating","description":"User rating from 1 to 5 stars"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment","description":"Optional user comment"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Feedback creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["id","user_id","organization_id","content_type","content_id","rating","created_at"],"title":"AIFeedbackResponse","description":"Schema for AI feedback response","example":{"comment":"Excellent AI-generated content!","content_id":"550e8400-e29b-41d4-a716-446655440000","content_type":"video_description","created_at":"2025-01-20T10:30:00Z","id":"650e8400-e29b-41d4-a716-446655440000","metadata":{"model_version":"v1.0"},"organization_id":"850e8400-e29b-41d4-a716-446655440000","rating":5,"user_id":"750e8400-e29b-41d4-a716-446655440000"}},"AIGeneratePRDRequest":{"properties":{"project_idea":{"type":"string","title":"Project Idea","description":"Brief description of the project"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience","description":"Who will use this"},"key_features":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Features","description":"Key features list"},"business_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Goals","description":"Business goals list"}},"type":"object","required":["project_idea"],"title":"AIGeneratePRDRequest","description":"Request for AI PRD generation from a project idea"},"AIGenerateRequest":{"properties":{"prd_content":{"type":"string","title":"Prd Content","description":"PRD content"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name","description":"Project name"},"features":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Features","description":"Features list"},"technology_preferences":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Technology Preferences","description":"Technology preferences"},"data_model":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data Model","description":"Data model for backlog generation"},"backlog":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Backlog","description":"Backlog for sprint plan generation"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Model the user selected in the UI"}},"type":"object","required":["prd_content"],"title":"AIGenerateRequest","description":"Request for AI generation endpoints"},"AIMessageCreate":{"properties":{"role":{"type":"string","title":"Role","description":"Role of the message sender (user, assistant, system)"},"content":{"type":"string","title":"Content","description":"Content of the message"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"}},"type":"object","required":["role","content"],"title":"AIMessageCreate","description":"Schema for creating an AI message"},"AIMessageRead":{"properties":{"role":{"type":"string","title":"Role","description":"Role of the message sender (user, assistant, system)"},"content":{"type":"string","title":"Content","description":"Content of the message"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"},"id":{"type":"string","format":"uuid","title":"Id","description":"Unique identifier"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id","description":"Unique identifier"},"sequence":{"type":"integer","title":"Sequence"},"tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"}},"type":"object","required":["role","content","id","conversation_id","sequence","created_at"],"title":"AIMessageRead","description":"Schema for reading an AI message"},"AIMessageSchema":{"properties":{"role":{"type":"string","title":"Role","description":"Role of the message sender (user, assistant, system)"},"content":{"type":"string","title":"Content","description":"Content of the message"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Name of the sender (for function calls)"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call","description":"Function call details if applicable"}},"type":"object","required":["role","content"],"title":"AIMessageSchema","description":"Schema for AI messages with additional metadata","example":{"content":"Can you help me with this Python code?","role":"user"}},"AIModelCreateSchema":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the AI model"},"provider":{"type":"string","title":"Provider","description":"Provider of the AI model"},"model_type":{"type":"string","title":"Model Type","description":"Type of the AI model"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the AI model"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities","description":"List of capabilities supported by the model","default":[]},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"Configuration parameters for the model","default":{}},"enabled":{"type":"boolean","title":"Enabled","description":"Whether the model is enabled","default":true},"is_default":{"type":"boolean","title":"Is Default","description":"Whether this is the default model","default":false},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Model category: chat, image, video, audio, coding, embedding"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug","description":"URL-friendly identifier"},"pricing":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pricing","description":"Pricing info: {credits, usd, unit}"},"endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint","description":"API endpoint path"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Preview image URL"},"speed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Speed","description":"Speed tier: Fast, Medium, Slow"},"quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality","description":"Quality tier: Standard, High, Cinematic"},"is_premium":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Premium","description":"Whether this is a premium model","default":false},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method","description":"HTTP method: GET, POST"},"example_prompts":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Example Prompts","description":"Array of example prompts"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type","description":"Source type: chat, image, video, audio, embedding"},"context_window":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Context Window","description":"Max input context window (tokens); 0/None = not published"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","description":"Max output tokens the model supports"}},"type":"object","required":["name","provider","model_type"],"title":"AIModelCreateSchema","description":"Schema for creating a new AI model","example":{"capabilities":["code_completion","code_explanation"],"config":{"max_tokens":2048,"temperature":0.7},"description":"Code generation model fine-tuned on code datasets","model_type":"codellama","name":"CodeLlama-7b","provider":"ollama"}},"AIModelReadSchema":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the AI model"},"provider":{"type":"string","title":"Provider","description":"Provider of the AI model"},"model_type":{"type":"string","title":"Model Type","description":"Type of the AI model"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the AI model"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities","description":"List of capabilities supported by the model","default":[]},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"Configuration parameters for the model","default":{}},"enabled":{"type":"boolean","title":"Enabled","description":"Whether the model is enabled","default":true},"is_default":{"type":"boolean","title":"Is Default","description":"Whether this is the default model","default":false},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Model category: chat, image, video, audio, coding, embedding"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug","description":"URL-friendly identifier"},"pricing":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pricing","description":"Pricing info: {credits, usd, unit}"},"endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint","description":"API endpoint path"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Preview image URL"},"speed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Speed","description":"Speed tier: Fast, Medium, Slow"},"quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality","description":"Quality tier: Standard, High, Cinematic"},"is_premium":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Premium","description":"Whether this is a premium model","default":false},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method","description":"HTTP method: GET, POST"},"example_prompts":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Example Prompts","description":"Array of example prompts"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type","description":"Source type: chat, image, video, audio, embedding"},"context_window":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Context Window","description":"Max input context window (tokens); 0/None = not published"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","description":"Max output tokens the model supports"},"id":{"type":"string","title":"Id","description":"Unique identifier for the AI model"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Time when the model was created"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Time when the model was last updated"},"versions":{"anyOf":[{"items":{"$ref":"#/components/schemas/ModelVersionReadSchema"},"type":"array"},{"type":"null"}],"title":"Versions","description":"List of available versions for this model","default":[]},"preview_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Preview Data","description":"Preview data for model demonstrations (Issue #1095)"}},"type":"object","required":["name","provider","model_type","id","created_at"],"title":"AIModelReadSchema","description":"Schema for reading an AI model"},"AIModelUpdateSchema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Name of the AI model"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the AI model"},"capabilities":{"anyOf":[{"items":{"$ref":"#/components/schemas/ModelCapabilityEnum"},"type":"array"},{"type":"null"}],"title":"Capabilities","description":"List of capabilities supported by the model"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"Configuration parameters for the model"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled","description":"Whether the model is enabled"},"is_default":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Default","description":"Whether this is the default model"}},"type":"object","title":"AIModelUpdateSchema","description":"\u0001"},"AIRequestCreateSchema":{"properties":{"model_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Id","description":"ID of the AI model to use (uses default if not specified)"},"messages":{"items":{"$ref":"#/components/schemas/AIMessageSchema"},"type":"array","title":"Messages","description":"List of messages in the conversation"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","description":"Maximum number of tokens to generate"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","description":"Temperature for sampling (0.0 to 1.0)"},"functions":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Functions","description":"List of available functions"},"function_call":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call","description":"Function call instruction"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"ID of the user making the request"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id","description":"ID of the organization"},"capability":{"$ref":"#/components/schemas/ModelCapabilityEnum","description":"Capability to use for this request"}},"type":"object","required":["messages","capability"],"title":"AIRequestCreateSchema","description":"Schema for creating a new AI request","example":{"capability":"code_completion","max_tokens":1024,"messages":[{"content":"Write a function to calculate Fibonacci numbers","role":"user"}],"model_id":"550e8400-e29b-41d4-a716-446655440000","temperature":0.7}},"AIRequestItem":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"tokens":{"type":"integer","title":"Tokens"},"type":{"type":"string","title":"Type"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["id","status","tokens","type"],"title":"AIRequestItem"},"AIRequestsResponse":{"properties":{"requests":{"items":{"$ref":"#/components/schemas/AIRequestItem"},"type":"array","title":"Requests"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"},"total_pages":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Pages"}},"type":"object","required":["requests","total","page","per_page"],"title":"AIRequestsResponse"},"AIResponseReadSchema":{"properties":{"model_id":{"type":"string","title":"Model Id","description":"ID of the AI model used"},"message":{"$ref":"#/components/schemas/AIMessageSchema","description":"Generated message"},"usage":{"additionalProperties":{"type":"integer"},"type":"object","title":"Usage","description":"Token usage statistics"},"finish_reason":{"type":"string","title":"Finish Reason","description":"Reason why generation finished"},"id":{"type":"string","title":"Id","description":"Unique identifier for the AI response"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Time when the response was created"}},"type":"object","required":["model_id","message","usage","finish_reason","id","created_at"],"title":"AIResponseReadSchema","description":"Schema for reading an AI response"},"AP2IssuerKeyCreateRequest":{"properties":{"issuer_id":{"type":"string","maxLength":500,"minLength":1,"title":"Issuer Id","description":"Mandate `iss` claim value"},"public_key":{"type":"string","minLength":1,"title":"Public Key","description":"PEM public key (RS256/ES256) or shared secret (HS256)"},"algorithm":{"type":"string","title":"Algorithm","description":"PyJWT algorithm name, e.g. RS256, ES256, HS256","default":"RS256"}},"type":"object","required":["issuer_id","public_key"],"title":"AP2IssuerKeyCreateRequest"},"AP2IssuerKeyResponse":{"properties":{"id":{"type":"string","title":"Id"},"issuer_id":{"type":"string","title":"Issuer Id"},"algorithm":{"type":"string","title":"Algorithm"},"created_at":{"type":"string","title":"Created At"},"revoked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revoked At"}},"type":"object","required":["id","issuer_id","algorithm","created_at","revoked_at"],"title":"AP2IssuerKeyResponse"},"AP2VerifyRequest":{"properties":{"mandate":{"type":"string","title":"Mandate"}},"type":"object","required":["mandate"],"title":"AP2VerifyRequest"},"APIErrorResponse":{"properties":{"detail":{"type":"string","title":"Detail"},"error_code":{"type":"string","title":"Error Code"},"next_action":{"type":"string","title":"Next Action"},"retry_after_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After Seconds"},"suggested_models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Suggested Models"},"upgrade_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upgrade Url"},"reset_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reset At"}},"type":"object","required":["detail","error_code","next_action"],"title":"APIErrorResponse","description":"Canonical error envelope returned by all API error responses."},"APIHealthInfo":{"properties":{"status":{"type":"string","title":"Status"},"active_users_today":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Users Today"},"response_time_ms":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Time Ms"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status"],"title":"APIHealthInfo","description":"API health information"},"APIKeyCreateRequest":{"properties":{"name":{"type":"string","title":"Name"},"expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Days"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"}},"type":"object","required":["name"],"title":"APIKeyCreateRequest","description":"API key creation request"},"APIKeyCreateResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"api_key":{"type":"string","title":"Api Key"},"key_preview":{"type":"string","title":"Key Preview"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"warning":{"type":"string","title":"Warning","default":"Save this key now - it won't be shown again!"}},"type":"object","required":["id","name","api_key","key_preview","is_active","created_at"],"title":"APIKeyCreateResponse","description":"API key creation response (includes full key once)"},"APIKeyHealthResponse":{"properties":{"key_id":{"type":"string","title":"Key Id"},"project_id":{"type":"string","title":"Project Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"key_project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Project Id"},"key_project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Project Name"},"suggested_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Action"}},"type":"object","required":["key_id","project_id","status","message"],"title":"APIKeyHealthResponse"},"APIKeyInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"usage_count":{"type":"integer","title":"Usage Count","default":0},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["id","name","prefix","is_active","created_at"],"title":"APIKeyInfo","description":"API key information (without exposing the actual key)"},"APIKeyListResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"items":{"$ref":"#/components/schemas/APIKeyInfo"},"type":"array","title":"Data","default":[]},"total":{"type":"integer","title":"Total","default":0}},"type":"object","title":"APIKeyListResponse","description":"Response for listing API keys"},"APIKeyResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"key_preview":{"type":"string","title":"Key Preview"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"usage_count":{"type":"integer","title":"Usage Count","default":0},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"billing_mode":{"type":"string","title":"Billing Mode","default":"credits"}},"type":"object","required":["id","name","key_preview","is_active","created_at"],"title":"APIKeyResponse","description":"API key response (without sensitive data)"},"APIKeyRevokeResponse":{"properties":{"message":{"type":"string","title":"Message"},"key_id":{"type":"string","title":"Key Id"}},"type":"object","required":["message","key_id"],"title":"APIKeyRevokeResponse","description":"Response for PATCH /{key_id}/revoke"},"APIKeyUpdateRequest":{"properties":{"billing_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Mode","description":"'credits' (default) or 'pay_per_use' (x402)"}},"type":"object","title":"APIKeyUpdateRequest","description":"Request body for PATCH /{key_id} — partial update of mutable fields.\n\nOnly ``billing_mode`` is supported today (Refs #9256). ``name`` is\naccepted for forward-compatibility with the frontend's existing\nUpdateApiKeyRequest shape but is a no-op until a real rename path is\nscoped — deliberately not implemented here to keep this change surgical."},"APIKeyVerifyActions":{"properties":{"claim_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Url"},"register_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Register Url"},"upgrade_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upgrade Url"}},"type":"object","title":"APIKeyVerifyActions","description":"``actions`` sub-object of POST /verify"},"APIKeyVerifyCapabilities":{"properties":{"chat_completions":{"type":"boolean","title":"Chat Completions"},"embeddings":{"type":"boolean","title":"Embeddings"},"zerodb":{"type":"boolean","title":"Zerodb"},"file_upload":{"type":"boolean","title":"File Upload"}},"type":"object","required":["chat_completions","embeddings","zerodb","file_upload"],"title":"APIKeyVerifyCapabilities","description":"``capabilities`` sub-object of POST /verify"},"APIKeyVerifyOrganization":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"is_default":{"type":"boolean","title":"Is Default","default":false}},"type":"object","required":["id"],"title":"APIKeyVerifyOrganization","description":"One organization the verified account is a member of. Refs #7546.\n\nEntries are ordered `is_default` first, then oldest-created, so\n`organizations[0]` is always the same org the scalar `organization_id`\nresolves to when no project-scoped org overrides it."},"APIKeyVerifyResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"email":{"type":"string","title":"Email"},"user_id":{"type":"string","title":"User Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"organizations":{"items":{"$ref":"#/components/schemas/APIKeyVerifyOrganization"},"type":"array","title":"Organizations"},"auth_method":{"type":"string","title":"Auth Method"},"user_plan":{"type":"string","title":"User Plan"},"tier":{"type":"string","title":"Tier"},"role":{"type":"string","title":"Role"},"is_temp_account":{"type":"boolean","title":"Is Temp Account"},"subscription":{"anyOf":[{"$ref":"#/components/schemas/APIKeyVerifySubscription"},{"type":"null"}]},"capabilities":{"$ref":"#/components/schemas/APIKeyVerifyCapabilities"},"actions":{"$ref":"#/components/schemas/APIKeyVerifyActions"}},"type":"object","required":["status","email","user_id","auth_method","user_plan","tier","role","is_temp_account","capabilities","actions"],"title":"APIKeyVerifyResponse","description":"Response for POST /api/v1/public/api-keys/verify.\n\nThis is the canonical AINative-identity-verification endpoint used by\nevery app's auth middleware (see docs/architecture/AINATIVE_UNIFIED_APP_AUTH.md).\nThe model below mirrors the handler's literal return dict field-for-field —\ndo not change field names/types without updating every consumer. Refs #2191."},"APIKeyVerifySubscription":{"properties":{"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"credits_total":{"type":"integer","title":"Credits Total","default":0},"credits_used":{"type":"number","title":"Credits Used","default":0},"credits_remaining":{"type":"number","title":"Credits Remaining","default":0},"max_requests_per_day":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Requests Per Day"},"max_tokens_per_month":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens Per Month"},"tokens_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens Used"}},"type":"object","title":"APIKeyVerifySubscription","description":"``subscription`` sub-object of POST /verify (null if no active subscription row)"},"APIKeysListResponse":{"properties":{"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"keys":{"items":{"$ref":"#/components/schemas/APIKeyResponse"},"type":"array","title":"Keys"}},"type":"object","required":["total","limit","offset","has_more","keys"],"title":"APIKeysListResponse","description":"API keys list response.\n\nPagination note (AINative-Studio/ainative-website#2208): this endpoint\ncurrently returns the full matching set in one page (no limit/offset\nquery params), so `has_more` is always False and `limit`/`offset`\nreflect the full result window returned. These fields are included so\nagent clients can rely on a consistent pagination shape across list\nendpoints without special-casing endpoints that happen to be unpaginated."},"AXAuditLeadCreate":{"properties":{"url":{"type":"string","title":"Url","description":"URL that was audited"},"email":{"type":"string","format":"email","title":"Email","description":"Contact email"},"score":{"type":"integer","maximum":100,"minimum":0,"title":"Score","description":"Overall AX score"},"findings_count":{"type":"integer","minimum":0,"title":"Findings Count","description":"Number of findings","default":0},"dimensions_failed":{"items":{"type":"string"},"type":"array","title":"Dimensions Failed","description":"Dimensions scoring below 50"},"package_interest":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Package Interest","description":"foundations|accelerator|transformation|service"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"}},"type":"object","required":["url","email","score"],"title":"AXAuditLeadCreate","description":"Create a lead from audit findings."},"AXAuditLeadResponse":{"properties":{"lead_id":{"type":"string","title":"Lead Id"},"url":{"type":"string","title":"Url"},"email":{"type":"string","title":"Email"},"score":{"type":"integer","title":"Score"},"findings_count":{"type":"integer","title":"Findings Count"},"package_interest":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Package Interest"},"booking_url":{"type":"string","title":"Booking Url"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["lead_id","url","email","score","findings_count","package_interest","booking_url","created_at"],"title":"AXAuditLeadResponse","description":"Lead response after creation."},"AXGradeBandCount":{"properties":{"grade":{"type":"string","title":"Grade"},"count":{"type":"integer","minimum":0,"title":"Count"}},"type":"object","required":["grade","count"],"title":"AXGradeBandCount","description":"Real count of opted-in sites in one grade band (core#9684)."},"AXHistogramBin":{"properties":{"bin_start":{"type":"integer","maximum":90,"minimum":0,"title":"Bin Start"},"bin_end":{"type":"integer","maximum":100,"minimum":10,"title":"Bin End"},"count":{"type":"integer","minimum":0,"title":"Count","description":"Real count of opted-in sites scoring in this bin."}},"type":"object","required":["bin_start","bin_end","count"],"title":"AXHistogramBin","description":"One 10-point score bin in the real research distribution (core#9684)."},"AXLayerBenchmark":{"properties":{"average_pct":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"title":"Average Pct","description":"Real pooled average score for this layer across opted-in sites, or None if too few sites have measured it yet."},"sample_size":{"type":"integer","minimum":0,"title":"Sample Size","description":"Real count of opted-in sites whose checks actually measured this layer (max > 0) -- not the overall site count."}},"type":"object","required":["sample_size"],"title":"AXLayerBenchmark","description":"Real ecosystem-wide average for one of the 4 dashboard layers\n(core#9504, ainative-ax#180).\n\naverage_pct is the real pooled ratio sum(earned)/sum(max) across every\nqualifying opted-in site, never a fabricated or estimated number.\nNone (never a fabricated 0) when fewer than `min_sample_size` real\nsites have measured this specific layer."},"AXLayerBenchmarksResponse":{"properties":{"sufficient_data":{"type":"boolean","title":"Sufficient Data"},"sample_size":{"type":"integer","minimum":0,"title":"Sample Size","description":"Real count of opted-in sites this aggregate was computed from."},"min_sample_size":{"type":"integer","title":"Min Sample Size"},"layers":{"additionalProperties":{"$ref":"#/components/schemas/AXLayerBenchmark"},"type":"object","title":"Layers"}},"type":"object","required":["sufficient_data","sample_size","min_sample_size","layers"],"title":"AXLayerBenchmarksResponse","description":"Real per-layer ecosystem averages for the dashboard's 4-layer\nDiscovery/Access/Usability/Payments breakdown (core#9504).\n\nMirrors the public leaderboard's own honesty-gate shape\n(sufficient_data/min_sample_size) so the two surfaces never disagree\nabout what counts as enough real data."},"AXLeaderboardResponse":{"properties":{"sufficient_data":{"type":"boolean","title":"Sufficient Data"},"min_sample_size":{"type":"integer","title":"Min Sample Size"},"rows":{"items":{"$ref":"#/components/schemas/AXLeaderboardRow"},"type":"array","title":"Rows"},"stats":{"$ref":"#/components/schemas/AXLeaderboardStats"},"offset":{"type":"integer","title":"Offset","default":0},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["sufficient_data","min_sample_size","rows","stats"],"title":"AXLeaderboardResponse","description":"Public Agentic Web Index leaderboard.\n\nsufficient_data distinguishes a genuinely short/empty leaderboard from a\nfully populated one, so the frontend can render an \"insufficient data /\nclaim your rank\" empty state instead of implying completeness.\n\noffset/has_more (core#9199) let a caller page through the full deduped\nset of domains -- rows are score-ranked (not alphabetically truncated),\nso offset/limit is how a caller reaches anything past the first page."},"AXLeaderboardRow":{"properties":{"domain":{"type":"string","title":"Domain"},"report_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Id","description":"The stored report's real UUID primary key (ax_audit_reports.id), so a client can route straight to the existing report (e.g. GET /report/) instead of re-scanning the domain on every leaderboard-row click. None for a row shape that predates this field."},"score":{"type":"integer","maximum":100,"minimum":0,"title":"Score"},"grade":{"type":"string","title":"Grade"},"ar_prov_conformant":{"type":"boolean","title":"Ar Prov Conformant","description":"True if the site passed both the MCP Discovery and Agent Discoverability checks from a real scan — never fabricated."},"scanned_at":{"type":"string","title":"Scanned At"},"source":{"type":"string","title":"Source","description":"'seed' = proactively scanned on our schedule from the curated ax_leaderboard_seeds list (Refs #9140); 'community' = submitted via /ax-audit/full with explicit opt-in.","default":"community"},"category":{"type":"string","title":"Category","description":"Industry category (ainative-ax#103). Sourced from the real `industry` value ONLY for 'seed' rows, where it is a genuine, deliberately-chosen classification (see ax_leaderboard_seeds / ax_seed_scan.py). 'community' rows get 'Uncategorized' rather than their row's `industry` column, which defaults to 'saas' for every /ax-audit/full submission regardless of the site's real industry (the frontend has no industry picker -- see services/auditService.ts's runFullAudit) -- surfacing it as a real category would misrepresent an unset default as a real signal.","default":"Uncategorized"},"trend":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trend","description":"core#9258: real {delta, direction} vs. this domain's score ~7 days ago (snapshot-diffed from real scan history in ax_audit_reports, not a precomputed/background-job field). None when no real scan exists that far back for this domain (e.g. scanned for the first time this week) -- never a fabricated 0."}},"type":"object","required":["domain","score","grade","ar_prov_conformant","scanned_at"],"title":"AXLeaderboardRow","description":"A single real scan result on the public leaderboard — either\nproactively seed-scanned or a user-submitted opt-in (Refs #9140)."},"AXLeaderboardStats":{"properties":{"total_sites_scored":{"type":"integer","minimum":0,"title":"Total Sites Scored"},"median_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Median Score"},"ar_prov_conformant_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ar Prov Conformant Pct"}},"type":"object","required":["total_sites_scored"],"title":"AXLeaderboardStats","description":"Real aggregate stats computed from stored, opted-in scan data.\n\nFields are None (never a fabricated 0) when there isn't enough data yet\nto compute them meaningfully."},"AXResearchCategoryBreakdown":{"properties":{"sample_size":{"type":"integer","minimum":0,"title":"Sample Size"},"sufficient_data":{"type":"boolean","title":"Sufficient Data"},"mean_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mean Score"},"grade_bands":{"items":{"$ref":"#/components/schemas/AXGradeBandCount"},"type":"array","title":"Grade Bands"},"layers":{"additionalProperties":{"$ref":"#/components/schemas/AXLayerBenchmark"},"type":"object","title":"Layers"}},"type":"object","required":["sample_size","sufficient_data","grade_bands","layers"],"title":"AXResearchCategoryBreakdown","description":"Real per-category stats for one industry segment (core#9684).\n\nScoped to real-category (source='seed') sites only -- a\nsource='community' row's `industry` defaults to 'saas' for every\nsubmission regardless of the site's actual industry (no industry\npicker exists in the submission flow), so including it here would\nfabricate a classification nobody chose."},"AXResearchCategoryBreakdownResponse":{"properties":{"min_sample_size":{"type":"integer","title":"Min Sample Size"},"categories":{"additionalProperties":{"$ref":"#/components/schemas/AXResearchCategoryBreakdown"},"type":"object","title":"Categories"}},"type":"object","required":["min_sample_size","categories"],"title":"AXResearchCategoryBreakdownResponse"},"AXResearchDistributionResponse":{"properties":{"sufficient_data":{"type":"boolean","title":"Sufficient Data"},"sample_size":{"type":"integer","minimum":0,"title":"Sample Size"},"min_sample_size":{"type":"integer","title":"Min Sample Size"},"median_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Median Score"},"histogram":{"items":{"$ref":"#/components/schemas/AXHistogramBin"},"type":"array","title":"Histogram"},"grade_bands":{"items":{"$ref":"#/components/schemas/AXGradeBandCount"},"type":"array","title":"Grade Bands"}},"type":"object","required":["sufficient_data","sample_size","min_sample_size","histogram","grade_bands"],"title":"AXResearchDistributionResponse","description":"Real score distribution over the public leaderboard's opt-in corpus\n(core#9684) -- a score histogram + grade-band counts + median, comparable\nto ora.ai/research's own distribution view.\n\nMirrors the leaderboard's own honesty-gate shape so the two public\nsurfaces never disagree about what counts as enough real data."},"AXResearchMoverEntry":{"properties":{"domain":{"type":"string","title":"Domain"},"category":{"type":"string","title":"Category"},"score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Score"},"grade":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade"},"category_avg_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Category Avg Score"},"gap_vs_category_avg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gap Vs Category Avg"}},"type":"object","required":["domain","category"],"title":"AXResearchMoverEntry","description":"One real site in the top/bottom movers list (core#9684).\n\ncategory_avg_score/gap_vs_category_avg are None when the site's\ncategory has fewer than min_sample_size real seed sites -- never a\nfabricated comparison against too few real points."},"AXResearchMoversResponse":{"properties":{"top":{"items":{"$ref":"#/components/schemas/AXResearchMoverEntry"},"type":"array","title":"Top"},"bottom":{"items":{"$ref":"#/components/schemas/AXResearchMoverEntry"},"type":"array","title":"Bottom"},"sample_size":{"type":"integer","minimum":0,"title":"Sample Size"},"min_sample_size":{"type":"integer","title":"Min Sample Size"}},"type":"object","required":["top","bottom","sample_size","min_sample_size"],"title":"AXResearchMoversResponse"},"AXResearchQuadrantPoint":{"properties":{"domain":{"type":"string","title":"Domain"},"category":{"type":"string","title":"Category"},"score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Score"},"grade":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade"},"discoverability_pct":{"type":"number","maximum":100,"minimum":0,"title":"Discoverability Pct"},"actionability_pct":{"type":"number","maximum":100,"minimum":0,"title":"Actionability Pct"}},"type":"object","required":["domain","category","discoverability_pct","actionability_pct"],"title":"AXResearchQuadrantPoint","description":"One real site's position on the Agent Readiness Quadrant (core#9684).\n\ndiscoverability_pct = real pooled AR-DISC earned/max ratio.\nactionability_pct = real pooled AR-AUTH+AR-CAP+AR-CONT+AR-COMM\nearned/max ratio. A site whose checks never measured BOTH axes is\nomitted upstream rather than plotted at a fabricated 0 -- see\nax_research_aggregates.compute_quadrant's docstring."},"AXResearchQuadrantResponse":{"properties":{"points":{"items":{"$ref":"#/components/schemas/AXResearchQuadrantPoint"},"type":"array","title":"Points"},"sample_size":{"type":"integer","minimum":0,"title":"Sample Size"}},"type":"object","required":["points","sample_size"],"title":"AXResearchQuadrantResponse"},"AXScopeCallRequest":{"properties":{"finding_ids":{"items":{"type":"string"},"type":"array","title":"Finding Ids","description":"IDs of findings to discuss"},"preferred_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preferred Time","description":"Preferred meeting time"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"AXScopeCallRequest","description":"Book a scope call for a lead."},"AXScopeCallResponse":{"properties":{"lead_id":{"type":"string","title":"Lead Id"},"status":{"type":"string","title":"Status"},"booking_url":{"type":"string","title":"Booking Url"},"findings_included":{"type":"integer","title":"Findings Included"}},"type":"object","required":["lead_id","status","booking_url","findings_included"],"title":"AXScopeCallResponse","description":"Response after booking a scope call."},"AXSparqlQueryRequest":{"properties":{"query":{"type":"string","maxLength":8000,"minLength":1,"title":"Query","description":"A read-only SPARQL 1.1 SELECT / ASK / CONSTRUCT query. UPDATE/INSERT/DELETE/LOAD/CLEAR/DROP are rejected with a 400."},"max_rows":{"type":"integer","maximum":1000,"minimum":1,"title":"Max Rows","description":"Hard cap on returned rows. Results beyond it are truncated and `truncated` is set to true.","default":1000}},"type":"object","required":["query"],"title":"AXSparqlQueryRequest","description":"One read-only SPARQL query against the public, consented AX corpus.\n\nValidated at the API boundary (CLAUDE.md rule 7). The read-only\nguarantee itself is enforced in ``sparql_service.assert_read_only``, not\nhere -- this only bounds the input size and the row cap so a public\ncaller cannot ask for an unbounded result set."},"AXSparqlQueryResponse":{"properties":{"query_type":{"type":"string","title":"Query Type","description":"SELECT | ASK | CONSTRUCT"},"columns":{"items":{"type":"string"},"type":"array","title":"Columns"},"rows":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Rows"},"boolean":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Boolean","description":"Present for ASK queries only."},"truncated":{"type":"boolean","title":"Truncated","description":"True when the row cap truncated the result.","default":false},"triples_in_scope":{"type":"integer","minimum":0,"title":"Triples In Scope","description":"Size of the consented graph this query ran against, rebuilt fresh for this request.","default":0}},"type":"object","required":["query_type"],"title":"AXSparqlQueryResponse","description":"Result of one public SPARQL query.\n\nThe queried graph contains ONLY (a) server-computed corpus aggregates\nand (b) full per-check detail for individually consented\n(``include_in_leaderboard = TRUE``) sites. It is rebuilt from the\ndatabase on every request and never cached, so a consent revocation\ntakes effect on the very next query (core#9426 AC-3)."},"AXSparqlVocabularyResponse":{"properties":{"endpoint":{"type":"string","title":"Endpoint"},"authentication":{"type":"string","title":"Authentication","description":"This endpoint is public and unauthenticated.","default":"none"},"consent_boundary":{"type":"string","title":"Consent Boundary"},"caching":{"type":"string","title":"Caching"},"namespaces":{"additionalProperties":{"type":"string"},"type":"object","title":"Namespaces"},"predicates":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Predicates"},"example_queries":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Example Queries"},"rate_limit":{"additionalProperties":{"type":"integer"},"type":"object","title":"Rate Limit"}},"type":"object","required":["endpoint","consent_boundary","caching","namespaces","predicates","example_queries","rate_limit"],"title":"AXSparqlVocabularyResponse","description":"Machine-readable description of what the public corpus holds.\n\nA SPARQL endpoint is unusable without knowing its vocabulary, and the\nalternative -- making callers probe the graph to discover it -- is both\nworse UX and more load on an endpoint that rebuilds per request."},"AXWebMcpDirectoryCounts":{"properties":{"self_reported":{"type":"integer","minimum":0,"title":"Self Reported","default":0},"observed":{"type":"integer","minimum":0,"title":"Observed","default":0},"scored":{"type":"integer","minimum":0,"title":"Scored","default":0}},"type":"object","title":"AXWebMcpDirectoryCounts","description":"Real per-tier row counts on this page. Broken out per tier so a\nconsumer can render three distinct sections rather than one blended\nlist (core#9419)."},"AXWebMcpDirectoryResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/AXWebMcpDirectoryRow"},"type":"array","title":"Rows"},"counts":{"$ref":"#/components/schemas/AXWebMcpDirectoryCounts"},"total_crawled_sites":{"type":"integer","minimum":0,"title":"Total Crawled Sites","description":"Real COUNT(DISTINCT domain) of consented scans across the whole table, independent of limit/offset -- never len(rows)."},"self_reported_submissions_enabled":{"type":"boolean","title":"Self Reported Submissions Enabled","description":"True now that the owner-submission mechanism (POST .../webmcp-directory/self-report, core#9424) exists. self_reported rows are real submissions, never fabricated or inferred (AC-3).","default":true},"offset":{"type":"integer","title":"Offset","default":0},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["rows","counts","total_crawled_sites"],"title":"AXWebMcpDirectoryResponse","description":"Public WebMCP directory.\n\nEvery row carries an explicit ``trust_level``. Only consented\n(``include_in_leaderboard = TRUE``) scans appear at all -- the same\nboundary the leaderboard enforces, never looser (AC-2). A scored site\nthat did NOT consent is absent entirely, not demoted to ``observed``."},"AXWebMcpDirectoryRow":{"properties":{"domain":{"type":"string","title":"Domain"},"trust_level":{"$ref":"#/components/schemas/AXWebMcpTrustLevel","description":"Which real data source this row came from. Required -- never omitted, never inferred client-side (core#9419 AC-1)."},"report_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Id","description":"The stored report's real UUID (ax_audit_reports.id) so a client can route to the existing report instead of re-scanning. Always None for a self_reported row (there is no report)."},"webmcp_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Webmcp Score","description":"The site's REAL WebMCP Tool Quality sub-score. None for an `observed` row -- a 0 there would misrepresent 'we could not measure this' as 'the site has nothing', which is the exact conflation this directory exists to prevent."},"webmcp_max_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Webmcp Max Score","description":"The WebMCP check's weight for this scan, so a score is interpretable without hardcoding CHECK_WEIGHTS client-side. None whenever webmcp_score is None."},"webmcp_details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webmcp Details","description":"The check's real, unedited `details` string -- including the honest failure reason for an `observed` row (e.g. 'WebMCP check timed out'). Never rewritten to look conclusive."},"ax_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ax Score","description":"The site's real overall AX score from the same scan. Present even for an `observed` row -- the wider scan did succeed. None for a self_reported row."},"grade":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade","description":"Real overall AX grade from the same scan."},"scanned_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scanned At","description":"When the scan behind this row ran. None for a self_reported row, which was never scanned."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"'seed' (proactively scanned, Refs #9140) or 'community' (user-submitted opt-in). None for a self_reported row."}},"type":"object","required":["domain","trust_level"],"title":"AXWebMcpDirectoryRow","description":"One site in the public WebMCP directory.\n\n``trust_level`` is REQUIRED and has no default (AC-1): a caller must\nnever have to infer a row's trust tier client-side, and a row the server\ncannot classify is a server-side bug, not a silently-defaulted row."},"AXWebMcpSelfReportRequest":{"properties":{"domain":{"type":"string","maxLength":255,"minLength":1,"title":"Domain","description":"The domain being claimed, in any common form (https://example.com, www.example.com, example.com) -- normalized server-side for the dedupe check."},"claimed_tools":{"type":"string","maxLength":2000,"minLength":1,"title":"Claimed Tools","description":"The owner's own free-text description of the WebMCP tools their site exposes. Stored verbatim, never parsed or validated against an actual scan."},"contact_email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Contact Email","description":"Optional contact email for follow-up."}},"type":"object","required":["domain","claimed_tools"],"title":"AXWebMcpSelfReportRequest","description":"POST body for a self-reported WebMCP claim. Every field here is\nstored exactly as submitted (core#9424 AC-2) -- nothing enriched,\ninferred, or validated beyond basic shape."},"AXWebMcpSelfReportResponse":{"properties":{"report_id":{"type":"string","title":"Report Id"},"domain":{"type":"string","title":"Domain","description":"The normalized domain the report was filed under."},"trust_level":{"type":"string","title":"Trust Level","description":"Always 'self_reported' -- a submission can never produce any other trust level (AC-1).","default":"self_reported"}},"type":"object","required":["report_id","domain"],"title":"AXWebMcpSelfReportResponse"},"AXWebMcpTrustLevel":{"type":"string","enum":["self_reported","observed","scored"],"title":"AXWebMcpTrustLevel","description":"How much we actually know about a site's WebMCP support.\n\nThese are genuinely different data sources with genuinely different\nconfidence, and the directory never blends them into one\nundifferentiated list (core#9419, AC-1)."},"AccessControlsEvidence":{"properties":{"active_agent_keys":{"type":"integer","title":"Active Agent Keys"},"keys_rotated_in_period":{"type":"integer","title":"Keys Rotated In Period"},"keys_revoked_in_period":{"type":"integer","title":"Keys Revoked In Period"}},"type":"object","required":["active_agent_keys","keys_rotated_in_period","keys_revoked_in_period"],"title":"AccessControlsEvidence"},"AccountDeletionRequest":{"properties":{"password":{"type":"string","minLength":1,"title":"Password","description":"Current password for confirmation"},"reason":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Reason","description":"Optional reason for account deletion"}},"type":"object","required":["password"],"title":"AccountDeletionRequest","description":"Request body for account deletion. Requires password confirmation."},"AccountDeletionResponse":{"properties":{"message":{"type":"string","title":"Message"},"grace_period_days":{"type":"integer","title":"Grace Period Days","default":30},"deleted_at":{"type":"string","title":"Deleted At"}},"type":"object","required":["message","deleted_at"],"title":"AccountDeletionResponse","description":"Response after successful account deletion request."},"AccountLogoResponse":{"properties":{"logo_url":{"type":"string","title":"Logo Url"},"file_name":{"type":"string","title":"File Name"},"size_bytes":{"type":"integer","title":"Size Bytes"},"content_type":{"type":"string","title":"Content Type"}},"type":"object","required":["logo_url","file_name","size_bytes","content_type"],"title":"AccountLogoResponse"},"AccountSettingsResponse":{"properties":{"settings":{"additionalProperties":true,"type":"object","title":"Settings","default":{}},"grove_notice_viewed":{"type":"boolean","title":"Grove Notice Viewed","default":false}},"type":"object","title":"AccountSettingsResponse","description":"Response for GET /api/oauth/account/settings."},"AchDetailsResponse":{"properties":{"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"account_holder_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Holder Name"},"account_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"},"account_number_last4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Number Last4"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","title":"AchDetailsResponse","description":"Masked ACH details as returned by ach_service._serialize()."},"AcknowledgeAlert":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Note","description":"Acknowledgment note"}},"type":"object","title":"AcknowledgeAlert","description":"Schema for acknowledging an alert","example":{"note":"Investigating email service issues. SMTP server appears to be slow."}},"AcquisitionResult":{"properties":{"targets":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Targets"},"signals":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Signals"},"grants":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Grants"},"sbir_awards":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sbir Awards"},"total_targets":{"type":"integer","title":"Total Targets","default":0},"total_sbir":{"type":"integer","title":"Total Sbir","default":0},"source":{"type":"string","title":"Source","default":"lakehouse"},"historical_data":{"items":{},"type":"array","title":"Historical Data"}},"type":"object","title":"AcquisitionResult"},"ActionExecutionResult":{"properties":{"execution_time_ms":{"type":"integer","title":"Execution Time Ms"},"output":{"type":"string","title":"Output"}},"type":"object","required":["execution_time_ms","output"],"title":"ActionExecutionResult"},"ActionItem":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"cta_label":{"type":"string","title":"Cta Label"},"cta_route":{"type":"string","title":"Cta Route"},"is_complete":{"type":"boolean","title":"Is Complete"},"progress_percent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Progress Percent"}},"type":"object","required":["type","title","description","cta_label","cta_route","is_complete"],"title":"ActionItem"},"ActionItemsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ActionItem"},"type":"array","title":"Data"},"badge_count":{"type":"integer","title":"Badge Count"},"onboarding_percent_complete":{"type":"integer","title":"Onboarding Percent Complete"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["data","badge_count","onboarding_percent_complete","organization_id"],"title":"ActionItemsResponse"},"ActionParameters":{"properties":{"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters","default":{}}},"type":"object","title":"ActionParameters","description":"Parameters for action execution"},"ActivateAccountRequest":{"properties":{"token":{"type":"string","title":"Token","description":"Activation token from email"},"password":{"type":"string","minLength":8,"title":"Password","description":"New password (minimum 8 characters)"}},"type":"object","required":["token","password"],"title":"ActivateAccountRequest","description":"Request to activate account and set password","example":{"password":"SecurePassword123","token":"abc123..."}},"ActivateAccountResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"trial_days_remaining":{"type":"integer","title":"Trial Days Remaining"}},"type":"object","required":["success","message","user_id","email","trial_days_remaining"],"title":"ActivateAccountResponse","description":"Response after successful activation","example":{"email":"user@example.com","message":"Account activated successfully! Welcome to AI Native Studio.","success":true,"trial_days_remaining":30,"user_id":"abc-123-def"}},"ActivateGiftResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"message":{"type":"string","title":"Message"},"subscription_id":{"type":"string","title":"Subscription Id"},"already_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Already Active"},"trial_ends_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trial Ends At"},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"},"campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"}},"type":"object","required":["message","subscription_id"],"title":"ActivateGiftResponse","description":"Response for POST /campaign/activate-gift"},"ActiveAgentItem":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_type":{"type":"string","title":"Agent Type"},"last_active":{"type":"string","title":"Last Active"}},"type":"object","required":["agent_id","agent_type","last_active"],"title":"ActiveAgentItem"},"ActiveAlert":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"severity":{"type":"string","title":"Severity"},"status":{"type":"string","title":"Status"},"metric":{"type":"string","title":"Metric"},"current_value":{"type":"number","title":"Current Value"},"threshold":{"type":"number","title":"Threshold"},"created_at":{"type":"string","title":"Created At"},"last_triggered":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Triggered"},"acknowledged_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Acknowledged At"},"acknowledged_by":{"anyOf":[{},{"type":"null"}],"title":"Acknowledged By"},"affected_services":{"items":{"type":"string"},"type":"array","title":"Affected Services"}},"type":"object","required":["id","title","description","severity","status","metric","current_value","threshold","created_at","affected_services"],"title":"ActiveAlert"},"ActiveDeploymentSummary":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"agent_type":{"type":"string","title":"Agent Type"},"version":{"type":"string","title":"Version"},"status":{"type":"string","title":"Status"},"progress":{"type":"number","title":"Progress"},"started_at":{"type":"string","title":"Started At"}},"type":"object","required":["deployment_id","agent_type","version","status","progress","started_at"],"title":"ActiveDeploymentSummary"},"ActiveExperimentSummary":{"properties":{"experiment_id":{"type":"string","title":"Experiment Id"},"name":{"type":"string","title":"Name"},"target_agents":{"items":{"type":"string"},"type":"array","title":"Target Agents"},"strategy":{"type":"string","title":"Strategy"},"progress":{"type":"number","title":"Progress"},"status":{"type":"string","title":"Status"},"started_at":{"type":"string","title":"Started At"},"estimated_completion":{"type":"string","title":"Estimated Completion"}},"type":"object","required":["experiment_id","name","target_agents","strategy","progress","status","started_at","estimated_completion"],"title":"ActiveExperimentSummary"},"ActiveProjectSummary":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"repo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repo Url"},"status":{"$ref":"#/components/schemas/ProjectStatus","default":"pending"},"progress":{"type":"integer","maximum":100,"minimum":0,"title":"Progress","default":0},"current_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Stage"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"last_activity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Activity"},"total_agents":{"type":"integer","title":"Total Agents","default":0},"active_agents":{"type":"integer","title":"Active Agents","default":0},"agents":{"items":{"$ref":"#/components/schemas/AgentInfo"},"type":"array","title":"Agents"},"current_sprint":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Sprint"},"sprint_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sprint Name"},"stats":{"$ref":"#/components/schemas/app__schemas__active_projects__QuickStats"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"error_count":{"type":"integer","title":"Error Count","default":0}},"type":"object","required":["project_id","project_name"],"title":"ActiveProjectSummary","description":"Summary of an active project with Agent Swarm running"},"ActiveProjectsListResponse":{"properties":{"projects":{"items":{"$ref":"#/components/schemas/ActiveProjectSummary"},"type":"array","title":"Projects"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page","default":1},"page_size":{"type":"integer","title":"Page Size","default":20},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["projects","total"],"title":"ActiveProjectsListResponse","description":"Response for listing all active projects"},"AdCreditsPurchaseRequest":{"properties":{"sponsor_id":{"type":"string","title":"Sponsor Id","description":"Sponsor ID"},"amount":{"type":"integer","maximum":100000,"minimum":10,"title":"Amount","description":"Amount in USD (1 credit = $1)"},"payment_method_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method Id","description":"Stripe payment method ID"},"auto_confirm":{"type":"boolean","title":"Auto Confirm","description":"Auto-confirm payment intent","default":true}},"type":"object","required":["sponsor_id","amount"],"title":"AdCreditsPurchaseRequest","description":"Schema for purchasing ad credits","example":{"amount":1000,"auto_confirm":true,"payment_method_id":"pm_card_visa","sponsor_id":"sponsor_abc123"}},"AdCreditsPurchaseResponse":{"properties":{"payment_intent_id":{"type":"string","title":"Payment Intent Id","description":"Stripe payment intent ID"},"sponsor_id":{"type":"string","title":"Sponsor Id"},"amount":{"type":"integer","title":"Amount","description":"Credits purchased (equals USD amount)"},"status":{"type":"string","title":"Status","description":"Payment status"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Secret","description":"Client secret for frontend confirmation"},"requires_action":{"type":"boolean","title":"Requires Action","description":"Whether additional auth is required","default":false}},"type":"object","required":["payment_intent_id","sponsor_id","amount","status"],"title":"AdCreditsPurchaseResponse","description":"Schema for credit purchase response","example":{"amount":1000,"client_secret":"pi_abc123_secret_xyz","payment_intent_id":"pi_abc123","requires_action":false,"sponsor_id":"sponsor_abc123","status":"requires_confirmation"}},"AdCreditsResponse":{"properties":{"sponsor_id":{"type":"string","title":"Sponsor Id"},"total_credits":{"type":"integer","title":"Total Credits","description":"Total credits purchased"},"used_credits":{"type":"integer","title":"Used Credits","description":"Total credits used"},"remaining_credits":{"type":"integer","title":"Remaining Credits","description":"Available credits"},"total_spend":{"type":"string","title":"Total Spend","description":"Total USD spent"},"auto_reload_enabled":{"type":"boolean","title":"Auto Reload Enabled"},"auto_reload_threshold":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Auto Reload Threshold"},"auto_reload_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Auto Reload Amount"},"low_balance_alert":{"type":"boolean","title":"Low Balance Alert","description":"Whether balance is below threshold"}},"type":"object","required":["sponsor_id","total_credits","used_credits","remaining_credits","total_spend","auto_reload_enabled","low_balance_alert"],"title":"AdCreditsResponse","description":"Schema for ad credits balance response","example":{"auto_reload_amount":500,"auto_reload_enabled":true,"auto_reload_threshold":100,"low_balance_alert":false,"remaining_credits":650,"sponsor_id":"sponsor_abc123","total_credits":1000,"total_spend":"350.00","used_credits":350}},"AdFormat":{"type":"string","enum":["video","banner","native","audio"],"title":"AdFormat","description":"Supported ad formats with different base pricing."},"AdRequest":{"properties":{"event_id":{"type":"string","title":"Event Id","description":"Event ID requesting the ad"},"placement":{"$ref":"#/components/schemas/PlacementType","description":"Ad placement location (header, sidebar, content, video)"},"device_type":{"$ref":"#/components/schemas/DeviceType","description":"Device type (desktop, mobile, tablet)"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User ID if authenticated (for frequency capping)"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context","description":"Additional context (page_url, referrer, etc.)"},"user_interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"User Interests","description":"User's interests for contextual targeting"},"page_context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Page Context","description":"Page metadata (URL, referrer, user agent, etc.)"}},"type":"object","required":["event_id","placement","device_type"],"title":"AdRequest","description":"Schema for ad serving request\n\nSent by frontend when event page needs to display an ad.\nIncludes context about placement, device, and user for targeting.","example":{"context":{"page_url":"https://paipalooza.com/events/pai2026","referrer":"https://google.com"},"device_type":"desktop","event_id":"event_pai2026","placement":"header","user_id":"user_abc123"}},"AdResponse":{"properties":{"ad_id":{"type":"string","title":"Ad Id","description":"Unique identifier for this ad serve (for tracking correlation)"},"creative_id":{"type":"string","title":"Creative Id","description":"Creative ID being served"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID"},"creative_type":{"$ref":"#/components/schemas/CreativeType","description":"Creative type (video, banner, native)"},"creative_data":{"additionalProperties":true,"type":"object","title":"Creative Data","description":"Creative data (URLs, dimensions, title, description, CTA, etc.)"},"tracking_urls":{"$ref":"#/components/schemas/TrackingURLs","description":"Tracking URLs for impression, click, completion"},"ab_test_metadata":{"anyOf":[{"$ref":"#/components/schemas/ABTestMetadata"},{"type":"null"}],"description":"A/B test metadata (present when campaign uses A_B_TEST strategy)"},"personalized":{"type":"boolean","title":"Personalized","description":"Whether response includes personalization (true if user_id provided)","default":false}},"type":"object","required":["ad_id","creative_id","campaign_id","creative_type","creative_data","tracking_urls"],"title":"AdResponse","description":"Schema for ad serving response\nIssue #563: Enhanced with A/B test metadata and personalization flag\n\nContains all data needed to display the ad:\n- Unique ad_id for tracking correlation\n- Campaign and creative identifiers\n- Creative type and data (URLs, dimensions, etc.)\n- Tracking URLs for impression/click/completion\n- A/B test metadata (if A_B_TEST strategy)\n- Personalization flag (if user_id provided)","example":{"ab_test_metadata":{"test_id":"test_abc123xyz789","variant":"A"},"ad_id":"ad_xyz789abc123","campaign_id":"camp_abc123","creative_data":{"call_to_action":"Register Now","description":"Join us for the best AI event","destination_url":"https://example.com/register","duration_seconds":30,"thumbnail_url":"https://r2.example.com/thumb.jpg","title":"AI Conference 2026","video_url":"https://r2.example.com/video.mp4"},"creative_id":"creative_def456","creative_type":"video","personalized":true,"tracking_urls":{"click_url":"https://api.ainative.studio/v1/paipalooza/ads/ad_xyz789/click","completion_url":"https://api.ainative.studio/v1/paipalooza/ads/ad_xyz789/complete","impression_url":"https://api.ainative.studio/v1/paipalooza/ads/ad_xyz789/impression"}}},"AddAlertRuleResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","timestamp"],"title":"AddAlertRuleResponse","description":"POST /deployment/alert-rules — new alert rule registered."},"AddHealthCheckResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","timestamp"],"title":"AddHealthCheckResponse","description":"POST /deployment/health-checks — new health check registered."},"AddIPWhitelistResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"entry":{"$ref":"#/components/schemas/IPWhitelistResponse"}},"type":"object","required":["success","message","entry"],"title":"AddIPWhitelistResponse","description":"Response for adding an IP to the whitelist"},"AddMemoryRequest":{"properties":{"content":{"type":"string","maxLength":10000,"minLength":1,"title":"Content","description":"The fact or memory to store"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Optional tags for categorization"}},"type":"object","required":["content"],"title":"AddMemoryRequest"},"AddMemoryResponse":{"properties":{"memory_id":{"type":"string","title":"Memory Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["memory_id","status"],"title":"AddMemoryResponse"},"AddPaymentMethodRequest":{"properties":{"payment_method_token":{"type":"string","title":"Payment Method Token"}},"type":"object","required":["payment_method_token"],"title":"AddPaymentMethodRequest","description":"Body for attaching a Stripe-tokenized card.\n\n``payment_method_token`` is a Stripe payment_method id produced\nclient-side by Stripe.js/Elements — never a raw card number/CVC.\n\nThere is deliberately no ``stripe_customer_id`` field: the Stripe customer\nis resolved from the authenticated tenant, never named by the caller\n(#7637)."},"AddTrackRequest":{"properties":{"sdp":{"type":"string","minLength":10,"title":"Sdp","description":"SDP offer from client"},"type":{"$ref":"#/components/schemas/TrackTypeEnum","description":"Track type (video, audio, screen)"}},"type":"object","required":["sdp","type"],"title":"AddTrackRequest","description":"Request model for adding a media track"},"AddTrackResponse":{"properties":{"track_id":{"type":"string","format":"uuid","title":"Track Id","description":"Track identifier"},"type":{"$ref":"#/components/schemas/TrackTypeEnum","description":"Track type"},"sdp_answer":{"type":"string","title":"Sdp Answer","description":"SDP answer from server"}},"type":"object","required":["track_id","type","sdp_answer"],"title":"AddTrackResponse","description":"Response model for adding a track"},"AddTutorialStepResponse":{"properties":{"step_id":{"type":"string","title":"Step Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"step":{"additionalProperties":true,"type":"object","title":"Step"}},"type":"object","required":["step_id","status","message","step"],"title":"AddTutorialStepResponse","description":"Response for POST /onboarding-tutorials/tutorials/{tutorial_id}/steps."},"AdminAPIInfoResponse":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"version":{"type":"string","title":"Version"},"access_level":{"type":"string","title":"Access Level"},"user_email":{"type":"string","title":"User Email"},"user_role":{"type":"string","title":"User Role"},"endpoints_count":{"type":"integer","title":"Endpoints Count"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"security_note":{"type":"string","title":"Security Note"}},"type":"object","required":["name","description","version","access_level","user_email","user_role","endpoints_count","categories","security_note"],"title":"AdminAPIInfoResponse","description":"Real shape of GET /admin/ -- matches get_admin_api_info()'s\nliteral return dict exactly."},"AdminAPIKeyCreate":{"properties":{"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["name"],"title":"AdminAPIKeyCreate","description":"Schema for creating API key for a user"},"AdminAPIKeyCreateResult":{"properties":{"api_key":{"type":"string","title":"Api Key","description":"Plaintext API key -- shown only once"},"key_info":{"$ref":"#/components/schemas/AdminAPIKeyResponse"},"warning":{"type":"string","title":"Warning"}},"type":"object","required":["api_key","key_info","warning"],"title":"AdminAPIKeyCreateResult","description":"Real shape of POST /admin/keys/api-keys and its\n/{key_id}/rotate sibling -- both return the freshly (re)generated\nplaintext key alongside the persisted key record and a one-time\nstorage warning."},"AdminAPIKeyListPaged":{"properties":{"api_keys":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Api Keys"},"total":{"type":"integer","title":"Total","default":0},"active_count":{"type":"integer","title":"Active Count","default":0},"skip":{"type":"integer","title":"Skip","default":0},"limit":{"type":"integer","title":"Limit","default":100}},"type":"object","title":"AdminAPIKeyListPaged","description":"Real shape of GET /admin/keys/api-keys on its normal (DB-backed)\npath -- a paginated envelope, not a bare list. The same handler also\nhas a dev-fallback / \"table missing\" branch that returns a bare\n`List[AdminAPIKeyResponse]` instead (see AdminAPIKeyListResponse\nbelow); response_model=None was previously used here (782639338) to\ndodge the resulting validation conflict."},"AdminAPIKeyMessageResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"AdminAPIKeyMessageResponse","description":"Simple {message} envelope returned by DELETE /api-keys/{key_id}."},"AdminAPIKeyResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"user_email":{"type":"string","format":"email","title":"User Email"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"is_active":{"type":"boolean","title":"Is Active"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"usage_count":{"type":"integer","title":"Usage Count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","user_id","user_email","name","prefix","is_active","created_at"],"title":"AdminAPIKeyResponse","description":"Admin view of API key with user information"},"AdminAPIKeyUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Name"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","title":"AdminAPIKeyUpdate","description":"Schema for updating API key settings"},"AdminAPIKeyUsageStatsResponse":{"properties":{"period_days":{"type":"integer","title":"Period Days"},"total_keys":{"type":"integer","title":"Total Keys"},"active_keys":{"type":"integer","title":"Active Keys"},"used_keys":{"type":"integer","title":"Used Keys"},"recent_usage":{"type":"integer","title":"Recent Usage"},"total_usage":{"type":"integer","title":"Total Usage"},"month_usage":{"type":"integer","title":"Month Usage"},"top_users":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Users"}},"type":"object","required":["period_days","total_keys","active_keys","used_keys","recent_usage","total_usage","month_usage"],"title":"AdminAPIKeyUsageStatsResponse","description":"Real shape of GET /admin/keys/api-keys/usage/stats."},"AdminConfigureWorkspaceRequest":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":3,"title":"Domain"},"admin_subject":{"type":"string","format":"email","title":"Admin Subject","default":"toby@luvmart.co"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"org_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Domain"},"org_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Name"}},"type":"object","required":["domain"],"title":"AdminConfigureWorkspaceRequest","description":"Superadmin: bind a domain to ANOTHER org (provision on behalf). Refs #5750.\n\nTarget the org by exactly one of org_id / org_domain / org_name. Since every\ndomain AINative hosts is a secondary domain under the ONE luvmart.co\nWorkspace, admin_subject defaults to that super-admin."},"AdminConfigureWorkspaceResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Always true on the 202 path"},"org_id":{"type":"string","title":"Org Id","description":"Target organization id, pre-serialized"},"org_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Name","description":"Target organization name"},"domain":{"type":"string","title":"Domain","description":"Normalized (lowercased, @-stripped) domain"},"admin_subject":{"type":"string","title":"Admin Subject","description":"Workspace super-admin subject"},"verify_status":{"type":"string","title":"Verify Status","description":"Always 'pending' — verification runs in the background"},"detail":{"type":"string","title":"Detail","description":"Human-readable next step for the caller"}},"type":"object","required":["ok","org_id","domain","admin_subject","verify_status","detail"],"title":"AdminConfigureWorkspaceResponse","description":"202 body for POST /workspace/admin/configure (Refs #8449).\n\nAll seven keys are unconditional on the 202 path — the handler returns one\nflat dict literal with no branch-dependent fields — so no\n`response_model_exclude_unset` is needed.\n\n`verify_status` is a plain `str` here (\"pending\"), NOT the dict shape the\nSAME concept takes when persisted by `set_workspace_config` above\n(`{\"ok\": None, \"state\": \"pending\"}`). Typing this field as that dict (or a\nmodel of it) would reject every real response from this route. The two\nrepresentations are genuinely different and must stay that way."},"AdminCreditsBalanceData":{"properties":{"admin_balance":{"$ref":"#/components/schemas/AdminCreditsBalanceSummary"},"system_overview":{"$ref":"#/components/schemas/SystemCreditsOverview"}},"type":"object","required":["admin_balance","system_overview"],"title":"AdminCreditsBalanceData"},"AdminCreditsBalanceResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/AdminCreditsBalanceData"}},"type":"object","required":["success","data"],"title":"AdminCreditsBalanceResponse","description":"Response for GET /admin/credits/balance."},"AdminCreditsBalanceSummary":{"properties":{"total_credits":{"type":"number","title":"Total Credits"},"used_credits":{"type":"number","title":"Used Credits"},"remaining_credits":{"type":"number","title":"Remaining Credits"}},"type":"object","required":["total_credits","used_credits","remaining_credits"],"title":"AdminCreditsBalanceSummary"},"AdminDashboardResponse":{"properties":{"active_campaigns":{"type":"integer","title":"Active Campaigns","description":"Total active campaigns","default":0},"pending_campaigns":{"type":"integer","title":"Pending Campaigns","description":"Campaigns pending approval","default":0},"impressions":{"$ref":"#/components/schemas/TimeRangeMetrics","description":"Impressions by time range"},"revenue":{"$ref":"#/components/schemas/app__schemas__paipalooza__admin__RevenueBreakdown","description":"Revenue breakdown"},"pending_creative_approvals":{"type":"integer","title":"Pending Creative Approvals","description":"Creatives awaiting review","default":0},"total_creatives":{"type":"integer","title":"Total Creatives","description":"Total active creatives","default":0},"top_sponsors":{"anyOf":[{"items":{"$ref":"#/components/schemas/TopSponsor"},"type":"array"},{"type":"null"}],"title":"Top Sponsors","description":"Top sponsors by spend"},"top_events":{"anyOf":[{"items":{"$ref":"#/components/schemas/TopEvent"},"type":"array"},{"type":"null"}],"title":"Top Events","description":"Top events by revenue"},"growth_metrics":{"anyOf":[{"items":{"$ref":"#/components/schemas/GrowthMetric"},"type":"array"},{"type":"null"}],"title":"Growth Metrics","description":"Growth comparison"},"generated_at":{"type":"string","format":"date-time","title":"Generated At","description":"Response generation timestamp"}},"type":"object","required":["impressions","revenue","generated_at"],"title":"AdminDashboardResponse","description":"Admin dashboard overview response"},"AdminDashboardStatsResponse":{"properties":{"users":{"$ref":"#/components/schemas/DashboardUserMetrics"},"api_usage":{"$ref":"#/components/schemas/DashboardApiUsageMetrics"},"revenue":{"$ref":"#/components/schemas/DashboardRevenueMetrics"},"projects":{"$ref":"#/components/schemas/DashboardProjectMetrics"},"cache_hit":{"type":"boolean","title":"Cache Hit"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"},"cache_ttl_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cache Ttl Seconds"},"response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time Ms"}},"type":"object","required":["users","api_usage","revenue","projects","cache_hit"],"title":"AdminDashboardStatsResponse","description":"Response for GET /dashboard/stats.\n\n`timestamp` and `cache_ttl_seconds` are only present on a freshly\ncomputed (non-cached) response; `response_time_ms` is added on both\nthe cached and fresh paths. Modeled as Optional + exclude_none so a\ncache-hit response never gains new explicit-null keys."},"AdminEvaluationAnalyticsResponse":{"properties":{"evaluations_today":{"type":"integer","title":"Evaluations Today"},"avg_quality_score":{"type":"number","title":"Avg Quality Score"},"evaluations_week":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Evaluations Week"},"avg_evaluation_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Evaluation Time"},"quality_distribution":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Quality Distribution"},"evaluation_types":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Evaluation Types"},"top_issues_found":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Top Issues Found"},"improvement_trends":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Improvement Trends"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["evaluations_today","avg_quality_score"],"title":"AdminEvaluationAnalyticsResponse","description":"Real shape of get_evaluation_analytics(). Same union-of-branches\nreasoning as AdminMemoryAnalyticsResponse -- the `except Exception`\nbranch returns only {error, evaluations_today, avg_quality_score}."},"AdminLoginResponse":{"properties":{"access_token":{"type":"string","title":"Access Token","description":"JWT access token"},"token_type":{"type":"string","title":"Token Type","description":"Token type","default":"bearer"},"expires_in":{"type":"integer","title":"Expires In","description":"Token expiration in seconds"},"user_info":{"additionalProperties":true,"type":"object","title":"User Info","description":"Admin user information"}},"type":"object","required":["access_token","expires_in","user_info"],"title":"AdminLoginResponse","description":"Admin login response schema","example":{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","expires_in":3600,"token_type":"bearer","user_info":{"email":"admin@example.com","full_name":"Admin User","id":"admin-user-123","is_superuser":true,"role":"ADMIN"}}},"AdminLogoutResponse":{"properties":{"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["message","timestamp"],"title":"AdminLogoutResponse","description":"Response for POST /admin/auth/logout."},"AdminMeResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"username":{"type":"string","title":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"status":{"type":"string","title":"Status"},"is_active":{"type":"boolean","title":"Is Active"},"is_superuser":{"type":"boolean","title":"Is Superuser"},"email_verified":{"type":"boolean","title":"Email Verified"},"permissions":{"$ref":"#/components/schemas/AdminUserPermissions"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"last_login_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Login At"},"organizations_count":{"type":"integer","title":"Organizations Count"},"projects_count":{"type":"integer","title":"Projects Count"},"api_keys_count":{"type":"integer","title":"Api Keys Count"}},"type":"object","required":["id","email","username","status","is_active","is_superuser","email_verified","permissions","organizations_count","projects_count","api_keys_count"],"title":"AdminMeResponse","description":"Response for GET /admin/auth/me."},"AdminMemoryAnalyticsResponse":{"properties":{"active_sessions":{"type":"integer","title":"Active Sessions"},"completed_sessions":{"type":"integer","title":"Completed Sessions"},"total_memories":{"type":"integer","title":"Total Memories"},"memories_today":{"type":"integer","title":"Memories Today"},"avg_session_duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Session Duration"},"learning_progress_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Learning Progress Score"},"top_interaction_types":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Top Interaction Types"},"user_feedback_distribution":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"User Feedback Distribution"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["active_sessions","completed_sessions","total_memories","memories_today"],"title":"AdminMemoryAnalyticsResponse","description":"Real shape of get_memory_analytics(). All fields are optional\nbecause the handler's `except Exception` branch returns only a\nsubset (error, active_sessions, completed_sessions, total_memories,\nmemories_today) -- this schema is the union of both real branches,\nnot a narrowing to either one."},"AdminOrganizationListItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"user_count":{"type":"integer","title":"User Count"},"project_count":{"type":"integer","title":"Project Count"}},"type":"object","required":["id","name","is_active","user_count","project_count"],"title":"AdminOrganizationListItem"},"AdminProfileData":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"created_at":{"anyOf":[{},{"type":"null"}],"title":"Created At"},"last_login":{"anyOf":[{},{"type":"null"}],"title":"Last Login"},"is_active":{"type":"boolean","title":"Is Active","default":true},"email_verified":{"type":"boolean","title":"Email Verified","default":true},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"preferences":{"additionalProperties":true,"type":"object","title":"Preferences"}},"type":"object","title":"AdminProfileData"},"AdminProfileResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/AdminProfileData"}},"type":"object","required":["success","data"],"title":"AdminProfileResponse"},"AdminProfileStatsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["success","data"],"title":"AdminProfileStatsResponse","description":"Response for GET /profile/stats.\n\n`data` can be either the real GitHubAnalyticsService result (dynamic\nshape, service-defined) or the fixed mock-data fallback shown when that\nservice raises. Modeled as Dict[str, Any] to accommodate both without\nover-constraining the real-service shape."},"AdminRequestCreate":{"properties":{"request_type":{"type":"string","minLength":1,"title":"Request Type","description":"Type of admin request"},"reason":{"type":"string","minLength":1,"title":"Reason","description":"Reason for the request"}},"type":"object","required":["request_type","reason"],"title":"AdminRequestCreate","description":"Schema for creating an admin request."},"AdminRequestListResponse":{"properties":{"requests":{"items":{"$ref":"#/components/schemas/AdminRequestResponse"},"type":"array","title":"Requests","default":[]}},"type":"object","title":"AdminRequestListResponse","description":"Schema for listing admin requests."},"AdminRequestResponse":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"request_type":{"type":"string","title":"Request Type"},"reason":{"type":"string","title":"Reason"},"org_id":{"type":"string","title":"Org Id"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["id","status","request_type","reason","org_id","user_id"],"title":"AdminRequestResponse","description":"Schema for an admin request response."},"AdminSystemLogsResponse":{"properties":{"logs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Logs"},"total":{"type":"integer","title":"Total"},"level_filter":{"type":"string","title":"Level Filter"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["total","level_filter"],"title":"AdminSystemLogsResponse","description":"Real shape of get_recent_system_logs() -- currently always mock\ndata (module docstring: \"would integrate with actual logging\nsystem\"). Log entries themselves are kept as free-form dicts since\nreal fields vary per log type (user_id, query, ip, ...)."},"AdminSystemMetricsResponse":{"properties":{"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"database":{"additionalProperties":true,"type":"object","title":"Database"},"users":{"additionalProperties":true,"type":"object","title":"Users"},"organizations":{"additionalProperties":true,"type":"object","title":"Organizations"},"api_keys":{"additionalProperties":true,"type":"object","title":"Api Keys"}},"type":"object","required":["timestamp","database","users","organizations","api_keys"],"title":"AdminSystemMetricsResponse","description":"Real shape of get_system_metrics(). `database` is either the real\ntable-size breakdown or {\"error\": str} if the pg_tables query fails —\nkept as Dict[str, Any] since both are legitimate, differently-shaped\nbranches of the same handler."},"AdminUserListItem":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"username":{"type":"string","title":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"role":{"type":"string","title":"Role"},"is_active":{"type":"boolean","title":"Is Active"},"email_verified":{"type":"boolean","title":"Email Verified"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"last_login_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Login At"},"plan":{"type":"string","title":"Plan"},"organizations_count":{"type":"integer","title":"Organizations Count"},"projects_count":{"type":"integer","title":"Projects Count"},"api_keys_count":{"type":"integer","title":"Api Keys Count"},"signup_client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signup Client Id"}},"type":"object","required":["id","email","username","role","is_active","email_verified","plan","organizations_count","projects_count","api_keys_count"],"title":"AdminUserListItem"},"AdminUserPermissions":{"properties":{"can_manage_users":{"type":"boolean","title":"Can Manage Users"},"can_manage_api_keys":{"type":"boolean","title":"Can Manage Api Keys"},"can_view_analytics":{"type":"boolean","title":"Can View Analytics"},"can_manage_system":{"type":"boolean","title":"Can Manage System"}},"type":"object","required":["can_manage_users","can_manage_api_keys","can_view_analytics","can_manage_system"],"title":"AdminUserPermissions","description":"Static permission flags returned for every authenticated admin user."},"AdminUserSubscriptionRecord":{"properties":{"id":{"anyOf":[{},{"type":"null"}],"title":"Id"},"tier":{"anyOf":[{},{"type":"null"}],"title":"Tier"},"status":{"anyOf":[{},{"type":"null"}],"title":"Status"},"plan_name":{"anyOf":[{},{"type":"null"}],"title":"Plan Name"},"plan_price":{"anyOf":[{},{"type":"null"}],"title":"Plan Price"},"billing_email":{"anyOf":[{},{"type":"null"}],"title":"Billing Email"},"current_period_start":{"anyOf":[{},{"type":"null"}],"title":"Current Period Start"},"current_period_end":{"anyOf":[{},{"type":"null"}],"title":"Current Period End"},"max_ai_requests_per_day":{"anyOf":[{},{"type":"null"}],"title":"Max Ai Requests Per Day"},"max_tokens_per_month":{"anyOf":[{},{"type":"null"}],"title":"Max Tokens Per Month"},"chat_completion_credits":{"anyOf":[{},{"type":"null"}],"title":"Chat Completion Credits"},"chat_completion_credits_used":{"anyOf":[{},{"type":"null"}],"title":"Chat Completion Credits Used"},"stripe_subscription_id":{"anyOf":[{},{"type":"null"}],"title":"Stripe Subscription Id"},"stripe_managed":{"anyOf":[{},{"type":"null"}],"title":"Stripe Managed"}},"type":"object","title":"AdminUserSubscriptionRecord","description":"The active `subscriptions` row as `_read_user_subscription` shapes it.\n\nEvery field is Optional and the numeric/text ones are `Any`. That is not\nlaziness -- the values come straight out of a raw `db.execute(text(...))`\nSELECT, so their Python types are whatever the driver yields for that\ncolumn in THAT database, and the local test schema is already known to\ndrift from production here (`stripe_subscription_id` is selected as\n`NULL::text` when the column is absent). Pinning e.g. `plan_price: int`\nwould turn any such drift -- a numeric column read back as Decimal, a\nlegacy NULL in a column that is NOT NULL today -- into a\nResponseValidationError 500 on an admin billing route that currently\nworks. The field NAMES are what #8449 needs documented; constraining\ntheir types buys nothing here and can only break a live route."},"AdminUserWorkspacesResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"workspaces":{"items":{"$ref":"#/components/schemas/AdminWorkspaceItem"},"type":"array","title":"Workspaces"}},"type":"object","required":["user_id","email","workspaces"],"title":"AdminUserWorkspacesResponse"},"AdminWorkspaceItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"is_default":{"type":"boolean","title":"Is Default"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","name","is_default","created_at"],"title":"AdminWorkspaceItem"},"AdsStats":{"properties":{"total_spend":{"type":"number","title":"Total Spend","default":0},"total_clicks":{"type":"integer","title":"Total Clicks","default":0},"total_impressions":{"type":"integer","title":"Total Impressions","default":0},"total_conversions":{"type":"integer","title":"Total Conversions","default":0},"avg_cpc":{"type":"number","title":"Avg Cpc","default":0},"ctr":{"type":"number","title":"Ctr","default":0},"campaigns_active":{"type":"integer","title":"Campaigns Active","default":0},"top_keyword":{"type":"string","title":"Top Keyword","default":""},"top_keyword_conversions":{"type":"integer","title":"Top Keyword Conversions","default":0},"source":{"type":"string","title":"Source","default":"ads_report"}},"type":"object","title":"AdsStats","description":"Google Ads campaign performance — pulled from daily optimizer reports."},"AgentABTestResult":{"properties":{"test_id":{"type":"string","title":"Test Id"},"test_name":{"type":"string","title":"Test Name"},"winner":{"type":"string","title":"Winner"},"improvement":{"type":"number","title":"Improvement"},"confidence":{"type":"number","title":"Confidence"}},"type":"object","required":["test_id","test_name","winner","improvement","confidence"],"title":"AgentABTestResult"},"AgentAnomaliesResponse":{"properties":{"status":{"type":"string","title":"Status"},"anomalies":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Anomalies"},"all_agents":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"All Agents"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["status","anomalies","all_agents"],"title":"AgentAnomaliesResponse","description":"Agent anomaly flags from the lake. Refs #3410"},"AgentAuditEntry":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"action":{"type":"string","title":"Action"},"resource":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource"},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","agent_id","action"],"title":"AgentAuditEntry"},"AgentBriefingResponse":{"properties":{"agent":{"type":"string","title":"Agent"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"},"signals":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Signals","default":[]},"correlations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Correlations","default":[]},"market_regime":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Market Regime"},"trending_companies":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Trending Companies","default":[]},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations","default":[]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["agent"],"title":"AgentBriefingResponse","description":"Pre-run intelligence briefing for an agent. Refs #4236"},"AgentCard":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"version":{"type":"string","maxLength":20,"title":"Version","default":"1.0.0"},"skills":{"items":{"$ref":"#/components/schemas/AgentCardSkill"},"type":"array","title":"Skills"},"input_modes":{"items":{"type":"string"},"type":"array","title":"Input Modes"},"output_modes":{"items":{"type":"string"},"type":"array","title":"Output Modes"},"meta":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["name"],"title":"AgentCard","description":"A2A-spec agent card describing what an agent can do.\nFollows the Agent-to-Agent protocol specification."},"AgentCardSkill":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description"},"input_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input Schema"},"output_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Schema"}},"type":"object","required":["name"],"title":"AgentCardSkill","description":"A single skill advertised by an agent."},"AgentCardUpdateRequest":{"properties":{"agent_card":{"$ref":"#/components/schemas/AgentCard"}},"type":"object","required":["agent_card"],"title":"AgentCardUpdateRequest","description":"Request body for PUT /api/v1/cloud/agents/{agent_id}/card."},"AgentCloudRegisterRequest":{"properties":{"agent_type":{"type":"string","maxLength":100,"minLength":1,"title":"Agent Type","description":"Type of agent (e.g. 'code-reviewer', 'translator')"},"capabilities":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Capabilities","description":"List of capability slugs (e.g. ['code-review', 'testing'])"},"agent_card":{"anyOf":[{"$ref":"#/components/schemas/AgentCard"},{"type":"null"}],"description":"A2A-spec agent card describing agent skills"},"protocols":{"items":{"type":"string"},"type":"array","title":"Protocols","description":"Supported protocols (e.g. ['mcp', 'a2a'])","default":["mcp"]},"endpoint_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Endpoint Url","description":"Agent's callable endpoint URL"},"is_public":{"type":"boolean","title":"Is Public","description":"Whether agent is discoverable by other agents","default":false},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"model":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Model"},"operator":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Operator"},"tools":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tools","description":"Tools to bundle. Defaults to standard 8-tool set if not specified."},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Free-form tags for organizing/discovering the agent (Refs #6519)"},"mcp_servers":{"anyOf":[{"items":{"$ref":"#/components/schemas/AgentMCPServerConfig"},"type":"array"},{"type":"null"}],"title":"Mcp Servers","description":"MCP server configurations to attach to this agent (Refs #6333)"}},"type":"object","required":["agent_type","capabilities"],"title":"AgentCloudRegisterRequest","description":"Request body for POST /api/v1/cloud/agents/register.\nRegisters an agent with A2A card and protocol support.\n\nRefs #1940"},"AgentCloudRegisterResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_type":{"type":"string","title":"Agent Type"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"tools":{"items":{"type":"string"},"type":"array","title":"Tools"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"agent_card":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Agent Card"},"protocols":{"items":{"type":"string"},"type":"array","title":"Protocols"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"is_public":{"type":"boolean","title":"Is Public"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["agent_id","agent_type","capabilities","tools","protocols","is_public","status","created_at"],"title":"AgentCloudRegisterResponse","description":"Response from POST /api/v1/cloud/agents/register."},"AgentConnectRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_type":{"type":"string","title":"Agent Type"},"capabilities":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Capabilities","default":{}},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["agent_id","agent_type"],"title":"AgentConnectRequest"},"AgentConnectResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/AgentConnectionInfo"},"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["success","data","message"],"title":"AgentConnectResponse","description":"Response for POST /agent-bridge/connect."},"AgentConnectionInfo":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"status":{"type":"string","title":"Status"},"connected_at":{"type":"string","title":"Connected At"},"capabilities":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Capabilities"}},"additionalProperties":true,"type":"object","required":["agent_id","name","type","status","connected_at"],"title":"AgentConnectionInfo","description":"The `data` payload of POST /agent-bridge/connect."},"AgentControlAction":{"type":"string","enum":["pause","resume","stop"],"title":"AgentControlAction","description":"Available agent control actions"},"AgentControlRequest":{"properties":{"action":{"$ref":"#/components/schemas/AgentControlAction","description":"Control action to perform"}},"type":"object","required":["action"],"title":"AgentControlRequest","description":"Request body for agent control"},"AgentControlResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether action was successful"},"agent_id":{"type":"string","title":"Agent Id","description":"Agent identifier"},"action":{"type":"string","title":"Action","description":"Action performed"},"new_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New State","description":"New agent state after action"},"message":{"type":"string","title":"Message","description":"Human-readable result message"}},"type":"object","required":["success","agent_id","action","message"],"title":"AgentControlResponse","description":"Response for agent control action"},"AgentCostResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"period":{"type":"string","title":"Period"},"total_credits":{"type":"number","title":"Total Credits"},"breakdown":{"items":{"$ref":"#/components/schemas/CostBreakdownItem"},"type":"array","title":"Breakdown"}},"type":"object","required":["agent_id","period","total_credits","breakdown"],"title":"AgentCostResponse","description":"Per-agent cost breakdown by resource type over a time period."},"AgentCreateRequest":{"properties":{"name":{"type":"string","title":"Name"},"agent_type":{"type":"string","title":"Agent Type"},"capabilities":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Capabilities","default":{}},"configuration":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Configuration","default":{}}},"type":"object","required":["name","agent_type"],"title":"AgentCreateRequest"},"AgentDashboardResponse":{"properties":{"agent_type":{"type":"string","title":"Agent Type"},"time_range_hours":{"type":"integer","title":"Time Range Hours"},"performance_summary":{"$ref":"#/components/schemas/AgentPerformanceDetail"},"optimization_experiments":{"items":{"$ref":"#/components/schemas/AgentOptimizationExperiment"},"type":"array","title":"Optimization Experiments"},"ab_test_results":{"items":{"$ref":"#/components/schemas/AgentABTestResult"},"type":"array","title":"Ab Test Results"},"quality_metrics":{"$ref":"#/components/schemas/AgentQualityMetrics"},"deployment_history":{"items":{"$ref":"#/components/schemas/AgentDeploymentHistoryItem"},"type":"array","title":"Deployment History"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["agent_type","time_range_hours","performance_summary","optimization_experiments","ab_test_results","quality_metrics","deployment_history","recommendations"],"title":"AgentDashboardResponse","description":"Response for GET /dashboard/agent/{agent_type}."},"AgentDeploymentHistoryItem":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"version":{"type":"string","title":"Version"},"status":{"type":"string","title":"Status"},"deployed_at":{"type":"string","title":"Deployed At"}},"type":"object","required":["deployment_id","version","status","deployed_at"],"title":"AgentDeploymentHistoryItem"},"AgentDeregisterResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"deregistered":{"type":"boolean","title":"Deregistered","default":true},"hard_deleted":{"type":"boolean","title":"Hard Deleted","default":false},"deployments_torn_down":{"type":"integer","title":"Deployments Torn Down","default":0},"oauth_clients_revoked":{"type":"integer","title":"Oauth Clients Revoked","default":0},"schedules_removed":{"type":"integer","title":"Schedules Removed","default":0}},"type":"object","required":["agent_id"],"title":"AgentDeregisterResponse","description":"Response from DELETE /api/v1/cloud/agents/{agent_id}."},"AgentDetailResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Agent instance ID"},"name":{"type":"string","title":"Name","description":"Agent name"},"persona":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona","description":"Agent persona/instructions"},"model":{"type":"string","title":"Model","description":"Model identifier"},"user_id":{"type":"string","format":"uuid","title":"User Id","description":"Owner user ID"},"status":{"$ref":"#/components/schemas/AgentSwarmStatusEnum","description":"Current agent status"},"openclaw_session_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openclaw Session Key","description":"OpenClaw session identifier"},"openclaw_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openclaw Agent Id","description":"OpenClaw agent ID"},"heartbeat_enabled":{"type":"boolean","title":"Heartbeat Enabled","description":"Heartbeat monitoring enabled"},"heartbeat_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Heartbeat Interval","description":"Heartbeat interval"},"heartbeat_checklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Heartbeat Checklist","description":"Heartbeat task checklist"},"last_heartbeat_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Heartbeat At","description":"Last heartbeat execution time"},"next_heartbeat_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Heartbeat At","description":"Next scheduled heartbeat time"},"configuration":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Configuration","description":"Agent configuration"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Last error message"},"error_count":{"type":"integer","title":"Error Count","description":"Error count"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"},"provisioned_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Provisioned At","description":"Provisioning completion timestamp"},"paused_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Paused At","description":"Pause timestamp"},"stopped_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Stopped At","description":"Stop timestamp"}},"type":"object","required":["id","name","model","user_id","status","heartbeat_enabled","error_count","created_at"],"title":"AgentDetailResponse","description":"Detailed response schema for agent retrieval"},"AgentDisconnectResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/AgentDisconnectionInfo"},"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["success","data","message"],"title":"AgentDisconnectResponse","description":"Response for POST /agent-bridge/disconnect."},"AgentDisconnectionInfo":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"disconnected_at":{"type":"string","title":"Disconnected At"}},"additionalProperties":true,"type":"object","required":["agent_id","name","status","disconnected_at"],"title":"AgentDisconnectionInfo","description":"The `data` payload of POST /agent-bridge/disconnect."},"AgentDiscoveryItem":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_type":{"type":"string","title":"Agent Type"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"protocols":{"items":{"type":"string"},"type":"array","title":"Protocols"},"tools":{"items":{"type":"string"},"type":"array","title":"Tools"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status","default":"ACTIVE"},"health_status":{"type":"string","title":"Health Status","default":"unknown"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"agent_card":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Agent Card"},"is_public":{"type":"boolean","title":"Is Public","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["agent_id","agent_type","capabilities","protocols","created_at"],"title":"AgentDiscoveryItem","description":"A single agent result in discovery/catalog responses."},"AgentDiscoveryResponse":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/AgentDiscoveryItem"},"type":"array","title":"Agents"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["agents","total","page","page_size"],"title":"AgentDiscoveryResponse","description":"Paginated discovery response."},"AgentEvalBreakdownEntry":{"properties":{"agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent"},"evals":{"type":"integer","title":"Evals"},"avg_score":{"type":"number","title":"Avg Score"}},"type":"object","required":["evals","avg_score"],"title":"AgentEvalBreakdownEntry"},"AgentEvent":{"properties":{"id":{"type":"string","title":"Id"},"agent":{"type":"string","title":"Agent"},"role":{"type":"string","title":"Role"},"action":{"type":"string","title":"Action"},"target":{"type":"string","title":"Target"},"timestamp":{"type":"string","title":"Timestamp"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","agent","role","action","target","timestamp","status"],"title":"AgentEvent"},"AgentHealthEntry":{"properties":{"agent_name":{"type":"string","title":"Agent Name","description":"Agent identifier (e.g., 'atlas', 'nova')"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name","description":"Human-readable agent name"},"specialty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Specialty","description":"Agent specialty area"},"status":{"type":"string","title":"Status","description":"Agent status: healthy, unhealthy, restarting, dead, unknown"},"current_task":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Task","description":"Current task or 'idle'"},"last_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Seen","description":"ISO 8601 timestamp of last successful health check"},"restart_count":{"type":"integer","title":"Restart Count","description":"Number of restart attempts","default":0},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error details if unhealthy"},"stub":{"type":"boolean","title":"Stub","description":"Whether agent is a stub (no specialized class)","default":false}},"type":"object","required":["agent_name","status"],"title":"AgentHealthEntry","description":"Health status of a single OpenClaw agent."},"AgentHealthReportRequest":{"properties":{"health_status":{"type":"string","title":"Health Status","description":"Agent health status"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Health metadata (e.g. latency_ms, load)"}},"type":"object","required":["health_status"],"title":"AgentHealthReportRequest","description":"Request body for POST /api/v1/cloud/agents/{agent_id}/health."},"AgentHealthReportResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"health_status":{"type":"string","title":"Health Status"},"last_health_check":{"type":"string","format":"date-time","title":"Last Health Check"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["agent_id","health_status","last_health_check"],"title":"AgentHealthReportResponse","description":"Response from health report endpoint."},"AgentIdentityClaimRequest":{"properties":{"claim_token":{"type":"string","title":"Claim Token"}},"type":"object","required":["claim_token"],"title":"AgentIdentityClaimRequest"},"AgentIdentityRegisterRequest":{"properties":{"type":{"type":"string","enum":["anonymous","service_auth","identity_assertion"],"title":"Type"},"login_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Login Hint"},"assertion_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assertion Type"},"assertion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assertion"}},"type":"object","required":["type"],"title":"AgentIdentityRegisterRequest"},"AgentImprovementRecord":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"score_before":{"type":"number","title":"Score Before"},"score_after":{"type":"number","title":"Score After"},"delta":{"type":"number","title":"Delta"},"improved":{"type":"boolean","title":"Improved"},"verified_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verified At"}},"type":"object","required":["agent_id","score_before","score_after","delta","improved"],"title":"AgentImprovementRecord"},"AgentInferenceRequest":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"Inference prompt"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Additional context"}},"type":"object","required":["prompt"],"title":"AgentInferenceRequest","description":"Request for agent inference"},"AgentInferenceResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"prompt":{"type":"string","title":"Prompt"},"response":{"type":"string","title":"Response"},"tokens_used":{"type":"integer","title":"Tokens Used"},"latency_ms":{"type":"integer","title":"Latency Ms"},"model_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Id"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["agent_id","prompt","response","tokens_used","latency_ms","timestamp"],"title":"AgentInferenceResponse","description":"Response for POST /collaboration/sessions/{session_id}/agents/{agent_id}/inference."},"AgentInfo":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"type":"string","title":"Agent Name"},"agent_type":{"type":"string","title":"Agent Type"},"status":{"$ref":"#/components/schemas/AgentStatus-Output","default":"idle"},"current_task":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Task"},"progress":{"type":"integer","maximum":100,"minimum":0,"title":"Progress","default":0},"last_activity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Activity"}},"type":"object","required":["agent_id","agent_name","agent_type"],"title":"AgentInfo","description":"Information about an agent working on a project"},"AgentInsight":{"properties":{"quality_score":{"type":"number","title":"Quality Score"},"improvement_trend":{"type":"string","title":"Improvement Trend"},"key_metrics":{"$ref":"#/components/schemas/AgentInsightKeyMetrics"}},"type":"object","required":["quality_score","improvement_trend","key_metrics"],"title":"AgentInsight"},"AgentInsightKeyMetrics":{"properties":{"accuracy":{"type":"number","title":"Accuracy"},"consistency":{"type":"number","title":"Consistency"},"efficiency":{"type":"number","title":"Efficiency"}},"type":"object","required":["accuracy","consistency","efficiency"],"title":"AgentInsightKeyMetrics"},"AgentInstanceResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"agent_type":{"type":"string","title":"Agent Type"},"capabilities":{"additionalProperties":true,"type":"object","title":"Capabilities"},"status":{"type":"string","title":"Status"},"created_by":{"type":"string","title":"Created By"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"last_ping":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ping"},"uptime_seconds":{"type":"integer","title":"Uptime Seconds"}},"type":"object","required":["id","name","agent_type","capabilities","status","created_by","created_at","uptime_seconds"],"title":"AgentInstanceResponse"},"AgentLearningTaskSummary":{"properties":{"id":{"type":"string","title":"Id"},"task_type":{"type":"string","title":"Task Type"},"status":{"type":"string","title":"Status"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters"},"results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Results"},"created_at":{"type":"string","title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["id","task_type","status","parameters","created_at"],"title":"AgentLearningTaskSummary"},"AgentListResponse":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/AgentDetailResponse"},"type":"array","title":"Agents","description":"List of agents"},"total":{"type":"integer","title":"Total","description":"Total agent count"},"limit":{"type":"integer","title":"Limit","description":"Pagination limit"},"offset":{"type":"integer","title":"Offset","description":"Pagination offset"}},"type":"object","required":["agents","total","limit","offset"],"title":"AgentListResponse","description":"Response schema for agent list endpoint"},"AgentLogCreate":{"properties":{"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id","description":"Agent identifier"},"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"log_level":{"type":"string","title":"Log Level","description":"Log level (DEBUG, INFO, WARN, ERROR)"},"log_message":{"type":"string","title":"Log Message","description":"Log message"},"raw_payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Raw Payload","description":"Raw log payload"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"Project ID (set automatically)"}},"type":"object","required":["log_level","log_message"],"title":"AgentLogCreate","description":"Schema for creating agent logs"},"AgentLogResponse":{"properties":{"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id","description":"Agent identifier"},"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"log_level":{"type":"string","title":"Log Level","description":"Log level (DEBUG, INFO, WARN, ERROR)"},"log_message":{"type":"string","title":"Log Message","description":"Log message"},"raw_payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Raw Payload","description":"Raw log payload"},"log_id":{"type":"string","format":"uuid","title":"Log Id","description":"Unique identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Unique identifier"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"}},"type":"object","required":["log_level","log_message","log_id","project_id","created_at"],"title":"AgentLogResponse","description":"Complete agent log response schema"},"AgentLogSubscribeRequest":{"properties":{"agent_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Agent Types","description":"Filter: only these agent types"},"levels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Levels","description":"Filter: only these log levels"},"filter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter","description":"Additional filter criteria"}},"type":"object","title":"AgentLogSubscribeRequest"},"AgentLogSubscribeResponse":{"properties":{"subscription_id":{"type":"string","title":"Subscription Id","description":"UUID of the created subscription"},"websocket_url":{"type":"string","title":"Websocket Url","description":"Relative WebSocket path to connect for live log streaming"}},"type":"object","required":["subscription_id","websocket_url"],"title":"AgentLogSubscribeResponse"},"AgentLogsRecentError":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"message":{"type":"string","title":"Message"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["timestamp","message"],"title":"AgentLogsRecentError"},"AgentLogsResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Agent identifier"},"logs":{"items":{"type":"string"},"type":"array","title":"Logs","description":"Log lines"},"total_lines":{"type":"integer","title":"Total Lines","description":"Total number of log lines available"},"returned_lines":{"type":"integer","title":"Returned Lines","description":"Number of lines returned"}},"type":"object","required":["agent_id","logs","total_lines","returned_lines"],"title":"AgentLogsResponse","description":"Agent execution logs"},"AgentMCPCatalogEntry":{"properties":{"id":{"type":"string","title":"Id"},"catalog_name":{"type":"string","title":"Catalog Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"endpoint_url":{"type":"string","title":"Endpoint Url"},"is_recommended":{"type":"boolean","title":"Is Recommended"}},"type":"object","required":["id","catalog_name","endpoint_url","is_recommended"],"title":"AgentMCPCatalogEntry","description":"One hosted-Gateway-backed MCP server a new agent could attach to."},"AgentMCPServerConfig":{"properties":{"server_name":{"type":"string","maxLength":100,"minLength":1,"title":"Server Name"},"server_type":{"type":"string","minLength":1,"title":"Server Type","description":"The MCP Discovery catalog server's id (UUID) this config attaches"},"env":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Env","description":"Environment variables for the MCP server"}},"type":"object","required":["server_name","server_type"],"title":"AgentMCPServerConfig","description":"MCP server configuration for an agent.\n\nserver_type is the real MCP Discovery catalog server's id (a UUID) —\nresolved against the live catalog at test-time, not a fixed enum. This\nreplaces the old closed 8-value set, which required a manual code change\n(schema + agent_mcp_runtime_service's MCP_SERVER_REQUIRED_ENV dict) for\nevery new catalog server to ever become attachable/testable (see #7875,\nwhere 'luma' was added this exact way). Refs #8548."},"AgentMCPServerListResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"servers":{"items":{"$ref":"#/components/schemas/AgentMCPServerResponse"},"type":"array","title":"Servers"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["agent_id","servers","total"],"title":"AgentMCPServerListResponse","description":"List of MCP servers attached to an agent."},"AgentMCPServerResponse":{"properties":{"server_name":{"type":"string","title":"Server Name"},"server_type":{"type":"string","title":"Server Type"},"env_keys":{"items":{"type":"string"},"type":"array","title":"Env Keys","description":"Names of configured env vars (values redacted for security)"}},"type":"object","required":["server_name","server_type"],"title":"AgentMCPServerResponse","description":"A single attached MCP server (credentials redacted)."},"AgentMCPTestResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"server_name":{"type":"string","title":"Server Name"},"server_type":{"type":"string","title":"Server Type"},"reachable":{"type":"boolean","title":"Reachable"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["agent_id","server_name","server_type","reachable","detail"],"title":"AgentMCPTestResponse","description":"Result of an MCP server connectivity test."},"AgentMemoryContextResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"memory_context":{"title":"Memory Context"},"context_count":{"type":"integer","title":"Context Count"},"retrieved_at":{"type":"string","title":"Retrieved At"}},"type":"object","required":["project_id","memory_context","context_count","retrieved_at"],"title":"AgentMemoryContextResponse"},"AgentMessageInfo":{"properties":{"message_id":{"type":"string","title":"Message Id"},"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"type":"string","title":"Agent Name"},"status":{"type":"string","title":"Status"},"sent_at":{"type":"string","title":"Sent At"},"message_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message Type"},"message_content":{"type":"string","title":"Message Content"}},"additionalProperties":true,"type":"object","required":["message_id","agent_id","agent_name","status","sent_at","message_content"],"title":"AgentMessageInfo","description":"The `data` payload of POST /agent-bridge/message."},"AgentMessageRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"message":{"type":"string","title":"Message"},"message_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message Type","default":"command"}},"type":"object","required":["agent_id","message"],"title":"AgentMessageRequest"},"AgentMessageResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/AgentMessageInfo"},"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["success","data","message"],"title":"AgentMessageResponse","description":"Response for POST /agent-bridge/message."},"AgentMetricsItem":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"total_requests":{"type":"integer","title":"Total Requests","default":0},"success_count":{"type":"integer","title":"Success Count","default":0},"error_count":{"type":"integer","title":"Error Count","default":0},"error_rate_pct":{"type":"number","title":"Error Rate Pct","default":0},"p50_latency_ms":{"type":"number","title":"P50 Latency Ms","default":0},"p95_latency_ms":{"type":"number","title":"P95 Latency Ms","default":0},"p99_latency_ms":{"type":"number","title":"P99 Latency Ms","default":0},"avg_latency_ms":{"type":"number","title":"Avg Latency Ms","default":0}},"type":"object","required":["agent_id"],"title":"AgentMetricsItem"},"AgentOptimizationExperiment":{"properties":{"experiment_id":{"type":"string","title":"Experiment Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"progress":{"type":"number","title":"Progress"}},"type":"object","required":["experiment_id","name","status","progress"],"title":"AgentOptimizationExperiment"},"AgentPerformanceDetail":{"properties":{"overall_score":{"type":"number","title":"Overall Score"},"efficiency_score":{"type":"number","title":"Efficiency Score"},"quality_score":{"type":"number","title":"Quality Score"},"recent_trend":{"type":"string","title":"Recent Trend"}},"type":"object","required":["overall_score","efficiency_score","quality_score","recent_trend"],"title":"AgentPerformanceDetail"},"AgentPerformanceEntry":{"properties":{"avg_time":{"type":"number","title":"Avg Time"},"success_rate":{"type":"number","title":"Success Rate"}},"type":"object","required":["avg_time","success_rate"],"title":"AgentPerformanceEntry"},"AgentPerformanceSummary":{"properties":{"performance_score":{"type":"number","title":"Performance Score"},"active_experiments":{"type":"integer","title":"Active Experiments"},"recent_deployments":{"type":"integer","title":"Recent Deployments"},"status":{"type":"string","title":"Status"}},"type":"object","required":["performance_score","active_experiments","recent_deployments","status"],"title":"AgentPerformanceSummary"},"AgentPromptAnalyticsResponse":{"properties":{"time_range":{"$ref":"#/components/schemas/PromptAnalyticsTimeRange"}},"additionalProperties":true,"type":"object","required":["time_range"],"title":"AgentPromptAnalyticsResponse"},"AgentProvisionRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name","description":"Agent name"},"persona":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona","description":"Agent persona/instructions"},"model":{"type":"string","title":"Model","description":"Model identifier (format: provider/model-name)"},"heartbeat":{"anyOf":[{"$ref":"#/components/schemas/HeartbeatConfig"},{"type":"null"}],"description":"Heartbeat configuration"},"configuration":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Configuration","description":"Additional agent configuration"}},"type":"object","required":["name","model"],"title":"AgentProvisionRequest","description":"Request schema for creating a new agent"},"AgentProvisionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Agent instance ID"},"name":{"type":"string","title":"Name","description":"Agent name"},"status":{"$ref":"#/components/schemas/AgentSwarmStatusEnum","description":"Current agent status"},"openclaw_session_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openclaw Session Key","description":"OpenClaw session identifier"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"}},"type":"object","required":["id","name","status","created_at"],"title":"AgentProvisionResponse","description":"Response schema for agent creation"},"AgentPublishResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"version":{"type":"string","title":"Version"},"status":{"type":"string","title":"Status"},"published_at":{"type":"string","format":"date-time","title":"Published At"}},"type":"object","required":["agent_id","version","status","published_at"],"title":"AgentPublishResponse","description":"Response from publishing an agent version."},"AgentQualityMetrics":{"properties":{"accuracy":{"type":"number","title":"Accuracy"},"consistency":{"type":"number","title":"Consistency"},"completeness":{"type":"number","title":"Completeness"},"response_time":{"type":"number","title":"Response Time"}},"type":"object","required":["accuracy","consistency","completeness","response_time"],"title":"AgentQualityMetrics"},"AgentRatingCreateRequest":{"properties":{"score":{"type":"integer","maximum":5,"minimum":1,"title":"Score","description":"Rating score (1-5)"},"comment":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Comment","description":"Optional review comment"}},"type":"object","required":["score"],"title":"AgentRatingCreateRequest","description":"Request body for POST /api/v1/cloud/agents/{agent_id}/ratings."},"AgentRatingListResponse":{"properties":{"ratings":{"items":{"$ref":"#/components/schemas/AgentRatingResponse"},"type":"array","title":"Ratings"},"total":{"type":"integer","title":"Total"},"average_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Score"}},"type":"object","required":["ratings","total"],"title":"AgentRatingListResponse","description":"List of ratings for an agent."},"AgentRatingResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"user_id":{"type":"string","title":"User Id"},"score":{"type":"integer","title":"Score"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","agent_id","user_id","score","created_at"],"title":"AgentRatingResponse","description":"Response for a single agent rating."},"AgentRegisterResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Stable UUID for this platform agent"},"api_key":{"type":"string","title":"Api Key","description":"Bearer API key scoped to this agent — shown once, store securely"}},"type":"object","required":["agent_id","api_key"],"title":"AgentRegisterResponse","description":"Response from POST /agents/register.\n\nagent_id — stable UUID for this platform agent.\napi_key — secret bearer token; shown ONCE — caller must persist it."},"AgentRegistryListItem":{"properties":{"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"capabilities":{"anyOf":[{},{"type":"null"}],"title":"Capabilities","description":"Capabilities as stored in the agent_registrations JSON column"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"ISO-8601 creation timestamp, or null"}},"type":"object","title":"AgentRegistryListItem","description":"One row of ``GET /api/v1/cloud/agents/``.\n\nMirrors the seven columns that handler projects from\n``agent_registrations`` exactly. Deliberately NOT ``AgentDiscoveryItem``:\nthat model requires ``agent_type``, ``protocols`` and a real ``datetime``\n``created_at``, none of which this query selects or emits.\n\n``created_at`` is ``Optional[str]``, NOT ``datetime``: the handler emits\n``row[6].isoformat() if row[6] else None``, so the value is already a\nstring on the wire and is genuinely nullable. Declaring ``datetime`` would\nhand re-serialization to FastAPI and reject the null case outright."},"AgentRegistryListResponse":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/AgentRegistryListItem"},"type":"array","title":"Agents"},"count":{"type":"integer","title":"Count","description":"Number of agents in THIS page"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["agents","count","limit","offset"],"title":"AgentRegistryListResponse","description":"Envelope for ``GET /api/v1/cloud/agents/`` (Refs #8449).\n\nThis same shape is returned on BOTH the success path and the handler's\nDB-failure fallback (``{\"agents\": [], \"count\": 0, ...}``), so the model\nvalidates either one — a transient DB error must keep degrading to an\nempty list rather than becoming a 500 response-validation error."},"AgentResourceActionResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable confirmation of the action taken","examples":["Started agent resource monitoring with interval 60s"]}},"type":"object","required":["message"],"title":"AgentResourceActionResponse","description":"Acknowledgement for an agent-resource control action.\n\nReturned by the monitoring/scaling start-stop toggles under\n/api/v1/public/agent-resources/*. Those handlers emit exactly one key,\n``message``, carrying a human-readable confirmation that includes the\ninterval they were started with where applicable. Refs #8877, #8449."},"AgentResourceMetric":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"metric_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Type"},"metric_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Metric Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"recorded_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recorded At"},"metadata":{"anyOf":[{},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["id","agent_id"],"title":"AgentResourceMetric","description":"One row from agent_resource_metrics (see get_agent_metrics below)."},"AgentResourceMetrics":{"properties":{"agent_id":{"type":"string","format":"uuid","title":"Agent Id","description":"Agent identifier"},"cpu_usage_percent":{"type":"number","maximum":100,"minimum":0,"title":"Cpu Usage Percent","description":"CPU usage percentage"},"memory_usage_mb":{"type":"number","minimum":0,"title":"Memory Usage Mb","description":"Memory usage in MB"},"gpu_usage_percent":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"title":"Gpu Usage Percent","description":"GPU usage percentage if applicable"},"active_tasks":{"type":"integer","minimum":0,"title":"Active Tasks","description":"Number of currently active tasks"},"queued_tasks":{"type":"integer","minimum":0,"title":"Queued Tasks","description":"Number of tasks in queue"},"token_usage_per_min":{"type":"number","minimum":0,"title":"Token Usage Per Min","description":"Token consumption rate per minute"},"response_time_ms":{"type":"number","minimum":0,"title":"Response Time Ms","description":"Average response time in milliseconds"},"error_rate_percent":{"type":"number","maximum":100,"minimum":0,"title":"Error Rate Percent","description":"Error rate percentage"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Timestamp of the metrics collection"}},"type":"object","required":["agent_id","cpu_usage_percent","memory_usage_mb","active_tasks","queued_tasks","token_usage_per_min","response_time_ms","error_rate_percent","timestamp"],"title":"AgentResourceMetrics","description":"Current resource utilization metrics for an agent"},"AgentResourceMetricsResponse":{"properties":{"metrics":{"items":{"$ref":"#/components/schemas/AgentResourceMetric"},"type":"array","title":"Metrics"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["metrics","total"],"title":"AgentResourceMetricsResponse"},"AgentResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"name":{"type":"string","title":"Name"},"agent_type":{"type":"string","title":"Agent Type"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"operator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operator"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"oversight_level":{"type":"string","title":"Oversight Level"},"max_delegation_depth":{"type":"integer","title":"Max Delegation Depth"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"status":{"type":"string","title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","user_id","name","agent_type","capabilities","oversight_level","max_delegation_depth","status"],"title":"AgentResponse"},"AgentRunLogEntry":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"run_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run At"},"action_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Summary"},"actions_taken":{"additionalProperties":true,"type":"object","title":"Actions Taken"},"status":{"type":"string","title":"Status"},"consecutive_silence_count":{"type":"integer","title":"Consecutive Silence Count","default":0},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["agent_id","status"],"title":"AgentRunLogEntry"},"AgentRunLogListResponse":{"properties":{"total":{"type":"integer","title":"Total"},"runs":{"items":{"$ref":"#/components/schemas/AgentRunLogEntry"},"type":"array","title":"Runs"}},"type":"object","required":["total","runs"],"title":"AgentRunLogListResponse"},"AgentRunLogPayload":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Agent identifier, e.g. 'sage', 'nova'"},"actions_taken":{"additionalProperties":true,"type":"object","title":"Actions Taken","description":"Structured summary of what the agent did"},"status":{"type":"string","title":"Status","description":"One of: success, partial, failed"},"account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Account Id","description":"Real user/organization UUID when the run is customer-facing. Omit for internal OpenClaw agents (stored as NULL). Refs #9415"}},"type":"object","required":["agent_id","status"],"title":"AgentRunLogPayload"},"AgentRunTrend":{"properties":{"date":{"type":"string","title":"Date"},"success_rate":{"type":"number","title":"Success Rate"},"total_runs":{"type":"integer","title":"Total Runs"}},"type":"object","required":["date","success_rate","total_runs"],"title":"AgentRunTrend"},"AgentScheduleCreateRequest":{"properties":{"schedule_type":{"type":"string","title":"Schedule Type","description":"'cron' or 'interval'"},"cron_expression":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Cron Expression","description":"Cron expression (e.g. '0 9 * * *' for daily at 9am UTC)"},"interval_seconds":{"anyOf":[{"type":"integer","maximum":86400,"minimum":60},{"type":"null"}],"title":"Interval Seconds","description":"Interval in seconds (min 60, max 86400)"},"timezone":{"type":"string","maxLength":50,"title":"Timezone","default":"UTC"},"task_payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Task Payload","description":"JSON payload passed to the agent at each run"},"enabled":{"type":"boolean","title":"Enabled","default":true}},"type":"object","required":["schedule_type"],"title":"AgentScheduleCreateRequest","description":"Request body for POST /api/v1/cloud/agents/{agent_id}/schedules."},"AgentScheduleListResponse":{"properties":{"schedules":{"items":{"$ref":"#/components/schemas/AgentScheduleResponse"},"type":"array","title":"Schedules"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["schedules","total"],"title":"AgentScheduleListResponse","description":"List of schedules for an agent."},"AgentScheduleResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"schedule_type":{"type":"string","title":"Schedule Type"},"cron_expression":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cron Expression"},"interval_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Interval Seconds"},"timezone":{"type":"string","title":"Timezone","default":"UTC"},"task_payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Task Payload"},"enabled":{"type":"boolean","title":"Enabled","default":true},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At"},"next_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Run At"},"run_count":{"type":"integer","title":"Run Count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","agent_id","schedule_type","created_at","updated_at"],"title":"AgentScheduleResponse","description":"Response for a single schedule."},"AgentScheduleRunListResponse":{"properties":{"runs":{"items":{"$ref":"#/components/schemas/AgentScheduleRunResponse"},"type":"array","title":"Runs"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["runs","total"],"title":"AgentScheduleRunListResponse","description":"List of schedule run history."},"AgentScheduleRunResponse":{"properties":{"id":{"type":"string","title":"Id"},"schedule_id":{"type":"string","title":"Schedule Id"},"agent_id":{"type":"string","title":"Agent Id"},"status":{"type":"string","title":"Status"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["id","schedule_id","agent_id","status","started_at"],"title":"AgentScheduleRunResponse","description":"Response for a single schedule run record."},"AgentScheduleUpdateRequest":{"properties":{"cron_expression":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cron Expression"},"interval_seconds":{"anyOf":[{"type":"integer","maximum":86400,"minimum":60},{"type":"null"}],"title":"Interval Seconds"},"timezone":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Timezone"},"task_payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Task Payload"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"}},"type":"object","title":"AgentScheduleUpdateRequest","description":"Request body for PUT /api/v1/cloud/agents/{agent_id}/schedules/{schedule_id}."},"AgentSearchRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":1,"title":"Query","description":"Search query"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Max results to return","default":20}},"type":"object","required":["query"],"title":"AgentSearchRequest","description":"Request body for POST /api/v1/cloud/agents/search."},"AgentSearchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/AgentSearchResultItem"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"},"query":{"type":"string","title":"Query"}},"type":"object","required":["results","total","query"],"title":"AgentSearchResponse","description":"Search results response."},"AgentSearchResultItem":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_type":{"type":"string","title":"Agent Type"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"is_public":{"type":"boolean","title":"Is Public","default":false},"relevance_score":{"type":"number","title":"Relevance Score","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["agent_id","agent_type","capabilities","created_at"],"title":"AgentSearchResultItem","description":"A single search result with relevance score."},"AgentSpawnQueueResponse":{"properties":{"spawn_request_ids":{"items":{"type":"string"},"type":"array","title":"Spawn Request Ids"}},"type":"object","required":["spawn_request_ids"],"title":"AgentSpawnQueueResponse","description":"Queued spawn response."},"AgentSpawnRequest":{"properties":{"role":{"type":"string","title":"Role","description":"Agent role","default":"worker"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities","description":"Agent capabilities"},"resources":{"additionalProperties":true,"type":"object","title":"Resources","description":"Resource requirements"},"issue_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Issue Number","description":"Optional issue number for NousCoder execution"},"task_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Description","description":"Optional task description for NousCoder execution"}},"type":"object","title":"AgentSpawnRequest","description":"Request to spawn a new agent"},"AgentSpendEntry":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"total_credits":{"type":"number","title":"Total Credits"},"breakdown":{"items":{"$ref":"#/components/schemas/CostBreakdownItem"},"type":"array","title":"Breakdown"}},"type":"object","required":["agent_id","total_credits","breakdown"],"title":"AgentSpendEntry","description":"One agent's contribution to a customer's total cloud spend."},"AgentStateCreateResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"state_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Name"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","title":"Created At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","agent_id","is_active","created_at","message"],"title":"AgentStateCreateResponse"},"AgentStateDeactivateResponse":{"properties":{"id":{"type":"string","title":"Id"},"is_active":{"type":"boolean","title":"Is Active"},"updated_at":{"type":"string","title":"Updated At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","is_active","updated_at","message"],"title":"AgentStateDeactivateResponse"},"AgentStateDeleteResponse":{"properties":{"id":{"type":"string","title":"Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","message"],"title":"AgentStateDeleteResponse"},"AgentStateDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"state_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Name"},"state_data":{"additionalProperties":true,"type":"object","title":"State Data"},"version":{"type":"integer","title":"Version"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","agent_id","state_data","version","is_active","created_at"],"title":"AgentStateDetailResponse"},"AgentStateListEntry":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"max_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Size Bytes"},"usage_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Usage Percent"},"table_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Table Count"},"total_rows":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Rows"},"tables":{"anyOf":[{"items":{"$ref":"#/components/schemas/AgentStateTableInfo"},"type":"array"},{"type":"null"}],"title":"Tables"},"snapshot_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Snapshot Count"},"last_write_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Write At"},"ttl_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Hours"},"ttl_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ttl Expires At"},"ttl_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Days"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"is_expired":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Expired"},"last_accessed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Accessed At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"}},"additionalProperties":true,"type":"object","required":["agent_id"],"title":"AgentStateListEntry","description":"One agent in the durable-state list — the frontend AgentStateInfo\ncontract (Refs #6506) plus the retained back-compat fields."},"AgentStateSummary":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"state_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Name"},"version":{"type":"integer","title":"Version"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","agent_id","version","is_active","created_at"],"title":"AgentStateSummary"},"AgentStateTableInfo":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"row_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Row Count"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"}},"additionalProperties":true,"type":"object","title":"AgentStateTableInfo","description":"One ZeroDB table in an agent's namespace."},"AgentStateTransferResponse":{"properties":{"original_state_id":{"type":"string","title":"Original State Id"},"new_state_id":{"type":"string","title":"New State Id"},"target_agent_id":{"type":"string","title":"Target Agent Id"},"created_at":{"type":"string","title":"Created At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["original_state_id","new_state_id","target_agent_id","created_at","message"],"title":"AgentStateTransferResponse"},"AgentStateUpdateResponse":{"properties":{"id":{"type":"string","title":"Id"},"version":{"type":"integer","title":"Version"},"updated_at":{"type":"string","title":"Updated At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","version","updated_at","message"],"title":"AgentStateUpdateResponse"},"AgentStatus-Input":{"type":"string","enum":["active","suspended","revoked"],"title":"AgentStatus"},"AgentStatus-Output":{"type":"string","enum":["idle","working","completed","failed","waiting"],"title":"AgentStatus","description":"Agent status within a project"},"AgentStatusEntry":{"properties":{"agent_name":{"type":"string","title":"Agent Name"},"status":{"type":"string","title":"Status"},"progress":{"type":"integer","title":"Progress"},"current_task":{"type":"string","title":"Current Task"},"model":{"type":"string","title":"Model"},"start_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Time"},"completion_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completion Time"}},"type":"object","required":["agent_name","status","progress","current_task","model"],"title":"AgentStatusEntry"},"AgentSummaryEntry":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"run_count":{"type":"integer","title":"Run Count"},"latest_run":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Run"},"max_silence_count":{"type":"integer","title":"Max Silence Count","default":0},"latest_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Status"},"latest_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Action"}},"type":"object","required":["agent_id","run_count"],"title":"AgentSummaryEntry"},"AgentSummaryResponse":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/AgentSummaryEntry"},"type":"array","title":"Agents"},"hours":{"type":"integer","title":"Hours"}},"type":"object","required":["agents","hours"],"title":"AgentSummaryResponse"},"AgentSwarmAgent":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","name","status","created_at"],"title":"AgentSwarmAgent"},"AgentSwarmAgentConfigEntry":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"status":{"type":"string","title":"Status"}},"type":"object","required":["enabled","status"],"title":"AgentSwarmAgentConfigEntry"},"AgentSwarmFeedbackEntry":{"properties":{"id":{"type":"string","title":"Id"},"project_id":{"type":"string","title":"Project Id"},"workflow_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Id"},"user_id":{"type":"string","title":"User Id"},"stage":{"type":"string","title":"Stage"},"feedback_type":{"type":"string","title":"Feedback Type"},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating"},"thumbs":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Thumbs"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment"},"suggestions":{"items":{},"type":"array","title":"Suggestions"},"content_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Reference"},"content_snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Snippet"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"zerodb_synced":{"type":"boolean","title":"Zerodb Synced"},"zerodb_interaction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zerodb Interaction Id"},"normalized_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Normalized Score"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","project_id","user_id","stage","feedback_type","zerodb_synced"],"title":"AgentSwarmFeedbackEntry","description":"Shape of AgentSwarmFeedback.to_dict(), as returned by\nGET /agent-swarm/feedback/projects/{project_id}."},"AgentSwarmFeedbackRequest":{"properties":{"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Project ID the feedback is for"},"workflow_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Workflow Id","description":"Workflow ID if applicable"},"stage":{"$ref":"#/components/schemas/FeedbackStage","description":"Workflow stage being evaluated"},"feedback_type":{"$ref":"#/components/schemas/app__schemas__agent_swarm_feedback__FeedbackType","description":"Type of feedback provided"},"rating":{"anyOf":[{"type":"integer","maximum":5,"minimum":1},{"type":"null"}],"title":"Rating","description":"Star rating from 1 to 5 (required for star_rating type)"},"thumbs":{"anyOf":[{"$ref":"#/components/schemas/ThumbsFeedback"},{"type":"null"}],"description":"Thumbs up/down feedback (required for thumbs type)"},"comment":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Comment","description":"Optional detailed feedback comment"},"suggestions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Suggestions","description":"List of improvement suggestions"},"content_reference":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Content Reference","description":"Reference to specific content (e.g., table name, issue ID)"},"content_snippet":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Content Snippet","description":"Snippet of the content being rated"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata for the feedback"}},"type":"object","required":["project_id","stage","feedback_type"],"title":"AgentSwarmFeedbackRequest","description":"Request schema for submitting feedback on AI-generated content.\n\nSupports multiple feedback types:\n- Star ratings (1-5) for PRD interpretation accuracy\n- Thumbs up/down for data model tables/fields\n- 1-5 ratings for issue quality in backlog\n- Detailed feedback for sprint estimates and code reviews","example":{"comment":"PRD interpretation was mostly accurate but missed some edge cases","content_reference":"prd_v1.md","feedback_type":"star_rating","metadata":{"agent_id":"prd_processor_001","prd_version":"1.0"},"project_id":"550e8400-e29b-41d4-a716-446655440000","rating":4,"stage":"prd_processing"}},"AgentSwarmFeedbackResponse":{"properties":{"feedback_id":{"type":"string","format":"uuid","title":"Feedback Id","description":"Unique feedback ID"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Project ID"},"stage":{"$ref":"#/components/schemas/FeedbackStage","description":"Workflow stage"},"feedback_type":{"$ref":"#/components/schemas/app__schemas__agent_swarm_feedback__FeedbackType","description":"Type of feedback"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp when feedback was created"},"synced_to_zerodb":{"type":"boolean","title":"Synced To Zerodb","description":"Whether feedback was synced to ZeroDB","default":false}},"type":"object","required":["feedback_id","project_id","stage","feedback_type","created_at"],"title":"AgentSwarmFeedbackResponse","description":"Response schema for submitted feedback","example":{"created_at":"2025-01-15T10:35:00Z","feedback_id":"660e8400-e29b-41d4-a716-446655440000","feedback_type":"star_rating","project_id":"550e8400-e29b-41d4-a716-446655440000","stage":"prd_processing","synced_to_zerodb":true}},"AgentSwarmFeedbackStage":{"properties":{"value":{"type":"string","title":"Value"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["value","name","description"],"title":"AgentSwarmFeedbackStage","description":"GET /agent-swarm/feedback/stages — one {value, name, description} entry."},"AgentSwarmFeedbackStatsResponse":{"properties":{"total_feedback":{"type":"integer","title":"Total Feedback","description":"Total feedback entries","default":0},"average_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Rating","description":"Overall average rating"},"positive_rate":{"type":"number","title":"Positive Rate","description":"Overall positive feedback rate","default":0},"negative_rate":{"type":"number","title":"Negative Rate","description":"Overall negative feedback rate","default":0},"stages":{"items":{"$ref":"#/components/schemas/FeedbackStageStats"},"type":"array","title":"Stages","description":"Statistics per workflow stage"},"start_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date","description":"Start of analysis period"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date","description":"End of analysis period"},"rating_trend":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Rating Trend","description":"Rating trend over time"}},"type":"object","title":"AgentSwarmFeedbackStatsResponse","description":"Response schema for feedback statistics","example":{"average_rating":4.2,"end_date":"2025-01-31T23:59:59Z","negative_rate":0.15,"positive_rate":0.85,"stages":[{"average_rating":4.5,"positive_rate":0.9,"stage":"prd_processing","thumbs_down_count":5,"thumbs_up_count":45,"total_feedback":50}],"start_date":"2025-01-01T00:00:00Z","total_feedback":150}},"AgentSwarmFeedbackSyncResponse":{"properties":{"synced":{"type":"integer","title":"Synced"},"failed":{"type":"integer","title":"Failed"},"pending":{"type":"integer","title":"Pending"}},"type":"object","required":["synced","failed","pending"],"title":"AgentSwarmFeedbackSyncResponse","description":"POST /agent-swarm/feedback/sync"},"AgentSwarmHealth":{"properties":{"total":{"type":"integer","title":"Total"},"active":{"type":"integer","title":"Active"},"specializations":{"items":{"type":"string"},"type":"array","title":"Specializations"}},"type":"object","required":["total","active","specializations"],"title":"AgentSwarmHealth","description":"Agent counts/specializations reported by the health check"},"AgentSwarmHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","timestamp"],"title":"AgentSwarmHealthResponse"},"AgentSwarmMetricsResponse":{"properties":{"total_projects":{"type":"integer","title":"Total Projects"},"active_projects":{"type":"integer","title":"Active Projects"},"completed_projects":{"type":"integer","title":"Completed Projects"},"failed_projects":{"type":"integer","title":"Failed Projects"},"success_rate":{"type":"number","title":"Success Rate"},"avg_completion_time":{"type":"number","title":"Avg Completion Time"},"active_agents":{"type":"integer","title":"Active Agents"},"agent_performance":{"additionalProperties":{"$ref":"#/components/schemas/AgentPerformanceEntry"},"type":"object","title":"Agent Performance"},"popular_project_types":{"items":{"$ref":"#/components/schemas/PopularProjectTypeEntry"},"type":"array","title":"Popular Project Types"},"resource_usage":{"$ref":"#/components/schemas/ResourceUsage"}},"type":"object","required":["total_projects","active_projects","completed_projects","failed_projects","success_rate","avg_completion_time","active_agents","agent_performance","popular_project_types","resource_usage"],"title":"AgentSwarmMetricsResponse"},"AgentSwarmProjectListItem":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"project_type":{"type":"string","title":"Project Type"},"description":{"type":"string","title":"Description"},"status":{"type":"string","title":"Status"},"agents_config":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Agents Config"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"completion_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completion Url"},"progress":{"type":"integer","title":"Progress"},"tier":{"anyOf":[{},{"type":"null"}],"title":"Tier"},"database_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Database Enabled"}},"type":"object","required":["project_id","project_name","project_type","description","status","agents_config","created_at","updated_at","progress"],"title":"AgentSwarmProjectListItem"},"AgentSwarmProjectStatusResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"status":{"type":"string","title":"Status"}},"additionalProperties":true,"type":"object","required":["project_id","status"],"title":"AgentSwarmProjectStatusResponse","description":"Permissive envelope for the project-status union of shapes.\n\nOnly `project_id` and `status` are common to every branch; everything\nelse is branch-specific and modeled loosely via extra=\"allow\" so no\nreal field is dropped by response_model filtering."},"AgentSwarmStatusEnum":{"type":"string","enum":["provisioning","running","paused","stopped","failed"],"title":"AgentSwarmStatusEnum","description":"Agent swarm instance status"},"AgentTaskDetail":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"task_type":{"type":"string","title":"Task Type"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters"},"priority":{"type":"integer","title":"Priority"},"status":{"type":"string","title":"Status"},"progress":{"type":"number","title":"Progress"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"assigned_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Agent Id"},"estimated_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Duration"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By"}},"type":"object","required":["id","name","task_type","parameters","priority","status","progress"],"title":"AgentTaskDetail"},"AgentTaskRequest":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"task_type":{"type":"string","title":"Task Type"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters","default":{}},"priority":{"type":"integer","title":"Priority","default":5},"assigned_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Agent Id"},"estimated_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Duration"}},"type":"object","required":["name","task_type"],"title":"AgentTaskRequest"},"AgentTaskSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"task_type":{"type":"string","title":"Task Type"},"priority":{"type":"integer","title":"Priority"},"status":{"type":"string","title":"Status"},"progress":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Progress"},"assigned_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Agent Id"},"estimated_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Duration"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"created_at":{"type":"string","title":"Created At"},"created_by":{"type":"string","title":"Created By"}},"type":"object","required":["id","name","task_type","priority","status","created_at","created_by"],"title":"AgentTaskSummary"},"AgentTokenRequest":{"properties":{"task":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Task","description":"Task description for this token"},"delegation_chain":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Delegation Chain","description":"Existing delegation chain to extend"},"ttl_minutes":{"type":"integer","maximum":1440,"minimum":1,"title":"Ttl Minutes","description":"Token TTL in minutes (max 24h)","default":60},"capability_subset":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Capability Subset","description":"Subset of agent capabilities to include (must be subset of agent's capabilities)"}},"type":"object","title":"AgentTokenRequest","description":"Request body to generate an AAP-extended JWT for an agent."},"AgentTokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"expires_in":{"type":"integer","title":"Expires In"},"agent_id":{"type":"string","title":"Agent Id"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"delegation_chain":{"items":{"type":"string"},"type":"array","title":"Delegation Chain"}},"type":"object","required":["access_token","expires_in","agent_id","capabilities","delegation_chain"],"title":"AgentTokenResponse"},"AgentToolsCatalogEntry":{"properties":{"description":{"type":"string","title":"Description"},"tier":{"type":"string","title":"Tier","description":"free | basic | professional | enterprise"}},"type":"object","required":["description","tier"],"title":"AgentToolsCatalogEntry","description":"One built-in tool's metadata in the ``all_tools`` map."},"AgentToolsCatalogResponse":{"properties":{"default_tools":{"items":{"type":"string"},"type":"array","title":"Default Tools","description":"Toolset bundled with every agent at registration"},"all_tools":{"additionalProperties":{"$ref":"#/components/schemas/AgentToolsCatalogEntry"},"type":"object","title":"All Tools","description":"Full built-in tool catalog, keyed by tool name"},"mcp_catalog":{"items":{"$ref":"#/components/schemas/AgentMCPCatalogEntry"},"type":"array","title":"Mcp Catalog","description":"Live Gateway-backed MCP servers; empty if unavailable"}},"type":"object","required":["default_tools","all_tools","mcp_catalog"],"title":"AgentToolsCatalogResponse","description":"Response for ``GET /api/v1/cloud/agents/tools`` (Refs #8449, #7989).\n\nAll three keys are unconditionally present — this is a public, read-only\ncatalog with no permission-dependent field sets — so no\n``response_model_exclude_unset`` is needed. ``mcp_catalog`` degrades to an\nempty list when the catalog query fails; the model permits that."},"AgentTraceAgentSummary":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"first_seen":{"type":"string","title":"First Seen"},"event_count":{"type":"integer","title":"Event Count"},"last_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Seen"}},"type":"object","required":["agent_id","first_seen","event_count"],"title":"AgentTraceAgentSummary"},"AgentTraceEvent":{"properties":{"index":{"type":"integer","title":"Index"},"timestamp":{"type":"string","title":"Timestamp"},"relative_time_ms":{"type":"integer","title":"Relative Time Ms"},"log_id":{"type":"string","title":"Log Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"level":{"type":"string","title":"Level"},"message":{"type":"string","title":"Message"},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"},"event_type":{"type":"string","title":"Event Type"}},"type":"object","required":["index","timestamp","relative_time_ms","log_id","level","message","event_type"],"title":"AgentTraceEvent"},"AgentTraceFilters":{"properties":{"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"time_window_minutes":{"type":"integer","title":"Time Window Minutes"}},"type":"object","required":["time_window_minutes"],"title":"AgentTraceFilters"},"AgentTraceGroup":{"properties":{"session_id":{"type":"string","title":"Session Id"},"agent_id":{"type":"string","title":"Agent Id"},"logs":{"items":{"$ref":"#/components/schemas/AgentTraceLogEntry"},"type":"array","title":"Logs"},"start_time":{"type":"string","title":"Start Time"},"log_count":{"type":"integer","title":"Log Count"}},"type":"object","required":["session_id","agent_id","logs","start_time","log_count"],"title":"AgentTraceGroup"},"AgentTraceLogEntry":{"properties":{"log_id":{"type":"string","title":"Log Id"},"timestamp":{"type":"string","title":"Timestamp"},"log_level":{"type":"string","title":"Log Level"},"message":{"type":"string","title":"Message"}},"type":"object","required":["log_id","timestamp","log_level","message"],"title":"AgentTraceLogEntry"},"AgentTraceSessionSummary":{"properties":{"session_id":{"type":"string","title":"Session Id"},"start_time":{"type":"string","title":"Start Time"},"event_count":{"type":"integer","title":"Event Count"},"error_count":{"type":"integer","title":"Error Count"},"status":{"type":"string","title":"Status"},"last_activity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity"}},"type":"object","required":["session_id","start_time","event_count","error_count","status"],"title":"AgentTraceSessionSummary"},"AgentType":{"type":"string","enum":["autonomous","supervised","tool","delegate"],"title":"AgentType"},"AgentTypeEntry":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"models":{"items":{"type":"string"},"type":"array","title":"Models"},"avg_completion_time":{"type":"number","title":"Avg Completion Time"}},"type":"object","required":["name","description","capabilities","models","avg_completion_time"],"title":"AgentTypeEntry"},"AgentUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Description"},"model":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Model"},"operator":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Operator"},"capabilities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Capabilities"},"oversight_level":{"anyOf":[{"$ref":"#/components/schemas/OversightLevel"},{"type":"null"}]},"max_delegation_depth":{"anyOf":[{"type":"integer","maximum":10,"minimum":1},{"type":"null"}],"title":"Max Delegation Depth"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"status":{"anyOf":[{"$ref":"#/components/schemas/AgentStatus-Input"},{"type":"null"}]}},"type":"object","title":"AgentUpdateRequest","description":"Request body to update an agent."},"AgentUpdateSettingsRequest":{"properties":{"persona":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona","description":"Updated agent persona/instructions"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Updated model identifier"},"heartbeat":{"anyOf":[{"$ref":"#/components/schemas/HeartbeatConfig"},{"type":"null"}],"description":"Updated heartbeat configuration"},"configuration":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Configuration","description":"Updated agent configuration"}},"type":"object","title":"AgentUpdateSettingsRequest","description":"Request schema for updating agent settings"},"AgentUsageItem":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"tokens_used":{"type":"integer","title":"Tokens Used","default":0},"cost_usd":{"type":"number","title":"Cost Usd","default":0},"tool_calls":{"type":"integer","title":"Tool Calls","default":0},"tasks_completed":{"type":"integer","title":"Tasks Completed","default":0}},"type":"object","required":["agent_id"],"title":"AgentUsageItem"},"AgentUsageResponse":{"properties":{"period":{"type":"string","title":"Period"},"period_start":{"type":"string","format":"date-time","title":"Period Start"},"period_end":{"type":"string","format":"date-time","title":"Period End"},"agents":{"items":{"$ref":"#/components/schemas/AgentUsageItem"},"type":"array","title":"Agents"}},"type":"object","required":["period","period_start","period_end","agents"],"title":"AgentUsageResponse"},"AgentVersionCreateRequest":{"properties":{"version":{"type":"string","maxLength":64,"minLength":5,"title":"Version","description":"Semver version string"},"agent_card":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Agent Card"},"capabilities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Capabilities"}},"type":"object","required":["version"],"title":"AgentVersionCreateRequest","description":"Request body for POST /api/v1/cloud/agents/{agent_id}/versions."},"AgentVersionListResponse":{"properties":{"versions":{"items":{"$ref":"#/components/schemas/AgentVersionResponse"},"type":"array","title":"Versions"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["versions","total"],"title":"AgentVersionListResponse","description":"List of agent versions."},"AgentVersionResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"version":{"type":"string","title":"Version"},"agent_card":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Agent Card"},"capabilities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Capabilities"},"status":{"type":"string","title":"Status","default":"draft"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","agent_id","version","created_at"],"title":"AgentVersionResponse","description":"Response for a single agent version."},"AgentWorkloadResponse":{"properties":{"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"active_tasks":{"type":"integer","title":"Active Tasks"},"completed_tasks":{"type":"integer","title":"Completed Tasks"},"pending_messages":{"type":"integer","title":"Pending Messages"},"average_response_time":{"type":"number","title":"Average Response Time"}},"type":"object","required":["active_tasks","completed_tasks","pending_messages","average_response_time"],"title":"AgentWorkloadResponse","example":{"active_tasks":5,"agent_id":"agent-123","average_response_time":1.5,"completed_tasks":42,"pending_messages":3}},"AgentsStatusSummaryResponse":{"properties":{"total_agents":{"type":"integer","title":"Total Agents","description":"Total number of active agents"},"state_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"State Breakdown","description":"Count of agents in each lifecycle state"},"agents":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__orchestration__AgentStatusResponse"},"type":"array","title":"Agents","description":"List of all active agents"}},"type":"object","required":["total_agents","state_breakdown","agents"],"title":"AgentsStatusSummaryResponse","description":"Summary of all active agents"},"AiGenerateBacklogResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"backlog":{"additionalProperties":true,"type":"object","title":"Backlog"},"existing_primitives":{"additionalProperties":true,"type":"object","title":"Existing Primitives"},"grounded_on_existing":{"type":"boolean","title":"Grounded On Existing"},"generated_at":{"type":"string","title":"Generated At"},"model_used":{"type":"string","title":"Model Used"},"status":{"type":"string","title":"Status"}},"type":"object","required":["project_id","backlog","existing_primitives","grounded_on_existing","generated_at","model_used","status"],"title":"AiGenerateBacklogResponse"},"AiGenerateDataModelResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"data_model":{"additionalProperties":true,"type":"object","title":"Data Model"},"existing_primitives":{"additionalProperties":true,"type":"object","title":"Existing Primitives"},"grounded_on_existing":{"type":"boolean","title":"Grounded On Existing"},"generated_at":{"type":"string","title":"Generated At"},"generator":{"type":"string","title":"Generator"},"model_used":{"type":"string","title":"Model Used"},"status":{"type":"string","title":"Status"}},"type":"object","required":["project_id","data_model","existing_primitives","grounded_on_existing","generated_at","generator","model_used","status"],"title":"AiGenerateDataModelResponse"},"AiGeneratePrdResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"prd_content":{"type":"string","title":"Prd Content"},"generated_at":{"type":"string","title":"Generated At"},"model_used":{"type":"string","title":"Model Used"},"token_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Token Count"},"status":{"type":"string","title":"Status"}},"type":"object","required":["project_id","prd_content","generated_at","model_used","status"],"title":"AiGeneratePrdResponse"},"AiGenerateSprintPlanResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"sprint_plan":{"additionalProperties":true,"type":"object","title":"Sprint Plan"},"generated_at":{"type":"string","title":"Generated At"},"model_used":{"type":"string","title":"Model Used"},"status":{"type":"string","title":"Status"}},"type":"object","required":["project_id","sprint_plan","generated_at","model_used","status"],"title":"AiGenerateSprintPlanResponse"},"AiUsageAggregateData":{"properties":{"total_sessions":{"type":"integer","title":"Total Sessions"},"total_output_tokens":{"type":"integer","title":"Total Output Tokens"},"successful_requests":{"type":"integer","title":"Successful Requests"},"last_activity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity"},"model_usage":{"additionalProperties":{"type":"integer"},"type":"object","title":"Model Usage"},"active_providers":{"items":{"type":"string"},"type":"array","title":"Active Providers"},"total_requests":{"type":"integer","title":"Total Requests"},"avg_latency":{"type":"number","title":"Avg Latency"}},"type":"object","required":["total_sessions","total_output_tokens","successful_requests","model_usage","active_providers","total_requests","avg_latency"],"title":"AiUsageAggregateData"},"AiUsageAggregateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/AiUsageAggregateData"}},"type":"object","required":["success","data"],"title":"AiUsageAggregateResponse"},"AikitTopModel":{"properties":{"name":{"type":"string","title":"Name"},"requests":{"type":"integer","title":"Requests"},"avg_latency_ms":{"type":"number","title":"Avg Latency Ms"},"provider":{"type":"string","title":"Provider"}},"type":"object","required":["name","requests","avg_latency_ms","provider"],"title":"AikitTopModel"},"AirflowPipelinePauseResponse":{"properties":{"dag_id":{"anyOf":[{},{"type":"null"}],"title":"Dag Id"},"is_paused":{"anyOf":[{},{"type":"null"}],"title":"Is Paused"},"is_active":{"anyOf":[{},{"type":"null"}],"title":"Is Active"},"is_subdag":{"anyOf":[{},{"type":"null"}],"title":"Is Subdag"},"description":{"anyOf":[{},{"type":"null"}],"title":"Description"},"owners":{"anyOf":[{},{"type":"null"}],"title":"Owners"},"tags":{"anyOf":[{},{"type":"null"}],"title":"Tags"},"schedule_interval":{"anyOf":[{},{"type":"null"}],"title":"Schedule Interval"},"next_dagrun":{"anyOf":[{},{"type":"null"}],"title":"Next Dagrun"},"last_parsed_time":{"anyOf":[{},{"type":"null"}],"title":"Last Parsed Time"},"fileloc":{"anyOf":[{},{"type":"null"}],"title":"Fileloc"}},"additionalProperties":true,"type":"object","title":"AirflowPipelinePauseResponse","description":"PATCH /pipelines/{dag_id}/pause -- Airflow's DAG object, verbatim.\n\nA different shape from the DAGRun above: Airflow's PATCH /dags/{dag_id}\nreturns the whole DAG, not the run."},"AirflowPipelineTriggerResponse":{"properties":{"dag_run_id":{"anyOf":[{},{"type":"null"}],"title":"Dag Run Id"},"dag_id":{"anyOf":[{},{"type":"null"}],"title":"Dag Id"},"state":{"anyOf":[{},{"type":"null"}],"title":"State"},"logical_date":{"anyOf":[{},{"type":"null"}],"title":"Logical Date"},"execution_date":{"anyOf":[{},{"type":"null"}],"title":"Execution Date"},"start_date":{"anyOf":[{},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{},{"type":"null"}],"title":"End Date"},"data_interval_start":{"anyOf":[{},{"type":"null"}],"title":"Data Interval Start"},"data_interval_end":{"anyOf":[{},{"type":"null"}],"title":"Data Interval End"},"run_type":{"anyOf":[{},{"type":"null"}],"title":"Run Type"},"external_trigger":{"anyOf":[{},{"type":"null"}],"title":"External Trigger"},"conf":{"anyOf":[{},{"type":"null"}],"title":"Conf"},"note":{"anyOf":[{},{"type":"null"}],"title":"Note"}},"additionalProperties":true,"type":"object","title":"AirflowPipelineTriggerResponse","description":"POST /pipelines/{dag_id}/trigger -- Airflow's DAGRun object, verbatim."},"AlbumCreate":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"visibility":{"$ref":"#/components/schemas/AlbumVisibility","default":"public"},"cover_photo_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Cover Photo Url"}},"type":"object","required":["title"],"title":"AlbumCreate","description":"Schema for creating an album"},"AlbumDetailResponse":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"visibility":{"$ref":"#/components/schemas/AlbumVisibility","default":"public"},"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"cover_photo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Photo Url"},"cover_item_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cover Item Id"},"items_count":{"type":"integer","title":"Items Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"items":{"items":{"$ref":"#/components/schemas/AlbumItemResponse"},"type":"array","title":"Items","default":[]}},"type":"object","required":["title","id","user_id","cover_photo_url","cover_item_id","items_count","created_at","updated_at"],"title":"AlbumDetailResponse","description":"Schema for detailed album response with items"},"AlbumItemCreate":{"properties":{"content_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Content Id"},"item_type":{"$ref":"#/components/schemas/AlbumItemType"},"media_url":{"type":"string","maxLength":500,"title":"Media Url"},"thumbnail_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Thumbnail Url"},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"file_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size Bytes"},"mime_type":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Mime Type"},"order_index":{"type":"integer","minimum":0,"title":"Order Index","default":0}},"type":"object","required":["item_type","media_url"],"title":"AlbumItemCreate","description":"Schema for creating an album item"},"AlbumItemResponse":{"properties":{"content_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Content Id"},"item_type":{"$ref":"#/components/schemas/AlbumItemType"},"media_url":{"type":"string","maxLength":500,"title":"Media Url"},"thumbnail_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Thumbnail Url"},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"file_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size Bytes"},"mime_type":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Mime Type"},"order_index":{"type":"integer","minimum":0,"title":"Order Index","default":0},"id":{"type":"string","format":"uuid","title":"Id"},"album_id":{"type":"string","format":"uuid","title":"Album Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["item_type","media_url","id","album_id","created_at","updated_at"],"title":"AlbumItemResponse","description":"Schema for album item response"},"AlbumItemType":{"type":"string","enum":["photo","video"],"title":"AlbumItemType","description":"Types of items that can be in an album"},"AlbumListResponse":{"properties":{"albums":{"items":{"$ref":"#/components/schemas/AlbumResponse"},"type":"array","title":"Albums"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["albums","total","page","page_size","total_pages"],"title":"AlbumListResponse","description":"Schema for paginated album list"},"AlbumResponse":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"visibility":{"$ref":"#/components/schemas/AlbumVisibility","default":"public"},"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"cover_photo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Photo Url"},"cover_item_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cover Item Id"},"items_count":{"type":"integer","title":"Items Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["title","id","user_id","cover_photo_url","cover_item_id","items_count","created_at","updated_at"],"title":"AlbumResponse","description":"Schema for album response"},"AlbumUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"visibility":{"anyOf":[{"$ref":"#/components/schemas/AlbumVisibility"},{"type":"null"}]},"cover_photo_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Cover Photo Url"},"cover_item_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cover Item Id"}},"type":"object","title":"AlbumUpdate","description":"Schema for updating an album"},"AlbumVisibility":{"type":"string","enum":["public","private","friends","unlisted"],"title":"AlbumVisibility","description":"Album visibility options"},"AlertAction":{"properties":{"type":{"type":"string","pattern":"^(email|slack|pagerduty|webhook)$","title":"Type","description":"Action type"},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Action-specific configuration"}},"type":"object","required":["type","config"],"title":"AlertAction","description":"Alert action configuration","example":{"config":{"recipients":["admin@example.com","ops@example.com"]},"type":"email"}},"AlertCondition":{"properties":{"threshold":{"type":"number","title":"Threshold","description":"Threshold value (percentage or absolute)"},"duration_minutes":{"type":"integer","maximum":1440,"minimum":1,"title":"Duration Minutes","description":"Time window in minutes"},"operator":{"type":"string","pattern":"^(gt|lt|gte|lte|eq)$","title":"Operator","description":"Comparison operator"},"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel","description":"Optional channel filter. Accepts the family alias 'email' (covers email_smtp, email_sendgrid, email_ses, email_resend) or an exact channel type: email_smtp, email_sendgrid, email_ses, email_resend, slack, pagerduty, webhook. Omit to match all channels."}},"type":"object","required":["threshold","duration_minutes","operator"],"title":"AlertCondition","description":"Alert condition configuration","example":{"channel":"email","duration_minutes":5,"operator":"gt","threshold":10}},"AlertCreateRequest":{"properties":{"agent_id":{"type":"string","maxLength":255,"minLength":1,"title":"Agent Id"},"threshold_percent":{"type":"integer","maximum":100,"minimum":1,"title":"Threshold Percent"},"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["agent_id","threshold_percent","email"],"title":"AlertCreateRequest"},"AlertHistoryResponse":{"properties":{"alerts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Alerts"},"total_count":{"type":"integer","title":"Total Count"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["alerts","total_count","timestamp"],"title":"AlertHistoryResponse"},"AlertInstanceListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AlertInstanceResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["items","total","page","page_size","total_pages"],"title":"AlertInstanceListResponse","description":"Schema for paginated alert instance list","example":{"items":[],"page":1,"page_size":20,"total":10,"total_pages":1}},"AlertInstanceResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"rule_id":{"type":"string","format":"uuid","title":"Rule Id"},"rule_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rule Name"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"metric_value":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metric Value"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context"},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"},"acknowledged_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Acknowledged At"},"acknowledged_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Acknowledged By"},"acknowledgment_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Acknowledgment Note"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"auto_resolved":{"type":"boolean","title":"Auto Resolved"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","rule_id","status","message","metric_value","context","acknowledged_at","acknowledged_by","acknowledgment_note","resolved_at","auto_resolved","created_at"],"title":"AlertInstanceResponse","description":"Schema for alert instance response","example":{"auto_resolved":false,"context":{"affected_channels":["email_smtp"],"error_types":["connection_timeout","smtp_error"]},"created_at":"2025-01-07T12:05:00Z","id":"650e8400-e29b-41d4-a716-446655440001","message":"Email delivery failure rate is 12.5% (threshold: 10%)","metric_value":{"channel":"email","failed_count":25,"failure_rate":12.5,"time_window":"5m","total_count":200},"rule_id":"550e8400-e29b-41d4-a716-446655440000","rule_name":"High Email Failure Rate","severity":"warning","status":"active","updated_at":"2025-01-07T12:05:00Z"}},"AlertItem":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"threshold_percent":{"type":"integer","title":"Threshold Percent"},"email":{"type":"string","title":"Email"},"triggered":{"type":"boolean","title":"Triggered","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","agent_id","threshold_percent","email","created_at"],"title":"AlertItem"},"AlertListResponse":{"properties":{"alerts":{"items":{"$ref":"#/components/schemas/AlertItem"},"type":"array","title":"Alerts"}},"type":"object","required":["alerts"],"title":"AlertListResponse"},"AlertRuleConfig":{"properties":{"name":{"type":"string","title":"Name"},"condition":{"type":"string","title":"Condition"},"severity":{"type":"string","title":"Severity"},"action":{"type":"string","title":"Action"},"cooldown_minutes":{"type":"integer","title":"Cooldown Minutes"},"last_triggered":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Triggered"}},"type":"object","required":["name","condition","severity","action","cooldown_minutes"],"title":"AlertRuleConfig","description":"One configured alert rule (from ``AlertRule`` dataclass)."},"AlertRuleListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AlertRuleResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["items","total","page","page_size","total_pages"],"title":"AlertRuleListResponse","description":"Schema for paginated alert rule list","example":{"items":[],"page":1,"page_size":20,"total":5,"total_pages":1}},"AlertRuleResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"metric_type":{"type":"string","title":"Metric Type"},"condition":{"additionalProperties":true,"type":"object","title":"Condition"},"severity":{"type":"string","title":"Severity"},"actions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Actions"},"enabled":{"type":"boolean","title":"Enabled"},"cooldown_minutes":{"type":"integer","title":"Cooldown Minutes"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","description","metric_type","condition","severity","actions","enabled","cooldown_minutes","created_at"],"title":"AlertRuleResponse","description":"Schema for alert rule response","example":{"actions":[{"config":{"recipients":["admin@example.com"]},"type":"email"}],"condition":{"channel":"email","duration_minutes":5,"operator":"gt","threshold":10},"cooldown_minutes":15,"created_at":"2025-01-07T12:00:00Z","description":"Alert when email delivery failure rate exceeds 10% in 5 minutes","enabled":true,"id":"550e8400-e29b-41d4-a716-446655440000","metric_type":"notification_failure_rate","name":"High Email Failure Rate","severity":"warning","updated_at":"2025-01-07T12:00:00Z"}},"AlertStatistics":{"properties":{"total_rules":{"type":"integer","title":"Total Rules"},"enabled_rules":{"type":"integer","title":"Enabled Rules"},"disabled_rules":{"type":"integer","title":"Disabled Rules"},"active_alerts":{"type":"integer","title":"Active Alerts"},"acknowledged_alerts":{"type":"integer","title":"Acknowledged Alerts"},"resolved_alerts_24h":{"type":"integer","title":"Resolved Alerts 24H"},"avg_response_time_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Response Time Seconds"},"alerts_by_severity":{"additionalProperties":{"type":"integer"},"type":"object","title":"Alerts By Severity"}},"type":"object","required":["total_rules","enabled_rules","disabled_rules","active_alerts","acknowledged_alerts","resolved_alerts_24h","avg_response_time_seconds","alerts_by_severity"],"title":"AlertStatistics","description":"Schema for alert statistics","example":{"acknowledged_alerts":2,"active_alerts":3,"alerts_by_severity":{"critical":1,"info":0,"warning":2},"avg_response_time_seconds":180,"disabled_rules":2,"enabled_rules":8,"resolved_alerts_24h":15,"total_rules":10}},"AllowlistRequest":{"properties":{"allowlist":{"items":{"type":"string"},"type":"array","title":"Allowlist"}},"type":"object","required":["allowlist"],"title":"AllowlistRequest"},"AllowlistResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"allowlist":{"items":{"type":"string"},"type":"array","title":"Allowlist"}},"type":"object","required":["allowlist"],"title":"AllowlistResponse"},"Alternative":{"properties":{"model_id":{"type":"string","title":"Model Id"},"tradeoff":{"type":"string","title":"Tradeoff"}},"type":"object","required":["model_id","tradeoff"],"title":"Alternative"},"AnalysisRequest":{"properties":{"analysis_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Analysis Types","description":"Types of analysis to perform","default":["style","security","performance","best_practices"]}},"type":"object","title":"AnalysisRequest","description":"Request model for starting PR analysis"},"AnalysisResult":{"properties":{"id":{"type":"string","title":"Id"},"repository_id":{"type":"integer","title":"Repository Id"},"pull_request_id":{"type":"integer","title":"Pull Request Id"},"analysis_type":{"type":"string","title":"Analysis Type"},"analysis_result":{"additionalProperties":true,"type":"object","title":"Analysis Result"},"severity_level":{"type":"string","title":"Severity Level"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","repository_id","pull_request_id","analysis_type","analysis_result","severity_level","created_at","updated_at"],"title":"AnalysisResult","description":"Response model for analysis results"},"AnalysisStatus":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"repository_id":{"type":"integer","title":"Repository Id"},"pull_request_id":{"type":"integer","title":"Pull Request Id"},"status":{"type":"string","title":"Status"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["repository_id","pull_request_id","status"],"title":"AnalysisStatus","description":"Response model for analysis status"},"AnalyticsByToolResponse":{"properties":{"tools":{"items":{"$ref":"#/components/schemas/ToolAnalyticsEntry"},"type":"array","title":"Tools"},"total_tools":{"type":"integer","title":"Total Tools"},"period":{"anyOf":[{"$ref":"#/components/schemas/AnalyticsPeriod"},{"type":"null"}]},"filters":{"anyOf":[{"$ref":"#/components/schemas/AnalyticsFilters"},{"type":"null"}]}},"type":"object","required":["tools","total_tools"],"title":"AnalyticsByToolResponse","description":"Response body for /by-tool."},"AnalyticsEvaluationResponse":{"properties":{"total_evaluations":{"type":"integer","title":"Total Evaluations"},"evaluations_today":{"type":"integer","title":"Evaluations Today"},"evaluations_this_week":{"type":"integer","title":"Evaluations This Week"},"passed":{"type":"integer","title":"Passed"},"failed":{"type":"integer","title":"Failed"},"pass_rate":{"type":"number","title":"Pass Rate"},"avg_quality_score":{"type":"number","title":"Avg Quality Score"},"quality_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Quality Distribution"},"agent_breakdown":{"items":{"$ref":"#/components/schemas/AgentEvalBreakdownEntry"},"type":"array","title":"Agent Breakdown"},"wow_change_pct":{"type":"number","title":"Wow Change Pct"}},"type":"object","required":["total_evaluations","evaluations_today","evaluations_this_week","passed","failed","pass_rate","avg_quality_score","quality_distribution","agent_breakdown","wow_change_pct"],"title":"AnalyticsEvaluationResponse"},"AnalyticsEventBatch":{"properties":{"events":{"items":{"$ref":"#/components/schemas/AnalyticsEventCreate"},"type":"array","maxItems":100,"title":"Events","description":"List of events to create"}},"type":"object","required":["events"],"title":"AnalyticsEventBatch","description":"Batch analytics event creation request"},"AnalyticsEventCreate":{"properties":{"video_id":{"type":"string","format":"uuid","title":"Video Id","description":"Video identifier"},"event_type":{"$ref":"#/components/schemas/VideoAnalyticsEventType","description":"Event type"},"session_id":{"type":"string","maxLength":255,"minLength":1,"title":"Session Id","description":"Browser session ID"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id","description":"User ID (optional for anonymous)"},"position_seconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Position Seconds","description":"Playback position in seconds"},"duration_seconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Duration Seconds","description":"Total video duration in seconds"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional event metadata"},"watch_duration_seconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Watch Duration Seconds","description":"Duration watched in this segment"}},"type":"object","required":["video_id","event_type","session_id"],"title":"AnalyticsEventCreate","description":"Single analytics event creation request","example":{"duration_seconds":300,"event_type":"play","metadata":{"browser":"Chrome","device":"desktop","quality":"1080p"},"position_seconds":45.5,"session_id":"sess_abc123xyz","video_id":"123e4567-e89b-12d3-a456-426614174000"}},"AnalyticsEventResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"video_id":{"type":"string","format":"uuid","title":"Video Id"},"event_type":{"$ref":"#/components/schemas/VideoAnalyticsEventType"},"session_id":{"type":"string","title":"Session Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","video_id","event_type","session_id","timestamp","created_at"],"title":"AnalyticsEventResponse","description":"Analytics event response"},"AnalyticsExportFormat":{"type":"string","enum":["json","csv"],"title":"AnalyticsExportFormat","description":"Export format options"},"AnalyticsFilters":{"properties":{"tool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Name"},"admin_mode":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Admin Mode"}},"type":"object","title":"AnalyticsFilters","description":"Filters echoed back on analytics responses."},"AnalyticsGrowthExperimentsResponse":{"properties":{"active":{"type":"integer","title":"Active"},"killed":{"type":"integer","title":"Killed"},"promoted":{"type":"integer","title":"Promoted"},"total":{"type":"integer","title":"Total"},"experiments":{"items":{"$ref":"#/components/schemas/GrowthExperimentEntry"},"type":"array","title":"Experiments"}},"type":"object","required":["active","killed","promoted","total","experiments"],"title":"AnalyticsGrowthExperimentsResponse"},"AnalyticsLogsRequest":{"properties":{"logs":{"items":{"$ref":"#/components/schemas/LogEvent"},"type":"array","title":"Logs"}},"type":"object","title":"AnalyticsLogsRequest","description":"Batch of log events (Datadog intake format)."},"AnalyticsLogsResponse":{"properties":{"accepted":{"type":"integer","title":"Accepted"},"dropped":{"type":"integer","title":"Dropped"},"message":{"type":"string","title":"Message","default":"ok"}},"type":"object","required":["accepted","dropped"],"title":"AnalyticsLogsResponse"},"AnalyticsMemoryResponse":{"properties":{"total_memories":{"type":"integer","title":"Total Memories"},"memories_today":{"type":"integer","title":"Memories Today"},"active_sessions":{"type":"integer","title":"Active Sessions"},"completed_sessions":{"type":"integer","title":"Completed Sessions"},"total_vectors":{"type":"integer","title":"Total Vectors"},"memory_usage_mb":{"type":"number","title":"Memory Usage Mb"}},"type":"object","required":["total_memories","memories_today","active_sessions","completed_sessions","total_vectors","memory_usage_mb"],"title":"AnalyticsMemoryResponse"},"AnalyticsPeriod":{"properties":{"start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"},"end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}},"type":"object","title":"AnalyticsPeriod","description":"Date-range filter echoed back on analytics responses."},"AnalyticsSummaryHealthStatus":{"properties":{"system_status":{"type":"string","title":"System Status"},"active_alerts":{"title":"Active Alerts"},"data_freshness":{"type":"string","title":"Data Freshness"},"service_availability":{"type":"string","title":"Service Availability"}},"type":"object","required":["system_status","active_alerts","data_freshness","service_availability"],"title":"AnalyticsSummaryHealthStatus"},"AnalyticsSummaryKeyMetrics":{"properties":{"total_evaluations":{"title":"Total Evaluations"},"active_prompts":{"title":"Active Prompts"},"active_tests":{"title":"Active Tests"},"alert_count":{"title":"Alert Count"}},"type":"object","required":["total_evaluations","active_prompts","active_tests","alert_count"],"title":"AnalyticsSummaryKeyMetrics"},"AnalyticsSummaryPerformanceOverview":{"properties":{"top_performing_prompts":{"type":"integer","title":"Top Performing Prompts"},"quality_trends":{"type":"string","title":"Quality Trends"},"usage_trend":{"type":"string","title":"Usage Trend"},"cost_efficiency":{"type":"string","title":"Cost Efficiency"}},"type":"object","required":["top_performing_prompts","quality_trends","usage_trend","cost_efficiency"],"title":"AnalyticsSummaryPerformanceOverview"},"AnalyticsSummaryPeriod":{"properties":{"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"days":{"type":"integer","title":"Days"}},"type":"object","required":["start_date","end_date","days"],"title":"AnalyticsSummaryPeriod"},"AnalyticsTokenCostResponse":{"properties":{"total_cost_7d":{"type":"number","title":"Total Cost 7D"},"total_tokens_7d":{"type":"integer","title":"Total Tokens 7D"},"projected_monthly":{"type":"number","title":"Projected Monthly"},"providers":{"items":{"$ref":"#/components/schemas/TokenCostProviderEntry"},"type":"array","title":"Providers"}},"type":"object","required":["total_cost_7d","total_tokens_7d","projected_monthly","providers"],"title":"AnalyticsTokenCostResponse"},"AnalyticsUsageDetail":{"properties":{"api_calls":{"type":"integer","title":"Api Calls"},"data_processed_gb":{"type":"number","title":"Data Processed Gb"},"active_users":{"type":"integer","title":"Active Users"},"collections_count":{"type":"integer","title":"Collections Count"}},"type":"object","required":["api_calls","data_processed_gb","active_users","collections_count"],"title":"AnalyticsUsageDetail"},"AnalyzeDatabaseResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"operation":{"type":"string","title":"Operation"},"started_at":{"type":"string","title":"Started At"},"completed_at":{"type":"string","title":"Completed At"},"duration_seconds":{"type":"number","title":"Duration Seconds"},"tables_processed":{"type":"integer","title":"Tables Processed"},"tables_failed":{"type":"integer","title":"Tables Failed"},"results":{"items":{"$ref":"#/components/schemas/MaintenanceTableResult"},"type":"array","title":"Results"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","operation","started_at","completed_at","duration_seconds","tables_processed","tables_failed","results","message"],"title":"AnalyzeDatabaseResponse"},"AnalyzeGitRepositoryResponse":{"properties":{"status":{"type":"string","title":"Status","description":"completed | error"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"analysis_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Analysis Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"repository_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repository Path"},"commit_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Commit Count"},"branch_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Branch Count"},"developer_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Developer Count"},"file_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Count"}},"type":"object","required":["status"],"title":"AnalyzeGitRepositoryResponse","description":"Response for POST /git/analyze (GitContextProvider.analyze_repository)."},"AnnotationCreate":{"properties":{"timestamp":{"type":"integer","minimum":0,"title":"Timestamp","description":"Timestamp in seconds"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Annotation title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Annotation description"},"annotation_type":{"type":"string","title":"Annotation Type","description":"Annotation type (info, feature, bug-fix, demo)"},"url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Url","description":"Optional URL for external resources"}},"type":"object","required":["timestamp","title","annotation_type"],"title":"AnnotationCreate","description":"Annotation creation request"},"AnnotationResponse":{"properties":{"timestamp":{"type":"integer","minimum":0,"title":"Timestamp","description":"Timestamp in seconds"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Annotation title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Annotation description"},"annotation_type":{"type":"string","title":"Annotation Type","description":"Annotation type (info, feature, bug-fix, demo)"},"url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Url","description":"Optional URL for external resources"},"annotation_id":{"type":"string","format":"uuid","title":"Annotation Id"},"video_id":{"type":"string","format":"uuid","title":"Video Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["timestamp","title","annotation_type","annotation_id","video_id","created_at","updated_at"],"title":"AnnotationResponse","description":"Annotation response"},"AnnotationUpdate":{"properties":{"timestamp":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Timestamp"},"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"annotation_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Annotation Type"},"url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Url"}},"type":"object","title":"AnnotationUpdate","description":"Annotation update request"},"AnswerRequest":{"properties":{"question_id":{"type":"string","title":"Question Id"},"value":{"title":"Value"}},"type":"object","required":["question_id","value"],"title":"AnswerRequest"},"AnthropicComputerUseResultContent":{"properties":{"type":{"type":"string","const":"computer_use_result","title":"Type","default":"computer_use_result"},"tool_use_id":{"type":"string","title":"Tool Use Id"},"content":{"anyOf":[{"type":"string"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"}],"title":"Content","default":""},"is_error":{"type":"boolean","title":"Is Error","default":false}},"additionalProperties":true,"type":"object","required":["tool_use_id"],"title":"AnthropicComputerUseResultContent","description":"Computer use result content block — Refs #3122 (computer-use-2024-10-22 beta).\n\nReturned by the model when a computer_use tool call completes.\nContent is a list of screenshot/output blocks."},"AnthropicImageContent":{"properties":{"type":{"type":"string","const":"image","title":"Type","default":"image"},"source":{"$ref":"#/components/schemas/AnthropicImageSource"}},"type":"object","required":["source"],"title":"AnthropicImageContent","description":"Image content block in a message."},"AnthropicImageSource":{"properties":{"type":{"type":"string","const":"base64","title":"Type","default":"base64"},"media_type":{"type":"string","title":"Media Type"},"data":{"type":"string","title":"Data"}},"type":"object","required":["media_type","data"],"title":"AnthropicImageSource","description":"Image source for image content blocks."},"AnthropicMessage":{"properties":{"role":{"type":"string","enum":["user","assistant"],"title":"Role"},"content":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"$ref":"#/components/schemas/AnthropicTextContent"},{"$ref":"#/components/schemas/AnthropicImageContent"},{"$ref":"#/components/schemas/AnthropicToolUseContent"},{"$ref":"#/components/schemas/AnthropicToolResultContent"},{"$ref":"#/components/schemas/AnthropicComputerUseResultContent"}]},"type":"array"}],"title":"Content"}},"additionalProperties":true,"type":"object","required":["role","content"],"title":"AnthropicMessage","description":"A message in the conversation."},"AnthropicMessagesRequest":{"properties":{"model":{"type":"string","title":"Model"},"max_tokens":{"type":"integer","title":"Max Tokens"},"messages":{"items":{"$ref":"#/components/schemas/AnthropicMessage"},"type":"array","title":"Messages"},"system":{"anyOf":[{"type":"string"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"System"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature"},"top_p":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Top P"},"top_k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Top K"},"stop_sequences":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stop Sequences"},"stream":{"type":"boolean","title":"Stream","default":false},"tools":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tools"},"tool_choice":{"anyOf":[{"$ref":"#/components/schemas/AnthropicToolChoiceAuto"},{"$ref":"#/components/schemas/AnthropicToolChoiceAny"},{"$ref":"#/components/schemas/AnthropicToolChoiceTool"},{"type":"null"}],"title":"Tool Choice"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"thinking":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Thinking"},"context_management":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context Management"},"anthropic_beta":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Anthropic Beta"}},"additionalProperties":true,"type":"object","required":["model","max_tokens","messages"],"title":"AnthropicMessagesRequest","description":"Request body for POST /v1/messages.\n\nMatches the Anthropic Messages API specification.\nextra = \"allow\" so beta tool types (computer_use, etc.) pass through\nto Anthropic without being silently dropped. Refs #3122."},"AnthropicTextContent":{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"},"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"AnthropicTextContent","description":"Text content block in a message."},"AnthropicToolChoiceAny":{"properties":{"type":{"type":"string","const":"any","title":"Type","default":"any"}},"type":"object","title":"AnthropicToolChoiceAny","description":"Any tool choice (force tool use)."},"AnthropicToolChoiceAuto":{"properties":{"type":{"type":"string","const":"auto","title":"Type","default":"auto"}},"type":"object","title":"AnthropicToolChoiceAuto","description":"Auto tool choice."},"AnthropicToolChoiceTool":{"properties":{"type":{"type":"string","const":"tool","title":"Type","default":"tool"},"name":{"type":"string","title":"Name"}},"type":"object","required":["name"],"title":"AnthropicToolChoiceTool","description":"Specific tool choice."},"AnthropicToolResultContent":{"properties":{"type":{"type":"string","const":"tool_result","title":"Type","default":"tool_result"},"tool_use_id":{"type":"string","title":"Tool Use Id"},"content":{"anyOf":[{"type":"string"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"}],"title":"Content","default":""},"is_error":{"type":"boolean","title":"Is Error","default":false}},"type":"object","required":["tool_use_id"],"title":"AnthropicToolResultContent","description":"Tool result content block (user providing tool output)."},"AnthropicToolUseContent":{"properties":{"type":{"type":"string","const":"tool_use","title":"Type","default":"tool_use"},"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"input":{"additionalProperties":true,"type":"object","title":"Input"}},"type":"object","required":["id","name","input"],"title":"AnthropicToolUseContent","description":"Tool use content block (assistant requesting tool call)."},"ApiKeysCountData":{"properties":{"active_api_keys":{"type":"integer","title":"Active Api Keys"},"user_email":{"type":"string","title":"User Email"}},"type":"object","required":["active_api_keys","user_email"],"title":"ApiKeysCountData"},"ApiKeysCountResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ApiKeysCountData"}},"type":"object","required":["success","data"],"title":"ApiKeysCountResponse","description":"GET /credits/api-keys/count"},"ApiToggleResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"project_id":{"type":"string","title":"Project Id"},"api_name":{"type":"string","title":"Api Name"},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["project_id","api_name","enabled"],"title":"ApiToggleResponse","description":"Response model shared by the enable and disable routes — Refs #8449.\n\nBoth return `{\"success\": True, **toggle_api(...)}`, an identical 4-key\nbody, so one model is correct for both. `success` is always True on the\n2xx path; the failure path raises HTTP 400 instead of returning False."},"AppCacheConfiguration":{"properties":{"default_ttl":{"type":"integer","title":"Default Ttl"},"max_memory_mb":{"type":"integer","title":"Max Memory Mb"},"circuit_breaker_enabled":{"type":"boolean","title":"Circuit Breaker Enabled"},"local_fallback_enabled":{"type":"boolean","title":"Local Fallback Enabled"}},"type":"object","required":["default_ttl","max_memory_mb","circuit_breaker_enabled","local_fallback_enabled"],"title":"AppCacheConfiguration"},"AppCacheMemoryUsage":{"properties":{"current_size":{"type":"integer","title":"Current Size"},"max_size":{"type":"integer","title":"Max Size"},"utilization":{"type":"number","title":"Utilization"},"entry_count":{"type":"integer","title":"Entry Count"}},"type":"object","required":["current_size","max_size","utilization","entry_count"],"title":"AppCacheMemoryUsage"},"AppCacheMetricsDetail":{"properties":{"total_gets":{"type":"integer","title":"Total Gets"},"total_sets":{"type":"integer","title":"Total Sets"},"total_deletes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Deletes"},"cache_hits":{"type":"integer","title":"Cache Hits"},"cache_misses":{"type":"integer","title":"Cache Misses"},"hit_ratio":{"type":"number","title":"Hit Ratio"},"error_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Error Count"},"circuit_breaker_trips":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Circuit Breaker Trips"}},"type":"object","required":["total_gets","total_sets","cache_hits","cache_misses","hit_ratio"],"title":"AppCacheMetricsDetail"},"AppCachePerformance":{"properties":{"average_get_time":{"type":"number","title":"Average Get Time"},"average_set_time":{"type":"number","title":"Average Set Time"},"95th_percentile_get":{"type":"number","title":"95Th Percentile Get"},"95th_percentile_set":{"type":"number","title":"95Th Percentile Set"}},"type":"object","required":["average_get_time","average_set_time","95th_percentile_get","95th_percentile_set"],"title":"AppCachePerformance"},"AppendMessageRequest":{"properties":{"role":{"type":"string","pattern":"^(user|assistant|system|tool)$","title":"Role"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"tool_calls":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tool Calls"},"tool_call_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Call Id"}},"type":"object","required":["role"],"title":"AppendMessageRequest"},"ApplicationCacheMetrics":{"properties":{"status":{"type":"string","title":"Status"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"cache_service":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cache Service"},"configuration":{"anyOf":[{"$ref":"#/components/schemas/AppCacheConfiguration"},{"type":"null"}]},"metrics":{"$ref":"#/components/schemas/AppCacheMetricsDetail"},"memory_usage":{"anyOf":[{"$ref":"#/components/schemas/AppCacheMemoryUsage"},{"type":"null"}]},"performance":{"anyOf":[{"$ref":"#/components/schemas/AppCachePerformance"},{"type":"null"}]}},"type":"object","required":["status","metrics"],"title":"ApplicationCacheMetrics","description":"Two real shapes: active (full detail) and error (mock fallback)."},"ApplicationConfig":{"properties":{"cache_service":{"type":"string","title":"Cache Service"},"local_cache_enabled":{"type":"boolean","title":"Local Cache Enabled"},"circuit_breaker_enabled":{"type":"boolean","title":"Circuit Breaker Enabled"},"compression_enabled":{"type":"boolean","title":"Compression Enabled"},"serialization":{"type":"string","title":"Serialization"}},"type":"object","required":["cache_service","local_cache_enabled","circuit_breaker_enabled","compression_enabled","serialization"],"title":"ApplicationConfig"},"ApplicationGenerationHealthResponse":{"properties":{"status":{"type":"string","title":"Status","description":"'healthy' or 'unhealthy'"},"timestamp":{"type":"string","title":"Timestamp"},"agents":{"anyOf":[{"$ref":"#/components/schemas/AgentSwarmHealth"},{"type":"null"}]},"workflows":{"anyOf":[{"$ref":"#/components/schemas/WorkflowSwarmHealth"},{"type":"null"}]},"system_info":{"anyOf":[{"$ref":"#/components/schemas/SystemInfo"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present only when status is 'unhealthy'"}},"type":"object","required":["status","timestamp"],"title":"ApplicationGenerationHealthResponse","description":"Response model for GET /health. On failure, only status/timestamp/error are populated."},"ApplicationGenerationRequest":{"properties":{"prompt":{"type":"string","minLength":10,"title":"Prompt","description":"Natural language description of the desired application"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"Optional configuration overrides"}},"type":"object","required":["prompt"],"title":"ApplicationGenerationRequest","description":"Request model for application generation","example":{"config":{"budget_constraints":{"monthly":500,"setup":1000},"deployment_target":"kubernetes","technology_preferences":{"backend_framework":"fastapi","database":"postgresql","frontend_framework":"react"}},"prompt":"Create a task management web application with user authentication, project management, and real-time collaboration features"}},"ApplicationGenerationResponse":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id","description":"Unique identifier for tracking workflow progress"},"status":{"type":"string","title":"Status","description":"Initial workflow status"},"message":{"type":"string","title":"Message","description":"Success message"},"estimated_completion_time":{"type":"string","title":"Estimated Completion Time","description":"Estimated completion time"}},"type":"object","required":["workflow_id","status","message","estimated_completion_time"],"title":"ApplicationGenerationResponse","description":"Response model for application generation","example":{"estimated_completion_time":"15-30 minutes","message":"Application generation workflow started successfully","status":"pending","workflow_id":"wf_12345678-1234-1234-1234-123456789012"}},"ApplicationMetrics":{"properties":{"response_time_avg":{"type":"number","title":"Response Time Avg"},"response_time_p95":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time P95"},"requests_per_second":{"type":"number","title":"Requests Per Second"},"error_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Error Rate"},"active_connections":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Connections"},"total_requests":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Requests"},"error_requests":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Error Requests"},"rps_window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rps Window"},"data_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Source"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["response_time_avg","requests_per_second"],"title":"ApplicationMetrics","description":"REAL -- read from the live Prometheus registry (Refs #8270)."},"ApplicationMetricsTimeseries":{"properties":{"response_time":{"$ref":"#/components/schemas/MetricTimeSeries"},"requests_per_second":{"$ref":"#/components/schemas/MetricTimeSeries"},"error_rate":{"$ref":"#/components/schemas/MetricTimeSeries"}},"type":"object","required":["response_time","requests_per_second","error_rate"],"title":"ApplicationMetricsTimeseries"},"ApplyInferredOntologyResponse":{"properties":{"version":{"type":"string","title":"Version"},"entity_types_count":{"type":"integer","title":"Entity Types Count"},"predicates_count":{"type":"integer","title":"Predicates Count"},"reclassified_entities":{"type":"integer","title":"Reclassified Entities"}},"additionalProperties":true,"type":"object","required":["version","entity_types_count","predicates_count","reclassified_entities"],"title":"ApplyInferredOntologyResponse","description":"Response for POST /memory/v2/graph/ontology/apply.\n\n``version`` is a stringified UUID4, not an integer counter — unlike the\n``version: int`` on OntologyGetResponse/OntologyUpsertResponse."},"ApplyTemplateResponse":{"properties":{"template":{"type":"string","title":"Template"},"project_id":{"type":"string","title":"Project Id"},"entity_types_created":{"items":{"type":"string"},"type":"array","title":"Entity Types Created"},"seed_entities_created":{"items":{"$ref":"#/components/schemas/SeededEntity"},"type":"array","title":"Seed Entities Created"},"total_types":{"type":"integer","title":"Total Types"},"total_seeds":{"type":"integer","title":"Total Seeds"}},"additionalProperties":true,"type":"object","required":["template","project_id","total_types","total_seeds"],"title":"ApplyTemplateResponse","description":"Response for POST /memory/v2/graph/templates/{template_name}/apply."},"ApprovalDecision":{"properties":{"decision":{"type":"string","enum":["approve","deny"],"title":"Decision","description":"Decision to take on this approval request"}},"type":"object","required":["decision"],"title":"ApprovalDecision"},"ApprovalDecisionResponse":{"properties":{"approval_id":{"type":"string","title":"Approval Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["approval_id","status"],"title":"ApprovalDecisionResponse"},"ApprovalGatesEvidence":{"properties":{"requests_created":{"type":"integer","title":"Requests Created"},"approved":{"type":"integer","title":"Approved"},"rejected":{"type":"integer","title":"Rejected"}},"type":"object","required":["requests_created","approved","rejected"],"title":"ApprovalGatesEvidence"},"ApprovalHistoryResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"history":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_approvals__ApprovalRequestItem"},"type":"array","title":"History"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["agent_id","history","count"],"title":"ApprovalHistoryResponse"},"ApprovalListResponse":{"properties":{"pending":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__approvals__ApprovalRequestItem"},"type":"array","title":"Pending"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["pending","count"],"title":"ApprovalListResponse"},"ApprovalRecord":{"properties":{"id":{"type":"string","title":"Id"},"run_id":{"type":"string","title":"Run Id"},"agent_id":{"type":"string","title":"Agent Id"},"decision_context":{"title":"Decision Context"},"status":{"type":"string","title":"Status"},"approver_ref":{"type":"string","title":"Approver Ref"},"decided_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decided By"},"decision_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decision Note"},"ttl_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ttl At"},"decided_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decided At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","run_id","agent_id","status","approver_ref"],"title":"ApprovalRecord"},"ApprovalRequestCreate":{"properties":{"action":{"type":"string","maxLength":255,"minLength":1,"title":"Action","description":"Machine-readable action identifier, e.g. 'bash_egress'"},"description":{"type":"string","maxLength":2000,"minLength":1,"title":"Description","description":"Human-readable description of what will happen"},"risk_level":{"type":"string","title":"Risk Level","description":"One of: low, medium, high, critical"}},"type":"object","required":["action","description","risk_level"],"title":"ApprovalRequestCreate"},"ApprovalRequestCreateResponse":{"properties":{"approval_id":{"type":"string","title":"Approval Id"},"status":{"type":"string","title":"Status"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["approval_id","status","expires_at"],"title":"ApprovalRequestCreateResponse"},"ArtifactCreateResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"artifact":{"$ref":"#/components/schemas/app__api__v1__endpoints__artifacts__ArtifactResponse"}},"type":"object","required":["artifact"],"title":"ArtifactCreateResponse","description":"POST /artifacts envelope."},"ArtifactDeleteResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"deleted":{"type":"boolean","title":"Deleted"}},"type":"object","required":["deleted"],"title":"ArtifactDeleteResponse","description":"DELETE /artifacts/{id} envelope."},"ArtifactDetailResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"artifact":{"$ref":"#/components/schemas/ArtifactMetadata"}},"type":"object","required":["artifact"],"title":"ArtifactDetailResponse","description":"GET /artifacts/{id} envelope."},"ArtifactDiff":{"properties":{"added":{"items":{},"type":"array","title":"Added"},"removed":{"items":{},"type":"array","title":"Removed"},"modified":{"items":{},"type":"array","title":"Modified"}},"type":"object","title":"ArtifactDiff"},"ArtifactListResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"artifacts":{"items":{"$ref":"#/components/schemas/ArtifactSummary"},"type":"array","title":"Artifacts"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"}},"type":"object","required":["artifacts","total","page"],"title":"ArtifactListResponse","description":"GET /artifacts envelope. Note there is no `per_page` field: per_page is\na query parameter but list_artifacts() returns only artifacts/total/page."},"ArtifactMetadata":{"properties":{"id":{"type":"string","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"url":{"type":"string","title":"Url"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"visibility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visibility"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"view_count":{"type":"integer","title":"View Count","default":0},"short_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Code"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"}},"additionalProperties":true,"type":"object","required":["id","url"],"title":"ArtifactMetadata","description":"GET /artifacts/{id} payload — get_artifact_metadata(), which is scoped\nby `user_id = :user_id` in SQL, so only the owner ever sees it."},"ArtifactPutRequest":{"properties":{"content":{"additionalProperties":true,"type":"object","title":"Content","description":"Artifact payload (PRD body, data-model schema, or backlog stories)"}},"type":"object","required":["content"],"title":"ArtifactPutRequest","description":"Body for PUT — arbitrary JSON artifact content.\n\nFor ``backlog`` the ``content`` object is expected to carry a ``stories``\nlist where each story may include ``acceptance_criteria`` in BDD\n(Given/When/Then) form; the store persists whatever shape is provided."},"ArtifactSummary":{"properties":{"id":{"type":"string","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"visibility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visibility"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"view_count":{"type":"integer","title":"View Count","default":0},"url":{"type":"string","title":"Url"}},"additionalProperties":true,"type":"object","required":["id","url"],"title":"ArtifactSummary","description":"One row of GET /artifacts. Deliberately narrower than\nArtifactMetadata: list_artifacts() omits short_code and language."},"AssignProjectRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID to assign to this workspace"}},"type":"object","required":["project_id"],"title":"AssignProjectRequest"},"AssistantAskRequest":{"properties":{"message":{"type":"string","minLength":1,"title":"Message"},"history":{"items":{"$ref":"#/components/schemas/ChatTurn"},"type":"array","title":"History"}},"type":"object","required":["message"],"title":"AssistantAskRequest"},"AssistantAskResponse":{"properties":{"reply":{"type":"string","title":"Reply"}},"type":"object","required":["reply"],"title":"AssistantAskResponse"},"AttemptsStatusResponse":{"properties":{"failed_attempts":{"type":"integer","title":"Failed Attempts","description":"Number of failed verification attempts"},"locked_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Locked Until","description":"Lockout expiration timestamp"},"is_locked":{"type":"boolean","title":"Is Locked","description":"Current lock status"}},"type":"object","required":["failed_attempts","is_locked"],"title":"AttemptsStatusResponse","description":"Response with failed attempts status","example":{"failed_attempts":2,"is_locked":false}},"AttendeeListResponse":{"properties":{"attendees":{"items":{"$ref":"#/components/schemas/AttendeeResponse"},"type":"array","title":"Attendees"},"total":{"type":"integer","title":"Total","description":"Total count of attendees"},"skip":{"type":"integer","title":"Skip","description":"Number of attendees skipped"},"limit":{"type":"integer","title":"Limit","description":"Max attendees per page"}},"type":"object","required":["attendees","total","skip","limit"],"title":"AttendeeListResponse","description":"Paginated attendee list response","example":{"attendees":[],"limit":50,"skip":0,"total":12}},"AttendeeResponse":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User ID"},"status":{"$ref":"#/components/schemas/RSVPStatusEnum","description":"RSVP status"},"response_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Message","description":"Response message"},"rsvp_created_at":{"type":"string","format":"date-time","title":"Rsvp Created At","description":"When RSVP was created"}},"type":"object","required":["user_id","status","rsvp_created_at"],"title":"AttendeeResponse","description":"Schema for attendee information in event attendee list","example":{"response_message":"Can't wait!","rsvp_created_at":"2026-01-20T10:00:00Z","status":"going","user_id":"789e4567-e89b-12d3-a456-426614174000"}},"AttributeRequest":{"properties":{"tool_id":{"type":"string","title":"Tool Id"},"developer_id":{"type":"string","title":"Developer Id"},"credits_consumed":{"type":"integer","minimum":0,"title":"Credits Consumed"},"markup_pct":{"type":"number","maximum":0.4,"minimum":0,"title":"Markup Pct"}},"type":"object","required":["tool_id","developer_id","credits_consumed","markup_pct"],"title":"AttributeRequest","description":"Request body for POST /browser/echo/attribute"},"AttributeResponse":{"properties":{"tool_id":{"type":"string","title":"Tool Id"},"developer_id":{"type":"string","title":"Developer Id"},"gross_credits":{"type":"integer","title":"Gross Credits"},"developer_markup_credits":{"type":"number","title":"Developer Markup Credits"},"platform_fee_credits":{"type":"number","title":"Platform Fee Credits"},"net_developer_earnings_credits":{"type":"number","title":"Net Developer Earnings Credits"},"ainative_base_credits":{"type":"number","title":"Ainative Base Credits"}},"type":"object","required":["tool_id","developer_id","gross_credits","developer_markup_credits","platform_fee_credits","net_developer_earnings_credits","ainative_base_credits"],"title":"AttributeResponse","description":"Full earnings attribution breakdown"},"AudienceDemographicsResponse":{"properties":{"geographic_breakdown":{"items":{"$ref":"#/components/schemas/GeographicBreakdownItem"},"type":"array","title":"Geographic Breakdown","description":"Top 10 countries by viewer count"},"viewer_type_breakdown":{"$ref":"#/components/schemas/ViewerTypeBreakdown","description":"Authenticated vs anonymous breakdown"},"avg_watch_time_minutes":{"type":"number","minimum":0,"title":"Avg Watch Time Minutes","description":"Average watch time per viewer in minutes"}},"type":"object","required":["geographic_breakdown","viewer_type_breakdown","avg_watch_time_minutes"],"title":"AudienceDemographicsResponse","description":"Audience demographic insights","example":{"avg_watch_time_minutes":42.5,"geographic_breakdown":[{"anonymous_viewers":181,"authenticated_viewers":342,"country_code":"US","percentage":36.5,"viewer_count":523}],"viewer_type_breakdown":{"anonymous_views":3210,"authenticated_views":5432,"unique_anonymous_sessions":1543,"unique_authenticated_users":892}}},"AuditActionType":{"type":"string","enum":["create","read","update","delete","login","logout"],"title":"AuditActionType","description":"Audit action type enumeration"},"AuditEventListEntry":{"properties":{"event_id":{"type":"string","title":"Event Id"},"event_type":{"type":"string","title":"Event Type"},"user_id":{"type":"string","title":"User Id"},"resource_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Id"},"action":{"type":"string","title":"Action"},"outcome":{"type":"string","title":"Outcome"},"timestamp":{"type":"string","title":"Timestamp"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"risk_score":{"type":"integer","title":"Risk Score"},"requires_investigation":{"type":"boolean","title":"Requires Investigation"},"security_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Classification"},"compliance_frameworks":{"items":{"type":"string"},"type":"array","title":"Compliance Frameworks"}},"type":"object","required":["event_id","event_type","user_id","action","outcome","timestamp","risk_score","requires_investigation","compliance_frameworks"],"title":"AuditEventListEntry"},"AuditEventRequest":{"properties":{"event_type":{"type":"string","title":"Event Type","description":"Type of audit event"},"action":{"type":"string","title":"Action","description":"Action performed"},"outcome":{"type":"string","title":"Outcome","description":"Outcome (success, failure, warning)"},"resource_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Id","description":"Resource ID"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Session ID"},"security_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Classification","description":"Security classification"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"}},"type":"object","required":["event_type","action","outcome"],"title":"AuditEventRequest","description":"Request to log audit event"},"AuditEventTypeEntry":{"properties":{"type":{"type":"string","title":"Type"},"description":{"type":"string","title":"Description"}},"type":"object","required":["type","description"],"title":"AuditEventTypeEntry"},"AuditHourlyBucket":{"properties":{"hour":{"type":"integer","title":"Hour"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["hour","count"],"title":"AuditHourlyBucket"},"AuditLogEvidence":{"properties":{"total_tool_calls":{"type":"integer","title":"Total Tool Calls"},"high_risk_calls":{"type":"integer","title":"High Risk Calls"}},"type":"object","required":["total_tool_calls","high_risk_calls"],"title":"AuditLogEvidence"},"AuditLogFiltersApplied":{"properties":{"action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","title":"AuditLogFiltersApplied"},"AuditLogListResponse":{"properties":{"total":{"type":"integer","title":"Total"},"logs":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__audit_logs__AuditLogEntry"},"type":"array","title":"Logs"}},"type":"object","required":["total","logs"],"title":"AuditLogListResponse"},"AuditQueryResponse":{"properties":{"records":{"items":{"$ref":"#/components/schemas/AuditRecordResponse"},"type":"array","title":"Records"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["records","total","page","page_size"],"title":"AuditQueryResponse"},"AuditRecordResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"identity":{"type":"string","title":"Identity"},"capability":{"type":"string","title":"Capability"},"tool":{"type":"string","title":"Tool"},"decision":{"type":"string","title":"Decision"},"controls":{"items":{"type":"string"},"type":"array","title":"Controls","default":[]},"record_hash":{"type":"string","title":"Record Hash"},"prev_hash":{"type":"string","title":"Prev Hash"},"input_hash":{"type":"string","title":"Input Hash"},"output_hash":{"type":"string","title":"Output Hash"},"latency_ms":{"type":"number","title":"Latency Ms"},"approval_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approval Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","agent_id","identity","capability","tool","decision","record_hash","prev_hash","input_hash","output_hash","latency_ms"],"title":"AuditRecordResponse"},"AuditRequest":{"properties":{"url":{"type":"string","title":"Url","description":"URL to scan for agent-readiness","examples":["https://example.com"]}},"type":"object","required":["url"],"title":"AuditRequest"},"AuditResourceType":{"type":"string","enum":["user","organization","project","ai_model","subscription","api_key"],"title":"AuditResourceType","description":"Audit resource type enumeration"},"AuditResponse":{"properties":{"url":{"type":"string","title":"Url"},"score":{"type":"integer","title":"Score"},"max_score":{"type":"integer","title":"Max Score"},"grade":{"type":"string","title":"Grade"},"checks":{"items":{"$ref":"#/components/schemas/CheckResultResponse"},"type":"array","title":"Checks"},"scanned_at":{"type":"string","title":"Scanned At"},"full_report_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Report Url"}},"type":"object","required":["url","score","max_score","grade","checks","scanned_at"],"title":"AuditResponse"},"AuditRiskIndicators":{"properties":{"unusual_access_patterns":{"type":"integer","title":"Unusual Access Patterns"},"multiple_failed_logins":{"type":"integer","title":"Multiple Failed Logins"},"privilege_escalations":{"type":"integer","title":"Privilege Escalations"},"data_access_violations":{"type":"integer","title":"Data Access Violations"}},"type":"object","required":["unusual_access_patterns","multiple_failed_logins","privilege_escalations","data_access_violations"],"title":"AuditRiskIndicators"},"AuditTopAction":{"properties":{"action":{"type":"string","title":"Action"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["action","count"],"title":"AuditTopAction"},"AuditTopUser":{"properties":{"user_id":{"title":"User Id"},"username":{"type":"string","title":"Username"},"action_count":{"type":"integer","title":"Action Count"}},"type":"object","required":["user_id","username","action_count"],"title":"AuditTopUser"},"AuditTrailEntry":{"properties":{"transition":{"type":"string","title":"Transition"},"timestamp":{"type":"string","title":"Timestamp"},"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Id"},"actor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Name"}},"type":"object","required":["transition","timestamp"],"title":"AuditTrailEntry"},"AuditTrailResponse":{"properties":{"audit_trail":{"items":{"$ref":"#/components/schemas/AuditTrailEntry"},"type":"array","title":"Audit Trail"}},"type":"object","required":["audit_trail"],"title":"AuditTrailResponse"},"AuthProviderCreateRequest":{"properties":{"provider":{"$ref":"#/components/schemas/AuthProviderType","description":"Auth provider type"},"issuer_url":{"type":"string","maxLength":512,"minLength":1,"title":"Issuer Url","description":"OIDC issuer URL (e.g. https://my-tenant.auth0.com/)"},"client_id":{"type":"string","maxLength":256,"minLength":1,"title":"Client Id","description":"OAuth client ID from the provider"},"client_secret":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Client Secret","description":"OAuth client secret (stored encrypted, never returned in full)"},"display_name":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Display Name","description":"Human-readable name for this configuration"},"audience":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Audience","description":"Expected JWT audience claim"},"claim_mapping":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Claim Mapping","description":"Map provider JWT claims to internal fields (e.g. {'sub': 'user_id', 'email': 'email'})"},"rls_enabled":{"type":"boolean","title":"Rls Enabled","description":"Enable row-level security based on JWT claims","default":false},"rls_column":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Rls Column","description":"Column name used for RLS filtering (e.g. 'tenant_id')"},"provider_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Provider Config","description":"Provider-specific configuration (e.g. connection, organization settings)"}},"type":"object","required":["provider","issuer_url","client_id"],"title":"AuthProviderCreateRequest","description":"Request body for POST /api/v1/public/auth-providers/.\nCreates a new auth provider configuration.\n\nRefs #3863"},"AuthProviderResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"provider":{"type":"string","title":"Provider"},"issuer_url":{"type":"string","title":"Issuer Url"},"client_id":{"type":"string","title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Secret","description":"Redacted secret — only '***' prefix shown"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience"},"claim_mapping":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Claim Mapping"},"rls_enabled":{"type":"boolean","title":"Rls Enabled","default":false},"rls_column":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rls Column"},"provider_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Provider Config"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","user_id","provider","issuer_url","client_id"],"title":"AuthProviderResponse","description":"Response model for auth provider configurations.\nclient_secret is always redacted (prefix only).\n\nRefs #3863"},"AuthProviderTemplate":{"properties":{"provider":{"type":"string","title":"Provider"},"defaults":{"additionalProperties":true,"type":"object","title":"Defaults"},"description":{"type":"string","title":"Description"}},"type":"object","required":["provider","defaults","description"],"title":"AuthProviderTemplate","description":"Template with provider defaults for quick setup.\n\nRefs #3863"},"AuthProviderTestResult":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"jwks_key_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Jwks Key Count"},"issuer_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Issuer Verified"}},"type":"object","required":["success","message"],"title":"AuthProviderTestResult","description":"Result of testing an auth provider connection (JWKS fetch, issuer check).\n\nRefs #3863"},"AuthProviderType":{"type":"string","enum":["auth0","kinde","stytch","workos","clerk"],"title":"AuthProviderType"},"AuthProviderUpdateRequest":{"properties":{"provider":{"anyOf":[{"$ref":"#/components/schemas/AuthProviderType"},{"type":"null"}]},"issuer_url":{"anyOf":[{"type":"string","maxLength":512,"minLength":1},{"type":"null"}],"title":"Issuer Url"},"client_id":{"anyOf":[{"type":"string","maxLength":256,"minLength":1},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Client Secret"},"display_name":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Display Name"},"audience":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Audience"},"claim_mapping":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Claim Mapping"},"rls_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Rls Enabled"},"rls_column":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Rls Column"},"provider_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Provider Config"}},"type":"object","title":"AuthProviderUpdateRequest","description":"Request body for PUT /api/v1/public/auth-providers/{provider_id}.\nAll fields are optional — only provided fields are updated.\n\nRefs #3863"},"AuthProviderVerifyRequest":{"properties":{"token":{"type":"string","minLength":1,"title":"Token","description":"JWT token to verify against the provider's JWKS"}},"type":"object","required":["token"],"title":"AuthProviderVerifyRequest","description":"Request body for POST /api/v1/public/auth-providers/{provider_id}/verify.\nVerifies a JWT token against the provider's JWKS.\n\nRefs #3863"},"AuthProviderVerifyResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"claims":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Claims"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","required":["valid"],"title":"AuthProviderVerifyResponse","description":"Response from JWT verification.\n\nRefs #3863"},"AuthorContribution":{"properties":{"name":{"type":"string","title":"Name"},"files_changed":{"type":"integer","title":"Files Changed"},"total_changes":{"type":"integer","title":"Total Changes"}},"type":"object","required":["name","files_changed","total_changes"],"title":"AuthorContribution"},"AuthorizeResponse":{"properties":{"authorize_url":{"type":"string","title":"Authorize Url"}},"type":"object","required":["authorize_url"],"title":"AuthorizeResponse"},"AutoCommitResponse":{"properties":{"status":{"type":"string","title":"Status"},"auto_commit_result":{"additionalProperties":true,"type":"object","title":"Auto Commit Result"},"action":{"type":"string","title":"Action"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","auto_commit_result","action","timestamp"],"title":"AutoCommitResponse","description":"Response for POST /git-integration/auto-commit."},"AutoPayoutSettings":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"schedule":{"type":"string","title":"Schedule"},"threshold":{"type":"integer","title":"Threshold"},"delay_days":{"type":"integer","title":"Delay Days"}},"type":"object","required":["enabled","schedule","threshold","delay_days"],"title":"AutoPayoutSettings","description":"Auto-payout configuration"},"AutoRefillSettings":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"threshold":{"type":"integer","title":"Threshold"},"amount":{"type":"integer","title":"Amount"},"payment_method_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method Id"}},"type":"object","required":["enabled","threshold","amount"],"title":"AutoRefillSettings"},"AutoRefillSettingsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/AutoRefillSettings"}},"type":"object","required":["success","data"],"title":"AutoRefillSettingsResponse","description":"GET /credits/auto-refill-settings"},"AutoRefillSettingsUpdateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/AutoRefillSettings"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["success","data"],"title":"AutoRefillSettingsUpdateResponse","description":"PUT /credits/auto-refill-settings"},"AutoReloadCheckResponse":{"properties":{"auto_reload_triggered":{"type":"boolean","title":"Auto Reload Triggered","description":"Whether a reload was actually performed"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Why no reload happened; absent when one did"},"reload_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reload Amount","description":"Credits added; present only when triggered"},"payment_intent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Intent Id","description":"Stripe payment intent; present only when triggered"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Service failure detail; absent on normal outcomes"}},"type":"object","required":["auto_reload_triggered"],"title":"AutoReloadCheckResponse","description":"Result of an auto-reload check (Refs #8449, #539).\n\nThis route has THREE mutually-exclusive key sets, so the route declares\n`response_model_exclude_unset=True` and every branch-specific field is\nOptional:\n\n not enabled / above threshold\n {auto_reload_triggered: false, reason}\n triggered\n {auto_reload_triggered: true, reload_amount, payment_intent_id}\n service error\n {auto_reload_triggered: false, error}\n\nexclude_unset is REQUIRED here, not decorative: without it this model\nwould start emitting `reason: null`, `error: null`, `reload_amount: null`\nand `payment_intent_id: null` on every branch — four keys this route has\nnever sent. (Contrast the other #8449 routes, where exclude_unset was\neither a wire regression or simply unnecessary; it is per-route.)"},"AutoSnapshotConfigDetails":{"properties":{"trigger_type":{"type":"string","title":"Trigger Type"},"trigger_config":{"additionalProperties":true,"type":"object","title":"Trigger Config"},"retention_days":{"type":"integer","title":"Retention Days"}},"type":"object","required":["trigger_type","retention_days"],"title":"AutoSnapshotConfigDetails"},"AutoSnapshotConfigRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"ID of the project"},"project_path":{"type":"string","title":"Project Path","description":"Path to the project directory"},"trigger_type":{"type":"string","title":"Trigger Type","description":"Type of trigger (git, time, test)"},"trigger_config":{"additionalProperties":true,"type":"object","title":"Trigger Config","description":"Configuration for the trigger"},"retention_days":{"type":"integer","title":"Retention Days","description":"Number of days to retain snapshots","default":7}},"type":"object","required":["project_id","project_path","trigger_type","trigger_config"],"title":"AutoSnapshotConfigRequest"},"AutomationRule":{"properties":{"rule_id":{"type":"string","title":"Rule Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"trigger":{"type":"string","title":"Trigger"},"schedule":{"type":"string","title":"Schedule"},"action":{"type":"string","title":"Action"},"status":{"type":"string","title":"Status"},"last_run":{"type":"string","title":"Last Run"},"next_run":{"type":"string","title":"Next Run"}},"type":"object","required":["rule_id","name","description","trigger","schedule","action","status","last_run","next_run"],"title":"AutomationRule"},"AutomationRulesResponse":{"properties":{"rules":{"items":{"$ref":"#/components/schemas/AutomationRule"},"type":"array","title":"Rules"},"automation_stats":{"$ref":"#/components/schemas/AutomationStats"}},"type":"object","required":["rules","automation_stats"],"title":"AutomationRulesResponse","description":"Response for GET /wordpress-agent/automation-rules."},"AutomationStats":{"properties":{"total_rules":{"type":"integer","title":"Total Rules"},"active_rules":{"type":"integer","title":"Active Rules"},"executions_today":{"type":"integer","title":"Executions Today"},"success_rate":{"type":"number","title":"Success Rate"}},"type":"object","required":["total_rules","active_rules","executions_today","success_rate"],"title":"AutomationStats"},"AutoscaleCheckRequest":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id","description":"Deployment UUID"},"queue_depth":{"type":"integer","minimum":0,"title":"Queue Depth","description":"Current request queue depth"},"avg_latency_ms":{"type":"number","minimum":0,"title":"Avg Latency Ms","description":"Average inference latency in ms"}},"type":"object","required":["deployment_id","queue_depth","avg_latency_ms"],"title":"AutoscaleCheckRequest"},"AutoscaleCheckResponse":{"properties":{"action":{"type":"string","title":"Action","description":"scale_up, scale_down, scale_to_zero, or no_action"},"new_replicas":{"type":"integer","title":"New Replicas","description":"Resulting replica count"}},"type":"object","required":["action","new_replicas"],"title":"AutoscaleCheckResponse"},"AutoscalingConfiguration":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"strategy":{"type":"string","title":"Strategy"},"min_instances":{"type":"integer","title":"Min Instances"},"max_instances":{"type":"integer","title":"Max Instances"},"desired_instances":{"type":"integer","title":"Desired Instances"},"current_instances":{"type":"integer","title":"Current Instances"},"scaling_cooldown":{"type":"integer","title":"Scaling Cooldown"},"scale_up_threshold":{"$ref":"#/components/schemas/ScaleThreshold"},"scale_down_threshold":{"$ref":"#/components/schemas/ScaleThreshold"},"scaling_policies":{"items":{"$ref":"#/components/schemas/ScalingPolicySummary"},"type":"array","title":"Scaling Policies"},"recent_scaling_events":{"items":{"$ref":"#/components/schemas/RecentScalingEvent"},"type":"array","title":"Recent Scaling Events"}},"type":"object","required":["enabled","strategy","min_instances","max_instances","desired_instances","current_instances","scaling_cooldown","scale_up_threshold","scale_down_threshold","scaling_policies","recent_scaling_events"],"title":"AutoscalingConfiguration"},"AvailableAgentTypesResponse":{"properties":{"agent_types":{"items":{"$ref":"#/components/schemas/AgentTypeEntry"},"type":"array","title":"Agent Types"}},"type":"object","required":["agent_types"],"title":"AvailableAgentTypesResponse"},"AvailableToolsResponse":{"properties":{"tools":{"items":{"$ref":"#/components/schemas/ToolStatus"},"type":"array","title":"Tools"},"total_tools":{"type":"integer","title":"Total Tools"},"installed_tools":{"type":"integer","title":"Installed Tools"}},"type":"object","required":["tools","total_tools","installed_tools"],"title":"AvailableToolsResponse","description":"Response for GET /scaffolding-tools/tools."},"AvatarGenerateRequest":{"properties":{"twin_id":{"type":"string","title":"Twin Id"},"script":{"type":"string","minLength":1,"title":"Script"},"voice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Id"},"background":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Background"},"quality":{"type":"string","pattern":"^(standard|hd)$","title":"Quality","default":"standard"}},"type":"object","required":["twin_id","script"],"title":"AvatarGenerateRequest"},"AvatarGenerateResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"celery_task_id":{"type":"string","title":"Celery Task Id"},"provider":{"type":"string","title":"Provider"},"status":{"type":"string","title":"Status"},"progress":{"type":"integer","title":"Progress"},"estimated_seconds":{"type":"integer","title":"Estimated Seconds"}},"type":"object","required":["task_id","celery_task_id","provider","status","progress","estimated_seconds"],"title":"AvatarGenerateResponse"},"AvatarStatusResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"},"progress":{"type":"integer","title":"Progress"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["task_id","status","progress"],"title":"AvatarStatusResponse"},"AvatarUploadResponse":{"properties":{"avatar_url":{"type":"string","title":"Avatar Url","description":"Public URL of the stored 256x256 avatar"}},"type":"object","required":["avatar_url"],"title":"AvatarUploadResponse","description":"Avatar upload acknowledgement (POST /streams/me/profile/avatar).\n\nStrict: the upload is always scoped to the authenticated caller and the\nonly thing the client needs back is the resulting CDN URL.","example":{"avatar_url":"https://cdn.ainative.studio/avatars/abc.png"}},"BYOMModelListResponse":{"properties":{"models":{"items":{"$ref":"#/components/schemas/BYOMModelResponse"},"type":"array","title":"Models"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["models","count"],"title":"BYOMModelListResponse"},"BYOMModelResponse":{"properties":{"model_id":{"type":"string","title":"Model Id"},"user_id":{"type":"string","title":"User Id"},"name":{"type":"string","title":"Name"},"format":{"type":"string","title":"Format"},"base_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Model"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"filename":{"type":"string","title":"Filename"},"file_size_bytes":{"type":"integer","title":"File Size Bytes"},"status":{"type":"string","title":"Status"},"storage_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Storage Url"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["model_id","user_id","name","format","filename","file_size_bytes","status"],"title":"BYOMModelResponse"},"BackupCodeVerifyRequest":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User UUID"},"backup_code":{"type":"string","maxLength":10,"minLength":10,"title":"Backup Code","description":"Backup code (10 characters)"}},"type":"object","required":["user_id","backup_code"],"title":"BackupCodeVerifyRequest","description":"Request to verify backup code","example":{"backup_code":"A1B2C3D4E5","user_id":"123e4567-e89b-12d3-a456-426614174000"}},"BackupCodeVerifyResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Verification success status"},"message":{"type":"string","title":"Message","description":"Result message"},"remaining_codes":{"type":"integer","title":"Remaining Codes","description":"Number of backup codes remaining"}},"type":"object","required":["success","message","remaining_codes"],"title":"BackupCodeVerifyResponse","description":"Response after verifying backup code","example":{"message":"Backup code verified successfully","remaining_codes":7,"success":true}},"BackupCodesGenerateRequest":{"properties":{"current_code":{"type":"string","maxLength":6,"minLength":6,"title":"Current Code","description":"Current 2FA verification code"}},"type":"object","required":["current_code"],"title":"BackupCodesGenerateRequest","description":"Request to generate new backup codes","example":{"current_code":"123456"}},"BackupCodesGenerateResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Generation success status"},"message":{"type":"string","title":"Message","description":"Result message"},"backup_codes":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":10,"title":"Backup Codes","description":"10 new backup codes"}},"type":"object","required":["success","message","backup_codes"],"title":"BackupCodesGenerateResponse","description":"Response with new backup codes","example":{"backup_codes":["A1B2C3D4E5","F6G7H8I9J0","K1L2M3N4O5","P6Q7R8S9T0","U1V2W3X4Y5","Z6A7B8C9D0","E1F2G3H4I5","J6K7L8M9N0","O1P2Q3R4S5","T6U7V8W9X0"],"message":"New backup codes generated successfully","success":true}},"BackupCodesStatusResponse":{"properties":{"count":{"type":"integer","title":"Count","description":"Number of backup codes remaining"},"last_generated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Generated","description":"When codes were last generated"}},"type":"object","required":["count"],"title":"BackupCodesStatusResponse","description":"Response with backup codes status","example":{"count":8,"last_generated":"2024-01-15T10:00:00Z"}},"BackupListEntry":{"properties":{"backup_id":{"type":"string","title":"Backup Id"},"type":{"type":"string","title":"Type"},"description":{"type":"string","title":"Description"},"created_at":{"type":"string","title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"size_mb":{"type":"number","title":"Size Mb"},"components":{"items":{"type":"string"},"type":"array","title":"Components"},"status":{"type":"string","title":"Status"}},"type":"object","required":["backup_id","type","description","created_at","size_mb","components","status"],"title":"BackupListEntry"},"BackupScheduleStatus":{"properties":{"daily_backup":{"$ref":"#/components/schemas/DailyBackupSchedule"},"weekly_backup":{"$ref":"#/components/schemas/WeeklyBackupSchedule"},"monthly_backup":{"$ref":"#/components/schemas/MonthlyBackupSchedule"}},"type":"object","required":["daily_backup","weekly_backup","monthly_backup"],"title":"BackupScheduleStatus"},"BackupStatusOverview":{"properties":{"recent_backups":{"items":{"$ref":"#/components/schemas/RecentBackupEntry"},"type":"array","title":"Recent Backups"},"health_score":{"type":"integer","title":"Health Score"},"last_successful_backup":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Successful Backup"},"next_scheduled_backup":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Scheduled Backup"},"backup_retention_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Backup Retention Days"},"total_backups":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Backups"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["recent_backups","health_score"],"title":"BackupStatusOverview","description":"Two real shapes: happy path, and the except-fallback (fewer\nkeys, includes `error`) when the backup-directory scan fails."},"BackupStorageHealth":{"properties":{"used_gb":{"type":"number","title":"Used Gb"},"status":{"type":"string","title":"Status"}},"type":"object","required":["used_gb","status"],"title":"BackupStorageHealth"},"BackupType":{"type":"string","enum":["full","incremental","differential","snapshot"],"title":"BackupType","description":"Types of backups available"},"BadgeCountResponse":{"properties":{"badge_count":{"type":"integer","title":"Badge Count"}},"type":"object","required":["badge_count"],"title":"BadgeCountResponse"},"BadgesResponse":{"properties":{"badges":{"items":{"type":"string"},"type":"array","title":"Badges","description":"List of badge types"}},"type":"object","required":["badges"],"title":"BadgesResponse","description":"User badges in stream context","example":{"badges":["broadcaster","moderator","subscriber","verified"]}},"BanUserRequest":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"UUID of user to ban"},"reason":{"type":"string","maxLength":500,"title":"Reason","description":"Reason for ban"},"duration_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Days","description":"Ban duration in days (None = permanent)"},"notify_user":{"type":"boolean","title":"Notify User","description":"Whether to send notification to user","default":true}},"type":"object","required":["user_id","reason"],"title":"BanUserRequest","description":"Request schema for banning a user"},"BanditFinding":{"properties":{"id":{"type":"string","title":"Id"},"severity":{"type":"string","title":"Severity"},"confidence":{"type":"string","title":"Confidence"},"text":{"type":"string","title":"Text"},"file":{"type":"string","title":"File"},"line":{"type":"integer","title":"Line"},"cwe":{"anyOf":[{},{"type":"null"}],"title":"Cwe"}},"type":"object","required":["id","severity","confidence","text","file","line"],"title":"BanditFinding","description":"A single Bandit SAST finding."},"BankAccountCreateRequest":{"properties":{"account_name":{"type":"string","maxLength":255,"minLength":1,"title":"Account Name","description":"User-friendly name for the account"},"account_number":{"type":"string","maxLength":17,"minLength":4,"title":"Account Number","description":"Bank account number"},"routing_number":{"type":"string","maxLength":9,"minLength":9,"title":"Routing Number","description":"9-digit routing number"},"account_type":{"type":"string","title":"Account Type","description":"Account type: checking or savings"},"bank_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Bank Name","description":"Bank name"}},"type":"object","required":["account_name","account_number","routing_number","account_type"],"title":"BankAccountCreateRequest","description":"Schema for linking a bank account"},"BankAccountLinkRequest":{"properties":{"account_number":{"type":"string","maxLength":17,"minLength":4,"title":"Account Number","description":"Bank account number"},"routing_number":{"type":"string","maxLength":9,"minLength":9,"title":"Routing Number","description":"Bank routing number (9 digits)"},"account_type":{"type":"string","title":"Account Type","description":"Account type: 'checking' or 'savings'"},"account_name":{"type":"string","maxLength":255,"minLength":3,"title":"Account Name","description":"Unique name for this account"},"bank_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Bank Name","description":"Bank name"},"plaid_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plaid Account Id","description":"Plaid account ID if using Plaid Link"},"plaid_access_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plaid Access Token","description":"Plaid access token if using Plaid Link"}},"type":"object","required":["account_number","routing_number","account_type","account_name"],"title":"BankAccountLinkRequest","description":"Schema for linking a new bank account","example":{"account_name":"Primary Checking","account_number":"1234567890","account_type":"checking","bank_name":"Chase Bank","routing_number":"021000021"}},"BankAccountVerifyRequest":{"properties":{"verification_amounts":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Verification Amounts","description":"Micro-deposit amounts for manual verification (e.g., [0.01, 0.02])"}},"type":"object","title":"BankAccountVerifyRequest","description":"Schema for verifying a bank account","example":{"verification_amounts":[0.01,0.02]}},"BannerCreativeResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Creative ID"},"sponsor_id":{"type":"string","title":"Sponsor Id","description":"Sponsor ID"},"type":{"$ref":"#/components/schemas/CreativeType","description":"Creative type","default":"banner"},"status":{"$ref":"#/components/schemas/CreativeStatus","description":"Approval status"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"call_to_action":{"type":"string","title":"Call To Action"},"destination_url":{"type":"string","title":"Destination Url"},"banner_url":{"type":"string","title":"Banner Url","description":"R2 URL of banner image"},"ad_size":{"type":"string","title":"Ad Size","description":"IAB standard ad size (e.g., 300x250)"},"dimensions":{"additionalProperties":{"type":"integer"},"type":"object","title":"Dimensions","description":"Width and height in pixels"},"image_format":{"type":"string","title":"Image Format","description":"Image format (jpg, png, gif)"},"file_size_kb":{"type":"integer","title":"File Size Kb","description":"File size in kilobytes"},"is_animated":{"type":"boolean","title":"Is Animated","description":"True for animated GIFs","default":false},"reviewed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed By"},"reviewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reviewed At"},"rejection_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rejection Reason"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","sponsor_id","status","title","call_to_action","destination_url","banner_url","ad_size","dimensions","image_format","file_size_kb","created_at"],"title":"BannerCreativeResponse","description":"Schema for banner creative response","example":{"ad_size":"728x90","banner_url":"https://r2.ainative.studio/ad-creatives/sponsors/sponsor_xyz789/banners/creative_def456.png","call_to_action":"Learn More","created_at":"2026-01-05T11:00:00Z","description":"Conference promotion banner","destination_url":"https://paipalooza.com/register","dimensions":{"height":90,"width":728},"file_size_kb":245,"id":"creative_def456","image_format":"png","is_animated":false,"sponsor_id":"sponsor_xyz789","status":"pending_review","title":"PAI Palooza Banner","type":"banner"}},"BannerUploadResponse":{"properties":{"banner_url":{"type":"string","title":"Banner Url","description":"Public URL of the stored 1920x480 banner"}},"type":"object","required":["banner_url"],"title":"BannerUploadResponse","description":"Banner upload acknowledgement (POST /streams/me/profile/banner).","example":{"banner_url":"https://cdn.ainative.studio/banners/abc.png"}},"BaseTemplateInfo":{"properties":{"description":{"type":"string","title":"Description"},"components":{"items":{"type":"string"},"type":"array","title":"Components"},"complexity":{"type":"string","title":"Complexity"}},"type":"object","required":["description","components","complexity"],"title":"BaseTemplateInfo"},"BaseTemplateInfoWithSetupTime":{"properties":{"description":{"type":"string","title":"Description"},"components":{"items":{"type":"string"},"type":"array","title":"Components"},"complexity":{"type":"string","title":"Complexity"},"estimated_setup_time":{"type":"string","title":"Estimated Setup Time"}},"type":"object","required":["description","components","complexity","estimated_setup_time"],"title":"BaseTemplateInfoWithSetupTime"},"BaseTemplatesResponse":{"properties":{"base_templates":{"additionalProperties":{"$ref":"#/components/schemas/BaseTemplateInfoWithSetupTime"},"type":"object","title":"Base Templates"},"template_types":{"items":{"type":"string"},"type":"array","title":"Template Types"},"component_types":{"items":{"type":"string"},"type":"array","title":"Component Types"},"complexity_levels":{"items":{"type":"string"},"type":"array","title":"Complexity Levels"}},"type":"object","required":["base_templates","template_types","component_types","complexity_levels"],"title":"BaseTemplatesResponse","description":"Response for GET /langflow-templates/base-templates."},"BasicHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"timestamp":{"type":"string","title":"Timestamp"},"version":{"type":"string","title":"Version"},"environment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment"},"components":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/HealthComponentStatus"},"type":"object"},{"type":"null"}],"title":"Components"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status","timestamp","version"],"title":"BasicHealthResponse","description":"GET /health/ — shape returned by basic_health_check(). The error\nfallback branch inside the handler returns a *different* shape\n({status, timestamp, error, version} with no `environment`/`components`),\nso `environment` and `components` are optional here to cover both."},"BatchCodeGenerateRequest":{"properties":{"prefix":{"type":"string","title":"Prefix","description":"Code prefix","default":"NY2026"},"count":{"type":"integer","maximum":1000,"minimum":1,"title":"Count","description":"Number of codes to generate"},"length":{"type":"integer","maximum":10,"minimum":3,"title":"Length","description":"Length of random suffix","default":5}},"type":"object","required":["count"],"title":"BatchCodeGenerateRequest","description":"Request schema for generating batch of gift codes"},"BatchCreateRequest":{"properties":{"projects":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Projects"}},"type":"object","required":["projects"],"title":"BatchCreateRequest","description":"Request for batch creation"},"BatchCreateResponse":{"properties":{"created":{"type":"integer","title":"Created"},"failed":{"type":"integer","title":"Failed"},"ids":{"items":{"type":"string"},"type":"array","title":"Ids"}},"type":"object","required":["created","failed","ids"],"title":"BatchCreateResponse","description":"Response from batch creation"},"BatchEvaluateTemplatesResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}},"type":"object","required":["status","message"],"title":"BatchEvaluateTemplatesResponse"},"BatchEvaluationStartedResponse":{"properties":{"evaluation_ids":{"items":{"type":"string"},"type":"array","title":"Evaluation Ids"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"batch_size":{"type":"integer","title":"Batch Size"}},"type":"object","required":["evaluation_ids","status","message","batch_size"],"title":"BatchEvaluationStartedResponse","description":"Response for POST /batch-evaluate."},"BatchEventCreate":{"properties":{"topic":{"type":"string","title":"Topic","description":"Event topic"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Event payload"}},"type":"object","required":["topic","event_payload"],"title":"BatchEventCreate","description":"Event creation schema for batch operations"},"BatchEventPublishRequest":{"properties":{"events":{"items":{"$ref":"#/components/schemas/BatchEventCreate"},"type":"array","title":"Events","description":"Events to publish"},"partial_success":{"type":"boolean","title":"Partial Success","description":"Allow partial success (publish valid events even if some fail)","default":true}},"type":"object","required":["events"],"title":"BatchEventPublishRequest","description":"Batch event publishing request"},"BatchEventPublishResponse":{"properties":{"published_events":{"items":{"$ref":"#/components/schemas/BatchEventResponse"},"type":"array","title":"Published Events","description":"Successfully published events"},"success_count":{"type":"integer","title":"Success Count","description":"Number of successful publishes"},"error_count":{"type":"integer","title":"Error Count","description":"Number of failed publishes"},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors","description":"Error details with event indices"},"total_time_ms":{"type":"number","title":"Total Time Ms","description":"Total operation time in milliseconds"},"throughput_per_second":{"type":"number","title":"Throughput Per Second","description":"Events published per second"}},"type":"object","required":["published_events","success_count","error_count","total_time_ms","throughput_per_second"],"title":"BatchEventPublishResponse","description":"Batch event publishing response"},"BatchEventResponse":{"properties":{"event_id":{"type":"string","format":"uuid","title":"Event Id","description":"Event ID"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Project ID"},"topic":{"type":"string","title":"Topic","description":"Event topic"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Event payload"},"published_at":{"type":"string","format":"date-time","title":"Published At","description":"Published timestamp"}},"type":"object","required":["event_id","project_id","topic","event_payload","published_at"],"title":"BatchEventResponse","description":"Event response schema for batch operations"},"BatchExtractRequest":{"properties":{"urls":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Urls"},"table_name":{"type":"string","maxLength":128,"minLength":1,"title":"Table Name"},"extract_goal":{"type":"string","maxLength":512,"minLength":1,"title":"Extract Goal"},"project_id":{"type":"string","minLength":1,"title":"Project Id"}},"type":"object","required":["urls","table_name","extract_goal","project_id"],"title":"BatchExtractRequest"},"BatchExtractResponse":{"properties":{"processed":{"type":"integer","title":"Processed"},"failed":{"type":"integer","title":"Failed"},"results":{"items":{"$ref":"#/components/schemas/URLResult"},"type":"array","title":"Results"}},"type":"object","required":["processed","failed","results"],"title":"BatchExtractResponse"},"BatchFeedbackRequest":{"properties":{"feedback_items":{"items":{"$ref":"#/components/schemas/AgentSwarmFeedbackRequest"},"type":"array","maxItems":100,"minItems":1,"title":"Feedback Items","description":"List of feedback items to submit"}},"type":"object","required":["feedback_items"],"title":"BatchFeedbackRequest","description":"Request schema for submitting multiple feedback items at once","example":{"feedback_items":[{"content_reference":"users_table","feedback_type":"thumbs","project_id":"550e8400-e29b-41d4-a716-446655440000","stage":"data_model_generation","thumbs":"up"},{"comment":"Missing foreign key relationship","content_reference":"orders_table","feedback_type":"thumbs","project_id":"550e8400-e29b-41d4-a716-446655440000","stage":"data_model_generation","thumbs":"down"}]}},"BatchFeedbackResponse":{"properties":{"total_submitted":{"type":"integer","title":"Total Submitted","description":"Total items submitted"},"successful":{"type":"integer","title":"Successful","description":"Successfully stored count"},"failed":{"type":"integer","title":"Failed","description":"Failed count"},"feedback_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Feedback Ids","description":"IDs of successfully created feedback"},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors","description":"Error details for failed items"}},"type":"object","required":["total_submitted","successful","failed"],"title":"BatchFeedbackResponse","description":"Response schema for batch feedback submission"},"BatchMemoryDeleteRequest":{"properties":{"memory_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Memory Ids","description":"Memory record IDs to delete"}},"type":"object","required":["memory_ids"],"title":"BatchMemoryDeleteRequest","description":"Batch memory delete request"},"BatchMemoryDeleteResponse":{"properties":{"deleted_count":{"type":"integer","title":"Deleted Count","description":"Number of records deleted"},"not_found_count":{"type":"integer","title":"Not Found Count","description":"Number of records not found"},"error_count":{"type":"integer","title":"Error Count","description":"Number of deletion errors"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","description":"Error messages"},"total_time_ms":{"type":"number","title":"Total Time Ms","description":"Total operation time in milliseconds"}},"type":"object","required":["deleted_count","not_found_count","error_count","total_time_ms"],"title":"BatchMemoryDeleteResponse","description":"Batch memory delete response"},"BatchMemoryUpdateRequest":{"properties":{"memory_id":{"type":"string","format":"uuid","title":"Memory Id","description":"Memory record ID"},"updates":{"additionalProperties":true,"type":"object","title":"Updates","description":"Fields to update"}},"type":"object","required":["memory_id","updates"],"title":"BatchMemoryUpdateRequest","description":"Batch memory update request with partial field updates"},"BatchMemoryUpdatesRequest":{"properties":{"updates":{"items":{"$ref":"#/components/schemas/BatchMemoryUpdateRequest"},"type":"array","title":"Updates","description":"List of memory updates"}},"type":"object","required":["updates"],"title":"BatchMemoryUpdatesRequest","description":"Batch memory updates request"},"BatchMemoryUpdatesResponse":{"properties":{"updated_records":{"items":{"$ref":"#/components/schemas/MemoryRecordResponse"},"type":"array","title":"Updated Records","description":"Updated memory records"},"success_count":{"type":"integer","title":"Success Count","description":"Number of successful updates"},"error_count":{"type":"integer","title":"Error Count","description":"Number of failed updates"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","description":"Error messages"},"total_time_ms":{"type":"number","title":"Total Time Ms","description":"Total operation time in milliseconds"}},"type":"object","required":["updated_records","success_count","error_count","total_time_ms"],"title":"BatchMemoryUpdatesResponse","description":"Batch memory updates response"},"BatchMemoryUpsertRequest":{"properties":{"records":{"items":{"$ref":"#/components/schemas/MemoryRecordCreate"},"type":"array","title":"Records","description":"Memory records to upsert"}},"type":"object","required":["records"],"title":"BatchMemoryUpsertRequest","description":"Batch memory upsert request"},"BatchMemoryUpsertResponse":{"properties":{"records":{"items":{"$ref":"#/components/schemas/MemoryRecordResponse"},"type":"array","title":"Records","description":"Created/updated memory records"},"success_count":{"type":"integer","title":"Success Count","description":"Number of successful upserts"},"error_count":{"type":"integer","title":"Error Count","description":"Number of failed upserts"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","description":"Error messages"},"total_time_ms":{"type":"number","title":"Total Time Ms","description":"Total operation time in milliseconds"}},"type":"object","required":["records","success_count","error_count","total_time_ms"],"title":"BatchMemoryUpsertResponse","description":"Batch memory upsert response"},"BatchQueryOperation":{"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for this operation in the batch"},"type":{"type":"string","enum":["query","insert","update","delete"],"title":"Type","description":"Operation type"},"table":{"type":"string","title":"Table","description":"Table name"},"filters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters","description":"MongoDB-style filters for query/update/delete"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data","description":"Data for insert/update operations"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit","description":"Maximum number of results for query operations","default":100},"skip":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Skip","description":"Number of results to skip for query operations","default":0}},"type":"object","required":["id","type","table"],"title":"BatchQueryOperation","description":"Single query operation in a batch request"},"BatchQueryOperationResult":{"properties":{"id":{"type":"string","title":"Id","description":"Operation ID from request"},"success":{"type":"boolean","title":"Success","description":"Whether operation succeeded"},"data":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Data","description":"Query results or affected rows"},"affected_rows":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Affected Rows","description":"Number of rows affected (insert/update/delete)"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if operation failed"},"execution_time_ms":{"type":"number","title":"Execution Time Ms","description":"Operation execution time in milliseconds"}},"type":"object","required":["id","success","execution_time_ms"],"title":"BatchQueryOperationResult","description":"Result of a single operation in a batch query"},"BatchQueryRequest":{"properties":{"operations":{"items":{"$ref":"#/components/schemas/BatchQueryOperation"},"type":"array","title":"Operations","description":"List of operations to execute"},"parallel":{"type":"boolean","title":"Parallel","description":"Execute operations in parallel where possible","default":true},"stop_on_error":{"type":"boolean","title":"Stop On Error","description":"Stop batch execution on first error","default":false}},"type":"object","required":["operations"],"title":"BatchQueryRequest","description":"Batch query request containing multiple operations"},"BatchQueryResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/BatchQueryOperationResult"},"type":"array","title":"Results","description":"Results in same order as request"},"total_operations":{"type":"integer","title":"Total Operations","description":"Total number of operations"},"successful_operations":{"type":"integer","title":"Successful Operations","description":"Number of successful operations"},"failed_operations":{"type":"integer","title":"Failed Operations","description":"Number of failed operations"},"total_time_ms":{"type":"number","title":"Total Time Ms","description":"Total batch execution time in milliseconds"},"parallel_execution":{"type":"boolean","title":"Parallel Execution","description":"Whether operations were executed in parallel"}},"type":"object","required":["results","total_operations","successful_operations","failed_operations","total_time_ms","parallel_execution"],"title":"BatchQueryResponse","description":"Response containing results of all batch operations"},"BecknAck":{"properties":{"status":{"type":"string","title":"Status","description":"ACK or NACK per the Beckn spec"}},"type":"object","required":["status"],"title":"BecknAck","description":"Inner Beckn Protocol ack object: `{\"status\": \"ACK\"}`.\n\nTyped as a plain str map rather than a status enum because the Beckn spec\nalso defines NACK, and a BPP-facing envelope must stay able to carry it\nwithout a schema change. Matches the existing `BecknAckMessage.ack` shape\nalready used by beckn_network.py."},"BecknCallbackAckResponse":{"properties":{"message":{"$ref":"#/components/schemas/app__api__v1__endpoints__intent_marketplace__BecknAckMessage"}},"type":"object","required":["message"],"title":"BecknCallbackAckResponse","description":"Standard Beckn callback acknowledgement returned to the calling BPP.\n\nThis is the spec-defined ACK envelope, NOT the open-ended catalog payload\n— on_select/on_confirm deliberately discard the parsed quote/order and\nreturn only this literal, so the shape is fully known and safe to type."},"BecknGatewayStatus":{"properties":{"status":{"type":"string","title":"Status"},"domains":{"items":{"type":"string"},"type":"array","title":"Domains"}},"type":"object","required":["status","domains"],"title":"BecknGatewayStatus"},"BecknHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"network":{"type":"string","title":"Network"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"registry":{"anyOf":[{"$ref":"#/components/schemas/BecknRegistryStats"},{"type":"null"}]},"gateway":{"anyOf":[{"$ref":"#/components/schemas/BecknGatewayStatus"},{"type":"null"}]},"endpoints":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Endpoints"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status","network"],"title":"BecknHealthResponse"},"BecknOnSearchResponse":{"properties":{"message":{"$ref":"#/components/schemas/app__api__v1__endpoints__intent_marketplace__BecknAckMessage"},"matches_received":{"type":"integer","title":"Matches Received","description":"Number of catalog providers converted to matches"}},"type":"object","required":["message","matches_received"],"title":"BecknOnSearchResponse","description":"Beckn on_search ack, plus how many matches were extracted."},"BecknRegistryStats":{"properties":{"bap_count":{"type":"integer","title":"Bap Count"},"bpp_count":{"type":"integer","title":"Bpp Count"},"total_subscribers":{"type":"integer","title":"Total Subscribers"}},"type":"object","required":["bap_count","bpp_count","total_subscribers"],"title":"BecknRegistryStats"},"BecknSearchBroadcastResponse":{"properties":{"transaction_id":{"type":"string","title":"Transaction Id"},"beckn_request":{"additionalProperties":true,"type":"object","title":"Beckn Request","description":"The raw Beckn search request sent upstream"},"gateway_response":{"additionalProperties":true,"type":"object","title":"Gateway Response","description":"Raw ACK/NACK or error from the Beckn gateway"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["transaction_id","status","message"],"title":"BecknSearchBroadcastResponse","description":"Result of broadcasting an intent to the Beckn network.\n\nMirrors BecknAdapterService.search()'s fixed 5-key return. `beckn_request`\nand `gateway_response` ARE the genuinely open-ended, spec-defined Beckn\nenvelopes (arbitrary nested intent/catalog/error structures whose shape is\nowned by the Beckn spec and the remote gateway, not by this codebase), so\nthey stay `Dict[str, Any]` and pass through verbatim. Only the envelope\naround them is typed — pinned by\ntest_nested_beckn_envelopes_not_flattened."},"BecknSubscriber":{"properties":{"subscriber_id":{"type":"string","title":"Subscriber Id","description":"Unique subscriber ID (e.g., ainative-bap.ainative.studio)"},"subscriber_url":{"type":"string","title":"Subscriber Url","description":"Callback URL for the subscriber"},"type":{"type":"string","title":"Type","description":"BAP or BPP"},"domain":{"type":"string","title":"Domain","description":"Beckn domain (e.g., nic2004:52110)","default":"*"},"signing_public_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signing Public Key","description":"Ed25519 public key for request signing"},"encryption_public_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encryption Public Key","description":"X25519 public key for encryption"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City code (e.g., std:080)"},"country":{"type":"string","title":"Country","description":"Country code","default":"US"},"status":{"type":"string","title":"Status","description":"INITIATED, SUBSCRIBED, SUSPENDED","default":"SUBSCRIBED"}},"type":"object","required":["subscriber_id","subscriber_url","type"],"title":"BecknSubscriber"},"BestStreamingTime":{"properties":{"day_of_week":{"type":"integer","maximum":6,"minimum":0,"title":"Day Of Week","description":"Day of week (0=Sunday, 6=Saturday)"},"day_name":{"type":"string","title":"Day Name","description":"Day name"},"hour_of_day":{"type":"integer","maximum":23,"minimum":0,"title":"Hour Of Day","description":"Hour of day (0-23, UTC)"},"avg_viewers":{"type":"number","minimum":0,"title":"Avg Viewers","description":"Average viewers at this time"},"stream_count":{"type":"integer","minimum":0,"title":"Stream Count","description":"Number of streams at this time"}},"type":"object","required":["day_of_week","day_name","hour_of_day","avg_viewers","stream_count"],"title":"BestStreamingTime","description":"Best time to stream based on historical data","example":{"avg_viewers":125.5,"day_name":"Friday","day_of_week":5,"hour_of_day":20,"stream_count":12}},"BestStreamingTimesResponse":{"properties":{"best_times":{"items":{"$ref":"#/components/schemas/BestStreamingTime"},"type":"array","title":"Best Times"},"timezone":{"type":"string","title":"Timezone","description":"Timezone for hours (always UTC)"}},"type":"object","required":["best_times","timezone"],"title":"BestStreamingTimesResponse","description":"Best streaming times analysis","example":{"best_times":[{"avg_viewers":125.5,"day_name":"Friday","day_of_week":5,"hour_of_day":20,"stream_count":12}],"timezone":"UTC"}},"BestWorstPerformer":{"properties":{"prompt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Id"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"trend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend"}},"type":"object","title":"BestWorstPerformer"},"BillingBreakdownResponse":{"properties":{"period_start":{"type":"string","format":"date-time","title":"Period Start"},"period_end":{"type":"string","format":"date-time","title":"Period End"},"total_usd":{"type":"number","title":"Total Usd","default":0},"workspaces":{"items":{"$ref":"#/components/schemas/WorkspaceCostBreakdown"},"type":"array","title":"Workspaces"}},"type":"object","required":["period_start","period_end"],"title":"BillingBreakdownResponse"},"BillingDailyEntry":{"properties":{"date":{"type":"string","title":"Date"},"hours":{"type":"integer","title":"Hours"},"replicas":{"type":"integer","title":"Replicas"},"gpu_type":{"type":"string","title":"Gpu Type"},"rate_per_hr":{"type":"number","title":"Rate Per Hr"},"cost_usd":{"type":"number","title":"Cost Usd"}},"type":"object","required":["date","hours","replicas","gpu_type","rate_per_hr","cost_usd"],"title":"BillingDailyEntry"},"BillingHistoryResponse":{"properties":{"total_records":{"type":"integer","title":"Total Records"},"total_cost":{"type":"number","title":"Total Cost"},"records":{"items":{"$ref":"#/components/schemas/app__api__v1__consolidated__billing__UsageRecord"},"type":"array","title":"Records"}},"type":"object","required":["total_records","total_cost","records"],"title":"BillingHistoryResponse"},"BillingInfoDetailedResponse":{"properties":{"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id","description":"Stripe customer ID","example":"cus_abc123"},"subscription":{"$ref":"#/components/schemas/SubscriptionInfo","description":"Subscription details"},"payment_methods":{"items":{"$ref":"#/components/schemas/PaymentMethodResponse"},"type":"array","title":"Payment Methods","description":"List of payment methods on file"}},"type":"object","required":["subscription"],"title":"BillingInfoDetailedResponse","description":"Detailed billing information (used by /billing/info endpoint)\nIncludes customer ID and subscription details","example":{"customer_id":"cus_abc123","payment_methods":[{"brand":"visa","exp_month":12,"exp_year":2025,"last4":"4242","type":"card"}],"subscription":{"current_period_end":"2025-01-01T00:00:00Z","current_period_start":"2024-12-01T00:00:00Z","id":"sub_abc123","plan":"professional","status":"active"}}},"BillingMetricsData":{"properties":{"total_api_calls":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Api Calls","description":"Billable API calls in window"},"total_credits_consumed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Total Credits Consumed","description":"Credits consumed, decimal string for exact precision"},"active_users":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Users","description":"Distinct active users"},"avg_credits_per_user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Credits Per User","description":"Mean credits per active user, decimal string"},"peak_usage_hour":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peak Usage Hour","description":"Hour with peak usage"},"cost_per_service":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Cost Per Service","description":"Cost keyed by service, decimal strings"},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp","description":"Collection timestamp"}},"additionalProperties":true,"type":"object","title":"BillingMetricsData","description":"Mirror of mcp_proxy_metrics_service.BillingMetrics.\n\nThe Decimal-valued fields are strings on the wire: the handlers call\n`str(...)` on them to preserve exact precision, so typing them as float\nhere would both change the JSON type and lose precision."},"BillingMetricsEnvelope":{"properties":{"billing_metrics":{"$ref":"#/components/schemas/BillingMetricsData","description":"Billing metrics"},"collection_time":{"type":"string","title":"Collection Time","description":"ISO timestamp of collection"}},"additionalProperties":true,"type":"object","required":["billing_metrics","collection_time"],"title":"BillingMetricsEnvelope","description":"`data` block of the billing metrics route."},"BillingMetricsResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always true on a 200"},"data":{"$ref":"#/components/schemas/BillingMetricsEnvelope","description":"Billing metrics payload"}},"additionalProperties":true,"type":"object","required":["success","data"],"title":"BillingMetricsResponse","description":"GET /api/v1/mcp/proxy/metrics/billing"},"BillingPeriod":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"}},"type":"object","required":["start","end"],"title":"BillingPeriod"},"BillingPortalResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"url":{"type":"string","title":"Url"}},"type":"object","required":["success","url"],"title":"BillingPortalResponse","description":"Response for POST /billing/portal."},"BillingType":{"type":"string","enum":["prepaid","postpaid"],"title":"BillingType","description":"Billing type for sponsors"},"BillingUsageBreakdownEntry":{"properties":{"category":{"type":"string","title":"Category"},"credits":{"type":"integer","title":"Credits"},"percentage":{"type":"number","title":"Percentage"}},"type":"object","required":["category","credits","percentage"],"title":"BillingUsageBreakdownEntry"},"BillingUsageResponse":{"properties":{"total_credits_used":{"type":"number","title":"Total Credits Used","description":"Total credits consumed in time range"},"time_range":{"type":"string","title":"Time Range","description":"Time range identifier"},"breakdown":{"$ref":"#/components/schemas/UsageBreakdown","description":"Usage breakdown by category"},"top_endpoints":{"items":{"$ref":"#/components/schemas/app__schemas__gateway__EndpointUsage"},"type":"array","title":"Top Endpoints","description":"Top endpoints by credit usage"},"daily_breakdown":{"items":{"$ref":"#/components/schemas/DailyUsage"},"type":"array","title":"Daily Breakdown","description":"Daily credit usage breakdown"}},"type":"object","required":["total_credits_used","time_range","breakdown","top_endpoints","daily_breakdown"],"title":"BillingUsageResponse","description":"Billing usage response","example":{"breakdown":{"database_operations":400,"memory_operations":300,"postgres_queries":100,"storage_operations":200.5,"vector_operations":500},"daily_breakdown":[{"credits":1500.5,"date":"2025-12-15"}],"time_range":"last_24_hours","top_endpoints":[{"credits":250,"endpoint":"/api/vectors/search"}],"total_credits_used":1500.5}},"BlockResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Block relationship ID"},"blocker_id":{"type":"string","title":"Blocker Id","description":"Blocker user ID"},"blocked_id":{"type":"string","title":"Blocked Id","description":"Blocked user ID"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Block reason"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the block was created"}},"type":"object","required":["id","blocker_id","blocked_id","created_at"],"title":"BlockResponse","description":"Response for block operations"},"BlockUserRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason","description":"Optional reason for blocking","examples":["Spam"]}},"type":"object","title":"BlockUserRequest","description":"Schema for blocking a user","examples":[{"reason":"Spam"}]},"BlockedIPRow":{"properties":{"ip_address":{"type":"string","title":"Ip Address"},"blocked":{"type":"boolean","title":"Blocked"},"block_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Block Reason"},"first_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Seen"},"last_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Seen"},"request_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Request Count"},"failed_auth_attempts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Failed Auth Attempts"},"suspicious_requests":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suspicious Requests"},"trust_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Trust Score"}},"additionalProperties":true,"type":"object","required":["ip_address","blocked"],"title":"BlockedIPRow","description":"One blocked IP.\n\nSPARSE BY DESIGN: the handler only merges the reputation fields when the IP\nhas an entry in `ip_reputation`. A blocked IP with no reputation record is\nemitted with exactly two keys (ip_address, blocked). All reputation fields\nare therefore Optional, and the route sets\nresponse_model_exclude_unset=True so FastAPI does not materialize them as\nnulls that the untyped handler never sent."},"BlockedIPsResponse":{"properties":{"blocked_ips":{"items":{"$ref":"#/components/schemas/BlockedIPRow"},"type":"array","title":"Blocked Ips"},"total_blocked":{"type":"integer","title":"Total Blocked"},"timestamp":{"type":"string","title":"Timestamp"}},"additionalProperties":true,"type":"object","required":["blocked_ips","total_blocked","timestamp"],"title":"BlockedIPsResponse","description":"GET /blocked-ips."},"BlockedKeywordAdd":{"properties":{"keyword":{"type":"string","maxLength":100,"minLength":1,"title":"Keyword","description":"Keyword to block (supports wildcards * and ?)"}},"type":"object","required":["keyword"],"title":"BlockedKeywordAdd","description":"Schema for adding a single blocked keyword"},"BlockedKeywordBulkAdd":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Keywords","description":"List of keywords to block"}},"type":"object","required":["keywords"],"title":"BlockedKeywordBulkAdd","description":"Schema for adding multiple blocked keywords"},"BlockedKeywordRemove":{"properties":{"keyword":{"type":"string","minLength":1,"title":"Keyword","description":"Keyword to unblock"}},"type":"object","required":["keyword"],"title":"BlockedKeywordRemove","description":"Schema for removing a blocked keyword"},"BlockedKeywordsResponse":{"properties":{"blocked_keywords":{"items":{"type":"string"},"type":"array","title":"Blocked Keywords","description":"List of blocked keywords"},"count":{"type":"integer","minimum":0,"title":"Count","description":"Total number of blocked keywords"}},"type":"object","required":["count"],"title":"BlockedKeywordsResponse","description":"Schema for blocked keywords list response","example":{"blocked_keywords":["spam","bad*","offen?ive"],"count":3}},"BlockedKeywordsUpdateRequest":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Keywords","description":"List of keywords to block"}},"type":"object","required":["keywords"],"title":"BlockedKeywordsUpdateRequest","description":"Request schema for updating blocked keywords","example":{"keywords":["spam","offensive","nsfw"]}},"BlockedKeywordsUpdateResult":{"properties":{"success":{"type":"boolean","title":"Success"},"blocked_keywords":{"items":{"type":"string"},"type":"array","title":"Blocked Keywords"},"count":{"type":"integer","title":"Count"},"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["success","blocked_keywords","count","message"],"title":"BlockedKeywordsUpdateResult","description":"Response schema for PATCH /profiles/me/blocked-keywords.\n\nNamed distinctly from app.schemas.blocked_keywords.BlockedKeywordsResponse,\nwhich belongs to the separate /blocked-keywords endpoint module and has no\n``success``/``message`` fields. ``extra=\"allow\"`` for the same reason as\nSafeModeToggleResult above. Refs #8449."},"BlogPromptExtractionRequest":{"properties":{"blog_post_id":{"type":"string","maxLength":255,"title":"Blog Post Id","description":"Strapi blog post ID"},"blog_post_slug":{"type":"string","maxLength":500,"title":"Blog Post Slug","description":"Blog post URL slug"},"blog_post_title":{"type":"string","title":"Blog Post Title","description":"Blog post title"},"blog_post_content":{"type":"string","title":"Blog Post Content","description":"Full blog post content in Markdown"},"extraction_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Model","description":"AI model to use","default":"claude-3-5-sonnet-20241022"},"tenant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Tenant Id"},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Created By"}},"type":"object","required":["blog_post_id","blog_post_slug","blog_post_title","blog_post_content"],"title":"BlogPromptExtractionRequest","description":"Request to extract prompts from a blog post"},"BlogPromptExtractionResponse":{"properties":{"prompts_extracted":{"type":"integer","title":"Prompts Extracted"},"prompts":{"items":{"$ref":"#/components/schemas/BlogPromptResponse"},"type":"array","title":"Prompts"},"extraction_time_seconds":{"type":"number","title":"Extraction Time Seconds"},"model_used":{"type":"string","title":"Model Used"},"success":{"type":"boolean","title":"Success"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors"}},"type":"object","required":["prompts_extracted","prompts","extraction_time_seconds","model_used","success"],"title":"BlogPromptExtractionResponse","description":"Response from prompt extraction"},"BlogPromptListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BlogPromptResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","total","skip","limit","has_more"],"title":"BlogPromptListResponse","description":"Paginated list of prompts"},"BlogPromptResponse":{"properties":{"blog_post_id":{"type":"string","maxLength":255,"title":"Blog Post Id","description":"Strapi blog post ID"},"blog_post_slug":{"type":"string","maxLength":500,"title":"Blog Post Slug","description":"Blog post URL slug"},"blog_post_title":{"type":"string","title":"Blog Post Title","description":"Blog post title"},"prompt_type":{"$ref":"#/components/schemas/PromptType","description":"Type of prompt"},"prompt_title":{"type":"string","maxLength":500,"title":"Prompt Title","description":"Prompt title"},"prompt_content":{"type":"string","title":"Prompt Content","description":"Full prompt text"},"prompt_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Description","description":"Description of what the prompt does"},"category":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Category","description":"Prompt category"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Tags for categorization"},"uses_ainative_apis":{"type":"boolean","title":"Uses Ainative Apis","description":"Whether prompt uses AINative APIs","default":false},"referenced_apis":{"items":{"type":"string"},"type":"array","title":"Referenced Apis","description":"List of referenced API endpoints"},"variables":{"additionalProperties":true,"type":"object","title":"Variables","description":"Prompt variables {{variable_name}}"},"default_values":{"additionalProperties":true,"type":"object","title":"Default Values","description":"Default values for variables"},"id":{"type":"string","format":"uuid","title":"Id"},"extraction_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Model"},"extraction_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Confidence"},"extraction_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Method"},"view_count":{"type":"integer","title":"View Count","default":0},"copy_count":{"type":"integer","title":"Copy Count","default":0},"download_count":{"type":"integer","title":"Download Count","default":0},"share_count":{"type":"integer","title":"Share Count","default":0},"user_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Rating"},"rating_count":{"type":"integer","title":"Rating Count","default":0},"is_verified":{"type":"boolean","title":"Is Verified","default":false},"tenant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Tenant Id"},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Created By"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"deleted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deleted At"}},"type":"object","required":["blog_post_id","blog_post_slug","blog_post_title","prompt_type","prompt_title","prompt_content","id","created_at","updated_at"],"title":"BlogPromptResponse","description":"Schema for prompt responses"},"Body_admin_login_admin_auth_login_post":{"properties":{"grant_type":{"anyOf":[{"type":"string","pattern":"^password$"},{"type":"null"}],"title":"Grant Type"},"username":{"type":"string","title":"Username"},"password":{"type":"string","format":"password","title":"Password"},"scope":{"type":"string","title":"Scope","default":""},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"format":"password","title":"Client Secret"}},"type":"object","required":["username","password"],"title":"Body_admin_login_admin_auth_login_post"},"Body_admin_login_api_v1_admin_auth_login_post":{"properties":{"grant_type":{"anyOf":[{"type":"string","pattern":"^password$"},{"type":"null"}],"title":"Grant Type"},"username":{"type":"string","title":"Username"},"password":{"type":"string","format":"password","title":"Password"},"scope":{"type":"string","title":"Scope","default":""},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"format":"password","title":"Client Secret"}},"type":"object","required":["username","password"],"title":"Body_admin_login_api_v1_admin_auth_login_post"},"Body_analyze_database_api_v1_projects__project_id__database_maintenance_analyze_post":{"properties":{"verbose":{"type":"boolean","title":"Verbose","description":"Show detailed progress information","default":false}},"type":"object","title":"Body_analyze_database_api_v1_projects__project_id__database_maintenance_analyze_post"},"Body_analyze_database_api_v1_public_zerodb__project_id__database_maintenance_analyze_post":{"properties":{"verbose":{"type":"boolean","title":"Verbose","description":"Show detailed progress information","default":false}},"type":"object","title":"Body_analyze_database_api_v1_public_zerodb__project_id__database_maintenance_analyze_post"},"Body_authorize_callback_oauth_authorize_callback_post":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"},"client_id":{"type":"string","title":"Client Id"},"redirect_uri":{"type":"string","title":"Redirect Uri"},"scope":{"type":"string","title":"Scope"},"state":{"type":"string","title":"State","default":""},"code_challenge":{"type":"string","title":"Code Challenge"},"code_challenge_method":{"type":"string","title":"Code Challenge Method"}},"type":"object","required":["email","password","client_id","redirect_uri","scope","code_challenge","code_challenge_method"],"title":"Body_authorize_callback_oauth_authorize_callback_post"},"Body_block_ip_address_api_v1_security_blocked_ips__ip_address__block_post":{"properties":{"reason":{"type":"string","title":"Reason","description":"Reason for blocking"}},"type":"object","required":["reason"],"title":"Body_block_ip_address_api_v1_security_blocked_ips__ip_address__block_post"},"Body_change_password_api_v1_public_auth_change_password_post":{"properties":{"current_password":{"type":"string","title":"Current Password"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["current_password","new_password"],"title":"Body_change_password_api_v1_public_auth_change_password_post"},"Body_clear_all_blocked_ips_api_v1_security_blocked_ips_clear_all_post":{"properties":{"reason":{"type":"string","title":"Reason","description":"Reason for clearing all blocked IPs"}},"type":"object","required":["reason"],"title":"Body_clear_all_blocked_ips_api_v1_security_blocked_ips_clear_all_post"},"Body_confirm_upload_api_v1_projects__project_id__files_confirm_upload_post":{"properties":{"file_key":{"type":"string","title":"File Key","description":"Object key returned by presign-upload"},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name","description":"File name (defaults to file_key)"},"metadata":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata","description":"JSON metadata (optional)"}},"type":"object","required":["file_key"],"title":"Body_confirm_upload_api_v1_projects__project_id__files_confirm_upload_post"},"Body_confirm_upload_api_v1_public_zerodb__project_id__files_confirm_upload_post":{"properties":{"file_key":{"type":"string","title":"File Key","description":"Object key returned by presign-upload"},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name","description":"File name (defaults to file_key)"},"metadata":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata","description":"JSON metadata (optional)"}},"type":"object","required":["file_key"],"title":"Body_confirm_upload_api_v1_public_zerodb__project_id__files_confirm_upload_post"},"Body_create_bulk_reel_batch_api_v1_public_bulk_reels_post":{"properties":{"csv_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Csv File"},"twin_id":{"type":"string","title":"Twin Id"},"platform":{"type":"string","title":"Platform"}},"type":"object","required":["csv_file","twin_id","platform"],"title":"Body_create_bulk_reel_batch_api_v1_public_bulk_reels_post"},"Body_create_comparison_interaction_api_v1_projects__project_id__database_rlhf_interactions_compare_post":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"User prompt/question"},"response_a":{"type":"string","title":"Response A","description":"First response option"},"response_b":{"type":"string","title":"Response B","description":"Second response option"},"preferred_response":{"type":"string","title":"Preferred Response","description":"Preferred response (A or B)"},"model_a":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model A","description":"Model name for response A"},"model_b":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model B","description":"Model name for response B"},"feedback_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Comment","description":"Optional feedback comment"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id","description":"Agent identifier"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Interaction context"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata"}},"type":"object","required":["prompt","response_a","response_b","preferred_response"],"title":"Body_create_comparison_interaction_api_v1_projects__project_id__database_rlhf_interactions_compare_post"},"Body_create_comparison_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions_compare_post":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"User prompt/question"},"response_a":{"type":"string","title":"Response A","description":"First response option"},"response_b":{"type":"string","title":"Response B","description":"Second response option"},"preferred_response":{"type":"string","title":"Preferred Response","description":"Preferred response (A or B)"},"model_a":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model A","description":"Model name for response A"},"model_b":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model B","description":"Model name for response B"},"feedback_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Comment","description":"Optional feedback comment"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id","description":"Agent identifier"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Interaction context"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata"}},"type":"object","required":["prompt","response_a","response_b","preferred_response"],"title":"Body_create_comparison_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions_compare_post"},"Body_create_demo_agent_swarm_demo_agent_swarm_post":{"properties":{"name":{"type":"string","title":"Name"},"agents":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Agents"}},"type":"object","required":["name","agents"],"title":"Body_create_demo_agent_swarm_demo_agent_swarm_post"},"Body_create_demo_project_demo_projects_post":{"properties":{"name":{"type":"string","title":"Name","description":"Project name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Project description"}},"type":"object","required":["name"],"title":"Body_create_demo_project_demo_projects_post"},"Body_create_document_api_v1_public_documents__post":{"properties":{"title":{"type":"string","title":"Title"},"content_type":{"type":"string","title":"Content Type"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"},"file":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"File"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"}},"type":"object","required":["title","content_type"],"title":"Body_create_document_api_v1_public_documents__post"},"Body_create_native_creative_api_v1_paipalooza_ad_creatives_native_post":{"properties":{"title":{"type":"string","maxLength":60,"minLength":10,"title":"Title","description":"Native ad title (10-60 chars)"},"description":{"type":"string","maxLength":200,"minLength":30,"title":"Description","description":"Native ad description (30-200 chars)"},"call_to_action":{"type":"string","title":"Call To Action","description":"Call-to-action text (max 20 chars)"},"destination_url":{"type":"string","title":"Destination Url","description":"Destination URL (must be HTTPS)"},"sponsor_name":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Sponsor Name","description":"Advertiser name (optional)"},"sponsor_logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor Logo Url","description":"Sponsor logo URL (optional, HTTPS)"},"image_file":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Image File","description":"Optional image file (JPG, PNG, GIF, max 5MB)"}},"type":"object","required":["title","description","call_to_action","destination_url"],"title":"Body_create_native_creative_api_v1_paipalooza_ad_creatives_native_post"},"Body_create_single_review_interaction_api_v1_projects__project_id__database_rlhf_interactions_single_review_post":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"User prompt/question"},"response":{"type":"string","title":"Response","description":"Agent response"},"rating":{"type":"integer","maximum":5,"minimum":1,"title":"Rating","description":"Rating score 1-5"},"feedback_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Comment","description":"Optional feedback comment"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Model name"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id","description":"Agent identifier"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Interaction context"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Tags for categorization"},"expected_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Response","description":"Expected/ideal response"},"improvement_suggestions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Improvement Suggestions","description":"Suggestions for improvement"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata"}},"type":"object","required":["prompt","response","rating"],"title":"Body_create_single_review_interaction_api_v1_projects__project_id__database_rlhf_interactions_single_review_post"},"Body_create_single_review_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions_single_review_post":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"User prompt/question"},"response":{"type":"string","title":"Response","description":"Agent response"},"rating":{"type":"integer","maximum":5,"minimum":1,"title":"Rating","description":"Rating score 1-5"},"feedback_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Comment","description":"Optional feedback comment"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Model name"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id","description":"Agent identifier"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Interaction context"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Tags for categorization"},"expected_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Response","description":"Expected/ideal response"},"improvement_suggestions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Improvement Suggestions","description":"Suggestions for improvement"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata"}},"type":"object","required":["prompt","response","rating"],"title":"Body_create_single_review_interaction_api_v1_public_zerodb__project_id__database_rlhf_interactions_single_review_post"},"Body_create_transcription_api_v1_audio_transcriptions_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Audio file to transcribe"},"model":{"type":"string","title":"Model","default":"whisper-1"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"response_format":{"type":"string","title":"Response Format","default":"text"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature"}},"type":"object","required":["file"],"title":"Body_create_transcription_api_v1_audio_transcriptions_post"},"Body_create_translation_api_v1_audio_translations_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Audio file to translate to English"},"model":{"type":"string","title":"Model","default":"whisper-1"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"response_format":{"type":"string","title":"Response Format","default":"text"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature"}},"type":"object","required":["file"],"title":"Body_create_translation_api_v1_audio_translations_post"},"Body_create_webinar_api_v1_videos_webinars_post":{"properties":{"video_data":{"$ref":"#/components/schemas/VideoCreate"},"webinar_data":{"$ref":"#/components/schemas/WebinarCreate"}},"type":"object","required":["video_data","webinar_data"],"title":"Body_create_webinar_api_v1_videos_webinars_post"},"Body_evaluate_prompt_version_admin_prompt_evaluation_evaluate__version_id__post":{"properties":{"test_cases":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Test Cases"},"evaluators":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Evaluators"}},"type":"object","title":"Body_evaluate_prompt_version_admin_prompt_evaluation_evaluate__version_id__post"},"Body_evaluate_prompt_version_api_v1_admin_prompt_evaluation_evaluate__version_id__post":{"properties":{"test_cases":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Test Cases"},"evaluators":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Evaluators"}},"type":"object","title":"Body_evaluate_prompt_version_api_v1_admin_prompt_evaluation_evaluate__version_id__post"},"Body_evaluate_version_admin_prompts_versions__version_id__evaluate_post":{"properties":{"test_cases":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Test Cases"},"evaluators":{"items":{"type":"string"},"type":"array","title":"Evaluators"}},"type":"object","required":["test_cases","evaluators"],"title":"Body_evaluate_version_admin_prompts_versions__version_id__evaluate_post"},"Body_evaluate_version_api_v1_admin_prompts_versions__version_id__evaluate_post":{"properties":{"test_cases":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Test Cases"},"evaluators":{"items":{"type":"string"},"type":"array","title":"Evaluators"}},"type":"object","required":["test_cases","evaluators"],"title":"Body_evaluate_version_api_v1_admin_prompts_versions__version_id__evaluate_post"},"Body_export_agent_logs_api_v1_projects__project_id__database_agent_logs_export_post":{"properties":{"format":{"type":"string","title":"Format","default":"json"},"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id"},"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id"}},"type":"object","title":"Body_export_agent_logs_api_v1_projects__project_id__database_agent_logs_export_post"},"Body_export_agent_logs_api_v1_public_zerodb__project_id__database_agent_logs_export_post":{"properties":{"format":{"type":"string","title":"Format","default":"json"},"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id"},"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id"}},"type":"object","title":"Body_export_agent_logs_api_v1_public_zerodb__project_id__database_agent_logs_export_post"},"Body_export_rlhf_data_api_v1_projects__project_id__database_rlhf_export_post":{"properties":{"format":{"type":"string","title":"Format","default":"json"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"feedback":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","title":"Body_export_rlhf_data_api_v1_projects__project_id__database_rlhf_export_post"},"Body_export_rlhf_data_api_v1_public_zerodb__project_id__database_rlhf_export_post":{"properties":{"format":{"type":"string","title":"Format","default":"json"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"feedback":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","title":"Body_export_rlhf_data_api_v1_public_zerodb__project_id__database_rlhf_export_post"},"Body_generate_captions_api_v1_public_captions_generate_post":{"properties":{"reel_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reel Url"},"audio_file":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Audio File"}},"type":"object","title":"Body_generate_captions_api_v1_public_captions_generate_post"},"Body_generate_presigned_url_api_v1_projects__project_id__database_files__file_id__presigned_url_post":{"properties":{"expiration":{"type":"integer","title":"Expiration","default":3600},"operation":{"type":"string","title":"Operation","default":"download"}},"type":"object","title":"Body_generate_presigned_url_api_v1_projects__project_id__database_files__file_id__presigned_url_post"},"Body_generate_presigned_url_api_v1_public_zerodb__project_id__database_files__file_id__presigned_url_post":{"properties":{"expiration":{"type":"integer","title":"Expiration","default":3600},"operation":{"type":"string","title":"Operation","default":"download"}},"type":"object","title":"Body_generate_presigned_url_api_v1_public_zerodb__project_id__database_files__file_id__presigned_url_post"},"Body_index_repository_admin_indexing_repositories__project_id__post":{"properties":{"repository_path":{"type":"string","title":"Repository Path","description":"Path to the repository root"},"file_extensions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"File Extensions","description":"File extensions to include"},"exclude_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Patterns","description":"Patterns to exclude"}},"type":"object","required":["repository_path"],"title":"Body_index_repository_admin_indexing_repositories__project_id__post"},"Body_index_repository_api_v1_admin_indexing_repositories__project_id__post":{"properties":{"repository_path":{"type":"string","title":"Repository Path","description":"Path to the repository root"},"file_extensions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"File Extensions","description":"File extensions to include"},"exclude_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Patterns","description":"Patterns to exclude"}},"type":"object","required":["repository_path"],"title":"Body_index_repository_api_v1_admin_indexing_repositories__project_id__post"},"Body_login_access_token_api_v1_public_auth__post":{"properties":{"grant_type":{"anyOf":[{"type":"string","pattern":"^password$"},{"type":"null"}],"title":"Grant Type"},"username":{"type":"string","title":"Username"},"password":{"type":"string","format":"password","title":"Password"},"scope":{"type":"string","title":"Scope","default":""},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"format":"password","title":"Client Secret"}},"type":"object","required":["username","password"],"title":"Body_login_access_token_api_v1_public_auth__post"},"Body_login_access_token_api_v1_public_auth_login_post":{"properties":{"grant_type":{"anyOf":[{"type":"string","pattern":"^password$"},{"type":"null"}],"title":"Grant Type"},"username":{"type":"string","title":"Username"},"password":{"type":"string","format":"password","title":"Password"},"scope":{"type":"string","title":"Scope","default":""},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"format":"password","title":"Client Secret"}},"type":"object","required":["username","password"],"title":"Body_login_access_token_api_v1_public_auth_login_post"},"Body_manual_scale_api_v1_public_agent_resources_scale_post":{"properties":{"agent_type":{"type":"string","title":"Agent Type","description":"Agent type to scale"},"instance_count":{"type":"integer","title":"Instance Count","description":"Target number of instances"},"reason":{"type":"string","title":"Reason","description":"Reason for manual scaling"}},"type":"object","required":["agent_type","instance_count","reason"],"title":"Body_manual_scale_api_v1_public_agent_resources_scale_post"},"Body_presign_upload_api_v1_projects__project_id__files_presign_upload_post":{"properties":{"file_name":{"type":"string","title":"File Name","description":"File name"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type","description":"MIME type (optional)"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key","description":"Custom object key/path (optional)"},"expires_in":{"type":"integer","title":"Expires In","description":"Presigned URL TTL in seconds (60–86400)","default":3600}},"type":"object","required":["file_name"],"title":"Body_presign_upload_api_v1_projects__project_id__files_presign_upload_post"},"Body_presign_upload_api_v1_public_zerodb__project_id__files_presign_upload_post":{"properties":{"file_name":{"type":"string","title":"File Name","description":"File name"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type","description":"MIME type (optional)"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key","description":"Custom object key/path (optional)"},"expires_in":{"type":"integer","title":"Expires In","description":"Presigned URL TTL in seconds (60–86400)","default":3600}},"type":"object","required":["file_name"],"title":"Body_presign_upload_api_v1_public_zerodb__project_id__files_presign_upload_post"},"Body_reindex_database_api_v1_projects__project_id__database_maintenance_reindex_post":{"properties":{"concurrent":{"type":"boolean","title":"Concurrent","description":"Use REINDEX CONCURRENTLY (PostgreSQL 12+, no locks)","default":false}},"type":"object","title":"Body_reindex_database_api_v1_projects__project_id__database_maintenance_reindex_post"},"Body_reindex_database_api_v1_public_zerodb__project_id__database_maintenance_reindex_post":{"properties":{"concurrent":{"type":"boolean","title":"Concurrent","description":"Use REINDEX CONCURRENTLY (PostgreSQL 12+, no locks)","default":false}},"type":"object","title":"Body_reindex_database_api_v1_public_zerodb__project_id__database_maintenance_reindex_post"},"Body_reject_creative_endpoint_api_v1_paipalooza_ad_creatives_admin_reject_creative__creative_id__post":{"properties":{"rejection_reason":{"type":"string","maxLength":500,"minLength":10,"title":"Rejection Reason","description":"Reason for rejection"}},"type":"object","required":["rejection_reason"],"title":"Body_reject_creative_endpoint_api_v1_paipalooza_ad_creatives_admin_reject_creative__creative_id__post"},"Body_search_memory_api_v1_projects__project_id__database_memory_search_post":{"properties":{"query":{"type":"string","title":"Query"},"limit":{"type":"integer","title":"Limit","default":20}},"type":"object","required":["query"],"title":"Body_search_memory_api_v1_projects__project_id__database_memory_search_post"},"Body_search_memory_api_v1_public_zerodb__project_id__database_memory_search_post":{"properties":{"query":{"type":"string","title":"Query"},"limit":{"type":"integer","title":"Limit","default":20}},"type":"object","required":["query"],"title":"Body_search_memory_api_v1_public_zerodb__project_id__database_memory_search_post"},"Body_speech_to_speech_api_v1_audio_speech_to_speech_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"User speech audio (wav/mp3/m4a/webm)"},"system_prompt":{"type":"string","title":"System Prompt","default":"You are a helpful, concise voice assistant. Reply in 1-3 sentences."},"llm_model":{"type":"string","title":"Llm Model","default":"gemma-4-31b"},"voice":{"type":"string","title":"Voice","default":"alloy"},"voice_instructions":{"type":"string","title":"Voice Instructions","default":"A warm, natural conversational voice"}},"type":"object","required":["file"],"title":"Body_speech_to_speech_api_v1_audio_speech_to_speech_post"},"Body_toggle_ip_whitelist_api_v1_security_ip_whitelist_toggle_put":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Enable or disable IP whitelist"}},"type":"object","required":["enabled"],"title":"Body_toggle_ip_whitelist_api_v1_security_ip_whitelist_toggle_put"},"Body_toggle_quantum_compression_api_v1_projects__project_id__database_settings_quantum_compression_put":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Enable/disable quantum compression"},"algorithm":{"type":"string","title":"Algorithm","description":"Compression algorithm to use","default":"quantum_harmonic"},"compression_ratio":{"type":"number","maximum":0.8,"minimum":0.2,"title":"Compression Ratio","description":"Target compression ratio","default":0.5}},"type":"object","required":["enabled"],"title":"Body_toggle_quantum_compression_api_v1_projects__project_id__database_settings_quantum_compression_put"},"Body_toggle_quantum_compression_api_v1_public_zerodb__project_id__database_settings_quantum_compression_put":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Enable/disable quantum compression"},"algorithm":{"type":"string","title":"Algorithm","description":"Compression algorithm to use","default":"quantum_harmonic"},"compression_ratio":{"type":"number","maximum":0.8,"minimum":0.2,"title":"Compression Ratio","description":"Target compression ratio","default":0.5}},"type":"object","required":["enabled"],"title":"Body_toggle_quantum_compression_api_v1_public_zerodb__project_id__database_settings_quantum_compression_put"},"Body_token_endpoint_v1_oauth_token_post":{"properties":{"grant_type":{"type":"string","title":"Grant Type"},"code":{"type":"string","title":"Code"},"redirect_uri":{"type":"string","title":"Redirect Uri"},"client_id":{"type":"string","title":"Client Id"},"code_verifier":{"type":"string","title":"Code Verifier"},"refresh_token":{"type":"string","title":"Refresh Token"}},"type":"object","title":"Body_token_endpoint_v1_oauth_token_post"},"Body_token_grant_api_v1_cloud_auth_token_post":{"properties":{"grant_type":{"type":"string","title":"Grant Type"},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Secret"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"assertion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assertion"},"claim_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Token"}},"type":"object","required":["grant_type"],"title":"Body_token_grant_api_v1_cloud_auth_token_post"},"Body_transcribe_audio_api_v1_media_transcribe_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Audio file to transcribe"},"model":{"type":"string","title":"Model","default":"whisper-1"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"response_format":{"type":"string","title":"Response Format","default":"text"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature"}},"type":"object","required":["file"],"title":"Body_transcribe_audio_api_v1_media_transcribe_post"},"Body_translate_audio_api_v1_media_translate_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Audio file to translate to English"},"model":{"type":"string","title":"Model","default":"whisper-1"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"response_format":{"type":"string","title":"Response Format","default":"text"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature"}},"type":"object","required":["file"],"title":"Body_translate_audio_api_v1_media_translate_post"},"Body_triage_action_api_v1_public_agent_swarms_intake__item_id__triage_post":{"properties":{"action":{"type":"string","title":"Action","description":"reclassify|run_anyway|approve_issue|dismiss"},"classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Classification","description":"required for reclassify"}},"type":"object","required":["action"],"title":"Body_triage_action_api_v1_public_agent_swarms_intake__item_id__triage_post"},"Body_trigger_manual_rollback_api_v1_deployment_deployments__deployment_id__rollback_post":{"properties":{"reason":{"type":"string","title":"Reason"}},"type":"object","required":["reason"],"title":"Body_trigger_manual_rollback_api_v1_deployment_deployments__deployment_id__rollback_post"},"Body_unblock_ip_address_api_v1_security_blocked_ips__ip_address__unblock_post":{"properties":{"reason":{"type":"string","title":"Reason","description":"Reason for unblocking"}},"type":"object","required":["reason"],"title":"Body_unblock_ip_address_api_v1_security_blocked_ips__ip_address__unblock_post"},"Body_update_memory_record_api_v1_projects__project_id__database_memory__memory_id__put":{"properties":{"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","title":"Body_update_memory_record_api_v1_projects__project_id__database_memory__memory_id__put"},"Body_update_memory_record_api_v1_public_zerodb__project_id__database_memory__memory_id__put":{"properties":{"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","title":"Body_update_memory_record_api_v1_public_zerodb__project_id__database_memory__memory_id__put"},"Body_upload_avatar_api_v1_streams_me_profile_avatar_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_avatar_api_v1_streams_me_profile_avatar_post"},"Body_upload_banner_api_v1_streams_me_profile_banner_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_banner_api_v1_streams_me_profile_banner_post"},"Body_upload_banner_creative_api_v1_paipalooza_ad_creatives_banner_post":{"properties":{"image_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Image File","description":"Banner image file (JPG, PNG, GIF, max 5MB)"},"title":{"type":"string","maxLength":200,"minLength":3,"title":"Title","description":"Creative title"},"call_to_action":{"type":"string","title":"Call To Action","description":"Call-to-action text (e.g., 'Learn More')"},"destination_url":{"type":"string","title":"Destination Url","description":"Destination URL (must be HTTPS)"},"ad_size":{"type":"string","title":"Ad Size","description":"IAB standard ad size (300x250, 728x90, 320x50, 160x600, 970x250)"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description","description":"Creative description"}},"type":"object","required":["image_file","title","call_to_action","destination_url","ad_size"],"title":"Body_upload_banner_creative_api_v1_paipalooza_ad_creatives_banner_post"},"Body_upload_document_api_v1_ledger_documents_upload_post":{"properties":{"folder_id":{"type":"string","title":"Folder Id"},"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["folder_id","file"],"title":"Body_upload_document_api_v1_ledger_documents_upload_post"},"Body_upload_documentation_file_admin_help_documentation_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_documentation_file_admin_help_documentation_upload_post"},"Body_upload_documentation_file_api_v1_admin_help_documentation_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_documentation_file_api_v1_admin_help_documentation_upload_post"},"Body_upload_file_api_oauth_file_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_file_api_oauth_file_upload_post"},"Body_upload_file_api_v1_files_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_file_api_v1_files_post"},"Body_upload_file_binary_api_v1_projects__project_id__database_storage_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"bucket":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bucket"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key"},"metadata":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["file"],"title":"Body_upload_file_binary_api_v1_projects__project_id__database_storage_upload_post"},"Body_upload_file_binary_api_v1_projects__project_id__files_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"File to upload"},"bucket":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bucket","description":"Custom bucket name (optional)"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key","description":"Custom file key/path (optional)"},"metadata":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata","description":"JSON metadata (optional)"}},"type":"object","required":["file"],"title":"Body_upload_file_binary_api_v1_projects__project_id__files_upload_post"},"Body_upload_file_binary_api_v1_public_zerodb__project_id__database_storage_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"bucket":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bucket"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key"},"metadata":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["file"],"title":"Body_upload_file_binary_api_v1_public_zerodb__project_id__database_storage_upload_post"},"Body_upload_file_binary_api_v1_public_zerodb__project_id__files_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"File to upload"},"bucket":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bucket","description":"Custom bucket name (optional)"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key","description":"Custom file key/path (optional)"},"metadata":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata","description":"JSON metadata (optional)"}},"type":"object","required":["file"],"title":"Body_upload_file_binary_api_v1_public_zerodb__project_id__files_upload_post"},"Body_upload_logo_api_v1_account_logo_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_logo_api_v1_account_logo_post"},"Body_upload_logo_api_v1_ledger_branding_logo_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_logo_api_v1_ledger_branding_logo_post"},"Body_upload_model_api_v1_public_models_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"name":{"type":"string","title":"Name"},"format":{"type":"string","title":"Format"},"base_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Model"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["file","name","format"],"title":"Body_upload_model_api_v1_public_models_upload_post"},"Body_upload_video_creative_api_v1_paipalooza_ad_creatives_video_post":{"properties":{"video_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Video File","description":"Video file (MP4, MOV, WebM, max 500MB)"},"title":{"type":"string","maxLength":200,"minLength":3,"title":"Title","description":"Creative title"},"call_to_action":{"type":"string","title":"Call To Action","description":"Call-to-action text (e.g., 'Register Now')"},"destination_url":{"type":"string","title":"Destination Url","description":"Destination URL (must be HTTPS)"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description","description":"Creative description"},"duration_seconds":{"anyOf":[{"type":"integer","maximum":120,"minimum":5},{"type":"null"}],"title":"Duration Seconds","description":"Video duration (auto-detected if not provided)"}},"type":"object","required":["video_file","title","call_to_action","destination_url"],"title":"Body_upload_video_creative_api_v1_paipalooza_ad_creatives_video_post"},"Body_upload_w9_api_v1_ledger_vendors_1099__vendor_id__w9_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_w9_api_v1_ledger_vendors_1099__vendor_id__w9_upload_post"},"Body_vacuum_database_api_v1_projects__project_id__database_maintenance_vacuum_post":{"properties":{"full":{"type":"boolean","title":"Full","description":"Perform VACUUM FULL (requires table locks)","default":false},"analyze":{"type":"boolean","title":"Analyze","description":"Also run ANALYZE to update statistics","default":true}},"type":"object","title":"Body_vacuum_database_api_v1_projects__project_id__database_maintenance_vacuum_post"},"Body_vacuum_database_api_v1_public_zerodb__project_id__database_maintenance_vacuum_post":{"properties":{"full":{"type":"boolean","title":"Full","description":"Perform VACUUM FULL (requires table locks)","default":false},"analyze":{"type":"boolean","title":"Analyze","description":"Also run ANALYZE to update statistics","default":true}},"type":"object","title":"Body_vacuum_database_api_v1_public_zerodb__project_id__database_maintenance_vacuum_post"},"BookDemoRequest":{"properties":{"name":{"type":"string","minLength":1,"title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"time_slot":{"type":"string","format":"date-time","title":"Time Slot"}},"type":"object","required":["name","email","time_slot"],"title":"BookDemoRequest"},"BookDemoResponse":{"properties":{"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"},"time_slot":{"type":"string","title":"Time Slot"},"invite_sent":{"type":"boolean","title":"Invite Sent"},"status":{"type":"string","title":"Status"}},"type":"object","required":["time_slot","invite_sent","status"],"title":"BookDemoResponse"},"BootstrapResponse":{"properties":{"client_data":{"$ref":"#/components/schemas/ClientData"},"additional_model_options":{"items":{"$ref":"#/components/schemas/ModelOption"},"type":"array","title":"Additional Model Options"},"plan":{"type":"string","title":"Plan"},"user":{"anyOf":[{"$ref":"#/components/schemas/UserInfo"},{"type":"null"}]},"user_plan":{"type":"string","title":"User Plan","description":"Deprecated alias for plan","default":""},"direct_providers":{"items":{"$ref":"#/components/schemas/DirectProvider"},"type":"array","title":"Direct Providers","description":"Direct inference endpoints. CLI should call these URLs directly instead of routing through api.ainative.studio for listed models. Cuts ~1.5s latency per request."}},"type":"object","required":["client_data","additional_model_options","plan"],"title":"BootstrapResponse","description":"Top-level response for GET /api/v1/cli/bootstrap.\n\nThe CLI parser (src/services/api/bootstrap.ts) reads:\n - plan → subscription tier string\n - user → UserInfo object (id, email, name, organization, organization_id)\n - additional_model_options → list of ModelOption\n - client_data → ClientData defaults\n - direct_providers → direct inference endpoints (bypass AINative for speed)\n\nuser_plan is kept for backwards compatibility but plan is the canonical field."},"BreadcrumbItem":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","title":"BreadcrumbItem"},"BreakdownRow":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"period_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Id"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"customer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Name"},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id"},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Name"},"category_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Id"},"category_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Name"},"revenue_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue Amount"},"invoice_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Invoice Count"},"avg_invoice_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Invoice Value"},"payment_collected_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Payment Collected Amount"},"vendor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Id"},"vendor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Name"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"},"expense_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expense Amount"},"transaction_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Transaction Count"},"avg_transaction_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Transaction Amount"},"balance_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Balance Type"},"current_bucket":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Bucket"},"bucket_1_30":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bucket 1 30"},"bucket_31_60":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bucket 31 60"},"bucket_61_90":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bucket 61 90"},"bucket_90_plus":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bucket 90 Plus"},"total_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Balance"},"overdue_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overdue Balance"}},"type":"object","title":"BreakdownRow","description":"One drilldown row. Fields present depend on ``type`` (revenue |\nexpense | aging) — only the fields for the requested breakdown type are\never populated on a given row; the rest are null."},"BreakdownsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/BreakdownRow"},"type":"array","title":"Data"},"type":{"type":"string","title":"Type"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["data","type","organization_id"],"title":"BreakdownsResponse"},"BridgeCredentialsResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"worker_jwt":{"type":"string","title":"Worker Jwt"},"api_base_url":{"type":"string","title":"Api Base Url"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["session_id","worker_jwt","api_base_url","expires_at"],"title":"BridgeCredentialsResponse"},"BridgeEndpointDescriptor":{"properties":{"path":{"type":"string","title":"Path"},"method":{"type":"string","title":"Method"},"description":{"type":"string","title":"Description"},"auth_required":{"type":"boolean","title":"Auth Required"},"admin_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Admin Only"}},"additionalProperties":true,"type":"object","required":["path","method","description","auth_required"],"title":"BridgeEndpointDescriptor","description":"One entry in GET /agent-bridge/endpoints' available_endpoints.\n\nSparse by design: only admin-gated entries carry `admin_only`, so the\nroute declares response_model_exclude_unset=True to keep the key\nabsent rather than emitting `\"admin_only\": null` on the others."},"BridgeEndpointsData":{"properties":{"available_endpoints":{"items":{"$ref":"#/components/schemas/BridgeEndpointDescriptor"},"type":"array","title":"Available Endpoints"},"total_endpoints":{"type":"integer","title":"Total Endpoints"},"version":{"type":"string","title":"Version"},"documentation_url":{"type":"string","title":"Documentation Url"},"user_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Role"},"user_permissions":{"$ref":"#/components/schemas/BridgeUserPermissions"}},"additionalProperties":true,"type":"object","required":["available_endpoints","total_endpoints","version","documentation_url","user_permissions"],"title":"BridgeEndpointsData","description":"The `data` payload of GET /agent-bridge/endpoints."},"BridgeEndpointsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/BridgeEndpointsData"}},"additionalProperties":true,"type":"object","required":["success","data"],"title":"BridgeEndpointsResponse","description":"Response for GET /agent-bridge/endpoints."},"BridgeEnvironmentResponse":{"properties":{"environment_id":{"type":"string","title":"Environment Id"},"provider":{"type":"string","title":"Provider"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["environment_id","provider","status","created_at"],"title":"BridgeEnvironmentResponse"},"BridgeMetrics":{"properties":{"total_agents":{"type":"integer","title":"Total Agents"},"active_agents":{"type":"integer","title":"Active Agents"},"inactive_agents":{"type":"integer","title":"Inactive Agents"},"average_cpu_usage":{"type":"number","title":"Average Cpu Usage"},"average_memory_usage":{"type":"number","title":"Average Memory Usage"},"average_response_time_ms":{"type":"number","title":"Average Response Time Ms"},"workload_entries":{"type":"integer","title":"Workload Entries"},"uptime_percentage":{"type":"number","title":"Uptime Percentage"},"last_updated":{"type":"string","title":"Last Updated"}},"additionalProperties":true,"type":"object","required":["total_agents","active_agents","inactive_agents","average_cpu_usage","average_memory_usage","average_response_time_ms","workload_entries","uptime_percentage","last_updated"],"title":"BridgeMetrics","description":"The `data` payload of GET /agent-bridge/metrics."},"BridgeMetricsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/BridgeMetrics"}},"additionalProperties":true,"type":"object","required":["success","data"],"title":"BridgeMetricsResponse","description":"Response for GET /agent-bridge/metrics."},"BridgeStatusResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["success","data"],"title":"BridgeStatusResponse"},"BridgeUserPermissions":{"properties":{"can_view_metrics":{"type":"boolean","title":"Can View Metrics"},"can_manage_agents":{"type":"boolean","title":"Can Manage Agents"},"can_send_messages":{"type":"boolean","title":"Can Send Messages"}},"additionalProperties":false,"type":"object","required":["can_view_metrics","can_manage_agents","can_send_messages"],"title":"BridgeUserPermissions","description":"The caller's computed permissions in GET /agent-bridge/endpoints.\n\nNOT extra=\"allow\", and every field required: these three booleans are\nthe result of a real per-caller admin check in the handler\n(`is_superuser or role == \"ADMIN\"`). Keeping the model closed and\nexplicit means a future handler change cannot leak an extra\npermission flag through, and no field can default to a value the\ncheck did not produce."},"BroadcastFeedbackEventResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["status","message"],"title":"BroadcastFeedbackEventResponse","description":"Response for POST /feedback/websocket/broadcast."},"BrowserActRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Target URL to navigate to"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt","description":"Natural language description of the action to perform"},"instruction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instruction","description":"Alias for prompt (MCP client field name)"},"max_steps":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Max Steps","description":"Max steps for the action"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Optional session ID for continuity"}},"type":"object","required":["url"],"title":"BrowserActRequest","description":"Accepts both `prompt` (REST API) and `instruction` (MCP client) field names."},"BrowserActResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"action_taken":{"type":"string","title":"Action Taken"},"session_id":{"type":"string","title":"Session Id"},"url":{"type":"string","title":"Url"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success","action_taken","session_id","url"],"title":"BrowserActResponse"},"BrowserAgentHealthResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'ok' when this route responds"},"service":{"type":"string","title":"Service","description":"Subsystem identifier: 'browser-agent'"},"endpoints":{"items":{"type":"string"},"type":"array","title":"Endpoints","description":"Absolute paths served by the browser agent subsystem"}},"type":"object","required":["status","service","endpoints"],"title":"BrowserAgentHealthResponse","description":"Static health/discovery document for the browser agent subsystem.\n\nRefs #8449. Every field is unconditionally present and the body is fully\nstatic — no request-, time- or permission-dependent keys — so no\n`response_model_exclude_unset` is needed or wanted here."},"BrowserEchoToolCatalogEntry":{"properties":{"tool_id":{"type":"string","title":"Tool Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"credit_cost":{"type":"integer","title":"Credit Cost"},"input_schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Input Schema"},"output_schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Output Schema"}},"type":"object","required":["tool_id","name","description","category","credit_cost","input_schema","output_schema"],"title":"BrowserEchoToolCatalogEntry"},"BrowserEnrichMemoryRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Target URL to extract content from"},"prompt":{"type":"string","title":"Prompt","description":"What content to extract and remember"},"memory_type":{"type":"string","title":"Memory Type","description":"Memory type: episodic | semantic | procedural","default":"episodic"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id","description":"Agent ID to associate the memory with"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["url","prompt"],"title":"BrowserEnrichMemoryRequest"},"BrowserEnrichMemoryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Id"},"url":{"type":"string","title":"Url"},"memory_type":{"type":"string","title":"Memory Type"},"session_id":{"type":"string","title":"Session Id"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success","memory_id","url","memory_type","session_id"],"title":"BrowserEnrichMemoryResponse"},"BrowserExtractRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Target URL to extract data from"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt","description":"What data to extract"},"extract_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extract Goal","description":"Alias for prompt (MCP client field name)"},"schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schema","description":"JSON schema describing the expected output structure"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Optional session ID for continuity"}},"type":"object","required":["url"],"title":"BrowserExtractRequest","description":"Accepts both `prompt` (REST API) and `extract_goal` (MCP client) field names.\n`schema` is optional — defaults to a generic key-value extraction schema."},"BrowserExtractResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"title":"Data"},"session_id":{"type":"string","title":"Session Id"},"url":{"type":"string","title":"Url"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success","data","session_id","url"],"title":"BrowserExtractResponse"},"BrowserExtractToTableRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Target URL to extract data from"},"prompt":{"type":"string","title":"Prompt","description":"What data to extract"},"schema":{"additionalProperties":true,"type":"object","title":"Schema","description":"JSON schema describing the expected row structure"},"table_name":{"type":"string","title":"Table Name","description":"ZeroDB table name to insert rows into"},"project_id":{"type":"string","title":"Project Id","description":"ZeroDB project ID"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["url","prompt","schema","table_name","project_id"],"title":"BrowserExtractToTableRequest"},"BrowserExtractToTableResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"rows_inserted":{"type":"integer","title":"Rows Inserted"},"table_name":{"type":"string","title":"Table Name"},"url":{"type":"string","title":"Url"},"session_id":{"type":"string","title":"Session Id"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success","rows_inserted","table_name","url","session_id"],"title":"BrowserExtractToTableResponse"},"BrowserTaskRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Starting URL for the task"},"goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goal","description":"High-level goal for the autonomous agent to achieve"},"task_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Description","description":"Alias for goal (MCP client field name)"},"max_steps":{"anyOf":[{"type":"integer","maximum":50,"minimum":1},{"type":"null"}],"title":"Max Steps","description":"Max steps (default 20, max 50)"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Optional session ID for continuity"},"cookies":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Cookies","description":"Cookies to inject before navigation (e.g. session cookies)"}},"type":"object","required":["url"],"title":"BrowserTaskRequest","description":"Accepts both `goal` (REST API) and `task_description` (MCP client) field names."},"BrowserTaskResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"goal":{"type":"string","title":"Goal"},"steps_taken":{"type":"integer","title":"Steps Taken"},"result_summary":{"type":"string","title":"Result Summary"},"session_id":{"type":"string","title":"Session Id"},"url":{"type":"string","title":"Url"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success","goal","steps_taken","result_summary","session_id","url"],"title":"BrowserTaskResponse"},"BrowserValidateRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Target URL to validate"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt","description":"Natural language condition to check (returns true/false)"},"assertion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assertion","description":"Alias for prompt (MCP client field name)"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Optional session ID for continuity"}},"type":"object","required":["url"],"title":"BrowserValidateRequest","description":"Accepts both `prompt` (REST API) and `assertion` (MCP client) field names."},"BrowserValidateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"result":{"type":"boolean","title":"Result"},"url":{"type":"string","title":"Url"},"session_id":{"type":"string","title":"Session Id"}},"type":"object","required":["success","result","url","session_id"],"title":"BrowserValidateResponse"},"BucketPolicyAppliedResponse":{"properties":{"bucket_name":{"type":"string","title":"Bucket Name"},"project_id":{"type":"string","title":"Project Id"},"public_prefixes":{"items":{"type":"string"},"type":"array","title":"Public Prefixes"},"statements_count":{"type":"integer","title":"Statements Count"},"status":{"type":"string","title":"Status"}},"type":"object","required":["bucket_name","project_id","public_prefixes","statements_count","status"],"title":"BucketPolicyAppliedResponse","description":"Response for POST /bucket-policy/public-read (minio_service.set_public_read_policy)."},"BucketPolicyGetResponse":{"properties":{"bucket_name":{"type":"string","title":"Bucket Name"},"project_id":{"type":"string","title":"Project Id"},"policy":{"additionalProperties":true,"type":"object","title":"Policy"},"status":{"type":"string","title":"Status"}},"type":"object","required":["bucket_name","project_id","policy","status"],"title":"BucketPolicyGetResponse","description":"Response for GET /bucket-policy/{project_id} (minio_service.get_bucket_policy).\n\n`status` is \"ok\" when a policy exists, \"no_policy\" when none is set\n(NoSuchBucketPolicy) — `policy` is `{}` in the no_policy case."},"BucketPolicyRemovedResponse":{"properties":{"bucket_name":{"type":"string","title":"Bucket Name"},"project_id":{"type":"string","title":"Project Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["bucket_name","project_id","status"],"title":"BucketPolicyRemovedResponse","description":"Response for DELETE /bucket-policy/{project_id} (minio_service.remove_bucket_policy)."},"BudgetCreateRequest":{"properties":{"agent_id":{"type":"string","maxLength":255,"minLength":1,"title":"Agent Id"},"limit_usd":{"type":"number","maximum":1000000,"exclusiveMinimum":0,"title":"Limit Usd"},"period":{"type":"string","pattern":"^(day|week|month)$","title":"Period","description":"day | week | month"},"max_task_cost_usd":{"anyOf":[{"type":"number","maximum":10000,"exclusiveMinimum":0},{"type":"null"}],"title":"Max Task Cost Usd","description":"Max cost for any single task (Refs #2421)"},"auto_pause":{"type":"boolean","title":"Auto Pause","description":"Auto-pause agent when budget exhausted (Refs #2422)","default":false}},"type":"object","required":["agent_id","limit_usd","period"],"title":"BudgetCreateRequest"},"BudgetItem":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"limit_usd":{"type":"number","title":"Limit Usd"},"period":{"type":"string","title":"Period"},"current_spend_usd":{"type":"number","title":"Current Spend Usd","default":0},"max_task_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Task Cost Usd"},"auto_pause":{"type":"boolean","title":"Auto Pause","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","agent_id","limit_usd","period","created_at","updated_at"],"title":"BudgetItem"},"BudgetListResponse":{"properties":{"budgets":{"items":{"$ref":"#/components/schemas/BudgetItem"},"type":"array","title":"Budgets"}},"type":"object","required":["budgets"],"title":"BudgetListResponse"},"BuildDatasetRequest":{"properties":{"records":{"items":{"$ref":"#/components/schemas/InteractionRecordModel"},"type":"array","title":"Records","description":"Raw interaction records to transform into SFT data"},"min_reward":{"type":"number","maximum":1,"minimum":0,"title":"Min Reward","description":"Min reward to keep a scored record","default":0.7},"require_scored":{"type":"boolean","title":"Require Scored","description":"Drop records with no reward and no is_positive flag","default":false},"include_jsonl":{"type":"boolean","title":"Include Jsonl","description":"Include the full JSONL payload in the response (can be large)","default":false}},"type":"object","required":["records"],"title":"BuildDatasetRequest"},"BuildDatasetResponse":{"properties":{"total_input":{"type":"integer","title":"Total Input"},"kept":{"type":"integer","title":"Kept"},"dropped":{"type":"integer","title":"Dropped"},"jsonl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jsonl"}},"type":"object","required":["total_input","kept","dropped"],"title":"BuildDatasetResponse"},"BuildFromArtifactsRequest":{"properties":{"artifact_min_reward":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Artifact Min Reward","description":"Keep only captured artifacts scored >= this reward"},"limit":{"type":"integer","maximum":10000,"minimum":1,"title":"Limit","default":1000},"include_file_path":{"type":"boolean","title":"Include File Path","default":true},"min_reward":{"type":"number","maximum":1,"minimum":0,"title":"Min Reward","default":0.7},"require_scored":{"type":"boolean","title":"Require Scored","default":false},"include_jsonl":{"type":"boolean","title":"Include Jsonl","default":false}},"type":"object","title":"BuildFromArtifactsRequest"},"BuildFromDbRequest":{"properties":{"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id","description":"Filter to one agent; null reads across all"},"limit":{"type":"integer","maximum":5000,"minimum":1,"title":"Limit","description":"Max rows to pull","default":500},"days":{"type":"integer","maximum":365,"minimum":1,"title":"Days","description":"Look-back window","default":30},"min_reward":{"type":"number","maximum":1,"minimum":0,"title":"Min Reward","default":0.7},"require_scored":{"type":"boolean","title":"Require Scored","default":false},"include_jsonl":{"type":"boolean","title":"Include Jsonl","default":false}},"type":"object","title":"BuildFromDbRequest"},"BuildFromDocsRequest":{"properties":{"roots":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Roots","description":"Doc roots to scan; defaults to SDK guides + API ref + package READMEs + docs-site."},"max_files":{"type":"integer","maximum":10000,"minimum":1,"title":"Max Files","default":2000},"max_records":{"type":"integer","maximum":20000,"minimum":1,"title":"Max Records","default":5000},"min_reward":{"type":"number","maximum":1,"minimum":0,"title":"Min Reward","default":0.7},"require_scored":{"type":"boolean","title":"Require Scored","default":false},"include_jsonl":{"type":"boolean","title":"Include Jsonl","default":false}},"type":"object","title":"BuildFromDocsRequest"},"BuildFromGitRequest":{"properties":{"max_commits":{"type":"integer","maximum":5000,"minimum":1,"title":"Max Commits","default":500},"since_days":{"type":"integer","maximum":730,"minimum":1,"title":"Since Days","default":180},"max_diff_chars":{"type":"integer","maximum":50000,"minimum":100,"title":"Max Diff Chars","default":8000},"min_reward":{"type":"number","maximum":1,"minimum":0,"title":"Min Reward","default":0.7},"require_scored":{"type":"boolean","title":"Require Scored","default":false},"include_jsonl":{"type":"boolean","title":"Include Jsonl","default":false}},"type":"object","title":"BuildFromGitRequest"},"BuilderModelCatalogResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"models":{"items":{"$ref":"#/components/schemas/BuilderModelEntry"},"type":"array","title":"Models"}},"type":"object","required":["ok","models"],"title":"BuilderModelCatalogResponse"},"BuilderModelEntry":{"properties":{"id":{"type":"string","title":"Id"},"provider":{"type":"string","title":"Provider"},"backend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backend"},"label":{"type":"string","title":"Label"},"capabilities":{"$ref":"#/components/schemas/ModelCapabilities"},"context_window":{"type":"integer","title":"Context Window"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"tier":{"type":"string","title":"Tier"},"pricing":{"$ref":"#/components/schemas/ModelPricing"},"group":{"type":"string","title":"Group"},"default":{"type":"boolean","title":"Default"}},"type":"object","required":["id","provider","label","capabilities","context_window","tags","tier","pricing","group","default"],"title":"BuilderModelEntry","description":"A ModelEntry plus the two fields _builder_coding_models() adds for the\nBuilder dropdown: its display optgroup and whether it's pre-selected."},"BulkAnalysisPromptResult":{"properties":{"total_recommendations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Recommendations"},"recommendations":{"anyOf":[{"items":{"$ref":"#/components/schemas/BulkAnalysisRecommendationSummary"},"type":"array"},{"type":"null"}],"title":"Recommendations"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","title":"BulkAnalysisPromptResult","description":"Per-prompt entry inside a completed task's `results` map -- either\nthe real recommendations summary, or {\"error\": str} if that one\nprompt's analysis raised (see _process_bulk_analysis)."},"BulkAnalysisRecommendationSummary":{"properties":{"recommendation_id":{"type":"string","title":"Recommendation Id"},"type":{"type":"string","title":"Type"},"priority":{"type":"string","title":"Priority"},"confidence_score":{"type":"number","title":"Confidence Score"},"title":{"type":"string","title":"Title"}},"type":"object","required":["recommendation_id","type","priority","confidence_score","title"],"title":"BulkAnalysisRecommendationSummary"},"BulkAnalysisRequest":{"properties":{"prompt_ids":{"items":{"type":"string"},"type":"array","maxItems":50,"minItems":1,"title":"Prompt Ids","description":"List of prompt IDs to analyze"},"analysis_window_days":{"type":"integer","maximum":365,"minimum":1,"title":"Analysis Window Days","description":"Analysis window in days","default":30},"min_confidence":{"type":"number","maximum":1,"minimum":0,"title":"Min Confidence","description":"Minimum confidence threshold","default":0.5}},"type":"object","required":["prompt_ids"],"title":"BulkAnalysisRequest"},"BulkAnalysisStartResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"},"prompt_count":{"type":"integer","title":"Prompt Count"},"analysis_window_days":{"type":"integer","title":"Analysis Window Days"},"min_confidence":{"type":"number","title":"Min Confidence"},"estimated_completion":{"type":"string","title":"Estimated Completion"},"message":{"type":"string","title":"Message"}},"type":"object","required":["task_id","status","prompt_count","analysis_window_days","min_confidence","estimated_completion","message"],"title":"BulkAnalysisStartResponse","description":"Real shape returned by POST /recommendations/bulk-analysis --\nmatches bulk_prompt_analysis()'s literal return dict exactly."},"BulkAnalysisStartedResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"},"prompt_count":{"type":"integer","title":"Prompt Count"},"analysis_window_days":{"type":"integer","title":"Analysis Window Days"},"min_confidence":{"type":"number","title":"Min Confidence"},"estimated_completion":{"type":"string","title":"Estimated Completion"},"message":{"type":"string","title":"Message"}},"type":"object","required":["task_id","status","prompt_count","analysis_window_days","min_confidence","estimated_completion","message"],"title":"BulkAnalysisStartedResponse","description":"Response for POST /recommendations/bulk-analysis."},"BulkAnalysisStatusResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"},"progress":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Progress"},"total_prompts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Prompts"},"completed_prompts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completed Prompts"},"user_id":{"type":"string","title":"User Id"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"failed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failed At"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"results":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/BulkAnalysisPromptResult"},"type":"object"},{"type":"null"}],"title":"Results"}},"type":"object","required":["task_id","status","user_id"],"title":"BulkAnalysisStatusResponse","description":"Real shape stored/returned by get_bulk_analysis_status() across all\nthree states _process_bulk_analysis() writes to cache: processing,\ncompleted (adds completed_at + results), and failed (adds error +\nfailed_at instead of progress/total_prompts/completed_prompts)."},"BulkCreateRequest":{"properties":{"notifications":{"items":{"$ref":"#/components/schemas/BulkNotificationCreate"},"type":"array","maxItems":100,"minItems":1,"title":"Notifications"}},"type":"object","required":["notifications"],"title":"BulkCreateRequest","description":"Schema for bulk create request - supports up to 100 notifications","example":{"notifications":[{"action_url":"/dashboard","message":"Welcome to AINative Studio!","title":"Welcome","type":"INFO","user_id":"550e8400-e29b-41d4-a716-446655440000"},{"action_url":"/profile","message":"Your account setup is complete.","title":"Account Created","type":"SUCCESS","user_id":"550e8400-e29b-41d4-a716-446655440000"}]}},"BulkDeleteResponse":{"properties":{"deleted_count":{"type":"integer","title":"Deleted Count","description":"Number of rows deleted"},"filter_used":{"additionalProperties":true,"type":"object","title":"Filter Used","description":"Filter criteria used"},"execution_time_ms":{"type":"number","title":"Execution Time Ms","description":"Operation execution time in milliseconds"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","description":"Operation warnings"}},"type":"object","required":["deleted_count","filter_used","execution_time_ms"],"title":"BulkDeleteResponse","description":"Response schema for bulk row deletions"},"BulkDownloadData":{"properties":{"invoices":{"items":{"$ref":"#/components/schemas/BulkDownloadInvoiceItem"},"type":"array","title":"Invoices"},"total_requested":{"type":"integer","title":"Total Requested"},"total_available":{"type":"integer","title":"Total Available"},"failed":{"items":{"$ref":"#/components/schemas/BulkDownloadFailedItem"},"type":"array","title":"Failed"}},"type":"object","required":["invoices","total_requested","total_available","failed"],"title":"BulkDownloadData"},"BulkDownloadFailedItem":{"properties":{"invoice_id":{"type":"string","title":"Invoice Id"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["invoice_id","reason"],"title":"BulkDownloadFailedItem"},"BulkDownloadInvoiceItem":{"properties":{"invoice_id":{"type":"string","title":"Invoice Id"},"invoice_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Number"},"pdf_url":{"type":"string","title":"Pdf Url"},"amount":{"type":"number","title":"Amount"},"currency":{"type":"string","title":"Currency"},"created_at":{"title":"Created At"}},"additionalProperties":true,"type":"object","required":["invoice_id","pdf_url","amount","currency"],"title":"BulkDownloadInvoiceItem"},"BulkDownloadResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/BulkDownloadData"}},"type":"object","required":["success","data"],"title":"BulkDownloadResponse","description":"Response for POST /billing/invoices/download-bulk."},"BulkInvoiceBackfillRequest":{"properties":{"target_month":{"type":"string","title":"Target Month"},"plan_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Name","default":"Enterprise"}},"type":"object","required":["target_month"],"title":"BulkInvoiceBackfillRequest"},"BulkInvoiceBackfillResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"queued":{"anyOf":[{"items":{"$ref":"#/components/schemas/QueuedInvoice"},"type":"array"},{"type":"null"}],"title":"Queued"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"target_month":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Month"},"plan_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Name"},"queued_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Queued Count"},"failed_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Failed Count"},"failed":{"anyOf":[{"items":{"$ref":"#/components/schemas/FailedInvoice"},"type":"array"},{"type":"null"}],"title":"Failed"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success"],"title":"BulkInvoiceBackfillResponse","description":"Three real shapes: no-accounts-found (success + queued: [] + message),\nnormal completion (success + target_month/plan_name/queued_count/\nfailed_count/queued/failed), and the outer-exception branch\n(success=False + error). All optional fields + exclude_none."},"BulkMarkReadRequest":{"properties":{"notification_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":100,"minItems":1,"title":"Notification Ids"}},"type":"object","required":["notification_ids"],"title":"BulkMarkReadRequest","description":"Schema for bulk mark as read request - supports up to 100 notification IDs","example":{"notification_ids":["123e4567-e89b-12d3-a456-426614174000","223e4567-e89b-12d3-a456-426614174001"]}},"BulkNotificationCreate":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"message":{"type":"string","minLength":1,"title":"Message"},"action_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Url"},"user_id":{"type":"string","format":"uuid","title":"User Id"}},"type":"object","required":["type","title","message","user_id"],"title":"BulkNotificationCreate","description":"Schema for bulk creating notifications - same user_id for all","example":{"action_url":"/features","message":"New features have been released!","title":"System Update","type":"INFO","user_id":"550e8400-e29b-41d4-a716-446655440000"}},"BulkOperationError":{"properties":{"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"index":{"type":"integer","title":"Index"},"error":{"type":"string","title":"Error"}},"type":"object","required":["index","error"],"title":"BulkOperationError","description":"Schema for individual error in bulk operation","example":{"error":"Notification not found","index":2,"item_id":"123e4567-e89b-12d3-a456-426614174000"}},"BulkOperationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"count":{"type":"integer","title":"Count"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","count","message"],"title":"BulkOperationResponse","description":"Schema for bulk operation responses","example":{"count":12,"message":"Successfully marked 12 notifications as read","success":true}},"BulkOperationResult":{"properties":{"success_count":{"type":"integer","title":"Success Count","description":"Number of successful operations"},"error_count":{"type":"integer","title":"Error Count","description":"Number of failed operations"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","description":"Error messages"},"total_time_ms":{"type":"number","title":"Total Time Ms","description":"Total operation time in milliseconds"}},"type":"object","required":["success_count","error_count","total_time_ms"],"title":"BulkOperationResult","description":"BulkOperationResult schema"},"BulkReelBatchCreateResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"batch_id":{"type":"string","title":"Batch Id"},"status":{"type":"string","title":"Status"},"progress":{"type":"integer","title":"Progress"},"total_rows":{"type":"integer","title":"Total Rows"}},"type":"object","required":["task_id","batch_id","status","progress","total_rows"],"title":"BulkReelBatchCreateResponse"},"BulkReelBatchResult":{"properties":{"reels":{"items":{"$ref":"#/components/schemas/BulkReelItem"},"type":"array","title":"Reels"}},"type":"object","required":["reels"],"title":"BulkReelBatchResult"},"BulkReelBatchStatusResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"batch_id":{"type":"string","title":"Batch Id"},"status":{"type":"string","title":"Status"},"progress":{"type":"integer","title":"Progress"},"result":{"$ref":"#/components/schemas/BulkReelBatchResult"}},"type":"object","required":["task_id","batch_id","status","progress","result"],"title":"BulkReelBatchStatusResponse"},"BulkReelItem":{"properties":{"reel_id":{"type":"string","title":"Reel Id"},"status":{"type":"string","title":"Status"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["reel_id","status"],"title":"BulkReelItem"},"BulkRowCreateError":{"properties":{"index":{"type":"integer","title":"Index","description":"Index of the failed row in the request's `rows` array"},"error":{"type":"string","title":"Error","description":"Error message for this row"}},"type":"object","required":["index","error"],"title":"BulkRowCreateError","description":"A single failed row within a batch insert."},"BulkRowCreateRequest":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/ZeroDBRowCreate"},"type":"array","maxItems":1000,"minItems":1,"title":"Rows","description":"Rows to insert, in order (max 1000 per request)"}},"type":"object","required":["rows"],"title":"BulkRowCreateRequest","description":"Request schema for batch row insertion.\n\nAccepts an array of rows to insert into a table in a single request, so an\nagent populating a table does not need to loop one POST .../rows call per\nrow (AX audit, Refs AINative-Studio/ainative-website#2211)."},"BulkRowCreateResponse":{"properties":{"created":{"items":{"$ref":"#/components/schemas/ZeroDBRowResponse"},"type":"array","title":"Created","description":"Successfully created rows, in request order"},"errors":{"items":{"$ref":"#/components/schemas/BulkRowCreateError"},"type":"array","title":"Errors","description":"Per-row errors for rows that failed to insert"},"success_count":{"type":"integer","title":"Success Count","description":"Number of rows successfully inserted"},"error_count":{"type":"integer","title":"Error Count","description":"Number of rows that failed to insert"},"total_time_ms":{"type":"number","title":"Total Time Ms","description":"Total operation time in milliseconds"}},"type":"object","required":["success_count","error_count","total_time_ms"],"title":"BulkRowCreateResponse","description":"Response schema for batch row insertion.\n\nPartial-failure semantics: each row is inserted independently. A bad row\n(e.g. a storage-limit violation) is reported in `errors` and does NOT fail\nthe rest of the batch — this matches the existing vectors batch-upsert\nendpoint (`POST .../vectors/upsert-batch` -> BulkOperationResult). Only a\nrequest-level failure (e.g. the table itself does not exist) fails the\nentire request with an HTTP error, since there is nowhere to insert."},"BulkSeedRequest":{"properties":{"domains":{"items":{"$ref":"#/components/schemas/SeedDomainEntry"},"type":"array","maxItems":2000,"minItems":1,"title":"Domains","description":"Domains to seed, max 2000 per request"}},"type":"object","required":["domains"],"title":"BulkSeedRequest"},"BulkSeedResponse":{"properties":{"accepted":{"type":"integer","title":"Accepted"},"rejected":{"type":"integer","title":"Rejected"},"rejected_domains":{"items":{"type":"string"},"type":"array","title":"Rejected Domains"},"queued_task_ids":{"items":{"type":"string"},"type":"array","title":"Queued Task Ids"}},"type":"object","required":["accepted","rejected","rejected_domains","queued_task_ids"],"title":"BulkSeedResponse"},"BulkStatsRequest":{"properties":{"project_ids":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Project Ids","description":"List of project IDs (max 100)"}},"type":"object","required":["project_ids"],"title":"BulkStatsRequest","description":"Request model for bulk project stats"},"BulkStatsResponse":{"properties":{"stats":{"items":{"$ref":"#/components/schemas/app__zerodb__api__project_router__ProjectStats"},"type":"array","title":"Stats"},"total_projects":{"type":"integer","title":"Total Projects"},"page":{"type":"integer","title":"Page","default":1},"page_size":{"type":"integer","title":"Page Size","default":50},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["stats","total_projects"],"title":"BulkStatsResponse","description":"Response model for bulk project stats"},"BulkUpdateRequest":{"properties":{"filter":{"additionalProperties":true,"type":"object","title":"Filter","description":"MongoDB-style filter to match rows for update"},"update":{"additionalProperties":true,"type":"object","title":"Update","description":"MongoDB-style update operators ($set, $inc, $push, $pull, $unset)"},"confirm_large_operation":{"type":"boolean","title":"Confirm Large Operation","description":"Confirmation flag required for operations affecting >100 rows","default":false}},"type":"object","required":["filter","update"],"title":"BulkUpdateRequest","description":"Request schema for bulk row updates with MongoDB-style operators"},"BulkUpdateResponse":{"properties":{"matched_count":{"type":"integer","title":"Matched Count","description":"Number of rows matched by filter"},"modified_count":{"type":"integer","title":"Modified Count","description":"Number of rows actually modified"},"filter_used":{"additionalProperties":true,"type":"object","title":"Filter Used","description":"Filter criteria used"},"update_operators":{"additionalProperties":true,"type":"object","title":"Update Operators","description":"Update operators applied"},"execution_time_ms":{"type":"number","title":"Execution Time Ms","description":"Operation execution time in milliseconds"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","description":"Operation warnings"}},"type":"object","required":["matched_count","modified_count","filter_used","update_operators","execution_time_ms"],"title":"BulkUpdateResponse","description":"Response schema for bulk row updates"},"BulkUserOperationsResponse":{"properties":{"message":{"type":"string","title":"Message"},"affected_users":{"type":"integer","title":"Affected Users"},"total_requested":{"type":"integer","title":"Total Requested"}},"type":"object","required":["message","affected_users","total_requested"],"title":"BulkUserOperationsResponse"},"BundleDownloadResponse":{"properties":{"bundle_id":{"type":"string","title":"Bundle Id"},"bundle_data":{"additionalProperties":true,"type":"object","title":"Bundle Data"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum"}},"type":"object","required":["bundle_id","bundle_data","created_at"],"title":"BundleDownloadResponse"},"BundleInfo":{"properties":{"bundle_id":{"type":"string","title":"Bundle Id"},"bundle_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bundle Name"},"status":{"type":"string","title":"Status","default":"ready"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"entity_counts":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Entity Counts"}},"type":"object","required":["bundle_id","created_at"],"title":"BundleInfo"},"BundleUploadRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"bundle_data":{"additionalProperties":true,"type":"object","title":"Bundle Data","description":"Bundle data containing vectors, tables, memory, events, files to sync"},"bundle_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bundle Name","description":"Bundle name"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"compression":{"type":"boolean","title":"Compression","default":true}},"type":"object","required":["project_id","bundle_data"],"title":"BundleUploadRequest"},"BundleUploadResponse":{"properties":{"upload_id":{"type":"string","title":"Upload Id"},"bundle_id":{"type":"string","title":"Bundle Id"},"status":{"type":"string","title":"Status","default":"ready"},"estimated_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Size Bytes"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"applied":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Applied","description":"Count of entities applied per service"}},"type":"object","required":["upload_id","bundle_id","created_at"],"title":"BundleUploadResponse"},"BusinessResult":{"properties":{"businesses":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Businesses"},"contacts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Contacts"},"total_businesses":{"type":"integer","title":"Total Businesses","default":0},"total_contacts":{"type":"integer","title":"Total Contacts","default":0},"source":{"type":"string","title":"Source","default":"lakehouse"},"historical_data":{"items":{},"type":"array","title":"Historical Data"}},"type":"object","title":"BusinessResult"},"BusinessScanRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Business website or API base URL"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Business name (auto-detected if omitted)"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Business description"}},"type":"object","required":["url"],"title":"BusinessScanRequest","description":"Request to auto-discover business capabilities from a URL."},"BusinessScanResponse":{"properties":{"url":{"type":"string","title":"Url"},"name":{"type":"string","title":"Name"},"capabilities":{"items":{"$ref":"#/components/schemas/DiscoveredCapability"},"type":"array","title":"Capabilities"},"protocols_found":{"items":{"type":"string"},"type":"array","title":"Protocols Found"},"readiness_score":{"type":"number","maximum":100,"minimum":0,"title":"Readiness Score"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id","description":"Agent ID if auto-registered"},"message":{"type":"string","title":"Message"}},"type":"object","required":["url","name","capabilities","protocols_found","readiness_score","message"],"title":"BusinessScanResponse","description":"Result of scanning a business URL for agent-readable capabilities."},"BusinessSignals":{"properties":{"mrr_trend_7d":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Mrr Trend 7D"},"stripe_events_7d":{"type":"integer","title":"Stripe Events 7D"},"emails_delivered_7d":{"type":"integer","title":"Emails Delivered 7D"},"open_pipeline_value":{"type":"number","title":"Open Pipeline Value"},"open_deals_count":{"type":"integer","title":"Open Deals Count"},"commerce_revenue_7d":{"type":"number","title":"Commerce Revenue 7D"},"source":{"type":"string","title":"Source"}},"type":"object","required":["mrr_trend_7d","stripe_events_7d","emails_delivered_7d","open_pipeline_value","open_deals_count","commerce_revenue_7d","source"],"title":"BusinessSignals","description":"Business intelligence signals from lake exports. Refs #3364 #3365 #3366 #3367"},"ByomServeAdapter":{"properties":{"name":{"type":"string","title":"Name","description":"Adapter name; becomes the byom:{name} model ref"},"spaces_url":{"type":"string","title":"Spaces Url","description":"DO Spaces URL of the .safetensors adapter"}},"type":"object","required":["name","spaces_url"],"title":"ByomServeAdapter"},"ByomServeNodeResponse":{"properties":{"droplet_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Droplet Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"size_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size Slug"},"hourly_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Hourly Cost Usd"},"vllm_port":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vllm Port"},"adapters":{"items":{"type":"string"},"type":"array","title":"Adapters"}},"additionalProperties":true,"type":"object","title":"ByomServeNodeResponse","description":"provision_byom_serve_node() returns the provision result plus the vLLM\nserving fields. DO Spaces credentials are deliberately consumed by the\nservice and never returned — nothing here re-exposes them."},"ByomServeRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Droplet name"},"base_model":{"type":"string","title":"Base Model","description":"HF base model id all adapters share","default":"meta-llama/Llama-3.3-70B-Instruct"},"adapters":{"items":{"$ref":"#/components/schemas/ByomServeAdapter"},"type":"array","minItems":1,"title":"Adapters"},"region":{"type":"string","title":"Region","description":"DO region","default":"atl1"}},"type":"object","required":["name","adapters"],"title":"ByomServeRequest"},"CCREventDeliveryRequest":{"properties":{"events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Events","description":"Batch of CCR v2 events"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["events"],"title":"CCREventDeliveryRequest"},"CCREventDeliveryResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"accepted":{"type":"integer","title":"Accepted"},"sequence_start":{"type":"integer","title":"Sequence Start"}},"type":"object","required":["session_id","accepted","sequence_start"],"title":"CCREventDeliveryResponse"},"CDNCacheMetrics":{"properties":{"status":{"type":"string","title":"Status"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"edge_locations":{"type":"integer","title":"Edge Locations"},"cache_hit_ratio":{"type":"number","title":"Cache Hit Ratio"},"bandwidth_saved":{"type":"string","title":"Bandwidth Saved"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["status","edge_locations","cache_hit_ratio","bandwidth_saved","recommendations"],"title":"CDNCacheMetrics"},"CLIFeedbackCreate":{"properties":{"feedback_text":{"type":"string","maxLength":10000,"minLength":1,"title":"Feedback Text","description":"User feedback text (max 10,000 characters)"},"session_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Session Id","description":"Optional CLI session identifier"},"category":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Category","description":"Optional feedback category (e.g. bug, feature_request, usability)"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Optional metadata (cli_version, os, etc.)"}},"type":"object","required":["feedback_text"],"title":"CLIFeedbackCreate","description":"Schema for submitting CLI feedback."},"CLIFeedbackResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Unique feedback record ID"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp when feedback was received"},"status":{"type":"string","title":"Status","description":"Feedback status","default":"received"}},"type":"object","required":["id","created_at"],"title":"CLIFeedbackResponse","description":"Schema for feedback submission response."},"CLIReleaseHistoryItem":{"properties":{"version":{"type":"string","title":"Version"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"platforms":{"items":{"$ref":"#/components/schemas/CLIReleasePlatform"},"type":"array","title":"Platforms"},"changelog_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Changelog Url"}},"type":"object","required":["version","published_at"],"title":"CLIReleaseHistoryItem","description":"A release entry in the history listing."},"CLIReleaseHistoryResponse":{"properties":{"releases":{"items":{"$ref":"#/components/schemas/CLIReleaseHistoryItem"},"type":"array","title":"Releases"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["releases","total"],"title":"CLIReleaseHistoryResponse","description":"Response for GET /cli/releases/history."},"CLIReleaseInfo":{"properties":{"version":{"type":"string","title":"Version","description":"Semver version string (e.g., 1.2.3)"},"published_at":{"type":"string","format":"date-time","title":"Published At","description":"When the release was published"},"changelog_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Changelog Url","description":"URL to the changelog"}},"type":"object","required":["version","published_at"],"title":"CLIReleaseInfo","description":"Latest stable release info returned by GET /cli/releases/stable."},"CLIReleasePlatform":{"properties":{"platform":{"type":"string","title":"Platform","description":"OS platform (darwin, linux, windows)"},"arch":{"type":"string","title":"Arch","description":"Architecture (amd64, arm64)"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url","description":"Direct download URL"},"checksum_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum Sha256","description":"SHA256 checksum of the binary"},"file_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size Bytes","description":"File size in bytes"}},"type":"object","required":["platform","arch"],"title":"CLIReleasePlatform","description":"Platform availability for a release."},"CLIUsageResponse":{"properties":{"usage_percentage":{"type":"number","maximum":100,"minimum":0,"title":"Usage Percentage","description":"Overall usage percentage 0-100 (derived from 5-hour window utilization)","default":0},"five_hour":{"$ref":"#/components/schemas/UsageWindow","description":"Usage window for the last 5 hours"},"seven_day":{"$ref":"#/components/schemas/UsageWindow","description":"Usage window for the last 7 days"},"extra_usage":{"$ref":"#/components/schemas/ExtraUsage","description":"Extra usage allowance details"}},"type":"object","required":["five_hour","seven_day","extra_usage"],"title":"CLIUsageResponse","description":"Response model for GET /api/oauth/usage.\n\nIncludes usage_percentage (0-100) for the Cody CLI /usage command.\nRefs #3219"},"CSATRequest":{"properties":{"conversation_id":{"type":"integer","title":"Conversation Id"},"rating":{"type":"integer","maximum":5,"minimum":1,"title":"Rating","description":"1-5 star rating"},"comment":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Comment"},"ai_draft_used":{"type":"boolean","title":"Ai Draft Used","default":false},"ai_draft_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ai Draft Id"},"contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Email"},"deflected":{"type":"boolean","title":"Deflected","default":false}},"type":"object","required":["conversation_id","rating"],"title":"CSATRequest"},"CSATResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"csat_id":{"type":"string","title":"Csat Id"}},"type":"object","required":["csat_id"],"title":"CSATResponse"},"CSVExportResponse":{"properties":{"filename":{"type":"string","title":"Filename","description":"Generated CSV filename"},"content":{"type":"string","title":"Content","description":"CSV content as string"},"row_count":{"type":"integer","minimum":0,"title":"Row Count","description":"Number of data rows"},"generated_at":{"type":"string","format":"date-time","title":"Generated At","description":"Export timestamp"}},"type":"object","required":["filename","content","row_count","generated_at"],"title":"CSVExportResponse","description":"Response for CSV export with download URL or content"},"CacheAnalyticsResponse":{"properties":{"period":{"type":"string","title":"Period"},"period_hours":{"type":"integer","title":"Period Hours"},"generated_at":{"type":"string","title":"Generated At"},"performance_trends":{"$ref":"#/components/schemas/PerformanceTrends"},"cache_effectiveness":{"$ref":"#/components/schemas/CacheEffectiveness"},"top_cached_items":{"items":{"$ref":"#/components/schemas/TopCachedItem"},"type":"array","title":"Top Cached Items"},"cache_misses_analysis":{"$ref":"#/components/schemas/CacheMissesAnalysis"},"optimization_opportunities":{"items":{"$ref":"#/components/schemas/OptimizationOpportunity"},"type":"array","title":"Optimization Opportunities"}},"type":"object","required":["period","period_hours","generated_at","performance_trends","cache_effectiveness","top_cached_items","cache_misses_analysis","optimization_opportunities"],"title":"CacheAnalyticsResponse","description":"Response for GET /cache/analytics."},"CacheConfiguration":{"properties":{"redis":{"$ref":"#/components/schemas/RedisConfig"},"application":{"$ref":"#/components/schemas/ApplicationConfig"},"strategies":{"$ref":"#/components/schemas/CacheStrategiesConfig"},"eviction_policies":{"$ref":"#/components/schemas/EvictionPoliciesConfig"}},"type":"object","required":["redis","application","strategies","eviction_policies"],"title":"CacheConfiguration"},"CacheCostSavings":{"properties":{"database_queries_avoided":{"type":"integer","title":"Database Queries Avoided"},"network_requests_saved":{"type":"integer","title":"Network Requests Saved"},"estimated_cost_savings":{"type":"string","title":"Estimated Cost Savings"}},"type":"object","required":["database_queries_avoided","network_requests_saved","estimated_cost_savings"],"title":"CacheCostSavings"},"CacheDeleteRequest":{"properties":{"namespace":{"type":"string","title":"Namespace"},"key":{"type":"string","title":"Key"}},"type":"object","required":["namespace","key"],"title":"CacheDeleteRequest"},"CacheDeleteResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"deleted":{"type":"integer","title":"Deleted"}},"type":"object","required":["ok","deleted"],"title":"CacheDeleteResponse"},"CacheEffectiveness":{"properties":{"database_load_reduction":{"type":"string","title":"Database Load Reduction"},"api_response_acceleration":{"type":"string","title":"Api Response Acceleration"},"bandwidth_savings":{"type":"string","title":"Bandwidth Savings"},"cost_optimization":{"type":"string","title":"Cost Optimization"}},"type":"object","required":["database_load_reduction","api_response_acceleration","bandwidth_savings","cost_optimization"],"title":"CacheEffectiveness"},"CacheGetRequest":{"properties":{"namespace":{"type":"string","title":"Namespace"},"key":{"type":"string","title":"Key"}},"type":"object","required":["namespace","key"],"title":"CacheGetRequest"},"CacheGetResponse":{"properties":{"hit":{"type":"boolean","title":"Hit"},"value":{"title":"Value"}},"type":"object","required":["hit"],"title":"CacheGetResponse"},"CacheHealth":{"properties":{"score":{"type":"integer","title":"Score"},"status":{"type":"string","title":"Status"},"issues":{"items":{"type":"string"},"type":"array","title":"Issues"},"last_checked":{"type":"string","title":"Last Checked"}},"type":"object","required":["score","status","issues","last_checked"],"title":"CacheHealth"},"CacheHealthAlert":{"properties":{"level":{"type":"string","title":"Level"},"message":{"type":"string","title":"Message"},"action":{"type":"string","title":"Action"}},"type":"object","required":["level","message","action"],"title":"CacheHealthAlert"},"CacheHealthCheckItem":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"response_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Time"},"redis_memory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redis Memory"},"app_cache_memory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Cache Memory"},"redis_hit_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redis Hit Ratio"},"app_hit_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Hit Ratio"},"average_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Average Response"},"p95_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"P95 Response"},"evictions_per_hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Evictions Per Hour"},"recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation"},"error_rate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Rate"},"recent_errors":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Recent Errors"}},"type":"object","required":["status","message"],"title":"CacheHealthCheckItem"},"CacheHealthCheckResponse":{"properties":{"overall_health":{"type":"string","title":"Overall Health"},"last_checked":{"type":"string","title":"Last Checked"},"checks":{"$ref":"#/components/schemas/CacheHealthChecks"},"performance_indicators":{"$ref":"#/components/schemas/CachePerformanceIndicators"},"alerts":{"items":{"$ref":"#/components/schemas/CacheHealthAlert"},"type":"array","title":"Alerts"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["overall_health","last_checked","checks","performance_indicators","alerts","recommendations"],"title":"CacheHealthCheckResponse","description":"Response for GET /cache/health."},"CacheHealthChecks":{"properties":{"redis_connectivity":{"$ref":"#/components/schemas/CacheHealthCheckItem"},"memory_usage":{"$ref":"#/components/schemas/CacheHealthCheckItem"},"hit_ratio":{"$ref":"#/components/schemas/CacheHealthCheckItem"},"performance":{"$ref":"#/components/schemas/CacheHealthCheckItem"},"eviction_rate":{"$ref":"#/components/schemas/CacheHealthCheckItem"},"error_rate":{"$ref":"#/components/schemas/CacheHealthCheckItem"}},"type":"object","required":["redis_connectivity","memory_usage","hit_ratio","performance","eviction_rate","error_rate"],"title":"CacheHealthChecks"},"CacheHealthInfo":{"properties":{"status":{"type":"string","title":"Status"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status"],"title":"CacheHealthInfo","description":"Cache health information"},"CacheInvalidateResponse":{"properties":{"invalidation_id":{"type":"string","title":"Invalidation Id"},"type":{"type":"string","title":"Type"},"patterns":{"items":{"type":"string"},"type":"array","title":"Patterns"},"keys":{"items":{"type":"string"},"type":"array","title":"Keys"},"cache_layers":{"items":{"type":"string"},"type":"array","title":"Cache Layers"},"results":{"items":{"$ref":"#/components/schemas/CacheInvalidationResult"},"type":"array","title":"Results"},"total_invalidated":{"type":"integer","title":"Total Invalidated"},"invalidated_at":{"type":"string","title":"Invalidated At"},"invalidated_by":{"title":"Invalidated By"}},"type":"object","required":["invalidation_id","type","patterns","keys","cache_layers","results","total_invalidated","invalidated_at","invalidated_by"],"title":"CacheInvalidateResponse","description":"Response for POST /cache/invalidate."},"CacheInvalidationLayerResult":{"properties":{"status":{"type":"string","title":"Status"},"invalidated_count":{"type":"integer","title":"Invalidated Count"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status","invalidated_count"],"title":"CacheInvalidationLayerResult"},"CacheInvalidationResult":{"properties":{"layer":{"type":"string","title":"Layer"},"result":{"$ref":"#/components/schemas/CacheInvalidationLayerResult"}},"type":"object","required":["layer","result"],"title":"CacheInvalidationResult"},"CacheKeyAnalysisResponse":{"properties":{"total_keys":{"type":"integer","title":"Total Keys"},"analyzed_keys":{"type":"integer","title":"Analyzed Keys"},"pattern_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pattern Filter"},"key_statistics":{"$ref":"#/components/schemas/CacheKeyStatistics"},"key_patterns":{"items":{"$ref":"#/components/schemas/CacheKeyPatternDetail"},"type":"array","title":"Key Patterns"},"optimization_suggestions":{"items":{"$ref":"#/components/schemas/CacheKeyOptimizationSuggestion"},"type":"array","title":"Optimization Suggestions"}},"type":"object","required":["total_keys","analyzed_keys","key_statistics","key_patterns","optimization_suggestions"],"title":"CacheKeyAnalysisResponse","description":"Response for GET /cache/keys."},"CacheKeyOptimizationSuggestion":{"properties":{"pattern":{"type":"string","title":"Pattern"},"suggestion":{"type":"string","title":"Suggestion"},"potential_benefit":{"type":"string","title":"Potential Benefit"}},"type":"object","required":["pattern","suggestion","potential_benefit"],"title":"CacheKeyOptimizationSuggestion"},"CacheKeyPatternDetail":{"properties":{"pattern":{"type":"string","title":"Pattern"},"count":{"type":"integer","title":"Count"},"total_size":{"type":"string","title":"Total Size"},"average_ttl":{"type":"integer","title":"Average Ttl"},"hit_ratio":{"type":"number","title":"Hit Ratio"},"access_frequency":{"type":"string","title":"Access Frequency"}},"type":"object","required":["pattern","count","total_size","average_ttl","hit_ratio","access_frequency"],"title":"CacheKeyPatternDetail"},"CacheKeyStatistics":{"properties":{"average_size":{"type":"number","title":"Average Size"},"median_ttl":{"type":"integer","title":"Median Ttl"},"most_accessed":{"type":"string","title":"Most Accessed"},"largest_key":{"type":"string","title":"Largest Key"}},"type":"object","required":["average_size","median_ttl","most_accessed","largest_key"],"title":"CacheKeyStatistics"},"CacheLayers":{"properties":{"redis":{"$ref":"#/components/schemas/RedisMetrics"},"application":{"$ref":"#/components/schemas/ApplicationCacheMetrics"},"database":{"$ref":"#/components/schemas/DatabaseCacheMetrics"},"cdn":{"$ref":"#/components/schemas/CDNCacheMetrics"}},"type":"object","required":["redis","application","database","cdn"],"title":"CacheLayers"},"CacheMetricsResponse":{"properties":{"hit_rate":{"type":"number","title":"Hit Rate"},"total_requests":{"type":"integer","title":"Total Requests"},"cache_hits":{"type":"integer","title":"Cache Hits"},"cache_misses":{"type":"integer","title":"Cache Misses"},"note":{"type":"string","title":"Note"}},"type":"object","required":["hit_rate","total_requests","cache_hits","cache_misses","note"],"title":"CacheMetricsResponse"},"CacheMissesAnalysis":{"properties":{"total_misses":{"type":"integer","title":"Total Misses"},"cold_cache_misses":{"type":"integer","title":"Cold Cache Misses"},"expired_key_misses":{"type":"integer","title":"Expired Key Misses"},"evicted_key_misses":{"type":"integer","title":"Evicted Key Misses"},"miss_patterns":{"items":{"$ref":"#/components/schemas/MissPattern"},"type":"array","title":"Miss Patterns"}},"type":"object","required":["total_misses","cold_cache_misses","expired_key_misses","evicted_key_misses","miss_patterns"],"title":"CacheMissesAnalysis"},"CacheOptimizationTask":{"properties":{"task":{"type":"string","title":"Task"},"description":{"type":"string","title":"Description"},"estimated_duration":{"type":"string","title":"Estimated Duration"}},"type":"object","required":["task","description","estimated_duration"],"title":"CacheOptimizationTask"},"CacheOptimizeResponse":{"properties":{"optimization_id":{"type":"string","title":"Optimization Id"},"type":{"type":"string","title":"Type"},"target_metrics":{"additionalProperties":true,"type":"object","title":"Target Metrics"},"tasks":{"items":{"$ref":"#/components/schemas/CacheOptimizationTask"},"type":"array","title":"Tasks"},"status":{"type":"string","title":"Status"},"started_at":{"type":"string","title":"Started At"},"started_by":{"title":"Started By"},"estimated_completion":{"type":"string","title":"Estimated Completion"}},"type":"object","required":["optimization_id","type","target_metrics","tasks","status","started_at","started_by","estimated_completion"],"title":"CacheOptimizeResponse","description":"Response for POST /cache/optimize."},"CachePerformanceIndicators":{"properties":{"cache_efficiency":{"type":"string","title":"Cache Efficiency"},"memory_efficiency":{"type":"string","title":"Memory Efficiency"},"network_efficiency":{"type":"string","title":"Network Efficiency"},"cost_efficiency":{"type":"string","title":"Cost Efficiency"}},"type":"object","required":["cache_efficiency","memory_efficiency","network_efficiency","cost_efficiency"],"title":"CachePerformanceIndicators"},"CachePerformanceMetrics":{"properties":{"overall_hit_ratio":{"type":"number","title":"Overall Hit Ratio"},"average_response_time":{"type":"number","title":"Average Response Time"},"cache_efficiency_score":{"type":"integer","title":"Cache Efficiency Score"},"memory_efficiency":{"type":"number","title":"Memory Efficiency"},"network_efficiency":{"type":"number","title":"Network Efficiency"},"cost_savings":{"$ref":"#/components/schemas/CacheCostSavings"},"bottlenecks":{"items":{"type":"string"},"type":"array","title":"Bottlenecks"},"optimizations_applied":{"items":{"type":"string"},"type":"array","title":"Optimizations Applied"}},"type":"object","required":["overall_hit_ratio","average_response_time","cache_efficiency_score","memory_efficiency","network_efficiency","cost_savings","bottlenecks","optimizations_applied"],"title":"CachePerformanceMetrics"},"CacheScanRequest":{"properties":{"namespace":{"type":"string","title":"Namespace"},"pattern":{"type":"string","title":"Pattern","default":"*"}},"type":"object","required":["namespace"],"title":"CacheScanRequest"},"CacheScanResponse":{"properties":{"keys":{"items":{"type":"string"},"type":"array","title":"Keys"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["keys","count"],"title":"CacheScanResponse"},"CacheSetRequest":{"properties":{"namespace":{"type":"string","title":"Namespace"},"key":{"type":"string","title":"Key"},"value":{"title":"Value"},"ttl_seconds":{"type":"integer","maximum":86400,"minimum":1,"title":"Ttl Seconds","default":3600}},"type":"object","required":["namespace","key","value"],"title":"CacheSetRequest"},"CacheSetResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"}},"type":"object","required":["ok"],"title":"CacheSetResponse"},"CacheStatusResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"overall_health":{"$ref":"#/components/schemas/CacheHealth"},"cache_layers":{"$ref":"#/components/schemas/CacheLayers"},"configuration":{"$ref":"#/components/schemas/CacheConfiguration"},"performance_metrics":{"$ref":"#/components/schemas/CachePerformanceMetrics"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["timestamp","overall_health","cache_layers","configuration","performance_metrics","recommendations"],"title":"CacheStatusResponse","description":"Response for GET /cache/status."},"CacheStrategiesConfig":{"properties":{"user_sessions":{"type":"string","title":"User Sessions"},"api_responses":{"type":"string","title":"Api Responses"},"query_results":{"type":"string","title":"Query Results"},"static_data":{"type":"string","title":"Static Data"}},"type":"object","required":["user_sessions","api_responses","query_results","static_data"],"title":"CacheStrategiesConfig"},"CacheWarmResponse":{"properties":{"warming_id":{"type":"string","title":"Warming Id"},"status":{"type":"string","title":"Status"},"tasks":{"items":{"$ref":"#/components/schemas/CacheWarmingTask"},"type":"array","title":"Tasks"},"priority":{"type":"string","title":"Priority"},"started_at":{"type":"string","title":"Started At"},"started_by":{"title":"Started By"},"estimated_completion":{"type":"string","title":"Estimated Completion"}},"type":"object","required":["warming_id","status","tasks","priority","started_at","started_by","estimated_completion"],"title":"CacheWarmResponse","description":"Response for POST /cache/warm."},"CacheWarmingTask":{"properties":{"type":{"type":"string","title":"Type"},"description":{"type":"string","title":"Description"},"estimated_items":{"type":"integer","title":"Estimated Items"},"estimated_duration":{"type":"string","title":"Estimated Duration"}},"type":"object","required":["type","description","estimated_items","estimated_duration"],"title":"CacheWarmingTask"},"CalendarCreateRequest":{"properties":{"title":{"type":"string","title":"Title","description":"Event title"},"start":{"type":"string","title":"Start","description":"Start datetime ISO 8601"},"end":{"type":"string","title":"End","description":"End datetime ISO 8601"},"description":{"type":"string","title":"Description","description":"Event description","default":""},"attendees":{"items":{"type":"string"},"type":"array","title":"Attendees","description":"Attendee emails"},"calendar_id":{"type":"string","title":"Calendar Id","description":"Calendar ID","default":"primary"}},"type":"object","required":["title","start","end"],"title":"CalendarCreateRequest"},"CalendarCreateResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"html_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Html Link"},"title":{"type":"string","title":"Title"},"message":{"type":"string","title":"Message"}},"type":"object","required":["title","message"],"title":"CalendarCreateResponse"},"CalendarItemCreate":{"properties":{"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"script":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script"},"twin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Twin Id"},"platform":{"type":"string","pattern":"^(instagram|tiktok|linkedin|youtube)$","title":"Platform"},"scheduled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled At"}},"type":"object","required":["title","platform"],"title":"CalendarItemCreate"},"CalendarItemResponse":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"script":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script"},"twin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Twin Id"},"platform":{"type":"string","title":"Platform"},"scheduled_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled At"},"status":{"type":"string","title":"Status"},"publish_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publish Task Id"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","title","platform","status","created_at"],"title":"CalendarItemResponse"},"CalendarItemUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"script":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script"},"twin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Twin Id"},"platform":{"anyOf":[{"type":"string","pattern":"^(instagram|tiktok|linkedin|youtube)$"},{"type":"null"}],"title":"Platform"},"scheduled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled At"},"status":{"anyOf":[{"type":"string","pattern":"^(draft|scheduled|published|failed)$"},{"type":"null"}],"title":"Status"}},"type":"object","title":"CalendarItemUpdate"},"CallToAction":{"type":"string","enum":["Learn More","Sign Up","Get Started","Register Now","Visit Website","Download","Contact Us","Read More","Watch Now","Try Free","Start Free Trial","Buy Now","Book Now","Shop Now"],"title":"CallToAction","description":"Standard call-to-action options"},"CallbackRequest":{"properties":{"auth_code":{"type":"string","minLength":1,"title":"Auth Code"},"realm_id":{"type":"string","minLength":1,"title":"Realm Id"},"state":{"type":"string","minLength":1,"title":"State"}},"type":"object","required":["auth_code","realm_id","state"],"title":"CallbackRequest","description":"OAuth callback payload.\n\nSent as a POST body rather than query params, so an authorization code\nnever lands in access logs."},"CallbackResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"},"realm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Realm Id"},"sync_triggered":{"type":"boolean","title":"Sync Triggered","default":false}},"type":"object","required":["connected"],"title":"CallbackResponse"},"CampaignBreakdown":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign UUID"},"campaign_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Name","description":"Campaign name"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","default":0},"ctr":{"type":"number","maximum":1,"minimum":0,"title":"Ctr","default":0},"spend":{"type":"string","title":"Spend","default":0}},"type":"object","required":["campaign_id"],"title":"CampaignBreakdown","description":"Performance breakdown by campaign for a creative"},"CampaignClickItem":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"},"product":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product"},"click_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Click Source"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"converted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Converted"},"converted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Converted At"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"created_at":{"type":"string","title":"Created At"},"has_account":{"type":"boolean","title":"Has Account"},"user_active":{"type":"boolean","title":"User Active"},"subscription_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Tier"},"subscription_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Status"}},"type":"object","required":["created_at","has_account","user_active"],"title":"CampaignClickItem","description":"A single click record as returned by GET /campaign/clicks/{campaign_id}"},"CampaignClicksData":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"clicks":{"items":{"$ref":"#/components/schemas/CampaignClickItem"},"type":"array","title":"Clicks"},"count":{"type":"integer","title":"Count"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["campaign_id","count","limit","offset","has_more"],"title":"CampaignClicksData","description":"``data`` payload for GET /campaign/clicks/{campaign_id}"},"CampaignClicksResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/CampaignClicksData"}},"type":"object","required":["data"],"title":"CampaignClicksResponse","description":"Response for GET /campaign/clicks/{campaign_id}"},"CampaignConversionFixData":{"properties":{"dry_run":{"type":"boolean","title":"Dry Run"},"total_pending":{"type":"integer","title":"Total Pending"},"activated":{"type":"integer","title":"Activated"},"no_account":{"type":"integer","title":"No Account"},"already_paid":{"type":"integer","title":"Already Paid"},"errors":{"type":"integer","title":"Errors"},"details":{"items":{"$ref":"#/components/schemas/CampaignConversionFixDetail"},"type":"array","title":"Details"}},"type":"object","required":["dry_run","total_pending","activated","no_account","already_paid","errors"],"title":"CampaignConversionFixData","description":"``data`` payload for POST /campaign/fix-conversions/{campaign_id}"},"CampaignConversionFixDetail":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"CampaignConversionFixDetail","description":"One entry in the ``details`` list of POST /campaign/fix-conversions/{campaign_id}"},"CampaignConversionFixResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/CampaignConversionFixData"}},"type":"object","required":["data"],"title":"CampaignConversionFixResponse","description":"Response for POST /campaign/fix-conversions/{campaign_id}"},"CampaignCreate":{"properties":{"sponsor_id":{"type":"string","title":"Sponsor Id","description":"Sponsor ID"},"name":{"type":"string","maxLength":200,"minLength":3,"title":"Name","description":"Campaign name"},"creative_ids":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Creative Ids","description":"List of approved creative IDs to use in campaign"},"budget_credits":{"type":"integer","maximum":1000000,"minimum":1,"title":"Budget Credits","description":"Total budget in credits (1 credit = $1)"},"daily_budget":{"type":"integer","maximum":100000,"minimum":1,"title":"Daily Budget","description":"Daily budget in credits (1 credit = $1)"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Campaign start date/time (UTC)"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"Campaign end date/time (UTC)"},"targeting":{"anyOf":[{"$ref":"#/components/schemas/EventTargeting"},{"type":"null"}],"description":"Event targeting criteria (null = target all events)"},"selection_strategy":{"$ref":"#/components/schemas/SelectionStrategy","description":"Creative selection strategy (default: rotation)","default":"rotation"},"frequency_cap":{"anyOf":[{"$ref":"#/components/schemas/FrequencyCap"},{"type":"null"}],"description":"Frequency cap to limit impressions per user (optional)"}},"type":"object","required":["sponsor_id","name","creative_ids","budget_credits","daily_budget","start_date","end_date"],"title":"CampaignCreate","description":"Schema for creating a campaign","example":{"budget_credits":1000,"creative_ids":["creative_def456","creative_ghi789"],"daily_budget":50,"end_date":"2026-03-31T23:59:59Z","name":"AI Conference Q1 2026","sponsor_id":"sponsor_abc123","start_date":"2026-01-15T00:00:00Z","targeting":{"event_types":["conference","hackathon"],"locations":["San Francisco","New York"],"topics":["AI","ML"]}}},"CampaignCreateRequest":{"properties":{"code":{"type":"string","maxLength":50,"minLength":3,"title":"Code","description":"Unique gift code"},"name":{"type":"string","maxLength":255,"minLength":3,"title":"Name","description":"Campaign name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Campaign description"},"access_level":{"type":"string","title":"Access Level","description":"Access level: all_access, premium, pro, trial","default":"all_access"},"duration_days":{"type":"integer","exclusiveMinimum":0,"title":"Duration Days","description":"Duration in days (e.g., 30)"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Campaign start date"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"Campaign end date"},"max_redemptions":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}],"title":"Max Redemptions","description":"Max total redemptions (null = unlimited)"},"max_redemptions_per_user":{"type":"integer","minimum":1,"title":"Max Redemptions Per User","description":"Max redemptions per user","default":1},"campaign_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Type","description":"Campaign type (new_year, etc.)"}},"type":"object","required":["code","name","duration_days","start_date","end_date"],"title":"CampaignCreateRequest","description":"Request schema for creating a gift campaign"},"CampaignListResponse":{"properties":{"campaigns":{"items":{"$ref":"#/components/schemas/CampaignResponse"},"type":"array","title":"Campaigns"},"total":{"type":"integer","title":"Total","description":"Total campaigns matching filters"},"limit":{"type":"integer","title":"Limit","description":"Results per page","default":20},"offset":{"type":"integer","title":"Offset","description":"Pagination offset","default":0},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results are available","default":false}},"type":"object","required":["campaigns","total"],"title":"CampaignListResponse","description":"Schema for campaign list response","example":{"campaigns":[{"budget_credits":1000,"created_at":"2026-01-05T12:00:00Z","creative_ids":["creative_def456"],"daily_budget":50,"end_date":"2026-03-31T23:59:59Z","id":"camp_abc123","name":"AI Conference Q1 2026","remaining_credits":750,"spent_credits":250,"sponsor_id":"sponsor_xyz789","start_date":"2026-01-15T00:00:00Z","status":"active","targeting":{"event_types":["conference"],"locations":["San Francisco"],"topics":["AI"]},"updated_at":"2026-01-10T15:30:00Z"}],"has_more":false,"limit":20,"offset":0,"total":1}},"CampaignMetrics":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign UUID"},"campaign_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Name","description":"Campaign name for display"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","description":"Total impressions","default":0},"unique_impressions":{"type":"integer","minimum":0,"title":"Unique Impressions","description":"Unique user impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","description":"Total clicks","default":0},"completions":{"type":"integer","minimum":0,"title":"Completions","description":"Video completions (100% watched)","default":0},"ctr":{"type":"number","maximum":1,"minimum":0,"title":"Ctr","description":"Click-through rate (clicks/impressions)","default":0},"completion_rate":{"type":"number","maximum":1,"minimum":0,"title":"Completion Rate","description":"Completion rate (completions/impressions)","default":0},"total_spend":{"type":"string","title":"Total Spend","description":"Total spend in USD","default":0},"avg_cpm":{"type":"string","title":"Avg Cpm","description":"Average CPM (cost per 1000 impressions)","default":0},"avg_cpc":{"type":"string","title":"Avg Cpc","description":"Average CPC (cost per click)","default":0},"period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period Start","description":"Start of time period"},"period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period End","description":"End of time period"}},"type":"object","required":["campaign_id"],"title":"CampaignMetrics","description":"Core campaign performance metrics\n\nAll metrics calculated from aggregations of impressions, clicks, and completions."},"CampaignPerformanceResponse":{"properties":{"campaign":{"$ref":"#/components/schemas/CampaignMetrics","description":"Overall campaign metrics"},"by_creative":{"anyOf":[{"items":{"$ref":"#/components/schemas/CreativePerformance"},"type":"array"},{"type":"null"}],"title":"By Creative","description":"Performance breakdown by creative"},"by_event":{"anyOf":[{"items":{"$ref":"#/components/schemas/EventPerformance"},"type":"array"},{"type":"null"}],"title":"By Event","description":"Performance breakdown by event"},"time_range":{"$ref":"#/components/schemas/TimeRange-Output","description":"Time range used for metrics"},"generated_at":{"type":"string","format":"date-time","title":"Generated At","description":"Timestamp when report was generated"}},"type":"object","required":["campaign","time_range","generated_at"],"title":"CampaignPerformanceResponse","description":"Full campaign performance response\n\nIncludes overall metrics plus breakdowns by creative and event."},"CampaignResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Campaign ID"},"sponsor_id":{"type":"string","title":"Sponsor Id"},"name":{"type":"string","title":"Name"},"status":{"$ref":"#/components/schemas/CampaignStatus"},"creative_ids":{"items":{"type":"string"},"type":"array","title":"Creative Ids"},"budget_credits":{"type":"integer","title":"Budget Credits","description":"Total budget allocated"},"daily_budget":{"type":"integer","title":"Daily Budget","description":"Daily budget in credits"},"spent_credits":{"type":"integer","title":"Spent Credits","description":"Credits spent so far"},"remaining_credits":{"type":"integer","title":"Remaining Credits","description":"Budget remaining"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"targeting":{"anyOf":[{"$ref":"#/components/schemas/EventTargeting"},{"type":"null"}]},"selection_strategy":{"$ref":"#/components/schemas/SelectionStrategy","description":"Creative selection strategy","default":"rotation"},"frequency_cap":{"anyOf":[{"$ref":"#/components/schemas/FrequencyCap"},{"type":"null"}],"description":"Frequency cap to limit impressions per user"},"pause_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pause Reason","description":"Reason for pause: 'daily_budget_exhausted', 'sponsor_requested', etc."},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","sponsor_id","name","status","creative_ids","budget_credits","daily_budget","spent_credits","remaining_credits","start_date","end_date","created_at"],"title":"CampaignResponse","description":"Schema for campaign response","example":{"budget_credits":1000,"created_at":"2026-01-05T12:00:00Z","creative_ids":["creative_def456"],"daily_budget":50,"end_date":"2026-03-31T23:59:59Z","id":"camp_abc123","name":"AI Conference Q1 2026","remaining_credits":1000,"spent_credits":0,"sponsor_id":"sponsor_xyz789","start_date":"2026-01-15T00:00:00Z","status":"draft","targeting":{"event_types":["conference","hackathon"],"locations":["San Francisco","New York"],"topics":["AI","ML"]}}},"CampaignStatsData":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"total_clicks":{"type":"integer","title":"Total Clicks"},"unique_clicks":{"type":"integer","title":"Unique Clicks"},"conversions":{"type":"integer","title":"Conversions"},"conversion_rate":{"type":"number","title":"Conversion Rate"},"clicks_by_source":{"additionalProperties":{"type":"integer"},"type":"object","title":"Clicks By Source"},"retrieved_at":{"type":"string","title":"Retrieved At"}},"type":"object","required":["campaign_id","total_clicks","unique_clicks","conversions","conversion_rate","retrieved_at"],"title":"CampaignStatsData","description":"``data`` payload for GET /campaign/stats/{campaign_id}"},"CampaignStatsResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/CampaignStatsData"}},"type":"object","required":["data"],"title":"CampaignStatsResponse","description":"Response for GET /campaign/stats/{campaign_id}"},"CampaignStatus":{"type":"string","enum":["draft","active","paused","completed","cancelled"],"title":"CampaignStatus","description":"Campaign status values"},"CampaignUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":200,"minLength":3},{"type":"null"}],"title":"Name"},"creative_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","minItems":1},{"type":"null"}],"title":"Creative Ids"},"budget_credits":{"anyOf":[{"type":"integer","maximum":1000000,"minimum":1},{"type":"null"}],"title":"Budget Credits"},"daily_budget":{"anyOf":[{"type":"integer","maximum":100000,"minimum":1},{"type":"null"}],"title":"Daily Budget"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date","description":"Can extend end date, but not move it earlier"},"targeting":{"anyOf":[{"$ref":"#/components/schemas/EventTargeting"},{"type":"null"}]},"selection_strategy":{"anyOf":[{"$ref":"#/components/schemas/SelectionStrategy"},{"type":"null"}],"description":"Creative selection strategy"},"frequency_cap":{"anyOf":[{"$ref":"#/components/schemas/FrequencyCap"},{"type":"null"}],"description":"Frequency cap to limit impressions per user"}},"type":"object","title":"CampaignUpdate","description":"Schema for updating a campaign","example":{"budget_credits":1500,"end_date":"2026-04-30T23:59:59Z","name":"Updated Campaign Name","targeting":{"event_types":["conference"],"locations":["San Francisco"],"topics":["AI","ML","Deep Learning"]}}},"CampaignUsage":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"campaign_name":{"type":"string","title":"Campaign Name"},"credits_used":{"type":"integer","title":"Credits Used"},"impressions":{"type":"integer","title":"Impressions"},"clicks":{"type":"integer","title":"Clicks"},"ctr":{"type":"number","title":"Ctr","description":"Click-through rate (%)"},"avg_cpm":{"type":"string","title":"Avg Cpm","description":"Average cost per thousand impressions"}},"type":"object","required":["campaign_id","campaign_name","credits_used","impressions","clicks","ctr","avg_cpm"],"title":"CampaignUsage","description":"Schema for per-campaign credit usage","example":{"avg_cpm":"10.00","campaign_id":"camp_abc123","campaign_name":"Summer Campaign 2026","clicks":300,"credits_used":150,"ctr":2,"impressions":15000}},"CancelAgentTaskResponse":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"updated_at":{"type":"string","title":"Updated At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","status","updated_at","message"],"title":"CancelAgentTaskResponse"},"CancelContinuousEvaluationResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"template_id":{"type":"string","title":"Template Id"}},"type":"object","required":["status","message","template_id"],"title":"CancelContinuousEvaluationResponse"},"CancelScheduledResponse":{"properties":{"canceled":{"type":"boolean","title":"Canceled"},"id":{"type":"string","title":"Id"}},"type":"object","required":["canceled","id"],"title":"CancelScheduledResponse"},"CapabilityInfo":{"properties":{"capability":{"type":"string","title":"Capability"},"description":{"type":"string","title":"Description"}},"type":"object","required":["capability","description"],"title":"CapabilityInfo"},"CapacityCurrentUtilization":{"properties":{"cpu":{"type":"number","title":"Cpu"},"memory":{"type":"number","title":"Memory"},"storage":{"type":"number","title":"Storage"},"network":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Network"}},"type":"object","required":["cpu","memory","storage"],"title":"CapacityCurrentUtilization"},"CapacityLimits":{"properties":{"cpu_cores":{"type":"integer","title":"Cpu Cores"},"memory_gb":{"type":"number","title":"Memory Gb"},"storage_gb":{"type":"number","title":"Storage Gb"},"network_mbps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Network Mbps"}},"type":"object","required":["cpu_cores","memory_gb","storage_gb"],"title":"CapacityLimits"},"CapacityOverview":{"properties":{"current_utilization":{"$ref":"#/components/schemas/CapacityCurrentUtilization"},"capacity_limits":{"$ref":"#/components/schemas/CapacityLimits"},"projected_usage":{"$ref":"#/components/schemas/CapacityProjectedUsage"},"scaling_recommendations":{"items":{"type":"string"},"type":"array","title":"Scaling Recommendations"}},"type":"object","required":["current_utilization","capacity_limits","projected_usage","scaling_recommendations"],"title":"CapacityOverview","description":"Two real shapes: happy path (full detail) and exception fallback."},"CapacityProjectedUsage":{"properties":{"7_days":{"$ref":"#/components/schemas/CapacityProjection"},"30_days":{"$ref":"#/components/schemas/CapacityProjection"}},"type":"object","required":["7_days","30_days"],"title":"CapacityProjectedUsage"},"CapacityProjection":{"properties":{"cpu":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpu"},"memory":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Memory"},"storage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Storage"}},"type":"object","title":"CapacityProjection"},"CapacityValues":{"properties":{"cpu_cores":{"type":"integer","title":"Cpu Cores"},"memory_gb":{"type":"integer","title":"Memory Gb"},"storage_gb":{"type":"integer","title":"Storage Gb"},"network_bandwidth_mbps":{"type":"integer","title":"Network Bandwidth Mbps"}},"type":"object","required":["cpu_cores","memory_gb","storage_gb","network_bandwidth_mbps"],"title":"CapacityValues"},"CaptionBurnInResponse":{"properties":{"caption_id":{"type":"string","title":"Caption Id"},"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["caption_id","task_id","status"],"title":"CaptionBurnInResponse"},"CaptionDetailResponse":{"properties":{"caption_id":{"type":"string","title":"Caption Id"},"reel_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reel Url"},"srt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Srt"},"vtt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vtt"},"burn_in_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Burn In Url"},"segments":{"items":{"$ref":"#/components/schemas/CaptionSegmentResponse"},"type":"array","title":"Segments"}},"type":"object","required":["caption_id","segments"],"title":"CaptionDetailResponse"},"CaptionGenerateResponse":{"properties":{"caption_id":{"type":"string","title":"Caption Id"},"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["caption_id","task_id","status"],"title":"CaptionGenerateResponse"},"CaptionPatchRequest":{"properties":{"segments":{"items":{"$ref":"#/components/schemas/SegmentEdit"},"type":"array","title":"Segments"}},"type":"object","required":["segments"],"title":"CaptionPatchRequest"},"CaptionSegmentResponse":{"properties":{"id":{"type":"string","title":"Id"},"start_ms":{"type":"integer","title":"Start Ms"},"end_ms":{"type":"integer","title":"End Ms"},"text":{"type":"string","title":"Text"},"edited":{"type":"boolean","title":"Edited"},"segment_index":{"type":"integer","title":"Segment Index"}},"type":"object","required":["id","start_ms","end_ms","text","edited","segment_index"],"title":"CaptionSegmentResponse"},"CaptionUpdateResponse":{"properties":{"caption_id":{"type":"string","title":"Caption Id"},"srt":{"type":"string","title":"Srt"},"segments_updated":{"type":"integer","title":"Segments Updated"}},"type":"object","required":["caption_id","srt","segments_updated"],"title":"CaptionUpdateResponse"},"CasaAuthorizeResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"}},"type":"object","required":["accepted"],"title":"CasaAuthorizeResponse"},"CascadeRevocationRequest":{"properties":{"token":{"type":"string","title":"Token","description":"The token to revoke (and all downstream delegated tokens)"}},"type":"object","required":["token"],"title":"CascadeRevocationRequest","description":"Cascading token revocation request. Refs #2317."},"CascadeRevocationResponse":{"properties":{"revoked_count":{"type":"integer","title":"Revoked Count","description":"Total number of tokens revoked"}},"type":"object","required":["revoked_count"],"title":"CascadeRevocationResponse","description":"Cascading token revocation response. Refs #2317."},"CatalogListResponse":{"properties":{"total_partitions":{"type":"integer","title":"Total Partitions"},"total_files":{"type":"integer","title":"Total Files"},"total_mb":{"type":"number","title":"Total Mb"},"partitions":{"items":{"$ref":"#/components/schemas/PartitionInfo"},"type":"array","title":"Partitions"}},"type":"object","required":["total_partitions","total_files","total_mb","partitions"],"title":"CatalogListResponse","description":"Full lakehouse catalog listing."},"CatalogProduct":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"group":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"discount":{"type":"number","title":"Discount","default":0},"cost":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cost"},"annual":{"type":"boolean","title":"Annual","default":false},"available":{"type":"boolean","title":"Available","default":true},"disabled":{"type":"boolean","title":"Disabled","default":false},"sort_order":{"type":"integer","title":"Sort Order","default":0}},"type":"object","title":"CatalogProduct"},"CatalogSearchResponse":{"properties":{"query":{"type":"string","title":"Query"},"matches":{"type":"integer","title":"Matches"},"partitions":{"items":{"$ref":"#/components/schemas/PartitionInfo"},"type":"array","title":"Partitions"}},"type":"object","required":["query","matches","partitions"],"title":"CatalogSearchResponse","description":"Partition search results."},"CategoryBreakdownItem":{"properties":{"category_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Id","description":"Category ID (null for uncategorized)"},"category_name":{"type":"string","title":"Category Name","description":"Category name"},"category_slug":{"type":"string","title":"Category Slug","description":"Category slug"},"stream_count":{"type":"integer","minimum":0,"title":"Stream Count","description":"Number of streams in this category"},"avg_peak_viewers":{"type":"number","minimum":0,"title":"Avg Peak Viewers","description":"Average peak viewers"},"max_peak_viewers":{"type":"integer","minimum":0,"title":"Max Peak Viewers","description":"Maximum peak viewers"},"total_hours":{"type":"number","minimum":0,"title":"Total Hours","description":"Total hours streamed in this category"}},"type":"object","required":["category_name","category_slug","stream_count","avg_peak_viewers","max_peak_viewers","total_hours"],"title":"CategoryBreakdownItem","description":"Category performance breakdown","example":{"avg_peak_viewers":87.5,"category_id":"123e4567-e89b-12d3-a456-426614174000","category_name":"Web Development","category_slug":"web-dev","max_peak_viewers":523,"stream_count":42,"total_hours":156.5}},"CategoryBreakdownResponse":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/CategoryBreakdownItem"},"type":"array","title":"Categories"},"total_categories":{"type":"integer","minimum":0,"title":"Total Categories","description":"Number of categories"}},"type":"object","required":["categories","total_categories"],"title":"CategoryBreakdownResponse","description":"Category breakdown for channel","example":{"categories":[{"avg_peak_viewers":87.5,"category_name":"Web Development","category_slug":"web-dev","stream_count":42}],"total_categories":5}},"CategoryListItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"stream_count":{"type":"integer","minimum":0,"title":"Stream Count","description":"Number of active live streams","default":0},"viewer_count":{"type":"integer","minimum":0,"title":"Viewer Count","description":"Total viewers across all live streams","default":0}},"type":"object","required":["id","name","slug"],"title":"CategoryListItem","description":"Schema for category list item (used in trending categories)","example":{"description":"Artificial Intelligence and programming streams","id":"123e4567-e89b-12d3-a456-426614174000","name":"AI & Coding","slug":"ai-coding","stream_count":42,"thumbnail_url":"https://storage.ainative.studio/thumbnails/ai-coding.jpg","viewer_count":1523}},"CategoryResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"stream_count":{"type":"integer","title":"Stream Count","default":0},"viewer_count":{"type":"integer","title":"Viewer Count","default":0},"is_active":{"type":"boolean","title":"Is Active","default":true},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","slug","created_at"],"title":"CategoryResponse","description":"Schema for category response with viewer metrics","example":{"created_at":"2025-12-01T10:00:00Z","description":"Live coding game development sessions","icon_url":"https://storage.ainative.studio/icons/game-dev.svg","id":"123e4567-e89b-12d3-a456-426614174000","is_active":true,"name":"Game Development","slug":"game-dev","stream_count":42,"thumbnail_url":"https://storage.ainative.studio/thumbnails/game-dev.jpg","updated_at":"2025-12-20T15:30:00Z","viewer_count":1523}},"CategoryStatistics":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon Url"},"live_stream_count":{"type":"integer","minimum":0,"title":"Live Stream Count","description":"Current live streams in category"},"total_viewers":{"type":"integer","minimum":0,"title":"Total Viewers","description":"Total concurrent viewers across all live streams"},"total_streams":{"type":"integer","minimum":0,"title":"Total Streams","description":"Total streams ever in this category"},"peak_viewers":{"type":"integer","minimum":0,"title":"Peak Viewers","description":"Peak concurrent viewers for any stream in category"},"average_viewers":{"type":"number","minimum":0,"title":"Average Viewers","description":"Average concurrent viewers for live streams"},"is_active":{"type":"boolean","title":"Is Active","default":true},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","slug","live_stream_count","total_viewers","total_streams","peak_viewers","average_viewers"],"title":"CategoryStatistics","description":"Schema for category statistics (Issue #378)","example":{"average_viewers":43.58,"created_at":"2025-01-01T00:00:00Z","description":"Technology and programming streams","icon_url":"https://storage.ainative.studio/icons/tech.svg","id":"123e4567-e89b-12d3-a456-426614174000","is_active":true,"live_stream_count":12,"name":"Technology","peak_viewers":1250,"slug":"technology","total_streams":342,"total_viewers":523,"updated_at":"2025-12-23T14:30:00Z"}},"CategoryStreamItem":{"properties":{"id":{"type":"string","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"viewer_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Viewer Count"},"playback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playback Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"streamer":{"anyOf":[{"$ref":"#/components/schemas/CategoryStreamStreamerSummary"},{"type":"null"}]}},"additionalProperties":true,"type":"object","required":["id"],"title":"CategoryStreamItem","description":"One live stream inside the category-streams envelope."},"CategoryStreamStreamerSummary":{"properties":{"id":{"type":"string","title":"Id"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"}},"additionalProperties":true,"type":"object","required":["id"],"title":"CategoryStreamStreamerSummary","description":"Streamer block embedded in a category-streams item."},"CategoryStreamsResponse":{"properties":{"category":{"$ref":"#/components/schemas/CategoryStreamsSummary"},"streams":{"items":{"$ref":"#/components/schemas/CategoryStreamItem"},"type":"array","title":"Streams"},"total":{"type":"integer","minimum":0,"title":"Total","default":0},"page":{"type":"integer","minimum":1,"title":"Page","default":1},"per_page":{"type":"integer","minimum":1,"title":"Per Page","default":20},"has_more":{"type":"boolean","title":"Has More","default":false},"sort_by":{"type":"string","title":"Sort By","description":"Sort applied: viewers, recent or alphabetical","default":"viewers"}},"additionalProperties":true,"type":"object","required":["category"],"title":"CategoryStreamsResponse","description":"Paginated live streams in a category with sorting.\n\nGET /streams/categories/by-slug/{slug}/streams\n\nPublic read of already-public live streams - `extra=\"allow\"` on the nested\nitems because the service builds them from a raw SQL projection that can\ngain columns; the envelope itself is fixed."},"CategoryStreamsSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon Url"},"stream_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stream Count"}},"additionalProperties":true,"type":"object","required":["id","name","slug"],"title":"CategoryStreamsSummary","description":"Category block embedded in the category-streams envelope."},"CategorySummary":{"properties":{"name":{"type":"string","title":"Name","description":"Category name"},"slug":{"type":"string","title":"Slug","description":"Category URL slug"},"streamCount":{"type":"integer","minimum":0,"title":"Streamcount","description":"Number of streams in this category"}},"type":"object","required":["name","slug","streamCount"],"title":"CategorySummary","description":"Summary of a stream category","example":{"name":"Game Development","slug":"game-development","streamCount":15}},"CategoryTreeNode":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon Url"},"stream_count":{"type":"integer","title":"Stream Count","default":0},"live_stream_count":{"type":"integer","title":"Live Stream Count","default":0},"total_viewers":{"type":"integer","title":"Total Viewers","default":0},"is_active":{"type":"boolean","title":"Is Active","default":true},"children":{"items":{"$ref":"#/components/schemas/CategoryTreeNode"},"type":"array","title":"Children","description":"Child categories"}},"type":"object","required":["id","name","slug"],"title":"CategoryTreeNode","description":"Schema for hierarchical category tree node (Issue #378)","example":{"children":[{"children":[],"id":"234e5678-e89b-12d3-a456-426614174001","live_stream_count":5,"name":"Web Development","slug":"web-dev","stream_count":50,"total_viewers":230}],"description":"Technology and programming streams","icon_url":"https://storage.ainative.studio/icons/tech.svg","id":"123e4567-e89b-12d3-a456-426614174000","is_active":true,"live_stream_count":12,"name":"Technology","slug":"technology","stream_count":150,"total_viewers":523}},"CategoryTreeResponse":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/CategoryTreeNode"},"type":"array","title":"Categories","description":"Top-level categories with nested children"},"total_categories":{"type":"integer","minimum":0,"title":"Total Categories","description":"Total number of categories in tree"}},"type":"object","required":["categories","total_categories"],"title":"CategoryTreeResponse","description":"Schema for category tree response (Issue #378)","example":{"categories":[{"children":[],"id":"123e4567-e89b-12d3-a456-426614174000","live_stream_count":12,"name":"Technology","slug":"technology","stream_count":150,"total_viewers":523}],"total_categories":45}},"CentralityEntity":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"total_degree":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Degree"},"in_degree":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"In Degree"},"out_degree":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Out Degree"},"hub_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Hub Score"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank"},"is_critical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Critical"}},"additionalProperties":true,"type":"object","title":"CentralityEntity","description":"One ranked entity from GET /memory/v2/graph/centrality."},"CentralityResponse":{"properties":{"entities":{"items":{"$ref":"#/components/schemas/CentralityEntity"},"type":"array","title":"Entities"},"count":{"type":"integer","title":"Count"}},"additionalProperties":true,"type":"object","required":["count"],"title":"CentralityResponse","description":"Response for GET /memory/v2/graph/centrality."},"ChainVerifyResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"broken_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Broken At"},"records_checked":{"type":"integer","title":"Records Checked"}},"type":"object","required":["valid","records_checked"],"title":"ChainVerifyResponse"},"ChannelHealthStatus":{"properties":{"channel_id":{"type":"string","title":"Channel Id","description":"Channel ID"},"channel_name":{"type":"string","title":"Channel Name","description":"Channel name"},"channel_type":{"$ref":"#/components/schemas/ChannelType","description":"Channel type"},"status":{"$ref":"#/components/schemas/ChannelStatus","description":"Current health status"},"enabled":{"type":"boolean","title":"Enabled","description":"Whether channel is enabled"},"total_sent":{"type":"integer","title":"Total Sent","description":"Total sent via this channel","default":0},"total_delivered":{"type":"integer","title":"Total Delivered","description":"Total delivered","default":0},"total_failed":{"type":"integer","title":"Total Failed","description":"Total failed","default":0},"total_pending":{"type":"integer","title":"Total Pending","description":"Total pending","default":0},"success_rate":{"type":"number","maximum":100,"minimum":0,"title":"Success Rate","description":"Channel success rate (0-100)","default":0},"avg_response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Response Time Ms","description":"Average response time"},"last_success_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Success At","description":"Last successful delivery"},"last_failure_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Failure At","description":"Last failure"}},"type":"object","required":["channel_id","channel_name","channel_type","status","enabled"],"title":"ChannelHealthStatus","description":"Health status for individual channel"},"ChannelOverviewResponse":{"properties":{"total_streams":{"type":"integer","minimum":0,"title":"Total Streams","description":"Total number of streams created"},"completed_streams":{"type":"integer","minimum":0,"title":"Completed Streams","description":"Number of completed/ended streams"},"total_hours_streamed":{"type":"number","minimum":0,"title":"Total Hours Streamed","description":"Total hours streamed across all streams"},"avg_viewers_per_stream":{"type":"number","minimum":0,"title":"Avg Viewers Per Stream","description":"Average peak viewers per stream"},"max_peak_viewers":{"type":"integer","minimum":0,"title":"Max Peak Viewers","description":"Maximum peak viewers across all streams"},"total_unique_viewers":{"type":"integer","minimum":0,"title":"Total Unique Viewers","description":"Total unique viewers (all time)"},"follower_count":{"type":"integer","minimum":0,"title":"Follower Count","description":"Current follower count"}},"type":"object","required":["total_streams","completed_streams","total_hours_streamed","avg_viewers_per_stream","max_peak_viewers","total_unique_viewers","follower_count"],"title":"ChannelOverviewResponse","description":"Channel-level overview statistics","example":{"avg_viewers_per_stream":45.8,"completed_streams":82,"follower_count":892,"max_peak_viewers":523,"total_hours_streamed":342.5,"total_streams":87,"total_unique_viewers":1250}},"ChannelStatus":{"type":"string","enum":["active","degraded","down"],"title":"ChannelStatus","description":"Channel health status"},"ChannelType":{"type":"string","enum":["email_smtp","email_sendgrid","email_ses","email_resend","slack","pagerduty","webhook"],"title":"ChannelType","description":"Notification channel types"},"ChapterAtTimeResponse":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Chapter title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Chapter description"},"start_time":{"type":"integer","minimum":0,"title":"Start Time","description":"Chapter start time in seconds"},"end_time":{"type":"integer","exclusiveMinimum":0,"title":"End Time","description":"Chapter end time in seconds"},"order":{"type":"integer","minimum":0,"title":"Order","description":"Chapter display order"},"id":{"type":"string","format":"uuid","title":"Id"},"video_id":{"type":"string","format":"uuid","title":"Video Id"},"source":{"type":"string","title":"Source","description":"Chapter source: 'manual' or 'ai'"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score","description":"AI confidence score (0.0-1.0)"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"is_active":{"type":"boolean","title":"Is Active","description":"Whether this chapter is active at the queried time"}},"type":"object","required":["title","start_time","end_time","order","id","video_id","source","created_at","updated_at","is_active"],"title":"ChapterAtTimeResponse","description":"Schema for chapter at specific timestamp","example":{"end_time":300,"id":"123e4567-e89b-12d3-a456-426614174000","is_active":true,"order":0,"source":"manual","start_time":0,"title":"Introduction","video_id":"123e4567-e89b-12d3-a456-426614174001"}},"ChapterGenerateRequest":{"properties":{"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"AI model to use","default":"gpt-4-turbo"},"temperature":{"anyOf":[{"type":"number","maximum":2,"minimum":0},{"type":"null"}],"title":"Temperature","description":"Sampling temperature","default":0.7},"max_tokens":{"anyOf":[{"type":"integer","maximum":4000,"exclusiveMinimum":0},{"type":"null"}],"title":"Max Tokens","description":"Maximum tokens for response","default":2000},"replace_existing":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Replace Existing","description":"Replace existing AI-generated chapters (preserves manual chapters)","default":true}},"type":"object","title":"ChapterGenerateRequest","description":"Schema for chapter generation request","example":{"max_tokens":2000,"model":"gpt-4-turbo","replace_existing":true,"temperature":0.7}},"ChapterGenerateResponse":{"properties":{"chapters":{"items":{"$ref":"#/components/schemas/app__schemas__chapter__ChapterResponse"},"type":"array","title":"Chapters"},"count":{"type":"integer","title":"Count","description":"Number of chapters generated"},"model_used":{"type":"string","title":"Model Used","description":"AI model used for generation"},"processing_time_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Processing Time Seconds","description":"Time taken for generation"}},"type":"object","required":["chapters","count","model_used"],"title":"ChapterGenerateResponse","description":"Schema for chapter generation response","example":{"chapters":[{"confidence_score":0.95,"end_time":300,"id":"123e4567-e89b-12d3-a456-426614174000","order":0,"source":"ai","start_time":0,"title":"Introduction to FastAPI","video_id":"123e4567-e89b-12d3-a456-426614174001"}],"count":5,"model_used":"gpt-4-turbo","processing_time_seconds":12.5}},"ChatCompletionRequest":{"properties":{"messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","minItems":1,"title":"Messages","description":"Conversation messages"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Model to use (defaults to provider default)"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"AI provider (anthropic, meta_llama, nouscoder, openai)","default":"anthropic"},"tools":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tools","description":"Available tools for the model to call"},"tool_choice":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Choice","description":"Tool choice: 'auto', 'none', 'required', or {type:function, function:{name:...}} (Closes #3552)","default":"auto"},"tool_subset":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tool Subset","description":"Dynamic tool selection - only load specified tools"},"max_iterations":{"type":"integer","maximum":10,"minimum":1,"title":"Max Iterations","description":"Max agentic loop iterations","default":5},"temperature":{"anyOf":[{"type":"number","maximum":2,"minimum":0},{"type":"null"}],"title":"Temperature","description":"Sampling temperature","default":0.7},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","description":"Maximum tokens to generate"},"stream":{"type":"boolean","title":"Stream","description":"Whether to stream the response","default":false},"system":{"anyOf":[{"type":"string"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"System","description":"System prompt (string, or a list of Anthropic content blocks to set an explicit prompt-cache breakpoint)"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User ID for usage tracking"}},"type":"object","required":["messages"],"title":"ChatCompletionRequest","description":"Chat completion request schema with tool calling support\n\nIssue #623: Extended with agentic tool calling parameters"},"ChatCompletionResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Completion ID"},"model":{"type":"string","title":"Model","description":"Model used"},"provider":{"type":"string","title":"Provider","description":"Provider used"},"created":{"type":"integer","title":"Created","description":"Unix timestamp"},"choices":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Choices","description":"Completion choices"},"usage":{"additionalProperties":true,"type":"object","title":"Usage","description":"Token usage statistics"},"iterations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Iterations","description":"Number of tool calling iterations"},"total_tokens_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Tokens Used","description":"Total tokens across all iterations"},"finish_reason":{"type":"string","title":"Finish Reason","description":"Why the completion finished"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning","description":"Present when the response may be incomplete or misleading, e.g. truncated by max_tokens with no visible content produced"}},"type":"object","required":["id","model","provider","created","choices","usage","finish_reason"],"title":"ChatCompletionResponse","description":"Chat completion response schema with tool calling support\n\nIssue #623: Response format for agentic tool calling"},"ChatHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","service","timestamp"],"title":"ChatHealthResponse","description":"Response for GET /chat/health."},"ChatInfoResponse":{"properties":{"status":{"type":"string","title":"Status"},"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version"},"timestamp":{"type":"string","title":"Timestamp"},"description":{"type":"string","title":"Description"},"features":{"items":{"type":"string"},"type":"array","title":"Features"},"supported_message_types":{"items":{"type":"string"},"type":"array","title":"Supported Message Types"},"max_messages_per_session":{"type":"integer","title":"Max Messages Per Session"},"max_session_duration":{"type":"string","title":"Max Session Duration","description":"Human-readable max session duration, e.g. '24 hours'"}},"type":"object","required":["status","name","version","timestamp","description","features","supported_message_types","max_messages_per_session","max_session_duration"],"title":"ChatInfoResponse","description":"Response for GET /chat/info."},"ChatMessageCreate":{"properties":{"role":{"type":"string","pattern":"^(user|assistant|system)$","title":"Role"},"content":{"type":"string","minLength":1,"title":"Content"},"message_type":{"type":"string","pattern":"^(text|subscription|donation|announcement)$","title":"Message Type","description":"Message type: text, subscription, donation, or announcement","default":"text"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"}},"type":"object","required":["role","content"],"title":"ChatMessageCreate","description":"Schema for creating chat messages"},"ChatMessageType":{"type":"string","enum":["message","system","highlight"],"title":"ChatMessageType","description":"Chat message type enumeration"},"ChatSessionCreate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Title"},"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"}},"type":"object","title":"ChatSessionCreate","description":"Schema for creating chat sessions"},"ChatSessionSummary":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["id","title","status","created_at","user_id"],"title":"ChatSessionSummary","description":"A chat session summary, as returned by GET /memory/chat-sessions."},"ChatStats":{"properties":{"stream_id":{"type":"string","format":"uuid","title":"Stream Id"},"total_messages":{"type":"integer","minimum":0,"title":"Total Messages","description":"Total chat messages"},"unique_chatters":{"type":"integer","minimum":0,"title":"Unique Chatters","description":"Unique users who sent messages"},"messages_per_minute":{"type":"number","minimum":0,"title":"Messages Per Minute","description":"Average messages per minute"}},"type":"object","required":["stream_id","total_messages","unique_chatters","messages_per_minute"],"title":"ChatStats","description":"Chat engagement statistics","example":{"messages_per_minute":12.3,"stream_id":"987e6543-e21b-12d3-a456-426614174000","total_messages":1834,"unique_chatters":156}},"ChatStatsResponse":{"properties":{"total":{"type":"integer","title":"Total"},"open":{"type":"integer","title":"Open"},"resolved":{"type":"integer","title":"Resolved"}},"type":"object","required":["total","open","resolved"],"title":"ChatStatsResponse"},"ChatTestSession":{"properties":{"id":{"type":"string","title":"Id","description":"Test chat session identifier"},"title":{"type":"string","title":"Title","description":"Human-readable session title"},"status":{"type":"string","title":"Status","description":"Session status"},"user_id":{"type":"string","title":"User Id","description":"ID of the authenticated user"}},"type":"object","required":["id","title","status","user_id"],"title":"ChatTestSession","description":"A single item returned by GET /chat-test/test."},"ChatTurn":{"properties":{"role":{"type":"string","title":"Role","description":"'user' or 'assistant'"},"text":{"type":"string","title":"Text"}},"type":"object","required":["role","text"],"title":"ChatTurn"},"ChatwootWebhookResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event"},"queued":{"type":"boolean","title":"Queued"}},"type":"object","required":["ok","queued"],"title":"ChatwootWebhookResponse","description":"Ack returned to Chatwoot. Processing itself happens async via\nBackgroundTasks — this only confirms the event was accepted/queued."},"CheckParamsRequest":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"llm_requested_params":{"additionalProperties":true,"type":"object","title":"Llm Requested Params"},"actual_call_params":{"additionalProperties":true,"type":"object","title":"Actual Call Params"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},"type":"object","required":["tool_name","llm_requested_params","actual_call_params"],"title":"CheckParamsRequest"},"CheckParamsResponse":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"passed":{"type":"boolean","title":"Passed"},"llm_params_hash":{"type":"string","title":"Llm Params Hash"},"actual_params_hash":{"type":"string","title":"Actual Params Hash"},"diff":{"additionalProperties":true,"type":"object","title":"Diff"}},"type":"object","required":["tool_name","passed","llm_params_hash","actual_params_hash","diff"],"title":"CheckParamsResponse"},"CheckPermissionRequest":{"properties":{"tool":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool","description":"MCP tool name to check access for (e.g. 'zerodb_store_memory')."},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace","description":"Namespace to check access for (e.g. 'project/my-project')."},"route":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Route","description":"API route path to check access for (e.g. '/api/v1/memory/v2/remember')."}},"type":"object","title":"CheckPermissionRequest","description":"Request body for POST /auth/keys/{key_id}/check-permission."},"CheckPermissionResponse":{"properties":{"allowed":{"type":"boolean","title":"Allowed"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["allowed","reason"],"title":"CheckPermissionResponse","description":"Response body for POST /auth/keys/{key_id}/check-permission."},"CheckResultResponse":{"properties":{"name":{"type":"string","title":"Name"},"passed":{"type":"boolean","title":"Passed"},"score":{"type":"integer","title":"Score"},"max_score":{"type":"integer","title":"Max Score"},"details":{"type":"string","title":"Details"}},"type":"object","required":["name","passed","score","max_score","details"],"title":"CheckResultResponse"},"Checkpoint":{"properties":{"label":{"type":"string","title":"Label","description":"User-defined label for the checkpoint."},"project_id":{"type":"string","title":"Project Id","description":"Identifier for the project the checkpoint belongs to."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Optional description for the checkpoint."},"id":{"type":"string","title":"Id","description":"Unique identifier for the checkpoint."},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Timestamp when the checkpoint was created."},"storage_path":{"type":"string","title":"Storage Path","description":"Internal storage path for the checkpoint data."}},"type":"object","required":["label","project_id","id","timestamp","storage_path"],"title":"Checkpoint"},"CheckpointCreateRequest":{"properties":{"label":{"type":"string","title":"Label","description":"User-defined label for the checkpoint."},"project_id":{"type":"string","title":"Project Id","description":"Identifier for the project the checkpoint belongs to."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Optional description for the checkpoint."},"source_paths":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Source Paths","description":"List of source paths to include in the checkpoint. If None, behavior depends on service implementation."}},"type":"object","required":["label","project_id"],"title":"CheckpointCreateRequest"},"CheckpointListItem":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["id","label","timestamp","description"],"title":"CheckpointListItem"},"CheckpointRequest":{"properties":{"checkpoint_name":{"type":"string","title":"Checkpoint Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["checkpoint_name"],"title":"CheckpointRequest"},"CheckpointRestoreRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Identifier for the project."},"checkpoint_id":{"type":"string","title":"Checkpoint Id","description":"ID of the checkpoint to restore."},"target_dir":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Dir","description":"Optional target directory to restore into."}},"type":"object","required":["project_id","checkpoint_id"],"title":"CheckpointRestoreRequest"},"CheckpointSummary":{"properties":{"id":{"type":"string","title":"Id"},"checkpoint_name":{"type":"string","title":"Checkpoint Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","checkpoint_name","created_at"],"title":"CheckpointSummary"},"ChunkData":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id","description":"Chunk ID (absent for chunks not yet persisted)"},"content":{"type":"string","title":"Content","description":"Chunk source content"},"start_line":{"type":"integer","title":"Start Line","description":"Starting line number"},"end_line":{"type":"integer","title":"End Line","description":"Ending line number"},"chunk_type":{"type":"string","title":"Chunk Type","description":"Type of chunk (e.g. function, class, imports)"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Chunk-specific metadata"},"embedding":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Embedding","description":"Vector embedding, when included"}},"type":"object","required":["content","start_line","end_line","chunk_type"],"title":"ChunkData","description":"A single code chunk as stored/returned by the chunking engine."},"ChunkDirectoryRequest":{"properties":{"directory_path":{"type":"string","title":"Directory Path","description":"Path to the directory"},"include_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Include Patterns","description":"Optional patterns to include"},"exclude_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Patterns","description":"Optional patterns to exclude"}},"type":"object","required":["directory_path"],"title":"ChunkDirectoryRequest"},"ChunkDirectoryResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Service status: success or error"},"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"directory_path":{"type":"string","title":"Directory Path","description":"Directory that was chunked"},"total_files":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Files","description":"Files processed"},"total_chunks":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Chunks","description":"Chunks produced in total"},"results":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Results","description":"Per-file results"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message when status=error"}},"additionalProperties":true,"type":"object","required":["status","project_id","directory_path"],"title":"ChunkDirectoryResponse","description":"Aggregate result of chunking every matching file in a directory."},"ChunkFileRequest":{"properties":{"file_path":{"type":"string","title":"File Path","description":"Path to the file"},"content":{"type":"string","title":"Content","description":"Content of the file"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Optional language override"}},"type":"object","required":["file_path","content"],"title":"ChunkFileRequest"},"ChunkFileResponse":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"file_path":{"type":"string","title":"File Path","description":"Path to the chunked file"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Detected or supplied language"},"chunk_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Chunk Count","description":"Number of chunks produced"},"chunks":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Chunks","description":"Chunk records"},"cache_hit":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Cache Hit","description":"Whether chunks came from cache"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Service status, when supplied"}},"additionalProperties":true,"type":"object","required":["project_id","file_path"],"title":"ChunkFileResponse","description":"Result of chunking a single file."},"ChunkingRequest":{"properties":{"file_path":{"type":"string","maxLength":500,"minLength":1,"title":"File Path","description":"Relative path to the file within the project","examples":["src/utils/helpers.py","api/routes/auth.py"]},"file_content":{"type":"string","minLength":1,"title":"File Content","description":"Complete source code content of the file to be chunked","examples":["def hello():\n print('Hello World')"]},"project_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","title":"Project Id","description":"UUID of the project this file belongs to","examples":["550e8400-e29b-41d4-a716-446655440000"]}},"type":"object","required":["file_path","file_content","project_id"],"title":"ChunkingRequest","description":"Request to process a code file into semantic chunks with embeddings.\n\nUsed for preparing code files for AI context analysis by breaking them\ninto logically meaningful segments (functions, classes, modules).","example":{"file_content":"def calculate_sum(a: int, b: int) -> int:\n return a + b","file_path":"src/utils/helpers.py","project_id":"550e8400-e29b-41d4-a716-446655440000"}},"CircuitResult":{"properties":{"circuit_id":{"type":"string","title":"Circuit Id","description":"ID of the executed circuit"},"shots":{"type":"integer","minimum":1,"title":"Shots","description":"Number of times the circuit was run"},"measurements":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Measurements","description":"Detailed measurement results from circuit execution"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"status":{"type":"string","title":"Status","description":"Status of circuit execution","default":"completed"}},"type":"object","required":["circuit_id","shots"],"title":"CircuitResult","description":"Legacy circuit result schema"},"CityIntelligenceResult":{"properties":{"crime":{"additionalProperties":true,"type":"object","title":"Crime"},"service_requests":{"additionalProperties":true,"type":"object","title":"Service Requests"},"port_activity":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Port Activity"},"businesses":{"additionalProperties":true,"type":"object","title":"Businesses"},"source":{"type":"string","title":"Source","default":"lakehouse"},"city":{"type":"string","title":"City","default":""},"generated_at":{"type":"string","title":"Generated At","default":""},"historical_data":{"items":{},"type":"array","title":"Historical Data"}},"type":"object","title":"CityIntelligenceResult"},"ClassifyDataResponse":{"properties":{"classification":{"$ref":"#/components/schemas/DataClassificationDetail"},"classified_at":{"type":"string","title":"Classified At"}},"type":"object","required":["classification","classified_at"],"title":"ClassifyDataResponse"},"CleanupResponse":{"properties":{"deleted_events":{"type":"integer","title":"Deleted Events","description":"Number of analytics events deleted"},"deleted_viewers":{"type":"integer","title":"Deleted Viewers","description":"Number of stale realtime viewer records deleted"},"retention_days":{"type":"integer","title":"Retention Days","description":"Retention window that was applied"}},"type":"object","required":["deleted_events","deleted_viewers","retention_days"],"title":"CleanupResponse","description":"Counts returned by the GDPR retention cleanup.\n\nBoth counts come from ``AnalyticsService.cleanup_old_events`` and\n``AnalyticsService.cleanup_stale_viewers``, which are each annotated\n``-> int``. ``retention_days`` echoes back the requested retention window."},"CleanupSessionsResponse":{"properties":{"message":{"type":"string","title":"Message"},"triggered_at":{"type":"string","title":"Triggered At"}},"type":"object","required":["message","triggered_at"],"title":"CleanupSessionsResponse","description":"Response for POST /collaboration/cleanup."},"ClearBlockedIPsResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"cleared_count":{"type":"integer","title":"Cleared Count"},"reason":{"type":"string","title":"Reason"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","cleared_count","reason","timestamp"],"title":"ClearBlockedIPsResponse","description":"Result of clearing all blocked IPs."},"ClearMetricsCacheResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always true on a 200"},"message":{"type":"string","title":"Message","description":"Human-readable result summary"},"cleared_keys":{"items":{"type":"string"},"type":"array","title":"Cleared Keys","description":"Cache keys the clear was attempted on"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO timestamp of the clear"}},"additionalProperties":true,"type":"object","required":["success","message","cleared_keys","timestamp"],"title":"ClearMetricsCacheResponse","description":"POST /api/v1/mcp/proxy/metrics/clear-cache"},"ClearSessionMemoryResponse":{"properties":{"message":{"type":"string","title":"Message"},"session_id":{"type":"string","title":"Session Id"},"memories_deleted":{"type":"integer","title":"Memories Deleted"}},"type":"object","required":["message","session_id","memories_deleted"],"title":"ClearSessionMemoryResponse"},"ClearSuggestionCacheResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"ClearSuggestionCacheResponse","description":"Response for DELETE /zerodb/search/suggestions/cache."},"CliBootstrapStubResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"provider":{"type":"string","title":"Provider","default":"ainative"},"api_base_url":{"type":"string","title":"Api Base Url","default":"https://api.ainative.studio"},"features":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Features"}},"type":"object","title":"CliBootstrapStubResponse","description":"Fallback bootstrap shape used when the alias cannot resolve a real\nauthenticated user (proxy to the real bootstrap handler failed/anonymous)."},"CliFastModeResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Whether fast mode is enabled for the org"},"disabled_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disabled Reason","description":"Why fast mode is off; null when enabled"}},"type":"object","required":["enabled"],"title":"CliFastModeResponse","description":"Fast-mode org status for the CLI (Refs #8449).\n\n`disabled_reason` is always emitted and is always `None` today, and the CLI\nreads the key. It is therefore declared `Optional[str] = None`:\n * a required non-Optional `str` would reject every real response;\n * omitting the field from the model would drop the key.\n\nThe route is also declared WITHOUT `response_model_exclude_unset`. Measured\nbehaviour: with the handler as written (it passes `disabled_reason=None`\nexplicitly, so the field counts as *set*), exclude_unset would NOT drop the\nkey today. But it is still the wrong flag here — were the handler ever\nsimplified to `return {\"enabled\": True}`, the plain model keeps emitting\n`disabled_reason: null` while exclude_unset would silently stop emitting\nit. The plain model is robust to that change; exclude_unset is not."},"CliFeedbackResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"feedback_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Id"}},"type":"object","title":"CliFeedbackResponse","description":"Result of storing a CLI feedback submission."},"CliMetricsResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"}},"type":"object","title":"CliMetricsResponse","description":"Ack response for CLI metrics ingestion."},"CliProfileResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"user":{"$ref":"#/components/schemas/CliProfileUser"}},"type":"object","required":["user"],"title":"CliProfileResponse","description":"Default CLI user identification profile (no-auth stub)."},"CliProfileUser":{"properties":{"name":{"type":"string","title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","required":["name"],"title":"CliProfileUser"},"CliStatusResponse":{"properties":{"cli_available":{"type":"boolean","title":"Cli Available"},"cli_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cli Path"},"installation_command":{"type":"string","title":"Installation Command"},"login_command":{"type":"string","title":"Login Command"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["cli_available","installation_command","login_command","timestamp"],"title":"CliStatusResponse","description":"Response for GET /railway-deployment/cli-status."},"Click":{"properties":{"click_id":{"type":"string","title":"Click Id","description":"Unique click identifier"},"impression_id":{"type":"string","title":"Impression Id","description":"Related impression ID"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID"},"creative_id":{"type":"string","title":"Creative Id","description":"Creative ID"},"event_id":{"type":"string","title":"Event Id","description":"Event ID"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User ID (None if anonymous)"},"destination_url":{"type":"string","title":"Destination Url","description":"Destination URL for redirect"},"click_position":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Click Position","description":"Click position on creative"},"device_type":{"$ref":"#/components/schemas/DeviceType","description":"Device type"},"time_to_click":{"type":"number","minimum":0,"title":"Time To Click","description":"Time in seconds between impression and click"},"credit_bonus":{"type":"boolean","title":"Credit Bonus","description":"Whether engagement quality bonus was applied (click < 30s)"},"clicked_at":{"type":"string","format":"date-time","title":"Clicked At","description":"Timestamp when click occurred"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Record creation timestamp"}},"type":"object","required":["click_id","impression_id","campaign_id","creative_id","event_id","destination_url","device_type","time_to_click","credit_bonus","clicked_at","created_at"],"title":"Click","description":"Schema for click response\nIssue #549: Ad Click Tracking\n\nReturned after successfully tracking a click.\nIncludes all tracked data plus system-generated fields.","example":{"campaign_id":"camp_abc123","click_id":"click_xyz789abc123","click_position":{"x":150,"y":200},"clicked_at":"2026-01-05T14:35:00Z","created_at":"2026-01-05T14:35:00Z","creative_id":"creative_def456","credit_bonus":true,"destination_url":"https://sponsor.com/landing-page","device_type":"desktop","event_id":"event_pai2026","impression_id":"imp_abc123def456","time_to_click":12.5,"user_id":"user_xyz789"}},"ClickCreate":{"properties":{"impression_id":{"type":"string","title":"Impression Id","description":"Impression ID that was clicked (links to impression record)"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID that served the ad"},"creative_id":{"type":"string","title":"Creative Id","description":"Creative ID that was clicked"},"event_id":{"type":"string","title":"Event Id","description":"Event ID where click occurred"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User ID if authenticated, None for anonymous users"},"destination_url":{"type":"string","title":"Destination Url","description":"URL user is being redirected to"},"click_position":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Click Position","description":"Click position coordinates (x, y) on the ad creative"},"device_type":{"$ref":"#/components/schemas/DeviceType","description":"Device type used to click ad"}},"type":"object","required":["impression_id","campaign_id","creative_id","event_id","destination_url","device_type"],"title":"ClickCreate","description":"Schema for creating a click tracking record\nIssue #549: Ad Click Tracking\n\nRequired for tracking when a user clicks on an ad.\nUsed by ad serving system to log clicks for billing and conversion tracking.","example":{"campaign_id":"camp_abc123","click_position":{"x":150,"y":200},"creative_id":"creative_def456","destination_url":"https://sponsor.com/landing-page","device_type":"desktop","event_id":"event_pai2026","impression_id":"imp_abc123def456","user_id":"user_xyz789"}},"ClientData":{"properties":{"default_model":{"type":"string","title":"Default Model","default":"qwen-coder-32b"},"fast_model":{"type":"string","title":"Fast Model","default":"qwen-coder-7b"},"features":{"$ref":"#/components/schemas/FeatureFlags","default":{"tools_enabled":true,"mcp_enabled":true,"remote_sessions_enabled":true}}},"type":"object","title":"ClientData","description":"Client configuration defaults for CLI startup."},"ClientMetadata":{"properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"contact_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Name"},"contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Email"},"billing_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Email"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"ClientMetadata"},"ClientOrganizationSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role"}},"type":"object","required":["id","name","role"],"title":"ClientOrganizationSummary"},"ClientOrganizationsListResponse":{"properties":{"organizations":{"items":{"$ref":"#/components/schemas/ClientOrganizationSummary"},"type":"array","title":"Organizations"}},"type":"object","required":["organizations"],"title":"ClientOrganizationsListResponse"},"ClientRegistrationRequest":{"properties":{"client_name":{"type":"string","maxLength":255,"minLength":1,"title":"Client Name","description":"Human-readable name of the client application"},"redirect_uris":{"items":{"type":"string"},"type":"array","title":"Redirect Uris","description":"Redirect URIs for authorization_code flow"},"grant_types":{"items":{"type":"string"},"type":"array","title":"Grant Types","description":"OAuth 2.0 grant types the client will use","default":["authorization_code"]},"response_types":{"items":{"type":"string"},"type":"array","title":"Response Types","description":"OAuth 2.0 response types the client will use","default":["code"]},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope","description":"Space-separated list of requested scopes","default":""},"token_endpoint_auth_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Endpoint Auth Method","description":"Token endpoint authentication method","default":"client_secret_basic"},"client_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Uri","description":"URL of the client home page"},"logo_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Uri","description":"URL of the client logo"},"contacts":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Contacts","description":"Contact email addresses"},"tos_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tos Uri","description":"URL of terms of service"},"policy_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Policy Uri","description":"URL of privacy policy"}},"type":"object","required":["client_name"],"title":"ClientRegistrationRequest","description":"RFC 7591 §2 - Client Metadata\n\nAll fields except client_name are optional; sensible defaults are applied."},"ClientRegistrationResponse":{"properties":{"client_id":{"type":"string","title":"Client Id"},"client_secret":{"type":"string","title":"Client Secret"},"client_name":{"type":"string","title":"Client Name"},"redirect_uris":{"items":{"type":"string"},"type":"array","title":"Redirect Uris"},"grant_types":{"items":{"type":"string"},"type":"array","title":"Grant Types"},"response_types":{"items":{"type":"string"},"type":"array","title":"Response Types"},"scope":{"type":"string","title":"Scope"},"token_endpoint_auth_method":{"type":"string","title":"Token Endpoint Auth Method"},"client_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Uri"},"logo_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Uri"},"contacts":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Contacts"},"tos_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tos Uri"},"policy_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Policy Uri"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["client_id","client_secret","client_name","redirect_uris","grant_types","response_types","scope","token_endpoint_auth_method","created_at"],"title":"ClientRegistrationResponse","description":"RFC 7591 §3.2 - Client Information Response"},"ClientSpendSummary":{"properties":{"workspace_id":{"type":"string","title":"Workspace Id"},"workspace_name":{"type":"string","title":"Workspace Name"},"workspace_type":{"type":"string","title":"Workspace Type","default":"client"},"client_metadata":{"anyOf":[{"$ref":"#/components/schemas/ClientMetadata"},{"type":"null"}]},"project_count":{"type":"integer","title":"Project Count","default":0},"total_spend_usd":{"type":"number","title":"Total Spend Usd","default":0},"projects":{"items":{"$ref":"#/components/schemas/WorkspaceProjectSummary"},"type":"array","title":"Projects","default":[]}},"type":"object","required":["workspace_id","workspace_name"],"title":"ClientSpendSummary"},"ClientsListResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"clients":{"items":{"$ref":"#/components/schemas/ClientSpendSummary"},"type":"array","title":"Clients"},"total":{"type":"integer","title":"Total","default":0},"total_spend_usd":{"type":"number","title":"Total Spend Usd","default":0},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["clients"],"title":"ClientsListResponse","description":"`has_more` documented per AINative-Studio/ainative-website#2208 — this\nendpoint returns the full set of client workspaces in one page (no\nlimit/offset), so `has_more` is always False."},"CloneRepoRequest":{"properties":{"repository_url":{"type":"string","title":"Repository Url","description":"The URL of the Git repository to clone or update."}},"type":"object","required":["repository_url"],"title":"CloneRepoRequest","description":"Request model for cloning a repository."},"CloneRepoResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Status message indicating success."},"local_path":{"type":"string","title":"Local Path","description":"The local path where the repository is stored."}},"type":"object","required":["message","local_path"],"title":"CloneRepoResponse","description":"Response model after cloning/updating a repository."},"CloneRepositoryResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"repository":{"additionalProperties":true,"type":"object","title":"Repository"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","repository","timestamp"],"title":"CloneRepositoryResponse","description":"Response for POST /git-integration/repository/clone."},"CloseSessionResponse":{"properties":{"message":{"type":"string","title":"Message"},"session_id":{"type":"string","title":"Session Id"},"closed_at":{"type":"string","title":"Closed At"}},"type":"object","required":["message","session_id","closed_at"],"title":"CloseSessionResponse","description":"Response for DELETE /collaboration/sessions/{session_id}."},"CloudCreateRequest":{"properties":{"provider":{"type":"string","title":"Provider","description":"Provider to create environment on","default":"ainative"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","title":"CloudCreateRequest"},"CloudSyncStatus":{"properties":{"project_id":{"type":"string","title":"Project Id"},"is_authenticated":{"type":"boolean","title":"Is Authenticated","default":true},"last_sync_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Sync At"},"last_upload_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Upload At"},"last_download_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Download At"},"available_bundles":{"items":{"$ref":"#/components/schemas/BundleInfo"},"type":"array","title":"Available Bundles","default":[]},"pending_conflicts":{"items":{},"type":"array","title":"Pending Conflicts","default":[]},"sync_direction":{"type":"string","title":"Sync Direction","default":"bidirectional"},"auto_sync_enabled":{"type":"boolean","title":"Auto Sync Enabled","default":false},"total_bundles":{"type":"integer","title":"Total Bundles","default":0},"storage_used_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Storage Used Bytes"}},"type":"object","required":["project_id"],"title":"CloudSyncStatus"},"CloudflareStreamWebhookResponse":{"properties":{"status":{"type":"string","title":"Status"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event"},"stream_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stream Id"}},"type":"object","required":["status"],"title":"CloudflareStreamWebhookResponse","description":"Result of processing a Cloudflare Stream webhook event.\n\nThe handler returns one of two shapes depending on outcome: an\n\"ignored\" result carries only status+reason (missing event type,\nstream not found, or an unhandled event type); a \"processed\" result\ncarries status+event+stream_id instead. Both are optional here so one\nmodel covers both real shapes."},"ClusterInfo":{"properties":{"cluster_id":{"type":"integer","title":"Cluster Id","description":"Cluster identifier"},"size":{"type":"integer","title":"Size","description":"Number of vectors in cluster"},"centroid":{"items":{"type":"number"},"type":"array","title":"Centroid","description":"Cluster centroid (first 10 dimensions)"},"vector_ids":{"items":{"type":"string"},"type":"array","title":"Vector Ids","description":"Vector IDs in cluster (first 50)"},"inertia":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Inertia","description":"Cluster inertia (KMeans only)"}},"type":"object","required":["cluster_id","size","centroid","vector_ids"],"title":"ClusterInfo","description":"Information about a single cluster"},"CodeChunkCreate":{"properties":{"name":{"type":"string","title":"Name"},"content":{"type":"string","title":"Content"},"language":{"type":"string","title":"Language","default":"python"}},"type":"object","required":["name","content"],"title":"CodeChunkCreate"},"CodeChunkDeleteResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always true on the 200 path"},"message":{"type":"string","title":"Message","description":"Human-readable confirmation"}},"type":"object","required":["success","message"],"title":"CodeChunkDeleteResponse","description":"Confirmation body for the soft-delete route (Refs #8449).\n\nBoth keys are unconditional on the 200 path — the handler returns one flat\ndict literal reached only after the existence check passes — so no\n`response_model_exclude_unset` is needed. Deliberately carries no chunk\ncontent: a delete confirmation has no reason to echo the deleted code."},"CodeChunkPreview":{"properties":{"id":{"title":"Id"},"file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Path"},"content_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Preview"},"start_line":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start Line"},"end_line":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"End Line"}},"type":"object","required":["id"],"title":"CodeChunkPreview"},"CodeChunkResponse":{"properties":{"name":{"type":"string","title":"Name"},"content":{"type":"string","title":"Content"},"language":{"type":"string","title":"Language","default":"python"},"id":{"type":"string","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["name","content","id","created_at","updated_at"],"title":"CodeChunkResponse"},"CodeChunkUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"}},"type":"object","title":"CodeChunkUpdate"},"CodeContextStatusResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Engine status, e.g. 'active'"},"engine":{"type":"string","title":"Engine","description":"Engine display name"},"version":{"type":"string","title":"Version","description":"Engine version"},"operations":{"items":{"type":"string"},"type":"array","title":"Operations","description":"Supported operation names"}},"additionalProperties":true,"type":"object","required":["status","engine","version","operations"],"title":"CodeContextStatusResponse","description":"Static engine status banner returned by GET /."},"CodeDiff":{"properties":{"original":{"type":"string","title":"Original","description":"Original code snippet"},"refactored":{"type":"string","title":"Refactored","description":"Refactored code snippet"},"start_line":{"type":"integer","title":"Start Line","description":"Starting line number in the original file"},"end_line":{"type":"integer","title":"End Line","description":"Ending line number in the original file"}},"type":"object","required":["original","refactored","start_line","end_line"],"title":"CodeDiff","description":"CodeDiff schema"},"CodeEvaluationRequest":{"properties":{"generated_code":{"type":"string","title":"Generated Code","description":"The AI-generated code to evaluate"},"original_prompt":{"type":"string","title":"Original Prompt","description":"Original user prompt/query"},"context":{"type":"string","title":"Context","description":"Context used for generation","default":""},"expected_output":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Output","description":"Expected/reference code"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project context"},"evaluation_type":{"type":"string","title":"Evaluation Type","description":"Type of evaluation","default":"comprehensive"}},"type":"object","required":["generated_code","original_prompt"],"title":"CodeEvaluationRequest","description":"Request to evaluate generated code"},"CodeEvaluationStartedResponse":{"properties":{"message":{"type":"string","title":"Message"},"evaluation_id":{"type":"string","title":"Evaluation Id"},"status":{"type":"string","title":"Status"},"started_at":{"type":"string","title":"Started At"}},"type":"object","required":["message","evaluation_id","status","started_at"],"title":"CodeEvaluationStartedResponse","description":"Response for POST /code/evaluate."},"CodeExecutionRequest":{"properties":{"code":{"type":"string","maxLength":100000,"title":"Code","description":"Source code to execute"},"language":{"type":"string","title":"Language","description":"Language: python, javascript, typescript","default":"python"},"timeout":{"type":"integer","maximum":300,"minimum":1,"title":"Timeout","description":"Max execution time in seconds","default":30}},"type":"object","required":["code"],"title":"CodeExecutionRequest","description":"Request to execute code in a sandbox."},"CodeExecutionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"stdout":{"type":"string","title":"Stdout"},"stderr":{"type":"string","title":"Stderr"},"exit_code":{"type":"integer","title":"Exit Code"},"execution_time_ms":{"type":"integer","title":"Execution Time Ms"},"credits_charged":{"type":"integer","title":"Credits Charged"},"language":{"type":"string","title":"Language"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success","stdout","stderr","exit_code","execution_time_ms","credits_charged","language"],"title":"CodeExecutionResponse","description":"Response from code execution."},"CodeFragment-Input":{"properties":{"id":{"type":"string","title":"Id","description":"Unique fragment ID (e.g. sha256:42:88)"},"content":{"type":"string","minLength":1,"title":"Content","description":"Source code text of the fragment"},"metadata":{"$ref":"#/components/schemas/FragmentMetadata"}},"type":"object","required":["id","content","metadata"],"title":"CodeFragment"},"CodeFragment-Output":{"properties":{"fragment":{"type":"string","title":"Fragment","description":"The matching code text"},"file_path":{"type":"string","title":"File Path","description":"Relative path of the source file"},"line_start":{"type":"integer","title":"Line Start","description":"First line of the fragment (1-based)"},"line_end":{"type":"integer","title":"Line End","description":"Last line of the fragment (inclusive)"},"score":{"type":"number","title":"Score","description":"Similarity score in [0, 1]"}},"type":"object","required":["fragment","file_path","line_start","line_end","score"],"title":"CodeFragment","description":"A single code fragment result."},"CodeOwnershipRequest":{"properties":{"repo_path":{"type":"string","title":"Repo Path","description":"Path to the Git repository"},"project_id":{"type":"string","title":"Project Id","description":"ID of the project"}},"type":"object","required":["repo_path","project_id"],"title":"CodeOwnershipRequest"},"CodeQualityAgentAnalysisCreate":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID to associate with analysis"},"file_path":{"type":"string","title":"File Path","description":"Path to the file being analyzed"},"code_content":{"type":"string","title":"Code Content","description":"Content of the file to be analyzed"},"agent_session_id":{"type":"string","title":"Agent Session Id","description":"ID of the agent session to use for analysis"}},"type":"object","required":["project_id","file_path","code_content","agent_session_id"],"title":"CodeQualityAgentAnalysisCreate","description":"Request data for creating a code quality analysis via agent"},"CodeQualityAnalysisCreate":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID to associate with analysis"},"file_path":{"type":"string","title":"File Path","description":"Path to the file being analyzed"},"code_content":{"type":"string","title":"Code Content","description":"Content of the file to be analyzed"}},"type":"object","required":["project_id","file_path","code_content"],"title":"CodeQualityAnalysisCreate","description":"Request data for creating a code quality analysis"},"CodeQualityAnalysisRead":{"properties":{"analysis_id":{"type":"string","title":"Analysis Id","description":"Unique identifier for the analysis"},"project_id":{"type":"string","title":"Project Id","description":"Project ID associated with analysis"},"file_path":{"type":"string","title":"File Path","description":"Path to the analyzed file"},"timestamp":{"type":"string","title":"Timestamp","description":"When the analysis was performed"},"issues":{"items":{"$ref":"#/components/schemas/CodeQualityIssue"},"type":"array","title":"Issues","description":"List of issues found"},"metrics":{"$ref":"#/components/schemas/CodeQualityMetrics","description":"Analysis metrics"},"agent_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Session Id","description":"ID of the agent session used for analysis"},"llm_used":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Used","description":"LLM provider used for the analysis"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary","description":"Summary of the analysis results"}},"type":"object","required":["analysis_id","project_id","file_path","timestamp","issues","metrics"],"title":"CodeQualityAnalysisRead","description":"Response data for a code quality analysis result"},"CodeQualityAnalysisSummary":{"properties":{"analysis_id":{"type":"string","title":"Analysis Id","description":"Unique identifier for the analysis"},"project_id":{"type":"string","title":"Project Id","description":"Project ID associated with analysis"},"file_path":{"type":"string","title":"File Path","description":"Path to the analyzed file"},"timestamp":{"type":"string","title":"Timestamp","description":"When the analysis was performed"},"issue_count":{"type":"integer","title":"Issue Count","description":"Total number of issues found"},"agent_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Session Id","description":"ID of the agent session used for analysis"},"llm_used":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Used","description":"LLM provider used for the analysis"}},"type":"object","required":["analysis_id","project_id","file_path","timestamp","issue_count"],"title":"CodeQualityAnalysisSummary","description":"Summary of a code quality analysis for history listing"},"CodeQualityFixRequest":{"properties":{"analysis_id":{"type":"string","title":"Analysis Id"},"issue_ids":{"items":{"type":"string"},"type":"array","title":"Issue Ids","description":"List of items"},"agent_session_id":{"type":"string","title":"Agent Session Id"}},"type":"object","required":["analysis_id","agent_session_id"],"title":"CodeQualityFixRequest","description":"Schema for requesting quick fixes for code quality issues"},"CodeQualityFixResponse":{"properties":{"analysis_id":{"type":"string","title":"Analysis Id"},"suggestions":{"items":{"$ref":"#/components/schemas/CodeQualityFixSuggestion"},"type":"array","title":"Suggestions","description":"List of items"},"timestamp":{"type":"string","title":"Timestamp"},"agent_session_id":{"type":"string","title":"Agent Session Id"},"llm_used":{"type":"string","title":"Llm Used"}},"type":"object","required":["analysis_id","timestamp","agent_session_id","llm_used"],"title":"CodeQualityFixResponse","description":"Schema for the response from the quick fix generation endpoint"},"CodeQualityFixSuggestion":{"properties":{"issue_id":{"type":"string","title":"Issue Id"},"original_code":{"type":"string","title":"Original Code"},"suggested_code":{"type":"string","title":"Suggested Code"},"explanation":{"type":"string","title":"Explanation"},"line_range":{"additionalProperties":{"type":"integer"},"type":"object","title":"Line Range","description":"Dictionary of items"}},"type":"object","required":["issue_id","original_code","suggested_code","explanation"],"title":"CodeQualityFixSuggestion","description":"Schema for a suggestion to fix a code quality issue"},"CodeQualityIssue":{"properties":{"type":{"type":"string","title":"Type","description":"Type of the issue (code_smell, bug, etc.)"},"line":{"type":"integer","title":"Line","description":"Line number where the issue was found"},"message":{"type":"string","title":"Message","description":"Description of the issue"},"severity":{"type":"string","title":"Severity","description":"Severity level of the issue"},"rule_id":{"type":"string","title":"Rule Id","description":"Identifier of the rule that was violated"}},"type":"object","required":["type","line","message","severity","rule_id"],"title":"CodeQualityIssue","description":"Individual code quality issue found in analysis"},"CodeQualityMetrics":{"properties":{"issue_count":{"type":"integer","title":"Issue Count","description":"Total number of issues found"},"complexity_score":{"type":"number","title":"Complexity Score","description":"Cognitive complexity score"},"maintainability_index":{"type":"number","title":"Maintainability Index","description":"Maintainability index (0-100)"},"severity_distribution":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Severity Distribution","description":"Distribution of issues by severity"}},"additionalProperties":true,"type":"object","required":["issue_count","complexity_score","maintainability_index"],"title":"CodeQualityMetrics","description":"Metrics calculated during code quality analysis.\n\nextra=\"allow\" (Refs #8449): CodeQualityAnalysisService._calculate_metrics\nreturns six keys, including issue_density and issue_type_distribution,\nwhich this model does not declare. Without extra=\"allow\", attaching\nresponse_model=CodeQualityAnalysisRead to POST /analyze would silently\ndrop both from the live response -- the same class of bug PR #8721 found\nand fixed. Declared fields stay documented; undeclared ones still flow\nthrough."},"CodeQualityScores":{"properties":{"overall_score":{"type":"number","title":"Overall Score"},"maintainability":{"type":"number","title":"Maintainability"},"reliability":{"type":"number","title":"Reliability"},"security":{"type":"number","title":"Security"}},"type":"object","required":["overall_score","maintainability","reliability","security"],"title":"CodeQualityScores"},"CodeReviewRequest":{"properties":{"code":{"type":"string","title":"Code","description":"Source code to review"},"language":{"type":"string","title":"Language","description":"Programming language","default":"python"},"file_name":{"type":"string","title":"File Name","description":"Name of the file","default":"code"}},"type":"object","required":["code"],"title":"CodeReviewRequest","description":"Request body for code review"},"CodeReviewResponse":{"properties":{"file_name":{"type":"string","title":"File Name"},"language":{"type":"string","title":"Language"},"timestamp":{"type":"string","title":"Timestamp"},"analysis":{"additionalProperties":true,"type":"object","title":"Analysis"},"summary":{"additionalProperties":true,"type":"object","title":"Summary"}},"type":"object","required":["file_name","language","timestamp","analysis","summary"],"title":"CodeReviewResponse","description":"Response body for code review"},"CodeSessionBridgeResponse":{"properties":{"session_id":{"type":"string","format":"uuid","title":"Session Id"},"worker_token":{"type":"string","title":"Worker Token"},"expires_in":{"type":"integer","title":"Expires In","description":"Token lifetime in seconds"}},"type":"object","required":["session_id","worker_token","expires_in"],"title":"CodeSessionBridgeResponse","description":"Response containing a worker JWT for bridging a session."},"CodeSessionCreate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","title":"CodeSessionCreate","description":"Create a new code session."},"CodeSessionCreateRequest":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Optional session title"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","title":"CodeSessionCreateRequest"},"CodeTriggerCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name","description":"Trigger name"},"schedule":{"type":"string","minLength":1,"title":"Schedule","description":"Cron schedule expression"},"prompt":{"type":"string","minLength":1,"title":"Prompt","description":"Prompt to execute on trigger"},"repo":{"type":"string","minLength":1,"title":"Repo","description":"Repository (e.g. org/repo)"},"branch":{"type":"string","minLength":1,"title":"Branch","description":"Git branch to target"},"github_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Token","description":"GitHub token used to fetch file context and open a PR when this trigger runs. Required for a run to actually execute — without it, run_trigger fails closed rather than silently no-op'ing. Never returned in responses (write-only, Refs #7092)."},"use_memory":{"type":"boolean","title":"Use Memory","description":"When true (default), a run recalls prior project memory before executing and writes a summary back after — same project: namespace convention as Cody CLI's own memory feature (Refs #583).","default":true}},"type":"object","required":["name","schedule","prompt","repo","branch"],"title":"CodeTriggerCreate","description":"Request body for creating a code trigger."},"CodeTriggerListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CodeTriggerResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["items","total","page","page_size"],"title":"CodeTriggerListResponse","description":"Paginated list of code triggers."},"CodeTriggerResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"schedule":{"type":"string","title":"Schedule"},"prompt":{"type":"string","title":"Prompt"},"repo":{"type":"string","title":"Repo"},"branch":{"type":"string","title":"Branch"},"organization_id":{"type":"string","title":"Organization Id"},"use_memory":{"type":"boolean","title":"Use Memory","default":true},"has_github_token":{"type":"boolean","title":"Has Github Token","default":false}},"type":"object","required":["id","name","schedule","prompt","repo","branch","organization_id"],"title":"CodeTriggerResponse","description":"Response body for a single code trigger. github_token is intentionally\nnever included — write-only, per CodeTriggerCreate's docstring."},"CodebaseSearchRequest":{"properties":{"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"ZeroDB project UUID — must be owned by the caller"},"query":{"type":"string","minLength":1,"title":"Query","description":"Natural-language or keyword search query"},"limit":{"type":"integer","maximum":50,"minimum":1,"title":"Limit","description":"Maximum number of results to return (1–50)","default":10},"filters":{"anyOf":[{"$ref":"#/components/schemas/SearchFilters"},{"type":"null"}],"description":"Optional metadata filters"}},"type":"object","required":["project_id","query"],"title":"CodebaseSearchRequest","description":"Request body for POST /codebase/search."},"CodebaseSearchResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"results":{"items":{"$ref":"#/components/schemas/CodeFragment-Output"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"CodebaseSearchResponse","description":"Response for POST /codebase/search."},"CodingSessionCreate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Title"},"model":{"type":"string","maxLength":200,"title":"Model","default":"claude-sonnet-4-20250514"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","title":"CodingSessionCreate","description":"Create a new coding session"},"CodingSessionListResponse":{"properties":{"sessions":{"items":{"$ref":"#/components/schemas/CodingSessionResponse"},"type":"array","title":"Sessions"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["sessions","total"],"title":"CodingSessionListResponse","description":"Paginated list of coding sessions"},"CodingSessionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"status":{"$ref":"#/components/schemas/app__schemas__coding_session__SessionStatusEnum"},"model":{"type":"string","title":"Model"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"event_count":{"type":"integer","title":"Event Count"},"session_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Session Metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","status","model","organization_id","user_id","event_count","created_at"],"title":"CodingSessionResponse","description":"Response for a coding session"},"CodingSessionUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Title"}},"type":"object","title":"CodingSessionUpdate","description":"Update a coding session (PATCH)"},"CodyRecallItem":{"properties":{"content":{"type":"string","title":"Content"},"project":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project"},"memory_type":{"type":"string","title":"Memory Type"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["content","memory_type","created_at"],"title":"CodyRecallItem"},"CodyRecallRequest":{"properties":{"context_query":{"type":"string","maxLength":2000,"minLength":1,"title":"Context Query"},"project":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project"},"limit":{"type":"integer","maximum":50,"minimum":1,"title":"Limit","default":10}},"type":"object","required":["context_query"],"title":"CodyRecallRequest"},"CodyRecallResponse":{"properties":{"memories":{"items":{"$ref":"#/components/schemas/CodyRecallItem"},"type":"array","title":"Memories"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["memories","count"],"title":"CodyRecallResponse"},"CodySessionStubResponse":{"properties":{"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["status","message"],"title":"CodySessionStubResponse","description":"Placeholder shape while this endpoint is stubbed out (Refs #3165, #3723)."},"CogVideoXRequest":{"properties":{"prompt":{"type":"string","maxLength":1000,"minLength":1,"title":"Prompt","description":"Video generation prompt"},"num_frames":{"type":"integer","maximum":49,"minimum":17,"title":"Num Frames","description":"Number of frames (17, 33, or 49)","default":49},"guidance_scale":{"type":"number","maximum":20,"minimum":1,"title":"Guidance Scale","description":"Guidance scale for generation","default":6},"num_inference_steps":{"type":"integer","maximum":100,"minimum":20,"title":"Num Inference Steps","description":"Number of inference steps","default":50}},"type":"object","required":["prompt"],"title":"CogVideoXRequest","description":"Request schema for CogVideoX video generation","example":{"guidance_scale":6,"num_frames":49,"num_inference_steps":50,"prompt":"A cat walking on a busy street in Tokyo at night"}},"CollaborationEventType":{"properties":{"type":{"type":"string","title":"Type"},"description":{"type":"string","title":"Description"}},"type":"object","required":["type","description"],"title":"CollaborationEventType"},"CollaborationMetrics":{"properties":{"agent_runs_today":{"type":"integer","title":"Agent Runs Today"},"rlhf_feedback_today":{"type":"integer","title":"Rlhf Feedback Today"},"active_api_sessions":{"type":"integer","title":"Active Api Sessions"},"total_active_users":{"type":"integer","title":"Total Active Users"}},"type":"object","required":["agent_runs_today","rlhf_feedback_today","active_api_sessions","total_active_users"],"title":"CollaborationMetrics"},"CollaborationUserRole":{"properties":{"role":{"type":"string","title":"Role"},"description":{"type":"string","title":"Description"}},"type":"object","required":["role","description"],"title":"CollaborationUserRole"},"CollectionControlResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["status","message"],"title":"CollectionControlResponse","description":"Response for POST /feedback/collection/start and .../stop.\n\nBoth endpoints return the same two-key shape whether the system was\nalready in the requested state or was just transitioned."},"CollectionsStubResponse":{"properties":{"collections":{"items":{},"type":"array","title":"Collections"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["collections","total","message"],"title":"CollectionsStubResponse","description":"Response for GET /collections (zerodb_analytics stub)."},"CommentRequest":{"properties":{"post_url":{"type":"string","title":"Post Url","description":"Full URL of the LinkedIn post to comment on."},"text":{"type":"string","maxLength":1250,"minLength":1,"title":"Text","description":"Comment body."}},"type":"object","required":["post_url","text"],"title":"CommentRequest"},"CommentUpdate":{"properties":{"content":{"type":"string","maxLength":2000,"minLength":1,"title":"Content","description":"Updated comment content"}},"type":"object","required":["content"],"title":"CommentUpdate","description":"Schema for updating an existing comment","example":{"content":"Updated comment text"}},"CommentsListResponse":{"properties":{"comments":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__comments__CommentResponse"},"type":"array","title":"Comments"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["comments","total","limit","offset"],"title":"CommentsListResponse","description":"Schema for paginated comments list"},"CommitChangesResponse":{"properties":{"status":{"type":"string","title":"Status"},"commit_result":{"additionalProperties":true,"type":"object","title":"Commit Result"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","commit_result","timestamp"],"title":"CommitChangesResponse","description":"Response for POST /git-integration/commit."},"CommitHistoryResponse":{"properties":{"status":{"type":"string","title":"Status"},"commits":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Commits"},"commit_count":{"type":"integer","title":"Commit Count"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","commits","commit_count","timestamp"],"title":"CommitHistoryResponse","description":"Response for GET /git-integration/history/{project_path}."},"CommunicationSettings":{"properties":{"preferred_language":{"type":"string","title":"Preferred Language","default":"en"},"timezone":{"type":"string","title":"Timezone","default":"UTC"},"email_frequency":{"type":"string","title":"Email Frequency","default":"daily"},"slack_notifications":{"type":"boolean","title":"Slack Notifications","default":false},"teams_notifications":{"type":"boolean","title":"Teams Notifications","default":false},"discord_notifications":{"type":"boolean","title":"Discord Notifications","default":false}},"type":"object","title":"CommunicationSettings","description":"User communication settings (Issue #2191 response_model coverage)"},"CommunicationSettingsUpdate":{"properties":{"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"email_frequency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Frequency"}},"type":"object","title":"CommunicationSettingsUpdate","description":"Schema for updating communication settings - all fields optional"},"CommunityMember":{"properties":{"id":{"type":"string","title":"Id"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"skills":{"items":{"type":"string"},"type":"array","title":"Skills","default":[]},"interests":{"items":{"type":"string"},"type":"array","title":"Interests","default":[]},"follower_count":{"type":"integer","title":"Follower Count","default":0},"is_following":{"type":"boolean","title":"Is Following","default":false}},"type":"object","required":["id"],"title":"CommunityMember"},"CommunityModerationQueueResponse":{"properties":{"total_count":{"type":"integer","title":"Total Count","description":"Total posts awaiting review"},"skip":{"type":"integer","title":"Skip","description":"Records skipped"},"limit":{"type":"integer","title":"Limit","description":"Page size"},"posts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Posts","description":"Queued posts with moderation metadata (empty list when none)"}},"additionalProperties":true,"type":"object","required":["total_count","skip","limit","posts"],"title":"CommunityModerationQueueResponse","description":"Admin moderation queue page.\n\nAdmin-gated (current_user.role must be ADMIN or SUPERUSER, checked before\nthe delegate call), so extra=\"allow\" is safe here. Queue entries are typed\nas Dict[str, Any] because each row carries an arbitrary\nmoderation_metadata blob written by the moderation service."},"CompanyPassportResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"legal_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name"},"ein":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ein"},"incorporation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incorporation Date"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"corporate_address":{"$ref":"#/components/schemas/CorporateAddress"},"signing_officer":{"$ref":"#/components/schemas/SigningOfficer"},"bank_accounts":{"items":{"$ref":"#/components/schemas/PassportBankAccount"},"type":"array","title":"Bank Accounts"},"mercury_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mercury Status","description":"connected | expired | disconnected | error | manual"},"quickbooks_realm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quickbooks Realm Id","description":"QuickBooks company id, when QuickBooks is linked"},"stripe_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Account Id","description":"Always null today — no real source exists in core yet. Present so the passport UI can lay out the field; never fabricated."},"delaware_file_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delaware File Number","description":"Always null today — no real source exists in core yet. Present so the passport UI can lay out the field; never fabricated."}},"type":"object","required":["organization_id"],"title":"CompanyPassportResponse"},"ComparativeInsightsResponse":{"properties":{"comparison_timestamp":{"type":"string","title":"Comparison Timestamp"},"prompts_analyzed":{"type":"integer","title":"Prompts Analyzed"},"time_window_days":{"type":"integer","title":"Time Window Days"},"performance_ranking":{"items":{},"type":"array","title":"Performance Ranking"},"best_performer":{"$ref":"#/components/schemas/BestWorstPerformer"},"worst_performer":{"$ref":"#/components/schemas/BestWorstPerformer"},"trend_analysis":{"$ref":"#/components/schemas/ComparativeTrendAnalysis"},"recommendations":{"$ref":"#/components/schemas/ComparativeRecommendations"}},"type":"object","required":["comparison_timestamp","prompts_analyzed","time_window_days","performance_ranking","best_performer","worst_performer","trend_analysis","recommendations"],"title":"ComparativeInsightsResponse","description":"Response for GET /insights/comparative."},"ComparativeRecommendations":{"properties":{"focus_areas":{"items":{"type":"string"},"type":"array","title":"Focus Areas","default":[]},"best_practices":{"items":{"type":"string"},"type":"array","title":"Best Practices","default":[]},"optimization_opportunities":{"items":{"type":"string"},"type":"array","title":"Optimization Opportunities","default":[]}},"type":"object","title":"ComparativeRecommendations"},"ComparativeTrendAnalysis":{"properties":{"most_improving":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Most Improving"},"most_declining":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Most Declining"},"stable_prompts":{"type":"integer","title":"Stable Prompts"},"volatile_prompts":{"type":"integer","title":"Volatile Prompts"}},"type":"object","required":["stable_prompts","volatile_prompts"],"title":"ComparativeTrendAnalysis"},"CompareSnapshotsResponse":{"properties":{"status":{"type":"string","title":"Status","description":"not_found | error | success"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"comparison_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Comparison Id"},"snapshot1":{"anyOf":[{"$ref":"#/components/schemas/SnapshotSummaryRef"},{"type":"null"}]},"snapshot2":{"anyOf":[{"$ref":"#/components/schemas/SnapshotSummaryRef"},{"type":"null"}]},"summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Summary"},"diffs":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Diffs"}},"type":"object","required":["status"],"title":"CompareSnapshotsResponse","description":"Response for POST /snapshots/compare (SnapshotSystem.compare_snapshots)."},"ComparisonProject":{"properties":{"id":{"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"organization_id":{"anyOf":[{},{"type":"null"}],"title":"Organization Id"}},"additionalProperties":true,"type":"object","required":["id"],"title":"ComparisonProject"},"CompleteStepRequest":{"properties":{"step_id":{"type":"string","title":"Step Id","description":"Onboarding step identifier"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},"type":"object","required":["step_id"],"title":"CompleteStepRequest","description":"Body for marking one onboarding step complete."},"Completion":{"properties":{"completion_id":{"type":"string","title":"Completion Id","description":"Unique completion identifier"},"impression_id":{"type":"string","title":"Impression Id","description":"Related impression ID"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID"},"creative_id":{"type":"string","title":"Creative Id","description":"Creative ID"},"event_id":{"type":"string","title":"Event Id","description":"Event ID"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User ID (None if anonymous)"},"milestone":{"$ref":"#/components/schemas/CompletionMilestone","description":"Completion milestone reached"},"video_duration":{"type":"integer","exclusiveMinimum":0,"title":"Video Duration","description":"Total video duration in seconds"},"watch_time":{"type":"integer","minimum":0,"title":"Watch Time","description":"Seconds watched"},"engagement_score":{"type":"number","maximum":1,"minimum":0,"title":"Engagement Score","description":"Engagement score based on milestone (0.0 to 1.0)"},"credit_bonus":{"type":"number","minimum":0,"title":"Credit Bonus","description":"Credit bonus awarded (only for 100% completion)"},"tracked_at":{"type":"string","format":"date-time","title":"Tracked At","description":"Timestamp when completion was tracked"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Record creation timestamp"}},"type":"object","required":["completion_id","impression_id","campaign_id","creative_id","event_id","milestone","video_duration","watch_time","engagement_score","credit_bonus","tracked_at","created_at"],"title":"Completion","description":"Schema for completion response\nIssue #564: Ad Completion Tracking (Video)\n\nReturned after successfully tracking a video completion.\nIncludes all tracked data plus system-generated fields and calculated metrics.","example":{"campaign_id":"camp_abc123","completion_id":"comp_xyz789abc123","created_at":"2026-01-05T14:40:00Z","creative_id":"creative_video789","credit_bonus":0.01,"engagement_score":1,"event_id":"event_pai2026","impression_id":"imp_abc123def456","milestone":"complete","tracked_at":"2026-01-05T14:40:00Z","user_id":"user_xyz789","video_duration":60,"watch_time":60}},"CompletionCreate":{"properties":{"impression_id":{"type":"string","title":"Impression Id","description":"Impression ID that was completed (required - links to impression)"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID that served the video ad"},"creative_id":{"type":"string","title":"Creative Id","description":"Creative ID (must be VIDEO type)"},"event_id":{"type":"string","title":"Event Id","description":"Event ID where video was watched"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User ID if authenticated"},"milestone":{"$ref":"#/components/schemas/CompletionMilestone","description":"Completion milestone reached (0%, 25%, 50%, 75%, 100%)"},"video_duration":{"type":"integer","exclusiveMinimum":0,"title":"Video Duration","description":"Total video duration in seconds"},"watch_time":{"type":"integer","minimum":0,"title":"Watch Time","description":"Seconds of video watched"}},"type":"object","required":["impression_id","campaign_id","creative_id","event_id","milestone","video_duration","watch_time"],"title":"CompletionCreate","description":"Schema for creating a video completion tracking record\nIssue #564: Ad Completion Tracking (Video)\n\nRequired for tracking video ad completion milestones for engagement metrics.\nOnly applicable to video ad creatives.","example":{"campaign_id":"camp_abc123","creative_id":"creative_video789","event_id":"event_pai2026","impression_id":"imp_abc123def456","milestone":"complete","user_id":"user_xyz789","video_duration":60,"watch_time":60}},"CompletionMilestone":{"type":"string","enum":["started","quarter","half","three_quarter","complete"],"title":"CompletionMilestone","description":"Video completion milestone percentages"},"CompletionRatesResponse":{"properties":{"timeframe":{"type":"string","title":"Timeframe"},"overall_rates":{"$ref":"#/components/schemas/OverallCompletionRates"},"completion_by_stage":{"additionalProperties":{"type":"number"},"type":"object","title":"Completion By Stage"},"completion_by_tutorial":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Completion By Tutorial"},"completion_trends":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Completion Trends"},"drop_off_analysis":{"additionalProperties":true,"type":"object","title":"Drop Off Analysis"},"improvement_areas":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Improvement Areas"}},"type":"object","required":["timeframe","overall_rates","completion_by_stage","completion_by_tutorial","completion_trends","drop_off_analysis","improvement_areas"],"title":"CompletionRatesResponse","description":"Response for GET /onboarding-tutorials/completion-rates."},"ComplianceAttestation":{"properties":{"compliant":{"type":"boolean","title":"Compliant"},"confidence_level":{"type":"string","title":"Confidence Level"},"next_review_date":{"type":"string","title":"Next Review Date"},"certifying_official":{"type":"string","title":"Certifying Official"}},"type":"object","required":["compliant","confidence_level","next_review_date","certifying_official"],"title":"ComplianceAttestation"},"ComplianceAuditCoverage":{"properties":{"total_required_events":{"type":"integer","title":"Total Required Events"},"events_captured":{"type":"integer","title":"Events Captured"},"coverage_percentage":{"type":"number","title":"Coverage Percentage"},"missing_event_types":{"items":{"type":"string"},"type":"array","title":"Missing Event Types"}},"type":"object","required":["total_required_events","events_captured","coverage_percentage","missing_event_types"],"title":"ComplianceAuditCoverage"},"ComplianceControlAssessment":{"properties":{"control_id":{"type":"string","title":"Control Id"},"status":{"type":"string","title":"Status"},"evidence_count":{"type":"integer","title":"Evidence Count"},"exceptions":{"type":"integer","title":"Exceptions"},"last_reviewed":{"type":"string","title":"Last Reviewed"}},"type":"object","required":["control_id","status","evidence_count","exceptions","last_reviewed"],"title":"ComplianceControlAssessment"},"ComplianceFrameworkEntry":{"properties":{"framework":{"type":"string","title":"Framework"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["framework","name","description"],"title":"ComplianceFrameworkEntry"},"ComplianceFrameworkReport":{"properties":{"framework":{"type":"string","title":"Framework"},"period":{"type":"string","title":"Period"},"total_events":{"type":"integer","title":"Total Events"},"violations":{"type":"integer","title":"Violations"},"compliance_percentage":{"type":"number","title":"Compliance Percentage"},"violation_details":{"items":{"$ref":"#/components/schemas/ComplianceViolationDetail"},"type":"array","title":"Violation Details"}},"type":"object","required":["framework","period","total_events","violations","compliance_percentage","violation_details"],"title":"ComplianceFrameworkReport"},"ComplianceGeneratedBy":{"properties":{"user_id":{"title":"User Id"},"username":{"type":"string","title":"Username"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["user_id","username","timestamp"],"title":"ComplianceGeneratedBy"},"CompliancePeriod":{"properties":{"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"duration_days":{"type":"integer","title":"Duration Days"}},"type":"object","required":["start_date","end_date","duration_days"],"title":"CompliancePeriod"},"ComplianceReportPeriod":{"properties":{"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"}},"type":"object","required":["start_date","end_date"],"title":"ComplianceReportPeriod"},"ComplianceReportRequest":{"properties":{"frameworks":{"items":{"type":"string"},"type":"array","title":"Frameworks","description":"Compliance frameworks"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Report start date"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"Report end date"}},"type":"object","required":["frameworks","start_date","end_date"],"title":"ComplianceReportRequest","description":"Request to generate compliance report"},"ComplianceReportSummary":{"properties":{"total_frameworks":{"type":"integer","title":"Total Frameworks"},"total_violations":{"type":"integer","title":"Total Violations"},"risk_level":{"type":"string","title":"Risk Level"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["total_frameworks","total_violations","risk_level","recommendations"],"title":"ComplianceReportSummary"},"ComplianceSecurityMetrics":{"properties":{"failed_login_attempts":{"type":"integer","title":"Failed Login Attempts"},"unauthorized_access_attempts":{"type":"integer","title":"Unauthorized Access Attempts"},"privilege_escalations":{"type":"integer","title":"Privilege Escalations"},"data_breach_incidents":{"type":"integer","title":"Data Breach Incidents"},"policy_violations":{"type":"integer","title":"Policy Violations"}},"type":"object","required":["failed_login_attempts","unauthorized_access_attempts","privilege_escalations","data_breach_incidents","policy_violations"],"title":"ComplianceSecurityMetrics"},"ComplianceStandardInfo":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"key_requirements":{"items":{"type":"string"},"type":"array","title":"Key Requirements"},"audit_retention":{"type":"string","title":"Audit Retention"},"required_logs":{"items":{"type":"string"},"type":"array","title":"Required Logs"}},"type":"object","required":["name","description","key_requirements","audit_retention","required_logs"],"title":"ComplianceStandardInfo"},"ComplianceStandardStatus":{"properties":{"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"}},"type":"object","required":["name","status"],"title":"ComplianceStandardStatus"},"ComplianceStatusResponse":{"properties":{"framework":{"type":"string","title":"Framework"},"compliance_percentage":{"type":"number","title":"Compliance Percentage"},"status":{"type":"string","title":"Status"},"total_rules":{"type":"integer","title":"Total Rules"},"compliant_rules":{"type":"integer","title":"Compliant Rules"},"last_assessment":{"type":"string","format":"date-time","title":"Last Assessment"},"rules_assessment":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Rules Assessment"}},"type":"object","required":["framework","compliance_percentage","status","total_rules","compliant_rules","last_assessment","rules_assessment"],"title":"ComplianceStatusResponse","description":"Compliance status response"},"ComplianceViolationDetail":{"properties":{"event_id":{"type":"string","title":"Event Id"},"event_type":{"type":"string","title":"Event Type"},"timestamp":{"type":"string","title":"Timestamp"},"risk_score":{"type":"integer","title":"Risk Score"}},"type":"object","required":["event_id","event_type","timestamp","risk_score"],"title":"ComplianceViolationDetail"},"ComponentInfo":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"type":{"type":"string","title":"Type"}},"type":"object","required":["name","description","type"],"title":"ComponentInfo"},"ComprehensiveEvaluationRequest":{"properties":{"generated_code":{"type":"string","title":"Generated Code","description":"The AI-generated code to evaluate"},"original_prompt":{"type":"string","title":"Original Prompt","description":"Original user prompt/query"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Context used for generation","default":""},"expected_output":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Output","description":"Expected/reference code"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project context"},"file_path":{"type":"string","title":"File Path","description":"Virtual file path for the code","default":"generated_code.py"},"evaluation_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evaluation Options","description":"Custom evaluation configuration"}},"type":"object","required":["generated_code","original_prompt"],"title":"ComprehensiveEvaluationRequest","description":"Request model for comprehensive code evaluation"},"ComprehensiveEvaluationStartedResponse":{"properties":{"evaluation_id":{"type":"string","title":"Evaluation Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"estimated_duration_seconds":{"type":"integer","title":"Estimated Duration Seconds"},"tracking_url":{"type":"string","title":"Tracking Url"}},"type":"object","required":["evaluation_id","status","message","estimated_duration_seconds","tracking_url"],"title":"ComprehensiveEvaluationStartedResponse","description":"Response for POST /evaluate (202 Accepted)."},"ComprehensiveMetricsData":{"properties":{"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","description":"Report generation timestamp"},"kong_metrics":{"anyOf":[{"$ref":"#/components/schemas/KongMetricsData"},{"type":"null"}],"description":"API-gateway metrics"},"websocket_metrics":{"anyOf":[{"$ref":"#/components/schemas/WebSocketMetricsData"},{"type":"null"}],"description":"WebSocket metrics"},"container_metrics":{"anyOf":[{"$ref":"#/components/schemas/ContainerMetricsData"},{"type":"null"}],"description":"Container metrics"},"billing_metrics":{"anyOf":[{"$ref":"#/components/schemas/BillingMetricsData"},{"type":"null"}],"description":"Billing metrics"},"health_status":{"anyOf":[{"$ref":"#/components/schemas/ProxyHealthStatusData"},{"type":"null"}],"description":"Aggregated health"},"collection_metadata":{"anyOf":[{"$ref":"#/components/schemas/MetricsCollectionMetadata"},{"type":"null"}],"description":"Collection metadata"},"historical_data":{"anyOf":[{"$ref":"#/components/schemas/HistoricalMetricsData"},{"type":"null"}],"description":"Historical trend data (admin, include_historical=true)"}},"additionalProperties":true,"type":"object","title":"ComprehensiveMetricsData","description":"`data` block of GET /metrics.\n\nNon-admin callers receive sections narrowed by `_filter_user_metrics()`,\nwhich is why every section is optional and permissive."},"ComprehensiveMetricsRequestMetadata":{"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"Requesting user id"},"is_admin":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Admin","description":"Whether the caller is an admin"},"collection_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collection Time","description":"ISO timestamp of this collection"},"time_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Range","description":"Requested time range"},"include_historical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Historical","description":"Whether history was requested"}},"additionalProperties":true,"type":"object","title":"ComprehensiveMetricsRequestMetadata","description":"`metadata` block of GET /metrics — echoes the request's own context."},"ComprehensiveMetricsResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always true on a 200"},"data":{"$ref":"#/components/schemas/ComprehensiveMetricsData","description":"Collected metrics"},"metadata":{"$ref":"#/components/schemas/ComprehensiveMetricsRequestMetadata","description":"Request context"}},"additionalProperties":true,"type":"object","required":["success","data","metadata"],"title":"ComprehensiveMetricsResponse","description":"GET /api/v1/mcp/proxy/metrics"},"Compression":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"min_size":{"type":"integer","title":"Min Size"},"types":{"items":{"type":"string"},"type":"array","title":"Types"}},"type":"object","required":["enabled","min_size","types"],"title":"Compression"},"ConfidenceInterval":{"properties":{"lower":{"type":"number","title":"Lower"},"upper":{"type":"number","title":"Upper"}},"type":"object","required":["lower","upper"],"title":"ConfidenceInterval"},"ConfidenceRequest":{"properties":{"response":{"type":"string","title":"Response","description":"Agent response text to rate"},"context":{"items":{"type":"string"},"type":"array","title":"Context","description":"Context strings available at generation time"}},"type":"object","required":["response"],"title":"ConfidenceRequest"},"ConfidenceResponse":{"properties":{"score":{"type":"number","title":"Score"}},"type":"object","required":["score"],"title":"ConfidenceResponse"},"ConfigurationTuning":{"properties":{"shared_buffers":{"type":"string","title":"Shared Buffers"},"max_connections":{"type":"string","title":"Max Connections"},"work_mem":{"type":"string","title":"Work Mem"},"effective_cache_size":{"type":"string","title":"Effective Cache Size"}},"type":"object","required":["shared_buffers","max_connections","work_mem","effective_cache_size"],"title":"ConfigurationTuning"},"ConfigureAgentPromptsResponse":{"properties":{"template_id":{"type":"string","title":"Template Id"},"agent_type":{"title":"Agent Type"},"task_type":{"title":"Task Type"},"message":{"type":"string","title":"Message"},"template_name":{"type":"string","title":"Template Name"}},"type":"object","required":["template_id","agent_type","task_type","message","template_name"],"title":"ConfigureAgentPromptsResponse"},"ConfigureAutoSnapshotResponse":{"properties":{"status":{"type":"string","title":"Status","description":"configured | error"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"config_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Config Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"trigger_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger Type"},"trigger_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trigger Config"},"retention_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retention Days"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["status"],"title":"ConfigureAutoSnapshotResponse","description":"Response for POST /snapshots/auto/configure (SnapshotSystem.configure_auto_snapshot)."},"ConfigureWorkspaceRequest":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":3,"title":"Domain"},"admin_subject":{"type":"string","format":"email","title":"Admin Subject"}},"type":"object","required":["domain","admin_subject"],"title":"ConfigureWorkspaceRequest","description":"Bind a Google Workspace domain to the caller's org (DWD auth). Refs #5750."},"ConfirmEmailChangeRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"ConfirmEmailChangeRequest","description":"Confirm a pending email change with the token from the confirmation email. Refs ainative-ax#167"},"ConfirmEmailChangeResponse":{"properties":{"message":{"type":"string","title":"Message"},"email":{"type":"string","title":"Email"}},"type":"object","required":["message","email"],"title":"ConfirmEmailChangeResponse"},"ConfirmUploadResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"file_id":{"type":"string","title":"File Id"},"file_name":{"type":"string","title":"File Name"},"file_key":{"type":"string","title":"File Key"},"size_bytes":{"type":"integer","title":"Size Bytes"},"size_mb":{"type":"number","title":"Size Mb"},"content_type":{"type":"string","title":"Content Type"},"bucket":{"type":"string","title":"Bucket"},"storage_usage_mb":{"type":"number","title":"Storage Usage Mb"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","file_id","file_name","file_key","size_bytes","size_mb","content_type","bucket","storage_usage_mb","message"],"title":"ConfirmUploadResponse"},"ConnectBankRequest":{"properties":{"provider":{"type":"string","enum":["mercury","brex","rho","chase","svb","other"],"title":"Provider","description":"Bank to connect. Only mercury syncs live for MVP."},"nickname":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Nickname","description":"Display name on the Integrations screen."}},"type":"object","required":["provider"],"title":"ConnectBankRequest"},"ConnectLinkResponse":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"ConnectLinkResponse","description":"Response for Connect link requests"},"ConnectOnboardingResponse":{"properties":{"onboarding_url":{"type":"string","title":"Onboarding Url"},"account_id":{"type":"string","title":"Account Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["onboarding_url","account_id","message"],"title":"ConnectOnboardingResponse","description":"Response for Connect onboarding initiation"},"ConnectRequestPayload":{"properties":{"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"ConnectRequestPayload"},"ConnectRequestResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"status":{"type":"string","title":"Status"},"vendor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Name"}},"type":"object","required":["request_id","status"],"title":"ConnectRequestResponse"},"ConnectResponse":{"properties":{"authorization_url":{"type":"string","title":"Authorization Url"},"state":{"type":"string","title":"State"}},"type":"object","required":["authorization_url","state"],"title":"ConnectResponse"},"ConnectStatusResponse":{"properties":{"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"connect_enabled":{"type":"boolean","title":"Connect Enabled"},"onboarding_complete":{"type":"boolean","title":"Onboarding Complete"},"verified_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verified At"},"payouts_enabled":{"type":"boolean","title":"Payouts Enabled","default":false},"charges_enabled":{"type":"boolean","title":"Charges Enabled","default":false}},"type":"object","required":["connect_enabled","onboarding_complete"],"title":"ConnectStatusResponse","description":"Response for Connect account status"},"ConnectStripeRequest":{"properties":{"api_key":{"type":"string","minLength":12,"title":"Api Key","description":"A Stripe Restricted API key (rk_...) with read-only access to Charges, Invoices, and Balance. Never a Secret key."},"nickname":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Nickname","description":"Display name on the Integrations screen."}},"type":"object","required":["api_key"],"title":"ConnectStripeRequest"},"ConnectedAgentItem":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"status":{"type":"string","title":"Status"},"capabilities":{"additionalProperties":true,"type":"object","title":"Capabilities"},"created_at":{"type":"string","title":"Created At"},"last_ping":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ping"},"uptime_seconds":{"type":"integer","title":"Uptime Seconds"},"created_by":{"type":"string","title":"Created By"}},"additionalProperties":true,"type":"object","required":["agent_id","name","type","status","capabilities","created_at","uptime_seconds","created_by"],"title":"ConnectedAgentItem","description":"One agent row in GET /agent-bridge/agents."},"ConnectedAgentsData":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/ConnectedAgentItem"},"type":"array","title":"Agents"},"total_agents":{"type":"integer","title":"Total Agents"},"active_agents":{"type":"integer","title":"Active Agents"},"inactive_agents":{"type":"integer","title":"Inactive Agents"}},"additionalProperties":true,"type":"object","required":["agents","total_agents","active_agents","inactive_agents"],"title":"ConnectedAgentsData","description":"The `data` payload of GET /agent-bridge/agents."},"ConnectedAgentsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ConnectedAgentsData"}},"additionalProperties":true,"type":"object","required":["success","data"],"title":"ConnectedAgentsResponse","description":"Response for GET /agent-bridge/agents."},"ConnectionCard":{"properties":{"integration_type":{"type":"string","title":"Integration Type"},"connected":{"type":"boolean","title":"Connected"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"environment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"masked_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Masked Key"},"last_tested_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Tested At"},"last_test_ok":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Last Test Ok"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"}},"type":"object","required":["integration_type","connected"],"title":"ConnectionCard","description":"One Zero-app card in the Integrations page's connections grid (#7556)."},"ConnectionDraining":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"timeout":{"type":"integer","title":"Timeout"}},"type":"object","required":["enabled","timeout"],"title":"ConnectionDraining"},"ConnectionInput":{"properties":{"name":{"type":"string","title":"Name"},"firm":{"type":"string","title":"Firm","default":""},"title":{"type":"string","title":"Title","default":""},"context":{"type":"string","title":"Context","default":""}},"type":"object","required":["name"],"title":"ConnectionInput"},"ConnectionPoolMetrics":{"properties":{"pool_size":{"type":"integer","title":"Pool Size"},"active_connections":{"type":"integer","title":"Active Connections"},"idle_connections":{"type":"integer","title":"Idle Connections"},"checked_out":{"type":"integer","title":"Checked Out"},"overflow":{"type":"integer","title":"Overflow"},"invalid":{"type":"integer","title":"Invalid"},"pool_utilization":{"type":"number","title":"Pool Utilization"},"average_checkout_time":{"type":"number","title":"Average Checkout Time"},"max_checkout_time":{"type":"number","title":"Max Checkout Time"},"connection_errors":{"type":"integer","title":"Connection Errors"},"timeouts":{"type":"integer","title":"Timeouts"},"health_status":{"type":"string","title":"Health Status"}},"type":"object","required":["pool_size","active_connections","idle_connections","checked_out","overflow","invalid","pool_utilization","average_checkout_time","max_checkout_time","connection_errors","timeouts","health_status"],"title":"ConnectionPoolMetrics"},"ConnectionResponse":{"properties":{"status":{"type":"string","title":"Status"},"masked_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Masked Key"}},"type":"object","required":["status"],"title":"ConnectionResponse"},"ConnectionsListResponse":{"properties":{"connections":{"items":{"$ref":"#/components/schemas/ConnectionCard"},"type":"array","title":"Connections"},"connected_count":{"type":"integer","title":"Connected Count"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["connections","connected_count","total_count"],"title":"ConnectionsListResponse"},"ConnectorHealthItem":{"properties":{"id":{"type":"string","title":"Id"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"last_synced_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Synced At"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"memory_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Count"},"is_stale":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Stale"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"additionalProperties":true,"type":"object","required":["id"],"title":"ConnectorHealthItem"},"ConnectorHealthResponse":{"properties":{"connectors":{"items":{"$ref":"#/components/schemas/ConnectorHealthItem"},"type":"array","title":"Connectors"},"summary":{"$ref":"#/components/schemas/ConnectorHealthSummary"}},"additionalProperties":true,"type":"object","required":["summary"],"title":"ConnectorHealthResponse","description":"Response for GET /memory/v2/graph/connectors/health."},"ConnectorHealthSummary":{"properties":{"total":{"type":"integer","title":"Total"},"healthy":{"type":"integer","title":"Healthy"},"stale":{"type":"integer","title":"Stale"},"errored":{"type":"integer","title":"Errored"},"health_pct":{"type":"number","title":"Health Pct"}},"additionalProperties":true,"type":"object","required":["total","healthy","stale","errored","health_pct"],"title":"ConnectorHealthSummary"},"ConnectorStatusResponse":{"properties":{"source_id":{"type":"string","title":"Source Id"},"sensor_type":{"type":"string","title":"Sensor Type"},"status":{"type":"string","title":"Status"},"last_data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Data"},"records_per_hour":{"type":"integer","title":"Records Per Hour","default":0},"category":{"type":"string","title":"Category","default":""}},"type":"object","required":["source_id","sensor_type","status"],"title":"ConnectorStatusResponse"},"ConsentCoverageStatsResponse":{"properties":{"opt_out_model_authoritative":{"type":"boolean","title":"Opt Out Model Authoritative"},"total_user_accounts":{"type":"integer","title":"Total User Accounts"},"explicit_granted_count":{"type":"integer","title":"Explicit Granted Count"},"explicit_excluded_count":{"type":"integer","title":"Explicit Excluded Count"},"explicit_withdrawn_count":{"type":"integer","title":"Explicit Withdrawn Count"},"sellable_trace_count":{"type":"integer","title":"Sellable Trace Count"},"excluded_trace_count":{"type":"integer","title":"Excluded Trace Count"},"withdrawn_trace_count":{"type":"integer","title":"Withdrawn Trace Count"},"untagged_trace_count":{"type":"integer","title":"Untagged Trace Count"},"scrub_qa_results_available":{"type":"boolean","title":"Scrub Qa Results Available"}},"type":"object","required":["opt_out_model_authoritative","total_user_accounts","explicit_granted_count","explicit_excluded_count","explicit_withdrawn_count","sellable_trace_count","excluded_trace_count","withdrawn_trace_count","untagged_trace_count","scrub_qa_results_available"],"title":"ConsentCoverageStatsResponse"},"ConsentGrantResponse":{"properties":{"status":{"type":"string","title":"Status"},"basis":{"type":"string","title":"Basis"},"granted":{"type":"boolean","title":"Granted"}},"type":"object","required":["status","basis","granted"],"title":"ConsentGrantResponse"},"ConsentStatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"basis":{"type":"string","title":"Basis"},"is_enterprise":{"type":"boolean","title":"Is Enterprise"},"has_explicit_record":{"type":"boolean","title":"Has Explicit Record"},"authoritative":{"type":"boolean","title":"Authoritative"}},"type":"object","required":["status","basis","is_enterprise","has_explicit_record","authoritative"],"title":"ConsentStatusResponse"},"ConsentWithdrawResponse":{"properties":{"status":{"type":"string","title":"Status"},"withdrawn":{"type":"boolean","title":"Withdrawn"}},"type":"object","required":["status","withdrawn"],"title":"ConsentWithdrawResponse"},"ConsolidationJobEntry":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"status":{"type":"string","title":"Status"},"strategy":{"type":"string","title":"Strategy"},"memories_processed":{"type":"integer","title":"Memories Processed"},"insights_created":{"type":"integer","title":"Insights Created"},"relationships_created":{"type":"integer","title":"Relationships Created"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"started_at":{"type":"string","title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"}},"type":"object","required":["id","status","strategy","memories_processed","insights_created","relationships_created","started_at"],"title":"ConsolidationJobEntry","description":"A single row from the real `consolidation_jobs` table.\n\nField-for-field match of the columns created in migration\n20260308_03_consolidation_jobs.py and written by\nMemoryConsolidationWorker._track_job()/._complete_job() (app/services/\nmemory/consolidation_worker.py). `status` is one of pending, running,\ncompleted, failed, cancelled (DB check constraint `valid_status`).\n`completed_at`/`duration_seconds`/`error_message` are nullable because a\nstill-running or just-started job has not set them yet."},"ConsolidationJobListResponse":{"properties":{"total":{"type":"integer","title":"Total"},"jobs":{"items":{"$ref":"#/components/schemas/ConsolidationJobEntry"},"type":"array","title":"Jobs"}},"type":"object","required":["total","jobs"],"title":"ConsolidationJobListResponse","description":"Response for GET /consolidation/jobs."},"ConsolidationRunResponse":{"properties":{"job_id":{"type":"string","title":"Job Id"},"memories_processed":{"type":"integer","title":"Memories Processed"},"clusters_found":{"type":"integer","title":"Clusters Found"},"insights_created":{"type":"integer","title":"Insights Created"},"relationships_created":{"type":"integer","title":"Relationships Created"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors"},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Seconds"}},"type":"object","required":["job_id","memories_processed","clusters_found","insights_created","relationships_created","errors"],"title":"ConsolidationRunResponse","description":"Response for POST /consolidation/run.\n\nField-for-field match of the `stats` dict initialized and mutated in\nMemoryConsolidationWorker.run_consolidation_cycle(): job_id and\nmemories_processed/clusters_found/insights_created/relationships_created\ncounters are always present, and errors is always a list (possibly\nempty) collecting any per-cluster processing failures.\n\n`duration_seconds` is Optional: the \"no consolidatable memories found\"\nbranch does an early `return stats` BEFORE `duration_seconds` is\ncomputed and set on `stats`, so that one real branch omits the key\nentirely while every other branch (success-with-memories, and the\nouter-exception/failed path) includes it."},"ConsumeSignalResponse":{"properties":{"status":{"type":"string","title":"Status"},"signal_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signal Id"},"consumed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consumed By"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["status"],"title":"ConsumeSignalResponse","description":"Result of marking a signal consumed by an agent. Refs #4236"},"ConsumerEntry":{"properties":{"consumer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consumer Id"},"display_name":{"type":"string","title":"Display Name"},"query_count":{"type":"integer","title":"Query Count"},"credits_consumed":{"type":"integer","title":"Credits Consumed"}},"type":"object","required":["display_name","query_count","credits_consumed"],"title":"ConsumerEntry"},"ContactSubmission":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"inquiry_type":{"type":"string","maxLength":100,"minLength":1,"title":"Inquiry Type"},"subject":{"type":"string","maxLength":300,"minLength":1,"title":"Subject"},"message":{"type":"string","maxLength":5000,"minLength":1,"title":"Message"}},"type":"object","required":["name","email","inquiry_type","subject","message"],"title":"ContactSubmission","description":"Contact-form payload. Email is validated as a real address."},"ContactSubmitResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"crm_recorded":{"type":"boolean","title":"Crm Recorded"},"team_notified":{"type":"boolean","title":"Team Notified"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","crm_recorded","team_notified","message"],"title":"ContactSubmitResponse","description":"Honest result: whether the lead was recorded and the team was alerted."},"ContainerCacheInfo":{"properties":{"cached":{"type":"boolean","title":"Cached","default":false},"cached_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cached At"},"cache_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cache Status"},"cache_age_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cache Age Seconds"}},"type":"object","title":"ContainerCacheInfo","description":"Container cache information"},"ContainerHealthStatus":{"properties":{"healthy":{"type":"boolean","title":"Healthy","default":false},"response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time Ms"},"last_check":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Check"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint"}},"type":"object","title":"ContainerHealthStatus","description":"Container health status information"},"ContainerMetricsData":{"properties":{"total_containers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Containers","description":"Registered MCP containers"},"healthy_containers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Healthy Containers","description":"Containers passing health checks"},"unhealthy_containers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Unhealthy Containers","description":"Containers failing health checks"},"avg_response_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Response Time","description":"Mean container response time (ms)"},"container_uptime":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Container Uptime","description":"Uptime percentage keyed by container id"},"resource_usage":{"anyOf":[{"additionalProperties":{"additionalProperties":{"type":"number"},"type":"object"},"type":"object"},{"type":"null"}],"title":"Resource Usage","description":"Resource usage metrics keyed by container id"},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp","description":"Collection timestamp"}},"additionalProperties":true,"type":"object","title":"ContainerMetricsData","description":"Mirror of mcp_proxy_metrics_service.ContainerMetrics."},"ContainerMetricsEnvelope":{"properties":{"container_metrics":{"$ref":"#/components/schemas/ContainerMetricsData","description":"Container metrics"},"collection_time":{"type":"string","title":"Collection Time","description":"ISO timestamp of collection"}},"additionalProperties":true,"type":"object","required":["container_metrics","collection_time"],"title":"ContainerMetricsEnvelope","description":"`data` block of the container metrics route."},"ContainerMetricsResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always true on a 200"},"data":{"$ref":"#/components/schemas/ContainerMetricsEnvelope","description":"Container metrics payload"}},"additionalProperties":true,"type":"object","required":["success","data"],"title":"ContainerMetricsResponse","description":"GET /api/v1/mcp/proxy/metrics/containers"},"ContainerRegistryInfo":{"properties":{"internal_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Internal Endpoint"},"external_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Endpoint"},"proxy_enabled":{"type":"boolean","title":"Proxy Enabled","default":false},"endpoint_available":{"type":"boolean","title":"Endpoint Available","default":false},"health_status":{"$ref":"#/components/schemas/ContainerHealthStatus"},"cache_info":{"$ref":"#/components/schemas/ContainerCacheInfo"},"container_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container Id"},"container_internal_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container Internal Url"}},"type":"object","title":"ContainerRegistryInfo","description":"Container registry information for MCP instances"},"ContentFilterRequest":{"properties":{"content":{"type":"string","minLength":1,"title":"Content","description":"Content to check for blocked keywords"}},"type":"object","required":["content"],"title":"ContentFilterRequest","description":"Schema for checking if content contains blocked keywords"},"ContentFilterResponse":{"properties":{"is_blocked":{"type":"boolean","title":"Is Blocked","description":"Whether content contains blocked keywords"},"reason":{"type":"string","title":"Reason","description":"Reason for blocking (if applicable)","default":""}},"type":"object","required":["is_blocked"],"title":"ContentFilterResponse","description":"Schema for content filter response","examples":[{"is_blocked":false,"reason":""},{"is_blocked":true,"reason":"Content contains blocked keyword"}]},"ContentFormat":{"type":"string","enum":["markdown","html","video","interactive","pdf"],"title":"ContentFormat","description":"Content format types"},"ContentGenerateResponse":{"properties":{"generation_id":{"type":"string","title":"Generation Id"},"content_type":{"type":"string","title":"Content Type"},"topic":{"type":"string","title":"Topic"},"site_id":{"type":"string","title":"Site Id"},"status":{"type":"string","title":"Status"},"language":{"type":"string","title":"Language"},"tone":{"type":"string","title":"Tone"},"word_count":{"type":"integer","title":"Word Count"},"created_at":{"type":"string","title":"Created At"},"estimated_completion":{"type":"string","title":"Estimated Completion"},"message":{"type":"string","title":"Message"}},"type":"object","required":["generation_id","content_type","topic","site_id","status","language","tone","word_count","created_at","estimated_completion","message"],"title":"ContentGenerateResponse","description":"Response for POST /wordpress-agent/content-generator/generate."},"ContentGeneratorAIModels":{"properties":{"primary":{"type":"string","title":"Primary"},"fallback":{"type":"string","title":"Fallback"},"specialized":{"type":"string","title":"Specialized"}},"type":"object","required":["primary","fallback","specialized"],"title":"ContentGeneratorAIModels"},"ContentGeneratorFeature":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"generated_today":{"type":"integer","title":"Generated Today"},"avg_quality_score":{"type":"number","title":"Avg Quality Score"}},"type":"object","required":["enabled","generated_today","avg_quality_score"],"title":"ContentGeneratorFeature"},"ContentGeneratorFeatures":{"properties":{"blog_posts":{"$ref":"#/components/schemas/ContentGeneratorFeature"},"product_descriptions":{"$ref":"#/components/schemas/ContentGeneratorFeature"},"meta_descriptions":{"$ref":"#/components/schemas/ContentGeneratorFeature"},"social_media_posts":{"$ref":"#/components/schemas/ContentGeneratorFeature"}},"type":"object","required":["blog_posts","product_descriptions","meta_descriptions","social_media_posts"],"title":"ContentGeneratorFeatures"},"ContentGeneratorStatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"features":{"$ref":"#/components/schemas/ContentGeneratorFeatures"},"content_types":{"items":{"type":"string"},"type":"array","title":"Content Types"},"languages_supported":{"items":{"type":"string"},"type":"array","title":"Languages Supported"},"ai_models":{"$ref":"#/components/schemas/ContentGeneratorAIModels"}},"type":"object","required":["status","features","content_types","languages_supported","ai_models"],"title":"ContentGeneratorStatusResponse","description":"Response for GET /wordpress-agent/content-generator."},"ContentInventory":{"properties":{"slot_type":{"$ref":"#/components/schemas/SlotType","description":"Type of ad slot (video_preroll, banner_sidebar, etc.)"},"format":{"$ref":"#/components/schemas/InventoryFormat","description":"Ad format (video, banner, native, audio)"},"total_slots":{"type":"integer","exclusiveMinimum":0,"title":"Total Slots","description":"Total number of slots available"},"floor_price":{"type":"string","title":"Floor Price","description":"Minimum price per slot (USD)"},"suggested_price":{"type":"string","title":"Suggested Price","description":"Suggested price per slot (USD)"},"id":{"type":"string","title":"Id","description":"Inventory UUID"},"event_id":{"type":"string","title":"Event Id","description":"Event UUID this inventory belongs to"},"filled_slots":{"type":"integer","minimum":0,"title":"Filled Slots","description":"Number of slots currently filled","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Inventory creation timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Inventory last update timestamp"},"available_slots":{"type":"integer","title":"Available Slots","description":"Calculate available slots (total - filled)","readOnly":true}},"type":"object","required":["slot_type","format","total_slots","floor_price","suggested_price","id","event_id","created_at","updated_at","available_slots"],"title":"ContentInventory","description":"Full content inventory schema with system fields"},"ContentInventoryCreate":{"properties":{"slot_type":{"$ref":"#/components/schemas/SlotType","description":"Type of ad slot (video_preroll, banner_sidebar, etc.)"},"format":{"$ref":"#/components/schemas/InventoryFormat","description":"Ad format (video, banner, native, audio)"},"total_slots":{"type":"integer","exclusiveMinimum":0,"title":"Total Slots","description":"Total number of slots available"},"floor_price":{"anyOf":[{"type":"number","minimum":0},{"type":"string"}],"title":"Floor Price","description":"Minimum price per slot (USD)"},"suggested_price":{"anyOf":[{"type":"number","minimum":0},{"type":"string"}],"title":"Suggested Price","description":"Suggested price per slot (USD)"}},"type":"object","required":["slot_type","format","total_slots","floor_price","suggested_price"],"title":"ContentInventoryCreate","description":"Schema for creating content inventory"},"ContextRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Search query for context synthesis"},"top_k":{"type":"integer","maximum":100,"minimum":1,"title":"Top K","description":"Number of top memories to use","default":10},"max_tokens":{"type":"integer","maximum":8000,"minimum":100,"title":"Max Tokens","description":"Max tokens for synthesized context","default":2000},"graph_weight":{"type":"number","maximum":1,"minimum":0,"title":"Graph Weight","description":"Graph vs vector weight blend","default":0.3},"query_expansion":{"type":"boolean","title":"Query Expansion","description":"Enable query expansion for broader recall","default":true},"rerank":{"type":"boolean","title":"Rerank","description":"Sort results by score before synthesis","default":true}},"type":"object","required":["query"],"title":"ContextRequest"},"ContextResponse":{"properties":{"context":{"type":"string","title":"Context"},"sources":{"items":{"$ref":"#/components/schemas/SourceItem"},"type":"array","title":"Sources"},"confidence":{"type":"number","title":"Confidence"},"token_count":{"type":"integer","title":"Token Count"},"query":{"type":"string","title":"Query"}},"type":"object","required":["context","sources","confidence","token_count","query"],"title":"ContextResponse"},"ContinuousEvalScheduleConfig":{"properties":{"template_id":{"type":"string","title":"Template Id"},"interval_hours":{"type":"integer","title":"Interval Hours"},"min_usage_threshold":{"type":"integer","title":"Min Usage Threshold"},"enabled":{"type":"boolean","title":"Enabled"},"created_by":{"type":"string","title":"Created By"},"created_at":{"type":"string","title":"Created At"},"next_run":{"type":"string","title":"Next Run"}},"type":"object","required":["template_id","interval_hours","min_usage_threshold","enabled","created_by","created_at","next_run"],"title":"ContinuousEvalScheduleConfig"},"ContinuousEvaluationResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"template_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Id"},"version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version Id"},"evaluation_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evaluation Results"},"usage_stats":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Usage Stats"},"recommendations":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Recommendations"},"evaluated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evaluated At"}},"additionalProperties":true,"type":"object","required":["status"],"title":"ContinuousEvaluationResponse"},"ContradictionItem":{"properties":{"old_edge_id":{"type":"string","title":"Old Edge Id"},"source_id":{"type":"string","title":"Source Id"},"old_target_id":{"type":"string","title":"Old Target Id"},"predicate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicate"},"old_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Old Confidence"},"old_valid_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Old Valid From"},"valid_until":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid Until"},"new_edge_id":{"type":"string","title":"New Edge Id"},"new_target_id":{"type":"string","title":"New Target Id"},"new_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"New Confidence"},"new_valid_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Valid From"},"source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Name"},"old_target_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Old Target Name"},"new_target_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Target Name"}},"type":"object","required":["old_edge_id","source_id","old_target_id","new_edge_id","new_target_id"],"title":"ContradictionItem","description":"A single entry in GET /memory/v2/graph/contradictions"},"ConversationStartedResponse":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["conversation_id","status","message","created_at"],"title":"ConversationStartedResponse"},"ConversationStatusResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"ConversationStatusResponse"},"ConversationSummary":{"properties":{"id":{"type":"string","title":"Id"},"inbox_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inbox Id"},"visitor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visitor Name"},"visitor_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visitor Email"},"status":{"type":"string","title":"Status"},"assigned_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Agent Id"},"last_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Message"},"message_count":{"type":"integer","title":"Message Count"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","status","message_count","created_at","updated_at"],"title":"ConversationSummary"},"ConversionEventRequest":{"properties":{"event_type":{"type":"string","title":"Event Type","description":"Type of event: page_view, form_submit, signup, etc."},"event_name":{"type":"string","title":"Event Name","description":"Human-readable event name"},"session_id":{"type":"string","title":"Session Id","description":"User session ID (from frontend)"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"utm_params":{"anyOf":[{"$ref":"#/components/schemas/UTMParams"},{"type":"null"}]},"referrer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referrer"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url"},"page_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Title"},"form_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Form Data"},"conversion_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Conversion Value"},"currency":{"type":"string","title":"Currency","default":"USD"},"ga_client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga Client Id"},"ga_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga Session Id"},"stripe_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Session Id"},"stripe_customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Customer Id"},"device_info":{"anyOf":[{"$ref":"#/components/schemas/DeviceInfo"},{"type":"null"}]},"fb_pixel_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fb Pixel Id"},"fb_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fb Event Id"},"google_ads_click_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Ads Click Id"},"linkedin_partner_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Partner Id"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["event_type","event_name","session_id"],"title":"ConversionEventRequest","description":"Request schema for tracking conversion events"},"ConversionsData":{"properties":{"date_range":{"$ref":"#/components/schemas/ConversionsDateRange"},"by_source":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"By Source"},"funnel":{"additionalProperties":true,"type":"object","title":"Funnel"}},"type":"object","required":["date_range","by_source","funnel"],"title":"ConversionsData"},"ConversionsDateRange":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"}},"type":"object","required":["start","end"],"title":"ConversionsDateRange"},"ConversionsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ConversionsData"}},"type":"object","required":["success","data"],"title":"ConversionsResponse","description":"Response for GET /conversions"},"CorporateAddress":{"properties":{"address_line1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line1"},"address_line2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line2"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},"type":"object","title":"CorporateAddress"},"CorsOriginCreate":{"properties":{"origin":{"type":"string","title":"Origin"}},"type":"object","required":["origin"],"title":"CorsOriginCreate"},"CorsOriginListResponse":{"properties":{"origins":{"items":{"$ref":"#/components/schemas/CorsOriginResponse"},"type":"array","title":"Origins"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["origins","count"],"title":"CorsOriginListResponse"},"CorsOriginResponse":{"properties":{"id":{"type":"string","title":"Id"},"project_id":{"type":"string","title":"Project Id"},"origin":{"type":"string","title":"Origin"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By"}},"type":"object","required":["id","project_id","origin"],"title":"CorsOriginResponse"},"CorsPreflightResponse":{"properties":{"allow":{"type":"string","title":"Allow"}},"type":"object","required":["allow"],"title":"CorsPreflightResponse","description":"Manual OPTIONS preflight ack (Kong Gateway CORS workaround)."},"CorsTestResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"origin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Origin"},"referer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referer"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"cors_headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Cors Headers"}},"type":"object","required":["success","message","cors_headers"],"title":"CorsTestResponse","description":"Response for GET /debug/cors-test."},"CostBreakdownItem":{"properties":{"resource_type":{"type":"string","title":"Resource Type"},"quantity":{"type":"number","title":"Quantity"},"unit":{"type":"string","title":"Unit"},"credits":{"type":"number","title":"Credits"}},"type":"object","required":["resource_type","quantity","unit","credits"],"title":"CostBreakdownItem","description":"Single resource type cost breakdown entry."},"CostDataResponse":{"properties":{"total_cost_usd":{"type":"number","title":"Total Cost Usd","description":"Total cost in USD"},"cost_by_provider":{"additionalProperties":{"type":"number"},"type":"object","title":"Cost By Provider","description":"Cost breakdown by provider"},"cost_by_agent":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Cost By Agent","description":"Cost per agent"},"cost_by_issue":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Cost By Issue","description":"Cost per issue"},"date_range":{"additionalProperties":{"type":"string"},"type":"object","title":"Date Range","description":"Date range for cost data"},"total_agents":{"type":"integer","title":"Total Agents","description":"Number of agents included"}},"type":"object","required":["total_cost_usd","cost_by_provider","cost_by_agent","cost_by_issue","date_range","total_agents"],"title":"CostDataResponse","description":"Cost tracking data"},"CostEstimateRequest":{"properties":{"agent_id":{"type":"string","maxLength":255,"minLength":1,"title":"Agent Id"},"estimated_tokens":{"type":"integer","minimum":0,"title":"Estimated Tokens","description":"Expected token count","default":0},"estimated_tool_calls":{"type":"integer","minimum":0,"title":"Estimated Tool Calls","description":"Expected tool invocations","default":0}},"type":"object","required":["agent_id"],"title":"CostEstimateRequest"},"CostNodeResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"task_id":{"type":"string","title":"Task Id"},"parent_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Task Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"resource_type":{"type":"string","title":"Resource Type"},"amount_credits":{"type":"number","title":"Amount Credits"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"depth":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Depth"}},"type":"object","required":["task_id","resource_type","amount_credits"],"title":"CostNodeResponse","description":"A single cost node returned from the DB"},"CostOptimization":{"properties":{"current_monthly_cost":{"type":"string","title":"Current Monthly Cost"},"optimized_monthly_cost":{"type":"string","title":"Optimized Monthly Cost"},"potential_savings":{"type":"string","title":"Potential Savings"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["current_monthly_cost","optimized_monthly_cost","potential_savings","recommendations"],"title":"CostOptimization"},"CostTotalResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"total_credits":{"type":"number","title":"Total Credits"},"node_count":{"type":"integer","title":"Node Count"}},"type":"object","required":["task_id","total_credits","node_count"],"title":"CostTotalResponse","description":"Response for GET /task-costs/{task_id}/total"},"CostTreeResponse":{"properties":{"root_task_id":{"type":"string","title":"Root Task Id"},"nodes":{"items":{"$ref":"#/components/schemas/CostNodeResponse"},"type":"array","title":"Nodes"},"total_credits":{"type":"number","title":"Total Credits"}},"type":"object","required":["root_task_id","nodes","total_credits"],"title":"CostTreeResponse","description":"Response for GET /task-costs/{task_id}/tree"},"CountRowsFilteredResponse":{"properties":{"count":{"type":"integer","title":"Count"},"table":{"type":"string","title":"Table"},"filter_summary":{"additionalProperties":true,"type":"object","title":"Filter Summary"}},"type":"object","required":["count","table","filter_summary"],"title":"CountRowsFilteredResponse"},"CountRowsResponse":{"properties":{"count":{"type":"integer","title":"Count"},"table":{"type":"string","title":"Table"}},"type":"object","required":["count","table"],"title":"CountRowsResponse"},"CountedEndpointRow":{"properties":{"endpoint":{"type":"string","title":"Endpoint"},"count":{"type":"integer","title":"Count"}},"additionalProperties":true,"type":"object","required":["endpoint","count"],"title":"CountedEndpointRow","description":"One attacked endpoint with its hit count."},"CountedUserAgentRow":{"properties":{"user_agent":{"type":"string","title":"User Agent"},"count":{"type":"integer","title":"Count"}},"additionalProperties":true,"type":"object","required":["user_agent","count"],"title":"CountedUserAgentRow","description":"One attacking user agent (truncated to 50 chars by the handler)."},"CpuMetrics":{"properties":{"usage_percent":{"type":"number","title":"Usage Percent"},"cores":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cores"},"frequency_mhz":{"type":"number","title":"Frequency Mhz"},"load_average":{"items":{"type":"number"},"type":"array","title":"Load Average"}},"type":"object","required":["usage_percent","frequency_mhz","load_average"],"title":"CpuMetrics"},"CrawlLogEntry":{"properties":{"id":{"type":"string","title":"Id"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name"},"path":{"type":"string","title":"Path"},"method":{"type":"string","title":"Method"},"response_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Status"},"response_time_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Time Ms"},"response_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Type"},"crawled_at":{"type":"string","format":"date-time","title":"Crawled At"}},"type":"object","required":["id","agent_name","path","method","response_status","response_time_ms","response_type","crawled_at"],"title":"CrawlLogEntry"},"CrawlLogsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CrawlLogEntry"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["items","total","page","page_size"],"title":"CrawlLogsResponse"},"CrawlRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Starting URL to crawl"},"max_pages":{"type":"integer","maximum":500,"minimum":1,"title":"Max Pages","description":"Max pages to crawl","default":10}},"type":"object","required":["url"],"title":"CrawlRequest"},"CrawlResultResponse":{"properties":{"crawl_id":{"type":"string","title":"Crawl Id"},"status":{"type":"string","title":"Status"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"pages_crawled":{"type":"integer","title":"Pages Crawled","default":0},"overall_score":{"type":"integer","title":"Overall Score","default":0},"dimension_averages":{"additionalProperties":{"type":"integer"},"type":"object","title":"Dimension Averages","default":{}},"crawl_time_ms":{"type":"integer","title":"Crawl Time Ms","default":0},"pages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Pages","default":[]},"errors":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Errors","default":[]}},"type":"object","required":["crawl_id","status"],"title":"CrawlResultResponse"},"CrawlStartResponse":{"properties":{"crawl_id":{"type":"string","title":"Crawl Id"},"status":{"type":"string","title":"Status"},"url":{"type":"string","title":"Url"},"max_pages":{"type":"integer","title":"Max Pages"}},"type":"object","required":["crawl_id","status","url","max_pages"],"title":"CrawlStartResponse"},"CreateABTestRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Test name"},"description":{"type":"string","title":"Description","description":"Test description"},"variants":{"items":{"$ref":"#/components/schemas/TestVariantRequest"},"type":"array","minItems":2,"title":"Variants","description":"Test variants (minimum 2)"},"test_type":{"type":"string","title":"Test Type","description":"Test type (binary, multivariate, sequential, paired)","default":"binary"},"target_metrics":{"items":{"type":"string"},"type":"array","title":"Target Metrics","description":"Target metrics to optimize"},"success_criteria":{"additionalProperties":true,"type":"object","title":"Success Criteria","description":"Success criteria definition"},"statistical_power":{"type":"number","maximum":0.99,"minimum":0.5,"title":"Statistical Power","description":"Statistical power (0.5-0.99)","default":0.8},"confidence_level":{"type":"number","maximum":0.999,"minimum":0.8,"title":"Confidence Level","description":"Confidence level (0.8-0.999)","default":0.95},"minimum_sample_size":{"type":"integer","minimum":10,"title":"Minimum Sample Size","description":"Minimum samples per variant","default":100},"maximum_duration_days":{"type":"integer","maximum":365,"minimum":1,"title":"Maximum Duration Days","description":"Maximum test duration in days","default":30},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id","description":"Team/organization ID"}},"type":"object","required":["name","description","variants"],"title":"CreateABTestRequest"},"CreateABTestResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"CreateABTestResponse","description":"Response for POST /ab-tests.\n\nReal shape is EnhancedPromptVersioningService.create_ab_test()'s own\nresult dict -- modeled as an open passthrough since that internal\nshape isn't owned by this router module."},"CreateAdRequest":{"properties":{"experiment_slug":{"type":"string","title":"Experiment Slug"},"experiment_name":{"type":"string","title":"Experiment Name"},"landing_url":{"type":"string","title":"Landing Url"},"campaign_id":{"type":"string","title":"Campaign Id","default":"23885054370"},"cpc_bid_micros":{"type":"integer","title":"Cpc Bid Micros","default":500000},"headlines":{"items":{},"type":"array","title":"Headlines","default":[]},"descriptions":{"items":{},"type":"array","title":"Descriptions","default":[]},"keywords":{"items":{},"type":"array","title":"Keywords","default":[]}},"type":"object","required":["experiment_slug","experiment_name","landing_url"],"title":"CreateAdRequest"},"CreateAdResponse":{"properties":{"ad_group_id":{"type":"string","title":"Ad Group Id","description":"Created ad group id"},"ad_group_name":{"type":"string","title":"Ad Group Name","description":"Ad group name (experiment name truncated to 60 chars)"},"keywords_added":{"type":"integer","title":"Keywords Added","description":"Number of keyword criteria created"},"landing_url":{"type":"string","title":"Landing Url","description":"Final URL the RSA points at"}},"type":"object","required":["ad_group_id","ad_group_name","keywords_added","landing_url"],"title":"CreateAdResponse","description":"Result of creating a Google Ads ad group + RSA + keywords (Refs #8449).\n\nAll four keys are unconditional on the 201 path — the handler returns one\nflat dict literal — so no `response_model_exclude_unset` is needed.\n\n`ad_group_id` is a `str`, NOT an `int`: it is parsed out of a Google Ads\nresource-name path, so typing it `int` would change the emitted JSON from\na string to a number for existing callers."},"CreateAgentSwarmProjectPublicResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_type":{"type":"string","title":"Project Type"},"description":{"type":"string","title":"Description"},"status":{"type":"string","title":"Status"},"agents_config":{"additionalProperties":{"$ref":"#/components/schemas/PublicAgentSwarmAgentConfigEntry"},"type":"object","title":"Agents Config"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"estimated_completion":{"type":"string","title":"Estimated Completion"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","project_type","description","status","agents_config","created_at","updated_at","estimated_completion","message"],"title":"CreateAgentSwarmProjectPublicResponse"},"CreateAgentSwarmProjectResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_type":{"type":"string","title":"Project Type"},"description":{"type":"string","title":"Description"},"status":{"type":"string","title":"Status"},"agents_config":{"additionalProperties":{"$ref":"#/components/schemas/AgentSwarmAgentConfigEntry"},"type":"object","title":"Agents Config"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"estimated_completion":{"type":"string","title":"Estimated Completion"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","project_type","description","status","agents_config","created_at","updated_at","estimated_completion","message"],"title":"CreateAgentSwarmProjectResponse"},"CreateAgentTablesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"tables_created":{"items":{"type":"string"},"type":"array","title":"Tables Created"},"executed_by":{"type":"string","title":"Executed By"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["success","message","tables_created","executed_by","timestamp"],"title":"CreateAgentTablesResponse","description":"Response for POST /admin/migrations/create-agent-tables."},"CreateAgentTaskResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"task_type":{"type":"string","title":"Task Type"},"status":{"type":"string","title":"Status"},"priority":{"type":"integer","title":"Priority"},"assigned_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Agent Id"},"created_at":{"type":"string","title":"Created At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","name","task_type","status","priority","created_at","message"],"title":"CreateAgentTaskResponse"},"CreateAlertRule":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name","description":"Alert rule name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Alert rule description"},"metric_type":{"type":"string","pattern":"^(notification_failure_rate|channel_downtime|rate_limit_approaching|slow_delivery|high_bounce_rate|custom)$","title":"Metric Type","description":"Metric type to monitor"},"condition":{"$ref":"#/components/schemas/AlertCondition","description":"Alert condition"},"severity":{"type":"string","pattern":"^(critical|warning|info)$","title":"Severity","description":"Alert severity","default":"warning"},"actions":{"items":{"$ref":"#/components/schemas/AlertAction"},"type":"array","minItems":1,"title":"Actions","description":"Actions to take when alert fires"},"enabled":{"type":"boolean","title":"Enabled","description":"Whether the alert rule is enabled","default":true},"cooldown_minutes":{"type":"integer","maximum":1440,"minimum":1,"title":"Cooldown Minutes","description":"Cooldown period in minutes","default":15}},"type":"object","required":["name","metric_type","condition","actions"],"title":"CreateAlertRule","description":"Schema for creating an alert rule","example":{"actions":[{"config":{"recipients":["admin@example.com"]},"type":"email"}],"condition":{"channel":"email","duration_minutes":5,"operator":"gt","threshold":10},"cooldown_minutes":15,"description":"Alert when email delivery failure rate exceeds 10% in 5 minutes","enabled":true,"metric_type":"notification_failure_rate","name":"High Email Failure Rate","severity":"warning"}},"CreateAlertRuleRequest":{"properties":{"rule_name":{"type":"string","title":"Rule Name","description":"Human-readable rule name"},"prompt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Id","description":"Prompt ID (null for global rule)"},"conditions":{"additionalProperties":true,"type":"object","title":"Conditions","description":"Alert conditions"},"alert_type":{"type":"string","title":"Alert Type","description":"Type of alert"},"severity":{"type":"string","title":"Severity","description":"Alert severity (info, low, medium, high, critical)"},"notification_channels":{"items":{"type":"string"},"type":"array","title":"Notification Channels","description":"Notification channels"},"cooldown_minutes":{"type":"integer","maximum":1440,"minimum":1,"title":"Cooldown Minutes","description":"Cooldown period in minutes","default":60}},"type":"object","required":["rule_name","conditions","alert_type","severity"],"title":"CreateAlertRuleRequest"},"CreateAlertRuleResponse":{"properties":{"rule_id":{"type":"string","title":"Rule Id"},"message":{"type":"string","title":"Message"},"rule_name":{"type":"string","title":"Rule Name"},"monitoring_metric":{"type":"string","title":"Monitoring Metric"}},"type":"object","required":["rule_id","message","rule_name","monitoring_metric"],"title":"CreateAlertRuleResponse","description":"Response for POST /alerts/rules (201 Created)."},"CreateAliasRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"alias":{"type":"string","format":"email","title":"Alias"}},"type":"object","required":["email","alias"],"title":"CreateAliasRequest"},"CreateApiKeyRequest":{"properties":{"name":{"type":"string","maxLength":255,"title":"Name","default":"claude-cli"}},"type":"object","title":"CreateApiKeyRequest","description":"Request body for POST /create_api_key."},"CreateApiKeyResponse":{"properties":{"api_key":{"type":"string","title":"Api Key"},"name":{"type":"string","title":"Name"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["api_key","name","created_at"],"title":"CreateApiKeyResponse","description":"Response for POST /create_api_key."},"CreateApprovalRequest":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id","description":"ID of the agent run to suspend"},"agent_id":{"type":"string","format":"uuid","title":"Agent Id","description":"ID of the agent requiring approval"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Decision context (tool, params, risk)"},"ttl_minutes":{"type":"integer","maximum":10080,"minimum":1,"title":"Ttl Minutes","description":"TTL in minutes before auto-expire (max 7 days)","default":30},"approver_ref":{"type":"string","maxLength":255,"title":"Approver Ref","description":"Approver reference (team: or user:)","default":"team:platform-ops"}},"type":"object","required":["run_id","agent_id"],"title":"CreateApprovalRequest"},"CreateApprovalResponse":{"properties":{"approval_id":{"type":"string","title":"Approval Id"},"status":{"type":"string","title":"Status"},"signal":{"type":"string","title":"Signal"},"ttl_at":{"type":"string","title":"Ttl At"}},"type":"object","required":["approval_id","status","signal","ttl_at"],"title":"CreateApprovalResponse"},"CreateAutoSnapshotResponse":{"properties":{"status":{"type":"string","title":"Status","description":"created | throttled | error"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Present only on the throttled branch"},"snapshot_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Snapshot Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"file_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Count"},"file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Path"},"file_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Hash"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"trigger_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger Type"}},"type":"object","required":["status"],"title":"CreateAutoSnapshotResponse","description":"Response for POST /snapshots/auto/create (SnapshotSystem.create_auto_snapshot).\n\nstatus can be \"created\", \"throttled\" (only \"message\" set), or \"error\"."},"CreateBackupResponse":{"properties":{"backup_id":{"type":"string","title":"Backup Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"estimated_duration_minutes":{"type":"integer","title":"Estimated Duration Minutes"}},"type":"object","required":["backup_id","status","message","estimated_duration_minutes"],"title":"CreateBackupResponse"},"CreateClientOrganizationRequest":{"properties":{"name":{"type":"string","minLength":1,"title":"Name","description":"The new client organization's name"},"initial_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Initial Contact Email","description":"Optional capture of the eventual client contact's email. Intent-only for this endpoint — no invite email is sent."}},"type":"object","required":["name"],"title":"CreateClientOrganizationRequest","description":"Body for admin-triggered client org creation."},"CreateClientOrganizationResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"tier":{"type":"string","title":"Tier"},"role":{"type":"string","title":"Role"}},"type":"object","required":["id","name","tier","role"],"title":"CreateClientOrganizationResponse"},"CreateDeploymentRequest":{"properties":{"name":{"type":"string","maxLength":64,"minLength":1,"title":"Name","description":"Deployment name"},"model_id":{"type":"string","title":"Model Id","description":"Model to deploy (e.g. 'meta/llama-3.1-70b')"},"gpu_type":{"type":"string","enum":["h100","mi300x","mi300x_8","mi325x","mi325x_8"],"title":"Gpu Type","description":"GPU type for this deployment"},"region":{"type":"string","enum":["atl1","nyc2","tor1","ric1"],"title":"Region","description":"Datacenter region"},"replicas":{"type":"integer","maximum":10,"minimum":1,"title":"Replicas","description":"Number of GPU replicas","default":1}},"type":"object","required":["name","model_id","gpu_type","region"],"title":"CreateDeploymentRequest"},"CreateDocumentationResponse":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"document":{"additionalProperties":true,"type":"object","title":"Document"}},"type":"object","required":["doc_id","status","message","document"],"title":"CreateDocumentationResponse","description":"Response for POST /help-documentation/content."},"CreateEdgeRequest":{"properties":{"source_name":{"type":"string","title":"Source Name","description":"Source entity name"},"target_name":{"type":"string","title":"Target Name","description":"Target entity name"},"predicate":{"type":"string","title":"Predicate","description":"Relationship type"},"confidence":{"type":"number","maximum":1,"minimum":0,"title":"Confidence","default":0.8},"properties":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Properties","description":"Edge properties"}},"type":"object","required":["source_name","target_name","predicate"],"title":"CreateEdgeRequest"},"CreateEdgeResponse":{"properties":{"id":{"type":"string","title":"Id"},"source_id":{"type":"string","title":"Source Id"},"target_id":{"type":"string","title":"Target Id"},"predicate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicate"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"contradictions":{"anyOf":[{"items":{"$ref":"#/components/schemas/EdgeContradiction"},"type":"array"},{"type":"null"}],"title":"Contradictions"}},"additionalProperties":true,"type":"object","required":["id","source_id","target_id"],"title":"CreateEdgeResponse","description":"Response for POST /memory/v2/graph/edge.\n\n``contradictions`` is present ONLY when this edge superseded an existing\none on the same (source, predicate) with a different target (Refs #1546).\nRequires ``response_model_exclude_unset=True`` on the route."},"CreateExperimentResponse":{"properties":{"experiment_id":{"type":"string","title":"Experiment Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"experiment_config":{"additionalProperties":true,"type":"object","title":"Experiment Config"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["experiment_id","status","message","experiment_config","created_at"],"title":"CreateExperimentResponse","description":"Response for POST /dashboard/experiments/create."},"CreateFolderRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Folder name (required, non-blank)"},"parent_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Folder Id"}},"type":"object","required":["name"],"title":"CreateFolderRequest"},"CreateInboxRequest":{"properties":{"name":{"type":"string","title":"Name","default":"Default"},"site_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Site Url"}},"type":"object","title":"CreateInboxRequest"},"CreateInboxResponse":{"properties":{"inbox_id":{"type":"string","title":"Inbox Id"},"token":{"type":"string","title":"Token"},"name":{"type":"string","title":"Name"},"site_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Site Url"},"widget_script":{"type":"string","title":"Widget Script"}},"type":"object","required":["inbox_id","token","name","widget_script"],"title":"CreateInboxResponse"},"CreateLearningTaskResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"task_type":{"type":"string","title":"Task Type"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","agent_id","task_type","status","created_at","message"],"title":"CreateLearningTaskResponse"},"CreateManualSnapshotResponse":{"properties":{"status":{"type":"string","title":"Status","description":"created | error"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"snapshot_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Snapshot Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"file_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Count"},"file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Path"},"file_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Hash"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"type":"object","required":["status"],"title":"CreateManualSnapshotResponse","description":"Response for POST /snapshots/manual (SnapshotSystem.create_manual_snapshot)."},"CreateNamespaceResponse":{"properties":{"name":{"type":"string","title":"Name"},"vector_count":{"type":"integer","title":"Vector Count"},"dimensions":{"type":"integer","title":"Dimensions"},"description":{"type":"string","title":"Description"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["name","vector_count","dimensions","description","created_at","updated_at"],"title":"CreateNamespaceResponse"},"CreateOAuthClientRequest":{"properties":{"agent_registration_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Registration Id","description":"UUID of an existing agent registration"},"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name","description":"App name (standalone create)"},"redirect_uris":{"items":{"type":"string"},"type":"array","title":"Redirect Uris","description":"OAuth redirect URIs"},"grant_types":{"items":{"type":"string"},"type":"array","title":"Grant Types","description":"OAuth grant types"},"scopes":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Scopes","description":"Requested OAuth scopes"},"token_ttl_seconds":{"type":"integer","maximum":86400,"minimum":60,"title":"Token Ttl Seconds","description":"Token TTL in seconds","default":3600}},"type":"object","required":["scopes"],"title":"CreateOAuthClientRequest","description":"Request to create an OAuth client.\n\nEither agent_registration_id (link to an existing agent) OR name (standalone\napp from the Cloud Auth UI — a minimal agent registration is auto-created).\nRefs #6091."},"CreateOAuthClientResponse":{"properties":{"id":{"type":"string","title":"Id"},"client_id":{"type":"string","title":"Client Id"},"client_secret":{"type":"string","title":"Client Secret"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"token_ttl_seconds":{"type":"integer","title":"Token Ttl Seconds"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","client_id","client_secret","scopes","token_ttl_seconds"],"title":"CreateOAuthClientResponse","description":"Response after creating an OAuth client. Secret is shown only once."},"CreateOnboardingFlowResponse":{"properties":{"flow_id":{"type":"string","title":"Flow Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"flow":{"additionalProperties":true,"type":"object","title":"Flow"}},"type":"object","required":["flow_id","status","message","flow"],"title":"CreateOnboardingFlowResponse","description":"Response for POST /onboarding-tutorials/flows."},"CreateOrderRequest":{"properties":{"product_ids":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Product Ids"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["product_ids"],"title":"CreateOrderRequest","description":"Body for creating an order from the Products modal's selection."},"CreateOrderResponse":{"properties":{"order":{"$ref":"#/components/schemas/Order"},"line_items":{"items":{"$ref":"#/components/schemas/OrderLineItem"},"type":"array","title":"Line Items"},"line_item_count":{"type":"integer","title":"Line Item Count"},"message":{"type":"string","title":"Message"}},"type":"object","required":["order","line_items","line_item_count","message"],"title":"CreateOrderResponse"},"CreateOrganizationResponse":{"properties":{"message":{"type":"string","title":"Message"},"organization":{"$ref":"#/components/schemas/CreatedOrganizationSummary"}},"type":"object","required":["message","organization"],"title":"CreateOrganizationResponse"},"CreatePolicyRequest":{"properties":{"workspace_id":{"type":"string","title":"Workspace Id"},"name":{"type":"string","maxLength":256,"minLength":1,"title":"Name"},"default_effect":{"type":"string","pattern":"^(allow|deny)$","title":"Default Effect","default":"allow"},"enforcement_mode":{"type":"string","pattern":"^(enforce|audit)$","title":"Enforcement Mode","default":"enforce"},"intent_classifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent Classifier"},"rules":{"items":{"$ref":"#/components/schemas/PolicyRuleSchema"},"type":"array","title":"Rules"}},"type":"object","required":["workspace_id","name"],"title":"CreatePolicyRequest"},"CreatePostgresBackupResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"backup":{"$ref":"#/components/schemas/PostgresBackupSummary"}},"type":"object","required":["success","backup"],"title":"CreatePostgresBackupResponse"},"CreateProjectRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Project name"},"description":{"type":"string","title":"Description","description":"Project description (PRD content)"},"project_type":{"type":"string","title":"Project Type","description":"Project type","default":"web_app"},"technologies":{"items":{"type":"string"},"type":"array","title":"Technologies","description":"Technologies"},"features":{"items":{"type":"string"},"type":"array","title":"Features","description":"Features"},"zerodb_project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zerodb Project Id","description":"ZeroDB project ID"}},"type":"object","required":["name","description"],"title":"CreateProjectRequest","description":"Request to create a new agent swarm project"},"CreateProjectResponse":{"properties":{"id":{"type":"string","title":"Id"},"project_id":{"type":"string","title":"Project Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","project_id","name","status","message"],"title":"CreateProjectResponse","description":"Response from project creation"},"CreatePromptRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Human-readable name for the prompt"},"description":{"type":"string","title":"Description","description":"Description of the prompt's purpose"},"category":{"type":"string","title":"Category","description":"Category (e.g., code_generation, analysis, chat)"},"use_case":{"type":"string","title":"Use Case","description":"Specific use case description"},"initial_content":{"type":"string","title":"Initial Content","description":"Initial prompt content"},"template_variables":{"items":{"type":"string"},"type":"array","title":"Template Variables","description":"Template variables"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id","description":"Team/organization ID"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"}},"type":"object","required":["name","description","category","use_case","initial_content"],"title":"CreatePromptRequest"},"CreatePromptResponse":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"message":{"type":"string","title":"Message"},"initial_version":{"type":"string","title":"Initial Version"},"status":{"type":"string","title":"Status"}},"type":"object","required":["prompt_id","message","initial_version","status"],"title":"CreatePromptResponse"},"CreatePublicABTestResponse":{"properties":{"test_id":{"type":"string","title":"Test Id"},"message":{"type":"string","title":"Message"},"variants_count":{"type":"integer","title":"Variants Count"},"status":{"type":"string","title":"Status"}},"additionalProperties":true,"type":"object","required":["test_id","message","variants_count","status"],"title":"CreatePublicABTestResponse","description":"Response for POST /ab-testing/tests.\n\nRefs #8449 -- this route previously declared `-> Dict[str, Any]` and\nso published an empty `{}` OpenAPI schema.\n\nDeliberately NOT named CreateABTestResponse: that name is already\ntaken by app/schemas/admin/prompt_management.py, and a duplicate\nclass name makes FastAPI fully-qualify BOTH schemas in the OpenAPI\nspec, renaming the pre-existing admin one as a side effect."},"CreateQualityAlertRuleResponse":{"properties":{"rule_id":{"type":"string","title":"Rule Id"},"rule_name":{"type":"string","title":"Rule Name"},"prompt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Id"},"alert_type":{"type":"string","title":"Alert Type"},"severity":{"type":"string","title":"Severity"},"created_by":{"type":"string","title":"Created By"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message"}},"type":"object","required":["rule_id","rule_name","alert_type","severity","created_by","timestamp","message"],"title":"CreateQualityAlertRuleResponse","description":"Response for POST /alert-rules."},"CreateRefRequest":{"properties":{"credential_id":{"type":"string","title":"Credential Id","description":"Vault credential ID to create ref for"},"agent_id":{"type":"string","maxLength":255,"minLength":1,"title":"Agent Id","description":"Agent that will use this ref"},"ttl_seconds":{"type":"integer","maximum":86400,"minimum":60,"title":"Ttl Seconds","description":"TTL in seconds (1 min to 24 hours)","default":3600},"max_uses":{"anyOf":[{"type":"integer","maximum":10000,"minimum":1},{"type":"null"}],"title":"Max Uses","description":"Max resolution count (None = unlimited)"}},"type":"object","required":["credential_id","agent_id"],"title":"CreateRefRequest","description":"Request body for POST /api/v1/cloud/credentials/refs."},"CreateReportRequest":{"properties":{"report_type":{"type":"string","title":"Report Type","description":"financial_reporting | investor_update | board_pack"},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe","description":"e.g. 'Mar 2026', 'Q1 2026'"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By"}},"type":"object","required":["report_type"],"title":"CreateReportRequest","description":"Body for the Reporting page's create-report dialog."},"CreateReportResponse":{"properties":{"report":{"$ref":"#/components/schemas/ReportRecord"},"message":{"type":"string","title":"Message"}},"type":"object","required":["report","message"],"title":"CreateReportResponse"},"CreateReviewRequest":{"properties":{"agent_id":{"type":"string","format":"uuid","title":"Agent Id","description":"ID of the agent requesting review"},"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title","description":"Short summary of what needs review"},"description":{"type":"string","maxLength":4000,"title":"Description","description":"Detailed explanation of the pending action","default":""},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context","description":"Arbitrary metadata about the pending action"}},"type":"object","required":["agent_id","title"],"title":"CreateReviewRequest"},"CreateReviewResponse":{"properties":{"review_id":{"type":"string","title":"Review Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["review_id","status"],"title":"CreateReviewResponse","description":"See AgentReviewService.create_review."},"CreateSecurityIncidentResponse":{"properties":{"message":{"type":"string","title":"Message"},"incident_id":{"type":"string","title":"Incident Id"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["message","incident_id","created_at"],"title":"CreateSecurityIncidentResponse"},"CreateTranscriptRequest":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"messages":{"items":{"$ref":"#/components/schemas/TranscriptMessage"},"type":"array","minItems":1,"title":"Messages"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"expires_in_days":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"title":"Expires In Days","default":30}},"type":"object","required":["messages"],"title":"CreateTranscriptRequest","description":"Request body for creating a shared transcript."},"CreateTranscriptResponse":{"properties":{"id":{"type":"string","title":"Id"},"share_url":{"type":"string","title":"Share Url"},"created_at":{"type":"string","title":"Created At"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["id","share_url","created_at","expires_at"],"title":"CreateTranscriptResponse","description":"Response after creating a shared transcript."},"CreateTrialCheckoutEmbeddedResponse":{"properties":{"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Secret","description":"Stripe embedded-checkout client secret."},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Stripe Checkout session ID."},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id","description":"Stripe customer ID."},"already_subscribed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Already Subscribed"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"redirect":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redirect"}},"additionalProperties":true,"type":"object","title":"CreateTrialCheckoutEmbeddedResponse","description":"POST /auth/create-trial-checkout-embedded — normal (new session) branch.\n\nSame duplicate-subscription short-circuit as the hosted-checkout sibling\n(Refs #6425); ``extra=\"allow\"`` covers both shapes."},"CreateTrialCheckoutResponse":{"properties":{"checkout_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkout Url","description":"Stripe-hosted Checkout URL to redirect the user to."},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Stripe Checkout session ID."},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id","description":"Stripe customer ID."},"already_subscribed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Already Subscribed"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"redirect":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redirect"}},"additionalProperties":true,"type":"object","title":"CreateTrialCheckoutResponse","description":"POST /auth/create-trial-checkout — normal (new session) branch.\n\nThe duplicate-subscription branch (``already_subscribed=True``) has a\ndifferent shape (see ``TrialCheckoutAlreadySubscribedResponse``); both\nare valid 200 bodies from this handler. ``extra=\"allow\"`` lets either\nshape pass through response_model filtering without losing fields."},"CreateTutorialResponse":{"properties":{"tutorial_id":{"type":"string","title":"Tutorial Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"tutorial":{"additionalProperties":true,"type":"object","title":"Tutorial"}},"type":"object","required":["tutorial_id","status","message","tutorial"],"title":"CreateTutorialResponse","description":"Response for POST /onboarding-tutorials/tutorials."},"CreateUserRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"first_name":{"type":"string","maxLength":100,"minLength":1,"title":"First Name"},"last_name":{"type":"string","maxLength":100,"minLength":1,"title":"Last Name"},"password":{"anyOf":[{"type":"string","maxLength":100,"minLength":8},{"type":"null"}],"title":"Password"},"change_at_next_login":{"type":"boolean","title":"Change At Next Login","default":true}},"type":"object","required":["email","first_name","last_name"],"title":"CreateUserRequest"},"CreateUserResponse":{"properties":{"message":{"type":"string","title":"Message"},"user":{"$ref":"#/components/schemas/CreatedUserSummary"}},"type":"object","required":["message","user"],"title":"CreateUserResponse"},"CreateVersionRequest":{"properties":{"content":{"type":"string","title":"Content","description":"New prompt content"},"version_type":{"type":"string","title":"Version Type","description":"Version increment type (major, minor, patch)","default":"minor"},"template_variables":{"items":{"type":"string"},"type":"array","title":"Template Variables","description":"Updated template variables"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Version metadata"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Tags for this version"},"auto_test":{"type":"boolean","title":"Auto Test","description":"Whether to automatically run tests","default":true}},"type":"object","required":["content"],"title":"CreateVersionRequest"},"CreateVersionResponse":{"properties":{"version_id":{"type":"string","title":"Version Id"},"prompt_id":{"type":"string","title":"Prompt Id"},"message":{"type":"string","title":"Message"},"auto_test_scheduled":{"type":"boolean","title":"Auto Test Scheduled"}},"type":"object","required":["version_id","prompt_id","message","auto_test_scheduled"],"title":"CreateVersionResponse"},"CreateViewRequest":{"properties":{"name":{"type":"string","title":"Name","description":"View name"},"is_default":{"type":"boolean","title":"Is Default","default":false},"layout_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Layout Json"},"filters_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters Json"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},"type":"object","required":["name"],"title":"CreateViewRequest","description":"Body matching smb-dash's ``CreateViewPayload``."},"CreateWalletRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Agent to create wallet for"},"spending_limit_usd":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Spending Limit Usd","description":"Period spending cap"},"single_payment_limit_usd":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Single Payment Limit Usd","description":"Per-payment cap"},"period":{"type":"string","title":"Period","description":"Budget period: day, week, month","default":"month"}},"type":"object","required":["agent_id"],"title":"CreateWalletRequest"},"CreateWalletResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"agent_id":{"type":"string","title":"Agent Id"},"balance_usd":{"type":"number","title":"Balance Usd"},"spending_limit_usd":{"type":"number","title":"Spending Limit Usd"},"single_payment_limit_usd":{"type":"number","title":"Single Payment Limit Usd"},"period":{"type":"string","title":"Period"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","user_id","agent_id","balance_usd","spending_limit_usd","single_payment_limit_usd","period","status"],"title":"CreateWalletResponse"},"CreatedOrganizationSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["id","name","is_active"],"title":"CreatedOrganizationSummary"},"CreatedUserSummary":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"username":{"type":"string","title":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"role":{"type":"string","title":"Role"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","email","username","role","is_active","created_at"],"title":"CreatedUserSummary"},"CreativeComparisonItem":{"properties":{"creative_id":{"type":"string","title":"Creative Id","description":"Creative UUID"},"creative_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Name","description":"Creative name"},"creative_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Type","description":"Creative type"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","default":0},"completions":{"type":"integer","minimum":0,"title":"Completions","default":0},"ctr":{"type":"number","maximum":1,"minimum":0,"title":"Ctr","default":0},"completion_rate":{"type":"number","maximum":1,"minimum":0,"title":"Completion Rate","default":0},"spend":{"type":"string","title":"Spend","default":0},"rank":{"type":"integer","minimum":0,"title":"Rank","description":"Rank by CTR (1 = best)","default":0}},"type":"object","required":["creative_id"],"title":"CreativeComparisonItem","description":"Single creative in comparison view"},"CreativeComparisonResponse":{"properties":{"creatives":{"items":{"$ref":"#/components/schemas/CreativeComparisonItem"},"type":"array","title":"Creatives","description":"Creatives ranked by CTR"},"best_performing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Best Performing","description":"Creative ID with highest CTR"},"total_creatives":{"type":"integer","minimum":0,"title":"Total Creatives","description":"Total creatives compared","default":0},"time_range":{"$ref":"#/components/schemas/TimeRange-Output","description":"Time range used"},"generated_at":{"type":"string","format":"date-time","title":"Generated At","description":"Report generation timestamp"}},"type":"object","required":["creatives","time_range","generated_at"],"title":"CreativeComparisonResponse","description":"Compare multiple creatives side-by-side\nIssue #580: Creative Performance Analytics"},"CreativeListResponse":{"properties":{"creatives":{"items":{"$ref":"#/components/schemas/VideoCreativeResponse"},"type":"array","title":"Creatives"},"total":{"type":"integer","title":"Total","description":"Total number of creatives"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["creatives","total","skip","limit"],"title":"CreativeListResponse","description":"Schema for paginated creative list","example":{"creatives":[],"limit":20,"skip":0,"total":42}},"CreativeMetrics":{"properties":{"creative_id":{"type":"string","title":"Creative Id","description":"Creative UUID"},"creative_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Name","description":"Creative name"},"creative_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Type","description":"Creative type (video, banner, etc)"},"sponsor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor Id","description":"Sponsor UUID"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","description":"Total impressions","default":0},"unique_impressions":{"type":"integer","minimum":0,"title":"Unique Impressions","description":"Unique user impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","description":"Total clicks","default":0},"completions":{"type":"integer","minimum":0,"title":"Completions","description":"Video completions","default":0},"ctr":{"type":"number","maximum":1,"minimum":0,"title":"Ctr","description":"Click-through rate","default":0},"completion_rate":{"type":"number","maximum":1,"minimum":0,"title":"Completion Rate","description":"Completion rate","default":0},"total_spend":{"type":"string","title":"Total Spend","description":"Total spend","default":0},"avg_cpm":{"type":"string","title":"Avg Cpm","description":"Average CPM","default":0},"avg_cpc":{"type":"string","title":"Avg Cpc","description":"Average CPC","default":0},"period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period Start","description":"Start of time period"},"period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period End","description":"End of time period"}},"type":"object","required":["creative_id"],"title":"CreativeMetrics","description":"Detailed creative performance metrics\nIssue #580: Creative Performance Analytics"},"CreativePerformance":{"properties":{"creative_id":{"type":"string","title":"Creative Id","description":"Creative UUID"},"creative_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Name","description":"Creative name"},"creative_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Type","description":"Creative type (video, banner, etc)"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","default":0},"completions":{"type":"integer","minimum":0,"title":"Completions","default":0},"ctr":{"type":"number","maximum":1,"minimum":0,"title":"Ctr","default":0},"completion_rate":{"type":"number","maximum":1,"minimum":0,"title":"Completion Rate","default":0},"spend":{"type":"string","title":"Spend","default":0}},"type":"object","required":["creative_id"],"title":"CreativePerformance","description":"Performance metrics breakdown by creative"},"CreativePerformanceResponse":{"properties":{"creative":{"$ref":"#/components/schemas/CreativeMetrics","description":"Overall creative metrics"},"daily_metrics":{"anyOf":[{"items":{"$ref":"#/components/schemas/DailyMetrics"},"type":"array"},{"type":"null"}],"title":"Daily Metrics","description":"Daily time series for performance over time"},"by_campaign":{"anyOf":[{"items":{"$ref":"#/components/schemas/CampaignBreakdown"},"type":"array"},{"type":"null"}],"title":"By Campaign","description":"Performance breakdown by campaign"},"time_range":{"$ref":"#/components/schemas/TimeRange-Output","description":"Time range used for metrics"},"generated_at":{"type":"string","format":"date-time","title":"Generated At","description":"Timestamp when report was generated"}},"type":"object","required":["creative","time_range","generated_at"],"title":"CreativePerformanceResponse","description":"Full creative performance response\nIssue #580: Creative Performance Analytics"},"CreativeReview":{"properties":{"status":{"$ref":"#/components/schemas/CreativeStatus","description":"New approval status"},"rejection_reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Rejection Reason","description":"Reason for rejection (required if rejected)"}},"type":"object","required":["status"],"title":"CreativeReview","description":"Schema for admin creative review","example":{"status":"approved"}},"CreativeStatus":{"type":"string","enum":["pending_review","approved","rejected","archived"],"title":"CreativeStatus","description":"Creative approval status"},"CreativeType":{"type":"string","enum":["video","banner","native"],"title":"CreativeType","description":"Ad creative types"},"CreativeUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":3},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"call_to_action":{"anyOf":[{"$ref":"#/components/schemas/CallToAction"},{"type":"null"}]},"destination_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Destination Url"}},"type":"object","title":"CreativeUpdate","description":"Schema for updating creative metadata","example":{"destination_url":"https://paipalooza.com/new-page","title":"Updated Title"}},"CredentialDeleteResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'deleted' on the 200 path"},"id":{"type":"string","title":"Id","description":"The credential that was soft-deleted"}},"type":"object","required":["status","id"],"title":"CredentialDeleteResponse","description":"Confirmation body for DELETE /api/v1/cloud/credentials/{id} (Refs #8449).\n\nBoth keys are unconditional on the 200 path — the handler returns one flat\ndict literal — so no `response_model_exclude_unset` is needed. Deliberately\ncarries NO credential value, masked or otherwise: a delete confirmation has\nno reason to echo secret material, and keeping the model this narrow means\na future handler change cannot start leaking one through this route."},"CredentialListItem":{"properties":{"id":{"type":"string","title":"Id"},"agent_registration_id":{"type":"string","title":"Agent Registration Id"},"domain":{"type":"string","title":"Domain"},"credential_type":{"type":"string","title":"Credential Type"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["id","agent_registration_id","domain","credential_type"],"title":"CredentialListItem","description":"A stored credential's non-secret metadata (Refs #6527).\n\nNever includes encrypted_data / credential_data — only metadata the UI shows."},"CredentialResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"credential_type":{"type":"string","title":"Credential Type"},"target_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Domain"},"agent_ids":{"items":{"type":"string"},"type":"array","title":"Agent Ids"},"masked_value":{"type":"string","title":"Masked Value","description":"e.g. sk-****abcd"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","name","credential_type","masked_value","created_at","updated_at"],"title":"CredentialResponse","description":"Credential metadata response (never exposes raw value)."},"CreditCurrentUsageData":{"properties":{"period_start":{"type":"string","title":"Period Start"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End"},"summary":{"$ref":"#/components/schemas/CreditUsageSummary"},"by_operation_type":{"items":{"$ref":"#/components/schemas/CreditUsageByType"},"type":"array","title":"By Operation Type"},"daily_usage":{"items":{"$ref":"#/components/schemas/CreditDailyUsage"},"type":"array","title":"Daily Usage"}},"type":"object","required":["period_start","summary","by_operation_type","daily_usage"],"title":"CreditCurrentUsageData"},"CreditCurrentUsageResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/CreditCurrentUsageData"}},"type":"object","required":["success","data"],"title":"CreditCurrentUsageResponse","description":"GET /credits/usage/current"},"CreditDailyUsage":{"properties":{"date":{"type":"string","title":"Date"},"request_count":{"type":"integer","title":"Request Count"},"credits_used":{"type":"number","title":"Credits Used"}},"type":"object","required":["date","request_count","credits_used"],"title":"CreditDailyUsage"},"CreditEstimateRequest":{"properties":{"model":{"type":"string","title":"Model","description":"Model to estimate for"},"estimated_tokens":{"type":"integer","minimum":1,"title":"Estimated Tokens","description":"Estimated total tokens"}},"type":"object","required":["model","estimated_tokens"],"title":"CreditEstimateRequest","description":"Request to estimate credit cost before execution"},"CreditEstimateResponse":{"properties":{"model":{"type":"string","title":"Model"},"estimated_tokens":{"type":"integer","title":"Estimated Tokens"},"estimated_credits":{"type":"number","title":"Estimated Credits"},"credits_available":{"type":"number","title":"Credits Available"},"can_afford":{"type":"boolean","title":"Can Afford"}},"type":"object","required":["model","estimated_tokens","estimated_credits","credits_available","can_afford"],"title":"CreditEstimateResponse","description":"Response with credit cost estimate"},"CreditGrantRequest":{"properties":{"user_email":{"type":"string","title":"User Email"},"amount":{"type":"number","title":"Amount"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":"Admin credit grant"}},"type":"object","required":["user_email","amount"],"title":"CreditGrantRequest"},"CreditGrantResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"$ref":"#/components/schemas/CreditGrantTransactionData"}},"type":"object","required":["success","message","data"],"title":"CreditGrantResponse","description":"Response for POST /admin/credits/grant."},"CreditGrantTransactionData":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"user_email":{"type":"string","title":"User Email"},"amount":{"type":"number","title":"Amount"},"transaction_type":{"type":"string","title":"Transaction Type"},"description":{"type":"string","title":"Description"},"created_at":{"type":"string","title":"Created At"},"new_balance":{"type":"number","title":"New Balance"}},"type":"object","required":["id","user_id","user_email","amount","transaction_type","description","created_at","new_balance"],"title":"CreditGrantTransactionData"},"CreditPackage":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"credits":{"type":"integer","title":"Credits"},"price":{"type":"number","title":"Price"},"currency":{"type":"string","title":"Currency"},"popular":{"type":"boolean","title":"Popular"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"features":{"items":{"type":"string"},"type":"array","title":"Features"}},"type":"object","required":["id","name","credits","price","currency","popular"],"title":"CreditPackage"},"CreditPackagesData":{"properties":{"packages":{"items":{"$ref":"#/components/schemas/CreditPackage"},"type":"array","title":"Packages"}},"type":"object","required":["packages"],"title":"CreditPackagesData"},"CreditPackagesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/CreditPackagesData"}},"type":"object","required":["success","data"],"title":"CreditPackagesResponse","description":"GET /credits/packages"},"CreditPaymentIntentResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["success","data"],"title":"CreditPaymentIntentResponse","description":"POST /credits/payment-intent — `data` is whatever\npayment_service.create_payment_intent_for_credits() returns (client_secret,\npayment_intent_id, amount, etc.), which varies by provider config, so it is\nkept as a permissive mapping rather than guessed field-by-field."},"CreditTransactionsData":{"properties":{"transactions":{"items":{"$ref":"#/components/schemas/app__schemas__public_api_batch3__CreditTransactionItem"},"type":"array","title":"Transactions"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["transactions","total","skip","limit","has_more"],"title":"CreditTransactionsData"},"CreditTransactionsListData":{"properties":{"transactions":{"items":{"$ref":"#/components/schemas/app__schemas__admin__credits__CreditTransactionItem"},"type":"array","title":"Transactions"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["transactions","total","skip","limit","has_more"],"title":"CreditTransactionsListData"},"CreditUsageByType":{"properties":{"operation_type":{"type":"string","title":"Operation Type"},"request_count":{"type":"integer","title":"Request Count"},"credits_used":{"type":"number","title":"Credits Used"}},"type":"object","required":["operation_type","request_count","credits_used"],"title":"CreditUsageByType"},"CreditUsageSummary":{"properties":{"total_requests":{"type":"integer","title":"Total Requests"},"total_credits_used":{"type":"number","title":"Total Credits Used"},"total_tokens_processed":{"type":"integer","title":"Total Tokens Processed"},"unique_sessions":{"type":"integer","title":"Unique Sessions"},"active_days":{"type":"integer","title":"Active Days"}},"type":"object","required":["total_requests","total_credits_used","total_tokens_processed","unique_sessions","active_days"],"title":"CreditUsageSummary"},"CreditsAddedResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"credits_added":{"type":"number","title":"Credits Added"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"timestamp":{"type":"string","title":"Timestamp"},"new_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"New Balance"}},"additionalProperties":true,"type":"object","required":["user_id","credits_added","timestamp"],"title":"CreditsAddedResponse","description":"Confirmation echoed by POST /credits/add.\n\n`timestamp` is a `str`, not a `datetime`: the handler calls .isoformat()\nitself, so declaring a datetime here would re-serialize an already\nformatted value and could change the exact bytes clients parse today.\n\n`new_balance` was added with the #8832 fix so an admin can confirm the\ngrant actually landed in the ledger. It is Optional because `-1` is the\n\"unlimited\" sentinel and a balance recompute is best-effort."},"CreditsBalanceResponse":{"properties":{"total_credits":{"type":"integer","title":"Total Credits"},"used_credits":{"type":"number","title":"Used Credits"},"remaining_credits":{"type":"number","title":"Remaining Credits"},"unlimited":{"type":"boolean","title":"Unlimited"},"plan":{"type":"string","title":"Plan"},"period_start":{"type":"string","title":"Period Start"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End"},"usage_percentage":{"type":"number","title":"Usage Percentage"}},"type":"object","required":["total_credits","used_credits","remaining_credits","unlimited","plan","period_start","usage_percentage"],"title":"CreditsBalanceResponse","description":"GET /credits/balance — returned as a bare object, NOT wrapped in a\nsuccess/data envelope (unlike its sibling credits endpoints)."},"CriticalServicesHealth":{"properties":{"api_server":{"type":"string","title":"Api Server"},"database":{"type":"string","title":"Database"},"redis":{"type":"string","title":"Redis"},"file_system":{"type":"string","title":"File System"}},"type":"object","required":["api_server","database","redis","file_system"],"title":"CriticalServicesHealth"},"CrossProjectReferenceRequest":{"properties":{"reference":{"type":"string","title":"Reference","description":"Reference to resolve across projects"},"source_project_id":{"type":"string","title":"Source Project Id","description":"ID of the source project"}},"type":"object","required":["reference","source_project_id"],"title":"CrossProjectReferenceRequest"},"CrossProjectSearchRequest":{"properties":{"content":{"type":"string","title":"Content","description":"Code content to find similarities for"},"source_project_id":{"type":"string","title":"Source Project Id","description":"ID of the source project"},"limit":{"type":"integer","title":"Limit","description":"Maximum number of results to return","default":10}},"type":"object","required":["content","source_project_id"],"title":"CrossProjectSearchRequest"},"CrossReferenceSummary":{"properties":{"reference":{"type":"string","title":"Reference"},"resolved_count":{"type":"integer","title":"Resolved Count"},"last_resolved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Resolved At"}},"type":"object","required":["reference","resolved_count"],"title":"CrossReferenceSummary"},"CurrentDeploymentSummary":{"properties":{"deployment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deployment Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"environment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","title":"CurrentDeploymentSummary","description":"Nested ``current_deployment`` block within the deployment-status response."},"CurrentMetricsResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"cpu_percent":{"type":"number","title":"Cpu Percent"},"memory_percent":{"type":"number","title":"Memory Percent"},"memory_available_mb":{"type":"number","title":"Memory Available Mb"},"disk_usage_percent":{"type":"number","title":"Disk Usage Percent"},"network_io":{"additionalProperties":{"type":"integer"},"type":"object","title":"Network Io"},"active_connections":{"type":"integer","title":"Active Connections"},"load_average":{"type":"number","title":"Load Average"},"process_count":{"type":"integer","title":"Process Count"},"health_status":{"type":"string","title":"Health Status"}},"type":"object","required":["timestamp","cpu_percent","memory_percent","memory_available_mb","disk_usage_percent","network_io","active_connections","load_average","process_count","health_status"],"title":"CurrentMetricsResponse","description":"Latest system performance snapshot."},"CurrentPerformanceMetrics":{"properties":{"system":{"$ref":"#/components/schemas/app__schemas__admin__monitoring_alerts__SystemMetrics"},"application":{"$ref":"#/components/schemas/ApplicationMetrics"},"database":{"$ref":"#/components/schemas/DatabaseMetrics"},"network":{"$ref":"#/components/schemas/app__schemas__admin__monitoring_alerts__NetworkMetrics"}},"type":"object","required":["system","application","database","network"],"title":"CurrentPerformanceMetrics","description":"Two real shapes: happy path (full detail) and exception fallback\n(each sub-object only has a subset of keys, defaulted to 0)."},"CurrentStats":{"properties":{"follower_count":{"type":"integer","minimum":0,"title":"Follower Count"},"total_stream_hours":{"type":"integer","minimum":0,"title":"Total Stream Hours"},"average_viewers":{"type":"number","minimum":0,"title":"Average Viewers"},"peak_viewers":{"type":"integer","minimum":0,"title":"Peak Viewers"}},"type":"object","required":["follower_count","total_stream_hours","average_viewers","peak_viewers"],"title":"CurrentStats","description":"Current streamer statistics","example":{"average_viewers":23.5,"follower_count":750,"peak_viewers":87,"total_stream_hours":45}},"CurrentUsageResponse":{"properties":{"period":{"type":"string","title":"Period","description":"Period queried (monthly, weekly, daily)"},"credits_used":{"type":"number","title":"Credits Used","description":"Credits consumed in period"},"credits_remaining":{"type":"number","title":"Credits Remaining","description":"Credits remaining (-1 for unlimited)"},"requests_count":{"type":"integer","title":"Requests Count","description":"Number of requests made"},"total_tokens":{"type":"integer","title":"Total Tokens","description":"Total tokens used"},"models_used":{"additionalProperties":{"type":"integer"},"type":"object","title":"Models Used","description":"Model distribution (model -> request count)"}},"type":"object","required":["period","credits_used","credits_remaining","requests_count","total_tokens","models_used"],"title":"CurrentUsageResponse","description":"Current usage statistics response","example":{"credits_remaining":650,"credits_used":350,"models_used":{"llama-3.3-70b-instruct":100,"llama-3.3-8b-instruct":45},"period":"monthly","requests_count":145,"total_tokens":125000}},"CustomerCloudSpendResponse":{"properties":{"customer_id":{"type":"string","title":"Customer Id"},"period":{"type":"string","title":"Period"},"total_credits":{"type":"number","title":"Total Credits"},"by_agent":{"items":{"$ref":"#/components/schemas/AgentSpendEntry"},"type":"array","title":"By Agent"}},"type":"object","required":["customer_id","period","total_credits","by_agent"],"title":"CustomerCloudSpendResponse","description":"Customer-level cloud spend across ALL of their agents. Refs #9320.\n\nAgentCloudBillingService.get_customer_cloud_spend() was fully\nimplemented and tested but had no HTTP endpoint — the only reachable\ncost reporting was per-agent (GET .../costs/{agent_id}). This is the\ncustomer-level equivalent: total spend across every agent the\nauthenticated customer owns."},"DailyAggregationResponse":{"properties":{"date":{"type":"string","title":"Date","description":"Date that was aggregated (YYYY-MM-DD)"},"videos_processed":{"type":"integer","title":"Videos Processed","description":"Number of videos aggregated"},"retention_curves_calculated":{"type":"integer","title":"Retention Curves Calculated","description":"Number of retention curves successfully calculated"},"duration_seconds":{"type":"number","title":"Duration Seconds","description":"Wall-clock duration of the run"},"started_at":{"type":"string","title":"Started At","description":"ISO-8601 start timestamp"},"completed_at":{"type":"string","title":"Completed At","description":"ISO-8601 completion timestamp"}},"type":"object","required":["date","videos_processed","retention_curves_calculated","duration_seconds","started_at","completed_at"],"title":"DailyAggregationResponse","description":"Summary returned by a manual daily-aggregation run.\n\nMirrors the literal built by\n``app.utils.analytics_aggregator.AnalyticsAggregator.run_daily_aggregation``,\nwhich is returned to the caller unchanged. ``date``, ``started_at`` and\n``completed_at`` are already stringified by that helper (``str(date)`` /\n``.isoformat()``), so they are typed ``str`` here rather than date/datetime\nto keep the serialized payload byte-for-byte identical."},"DailyBackupSchedule":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"time":{"type":"string","title":"Time"},"last_run":{"type":"string","title":"Last Run"}},"type":"object","required":["enabled","time","last_run"],"title":"DailyBackupSchedule"},"DailyEarningsPoint":{"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"total_cents":{"type":"integer","title":"Total Cents"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["total_cents","count"],"title":"DailyEarningsPoint","description":"One day of x402 revenue for charting."},"DailyMetric":{"properties":{"date":{"type":"string","title":"Date"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["date","count"],"title":"DailyMetric"},"DailyMetrics":{"properties":{"date":{"type":"string","format":"date","title":"Date","description":"Date for metrics"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","default":0},"completions":{"type":"integer","minimum":0,"title":"Completions","default":0},"ctr":{"type":"number","maximum":1,"minimum":0,"title":"Ctr","default":0},"spend":{"type":"string","title":"Spend","default":0}},"type":"object","required":["date"],"title":"DailyMetrics","description":"Daily metrics for time series data"},"DailyRevenue":{"properties":{"report_date":{"type":"string","format":"date","title":"Report Date","description":"Date"},"total_revenue":{"type":"string","title":"Total Revenue","description":"Total revenue","default":"0.00"},"platform_share":{"type":"string","title":"Platform Share","description":"Platform share","default":"0.00"},"organizer_share":{"type":"string","title":"Organizer Share","description":"Organizer share","default":"0.00"},"impressions":{"type":"integer","title":"Impressions","description":"Total impressions","default":0},"clicks":{"type":"integer","title":"Clicks","description":"Total clicks","default":0}},"type":"object","required":["report_date"],"title":"DailyRevenue","description":"Revenue breakdown by day"},"DailyStorageEntry":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"zerodb_rows_bytes":{"type":"integer","title":"Zerodb Rows Bytes"},"zerodb_files_bytes":{"type":"integer","title":"Zerodb Files Bytes"},"lakehouse_bytes":{"type":"integer","title":"Lakehouse Bytes"},"total_bytes":{"type":"integer","title":"Total Bytes"},"total_gb":{"type":"number","title":"Total Gb","description":"Total storage in GB"}},"type":"object","required":["date","zerodb_rows_bytes","zerodb_files_bytes","lakehouse_bytes","total_bytes","total_gb"],"title":"DailyStorageEntry"},"DailyTrendItem":{"properties":{"date":{"type":"string","title":"Date"},"cost_usd":{"type":"number","title":"Cost Usd"}},"type":"object","required":["date","cost_usd"],"title":"DailyTrendItem"},"DailyUsage":{"properties":{"date":{"type":"string","title":"Date","description":"Date in ISO format (YYYY-MM-DD)"},"credits":{"type":"number","title":"Credits","description":"Credits consumed on this date"}},"type":"object","required":["date","credits"],"title":"DailyUsage","description":"Daily credit usage","example":{"credits":1500.5,"date":"2025-12-15"}},"DailyUsageItem":{"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"request_count":{"type":"integer","title":"Request Count"},"total_tokens":{"type":"integer","title":"Total Tokens"},"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"api_credits":{"type":"number","title":"Api Credits"}},"type":"object","required":["request_count","total_tokens","prompt_tokens","completion_tokens","api_credits"],"title":"DailyUsageItem"},"DailyUsageResponse":{"properties":{"daily":{"items":{"$ref":"#/components/schemas/DailyUsageItem"},"type":"array","title":"Daily"},"total_days":{"type":"integer","title":"Total Days"},"period":{"type":"string","title":"Period"}},"type":"object","required":["daily","total_days","period"],"title":"DailyUsageResponse"},"DashboardAction":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["id","name","description","category","enabled"],"title":"DashboardAction"},"DashboardActionsResponse":{"properties":{"actions":{"items":{"$ref":"#/components/schemas/DashboardAction"},"type":"array","title":"Actions"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["actions","total"],"title":"DashboardActionsResponse"},"DashboardAgentPerformance":{"properties":{"architect":{"$ref":"#/components/schemas/AgentPerformanceSummary"},"frontend":{"$ref":"#/components/schemas/AgentPerformanceSummary"},"backend":{"$ref":"#/components/schemas/AgentPerformanceSummary"},"security":{"$ref":"#/components/schemas/AgentPerformanceSummary"},"qa":{"$ref":"#/components/schemas/AgentPerformanceSummary"},"devops":{"$ref":"#/components/schemas/AgentPerformanceSummary"}},"type":"object","required":["architect","frontend","backend","security","qa","devops"],"title":"DashboardAgentPerformance"},"DashboardAgentSwarmResponse":{"properties":{"total_agents":{"type":"integer","title":"Total Agents"},"active_agents":{"type":"integer","title":"Active Agents"},"completed_tasks":{"type":"integer","title":"Completed Tasks"},"pending_tasks":{"type":"integer","title":"Pending Tasks"},"failed_tasks":{"type":"integer","title":"Failed Tasks"},"average_task_duration_seconds":{"type":"number","title":"Average Task Duration Seconds"},"agents":{"items":{"$ref":"#/components/schemas/AgentSwarmAgent"},"type":"array","title":"Agents"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["total_agents","active_agents","completed_tasks","pending_tasks","failed_tasks","average_task_duration_seconds","agents","updated_at"],"title":"DashboardAgentSwarmResponse"},"DashboardAikitResponse":{"properties":{"total_models":{"type":"integer","title":"Total Models"},"active_models":{"type":"integer","title":"Active Models"},"total_requests":{"type":"integer","title":"Total Requests"},"requests_today":{"type":"integer","title":"Requests Today"},"average_latency_ms":{"type":"number","title":"Average Latency Ms"},"error_rate":{"type":"number","title":"Error Rate"},"top_models":{"items":{"$ref":"#/components/schemas/AikitTopModel"},"type":"array","title":"Top Models"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["total_models","active_models","total_requests","requests_today","average_latency_ms","error_rate","top_models","updated_at"],"title":"DashboardAikitResponse"},"DashboardApiUsageMetrics":{"properties":{"total_requests":{"type":"integer","title":"Total Requests"},"requests_today":{"type":"integer","title":"Requests Today"},"average_response_time_ms":{"type":"number","title":"Average Response Time Ms"}},"type":"object","required":["total_requests","requests_today","average_response_time_ms"],"title":"DashboardApiUsageMetrics"},"DashboardBillingResponse":{"properties":{"current_plan":{"type":"string","title":"Current Plan"},"billing_cycle_start":{"type":"string","title":"Billing Cycle Start"},"billing_cycle_end":{"type":"string","title":"Billing Cycle End"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"credits_limit":{"type":"integer","title":"Credits Limit"},"credits_used":{"type":"integer","title":"Credits Used"},"estimated_cost_usd":{"type":"integer","title":"Estimated Cost Usd"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method"},"next_billing_date":{"type":"string","title":"Next Billing Date"},"usage_breakdown":{"items":{"$ref":"#/components/schemas/BillingUsageBreakdownEntry"},"type":"array","title":"Usage Breakdown"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["current_plan","billing_cycle_start","billing_cycle_end","credits_remaining","credits_limit","credits_used","estimated_cost_usd","next_billing_date","usage_breakdown","updated_at"],"title":"DashboardBillingResponse"},"DashboardLearningMetrics":{"properties":{"total_evaluations":{"type":"integer","title":"Total Evaluations"},"improvement_rate":{"type":"number","title":"Improvement Rate"},"active_ab_tests":{"items":{"$ref":"#/components/schemas/ABTestSummary"},"type":"array","title":"Active Ab Tests"},"statistical_significance":{"type":"boolean","title":"Statistical Significance"},"deployment_success_rate":{"type":"number","title":"Deployment Success Rate"}},"type":"object","required":["total_evaluations","improvement_rate","active_ab_tests","statistical_significance","deployment_success_rate"],"title":"DashboardLearningMetrics"},"DashboardOverview":{"properties":{"current_stream":{"anyOf":[{"$ref":"#/components/schemas/StreamResponse"},{"type":"null"}],"description":"Current active stream if exists"},"today_stats":{"$ref":"#/components/schemas/TodayStats"},"recent_streams":{"items":{"$ref":"#/components/schemas/RecentStreamSummary"},"type":"array","title":"Recent Streams"},"pending_vods_count":{"type":"integer","minimum":0,"title":"Pending Vods Count","description":"Number of pending VODs to review"},"upcoming_schedules_count":{"type":"integer","minimum":0,"title":"Upcoming Schedules Count","description":"Number of upcoming scheduled streams"},"notifications_count":{"type":"integer","minimum":0,"title":"Notifications Count","description":"Unread notifications count"},"follower_count":{"type":"integer","minimum":0,"title":"Follower Count","description":"Total follower count"},"updated_at":{"type":"string","title":"Updated At","description":"ISO 8601 timestamp of data update"}},"type":"object","required":["today_stats","recent_streams","pending_vods_count","upcoming_schedules_count","notifications_count","follower_count","updated_at"],"title":"DashboardOverview","description":"Main dashboard overview response","example":{"current_stream":{"id":"987e6543-e21b-12d3-a456-426614174000","status":"live","title":"Live Coding Session","viewer_count":42},"follower_count":1250,"notifications_count":7,"pending_vods_count":3,"recent_streams":[],"today_stats":{"chat_messages":234,"new_followers":5,"viewers":42},"upcoming_schedules_count":2,"updated_at":"2025-12-23T14:30:00Z"}},"DashboardProjectMetrics":{"properties":{"total":{"type":"integer","title":"Total"},"created_this_week":{"type":"integer","title":"Created This Week"}},"type":"object","required":["total","created_this_week"],"title":"DashboardProjectMetrics"},"DashboardQnnResponse":{"properties":{"total_circuits":{"type":"integer","title":"Total Circuits"},"active_circuits":{"type":"integer","title":"Active Circuits"},"completed_jobs":{"type":"integer","title":"Completed Jobs"},"pending_jobs":{"type":"integer","title":"Pending Jobs"},"failed_jobs":{"type":"integer","title":"Failed Jobs"},"total_qubits_used":{"type":"integer","title":"Total Qubits Used"},"average_execution_time_seconds":{"type":"number","title":"Average Execution Time Seconds"},"circuits":{"items":{"$ref":"#/components/schemas/QnnCircuitInfo"},"type":"array","title":"Circuits"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["total_circuits","active_circuits","completed_jobs","pending_jobs","failed_jobs","total_qubits_used","average_execution_time_seconds","circuits","updated_at"],"title":"DashboardQnnResponse"},"DashboardQualityInsights":{"properties":{"overall_quality_score":{"type":"number","title":"Overall Quality Score"},"trend":{"type":"string","title":"Trend"},"improvement_opportunities":{"items":{"type":"string"},"type":"array","title":"Improvement Opportunities"},"success_patterns":{"items":{"type":"string"},"type":"array","title":"Success Patterns"}},"type":"object","required":["overall_quality_score","trend","improvement_opportunities","success_patterns"],"title":"DashboardQualityInsights"},"DashboardRequest":{"properties":{"time_window":{"type":"string","title":"Time Window","description":"Time window (1h, 1d, 7d, 30d, 90d, 365d)","default":"1d"},"prompt_ids":{"items":{"type":"string"},"type":"array","title":"Prompt Ids","description":"Filter by specific prompt IDs"},"metric_types":{"items":{"type":"string"},"type":"array","title":"Metric Types","description":"Filter by metric types"}},"type":"object","title":"DashboardRequest"},"DashboardRevenueMetrics":{"properties":{"mrr":{"type":"number","title":"Mrr"},"total_this_month":{"type":"number","title":"Total This Month"},"growth_percentage":{"type":"number","title":"Growth Percentage"}},"type":"object","required":["mrr","total_this_month","growth_percentage"],"title":"DashboardRevenueMetrics"},"DashboardStatistics":{"properties":{"total_templates":{"type":"integer","title":"Total Templates"},"by_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Type"},"by_complexity":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Complexity"},"recent_templates":{"items":{"$ref":"#/components/schemas/TemplateListEntry"},"type":"array","title":"Recent Templates"}},"type":"object","required":["total_templates","by_type","by_complexity","recent_templates"],"title":"DashboardStatistics"},"DashboardSystemStatus":{"properties":{"promptfoo_evaluations":{"$ref":"#/components/schemas/SystemStatusItem"},"qa_agent_status":{"$ref":"#/components/schemas/SystemStatusItem"},"quality_engine_health":{"$ref":"#/components/schemas/SystemStatusItem"},"feedback_system_active":{"$ref":"#/components/schemas/SystemStatusItem"},"optimization_status":{"$ref":"#/components/schemas/SystemStatusItem"},"agent_integration":{"$ref":"#/components/schemas/SystemStatusItem"}},"type":"object","required":["promptfoo_evaluations","qa_agent_status","quality_engine_health","feedback_system_active","optimization_status","agent_integration"],"title":"DashboardSystemStatus"},"DashboardUserMetrics":{"properties":{"total":{"type":"integer","title":"Total"},"active_today":{"type":"integer","title":"Active Today"},"new_this_week":{"type":"integer","title":"New This Week"}},"type":"object","required":["total","active_today","new_this_week"],"title":"DashboardUserMetrics"},"DashboardZeroDbResponse":{"properties":{"total_databases":{"type":"integer","title":"Total Databases"},"total_tables":{"type":"integer","title":"Total Tables"},"total_records":{"type":"integer","title":"Total Records"},"storage_used_mb":{"type":"number","title":"Storage Used Mb"},"queries_today":{"type":"integer","title":"Queries Today"},"average_query_time_ms":{"type":"number","title":"Average Query Time Ms"},"databases":{"items":{"$ref":"#/components/schemas/ZeroDbDatabaseInfo"},"type":"array","title":"Databases"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["total_databases","total_tables","total_records","storage_used_mb","queries_today","average_query_time_ms","databases","updated_at"],"title":"DashboardZeroDbResponse"},"DataClassificationDetail":{"properties":{"level":{"type":"string","title":"Level"},"compartments":{"items":{"type":"string"},"type":"array","title":"Compartments"},"handling_instructions":{"title":"Handling Instructions"},"retention_period_days":{"title":"Retention Period Days"},"encryption_required":{"type":"boolean","title":"Encryption Required"},"access_restrictions":{"title":"Access Restrictions"}},"type":"object","required":["level","compartments","handling_instructions","retention_period_days","encryption_required","access_restrictions"],"title":"DataClassificationDetail"},"DataClassificationRequest":{"properties":{"data":{"type":"string","title":"Data","description":"Data to classify"},"user_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Classification","description":"User-suggested classification"},"compartments":{"items":{"type":"string"},"type":"array","title":"Compartments","description":"Data compartments"}},"type":"object","required":["data"],"title":"DataClassificationRequest","description":"Request to classify data"},"DataExportResponse":{"properties":{"profile":{"additionalProperties":true,"type":"object","title":"Profile"},"api_keys":{"items":{},"type":"array","title":"Api Keys"},"projects":{"items":{},"type":"array","title":"Projects"},"usage_summary":{"additionalProperties":true,"type":"object","title":"Usage Summary"},"exported_at":{"type":"string","title":"Exported At"}},"type":"object","required":["profile","api_keys","projects","usage_summary","exported_at"],"title":"DataExportResponse","description":"Response schema for data export -- matches GDPRService.export_user_data()'s dict exactly."},"DataForSEOEnrichmentPayload":{"properties":{"domain":{"type":"string","title":"Domain","description":"The exact domain this enrichment measured — the report's own scanned domain."},"status":{"type":"string","title":"Status","description":"\"ready\" when at least one piece succeeded, \"failed\" when none did."},"authority_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authority Rank","description":"DataForSEO backlinks rank (0-1000)."},"authority_spam_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authority Spam Score","description":"DataForSEO backlinks spam score (0-100, percent)."},"authority_referring_domains":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authority Referring Domains"},"authority_backlinks":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authority Backlinks"},"authority_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authority Error","description":"Present only when the authority call failed."},"mentions_prompts_tested":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mentions Prompts Tested"},"mentions_citation_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mentions Citation Count"},"mentions_citation_rate_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mentions Citation Rate Pct"},"mentions_platform_counts":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Mentions Platform Counts"},"mentions_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mentions Error","description":"Present only when the LLM-mentions call failed."},"microdata_validation":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Microdata Validation","description":"List of {level, field_path, message} items. UNCONFIRMED field mapping pending a human check against a real DataForSEO account (core#9478) — may be empty or incomplete until then."},"microdata_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Microdata Error","description":"Present only when the microdata call failed."},"enriched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enriched At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["domain","status"],"title":"DataForSEOEnrichmentPayload","description":"One stored per-report DataForSEO enrichment (core#9478).\n\nEach of the three pieces (authority / mentions / microdata) can be\npresent or null INDEPENDENTLY of the others — DataForSEO is three\nseparate live API calls per report, and one failing (e.g. an exhausted\nquota) must never hide the other two that succeeded. A null piece's\nmatching `*_error` field carries why, when known; both null together\nmeans that piece was never attempted (the whole enrichment skipped,\ne.g. no credentials configured)."},"DataForSEOEnrichmentResponse":{"properties":{"report_id":{"type":"string","title":"Report Id"},"enrichment":{"anyOf":[{"$ref":"#/components/schemas/DataForSEOEnrichmentPayload"},{"type":"null"}],"description":"The stored enrichment, or null when none exists yet for this report — render as 'pending', never as a failure."}},"type":"object","required":["report_id"],"title":"DataForSEOEnrichmentResponse","description":"GET .../dataforseo-enrichment's payload for one report (core#9478).\n\n`enrichment` is null while the async task hasn't completed yet (or\nnever ran — enrichment is best-effort and queued only on a fresh scan),\nwhich the frontend's existing `pending` state already renders as\n\"enriching…\" (lib/reportContentModel.ts) — never a 404, since a report\nexisting and its enrichment not having landed yet are both normal."},"DataLineageListResponse":{"properties":{"count":{"type":"integer","title":"Count"},"records":{"items":{"$ref":"#/components/schemas/DataLineageRecord"},"type":"array","title":"Records"}},"type":"object","required":["count","records"],"title":"DataLineageListResponse"},"DataLineageRecord":{"properties":{"id":{"type":"string","title":"Id"},"source_system":{"type":"string","title":"Source System"},"source_table":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Table"},"destination_bucket":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Bucket"},"destination_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Path"},"rows_written":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Written"},"bytes_written":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bytes Written"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"status":{"type":"string","title":"Status"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","source_system","status"],"title":"DataLineageRecord","description":"One row from data_lineage (see data_lineage_service.get_lineage_records)."},"DatabaseActivityEvent":{"properties":{"type":{"type":"string","title":"Type"},"entity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["type"],"title":"DatabaseActivityEvent","description":"`entity` can itself be None (e.g. a NULL `email`/`name` column\nvalue passed straight through), and `timestamp` is explicitly None\nwhen the row's timestamp column is NULL -- both stay Optional\n(present as null), never omitted, matching current behavior."},"DatabaseActivityResponse":{"properties":{"period_hours":{"type":"integer","title":"Period Hours"},"since":{"type":"string","title":"Since"},"until":{"type":"string","title":"Until"},"events":{"items":{"$ref":"#/components/schemas/DatabaseActivityEvent"},"type":"array","title":"Events"},"total_events":{"type":"integer","title":"Total Events"}},"type":"object","required":["period_hours","since","until","events","total_events"],"title":"DatabaseActivityResponse"},"DatabaseAdminAPIKeyListResponse":{"properties":{"api_keys":{"items":{"$ref":"#/components/schemas/AdminAPIKeyResponse"},"type":"array","title":"Api Keys"},"total":{"type":"integer","title":"Total","default":0},"page":{"type":"integer","title":"Page","default":1},"pageSize":{"type":"integer","title":"Pagesize","default":50}},"type":"object","title":"DatabaseAdminAPIKeyListResponse","description":"Real shape of GET /database/admin/api-keys."},"DatabaseAdminAPIKeyRevokeResponse":{"properties":{"message":{"type":"string","title":"Message"},"key_info":{"$ref":"#/components/schemas/AdminAPIKeyResponse"}},"type":"object","required":["message","key_info"],"title":"DatabaseAdminAPIKeyRevokeResponse","description":"Real shape of POST /database/admin/api-keys/{id}/revoke."},"DatabaseAdminAPIKeyStatsResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"usage_count":{"type":"integer","title":"Usage Count","default":0},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"is_active":{"type":"boolean","title":"Is Active"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","is_active","created_at"],"title":"DatabaseAdminAPIKeyStatsResponse","description":"Real shape of GET /database/admin/api-keys/{id}/stats."},"DatabaseBackupInfo":{"properties":{"id":{"type":"string","title":"Id","description":"Backup identifier"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Backup creation timestamp"},"size_mb":{"type":"number","title":"Size Mb","description":"Backup size in megabytes"},"status":{"type":"string","title":"Status","description":"Backup status (completed, failed, in_progress)"}},"type":"object","required":["id","created_at","size_mb","status"],"title":"DatabaseBackupInfo","description":"Schema for individual database backup information"},"DatabaseBackupsResponse":{"properties":{"backups":{"items":{"$ref":"#/components/schemas/DatabaseBackupInfo"},"type":"array","title":"Backups","description":"List of database backups"},"total":{"type":"integer","title":"Total","description":"Total count of backups"},"skip":{"type":"integer","title":"Skip","description":"Number of backups skipped"},"limit":{"type":"integer","title":"Limit","description":"Maximum backups per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more backups are available"}},"type":"object","required":["backups","total","skip","limit","has_more"],"title":"DatabaseBackupsResponse","description":"Response schema for database backups listing"},"DatabaseCacheMetrics":{"properties":{"status":{"type":"string","title":"Status"},"shared_buffers":{"type":"string","title":"Shared Buffers"},"effective_cache_size":{"type":"string","title":"Effective Cache Size"},"buffer_cache_hit_ratio":{"type":"number","title":"Buffer Cache Hit Ratio"},"index_cache_hit_ratio":{"type":"number","title":"Index Cache Hit Ratio"},"query_plan_cache":{"$ref":"#/components/schemas/QueryPlanCache"}},"type":"object","required":["status","shared_buffers","effective_cache_size","buffer_cache_hit_ratio","index_cache_hit_ratio","query_plan_cache"],"title":"DatabaseCacheMetrics"},"DatabaseConnectionResponse":{"properties":{"host":{"type":"string","title":"Host","description":"Database host"},"port":{"type":"integer","title":"Port","description":"Database port"},"database_name":{"type":"string","title":"Database Name","description":"Database name"},"status":{"type":"string","title":"Status","description":"Connection status (active, inactive, provisioning)"},"connection_string":{"type":"string","title":"Connection String","description":"Masked connection string for display"}},"type":"object","required":["host","port","database_name","status","connection_string"],"title":"DatabaseConnectionResponse","description":"Response schema for database connection information"},"DatabaseExportRequest":{"properties":{"format":{"type":"string","pattern":"^(json|csv|parquet|postgresql_dump)$","title":"Format","description":"Export format: json, csv, parquet, or postgresql_dump"},"include_vectors":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Vectors","description":"Include vector embeddings in export","default":true},"include_metadata":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Metadata","description":"Include metadata fields in export","default":true},"include_embeddings":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Embeddings","description":"Include full embedding arrays (warning: large file size)","default":true},"filter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter","description":"Filter configuration for export"},"namespaces":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Namespaces","description":"Vector namespaces to include (defaults to all)"},"tables":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tables","description":"Table names to include (defaults to all)"},"compression":{"anyOf":[{"type":"string","pattern":"^(none|gzip|bzip2)$"},{"type":"null"}],"title":"Compression","description":"Compression format","default":"gzip"}},"type":"object","required":["format"],"title":"DatabaseExportRequest","description":"Request schema for comprehensive database export operations"},"DatabaseExportResponse":{"properties":{"export_id":{"type":"string","title":"Export Id","description":"Unique export job identifier"},"status":{"type":"string","title":"Status","description":"Export status: pending, in_progress, completed, failed"},"format":{"type":"string","title":"Format","description":"Export file format"},"file_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Url","description":"Presigned URL for file download (available when completed)"},"file_size_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"File Size Mb","description":"Export file size in megabytes"},"record_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Record Count","description":"Total number of records exported"},"progress_percent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Progress Percent","description":"Export progress percentage (0-100)"},"created_at":{"type":"string","title":"Created At","description":"Export job creation timestamp (ISO format)"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At","description":"Export job completion timestamp (ISO format)"},"expires_at":{"type":"string","title":"Expires At","description":"File download URL expiration timestamp (ISO format)"},"message":{"type":"string","title":"Message","description":"Human-readable status message"}},"type":"object","required":["export_id","status","format","created_at","expires_at","message"],"title":"DatabaseExportResponse","description":"Response schema for comprehensive database export operations"},"DatabaseExtensionsResponse":{"properties":{"extensions":{"items":{"$ref":"#/components/schemas/PostgresExtensionInfo"},"type":"array","title":"Extensions","description":"List of installed PostgreSQL extensions"}},"type":"object","required":["extensions"],"title":"DatabaseExtensionsResponse","description":"Response schema for PostgreSQL extensions listing"},"DatabaseGenerationMetadata":{"properties":{"generated_at":{"type":"string","title":"Generated At"},"generated_by":{"type":"string","title":"Generated By"},"entities_count":{"type":"integer","title":"Entities Count"},"endpoints_count":{"type":"integer","title":"Endpoints Count"},"migrations_count":{"type":"integer","title":"Migrations Count"}},"type":"object","required":["generated_at","generated_by","entities_count","endpoints_count","migrations_count"],"title":"DatabaseGenerationMetadata"},"DatabaseHealthChecks":{"properties":{"connectivity":{"$ref":"#/components/schemas/HealthCheckItem"},"disk_space":{"$ref":"#/components/schemas/HealthCheckItem"},"memory_usage":{"$ref":"#/components/schemas/HealthCheckItem"},"connection_pool":{"$ref":"#/components/schemas/HealthCheckItem"},"backup_status":{"$ref":"#/components/schemas/HealthCheckItem"},"replication":{"$ref":"#/components/schemas/HealthCheckItem"}},"type":"object","required":["connectivity","disk_space","memory_usage","connection_pool","backup_status","replication"],"title":"DatabaseHealthChecks"},"DatabaseHealthForDr":{"properties":{"status":{"type":"string","title":"Status"},"connections":{"type":"integer","title":"Connections"},"response_time_ms":{"type":"integer","title":"Response Time Ms"}},"type":"object","required":["status","connections","response_time_ms"],"title":"DatabaseHealthForDr"},"DatabaseHealthInfo":{"properties":{"status":{"type":"string","title":"Status"},"users_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Users Total"},"organizations_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Organizations Total"},"projects_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Projects Total"},"connection_pool":{"type":"string","title":"Connection Pool","default":"healthy"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status"],"title":"DatabaseHealthInfo","description":"Database health information"},"DatabaseHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"timestamp":{"type":"string","title":"Timestamp"},"checks":{"additionalProperties":true,"type":"object","title":"Checks"}},"type":"object","required":["status","timestamp","checks"],"title":"DatabaseHealthResponse"},"DatabaseImportRequest":{"properties":{"source":{"type":"string","pattern":"^(postgresql_backup|json|csv|file_url|export_id)$","title":"Source","description":"Import source type"},"backup_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backup Id","description":"PostgreSQL backup ID (for postgresql_backup source)"},"file_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Url","description":"URL to download file from (for file_url source)"},"file_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Content","description":"Base64-encoded file content (for json/csv sources)"},"export_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Export Id","description":"Export ID to re-import (for export_id source)"},"validate_schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Validate Schema","description":"Validate data schema before import","default":true},"overwrite_existing":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Overwrite Existing","description":"Overwrite existing records","default":false},"merge_strategy":{"anyOf":[{"type":"string","pattern":"^(skip|overwrite|merge)$"},{"type":"null"}],"title":"Merge Strategy","description":"Strategy for handling duplicates","default":"skip"},"target_namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Namespace","description":"Target namespace for vectors (defaults to 'default')"}},"type":"object","required":["source"],"title":"DatabaseImportRequest","description":"Request schema for database import operations.\n\nAccepts BOTH the canonical API shape ({source, file_content, ...}) and the\nZeroDB dashboard shape ({namespace, format, data, source_url}). The dashboard\nposts raw (non-base64) content in ``data`` with ``format`` in (json|csv);\nthe ``_adapt_frontend_shape`` validator maps that onto the canonical fields\nso the import no longer 422s on the frontend contract (#6492)."},"DatabaseImportResponse":{"properties":{"import_id":{"type":"string","title":"Import Id","description":"Unique import job identifier"},"status":{"type":"string","title":"Status","description":"Import status: pending, validating, in_progress, completed, failed, rollback"},"source_type":{"type":"string","title":"Source Type","description":"Import source type"},"records_imported":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Records Imported","description":"Number of records successfully imported"},"records_failed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Records Failed","description":"Number of records that failed to import"},"records_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Records Total","description":"Total number of records to import"},"progress_percent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Progress Percent","description":"Import progress percentage (0-100)"},"validation_errors":{"anyOf":[{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array"},{"type":"null"}],"title":"Validation Errors","description":"Validation errors encountered"},"created_at":{"type":"string","title":"Created At","description":"Import job creation timestamp"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At","description":"Import job completion timestamp"},"message":{"type":"string","title":"Message","description":"Human-readable status message"},"rollback_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Rollback Available","description":"Whether rollback is available for this import","default":false}},"type":"object","required":["import_id","status","source_type","created_at","message"],"title":"DatabaseImportResponse","description":"Response schema for database import operations"},"DatabaseMetrics":{"properties":{"active_connections":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Connections"},"pool_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pool Size"},"checked_in":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Checked In"},"overflow":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Overflow"},"query_time_avg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Query Time Avg"},"query_time_p95":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Query Time P95"},"slow_queries":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Slow Queries"},"cache_hit_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cache Hit Ratio"},"data_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Source"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","title":"DatabaseMetrics","description":"REAL -- live SQLAlchemy pool counters (Refs #8270).\n\n`query_time_avg` / `query_time_p95` / `cache_hit_ratio` are now Optional\nand omitted: their previous values were invented constants and no live\nper-query timing source is wired into this process."},"DatabaseMetricsTimeseries":{"properties":{"query_time":{"$ref":"#/components/schemas/MetricTimeSeries"},"active_connections":{"$ref":"#/components/schemas/MetricTimeSeries"},"cache_hit_ratio":{"$ref":"#/components/schemas/MetricTimeSeries"}},"type":"object","required":["query_time","active_connections","cache_hit_ratio"],"title":"DatabaseMetricsTimeseries"},"DatabaseOptimizeResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"optimization_type":{"type":"string","title":"Optimization Type"},"dry_run":{"type":"boolean","title":"Dry Run"},"optimization_started":{"type":"string","title":"Optimization Started"},"tables_vacuumed":{"type":"integer","title":"Tables Vacuumed"},"tables_analyzed":{"type":"integer","title":"Tables Analyzed"},"indexes_rebuilt":{"type":"integer","title":"Indexes Rebuilt"},"cache_entries_cleared":{"type":"integer","title":"Cache Entries Cleared"},"estimated_space_freed_mb":{"type":"number","title":"Estimated Space Freed Mb"},"duration_seconds":{"type":"number","title":"Duration Seconds"},"message":{"type":"string","title":"Message"},"admin_user":{"type":"string","title":"Admin User"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["success","optimization_type","dry_run","optimization_started","tables_vacuumed","tables_analyzed","indexes_rebuilt","cache_entries_cleared","estimated_space_freed_mb","duration_seconds","message","admin_user","timestamp"],"title":"DatabaseOptimizeResponse","description":"Response for POST /database/optimize."},"DatabaseStatistics":{"properties":{"database_size":{"type":"string","title":"Database Size"},"database_size_bytes":{"type":"integer","title":"Database Size Bytes"},"active_connections":{"type":"integer","title":"Active Connections"},"max_connections":{"type":"integer","title":"Max Connections"},"connection_utilization":{"type":"number","title":"Connection Utilization"},"total_commits":{"type":"integer","title":"Total Commits"},"total_rollbacks":{"type":"integer","title":"Total Rollbacks"},"cache_hit_ratio":{"type":"number","title":"Cache Hit Ratio"},"blocks_read":{"type":"integer","title":"Blocks Read"},"blocks_hit":{"type":"integer","title":"Blocks Hit"}},"type":"object","required":["database_size","database_size_bytes","active_connections","max_connections","connection_utilization","total_commits","total_rollbacks","cache_hit_ratio","blocks_read","blocks_hit"],"title":"DatabaseStatistics"},"DatabaseStatusUsage":{"properties":{"vectors_count":{"type":"integer","title":"Vectors Count"},"tables_count":{"type":"integer","title":"Tables Count"},"events_count":{"type":"integer","title":"Events Count"},"memory_usage_mb":{"type":"integer","title":"Memory Usage Mb"},"storage_usage_mb":{"type":"integer","title":"Storage Usage Mb"}},"type":"object","required":["vectors_count","tables_count","events_count","memory_usage_mb","storage_usage_mb"],"title":"DatabaseStatusUsage"},"DatasetCardResponse":{"properties":{"status":{"type":"string","title":"Status","default":"not generated — run scripts/casa/anonymize_for_publication.py"},"total_source_rows":{"type":"integer","title":"Total Source Rows","default":0},"safe_candidate_rows":{"type":"integer","title":"Safe Candidate Rows","default":0},"published":{"type":"boolean","title":"Published"}},"additionalProperties":true,"type":"object","required":["published"],"title":"DatasetCardResponse","description":"Dataset card summary stats. Extra fields allowed — the underlying\ndataset_card.json is produced by a separate anonymization script and\nits exact key set may evolve without this endpoint needing a change."},"DatasetRowsResponse":{"properties":{"rows":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Rows"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["rows","limit","offset","count"],"title":"DatasetRowsResponse"},"DatasetStats":{"properties":{"dataset":{"type":"string","title":"Dataset"},"total_records":{"type":"integer","title":"Total Records"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Updated"},"description":{"type":"string","title":"Description"}},"type":"object","required":["dataset","total_records","description"],"title":"DatasetStats"},"DaySchedule":{"properties":{"day_of_week":{"type":"integer","maximum":6,"minimum":0,"title":"Day Of Week"},"day_name":{"type":"string","title":"Day Name","description":"Day name (Monday-Sunday)"},"schedules":{"items":{"$ref":"#/components/schemas/app__schemas__streaming__ScheduleResponse"},"type":"array","title":"Schedules"}},"type":"object","required":["day_of_week","day_name","schedules"],"title":"DaySchedule","description":"Schedule entries for a specific day","example":{"day_name":"Tuesday","day_of_week":1,"schedules":[{"day_of_week":1,"end_time":"20:00","id":"sched-1111-2222-3333-4444-555566667777","is_recurring":true,"start_time":"18:00","title":"Evening Code Stream","user_id":"550e8400-e29b-41d4-a716-446655440000"}]}},"DayVolume":{"properties":{"date":{"type":"string","title":"Date"},"value":{"type":"number","title":"Value"}},"type":"object","required":["date","value"],"title":"DayVolume"},"DeadlinesResponse":{"properties":{"deadlines":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Deadlines"}},"type":"object","required":["deadlines"],"title":"DeadlinesResponse"},"DebugAggregateRawQueries":{"properties":{"api_credits":{"title":"Api Credits"},"llm_tokens":{"title":"Llm Tokens"}},"type":"object","required":["api_credits","llm_tokens"],"title":"DebugAggregateRawQueries"},"DebugAggregateRawResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"subscription":{"$ref":"#/components/schemas/DebugAggregateRawSubscription"},"queries":{"$ref":"#/components/schemas/DebugAggregateRawQueries"},"note":{"type":"string","title":"Note"}},"type":"object","required":["user_id","subscription","queries","note"],"title":"DebugAggregateRawResponse"},"DebugAggregateRawSubscription":{"properties":{"plan_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Name"},"period_start":{"type":"string","title":"Period Start"},"period_end":{"type":"string","title":"Period End"}},"type":"object","required":["period_start","period_end"],"title":"DebugAggregateRawSubscription"},"DebugCheckPasswordResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"security_notice":{"type":"string","title":"Security Notice"},"admin_user":{"type":"string","title":"Admin User"},"security_measures":{"items":{"type":"string"},"type":"array","title":"Security Measures"},"password_security":{"$ref":"#/components/schemas/DebugPasswordSecurity"}},"type":"object","required":["status","message","security_notice","admin_user","security_measures","password_security"],"title":"DebugCheckPasswordResponse","description":"Response for GET /admin/debug/check-password."},"DebugCheckUsersResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"security_notice":{"type":"string","title":"Security Notice"},"admin_user":{"type":"string","title":"Admin User"},"timestamp":{"type":"string","title":"Timestamp"},"user_summary":{"$ref":"#/components/schemas/DebugUserSummary"},"security_improvements":{"items":{"type":"string"},"type":"array","title":"Security Improvements"}},"type":"object","required":["status","message","security_notice","admin_user","timestamp","user_summary","security_improvements"],"title":"DebugCheckUsersResponse","description":"Response for GET /admin/debug/check-users."},"DebugFixAllPasswordsResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"security_alert":{"type":"string","title":"Security Alert"},"admin_user":{"type":"string","title":"Admin User"},"security_improvements":{"items":{"type":"string"},"type":"array","title":"Security Improvements"},"recommendation":{"type":"string","title":"Recommendation"},"access_level":{"type":"string","title":"Access Level"}},"type":"object","required":["status","message","security_alert","admin_user","security_improvements","recommendation","access_level"],"title":"DebugFixAllPasswordsResponse","description":"Response for POST /admin/debug/fix-all-passwords."},"DebugPasswordSecurity":{"properties":{"hashing_algorithm":{"type":"string","title":"Hashing Algorithm"},"status":{"type":"string","title":"Status"},"exposure_risk":{"type":"string","title":"Exposure Risk"}},"type":"object","required":["hashing_algorithm","status","exposure_risk"],"title":"DebugPasswordSecurity"},"DebugUserSummary":{"properties":{"total_users":{"type":"string","title":"Total Users"},"active_users":{"type":"string","title":"Active Users"},"database_status":{"type":"string","title":"Database Status"}},"type":"object","required":["total_users","active_users","database_status"],"title":"DebugUserSummary"},"DebugVersionResponse":{"properties":{"commit":{"type":"string","title":"Commit"},"short_commit":{"type":"string","title":"Short Commit"},"fix_applied":{"type":"string","title":"Fix Applied"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["commit","short_commit","fix_applied","timestamp"],"title":"DebugVersionResponse"},"DebuggingAnalyzeRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"ID of the project"},"error_analysis_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Analysis Id","description":"ID of an existing error analysis"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error message if not using analysis"},"error_stack_trace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Stack Trace","description":"Stack trace if not using analysis"},"code_context":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Code Context","description":"Code context to assist with fixing"}},"type":"object","required":["project_id"],"title":"DebuggingAnalyzeRequest","description":"Schema for the top-level analyze endpoint"},"DebuggingSession":{"properties":{"debugging_title":{"type":"string","title":"Debugging Title","description":"Title of the debugging session"},"error_analysis_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Analysis Id","description":"ID of associated error analysis"},"session_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Session Metadata","description":"Additional metadata for the session"},"id":{"type":"string","title":"Id","description":"Unique ID of the session"},"user_id":{"type":"string","title":"User Id","description":"ID of the user who created the session"},"project_id":{"type":"string","title":"Project Id","description":"ID of the project"},"status":{"$ref":"#/components/schemas/DebuggingSessionStatus","description":"Status of the session"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["debugging_title","id","user_id","project_id","status","created_at"],"title":"DebuggingSession","description":"Schema for a debugging session"},"DebuggingSessionCreate":{"properties":{"debugging_title":{"type":"string","title":"Debugging Title","description":"Title of the debugging session"},"error_analysis_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Analysis Id","description":"ID of associated error analysis"},"session_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Session Metadata","description":"Additional metadata for the session"},"project_id":{"type":"string","title":"Project Id","description":"ID of the project"}},"type":"object","required":["debugging_title","project_id"],"title":"DebuggingSessionCreate","description":"Schema for creating a debugging session"},"DebuggingSessionStatus":{"type":"string","enum":["active","completed","failed","abandoned"],"title":"DebuggingSessionStatus","description":"Status of a debugging session"},"DebuggingSessionUpdate":{"properties":{"debugging_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Debugging Title","description":"Title of the debugging session"},"status":{"anyOf":[{"$ref":"#/components/schemas/DebuggingSessionStatus"},{"type":"null"}],"description":"Status of the session"},"session_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Session Metadata","description":"Additional metadata for the session"}},"type":"object","title":"DebuggingSessionUpdate","description":"Schema for updating a debugging session"},"DebuggingSessionWithDetails":{"properties":{"debugging_title":{"type":"string","title":"Debugging Title","description":"Title of the debugging session"},"error_analysis_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Analysis Id","description":"ID of associated error analysis"},"session_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Session Metadata","description":"Additional metadata for the session"},"id":{"type":"string","title":"Id","description":"Unique ID of the session"},"user_id":{"type":"string","title":"User Id","description":"ID of the user who created the session"},"project_id":{"type":"string","title":"Project Id","description":"ID of the project"},"status":{"$ref":"#/components/schemas/DebuggingSessionStatus","description":"Status of the session"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"},"steps":{"items":{"$ref":"#/components/schemas/DebuggingStep"},"type":"array","title":"Steps","description":"List of debugging steps"},"suggestions":{"items":{"$ref":"#/components/schemas/DebuggingSuggestion"},"type":"array","title":"Suggestions","description":"List of debugging suggestions"},"test_cases":{"items":{"$ref":"#/components/schemas/TestCaseSuggestion"},"type":"array","title":"Test Cases","description":"List of test case suggestions"}},"type":"object","required":["debugging_title","id","user_id","project_id","status","created_at"],"title":"DebuggingSessionWithDetails","description":"Schema for a debugging session with details"},"DebuggingStep":{"properties":{"step_number":{"type":"integer","title":"Step Number","description":"Sequence number of the step"},"step_title":{"type":"string","title":"Step Title","description":"Title of the debugging step"},"step_description":{"type":"string","title":"Step Description","description":"Detailed description of the step"},"step_status":{"$ref":"#/components/schemas/DebuggingStepStatus","description":"Current status of the step","default":"pending"},"id":{"type":"string","title":"Id","description":"Unique ID of the step"},"session_id":{"type":"string","title":"Session Id","description":"ID of the debugging session"},"step_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Step Results","description":"Results of the step"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["step_number","step_title","step_description","id","session_id","created_at"],"title":"DebuggingStep","description":"Schema for a debugging step"},"DebuggingStepCreate":{"properties":{"step_number":{"type":"integer","title":"Step Number","description":"Sequence number of the step"},"step_title":{"type":"string","title":"Step Title","description":"Title of the debugging step"},"step_description":{"type":"string","title":"Step Description","description":"Detailed description of the step"},"step_status":{"$ref":"#/components/schemas/DebuggingStepStatus","description":"Current status of the step","default":"pending"},"session_id":{"type":"string","title":"Session Id","description":"ID of the debugging session"},"step_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Step Results","description":"Results of the step"}},"type":"object","required":["step_number","step_title","step_description","session_id"],"title":"DebuggingStepCreate","description":"Schema for creating a debugging step"},"DebuggingStepStatus":{"type":"string","enum":["pending","in_progress","completed","failed","skipped"],"title":"DebuggingStepStatus","description":"Status of a debugging step"},"DebuggingStepUpdate":{"properties":{"step_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step Title","description":"Title of the debugging step"},"step_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step Description","description":"Detailed description of the step"},"step_status":{"anyOf":[{"$ref":"#/components/schemas/DebuggingStepStatus"},{"type":"null"}],"description":"Current status of the step"},"step_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Step Results","description":"Results of the step"}},"type":"object","title":"DebuggingStepUpdate","description":"Schema for updating a debugging step"},"DebuggingSuggestion":{"properties":{"suggestion_type":{"$ref":"#/components/schemas/SuggestionType","description":"Type of the suggestion"},"suggestion_title":{"type":"string","title":"Suggestion Title","description":"Title of the suggestion"},"suggestion_content":{"type":"string","title":"Suggestion Content","description":"Detailed content of the suggestion"},"code_snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Snippet","description":"Code snippet of the suggestion"},"file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Path","description":"File path related to the suggestion"},"line_numbers":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Line Numbers","description":"Line numbers related to the suggestion"},"confidence_score":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Confidence Score","description":"Confidence score of the suggestion"},"id":{"type":"string","title":"Id","description":"Unique ID of the suggestion"},"session_id":{"type":"string","title":"Session Id","description":"ID of the debugging session"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"}},"type":"object","required":["suggestion_type","suggestion_title","suggestion_content","id","session_id","created_at"],"title":"DebuggingSuggestion","description":"Schema for a debugging suggestion"},"DebuggingSuggestionCreate":{"properties":{"suggestion_type":{"$ref":"#/components/schemas/SuggestionType","description":"Type of the suggestion"},"suggestion_title":{"type":"string","title":"Suggestion Title","description":"Title of the suggestion"},"suggestion_content":{"type":"string","title":"Suggestion Content","description":"Detailed content of the suggestion"},"code_snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Snippet","description":"Code snippet of the suggestion"},"file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Path","description":"File path related to the suggestion"},"line_numbers":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Line Numbers","description":"Line numbers related to the suggestion"},"confidence_score":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Confidence Score","description":"Confidence score of the suggestion"},"session_id":{"type":"string","title":"Session Id","description":"ID of the debugging session"}},"type":"object","required":["suggestion_type","suggestion_title","suggestion_content","session_id"],"title":"DebuggingSuggestionCreate","description":"Schema for creating a debugging suggestion"},"DecayConfigResponse":{"properties":{"default_decay_rate":{"type":"number","title":"Default Decay Rate"},"eviction_limit":{"type":"integer","title":"Eviction Limit"},"last_decay_run":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Last Decay Run"},"last_eviction_run":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Last Eviction Run"}},"type":"object","required":["default_decay_rate","eviction_limit"],"title":"DecayConfigResponse"},"DecayConfigUpdate":{"properties":{"default_decay_rate":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Default Decay Rate","description":"Default decay rate for memories (0.0-1.0)"},"eviction_limit":{"anyOf":[{"type":"integer","minimum":100},{"type":"null"}],"title":"Eviction Limit","description":"Maximum number of memories per user before LRU eviction (min 100)"}},"type":"object","title":"DecayConfigUpdate"},"DecayConfigUpdateResponse":{"properties":{"status":{"type":"string","title":"Status"},"default_decay_rate":{"type":"number","title":"Default Decay Rate"},"eviction_limit":{"type":"integer","title":"Eviction Limit"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["status","default_decay_rate","eviction_limit","updated_at"],"title":"DecayConfigUpdateResponse"},"DecayCycleResponse":{"properties":{"status":{"type":"string","title":"Status"},"run_id":{"type":"string","title":"Run Id"},"worker_type":{"type":"string","title":"Worker Type"},"processed_count":{"type":"integer","title":"Processed Count"},"decayed_count":{"type":"integer","title":"Decayed Count"},"updated_rates":{"type":"integer","title":"Updated Rates"},"duration_ms":{"type":"integer","title":"Duration Ms"}},"type":"object","required":["status","run_id","worker_type","processed_count","decayed_count","updated_rates","duration_ms"],"title":"DecayCycleResponse"},"DecideApprovalRequest":{"properties":{"decision":{"type":"string","pattern":"^(approved|denied)$","title":"Decision","description":"Must be 'approved' or 'denied'"},"note":{"type":"string","maxLength":4000,"title":"Note","description":"Decision rationale","default":""}},"type":"object","required":["decision"],"title":"DecideApprovalRequest"},"DecideApprovalResponse":{"properties":{"approval_id":{"type":"string","title":"Approval Id"},"status":{"type":"string","title":"Status"},"signal":{"type":"string","title":"Signal"},"decided_by":{"type":"string","title":"Decided By"},"note":{"type":"string","title":"Note"}},"type":"object","required":["approval_id","status","signal","decided_by","note"],"title":"DecideApprovalResponse"},"DecideReviewRequest":{"properties":{"decision":{"type":"string","pattern":"^(approved|rejected)$","title":"Decision","description":"Must be 'approved' or 'rejected'"},"comment":{"type":"string","maxLength":2000,"title":"Comment","description":"Optional comment explaining the decision","default":""}},"type":"object","required":["decision"],"title":"DecideReviewRequest"},"DecideReviewResponse":{"properties":{"review_id":{"type":"string","title":"Review Id"},"status":{"type":"string","title":"Status"},"decided_by":{"type":"string","title":"Decided By"},"comment":{"type":"string","title":"Comment"}},"type":"object","required":["review_id","status","decided_by","comment"],"title":"DecideReviewResponse","description":"See AgentReviewService.decide_review."},"DecisionResponse":{"properties":{"effect":{"type":"string","title":"Effect"},"reason":{"type":"string","title":"Reason"},"decision_id":{"type":"string","title":"Decision Id"},"approval_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approval Id"},"workspace_id":{"type":"string","title":"Workspace Id"},"tool":{"type":"string","title":"Tool"},"target":{"type":"string","title":"Target"},"latency_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latency Ms"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent"}},"type":"object","required":["effect","reason","decision_id","workspace_id","tool","target"],"title":"DecisionResponse"},"DecryptDataRequest":{"properties":{"encrypted_payload":{"additionalProperties":{"type":"string"},"type":"object","title":"Encrypted Payload","description":"Encrypted data payload"},"context_id":{"type":"string","title":"Context Id","description":"Context identifier"}},"type":"object","required":["encrypted_payload","context_id"],"title":"DecryptDataRequest","description":"Request to decrypt data"},"DecryptSensitiveDataResponse":{"properties":{"data":{"type":"string","title":"Data"},"decrypted_at":{"type":"string","title":"Decrypted At"}},"type":"object","required":["data","decrypted_at"],"title":"DecryptSensitiveDataResponse"},"DeduplicateNamespaceResponse":{"properties":{"duplicates_removed":{"type":"integer","title":"Duplicates Removed"},"vectors_remaining":{"type":"integer","title":"Vectors Remaining"},"namespace":{"type":"string","title":"Namespace"}},"type":"object","required":["duplicates_removed","vectors_remaining","namespace"],"title":"DeduplicateNamespaceResponse"},"DeepEvalMetricInfo":{"properties":{"metric":{"type":"string","title":"Metric"},"description":{"type":"string","title":"Description"}},"type":"object","required":["metric","description"],"title":"DeepEvalMetricInfo"},"DefaultThresholds":{"properties":{"quality":{"$ref":"#/components/schemas/QualityThresholdLevels"},"performance":{"$ref":"#/components/schemas/PerformanceThresholdLevels"}},"type":"object","required":["quality","performance"],"title":"DefaultThresholds"},"DelegateTokenRequest":{"properties":{"parent_token":{"type":"string","title":"Parent Token","description":"The parent agent's access token"},"target_agent_id":{"type":"string","title":"Target Agent Id","description":"Agent ID to delegate to"},"scopes":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Scopes","description":"Scopes for the delegated token (must be subset of parent)"}},"type":"object","required":["parent_token","target_agent_id","scopes"],"title":"DelegateTokenRequest","description":"Delegated token exchange request."},"DelegateTokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"expires_in":{"type":"integer","title":"Expires In"},"scope":{"type":"string","title":"Scope"}},"type":"object","required":["access_token","expires_in","scope"],"title":"DelegateTokenResponse","description":"Delegated token exchange response."},"DeleteAPIKeyResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"DeleteAPIKeyResponse","description":"Response for DELETE /settings/api-keys/{key_id}"},"DeleteAgentLogResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"total_logs":{"type":"integer","title":"Total Logs"},"log_levels":{"additionalProperties":{"type":"integer"},"type":"object","title":"Log Levels"},"unique_agents":{"type":"integer","title":"Unique Agents"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["project_id","total_logs","log_levels","unique_agents","timestamp"],"title":"DeleteAgentLogResponse","description":"NOTE (pre-existing bug, out of scope for this typing pass): the\ndelete_agent_log handler does not actually delete the log or return a\ndeletion confirmation -- it returns the exact same stats payload as\nget_agent_logs_stats (copy/paste from that handler). This model documents\nthe REAL current response shape, not the shape a delete endpoint should\nhave. See handler docstring / code comment for the finding."},"DeleteCommentResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"DeleteCommentResponse"},"DeleteDeploymentWebhookResponse":{"properties":{"webhook_id":{"type":"string","title":"Webhook Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["webhook_id","status"],"title":"DeleteDeploymentWebhookResponse"},"DeleteDocumentationResponse":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"deleted_by":{"type":"string","title":"Deleted By"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["doc_id","status","message","deleted_by","timestamp"],"title":"DeleteDocumentationResponse","description":"Response for DELETE /help-documentation/content/{doc_id}."},"DeleteEvaluationResultsResponse":{"properties":{"message":{"type":"string","title":"Message"},"evaluation_id":{"type":"string","title":"Evaluation Id"}},"type":"object","required":["message","evaluation_id"],"title":"DeleteEvaluationResultsResponse","description":"Response for DELETE /results/{evaluation_id}."},"DeleteInboxResponse":{"properties":{"deleted":{"type":"boolean","title":"Deleted"}},"type":"object","required":["deleted"],"title":"DeleteInboxResponse"},"DeleteIndexRequest":{"properties":{"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"ZeroDB project UUID"},"repo_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repo Hash","description":"Git remote hash (alternative to project_id)"},"file_path":{"type":"string","title":"File Path","description":"Delete all fragments for this file path"}},"type":"object","required":["file_path"],"title":"DeleteIndexRequest"},"DeleteIndexResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"deleted":{"type":"integer","title":"Deleted"}},"type":"object","required":["deleted"],"title":"DeleteIndexResponse"},"DeleteMemoryRecordResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"DeleteMemoryRecordResponse","description":"delete_memory_record returns db_service.delete_memory_record's result\nverbatim (typically {\"message\": ...})."},"DeleteMemorySessionResponse":{"properties":{"message":{"type":"string","title":"Message"},"session_id":{"type":"string","title":"Session Id"}},"type":"object","required":["message","session_id"],"title":"DeleteMemorySessionResponse"},"DeleteNamespaceResponse":{"properties":{"message":{"type":"string","title":"Message"},"namespace":{"type":"string","title":"Namespace"},"vectors_deleted":{"type":"integer","title":"Vectors Deleted"}},"type":"object","required":["message","namespace","vectors_deleted"],"title":"DeleteNamespaceResponse"},"DeleteOperationResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"DeleteOperationResponse","description":"Response for DELETE /scaffolding-tools/operations/{request_id}."},"DeletePostgresResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"DeletePostgresResponse"},"DeleteResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"DeleteResponse","description":"Schema for delete operation response","example":{"message":"Notification deleted successfully","success":true}},"DeleteRowResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"DeleteRowResponse"},"DeleteSnapshotResponse":{"properties":{"status":{"type":"string","title":"Status","description":"not_found | success"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Id"},"snapshot_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Name"},"file_deleted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"File Deleted"},"directory_deleted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Directory Deleted"}},"type":"object","required":["status"],"title":"DeleteSnapshotResponse","description":"Response for DELETE /snapshots/{snapshot_id} (SnapshotSystem.delete_snapshot)."},"DeleteSwarmResponse":{"properties":{"message":{"type":"string","title":"Message"},"swarm_id":{"type":"string","title":"Swarm Id"},"deleted_at":{"type":"string","title":"Deleted At"}},"type":"object","required":["message","swarm_id","deleted_at"],"title":"DeleteSwarmResponse"},"DeleteTableResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"DeleteTableResponse","description":"delete_table returns whatever CachedDatabaseService.delete_table returns\nverbatim (typically {\"message\": ...}); modeled permissively since the\nservice layer is free-form here."},"DeleteTemplateResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"DeleteTemplateResponse","description":"Response for DELETE /templates/{template_id}."},"DeleteUserResponse":{"properties":{"message":{"type":"string","title":"Message"},"user_id":{"type":"string","title":"User Id"},"anonymized_email":{"type":"string","title":"Anonymized Email"},"purged_rows":{"additionalProperties":{"type":"integer"},"type":"object","title":"Purged Rows"},"deleted_at":{"type":"string","title":"Deleted At"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","required":["message","user_id","anonymized_email","purged_rows","deleted_at"],"title":"DeleteUserResponse"},"DeleteWebhookResponse":{"properties":{"webhook_id":{"type":"string","title":"Webhook Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["webhook_id","status"],"title":"DeleteWebhookResponse"},"DemandAdjustment":{"properties":{"fill_rate":{"type":"number","maximum":1,"minimum":0,"title":"Fill Rate","description":"Current fill rate (0.0 - 1.0)"},"multiplier":{"type":"number","maximum":2.5,"minimum":0.5,"title":"Multiplier","description":"Price multiplier applied (0.7 - 2.0)"},"reason":{"type":"string","maxLength":200,"title":"Reason","description":"Human-readable explanation for adjustment"}},"type":"object","required":["fill_rate","multiplier","reason"],"title":"DemandAdjustment","description":"Demand-based pricing adjustment.\n\nRepresents the multiplier applied to base price based on\nreal-time fill rate (inventory demand).","example":{"fill_rate":0.85,"multiplier":1.5,"reason":"High demand (>80% filled)"}},"DemoAgentSwarm":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"agents":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Agents"},"status":{"type":"string","title":"Status","default":"active"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","name","agents","created_at"],"title":"DemoAgentSwarm"},"DemoProject":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"vector_count":{"type":"integer","title":"Vector Count","default":0},"memory_contexts":{"type":"integer","title":"Memory Contexts","default":0}},"type":"object","required":["id","name","created_at"],"title":"DemoProject"},"DemoSearchRequest":{"properties":{"query_vector":{"items":{"type":"number"},"type":"array","title":"Query Vector"},"limit":{"type":"integer","title":"Limit","default":10},"include_metadata":{"type":"boolean","title":"Include Metadata","default":true},"filter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter"}},"type":"object","required":["query_vector"],"title":"DemoSearchRequest"},"DemoSearchResult":{"properties":{"matches":{"items":{"$ref":"#/components/schemas/DemoVector"},"type":"array","title":"Matches"},"query_time_ms":{"type":"number","title":"Query Time Ms"},"total_results":{"type":"integer","title":"Total Results"}},"type":"object","required":["matches","query_time_ms","total_results"],"title":"DemoSearchResult"},"DemoVector":{"properties":{"id":{"type":"string","title":"Id"},"embedding":{"items":{"type":"number"},"type":"array","title":"Embedding"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"similarity_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Similarity Score"}},"type":"object","required":["id","embedding"],"title":"DemoVector"},"DenyRequest":{"properties":{"reason":{"type":"string","maxLength":1000,"minLength":1,"title":"Reason","description":"Reason for denial"}},"type":"object","required":["reason"],"title":"DenyRequest"},"DependencyDetectRequest":{"properties":{"project_id":{"type":"string","title":"Project Id"}},"type":"object","required":["project_id"],"title":"DependencyDetectRequest","description":"Request model for detecting project dependencies."},"DependencyDetectResponse":{"properties":{"status":{"type":"string","title":"Status"},"project_id":{"type":"string","title":"Project Id"},"dependencies":{"items":{"$ref":"#/components/schemas/DependencyMatch"},"type":"array","title":"Dependencies"},"total_dependencies":{"type":"integer","title":"Total Dependencies"}},"type":"object","required":["status","project_id","dependencies","total_dependencies"],"title":"DependencyDetectResponse","description":"Response for POST /project-context/dependencies/detect\n(detect_project_dependencies)."},"DependencyInfo":{"properties":{"path":{"type":"string","title":"Path"},"type":{"type":"string","title":"Type"},"external":{"type":"boolean","title":"External"}},"type":"object","required":["path","type","external"],"title":"DependencyInfo"},"DependencyMatch":{"properties":{"project_id":{"title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"matching_imports":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Matching Imports"},"count":{"type":"integer","title":"Count"}},"additionalProperties":true,"type":"object","required":["project_id","matching_imports","count"],"title":"DependencyMatch"},"DeployAgentRequest":{"properties":{"agent_registration_id":{"type":"string","maxLength":128,"minLength":1,"title":"Agent Registration Id","description":"Agent registration UUID or agent_id string (e.g. 'agent-88d18d1bbed6')"},"image_uri":{"type":"string","maxLength":512,"minLength":1,"title":"Image Uri"},"resource_plan":{"type":"string","title":"Resource Plan","default":"basic"},"region":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Region","description":"Preferred Railway region (e.g. us-west1). Stored with the deployment; real region placement is a preview feature (Refs #6098)."},"runtime_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Runtime Config"}},"type":"object","required":["agent_registration_id","image_uri"],"title":"DeployAgentRequest","example":{"agent_registration_id":"agent-88d18d1bbed6","image_uri":"ghcr.io/my-org/my-agent:latest","resource_plan":"basic","runtime_config":{"env":{"LOG_LEVEL":"info"},"port":8080}}},"DeployFreshnessResponse":{"properties":{"fresh":{"type":"boolean","title":"Fresh"},"registered_count":{"type":"integer","title":"Registered Count"},"total_count":{"type":"integer","title":"Total Count"},"critical_modules":{"items":{"type":"string"},"type":"array","title":"Critical Modules"},"missing_critical_modules":{"items":{"type":"string"},"type":"array","title":"Missing Critical Modules"}},"type":"object","required":["fresh","registered_count","total_count","critical_modules","missing_critical_modules"],"title":"DeployFreshnessResponse","description":"GET /api/v1/public/health/freshness"},"DeployToRailwayResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"deployment":{"additionalProperties":true,"type":"object","title":"Deployment"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","deployment","timestamp"],"title":"DeployToRailwayResponse","description":"Response for POST /railway-deployment/deploy."},"DeployVersionRequest":{"properties":{"deployment_strategy":{"type":"string","title":"Deployment Strategy","description":"Deployment strategy (immediate, staged, canary, blue_green)","default":"staged"},"deployment_config":{"additionalProperties":true,"type":"object","title":"Deployment Config","description":"Additional deployment configuration"}},"type":"object","title":"DeployVersionRequest"},"DeployVersionResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"DeployVersionResponse","description":"Response for POST /versions/{version_id}/deploy -- open\npassthrough, see CreateABTestResponse docstring."},"DeploymentComparisonResponse":{"properties":{"status":{"type":"string","title":"Status"},"deployment1":{"$ref":"#/components/schemas/DeploymentComparisonSide"},"deployment2":{"$ref":"#/components/schemas/DeploymentComparisonSide"},"summary":{"$ref":"#/components/schemas/DeploymentComparisonSummary"},"config_differences":{"$ref":"#/components/schemas/DictDiff"},"artifact_differences":{"$ref":"#/components/schemas/ArtifactDiff"}},"type":"object","required":["status","deployment1","deployment2","summary","config_differences","artifact_differences"],"title":"DeploymentComparisonResponse","description":"Response for GET /compare."},"DeploymentComparisonSide":{"properties":{"id":{"title":"Id"},"environment_id":{"title":"Environment Id"},"environment_name":{"type":"string","title":"Environment Name"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"commit_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commit Hash"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","environment_id","environment_name"],"title":"DeploymentComparisonSide"},"DeploymentComparisonSummary":{"properties":{"same_environment":{"type":"boolean","title":"Same Environment"},"newer_deployment":{"type":"string","title":"Newer Deployment"},"version_change":{"type":"boolean","title":"Version Change"},"commit_change":{"type":"boolean","title":"Commit Change"},"config_differences":{"type":"integer","title":"Config Differences"},"artifact_differences":{"type":"integer","title":"Artifact Differences"}},"type":"object","required":["same_environment","newer_deployment","version_change","commit_change","config_differences","artifact_differences"],"title":"DeploymentComparisonSummary"},"DeploymentConfigurationEnvironment":{"properties":{"id":{"title":"Id"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"}},"type":"object","required":["id","name","type"],"title":"DeploymentConfigurationEnvironment"},"DeploymentConfigurationResponse":{"properties":{"status":{"type":"string","title":"Status"},"deployment_id":{"title":"Deployment Id"},"environment":{"$ref":"#/components/schemas/DeploymentConfigurationEnvironment"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"commit_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commit Hash"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"base_config":{"additionalProperties":true,"type":"object","title":"Base Config"},"config_overrides":{"additionalProperties":true,"type":"object","title":"Config Overrides"},"merged_config":{"additionalProperties":true,"type":"object","title":"Merged Config"},"artifacts":{"items":{},"type":"array","title":"Artifacts"}},"type":"object","required":["status","deployment_id","environment"],"title":"DeploymentConfigurationResponse","description":"Response for GET /configuration/{deployment_id} and\nPUT /configuration/{deployment_id} (update returns a smaller shape --\nsee DeploymentConfigurationUpdateResponse)."},"DeploymentConfigurationUpdateResponse":{"properties":{"status":{"type":"string","title":"Status"},"deployment_id":{"title":"Deployment Id"},"environment":{"$ref":"#/components/schemas/DeploymentConfigurationEnvironment"},"message":{"type":"string","title":"Message"}},"type":"object","required":["status","deployment_id","environment","message"],"title":"DeploymentConfigurationUpdateResponse","description":"Response for PUT /configuration/{deployment_id}."},"DeploymentDetailsResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"status":{"type":"string","title":"Status"},"version":{"type":"string","title":"Version"},"environment":{"type":"string","title":"Environment"},"timestamp":{"type":"string","title":"Timestamp"},"commit_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commit Hash"},"deploy_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Deploy Duration Seconds"},"health_checks_passed":{"type":"boolean","title":"Health Checks Passed"},"rollback_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rollback Reason"},"deployment_logs":{"items":{"type":"string"},"type":"array","title":"Deployment Logs"},"performance_baseline":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Performance Baseline"}},"type":"object","required":["deployment_id","status","version","environment","timestamp","health_checks_passed","deployment_logs"],"title":"DeploymentDetailsResponse","description":"GET /deployment/deployments/{deployment_id} — one deployment's full record."},"DeploymentDurationStatistics":{"properties":{"min_duration_seconds":{"type":"number","title":"Min Duration Seconds"},"max_duration_seconds":{"type":"number","title":"Max Duration Seconds"},"avg_duration_seconds":{"type":"number","title":"Avg Duration Seconds"},"median_duration_seconds":{"type":"number","title":"Median Duration Seconds"},"p90_duration_seconds":{"type":"number","title":"P90 Duration Seconds"},"p95_duration_seconds":{"type":"number","title":"P95 Duration Seconds"}},"type":"object","required":["min_duration_seconds","max_duration_seconds","avg_duration_seconds","median_duration_seconds","p90_duration_seconds","p95_duration_seconds"],"title":"DeploymentDurationStatistics"},"DeploymentEnvironment":{"type":"string","enum":["development","staging","production"],"title":"DeploymentEnvironment","description":"Railway deployment environments"},"DeploymentEnvironmentInfo":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"created_at":{"title":"Created At"}},"type":"object","required":["id","name","type"],"title":"DeploymentEnvironmentInfo"},"DeploymentHealthHistoryResponse":{"properties":{"entity_type":{"type":"string","title":"Entity Type"},"entity_id":{"type":"string","title":"Entity Id"},"stages":{"items":{"$ref":"#/components/schemas/DeploymentHealthStageResponse"},"type":"array","title":"Stages","description":"Stage reports ordered by created_at ASC"},"total":{"type":"integer","title":"Total","description":"Number of stage reports returned"}},"type":"object","required":["entity_type","entity_id","total"],"title":"DeploymentHealthHistoryResponse","description":"Accumulated stage history for one entity, oldest first."},"DeploymentHealthStageReportRequest":{"properties":{"stage":{"type":"string","maxLength":128,"minLength":1,"title":"Stage","description":"Name of the pipeline stage being reported, e.g. 'implement', 'coverage', 'merge', 'deploy'. Open string - consumers define their own stage vocabulary."},"status":{"type":"string","enum":["ok","failed","skipped"],"title":"Status","description":"Outcome of this stage. One of: ok, failed, skipped."},"reason":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}],"title":"Reason","description":"Human-readable explanation, most useful when status is 'failed' or 'skipped' (e.g. 'RAILWAY_DEPLOY_ENABLED is off')."},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Arbitrary caller-supplied structured detail for this stage."}},"type":"object","required":["stage","status"],"title":"DeploymentHealthStageReportRequest","description":"Body for POST /deployment-health/{entity_type}/{entity_id}."},"DeploymentHealthStageResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Stable UUID for this stage report"},"entity_type":{"type":"string","title":"Entity Type","description":"Caller's entity type"},"entity_id":{"type":"string","title":"Entity Id","description":"Caller's own id for the entity"},"stage":{"type":"string","title":"Stage","description":"Stage name as reported"},"status":{"type":"string","title":"Status","description":"One of: ok, failed, skipped"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Explanation, if provided"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Structured detail, if provided"},"user_id":{"type":"string","title":"User Id","description":"Owning AINative user id"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"ISO-8601 creation timestamp"}},"type":"object","required":["id","entity_type","entity_id","stage","status","user_id","created_at"],"title":"DeploymentHealthStageResponse","description":"One recorded stage report."},"DeploymentHealthStatus":{"properties":{"overall_health":{"type":"string","title":"Overall Health"},"deployment_pipeline":{"type":"string","title":"Deployment Pipeline"},"monitoring_systems":{"type":"string","title":"Monitoring Systems"},"rollback_capability":{"type":"string","title":"Rollback Capability"}},"type":"object","required":["overall_health","deployment_pipeline","monitoring_systems","rollback_capability"],"title":"DeploymentHealthStatus"},"DeploymentLogsResponse":{"properties":{"status":{"type":"string","title":"Status"},"logs":{"additionalProperties":true,"type":"object","title":"Logs"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","logs","timestamp"],"title":"DeploymentLogsResponse","description":"Response for GET /railway-deployment/deployment/{deployment_id}/logs."},"DeploymentMetricsTimeSeriesEntry":{"properties":{"time_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Period"},"total_deployments":{"type":"integer","title":"Total Deployments"},"completed_deployments":{"type":"integer","title":"Completed Deployments"},"failed_deployments":{"type":"integer","title":"Failed Deployments"},"canceled_deployments":{"type":"integer","title":"Canceled Deployments"},"success_rate":{"type":"number","title":"Success Rate"},"avg_duration_seconds":{"type":"number","title":"Avg Duration Seconds"}},"type":"object","required":["total_deployments","completed_deployments","failed_deployments","canceled_deployments","success_rate","avg_duration_seconds"],"title":"DeploymentMetricsTimeSeriesEntry"},"DeploymentProbeResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Deployment marker message"},"commit":{"type":"string","title":"Commit","description":"Commit short SHA the marker was written for"},"categories_trending_position":{"type":"string","title":"Categories Trending Position","description":"Route-ordering marker for /categories/trending"},"timestamp":{"type":"string","title":"Timestamp","description":"Server time at request, ISO-8601"}},"type":"object","required":["message","commit","categories_trending_position","timestamp"],"title":"DeploymentProbeResponse","description":"Static deployment-version probe payload (GET /streams/test-deployment).\n\nUnauthenticated diagnostic route - no user data, no permission filter.","example":{"categories_trending_position":"BEFORE by-slug","commit":"8f4bcffc","message":"Route ordering fix deployed","timestamp":"2026-10-13T22:53:07.214000"}},"DeploymentRequest":{"properties":{"version":{"type":"string","title":"Version"},"environment":{"type":"string","title":"Environment"},"commit_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commit Hash"}},"type":"object","required":["version","environment"],"title":"DeploymentRequest","description":"Request model for recording a new deployment"},"DeploymentStatus":{"type":"string","enum":["pending","building","deploying","deployed","failed","rolled_back"],"title":"DeploymentStatus","description":"Railway deployment status"},"DeploymentStatusSummaryResponse":{"properties":{"status":{"type":"string","title":"Status"},"environment_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Environment Id"},"environment_info":{"anyOf":[{"$ref":"#/components/schemas/DeploymentEnvironmentInfo"},{"type":"null"}]},"period_days":{"type":"integer","title":"Period Days"},"total_deployments":{"type":"integer","title":"Total Deployments"},"status_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Status Counts"},"success_rate":{"type":"number","title":"Success Rate"},"recent_deployments":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recent Deployments"}},"type":"object","required":["status","period_days","total_deployments","status_counts","success_rate"],"title":"DeploymentStatusSummaryResponse","description":"Response for GET /status/summary."},"DeploymentStrategy":{"type":"string","enum":["blue_green","rolling","canary","immediate"],"title":"DeploymentStrategy","description":"Railway deployment strategies"},"DeploymentWebhookResponse":{"properties":{"webhook_id":{"type":"string","title":"Webhook Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"active":{"type":"boolean","title":"Active","default":true},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["webhook_id","url","events"],"title":"DeploymentWebhookResponse"},"DeploymentsDashboardResponse":{"properties":{"active_deployments":{"items":{"$ref":"#/components/schemas/ActiveDeploymentSummary"},"type":"array","title":"Active Deployments"},"recent_deployments":{"items":{"$ref":"#/components/schemas/RecentDeploymentDetail"},"type":"array","title":"Recent Deployments"},"deployment_statistics":{"$ref":"#/components/schemas/app__schemas__admin__rlhf_simple_dashboard__DeploymentStatistics"},"rollback_history":{"items":{"$ref":"#/components/schemas/RollbackHistoryItem"},"type":"array","title":"Rollback History"},"health_status":{"$ref":"#/components/schemas/DeploymentHealthStatus"}},"type":"object","required":["active_deployments","recent_deployments","deployment_statistics","rollback_history","health_status"],"title":"DeploymentsDashboardResponse","description":"Response for GET /dashboard/deployments."},"DepositRequest":{"properties":{"bank_account_id":{"type":"string","format":"uuid","title":"Bank Account Id","description":"Bank account ID to deposit from"},"amount":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"string"}],"title":"Amount","description":"Amount to deposit in USD"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description","description":"Optional transaction description"}},"type":"object","required":["bank_account_id","amount"],"title":"DepositRequest","description":"Schema for deposit money request"},"DestroyStateResponse":{"properties":{"status":{"type":"string","title":"Status"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"tables_deleted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tables Deleted"},"rows_deleted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Deleted"},"destroyed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destroyed At"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"DestroyStateResponse","description":"agent_zerodb_state_service.destroy_state()"},"DetailedBulkOperationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"success_count":{"type":"integer","title":"Success Count"},"failed_count":{"type":"integer","title":"Failed Count"},"total_count":{"type":"integer","title":"Total Count"},"errors":{"anyOf":[{"items":{"$ref":"#/components/schemas/BulkOperationError"},"type":"array"},{"type":"null"}],"title":"Errors"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","success_count","failed_count","total_count","message"],"title":"DetailedBulkOperationResponse","description":"Schema for detailed bulk operation response with partial success support.\n\nThis response includes:\n- success: Overall operation success (true if at least some items succeeded)\n- success_count: Number of successfully processed items\n- failed_count: Number of failed items\n- total_count: Total items in the request\n- errors: List of errors for failed items (if any)\n- message: Human-readable summary message","example":{"errors":[{"error":"User not found","index":5,"item_id":"invalid-uuid"},{"error":"Notification not found","index":12,"item_id":"123e4567-e89b-12d3-a456-426614174999"}],"failed_count":2,"message":"Successfully processed 48 out of 50 notifications. 2 failed.","success":true,"success_count":48,"total_count":50}},"DeveloperAnalyticsResponse":{"properties":{"total_requests":{"type":"integer","title":"Total Requests"},"error_rate":{"type":"number","title":"Error Rate"},"avg_latency_ms":{"type":"number","title":"Avg Latency Ms"},"error_rate_over_time":{"items":{"$ref":"#/components/schemas/ErrorRatePoint"},"type":"array","title":"Error Rate Over Time"},"error_breakdown":{"items":{"$ref":"#/components/schemas/ErrorBreakdownEntry"},"type":"array","title":"Error Breakdown"},"period_start":{"type":"string","title":"Period Start"},"period_end":{"type":"string","title":"Period End"}},"type":"object","required":["total_requests","error_rate","avg_latency_ms","error_rate_over_time","error_breakdown","period_start","period_end"],"title":"DeveloperAnalyticsResponse","description":"Developer analytics overview: error rates, latency, breakdown."},"DeveloperDashboardStats":{"properties":{"api_keys":{"type":"integer","title":"Api Keys","description":"Number of active API keys"},"projects":{"type":"integer","title":"Projects","description":"Number of projects owned by the user"},"ai_requests_30d":{"type":"integer","title":"Ai Requests 30D","description":"AI usage log entries in the last 30 days"},"webhooks":{"type":"integer","title":"Webhooks","description":"Number of active webhooks"},"documents":{"type":"integer","title":"Documents","description":"Number of documents owned by the user"},"organizations":{"type":"integer","title":"Organizations","description":"Number of organizations the user belongs to"},"stats_partial":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Stats Partial","description":"True if one or more counts above failed to compute and were defaulted to 0 (only present on the success path, not the outer exception fallback)."},"account_created":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Created","description":"ISO timestamp the account was created"},"plan":{"type":"string","title":"Plan","description":"Developer plan name"},"status":{"type":"string","title":"Status","description":"Account status, e.g. 'active' or 'inactive'"}},"type":"object","required":["api_keys","projects","ai_requests_30d","webhooks","documents","organizations","plan","status"],"title":"DeveloperDashboardStats","description":"Aggregate usage/account stats for the current developer."},"DeveloperExpertiseEntry":{"properties":{"component":{"type":"string","title":"Component"},"commits":{"type":"integer","title":"Commits"},"expertise_percentage":{"type":"number","title":"Expertise Percentage"}},"type":"object","required":["component","commits","expertise_percentage"],"title":"DeveloperExpertiseEntry"},"DeveloperLogEntry":{"properties":{"id":{"type":"string","title":"Id"},"timestamp":{"type":"string","title":"Timestamp"},"endpoint":{"type":"string","title":"Endpoint"},"method":{"type":"string","title":"Method"},"status_code":{"type":"integer","title":"Status Code"},"latency_ms":{"type":"number","title":"Latency Ms"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["id","timestamp","endpoint","method","status_code","latency_ms"],"title":"DeveloperLogEntry","description":"A single request log row."},"DeveloperLogsResponse":{"properties":{"logs":{"items":{"$ref":"#/components/schemas/DeveloperLogEntry"},"type":"array","title":"Logs"},"pagination":{"$ref":"#/components/schemas/LogsPagination"}},"type":"object","required":["logs","pagination"],"title":"DeveloperLogsResponse","description":"Paginated developer request logs."},"DeveloperMarkupRequest":{"properties":{"developer_markup":{"type":"number","maximum":40,"minimum":0,"title":"Developer Markup","description":"Developer markup percentage (0-40%)"}},"type":"object","required":["developer_markup"],"title":"DeveloperMarkupRequest","description":"Request schema for updating developer markup"},"DeveloperResult":{"properties":{"repos":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Repos"},"influence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Influence Score"},"graph_connections":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Graph Connections"},"total_repos":{"type":"integer","title":"Total Repos","default":0},"source":{"type":"string","title":"Source","default":"lakehouse"},"historical_data":{"items":{},"type":"array","title":"Historical Data"}},"type":"object","title":"DeveloperResult"},"DeviceInfo":{"properties":{"device_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Type"},"browser":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Browser"},"os":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Os"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"}},"type":"object","title":"DeviceInfo","description":"Device and browser information"},"DeviceType":{"type":"string","enum":["desktop","mobile","tablet","unknown"],"title":"DeviceType","description":"Device types for tracking"},"DictDiff":{"properties":{"added":{"additionalProperties":true,"type":"object","title":"Added"},"removed":{"additionalProperties":true,"type":"object","title":"Removed"},"modified":{"additionalProperties":true,"type":"object","title":"Modified"}},"type":"object","title":"DictDiff"},"DimensionItem":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","title":"DimensionItem"},"DirectProvider":{"properties":{"provider":{"type":"string","title":"Provider"},"base_url":{"type":"string","title":"Base Url"},"api_key":{"type":"string","title":"Api Key"},"models":{"items":{"type":"string"},"type":"array","title":"Models"},"rpm_limit":{"type":"integer","title":"Rpm Limit","default":0},"supports_tools":{"type":"boolean","title":"Supports Tools","default":true}},"type":"object","required":["provider","base_url","api_key","models"],"title":"DirectProvider","description":"Direct inference endpoint — CLI calls this URL instead of AINative API.\nCuts ~1.5s latency by bypassing the gateway + backend proxy layer."},"DisableDatabaseResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"database_enabled":{"type":"boolean","title":"Database Enabled"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","database_enabled","message"],"title":"DisableDatabaseResponse"},"DisasterRecoveryCapability":{"properties":{"available":{"type":"boolean","title":"Available"},"rpo_minutes":{"type":"integer","title":"Rpo Minutes"},"rto_hours":{"type":"integer","title":"Rto Hours"},"geographical_backup":{"type":"boolean","title":"Geographical Backup"}},"type":"object","required":["available","rpo_minutes","rto_hours","geographical_backup"],"title":"DisasterRecoveryCapability"},"DisasterRiskAssessment":{"properties":{"overall_risk":{"type":"string","title":"Overall Risk"},"risk_factors":{"additionalProperties":{"$ref":"#/components/schemas/RiskFactor"},"type":"object","title":"Risk Factors"},"recovery_readiness":{"type":"integer","title":"Recovery Readiness"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["overall_risk","risk_factors","recovery_readiness","recommendations"],"title":"DisasterRiskAssessment"},"DisconnectResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"DisconnectResponse"},"DiscoveredCapability":{"properties":{"source":{"type":"string","title":"Source","description":"Where it was found: openapi, ai-plugin, agent-md, html"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint"}},"type":"object","required":["source","name","description"],"title":"DiscoveredCapability","description":"A capability discovered from scanning a business URL."},"DiskMetrics":{"properties":{"total_gb":{"type":"number","title":"Total Gb"},"free_gb":{"type":"number","title":"Free Gb"},"used_gb":{"type":"number","title":"Used Gb"},"usage_percent":{"type":"number","title":"Usage Percent"}},"type":"object","required":["total_gb","free_gb","used_gb","usage_percent"],"title":"DiskMetrics"},"DiskSpaceHealth":{"properties":{"free_gb":{"type":"number","title":"Free Gb"},"used_percent":{"type":"number","title":"Used Percent"},"status":{"type":"string","title":"Status"}},"type":"object","required":["free_gb","used_percent","status"],"title":"DiskSpaceHealth"},"DocSource":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","title":"Url"},"score":{"type":"number","title":"Score"}},"type":"object","required":["title","url","score"],"title":"DocSource"},"DocumentFile":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"folder_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Folder Id"},"file_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Id"},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"uploaded_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uploaded By"},"uploaded_by_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uploaded By Name"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"vendor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","title":"DocumentFile"},"DocumentResponse":{"properties":{"title":{"type":"string","title":"Title"},"content_type":{"type":"string","title":"Content Type"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"status":{"type":"string","title":"Status","default":"active"},"id":{"type":"string","title":"Id"},"organization_id":{"type":"string","title":"Organization Id"},"created_by":{"type":"string","title":"Created By"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["title","content_type","id","organization_id","created_by","created_at"],"title":"DocumentResponse","description":"Document API response schema"},"DocumentUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","title":"DocumentUpdate","description":"Document update schema"},"DocumentationAnalyticsResponse":{"properties":{"timeframe":{"type":"string","title":"Timeframe"},"category":{"type":"string","title":"Category"},"usage_metrics":{"additionalProperties":true,"type":"object","title":"Usage Metrics"},"content_performance":{"additionalProperties":true,"type":"object","title":"Content Performance"},"user_behavior":{"additionalProperties":true,"type":"object","title":"User Behavior"},"search_insights":{"additionalProperties":true,"type":"object","title":"Search Insights"},"feedback_analysis":{"additionalProperties":true,"type":"object","title":"Feedback Analysis"},"content_recommendations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Content Recommendations"}},"type":"object","required":["timeframe","category","usage_metrics","content_performance","user_behavior","search_insights","feedback_analysis","content_recommendations"],"title":"DocumentationAnalyticsResponse","description":"Response for GET /help-documentation/analytics."},"DocumentationCategoriesResponse":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/DocumentationCategoryEntry"},"type":"array","title":"Categories"},"total_categories":{"type":"integer","title":"Total Categories"}},"type":"object","required":["categories","total_categories"],"title":"DocumentationCategoriesResponse","description":"Response for GET /help-documentation/categories."},"DocumentationCategoryEntry":{"properties":{"category":{"type":"string","title":"Category"},"display_name":{"type":"string","title":"Display Name"},"description":{"type":"string","title":"Description"},"content_count":{"type":"integer","title":"Content Count"},"popular_content":{"items":{"type":"string"},"type":"array","title":"Popular Content"},"last_updated":{"type":"string","title":"Last Updated"}},"type":"object","required":["category","display_name","description","content_count","popular_content","last_updated"],"title":"DocumentationCategoryEntry"},"DocumentationCreate":{"properties":{"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"doc_type":{"$ref":"#/components/schemas/DocumentationType"},"category":{"$ref":"#/components/schemas/HelpCategory"},"format":{"$ref":"#/components/schemas/ContentFormat","default":"markdown"},"target_role":{"$ref":"#/components/schemas/app__api__admin__help_documentation__UserRole","default":"beginner"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"is_public":{"type":"boolean","title":"Is Public","default":true}},"type":"object","required":["title","content","doc_type","category"],"title":"DocumentationCreate"},"DocumentationDetailResponse":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"title":{"type":"string","title":"Title"},"related_content":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Related Content"},"comments":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Comments"},"edit_history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Edit History"},"analytics":{"additionalProperties":true,"type":"object","title":"Analytics"}},"additionalProperties":true,"type":"object","required":["doc_id","title","related_content","comments","edit_history","analytics"],"title":"DocumentationDetailResponse","description":"Response for GET /help-documentation/content/{doc_id}.\n\nThis is the stored document dict spread with extra keys\n(related_content/comments/edit_history/analytics) — modeled loosely\nsince the base document's own fields vary by document."},"DocumentationType":{"type":"string","enum":["user_guide","api_reference","tutorial","faq","troubleshooting","changelog","admin_guide"],"title":"DocumentationType","description":"Documentation types"},"DocumentationUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"doc_type":{"anyOf":[{"$ref":"#/components/schemas/DocumentationType"},{"type":"null"}]},"category":{"anyOf":[{"$ref":"#/components/schemas/HelpCategory"},{"type":"null"}]},"format":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}]},"target_role":{"anyOf":[{"$ref":"#/components/schemas/app__api__admin__help_documentation__UserRole"},{"type":"null"}]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"is_public":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Public"}},"type":"object","title":"DocumentationUpdate"},"DocumentsSummaryResponse":{"properties":{"folder_count":{"type":"integer","title":"Folder Count"},"file_count":{"type":"integer","title":"File Count"},"total_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Size Bytes"},"total_size_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Size Mb"},"summary_line":{"type":"string","title":"Summary Line"}},"type":"object","required":["folder_count","file_count","summary_line"],"title":"DocumentsSummaryResponse"},"DomainAllowlistEntry":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":1,"title":"Domain"},"added_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Added By"},"added_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Added At"}},"type":"object","required":["domain"],"title":"DomainAllowlistEntry"},"DomainAllowlistResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"domains":{"items":{"$ref":"#/components/schemas/DomainAllowlistEntry"},"type":"array","title":"Domains"},"platform_domains":{"items":{"type":"string"},"type":"array","title":"Platform Domains","description":"Platform-wide allowed domains"}},"type":"object","required":["agent_id","domains"],"title":"DomainAllowlistResponse"},"DomainCheckRequest":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":1,"title":"Domain"}},"type":"object","required":["domain"],"title":"DomainCheckRequest","description":"Request body for POST /api/v1/cloud/agents/{agent_id}/allowlist/check."},"DomainFulfillRequest":{"properties":{"session_id":{"type":"string","title":"Session Id","description":"Stripe Checkout session id from the return URL"}},"type":"object","required":["session_id"],"title":"DomainFulfillRequest"},"DomainFulfillResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"domain":{"type":"string","title":"Domain"},"slug":{"type":"string","title":"Slug"},"registered":{"type":"boolean","title":"Registered"},"register_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Register Error"},"dns":{"additionalProperties":true,"type":"object","title":"Dns"},"note":{"type":"string","title":"Note"},"idempotent_replay":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Idempotent Replay"}},"type":"object","required":["ok","domain","slug","registered","dns","note"],"title":"DomainFulfillResponse","description":"POST /domains/fulfill"},"DomainHealthResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"configured":{"type":"boolean","title":"Configured"},"egress_ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Egress Ip"},"ip_drift":{"type":"boolean","title":"Ip Drift","default":false},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"probe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Probe"},"checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checked At"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"pricing_feed":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pricing Feed"}},"type":"object","required":["ok","configured"],"title":"DomainHealthResponse"},"DomainPurchaseRequest":{"properties":{"domain":{"type":"string","title":"Domain","description":"Domain to buy, e.g. riffhub.io"},"slug":{"type":"string","title":"Slug","description":"Builder company slug to point the domain at"},"success_url":{"type":"string","title":"Success Url","description":"Where Stripe returns after payment"},"cancel_url":{"type":"string","title":"Cancel Url","description":"Where Stripe returns on cancel"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","required":["domain","slug","success_url","cancel_url"],"title":"DomainPurchaseRequest"},"DomainPurchaseResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"session_id":{"type":"string","title":"Session Id"},"amount":{"type":"number","title":"Amount"},"band":{"type":"string","title":"Band"}},"type":"object","required":["ok","session_id","amount","band"],"title":"DomainPurchaseResponse","description":"POST /domains/purchase"},"DomainRegisterRequest":{"properties":{"domain":{"type":"string","title":"Domain","description":"Fully-qualified domain, e.g. cadence.io"},"years":{"type":"integer","maximum":10,"minimum":1,"title":"Years","default":1},"confirm":{"type":"boolean","title":"Confirm","description":"Must be true to actually purchase","default":false}},"type":"object","required":["domain"],"title":"DomainRegisterRequest"},"DomainRegisterResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"years":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years"},"owner_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Id"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["ok"],"title":"DomainRegisterResponse","description":"POST /domains/register — either a real registration or a\nnot_confirmed guidance response (both 200, distinguished by `ok`)."},"DomainSuggestResponse":{"properties":{"brand":{"type":"string","title":"Brand"},"configured":{"type":"boolean","title":"Configured"},"suggestions":{"items":{"$ref":"#/components/schemas/DomainSuggestion"},"type":"array","title":"Suggestions"},"egress_ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Egress Ip"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["brand","configured","suggestions"],"title":"DomainSuggestResponse"},"DomainSuggestion":{"properties":{"domain":{"type":"string","title":"Domain"},"available":{"type":"boolean","title":"Available"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"wholesale":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Wholesale"}},"type":"object","required":["domain","available"],"title":"DomainSuggestion"},"DownloadFormat":{"type":"string","enum":["markdown","txt","json"],"title":"DownloadFormat","description":"Download file formats"},"DownloadLinkResponse":{"properties":{"document_id":{"type":"string","title":"Document Id"},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url"},"expires_in_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Seconds"}},"type":"object","required":["document_id"],"title":"DownloadLinkResponse"},"DrOperationEntry":{"properties":{"operation_id":{"type":"string","title":"Operation Id"},"type":{"type":"string","title":"Type"},"status":{"type":"string","title":"Status"},"started_at":{"type":"string","title":"Started At"},"completed_at":{"type":"string","title":"Completed At"},"duration_minutes":{"type":"integer","title":"Duration Minutes"}},"type":"object","required":["operation_id","type","status","started_at","completed_at","duration_minutes"],"title":"DrOperationEntry"},"DropOffPoint":{"properties":{"timestamp":{"type":"string","title":"Timestamp","description":"ISO 8601 timestamp when drop-off occurred"},"minute":{"type":"integer","minimum":0,"title":"Minute","description":"Minutes from stream start"},"viewers_lost":{"type":"integer","minimum":0,"title":"Viewers Lost","description":"Number of viewers lost"},"percentage_lost":{"type":"number","maximum":100,"minimum":0,"title":"Percentage Lost","description":"Percentage of viewers lost"}},"type":"object","required":["timestamp","minute","viewers_lost","percentage_lost"],"title":"DropOffPoint","description":"Significant viewer drop-off point","example":{"minute":35,"percentage_lost":18.4,"timestamp":"2025-12-23T14:35:00Z","viewers_lost":23}},"DryRunRequest":{"properties":{"jsonl":{"type":"string","title":"Jsonl","description":"Training data as JSONL (from /coding-data)"},"base_model":{"type":"string","title":"Base Model","description":"Base model for Phase 0","default":"qwen3-4b"},"min_examples":{"type":"integer","minimum":1,"title":"Min Examples","description":"Minimum valid examples required to proceed","default":1}},"type":"object","required":["jsonl"],"title":"DryRunRequest"},"DryRunResponse":{"properties":{"go":{"type":"boolean","title":"Go"},"blocker":{"type":"string","title":"Blocker"},"base_model":{"type":"string","title":"Base Model"},"dataset_examples":{"type":"integer","title":"Dataset Examples"},"estimated_cost_usd":{"type":"number","title":"Estimated Cost Usd"},"steps":{"items":{"$ref":"#/components/schemas/StepModel"},"type":"array","title":"Steps"}},"type":"object","required":["go","blocker","base_model","dataset_examples","estimated_cost_usd","steps"],"title":"DryRunResponse"},"EarningsBreakdownEntry":{"properties":{"total_cents":{"type":"integer","title":"Total Cents"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["total_cents","count"],"title":"EarningsBreakdownEntry","description":"One service_type line item inside the combined earnings breakdown."},"EarningsHistoryItem":{"properties":{"id":{"title":"Id"},"amount_cents":{"type":"integer","title":"Amount Cents"},"markup_percentage":{"type":"number","title":"Markup Percentage"},"status":{"type":"string","title":"Status"},"paid_out":{"type":"boolean","title":"Paid Out"},"payout_id":{"anyOf":[{},{"type":"null"}],"title":"Payout Id"},"created_at":{"title":"Created At"},"service_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Type"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","amount_cents","markup_percentage","status","paid_out","created_at"],"title":"EarningsHistoryItem"},"EarningsHistoryResponse":{"properties":{"earnings":{"items":{"$ref":"#/components/schemas/EarningsHistoryItem"},"type":"array","title":"Earnings"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["earnings","limit","offset","count"],"title":"EarningsHistoryResponse","description":"GET /developer/payouts/history, GET /developer/payouts/transactions\n(the latter is a page-based alias that delegates directly to the same\nhandler)."},"EarningsResponse":{"properties":{"total_earned_cents":{"type":"integer","title":"Total Earned Cents"},"unpaid_cents":{"type":"integer","title":"Unpaid Cents"},"paid_cents":{"type":"integer","title":"Paid Cents"},"paid_out_cents":{"type":"integer","title":"Paid Out Cents"},"total_transactions":{"type":"integer","title":"Total Transactions"},"average_per_transaction":{"type":"integer","title":"Average Per Transaction"},"eligible_for_payout":{"type":"boolean","title":"Eligible For Payout"},"minimum_threshold_cents":{"type":"integer","title":"Minimum Threshold Cents"},"this_month_cents":{"type":"integer","title":"This Month Cents","default":0},"last_month_cents":{"type":"integer","title":"Last Month Cents","default":0}},"type":"object","required":["total_earned_cents","unpaid_cents","paid_cents","paid_out_cents","total_transactions","average_per_transaction","eligible_for_payout","minimum_threshold_cents"],"title":"EarningsResponse","description":"Response for earnings data"},"EarningsSummaryResponse":{"properties":{"developer_id":{"type":"string","title":"Developer Id"},"period_start":{"type":"string","title":"Period Start"},"period_end":{"type":"string","title":"Period End"},"total_earned_cents":{"type":"integer","title":"Total Earned Cents"},"transaction_count":{"type":"integer","title":"Transaction Count"},"average_per_transaction_cents":{"type":"integer","title":"Average Per Transaction Cents"},"network_breakdown":{"additionalProperties":true,"type":"object","title":"Network Breakdown"}},"type":"object","required":["developer_id","period_start","period_end","total_earned_cents","transaction_count","average_per_transaction_cents","network_breakdown"],"title":"EarningsSummaryResponse","description":"X402 earnings summary for a developer."},"EdgeContradiction":{"properties":{"superseded_edge_id":{"type":"string","title":"Superseded Edge Id"},"old_target_id":{"type":"string","title":"Old Target Id"},"new_target_id":{"type":"string","title":"New Target Id"},"predicate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicate"}},"additionalProperties":true,"type":"object","required":["superseded_edge_id","old_target_id","new_target_id"],"title":"EdgeContradiction","description":"A superseded edge reported by create_edge's contradiction detection."},"EdgeFeedbackResponse":{"properties":{"edge_id":{"type":"string","title":"Edge Id"},"previous_confidence":{"type":"number","title":"Previous Confidence"},"new_confidence":{"type":"number","title":"New Confidence"},"action":{"type":"string","title":"Action"}},"additionalProperties":true,"type":"object","required":["edge_id","previous_confidence","new_confidence","action"],"title":"EdgeFeedbackResponse","description":"Response for POST /memory/v2/graph/feedback."},"EdgeItem":{"properties":{"source":{"type":"string","title":"Source"},"target":{"type":"string","title":"Target"},"relation":{"type":"string","title":"Relation"}},"type":"object","required":["source","target","relation"],"title":"EdgeItem"},"EgressLogEntry":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"method":{"type":"string","title":"Method"},"url":{"type":"string","title":"Url"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Status Code"},"credential_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential Id"},"credential_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential Name"},"latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Latency Ms"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"created_at":{"type":"string","title":"Created At"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["id","agent_id","method","url","created_at","timestamp"],"title":"EgressLogEntry"},"EgressLogListResponse":{"properties":{"logs":{"items":{"$ref":"#/components/schemas/EgressLogEntry"},"type":"array","title":"Logs"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["logs","total"],"title":"EgressLogListResponse"},"EgressRequest":{"properties":{"agent_id":{"type":"string","maxLength":255,"minLength":1,"title":"Agent Id"},"method":{"type":"string","title":"Method","description":"HTTP method (GET, POST, PUT, DELETE, PATCH)"},"url":{"type":"string","maxLength":2048,"minLength":1,"title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers"},"body":{"anyOf":[{"type":"string","maxLength":1048576},{"type":"null"}],"title":"Body","description":"Request body (max 1 MB)"},"credential_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential Id","description":"Credential to inject from vault"},"timeout_seconds":{"type":"integer","maximum":120,"minimum":1,"title":"Timeout Seconds","default":30}},"type":"object","required":["agent_id","method","url"],"title":"EgressRequest","description":"Request body for POST /api/v1/cloud/egress/request."},"EgressResponse":{"properties":{"status_code":{"type":"integer","title":"Status Code"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"request_id":{"type":"string","title":"Request Id"},"latency_ms":{"type":"integer","title":"Latency Ms"}},"type":"object","required":["status_code","request_id","latency_ms"],"title":"EgressResponse","description":"Proxied response returned to the agent."},"EligibilityListResponse":{"properties":{"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"EligibilityListResponse"},"EligibilityResponse":{"properties":{"eligible":{"type":"boolean","title":"Eligible"}},"type":"object","required":["eligible"],"title":"EligibilityResponse","description":"Schema for eligibility check response."},"EmailCollectionResponse":{"properties":{"stored":{"type":"boolean","title":"Stored"}},"type":"object","required":["stored"],"title":"EmailCollectionResponse","description":"Always 200 by design (Refs #6306) — ``stored`` is the only signal\nthe caller gets that the write actually succeeded."},"EmailPreferencesResponse":{"properties":{"marketing_emails":{"type":"boolean","title":"Marketing Emails","default":false},"product_updates":{"type":"boolean","title":"Product Updates","default":true},"security_alerts":{"type":"boolean","title":"Security Alerts","default":true},"marketing_consent_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Consent At"}},"type":"object","title":"EmailPreferencesResponse","description":"Response schema for email preferences."},"EmailPreferencesUpdate":{"properties":{"marketing_emails":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Marketing Emails","description":"Opt-in to marketing emails. Requires explicit consent (GDPR)."},"product_updates":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Product Updates","description":"Receive product update emails."},"security_alerts":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Security Alerts","description":"Security alerts. Server enforces this to always be True."}},"type":"object","title":"EmailPreferencesUpdate","description":"Request schema for updating email preferences."},"EmailProviderInfo":{"properties":{"name":{"type":"string","title":"Name"},"display_name":{"type":"string","title":"Display Name"},"description":{"type":"string","title":"Description"},"required_config":{"items":{"type":"string"},"type":"array","title":"Required Config"}},"additionalProperties":true,"type":"object","required":["name","display_name","description","required_config"],"title":"EmailProviderInfo"},"EmailProvidersListResponse":{"properties":{"providers":{"items":{"$ref":"#/components/schemas/EmailProviderInfo"},"type":"array","title":"Providers"}},"type":"object","required":["providers"],"title":"EmailProvidersListResponse","description":"GET /v1/emails/providers"},"EmailServiceHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"provider":{"type":"string","title":"Provider"},"configured":{"type":"boolean","title":"Configured"},"from_email":{"type":"string","title":"From Email"},"features":{"items":{"type":"string"},"type":"array","title":"Features"}},"type":"object","required":["status","provider","configured","from_email","features"],"title":"EmailServiceHealthResponse","description":"GET /v1/emails/health"},"EmailSubmission":{"properties":{"email":{"type":"string","title":"Email"},"source":{"type":"string","title":"Source","default":"cody-cli"},"version":{"type":"string","title":"Version","default":"unknown"}},"type":"object","required":["email"],"title":"EmailSubmission"},"EmailTestProviderResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"provider":{"type":"string","title":"Provider"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","provider","message"],"title":"EmailTestProviderResponse","description":"POST /v1/emails/test-provider"},"EmailVerificationRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"EmailVerificationRequest","description":"Schema for email verification request"},"EmailVerifyRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"EmailVerifyRequest","description":"Request body for email verification"},"EmbedChunkRequest":{"properties":{"chunk_id":{"type":"string","title":"Chunk Id","description":"ID of the chunk to embed"}},"type":"object","required":["chunk_id"],"title":"EmbedChunkRequest"},"EmbedChunkResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Service status"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project ID"},"chunk_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chunk Id","description":"Chunk that was embedded"},"embedding_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Embedding Id","description":"Stored embedding ID"},"dimensions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dimensions","description":"Embedding dimensionality"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Embedding model used"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message when status=error"}},"additionalProperties":true,"type":"object","required":["status"],"title":"EmbedChunkResponse","description":"Result of embedding a single chunk."},"EmbedFileChunksResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Service status"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project ID"},"file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Path","description":"File whose chunks were embedded"},"total_chunks":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Chunks","description":"Chunks embedded"},"embeddings":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Embeddings","description":"Per-chunk embedding records"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Embedding model used"},"dimensions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dimensions","description":"Embedding dimensionality"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message when status=error"}},"additionalProperties":true,"type":"object","required":["status"],"title":"EmbedFileChunksResponse","description":"Result of embedding every chunk in a file."},"EmbedFileRequest":{"properties":{"file_path":{"type":"string","title":"File Path","description":"Path to the file"}},"type":"object","required":["file_path"],"title":"EmbedFileRequest"},"EmbeddingUsageResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"embeddings_generated_today":{"type":"integer","title":"Embeddings Generated Today"},"embeddings_generated_month":{"type":"integer","title":"Embeddings Generated Month"},"cost_today_usd":{"type":"number","title":"Cost Today Usd"},"cost_month_usd":{"type":"number","title":"Cost Month Usd"},"model":{"type":"string","title":"Model"},"service":{"type":"string","title":"Service"}},"type":"object","required":["user_id","embeddings_generated_today","embeddings_generated_month","cost_today_usd","cost_month_usd","model","service"],"title":"EmbeddingUsageResponse","description":"Embedding usage counters.\n\nCounters are hardcoded to 0 pending real tracking (the handler's own TODO);\nthe shape is pinned here so adding tracking later cannot silently change\nthe contract. Refs #8449."},"EmbeddingsHealthResponse":{"properties":{"status":{"type":"string","title":"Status","description":"healthy | degraded | unhealthy"},"url":{"type":"string","title":"Url","description":"Configured embedding service base URL"},"embedding_service":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Embedding Service","description":"Upstream /health body (healthy branch only)"},"cost_per_embedding":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cost Per Embedding","description":"Per-embedding cost (healthy branch only)"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Failure detail (degraded/unhealthy branches only)"}},"type":"object","required":["status","url"],"title":"EmbeddingsHealthResponse","description":"Health of the upstream embedding service.\n\n`embeddings_health_check` has THREE returns with DIFFERENT key sets:\n healthy -> status, embedding_service, url, cost_per_embedding\n degraded -> status, message, url\n unhealthy -> status, message, url\n\nOnly `status` and `url` are common to all three, so every branch-specific\nfield is Optional AND the route is declared with\n`response_model_exclude_unset=True`. Without exclude_unset, FastAPI would\nemit null placeholders for the keys a branch never set — adding\n`message: null` to healthy responses and\n`embedding_service: null, cost_per_embedding: null` to failure responses.\nThat is a response-shape change, not a typing improvement. Refs #8449."},"EmitEventResponse":{"properties":{"status":{"type":"string","title":"Status"},"agent_id":{"type":"string","title":"Agent Id"},"event_type":{"type":"string","title":"Event Type"}},"type":"object","required":["status","agent_id","event_type"],"title":"EmitEventResponse","description":"Ack for POST /{agent_id}/events/emit (see emit_agent_event below)."},"EnableDatabaseResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"database_enabled":{"type":"boolean","title":"Database Enabled"},"config":{"additionalProperties":true,"type":"object","title":"Config"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","database_enabled","config","message"],"title":"EnableDatabaseResponse"},"EncryptDataRequest":{"properties":{"data":{"type":"string","title":"Data","description":"Data to encrypt"},"context_id":{"type":"string","title":"Context Id","description":"Context identifier"},"classification":{"type":"string","title":"Classification","description":"Security classification"}},"type":"object","required":["data","context_id","classification"],"title":"EncryptDataRequest","description":"Request to encrypt data"},"EncryptSensitiveDataResponse":{"properties":{"encrypted_payload":{"additionalProperties":{"type":"string"},"type":"object","title":"Encrypted Payload"},"encrypted_at":{"type":"string","title":"Encrypted At"}},"type":"object","required":["encrypted_payload","encrypted_at"],"title":"EncryptSensitiveDataResponse"},"EndpointPerformanceResponse":{"properties":{"endpoints":{"items":{"$ref":"#/components/schemas/EndpointPerformanceRow"},"type":"array","title":"Endpoints"},"summary":{"$ref":"#/components/schemas/EndpointPerformanceSummary"},"filters_applied":{"additionalProperties":true,"type":"object","title":"Filters Applied"}},"additionalProperties":true,"type":"object","required":["endpoints","summary","filters_applied"],"title":"EndpointPerformanceResponse","description":"GET /endpoints/performance."},"EndpointPerformanceRow":{"properties":{"endpoint":{"type":"string","title":"Endpoint"},"request_count":{"type":"integer","title":"Request Count"},"avg_response_time_ms":{"type":"number","title":"Avg Response Time Ms"},"error_rate":{"type":"number","title":"Error Rate"}},"additionalProperties":true,"type":"object","required":["endpoint","request_count","avg_response_time_ms","error_rate"],"title":"EndpointPerformanceRow","description":"One endpoint's aggregated performance."},"EndpointPerformanceSummary":{"properties":{"total_endpoints":{"type":"integer","title":"Total Endpoints"},"total_requests":{"type":"integer","title":"Total Requests"},"avg_response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Response Time Ms"},"total_errors":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Errors"},"overall_error_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overall Error Rate"}},"additionalProperties":true,"type":"object","required":["total_endpoints","total_requests"],"title":"EndpointPerformanceSummary","description":"Endpoint rollups.\n\nThe no-data branch returns ONLY total_endpoints/total_requests, so the\nother three fields are Optional and the route sets\nresponse_model_exclude_unset=True to avoid inventing null keys."},"EndpointValidationChecks":{"properties":{"syntax":{"type":"string","title":"Syntax"},"authentication":{"type":"string","title":"Authentication"},"authorization":{"type":"string","title":"Authorization"},"availability":{"type":"string","title":"Availability"}},"additionalProperties":false,"type":"object","required":["syntax","authentication","authorization","availability"],"title":"EndpointValidationChecks","description":"The per-check results of POST /agent-bridge/validate.\n\nClosed (extra=\"forbid\") for the same reason as\nBridgeUserPermissions: `authorization` carries the result of the\nhandler's admin check and must not be widened or defaulted."},"EndpointValidationRequest":{"properties":{"endpoint":{"type":"string","title":"Endpoint","description":"Endpoint path to validate"}},"type":"object","required":["endpoint"],"title":"EndpointValidationRequest"},"EndpointValidationRequirements":{"properties":{"authentication_required":{"type":"boolean","title":"Authentication Required"},"admin_role_required":{"type":"boolean","title":"Admin Role Required"},"user_has_access":{"type":"boolean","title":"User Has Access"}},"additionalProperties":false,"type":"object","required":["authentication_required","admin_role_required","user_has_access"],"title":"EndpointValidationRequirements","description":"The declared auth requirements of POST /agent-bridge/validate.\n\nClosed for the same reason: `user_has_access` is a permission result."},"EndpointValidationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/EndpointValidationResult"},"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["success","data","message"],"title":"EndpointValidationResponse","description":"Response for POST /agent-bridge/validate."},"EndpointValidationResult":{"properties":{"endpoint":{"type":"string","title":"Endpoint"},"valid":{"type":"boolean","title":"Valid"},"checks":{"$ref":"#/components/schemas/EndpointValidationChecks"},"requirements":{"$ref":"#/components/schemas/EndpointValidationRequirements"},"validated_at":{"type":"string","title":"Validated At"},"validated_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validated By"}},"additionalProperties":true,"type":"object","required":["endpoint","valid","checks","requirements","validated_at"],"title":"EndpointValidationResult","description":"The `data` payload of POST /agent-bridge/validate."},"EngagementMetrics":{"properties":{"stream_id":{"type":"string","format":"uuid","title":"Stream Id"},"new_followers_during_stream":{"type":"integer","minimum":0,"title":"New Followers During Stream","description":"New followers gained during stream"},"follow_conversion_rate":{"type":"number","maximum":100,"minimum":0,"title":"Follow Conversion Rate","description":"Percentage of viewers who followed"},"chat_participation_rate":{"type":"number","maximum":100,"minimum":0,"title":"Chat Participation Rate","description":"Percentage of viewers who chatted"},"average_messages_per_chatter":{"type":"number","minimum":0,"title":"Average Messages Per Chatter","description":"Average messages per active chatter"},"average_watch_time_minutes":{"type":"number","minimum":0,"title":"Average Watch Time Minutes","description":"Average watch time per viewer"},"median_watch_time_minutes":{"type":"number","minimum":0,"title":"Median Watch Time Minutes","description":"Median watch time per viewer"},"returning_viewer_rate":{"type":"number","maximum":100,"minimum":0,"title":"Returning Viewer Rate","description":"Percentage of viewers who have watched before"},"retention_curve":{"items":{"$ref":"#/components/schemas/RetentionPoint"},"type":"array","title":"Retention Curve","description":"Viewer retention over time"},"drop_off_points":{"items":{"$ref":"#/components/schemas/DropOffPoint"},"type":"array","title":"Drop Off Points","description":"Significant viewer drop-off moments"}},"type":"object","required":["stream_id","new_followers_during_stream","follow_conversion_rate","chat_participation_rate","average_messages_per_chatter","average_watch_time_minutes","median_watch_time_minutes","returning_viewer_rate"],"title":"EngagementMetrics","description":"Comprehensive engagement metrics for a stream","example":{"average_messages_per_chatter":7.8,"average_watch_time_minutes":45.3,"chat_participation_rate":35.6,"drop_off_points":[{"minute":35,"percentage_lost":18.4,"timestamp":"2025-12-23T14:35:00Z","viewers_lost":23}],"follow_conversion_rate":8.2,"median_watch_time_minutes":38,"new_followers_during_stream":42,"retention_curve":[{"minute":0,"retention_percentage":100,"viewer_count":120},{"minute":30,"retention_percentage":72.5,"viewer_count":87},{"minute":60,"retention_percentage":58.3,"viewer_count":70}],"returning_viewer_rate":23.5,"stream_id":"987e6543-e21b-12d3-a456-426614174000"}},"EngagementMetricsResponse":{"properties":{"video_id":{"type":"string","title":"Video Id"},"period_days":{"type":"integer","title":"Period Days"},"event_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Event Counts"},"total_users":{"type":"integer","title":"Total Users"},"avg_completion_percentage":{"type":"number","title":"Avg Completion Percentage"},"completed_views":{"type":"integer","title":"Completed Views"}},"type":"object","required":["video_id","period_days","event_counts","total_users","avg_completion_percentage","completed_views"],"title":"EngagementMetricsResponse","description":"Engagement metrics response"},"EnrichMemoryAsyncRequest":{"properties":{"url":{"type":"string","minLength":1,"title":"Url"},"project_id":{"type":"string","minLength":1,"title":"Project Id"},"memory_type":{"type":"string","title":"Memory Type","default":"semantic"},"extract_goal":{"type":"string","title":"Extract Goal","default":"Extract key facts and information"}},"type":"object","required":["url","project_id"],"title":"EnrichMemoryAsyncRequest"},"EnrichMemoryAsyncResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["task_id","status"],"title":"EnrichMemoryAsyncResponse"},"EnrichedSignup":{"properties":{"email":{"type":"string","title":"Email"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"lead_score":{"type":"integer","title":"Lead Score"},"signals":{"items":{"type":"string"},"type":"array","title":"Signals","default":[]},"enriched_at":{"type":"string","title":"Enriched At"}},"type":"object","required":["email","lead_score","enriched_at"],"title":"EnrichedSignup"},"EnsureProjectRequest":{"properties":{"repo_hash":{"type":"string","maxLength":64,"minLength":8,"title":"Repo Hash","description":"First 16 chars of SHA256(normalized git remote URL)","example":"a1b2c3d4e5f67890"},"repo_name":{"type":"string","maxLength":128,"minLength":1,"title":"Repo Name","description":"Human-readable project name (from directory or git remote)","example":"cody-cli"},"tier":{"type":"string","title":"Tier","description":"Project tier (free, pro, enterprise)","default":"free","example":"free"}},"type":"object","required":["repo_hash","repo_name"],"title":"EnsureProjectRequest"},"EnsureProjectResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"project":{"$ref":"#/components/schemas/EnsureProjectResult"}},"type":"object","required":["project"],"title":"EnsureProjectResponse"},"EnsureProjectResult":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"repo_hash":{"type":"string","title":"Repo Hash"},"tier":{"type":"string","title":"Tier"},"created":{"type":"boolean","title":"Created","description":"True if newly created, False if already existed"}},"type":"object","required":["id","name","repo_hash","tier","created"],"title":"EnsureProjectResult"},"EnterpriseAccountEntry":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"tier":{"type":"string","title":"Tier"},"status":{"type":"string","title":"Status"},"max_members":{"type":"integer","title":"Max Members"},"billing_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Email"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"org_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Name"},"member_count":{"type":"integer","title":"Member Count"}},"type":"object","required":["tenant_id","name","slug","tier","status","max_members","member_count"],"title":"EnterpriseAccountEntry"},"EnterpriseAuditLogEntry":{"properties":{"agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"summary":{"type":"string","title":"Summary"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["summary"],"title":"EnterpriseAuditLogEntry"},"EnterpriseUpgradeRequest":{"properties":{"user_email":{"type":"string","title":"User Email","description":"Email of the user to upgrade"},"org_name":{"type":"string","title":"Org Name","description":"Organization name (e.g., '8Genc')"},"org_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Slug","description":"URL slug (auto-generated from name if not provided)"},"tier":{"type":"string","title":"Tier","description":"Tier: free, pro, or enterprise","default":"enterprise"},"max_members":{"type":"integer","title":"Max Members","description":"Max members in the org","default":10},"max_storage_gb":{"type":"integer","title":"Max Storage Gb","description":"Max storage in GB","default":100},"billing_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Email","description":"Billing email (defaults to user email)"},"additional_members":{"items":{"type":"string"},"type":"array","title":"Additional Members","description":"Additional user emails to add as members","default":[]}},"type":"object","required":["user_email","org_name"],"title":"EnterpriseUpgradeRequest"},"EnterpriseUpgradeResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"user_id":{"type":"string","title":"User Id"},"user_email":{"type":"string","title":"User Email"},"tenant_id":{"type":"string","title":"Tenant Id"},"organization_id":{"type":"string","title":"Organization Id"},"org_name":{"type":"string","title":"Org Name"},"members_added":{"type":"integer","title":"Members Added"},"plan":{"type":"string","title":"Plan"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","user_id","user_email","tenant_id","organization_id","org_name","members_added","plan","message"],"title":"EnterpriseUpgradeResponse"},"EntitiesResponse":{"properties":{"entities":{"items":{"$ref":"#/components/schemas/EntityListItem"},"type":"array","title":"Entities"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["entities","count"],"title":"EntitiesResponse"},"EntityListItem":{"properties":{"name":{"type":"string","title":"Name"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"confidence":{"type":"number","title":"Confidence"},"memory_count":{"type":"integer","title":"Memory Count"}},"type":"object","required":["name","type","confidence","memory_count"],"title":"EntityListItem"},"EntityTimelineItem":{"properties":{"edge_id":{"type":"string","title":"Edge Id"},"predicate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicate"},"object":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Object"},"object_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Object Type"},"valid_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid From"},"valid_until":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid Until"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"source_memory_ids":{"title":"Source Memory Ids","description":"Raw evidence_ids text from entity_edges; shape is the stored JSON/array text, not a fixed structure."},"status":{"type":"string","title":"Status"}},"type":"object","required":["edge_id","predicate","object","object_type","valid_from","valid_until","confidence","source_memory_ids","status"],"title":"EntityTimelineItem"},"EntityTimelineResponse":{"properties":{"entity_id":{"type":"string","title":"Entity Id"},"entity_name":{"type":"string","title":"Entity Name"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"timeline":{"items":{"$ref":"#/components/schemas/EntityTimelineItem"},"type":"array","title":"Timeline"},"total_facts":{"type":"integer","title":"Total Facts"},"current_facts":{"type":"integer","title":"Current Facts"},"superseded_facts":{"type":"integer","title":"Superseded Facts"}},"type":"object","required":["entity_id","entity_name","entity_type","timeline","total_facts","current_facts","superseded_facts"],"title":"EntityTimelineResponse"},"EnvironmentDeregisterResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"status":{"type":"string","title":"Status","default":"deregistered"},"message":{"type":"string","title":"Message","default":"Environment successfully deregistered"}},"type":"object","required":["id"],"title":"EnvironmentDeregisterResponse"},"EnvironmentProvider":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"region":{"type":"string","title":"Region"},"available":{"type":"boolean","title":"Available"}},"type":"object","required":["provider_id","name","region","available"],"title":"EnvironmentProvider"},"EnvironmentProvidersResponse":{"properties":{"providers":{"items":{"$ref":"#/components/schemas/EnvironmentProvider"},"type":"array","title":"Providers"}},"type":"object","required":["providers"],"title":"EnvironmentProvidersResponse"},"EnvironmentReconnectResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"status":{"$ref":"#/components/schemas/EnvironmentStatusEnum"},"message":{"type":"string","title":"Message","default":"Environment reconnected"}},"type":"object","required":["id","status"],"title":"EnvironmentReconnectResponse"},"EnvironmentRegister":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"hostname":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Hostname"},"platform":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Platform"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["name"],"title":"EnvironmentRegister","description":"Register a new worker environment."},"EnvironmentResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"status":{"$ref":"#/components/schemas/EnvironmentStatusEnum"},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hostname"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"capabilities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Capabilities"},"last_heartbeat":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Heartbeat"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","user_id","status"],"title":"EnvironmentResponse"},"EnvironmentResult":{"properties":{"aqi":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Aqi"},"weather":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Weather"},"seismic":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Seismic"},"water_quality":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Water Quality"},"source":{"type":"string","title":"Source","default":"sensor_network"},"generated_at":{"type":"string","title":"Generated At","default":""},"historical_data":{"items":{},"type":"array","title":"Historical Data"}},"type":"object","title":"EnvironmentResult"},"EnvironmentStatusEnum":{"type":"string","enum":["online","offline","busy","error"],"title":"EnvironmentStatusEnum"},"ErrorAnalysisCreate":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID to associate with the error"},"error_message":{"type":"string","title":"Error Message","description":"The error message"},"error_type":{"type":"string","title":"Error Type","description":"The type or class of the error"},"stack_trace":{"type":"string","title":"Stack Trace","description":"Full stack trace of the error"},"source_code":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Source Code","description":"Source code files relevant to the error"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context","description":"Additional context about the error"},"occurrence":{"anyOf":[{"$ref":"#/components/schemas/ErrorOccurrence"},{"type":"null"}],"description":"Details about when/where the error occurred"}},"type":"object","required":["project_id","error_message","error_type","stack_trace"],"title":"ErrorAnalysisCreate","description":"Request model for creating an error analysis"},"ErrorAnalysisResponse":{"properties":{"analysis_id":{"type":"string","title":"Analysis Id","description":"Unique identifier for the analysis"},"project_id":{"type":"string","title":"Project Id","description":"Project ID associated with the error"},"error_message":{"type":"string","title":"Error Message","description":"The error message"},"error_type":{"type":"string","title":"Error Type","description":"The type or class of the error"},"category":{"type":"string","title":"Category","description":"Categorization of the error"},"severity":{"type":"string","title":"Severity","description":"Severity level of the error"},"root_cause":{"type":"string","title":"Root Cause","description":"Analysis of the root cause"},"suggestion":{"type":"string","title":"Suggestion","description":"Suggested fix or approach"},"stack_frames":{"items":{"$ref":"#/components/schemas/StackTraceFrame"},"type":"array","title":"Stack Frames","description":"Parsed stack trace frames"},"references":{"items":{"type":"string"},"type":"array","title":"References","description":"References to documentation or resources","default":[]},"similar_errors":{"items":{"type":"string"},"type":"array","title":"Similar Errors","description":"IDs of similar errors","default":[]},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the analysis was created"}},"type":"object","required":["analysis_id","project_id","error_message","error_type","category","severity","root_cause","suggestion","stack_frames","created_at"],"title":"ErrorAnalysisResponse","description":"Response model for an error analysis result"},"ErrorAnalysisSummary":{"properties":{"analysis_id":{"type":"string","title":"Analysis Id","description":"Unique identifier for the analysis"},"project_id":{"type":"string","title":"Project Id","description":"Project ID associated with the error"},"error_message":{"type":"string","title":"Error Message","description":"Brief error message"},"error_type":{"type":"string","title":"Error Type","description":"The type or class of the error"},"category":{"type":"string","title":"Category","description":"Categorization of the error"},"severity":{"type":"string","title":"Severity","description":"Severity level of the error"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the analysis was created"}},"type":"object","required":["analysis_id","project_id","error_message","error_type","category","severity","created_at"],"title":"ErrorAnalysisSummary","description":"Summary of an error analysis for listing"},"ErrorAnalyticsResponse":{"properties":{"errors":{"items":{},"type":"array","title":"Errors"},"error_rate":{"type":"number","title":"Error Rate"},"total_errors":{"type":"integer","title":"Total Errors"},"time_range":{"type":"string","title":"Time Range"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["errors","error_rate","total_errors","time_range","timestamp"],"title":"ErrorAnalyticsResponse","description":"Response for GET /analytics/errors."},"ErrorBreakdownEntry":{"properties":{"error_type":{"type":"string","title":"Error Type"},"count":{"type":"integer","title":"Count"},"percentage":{"type":"number","title":"Percentage"}},"type":"object","required":["error_type","count","percentage"],"title":"ErrorBreakdownEntry","description":"Error count/percentage for one status-code class (4xx/5xx/etc.)."},"ErrorMetrics":{"properties":{"total_errors":{"type":"integer","title":"Total Errors","description":"Total number of errors analyzed"},"critical_errors":{"type":"integer","title":"Critical Errors","description":"Number of critical errors"},"high_severity_errors":{"type":"integer","title":"High Severity Errors","description":"Number of high severity errors"},"most_common_category":{"type":"string","title":"Most Common Category","description":"Most common error category"},"most_affected_file":{"type":"string","title":"Most Affected File","description":"File with the most errors"},"error_trend":{"additionalProperties":{"type":"integer"},"type":"object","title":"Error Trend","description":"Error trend over time"}},"type":"object","required":["total_errors","critical_errors","high_severity_errors","most_common_category","most_affected_file","error_trend"],"title":"ErrorMetrics","description":"Project-level error metrics"},"ErrorOccurrence":{"properties":{"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"When the error occurred"},"environment":{"type":"string","title":"Environment","description":"Environment where the error occurred (dev, test, prod)"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"ID of the user who experienced the error"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Session ID when the error occurred"},"request_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Request Data","description":"Request data related to the error"}},"type":"object","required":["timestamp","environment"],"title":"ErrorOccurrence","description":"Single occurrence of an error"},"ErrorRatePoint":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"total_requests":{"type":"integer","title":"Total Requests"},"error_count":{"type":"integer","title":"Error Count"},"error_rate":{"type":"number","title":"Error Rate"}},"type":"object","required":["timestamp","total_requests","error_count","error_rate"],"title":"ErrorRatePoint","description":"One daily bucket in the error-rate-over-time series."},"ErrorReportRequest":{"properties":{"error_type":{"type":"string","title":"Error Type","description":"Type of error"},"error_message":{"type":"string","title":"Error Message","description":"Error message"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Context where error occurred"},"user_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Description","description":"User's description of what happened"},"steps_to_reproduce":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Steps To Reproduce","description":"Steps to reproduce the error"},"expected_behavior":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Behavior","description":"What the user expected to happen"}},"type":"object","required":["error_type","error_message","context"],"title":"ErrorReportRequest","description":"Request model for error reports"},"EscalateApprovalRequest":{"properties":{"new_approver":{"type":"string","maxLength":255,"title":"New Approver","description":"New approver reference"},"extend_ttl_minutes":{"type":"integer","maximum":10080,"minimum":1,"title":"Extend Ttl Minutes","description":"Additional TTL minutes","default":30}},"type":"object","required":["new_approver"],"title":"EscalateApprovalRequest"},"EscalateApprovalResponse":{"properties":{"approval_id":{"type":"string","title":"Approval Id"},"status":{"type":"string","title":"Status"},"approver_ref":{"type":"string","title":"Approver Ref"},"ttl_at":{"type":"string","title":"Ttl At"}},"type":"object","required":["approval_id","status","approver_ref","ttl_at"],"title":"EscalateApprovalResponse"},"EvaluatePromptVersionResponse":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version Id"},"evaluation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evaluation Id"},"evaluated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evaluated At"},"test_cases_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Test Cases Count"},"evaluators_used":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Evaluators Used"},"scores":{"anyOf":[{"$ref":"#/components/schemas/PromptEvaluationScores"},{"type":"null"}]},"metrics":{"anyOf":[{"$ref":"#/components/schemas/PromptEvaluationMetrics"},{"type":"null"}]},"detailed_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Detailed Results"},"recommendations":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Recommendations"},"should_promote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Should Promote"}},"additionalProperties":true,"type":"object","title":"EvaluatePromptVersionResponse","description":"Union of the background-started ack and the full evaluation result."},"EvaluateResponse":{"properties":{"passed":{"type":"boolean","title":"Passed"},"confidence":{"type":"number","title":"Confidence"},"hallucination_risk":{"type":"number","title":"Hallucination Risk"},"retry_recommended":{"type":"boolean","title":"Retry Recommended"},"confidence_reasoning":{"type":"string","title":"Confidence Reasoning"},"grounded":{"type":"boolean","title":"Grounded"},"evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence"}},"type":"object","required":["passed","confidence","hallucination_risk","retry_recommended","confidence_reasoning","grounded","evidence"],"title":"EvaluateResponse"},"EvaluateVersionResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"EvaluateVersionResponse","description":"Response for POST /versions/{version_id}/evaluate -- open\npassthrough, see CreateABTestResponse docstring."},"EvaluatedFlag":{"properties":{"key":{"type":"string","title":"Key"},"enabled":{"type":"boolean","title":"Enabled"},"value":{"anyOf":[{},{"type":"null"}],"title":"Value"}},"type":"object","required":["key","enabled"],"title":"EvaluatedFlag","description":"Schema for a flag evaluated for a specific user."},"EvaluatedFlagsResponse":{"properties":{"flags":{"items":{"$ref":"#/components/schemas/EvaluatedFlag"},"type":"array","title":"Flags"}},"type":"object","required":["flags"],"title":"EvaluatedFlagsResponse","description":"Response containing all evaluated flags for a user."},"EvaluationDashboardOverview":{"properties":{"total_templates":{"type":"integer","title":"Total Templates"},"active_templates":{"type":"integer","title":"Active Templates"},"total_versions":{"type":"integer","title":"Total Versions"},"evaluated_versions":{"type":"integer","title":"Evaluated Versions"}},"type":"object","required":["total_templates","active_templates","total_versions","evaluated_versions"],"title":"EvaluationDashboardOverview"},"EvaluationDashboardResponse":{"properties":{"evaluations_today":{"type":"integer","title":"Evaluations Today"},"evaluations_week":{"type":"integer","title":"Evaluations Week"},"avg_quality_score":{"type":"number","title":"Avg Quality Score"},"avg_evaluation_time":{"type":"number","title":"Avg Evaluation Time"},"evaluation_types":{"items":{"$ref":"#/components/schemas/EvaluationTypeBreakdown"},"type":"array","title":"Evaluation Types"},"quality_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Quality Distribution"},"top_issues_found":{"items":{"$ref":"#/components/schemas/TopIssueItem"},"type":"array","title":"Top Issues Found"},"improvement_trends":{"$ref":"#/components/schemas/ImprovementTrends"},"period_days":{"type":"integer","title":"Period Days"},"total_evaluations":{"type":"integer","title":"Total Evaluations"},"average_score":{"type":"number","title":"Average Score"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["evaluations_today","evaluations_week","avg_quality_score","avg_evaluation_time","evaluation_types","quality_distribution","top_issues_found","improvement_trends","period_days","total_evaluations","average_score","timestamp"],"title":"EvaluationDashboardResponse","description":"Response for GET /metrics/dashboard."},"EvaluationDashboardTrends":{"properties":{"daily_evaluations":{"items":{},"type":"array","title":"Daily Evaluations"},"average_scores":{"items":{},"type":"array","title":"Average Scores"},"success_rates":{"items":{},"type":"array","title":"Success Rates"}},"type":"object","required":["daily_evaluations","average_scores","success_rates"],"title":"EvaluationDashboardTrends"},"EvaluationSummaryResponse":{"properties":{"evaluation_id":{"type":"string","title":"Evaluation Id"},"integrated_score":{"type":"number","title":"Integrated Score"},"quality_grade":{"type":"string","title":"Quality Grade"},"evaluation_summary":{"type":"string","title":"Evaluation Summary"},"duration_seconds":{"type":"number","title":"Duration Seconds"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["evaluation_id","integrated_score","quality_grade","evaluation_summary","duration_seconds","timestamp"],"title":"EvaluationSummaryResponse","description":"Response model for evaluation summary"},"EvaluationTypeBreakdown":{"properties":{"type":{"type":"string","title":"Type"},"count":{"type":"integer","title":"Count"},"avg_score":{"type":"number","title":"Avg Score"}},"type":"object","required":["type","count","avg_score"],"title":"EvaluationTypeBreakdown"},"Event":{"properties":{"title":{"type":"string","maxLength":200,"minLength":3,"title":"Title","description":"Event title"},"description":{"type":"string","maxLength":5000,"minLength":10,"title":"Description","description":"Event description"},"event_type":{"$ref":"#/components/schemas/EventType","description":"Type of event"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Event start date and time"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date","description":"Event end date and time"},"location":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Location","description":"Physical location or virtual platform"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics","description":"Event topics/tags for targeting"},"expected_attendees":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Expected Attendees","description":"Expected number of attendees"},"id":{"type":"string","title":"Id","description":"Event UUID"},"organizer_id":{"type":"string","title":"Organizer Id","description":"Organizer UUID"},"status":{"$ref":"#/components/schemas/EventStatus","description":"Event status","default":"draft"},"embedding_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Embedding Id","description":"ZeroDB vector embedding ID"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Event creation timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Event last update timestamp"}},"type":"object","required":["title","description","event_type","start_date","id","organizer_id","created_at","updated_at"],"title":"Event","description":"Full event schema with system fields"},"EventCancelResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable confirmation"},"event":{"$ref":"#/components/schemas/app__schemas__community_events__EventResponse","description":"The cancelled event"}},"type":"object","required":["message","event"],"title":"EventCancelResponse","description":"Confirmation body for cancelling an event (Refs #8449).\n\n`event` NESTS the existing EventResponse schema rather than restating it\nor loosening it to `Dict[str, Any]` — the service returns a real\n`Optional[EventResponse]`, so nesting keeps every field constraint that\nschema already carries instead of throwing them away.\n\nBoth keys are unconditional on the 200 path (it is reached only after the\nNone check), so no `response_model_exclude_unset` is needed."},"EventComparisonItem":{"properties":{"event_id":{"type":"string","title":"Event Id","description":"Event UUID"},"event_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Name","description":"Event name"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","default":0},"revenue":{"type":"string","title":"Revenue","default":0},"fill_rate":{"type":"number","maximum":1,"minimum":0,"title":"Fill Rate","default":0},"ctr":{"type":"number","maximum":1,"minimum":0,"title":"Ctr","default":0},"rank":{"type":"integer","minimum":0,"title":"Rank","description":"Rank by revenue (1 = highest)","default":0}},"type":"object","required":["event_id"],"title":"EventComparisonItem","description":"Single event in comparison view"},"EventComparisonResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/EventComparisonItem"},"type":"array","title":"Events","description":"Events ranked by revenue"},"top_performer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Performer","description":"Event ID with highest revenue"},"total_events":{"type":"integer","minimum":0,"title":"Total Events","description":"Total events compared","default":0},"time_range":{"$ref":"#/components/schemas/TimeRange-Output","description":"Time range used"},"generated_at":{"type":"string","format":"date-time","title":"Generated At","description":"Report generation timestamp"}},"type":"object","required":["events","time_range","generated_at"],"title":"EventComparisonResponse","description":"Compare multiple events side-by-side\nIssue #581: Event Performance Analytics"},"EventMetrics":{"properties":{"event_id":{"type":"string","title":"Event Id","description":"Event UUID"},"event_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Name","description":"Event name"},"organizer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organizer Id","description":"Organizer UUID"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","description":"Total impressions","default":0},"unique_impressions":{"type":"integer","minimum":0,"title":"Unique Impressions","description":"Unique user impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","description":"Total clicks","default":0},"completions":{"type":"integer","minimum":0,"title":"Completions","description":"Video completions","default":0},"ctr":{"type":"number","maximum":1,"minimum":0,"title":"Ctr","description":"Click-through rate","default":0},"completion_rate":{"type":"number","maximum":1,"minimum":0,"title":"Completion Rate","description":"Completion rate","default":0},"total_revenue":{"type":"string","title":"Total Revenue","description":"Total revenue earned","default":0},"avg_rpm":{"type":"string","title":"Avg Rpm","description":"Average RPM (revenue per 1000 impressions)","default":0},"total_slots":{"type":"integer","minimum":0,"title":"Total Slots","description":"Total ad slots available","default":0},"filled_slots":{"type":"integer","minimum":0,"title":"Filled Slots","description":"Ad slots that were filled","default":0},"fill_rate":{"type":"number","maximum":1,"minimum":0,"title":"Fill Rate","description":"Fill rate (filled/total)","default":0},"period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period Start","description":"Start of time period"},"period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period End","description":"End of time period"}},"type":"object","required":["event_id"],"title":"EventMetrics","description":"Detailed event performance metrics for organizers\nIssue #581: Event Performance Analytics"},"EventPerformance":{"properties":{"event_id":{"type":"string","title":"Event Id","description":"Event UUID"},"event_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Name","description":"Event name"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","default":0},"completions":{"type":"integer","minimum":0,"title":"Completions","default":0},"ctr":{"type":"number","maximum":1,"minimum":0,"title":"Ctr","default":0},"completion_rate":{"type":"number","maximum":1,"minimum":0,"title":"Completion Rate","default":0},"spend":{"type":"string","title":"Spend","default":0}},"type":"object","required":["event_id"],"title":"EventPerformance","description":"Performance metrics breakdown by event"},"EventPerformanceResponse":{"properties":{"event":{"$ref":"#/components/schemas/EventMetrics","description":"Overall event metrics"},"daily_revenue":{"anyOf":[{"items":{"$ref":"#/components/schemas/RevenueDaily"},"type":"array"},{"type":"null"}],"title":"Daily Revenue","description":"Daily revenue time series"},"top_sponsors":{"anyOf":[{"items":{"$ref":"#/components/schemas/SponsorSpend"},"type":"array"},{"type":"null"}],"title":"Top Sponsors","description":"Top sponsors by spend"},"time_range":{"$ref":"#/components/schemas/TimeRange-Output","description":"Time range used for metrics"},"generated_at":{"type":"string","format":"date-time","title":"Generated At","description":"Timestamp when report was generated"}},"type":"object","required":["event","time_range","generated_at"],"title":"EventPerformanceResponse","description":"Full event performance response for organizers\nIssue #581: Event Performance Analytics"},"EventPrivacy":{"type":"string","enum":["public","private","group_only"],"title":"EventPrivacy","description":"Event privacy/visibility options"},"EventPrivacyEnum":{"type":"string","enum":["public","private","group_only"],"title":"EventPrivacyEnum","description":"Event privacy/visibility options"},"EventRevenue":{"properties":{"event_id":{"type":"string","title":"Event Id","description":"Event UUID"},"event_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Name","description":"Event name"},"organizer_id":{"type":"string","title":"Organizer Id","description":"Organizer UUID"},"total_revenue":{"type":"string","title":"Total Revenue","description":"Total revenue","default":"0.00"},"platform_share":{"type":"string","title":"Platform Share","description":"Platform share","default":"0.00"},"organizer_share":{"type":"string","title":"Organizer Share","description":"Organizer share","default":"0.00"},"impressions":{"type":"integer","title":"Impressions","description":"Total impressions","default":0},"clicks":{"type":"integer","title":"Clicks","description":"Total clicks","default":0},"payout_status":{"type":"string","title":"Payout Status","description":"Payout status","default":"pending"}},"type":"object","required":["event_id","organizer_id"],"title":"EventRevenue","description":"Revenue breakdown by event"},"EventSearchResult":{"properties":{"id":{"type":"string","title":"Id","description":"Event ID"},"title":{"type":"string","title":"Title","description":"Event title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Event description"},"event_type":{"type":"string","title":"Event Type","description":"Event type (virtual/in_person/hybrid)"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Event start time"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"Event location"},"rsvp_count":{"type":"integer","title":"Rsvp Count","description":"Number of RSVPs","default":0},"relevance_score":{"type":"number","maximum":1,"minimum":0,"title":"Relevance Score","description":"Search relevance score"}},"type":"object","required":["id","title","event_type","start_time","relevance_score"],"title":"EventSearchResult","description":"Event search result item","example":{"description":"Hands-on workshop for AI development","event_type":"hybrid","id":"e1v2e3n4-5t6i-7890-abcd-ef1234567890","location":"San Francisco, CA","relevance_score":0.85,"rsvp_count":89,"start_time":"2026-02-15T10:00:00Z","title":"AI Workshop 2026"}},"EventStatus":{"type":"string","enum":["draft","published","live","completed","cancelled"],"title":"EventStatus","description":"Event status lifecycle"},"EventStatusEnum":{"type":"string","enum":["scheduled","cancelled","completed"],"title":"EventStatusEnum","description":"Event status options"},"EventSubscriptionCreate":{"properties":{"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types","description":"Array of event types to subscribe to","examples":[["user.login","order.created"]]},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Url","description":"Webhook URL for event delivery (optional)"},"filter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter","description":"Event filter criteria (optional)"}},"type":"object","required":["event_types"],"title":"EventSubscriptionCreate","description":"Schema for creating event subscriptions - matches frontend request"},"EventSubscriptionCreateResponse":{"properties":{"subscription_id":{"type":"string","title":"Subscription Id","description":"UUID of created subscription"}},"type":"object","required":["subscription_id"],"title":"EventSubscriptionCreateResponse","description":"Response after creating a subscription"},"EventSubscriptionDeleteResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Success message"}},"type":"object","required":["message"],"title":"EventSubscriptionDeleteResponse","description":"Response after deleting a subscription"},"EventSubscriptionListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EventSubscriptionResponse"},"type":"array","title":"Data","description":"Array of subscriptions"},"total":{"type":"integer","title":"Total","description":"Total count"}},"type":"object","required":["data","total"],"title":"EventSubscriptionListResponse","description":"List response for subscriptions - matches frontend expectations exactly"},"EventSubscriptionResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Subscription ID as string"},"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types","description":"Array of event types"},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Url","description":"Webhook URL"},"filter":{"additionalProperties":true,"type":"object","title":"Filter","description":"Event filter"},"created_at":{"type":"string","title":"Created At","description":"ISO 8601 timestamp string"},"status":{"type":"string","title":"Status","description":"Subscription status (active or paused)"}},"type":"object","required":["id","event_types","created_at","status"],"title":"EventSubscriptionResponse","description":"Individual subscription response - matches frontend TypeScript interface"},"EventTargeting":{"properties":{"event_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Event Types","description":"Event types to target (e.g., 'conference', 'hackathon', 'webinar')"},"topics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topics","description":"Topics to target (e.g., 'AI', 'ML', 'NLP', 'Computer Vision')"},"locations":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Locations","description":"Locations to target (e.g., 'San Francisco', 'New York', 'Remote')"}},"type":"object","title":"EventTargeting","description":"Event targeting criteria for campaign\n\nCampaigns can target events by type, topics, and locations.\nAll criteria are optional (null = target all events).","example":{"event_types":["conference","hackathon"],"locations":["San Francisco","New York"],"topics":["AI","ML","NLP"]}},"EventType":{"type":"string","enum":["conference","hackathon","workshop","webinar","meetup"],"title":"EventType","description":"Event type enumeration"},"EventTypeEnum":{"type":"string","enum":["virtual","in_person","hybrid"],"title":"EventTypeEnum","description":"Event type options"},"EvictionCycleResponse":{"properties":{"status":{"type":"string","title":"Status"},"run_id":{"type":"string","title":"Run Id"},"worker_type":{"type":"string","title":"Worker Type"},"processed_users":{"type":"integer","title":"Processed Users"},"evicted_count":{"type":"integer","title":"Evicted Count"},"duration_ms":{"type":"integer","title":"Duration Ms"}},"type":"object","required":["status","run_id","worker_type","processed_users","evicted_count","duration_ms"],"title":"EvictionCycleResponse"},"EvictionPoliciesConfig":{"properties":{"default":{"type":"string","title":"Default"},"session_cache":{"type":"string","title":"Session Cache"},"query_cache":{"type":"string","title":"Query Cache"}},"type":"object","required":["default","session_cache","query_cache"],"title":"EvictionPoliciesConfig"},"EvidenceBundleResponse":{"properties":{"framework":{"type":"string","title":"Framework"},"start_time":{"type":"string","title":"Start Time"},"end_time":{"type":"string","title":"End Time"},"total_records":{"type":"integer","title":"Total Records"},"records":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Records"},"exported_at":{"type":"string","title":"Exported At"}},"type":"object","required":["framework","start_time","end_time","total_records","records","exported_at"],"title":"EvidenceBundleResponse"},"ExampleDetail":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"filename":{"type":"string","title":"Filename"},"language":{"type":"string","title":"Language"},"sdk_package":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sdk Package"},"install":{"type":"string","title":"Install"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"source_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Code","description":"Full source code of the example"}},"type":"object","required":["id","title","description","filename","language","install","tags"],"title":"ExampleDetail"},"ExampleDetailResponse":{"properties":{"example":{"$ref":"#/components/schemas/ExampleDetail"}},"type":"object","required":["example"],"title":"ExampleDetailResponse"},"ExampleSummary":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"filename":{"type":"string","title":"Filename"},"language":{"type":"string","title":"Language"},"sdk_package":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sdk Package"},"install":{"type":"string","title":"Install"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"}},"type":"object","required":["id","title","description","filename","language","install","tags"],"title":"ExampleSummary"},"ExamplesListResponse":{"properties":{"examples":{"items":{"$ref":"#/components/schemas/ExampleSummary"},"type":"array","title":"Examples"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["examples","total"],"title":"ExamplesListResponse"},"ExecuteActionResponse":{"properties":{"action_id":{"type":"string","title":"Action Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"result":{"$ref":"#/components/schemas/ActionExecutionResult"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["action_id","status","message","result","timestamp"],"title":"ExecuteActionResponse"},"ExecuteQueryResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/QueryResultItem"},"type":"array","title":"Results"},"query_time_ms":{"type":"number","title":"Query Time Ms"},"total_scanned":{"type":"integer","title":"Total Scanned"}},"type":"object","required":["results","query_time_ms","total_scanned"],"title":"ExecuteQueryResponse"},"ExecutionListResponse":{"properties":{"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["items","total","page","page_size","total_pages"],"title":"ExecutionListResponse","description":"Paginated list of executions"},"ExecutionResponse":{"properties":{"id":{"type":"string","title":"Id"},"sequence_id":{"type":"string","title":"Sequence Id"},"status":{"type":"string","title":"Status"},"started_at":{"type":"string","title":"Started At"}},"type":"object","required":["id","sequence_id","status","started_at"],"title":"ExecutionResponse","example":{"id":"exec-123","sequence_id":"seq-456","started_at":"2025-01-01T00:00:00Z","status":"started"}},"ExperimentCreate":{"properties":{"name":{"type":"string","title":"Name","description":"Human-readable experiment name"},"hypothesis":{"type":"string","title":"Hypothesis","description":"Hypothesis being tested"},"slug":{"type":"string","title":"Slug","description":"URL-safe unique identifier"},"utm_campaign":{"type":"string","title":"Utm Campaign","description":"UTM campaign value for attribution"},"ad_campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Campaign Id","description":"Optional ad platform campaign ID"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date","description":"Start date; defaults to today"}},"type":"object","required":["name","hypothesis","slug","utm_campaign"],"title":"ExperimentCreate"},"ExperimentListResponse":{"properties":{"total":{"type":"integer","title":"Total"},"experiments":{"items":{"$ref":"#/components/schemas/ExperimentResponse"},"type":"array","title":"Experiments"}},"type":"object","required":["total","experiments"],"title":"ExperimentListResponse"},"ExperimentResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"hypothesis":{"type":"string","title":"Hypothesis"},"slug":{"type":"string","title":"Slug"},"utm_campaign":{"type":"string","title":"Utm Campaign"},"ad_campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Campaign Id"},"conversions":{"type":"integer","title":"Conversions"},"impressions":{"type":"integer","title":"Impressions"},"conversion_rate":{"type":"number","title":"Conversion Rate"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"kill_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kill Date"},"status":{"type":"string","title":"Status"},"learnings":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Learnings"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","hypothesis","slug","utm_campaign","conversions","impressions","conversion_rate","status"],"title":"ExperimentResponse"},"ExperimentUpdate":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"New status: active, killed, or promoted"},"learnings":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Learnings","description":"Learnings text after experiment ends"},"conversions":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Conversions","description":"Override conversion count"},"impressions":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Impressions","description":"Override impression count"}},"type":"object","title":"ExperimentUpdate"},"ExpiringAgentsResponse":{"properties":{"status":{"type":"string","title":"Status"},"warning_threshold_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Warning Threshold Days"},"agents_expiring":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Agents Expiring"},"warnings":{"anyOf":[{"items":{"$ref":"#/components/schemas/ExpiryWarningEntry"},"type":"array"},{"type":"null"}],"title":"Warnings"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"ExpiringAgentsResponse","description":"state_expiry_service.get_expiry_warnings()"},"ExpiryWarningEntry":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"ttl_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Days"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"remaining_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Remaining Days"},"remaining_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Remaining Hours"}},"additionalProperties":true,"type":"object","required":["agent_id"],"title":"ExpiryWarningEntry"},"ExportAcceptedResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"export_id":{"type":"string","title":"Export Id"},"status":{"type":"string","title":"Status"},"format":{"type":"string","title":"Format"}},"type":"object","required":["task_id","export_id","status","format"],"title":"ExportAcceptedResponse"},"ExportAgentLogEntry":{"properties":{"id":{"type":"string","title":"Id"},"project_id":{"type":"string","title":"Project Id"},"agent_id":{"type":"string","title":"Agent Id"},"session_id":{"type":"string","title":"Session Id"},"log_level":{"type":"string","title":"Log Level"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["id","project_id","agent_id","session_id","log_level","message","timestamp"],"title":"ExportAgentLogEntry"},"ExportAgentLogsResponse":{"properties":{"format":{"type":"string","title":"Format"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/ExportAgentLogEntry"},"type":"array","title":"Data"},"exported_at":{"type":"string","title":"Exported At"}},"type":"object","required":["format","count","data","exported_at"],"title":"ExportAgentLogsResponse"},"ExportAnalyticsDataResponse":{"properties":{"export_id":{"type":"string","title":"Export Id"},"format":{"type":"string","title":"Format"},"data":{"$ref":"#/components/schemas/ExportDataPayload"},"download_ready":{"type":"boolean","title":"Download Ready"},"file_size_estimate":{"type":"string","title":"File Size Estimate"},"message":{"type":"string","title":"Message"}},"type":"object","required":["export_id","format","data","download_ready","file_size_estimate","message"],"title":"ExportAnalyticsDataResponse","description":"Response for GET /export/data."},"ExportAuditDataResponse":{"properties":{"export_id":{"type":"string","title":"Export Id"},"status":{"type":"string","title":"Status"},"estimated_completion":{"type":"string","title":"Estimated Completion"},"download_url":{"type":"string","title":"Download Url"},"expires_at":{"type":"string","title":"Expires At"},"record_count":{"type":"integer","title":"Record Count"},"file_format":{"type":"string","title":"File Format"},"security_notice":{"type":"string","title":"Security Notice"}},"type":"object","required":["export_id","status","estimated_completion","download_url","expires_at","record_count","file_format","security_notice"],"title":"ExportAuditDataResponse"},"ExportDataPayload":{"properties":{"export_metadata":{"$ref":"#/components/schemas/ExportMetadata"},"dashboard_summary":{"additionalProperties":true,"type":"object","title":"Dashboard Summary"},"aggregated_metrics":{"additionalProperties":true,"type":"object","title":"Aggregated Metrics"},"trend_analysis":{"items":{},"type":"array","title":"Trend Analysis"},"performance_insights":{"items":{},"type":"array","title":"Performance Insights"},"top_performing_prompts":{"items":{},"type":"array","title":"Top Performing Prompts"},"comparative_analysis":{"additionalProperties":true,"type":"object","title":"Comparative Analysis"},"chart_data":{"additionalProperties":true,"type":"object","title":"Chart Data"}},"type":"object","required":["export_metadata","dashboard_summary","aggregated_metrics","trend_analysis","performance_insights","top_performing_prompts","comparative_analysis","chart_data"],"title":"ExportDataPayload"},"ExportDataResponse":{"properties":{"export_id":{"type":"string","title":"Export Id"},"format":{"type":"string","title":"Format"},"vectors_exported":{"type":"integer","title":"Vectors Exported"},"size_mb":{"type":"number","title":"Size Mb"},"data":{"type":"string","title":"Data","description":"The exported records serialized inline as a JSON or CSV string, per `format`."},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["export_id","format","vectors_exported","size_mb","data","expires_at"],"title":"ExportDataResponse"},"ExportDocumentationResponse":{"properties":{"export_id":{"type":"string","title":"Export Id"},"format":{"type":"string","title":"Format"},"category":{"type":"string","title":"Category"},"include_analytics":{"type":"boolean","title":"Include Analytics"},"status":{"type":"string","title":"Status"},"download_url":{"type":"string","title":"Download Url"},"file_size_mb":{"type":"number","title":"File Size Mb"},"content_count":{"type":"integer","title":"Content Count"},"generated_at":{"type":"string","title":"Generated At"},"expires_at":{"type":"string","title":"Expires At"},"generated_by":{"type":"string","title":"Generated By"}},"type":"object","required":["export_id","format","category","include_analytics","status","download_url","file_size_mb","content_count","generated_at","expires_at","generated_by"],"title":"ExportDocumentationResponse","description":"Response for POST /help-documentation/export."},"ExportGraphEdge":{"properties":{"id":{"type":"string","title":"Id"},"source":{"type":"string","title":"Source"},"target":{"type":"string","title":"Target"},"predicate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicate"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"}},"additionalProperties":true,"type":"object","required":["id","source","target"],"title":"ExportGraphEdge"},"ExportGraphJSONResponse":{"properties":{"nodes":{"items":{"$ref":"#/components/schemas/ExportGraphNode"},"type":"array","title":"Nodes"},"edges":{"items":{"$ref":"#/components/schemas/ExportGraphEdge"},"type":"array","title":"Edges"},"meta":{"$ref":"#/components/schemas/ExportGraphMeta"}},"additionalProperties":true,"type":"object","required":["meta"],"title":"ExportGraphJSONResponse","description":"Response for GET /memory/v2/graph/export?format=json ONLY.\n\n``format=gexf`` returns a raw ``fastapi.responses.Response`` of XML and is\nNOT described by this model — see the route's own comment."},"ExportGraphMeta":{"properties":{"entities":{"type":"integer","title":"Entities"},"edges":{"type":"integer","title":"Edges"},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format"},"min_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Confidence"}},"additionalProperties":true,"type":"object","required":["entities","edges"],"title":"ExportGraphMeta","description":"Export metadata. ``format``/``min_confidence`` are omitted from the\nempty-graph early return, which emits only entities/edges counts."},"ExportGraphNode":{"properties":{"id":{"type":"string","title":"Id"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"},"memory_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Count"},"first_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Seen"},"last_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Seen"}},"additionalProperties":true,"type":"object","required":["id"],"title":"ExportGraphNode"},"ExportJobResponse":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","title":"Status"},"framework":{"type":"string","title":"Framework"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["job_id","status","framework","created_at"],"title":"ExportJobResponse"},"ExportMetadata":{"properties":{"generated_at":{"type":"string","title":"Generated At"},"generated_by":{"type":"string","title":"Generated By"},"time_window":{"type":"string","title":"Time Window"},"format":{"type":"string","title":"Format"},"metric_types_included":{"title":"Metric Types Included"}},"type":"object","required":["generated_at","generated_by","time_window","format","metric_types_included"],"title":"ExportMetadata"},"ExportTemplateResponse":{"properties":{"status":{"type":"string","title":"Status"},"export_format":{"type":"string","title":"Export Format"},"template_name":{"type":"string","title":"Template Name"},"content":{"type":"string","title":"Content"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","export_format","template_name","content","timestamp"],"title":"ExportTemplateResponse","description":"Response for POST /langflow-templates/export."},"ExportTestResultsResponse":{"properties":{"test_id":{"type":"string","title":"Test Id"},"export_format":{"type":"string","title":"Export Format"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"download_ready":{"type":"boolean","title":"Download Ready"},"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["test_id","export_format","data","download_ready","message"],"title":"ExportTestResultsResponse","description":"Response for GET /ab-testing/tests/{test_id}/export."},"ExtraUsage":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Whether extra usage is enabled for this account"},"remaining":{"type":"integer","minimum":0,"title":"Remaining","description":"Extra usage credits remaining"}},"type":"object","required":["enabled","remaining"],"title":"ExtraUsage","description":"Extra usage allowance information."},"FailedInvoice":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"error":{"type":"string","title":"Error"}},"type":"object","required":["user_id","email","error"],"title":"FailedInvoice"},"FailedRouterInfo":{"properties":{"prefix":{"type":"string","title":"Prefix"},"error":{"type":"string","title":"Error"}},"additionalProperties":true,"type":"object","required":["prefix","error"],"title":"FailedRouterInfo"},"FeatureFlagCreate":{"properties":{"key":{"type":"string","maxLength":255,"minLength":1,"pattern":"^[a-z][a-z0-9_]*$","title":"Key"},"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"flag_type":{"$ref":"#/components/schemas/FlagType","default":"boolean"},"enabled":{"type":"boolean","title":"Enabled","default":false},"value":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Value"},"percentage":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"title":"Percentage"},"target_plans":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Plans"}},"type":"object","required":["key","name"],"title":"FeatureFlagCreate","description":"Schema for creating a feature flag."},"FeatureFlagResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"key":{"type":"string","title":"Key"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"flag_type":{"$ref":"#/components/schemas/FlagType"},"enabled":{"type":"boolean","title":"Enabled"},"value":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Value"},"percentage":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Percentage"},"target_plans":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Plans"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","key","name","flag_type","enabled","created_at"],"title":"FeatureFlagResponse","description":"Schema for feature flag in API responses."},"FeatureFlagUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"flag_type":{"anyOf":[{"$ref":"#/components/schemas/FlagType"},{"type":"null"}]},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"value":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Value"},"percentage":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"title":"Percentage"},"target_plans":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Plans"}},"type":"object","title":"FeatureFlagUpdate","description":"Schema for updating a feature flag."},"FeatureFlags":{"properties":{"tools_enabled":{"type":"boolean","title":"Tools Enabled","default":true},"mcp_enabled":{"type":"boolean","title":"Mcp Enabled","default":true},"remote_sessions_enabled":{"type":"boolean","title":"Remote Sessions Enabled","default":true}},"type":"object","title":"FeatureFlags","description":"Feature flags for CLI client capabilities."},"FeedbackBySentiment":{"properties":{"positive":{"type":"integer","title":"Positive"},"negative":{"type":"integer","title":"Negative"},"neutral":{"type":"integer","title":"Neutral"},"mixed":{"type":"integer","title":"Mixed"}},"type":"object","required":["positive","negative","neutral","mixed"],"title":"FeedbackBySentiment"},"FeedbackCollectionStatusResponse":{"properties":{"collection_active":{"type":"boolean","title":"Collection Active"},"active_sessions":{"type":"integer","title":"Active Sessions"},"pending_interactions":{"type":"integer","title":"Pending Interactions"},"system_health":{"type":"string","title":"System Health"}},"type":"object","required":["collection_active","active_sessions","pending_interactions","system_health"],"title":"FeedbackCollectionStatusResponse","description":"Response for GET /feedback/status."},"FeedbackContentLimits":{"properties":{"min_length":{"type":"integer","title":"Min Length"},"max_length":{"type":"integer","title":"Max Length"}},"type":"object","required":["min_length","max_length"],"title":"FeedbackContentLimits"},"FeedbackDistributions":{"properties":{"by_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Type"},"by_severity":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Severity"},"top_prompts":{"items":{"$ref":"#/components/schemas/TopPromptCount"},"type":"array","title":"Top Prompts"}},"type":"object","required":["by_type","by_severity","top_prompts"],"title":"FeedbackDistributions"},"FeedbackHistoryResponse":{"properties":{"feedback_history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Feedback History"},"total_count":{"type":"integer","title":"Total Count"},"filtered_count":{"type":"integer","title":"Filtered Count"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["feedback_history","total_count","filtered_count","timestamp"],"title":"FeedbackHistoryResponse"},"FeedbackPeriod":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"}},"type":"object","required":["start","end"],"title":"FeedbackPeriod"},"FeedbackRatingScale":{"properties":{"min":{"type":"number","title":"Min"},"max":{"type":"number","title":"Max"}},"type":"object","required":["min","max"],"title":"FeedbackRatingScale"},"FeedbackStage":{"type":"string","enum":["prd_processing","data_model_generation","backlog_generation","sprint_planning","code_generation","documentation","testing","deployment"],"title":"FeedbackStage","description":"Enumeration of Agent Swarm workflow stages that can receive feedback"},"FeedbackStageStats":{"properties":{"stage":{"$ref":"#/components/schemas/FeedbackStage"},"total_feedback":{"type":"integer","title":"Total Feedback","description":"Total feedback count","default":0},"average_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Rating","description":"Average star rating"},"thumbs_up_count":{"type":"integer","title":"Thumbs Up Count","description":"Thumbs up count","default":0},"thumbs_down_count":{"type":"integer","title":"Thumbs Down Count","description":"Thumbs down count","default":0},"positive_rate":{"type":"number","title":"Positive Rate","description":"Percentage of positive feedback","default":0}},"type":"object","required":["stage"],"title":"FeedbackStageStats","description":"Statistics for a single workflow stage"},"FeedbackStatisticsResponse":{"properties":{"time_window":{"type":"string","title":"Time Window"},"period":{"$ref":"#/components/schemas/FeedbackPeriod"},"summary":{"$ref":"#/components/schemas/FeedbackSummary"},"distributions":{"$ref":"#/components/schemas/FeedbackDistributions"},"system_health":{"$ref":"#/components/schemas/FeedbackSystemHealth"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["time_window","period","summary","distributions","system_health","timestamp"],"title":"FeedbackStatisticsResponse","description":"Response for GET /realtime-feedback/statistics."},"FeedbackSummary":{"properties":{"total_feedback":{"type":"integer","title":"Total Feedback"},"feedback_rate":{"type":"number","title":"Feedback Rate"},"unique_prompts":{"type":"integer","title":"Unique Prompts"}},"type":"object","required":["total_feedback","feedback_rate","unique_prompts"],"title":"FeedbackSummary"},"FeedbackSystemHealth":{"properties":{"status":{"type":"string","title":"Status"},"active_connections":{"type":"integer","title":"Active Connections"},"active_subscriptions":{"type":"integer","title":"Active Subscriptions"},"recent_feedback_count":{"type":"integer","title":"Recent Feedback Count"},"queue_size":{"type":"integer","title":"Queue Size"},"processing_active":{"type":"boolean","title":"Processing Active"},"uptime":{"type":"string","title":"Uptime"}},"type":"object","required":["status","active_connections","active_subscriptions","recent_feedback_count","queue_size","processing_active","uptime"],"title":"FeedbackSystemHealth"},"FeedbackTrendsResponse":{"properties":{"analysis_period_days":{"type":"integer","title":"Analysis Period Days"},"total_feedback":{"type":"integer","title":"Total Feedback"},"daily_feedback_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Daily Feedback Counts"},"daily_average_ratings":{"additionalProperties":{"type":"number"},"type":"object","title":"Daily Average Ratings"},"daily_sentiment_distribution":{"additionalProperties":{"additionalProperties":{"type":"integer"},"type":"object"},"type":"object","title":"Daily Sentiment Distribution"},"overall_sentiment_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Overall Sentiment Distribution"},"category_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Category Distribution"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["analysis_period_days","total_feedback","daily_feedback_counts","daily_average_ratings","daily_sentiment_distribution","overall_sentiment_distribution","category_distribution","timestamp"],"title":"FeedbackTrendsResponse","description":"GET /user-feedback/analytics/trends"},"FileBlameEntry":{"properties":{"line":{"type":"integer","title":"Line"},"commit_hash":{"type":"string","title":"Commit Hash"},"content":{"type":"string","title":"Content"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["line","commit_hash","content"],"title":"FileBlameEntry"},"FileChangeHistoryEntry":{"properties":{"commit_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commit Id"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"changed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Changed At"},"previous_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Hash"},"new_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Hash"},"metrics":{"additionalProperties":true,"type":"object","title":"Metrics"}},"type":"object","title":"FileChangeHistoryEntry"},"FileCommitHistoryEntry":{"properties":{"hash":{"type":"string","title":"Hash"},"author":{"type":"string","title":"Author"},"email":{"type":"string","title":"Email"},"date":{"type":"string","title":"Date"},"message":{"type":"string","title":"Message"},"insertions":{"type":"integer","title":"Insertions"},"deletions":{"type":"integer","title":"Deletions"}},"type":"object","required":["hash","author","email","date","message","insertions","deletions"],"title":"FileCommitHistoryEntry"},"FileCreate":{"properties":{"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name","description":"File name"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type","description":"MIME content type"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes","description":"File size in bytes"},"file_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Metadata","description":"File metadata"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"Project ID (set automatically)"},"file_key":{"type":"string","title":"File Key","description":"MinIO object key"}},"type":"object","required":["file_key"],"title":"FileCreate","description":"Schema for creating files"},"FileCriteriaRequest":{"properties":{"criteria":{"additionalProperties":true,"type":"object","title":"Criteria","description":"Search criteria"}},"type":"object","required":["criteria"],"title":"FileCriteriaRequest"},"FileDependentInfo":{"properties":{"file_path":{"type":"string","title":"File Path"},"dependency_type":{"type":"string","title":"Dependency Type"}},"type":"object","required":["file_path","dependency_type"],"title":"FileDependentInfo"},"FileHistoryRequest":{"properties":{"repo_path":{"type":"string","title":"Repo Path","description":"Path to the Git repository"},"file_path":{"type":"string","title":"File Path","description":"Path to the file (relative to repo)"}},"type":"object","required":["repo_path","file_path"],"title":"FileHistoryRequest"},"FileHotspot":{"properties":{"file_path":{"type":"string","title":"File Path"},"change_count":{"type":"integer","title":"Change Count"},"complexity_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complexity Score"},"security_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Classification"}},"type":"object","required":["file_path","change_count"],"title":"FileHotspot"},"FileListItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique file identifier"},"filename":{"type":"string","title":"Filename","description":"Original filename"},"content_type":{"type":"string","title":"Content Type","description":"MIME content type"},"size":{"type":"integer","title":"Size","description":"File size in bytes"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Upload timestamp (UTC)"}},"type":"object","required":["id","filename","content_type","size","created_at"],"title":"FileListItem","description":"Single file entry in a list response."},"FileListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/FileListItem"},"type":"array","title":"Data","description":"List of files"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results are available after this page","default":false}},"type":"object","title":"FileListResponse","description":"Paginated file listing with cursor-based pagination."},"FileOwnershipEntry":{"properties":{"author":{"type":"string","title":"Author"},"email":{"type":"string","title":"Email"},"commits":{"type":"integer","title":"Commits"},"ownership_percentage":{"type":"number","title":"Ownership Percentage"}},"type":"object","required":["author","email","commits","ownership_percentage"],"title":"FileOwnershipEntry"},"FileResponse":{"properties":{"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name","description":"File name"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type","description":"MIME content type"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes","description":"File size in bytes"},"file_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Metadata","description":"File metadata"},"file_id":{"type":"string","format":"uuid","title":"File Id","description":"Unique identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Unique identifier"},"file_key":{"type":"string","title":"File Key"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Timestamp"}},"type":"object","required":["file_id","project_id","file_key","created_at","updated_at"],"title":"FileResponse","description":"Complete file response schema"},"FileStatsContentTypeBreakdown":{"properties":{"content_type":{"type":"string","title":"Content Type"},"count":{"type":"integer","title":"Count"},"total_bytes":{"type":"integer","title":"Total Bytes"}},"type":"object","required":["content_type","count","total_bytes"],"title":"FileStatsContentTypeBreakdown"},"FileTypeBreakdown":{"properties":{"type":{"type":"string","title":"Type"},"count":{"type":"integer","title":"Count"},"total_lines":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Lines"}},"type":"object","required":["type","count"],"title":"FileTypeBreakdown"},"FindFilesByCriteriaResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Service status"},"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"criteria":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Criteria","description":"Criteria echoed back"},"matching_files":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Matching Files","description":"Files matching all criteria"},"total_matches":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Matches","description":"Number of matching files"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message when status=error"}},"additionalProperties":true,"type":"object","required":["status","project_id"],"title":"FindFilesByCriteriaResponse","description":"Files matching a caller-supplied criteria dict."},"FindSimilarCodeResponse":{"properties":{"source_project_id":{"type":"string","title":"Source Project Id"},"similar_code":{"anyOf":[{"items":{"$ref":"#/components/schemas/SimilarCodeResult"},"type":"array"},{"type":"null"}],"title":"Similar Code"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Present only on the error branch"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present only when status is error"}},"type":"object","required":["source_project_id"],"title":"FindSimilarCodeResponse","description":"Response for POST /cross-project/similar."},"FinishResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"form_route":{"type":"string","title":"Form Route"},"answers":{"additionalProperties":true,"type":"object","title":"Answers","default":{}},"idx":{"type":"integer","title":"Idx","default":0},"done":{"type":"boolean","title":"Done"},"eligibility":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Eligibility"}},"type":"object","required":["organization_id","form_route","done"],"title":"FinishResponse"},"FirstTokenDateResponse":{"properties":{"first_token_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Token Date"}},"type":"object","title":"FirstTokenDateResponse","description":"Organization's first-token-issued date."},"FixUsersTableResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"columns_added":{"items":{"type":"string"},"type":"array","title":"Columns Added"},"username_made_nullable":{"type":"boolean","title":"Username Made Nullable"}},"type":"object","required":["success","message","columns_added","username_made_nullable"],"title":"FixUsersTableResponse"},"FlagType":{"type":"string","enum":["boolean","percentage","plan_targeted"],"title":"FlagType","description":"Supported feature flag types."},"FlowComplexity":{"type":"string","enum":["simple","intermediate","advanced","expert"],"title":"FlowComplexity","description":"Flow complexity levels"},"FlushNamespaceResponse":{"properties":{"deleted_count":{"type":"integer","title":"Deleted Count"},"namespace":{"type":"string","title":"Namespace"},"project_id":{"type":"string","title":"Project Id"}},"type":"object","required":["deleted_count","namespace","project_id"],"title":"FlushNamespaceResponse"},"FolderContentsResponse":{"properties":{"folders":{"items":{"$ref":"#/components/schemas/FolderNode"},"type":"array","title":"Folders"},"files":{"items":{"$ref":"#/components/schemas/DocumentFile"},"type":"array","title":"Files"}},"type":"object","required":["folders","files"],"title":"FolderContentsResponse"},"FolderNode":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"parent_folder_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Folder Id"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"children":{"items":{"$ref":"#/components/schemas/FolderNode"},"type":"array","title":"Children"}},"type":"object","title":"FolderNode"},"FollowCreate":{"properties":{"followed_id":{"type":"string","format":"uuid","title":"Followed Id","description":"User ID to follow"},"notifications_enabled":{"type":"boolean","title":"Notifications Enabled","description":"Enable live notifications","default":true}},"type":"object","required":["followed_id"],"title":"FollowCreate","description":"Schema for following a streamer","example":{"followed_id":"550e8400-e29b-41d4-a716-446655440000","notifications_enabled":true}},"FollowNotificationResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"follower_id":{"type":"string","format":"uuid","title":"Follower Id"},"follower":{"$ref":"#/components/schemas/app__schemas__streaming__UserSummary"},"is_read":{"type":"boolean","title":"Is Read"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","user_id","follower_id","follower","is_read","created_at"],"title":"FollowNotificationResponse","description":"Schema for single follow notification response","example":{"created_at":"2025-12-23T14:30:00Z","follower":{"avatar_url":"https://storage.ainative.studio/avatars/follower.jpg","display_name":"New Follower","id":"aaa00000-e11b-22d3-a456-bbbbccccdddd","username":"newFollower123"},"follower_id":"aaa00000-e11b-22d3-a456-bbbbccccdddd","id":"notif-1111-2222-3333-4444-555566667777","is_read":false,"user_id":"550e8400-e29b-41d4-a716-446655440000"}},"FollowNotificationsListResponse":{"properties":{"notifications":{"items":{"$ref":"#/components/schemas/FollowNotificationResponse"},"type":"array","title":"Notifications"},"total":{"type":"integer","title":"Total","description":"Total notification count"},"page":{"type":"integer","minimum":1,"title":"Page","description":"Current page number"},"per_page":{"type":"integer","maximum":100,"minimum":1,"title":"Per Page","description":"Items per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more pages exist"},"unread_count":{"type":"integer","minimum":0,"title":"Unread Count","description":"Count of unread notifications"}},"type":"object","required":["notifications","total","page","per_page","has_more","unread_count"],"title":"FollowNotificationsListResponse","description":"Paginated list of follow notifications","example":{"has_more":true,"notifications":[{"created_at":"2025-12-23T14:30:00Z","follower":{"display_name":"New Follower","id":"aaa00000-e11b-22d3-a456-bbbbccccdddd","username":"newFollower123"},"follower_id":"aaa00000-e11b-22d3-a456-bbbbccccdddd","id":"notif-1111-2222-3333-4444-555566667777","is_read":false,"user_id":"550e8400-e29b-41d4-a716-446655440000"}],"page":1,"per_page":20,"total":42,"unread_count":15}},"FollowStatusResponse":{"properties":{"following":{"type":"boolean","title":"Following","description":"Whether the caller follows the target user"},"notifications_enabled":{"type":"boolean","title":"Notifications Enabled","description":"Whether go-live notifications are on for this follow (False when not following)","default":false}},"type":"object","required":["following"],"title":"FollowStatusResponse","description":"Caller's follow relationship with a target user.\n\nGET /streams/users/{username}/follow\n\nDeliberately strict (no `extra`): this payload is scoped to the\nauthenticated caller as the follower, and the follow row carries other\ncolumns (follower/followee ids, timestamps) that must NOT be echoed back.","example":{"following":true,"notifications_enabled":true}},"FollowerGrowthResponse":{"properties":{"timeline":{"items":{"$ref":"#/components/schemas/GrowthTimelinePoint"},"type":"array","title":"Timeline","description":"Daily follower growth data"},"period_days":{"type":"integer","minimum":1,"title":"Period Days","description":"Time period in days"},"total_new_followers":{"type":"integer","minimum":0,"title":"Total New Followers","description":"Total new followers in period"},"growth_rate_percent":{"type":"number","title":"Growth Rate Percent","description":"Growth rate as percentage"}},"type":"object","required":["timeline","period_days","total_new_followers","growth_rate_percent"],"title":"FollowerGrowthResponse","description":"Follower growth over time","example":{"growth_rate_percent":4.9,"period_days":30,"timeline":[{"date":"2025-12-01","new_followers":8,"total_followers":850},{"date":"2025-12-02","new_followers":12,"total_followers":862}],"total_new_followers":42}},"FollowerListResponse":{"properties":{"followers":{"items":{"$ref":"#/components/schemas/app__schemas__social__UserSummary"},"type":"array","title":"Followers","description":"List of follower users"},"total":{"type":"integer","title":"Total","description":"Total number of followers"},"offset":{"type":"integer","title":"Offset","description":"Number of items skipped"},"limit":{"type":"integer","title":"Limit","description":"Number of items per page"}},"type":"object","required":["followers","total","offset","limit"],"title":"FollowerListResponse","description":"Response for list of followers"},"FollowersResponse":{"properties":{"followers":{"items":{"$ref":"#/components/schemas/app__schemas__streaming__UserSummary"},"type":"array","title":"Followers"},"total":{"type":"integer","title":"Total","description":"Total follower count"}},"type":"object","required":["followers","total"],"title":"FollowersResponse","description":"Paginated list of followers","example":{"followers":[{"display_name":"Viewer User","id":"aaa00000-e11b-22d3-a456-bbbbccccdddd","username":"viewer123"}],"total":1250}},"FollowingListResponse":{"properties":{"following":{"items":{"$ref":"#/components/schemas/app__schemas__social__UserSummary"},"type":"array","title":"Following","description":"List of users being followed"},"total":{"type":"integer","title":"Total","description":"Total number of users being followed"},"offset":{"type":"integer","title":"Offset","description":"Number of items skipped"},"limit":{"type":"integer","title":"Limit","description":"Number of items per page"}},"type":"object","required":["following","total","offset","limit"],"title":"FollowingListResponse","description":"Response for list of users being followed"},"FollowingResponse":{"properties":{"following":{"items":{"$ref":"#/components/schemas/app__schemas__streaming__UserSummary"},"type":"array","title":"Following"},"total":{"type":"integer","title":"Total","description":"Total following count"}},"type":"object","required":["following","total"],"title":"FollowingResponse","description":"Paginated list of followed streamers","example":{"following":[{"display_name":"John Doe","id":"550e8400-e29b-41d4-a716-446655440000","username":"johndoe"}],"total":42}},"ForecastResponse":{"properties":{"status":{"type":"string","title":"Status"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"}},"type":"object","required":["status","data"],"title":"ForecastResponse","description":"Shared shape for request-volume and token-cost forecasts. Refs #3410"},"ForgetEntityResponse":{"properties":{"entity_id":{"type":"string","title":"Entity Id"},"entity_name":{"type":"string","title":"Entity Name"},"edges_removed":{"type":"integer","title":"Edges Removed"},"memories_removed":{"type":"integer","title":"Memories Removed"},"cascade":{"type":"boolean","title":"Cascade"}},"type":"object","required":["entity_id","entity_name","edges_removed","memories_removed","cascade"],"title":"ForgetEntityResponse"},"ForgetRequest":{"properties":{"memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Id","description":"ID of the memory to forget (omit for bulk namespace clear)"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace","description":"Namespace to bulk-clear. Requires explicit namespace string. Refs #2884"}},"type":"object","title":"ForgetRequest"},"ForgetResponse":{"properties":{"memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Id"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"deleted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Deleted","description":"Rows deleted. Only present for a namespace bulk-clear."},"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"ForgetResponse","description":"ZeroMemory.forget() returns one of 3 shapes depending on which of\nmemory_id/namespace was passed — all fields Optional, `status` is the\nonly one always present."},"ForgotPasswordRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"app":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App"}},"type":"object","required":["email"],"title":"ForgotPasswordRequest","description":"Schema for forgot password request"},"ForgotPasswordResponse":{"properties":{"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["message"],"title":"ForgotPasswordResponse","description":"POST /auth/forgot-password\n\nAlways returns success regardless of whether the email exists (privacy-\npreserving, prevents account enumeration)."},"ForkAgentResponse":{"properties":{"status":{"type":"string","title":"Status"},"new_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Agent Id"},"source_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Agent Id"},"snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Id"},"forked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Forked At"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"ForkAgentResponse","description":"workspace_snapshot_service.fork_agent()"},"FormDetailResponse":{"properties":{"form_route":{"type":"string","title":"Form Route"},"title":{"type":"string","title":"Title"},"questions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Questions"}},"type":"object","required":["form_route","title","questions"],"title":"FormDetailResponse","description":"A form's full question set. Each question is a heterogeneous dict —\nfields vary by question ``type`` (see tax_forms.py's own docstring for\nthe field set), so ``questions`` is intentionally untyped per-item."},"FormListResponse":{"properties":{"forms":{"items":{"$ref":"#/components/schemas/FormSummary"},"type":"array","title":"Forms"}},"type":"object","required":["forms"],"title":"FormListResponse"},"FormSummary":{"properties":{"form_route":{"type":"string","title":"Form Route"},"title":{"type":"string","title":"Title"},"question_count":{"type":"integer","title":"Question Count"}},"type":"object","required":["form_route","title","question_count"],"title":"FormSummary"},"FormationDocsResponse":{"properties":{"formation_documents":{"items":{"$ref":"#/components/schemas/FormationDocument"},"type":"array","title":"Formation Documents"},"company":{"type":"string","title":"Company"},"link_ttl_seconds":{"type":"integer","title":"Link Ttl Seconds"},"note":{"type":"string","title":"Note"}},"type":"object","required":["formation_documents","company","link_ttl_seconds","note"],"title":"FormationDocsResponse"},"FormationDocument":{"properties":{"name":{"type":"string","title":"Name"},"file_id":{"type":"string","title":"File Id"},"purpose":{"type":"string","title":"Purpose"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["name","file_id","purpose"],"title":"FormationDocument"},"FragmentMetadata":{"properties":{"file_path":{"type":"string","title":"File Path","description":"Relative file path within the repo"},"line_start":{"type":"integer","minimum":0,"title":"Line Start","description":"First line of the fragment (1-based)"},"line_end":{"type":"integer","minimum":0,"title":"Line End","description":"Last line of the fragment (inclusive)"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Programming language"},"file_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Hash","description":"SHA of the file for change detection"}},"type":"object","required":["file_path","line_start","line_end"],"title":"FragmentMetadata"},"FrequencyCap":{"properties":{"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Maximum impressions per user within time window"},"window":{"type":"string","title":"Window","description":"Time window: 'hour', 'day', or 'week'"}},"type":"object","required":["limit","window"],"title":"FrequencyCap","description":"Frequency cap configuration for campaign\n\nIssue #613: Limits impressions per user to prevent ad fatigue\n\nLimits how many times a user can see ads from this campaign\nwithin a given time window (hour, day, or week).","example":{"limit":3,"window":"day"}},"FreshApiKeyItem":{"properties":{"email":{"type":"string","title":"Email"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"api_key":{"type":"string","title":"Api Key"},"key_name":{"type":"string","title":"Key Name"}},"type":"object","required":["email","api_key","key_name"],"title":"FreshApiKeyItem"},"FriendListResponse":{"properties":{"friends":{"items":{"$ref":"#/components/schemas/app__schemas__social__UserSummary"},"type":"array","title":"Friends","description":"List of friends"},"total":{"type":"integer","title":"Total","description":"Total number of friends"},"offset":{"type":"integer","title":"Offset","description":"Number of items skipped"},"limit":{"type":"integer","title":"Limit","description":"Number of items per page"}},"type":"object","required":["friends","total","offset","limit"],"title":"FriendListResponse","description":"Response for list of friends"},"FriendRequestCreate":{"properties":{"message":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Message","description":"Optional message with the request","examples":["Hey! Let's connect on AINative!"]}},"type":"object","title":"FriendRequestCreate","description":"Schema for creating a friend request","examples":[{"message":"Hey! Let's connect on AINative!"}]},"FriendRequestListResponse":{"properties":{"requests":{"items":{"$ref":"#/components/schemas/FriendRequestResponse"},"type":"array","title":"Requests","description":"List of friend requests"},"total":{"type":"integer","title":"Total","description":"Total number of requests"},"offset":{"type":"integer","title":"Offset","description":"Number of items skipped"},"limit":{"type":"integer","title":"Limit","description":"Number of items per page"}},"type":"object","required":["requests","total","offset","limit"],"title":"FriendRequestListResponse","description":"Response for list of friend requests"},"FriendRequestResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Friend request ID"},"requester_id":{"type":"string","title":"Requester Id","description":"Requester user ID"},"recipient_id":{"type":"string","title":"Recipient Id","description":"Recipient user ID"},"status":{"type":"string","title":"Status","description":"Request status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Optional message"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the request was created"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"When the request was last updated"},"sender":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__social__UserSummary"},{"type":"null"}],"description":"Sender user details"},"receiver":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__social__UserSummary"},{"type":"null"}],"description":"Receiver user details"}},"type":"object","required":["id","requester_id","recipient_id","status","created_at"],"title":"FriendRequestResponse","description":"Response for friend request operations"},"FriendshipResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Friendship ID"},"user1_id":{"type":"string","title":"User1 Id","description":"First user ID"},"user2_id":{"type":"string","title":"User2 Id","description":"Second user ID"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the friendship was established"},"friend":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__social__UserSummary"},{"type":"null"}],"description":"Friend user details"}},"type":"object","required":["id","user1_id","user2_id","created_at"],"title":"FriendshipResponse","description":"Response for friendship operations"},"FrontendConnectivityTestResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"user_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Role"},"request_info":{"$ref":"#/components/schemas/FrontendTestRequestInfo"},"deployment_info":{"$ref":"#/components/schemas/FrontendTestDeploymentInfo"}},"type":"object","required":["success","message","timestamp","request_info","deployment_info"],"title":"FrontendConnectivityTestResponse","description":"Response for GET /debug/frontend-test."},"FrontendTestDeploymentInfo":{"properties":{"backend_version":{"type":"string","title":"Backend Version"},"endpoints_available":{"items":{"type":"string"},"type":"array","title":"Endpoints Available"}},"type":"object","required":["backend_version","endpoints_available"],"title":"FrontendTestDeploymentInfo"},"FrontendTestRequestInfo":{"properties":{"method":{"type":"string","title":"Method"},"url":{"type":"string","title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers"},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client"}},"type":"object","required":["method","url","headers"],"title":"FrontendTestRequestInfo"},"FullAuditRequest":{"properties":{"url":{"type":"string","title":"Url","description":"URL to scan"},"industry":{"type":"string","title":"Industry","description":"Industry for benchmark comparison","default":"saas"},"include_in_leaderboard":{"type":"boolean","title":"Include In Leaderboard","description":"Explicit opt-in to include this scan's domain and score on the public Agentic Web Index leaderboard. Defaults to False — scans are private unless the caller opts in. Refs #9079","default":false},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id","description":"Which agent-simulation task to run: one of find_pricing (default), start_trial, find_docs, find_support (ax_agent_simulation.SIMULATION_TASKS). Omit for the existing default behavior (find_pricing) — no breaking change for existing callers. Refs #9494."}},"type":"object","required":["url"],"title":"FullAuditRequest"},"FullAuditResponse":{"properties":{"report_id":{"type":"string","title":"Report Id"},"url":{"type":"string","title":"Url"},"score":{"type":"integer","title":"Score"},"max_score":{"type":"integer","title":"Max Score"},"grade":{"type":"string","title":"Grade"},"checks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Checks"},"scanned_at":{"type":"string","title":"Scanned At"},"simulation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Simulation"},"benchmark":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Benchmark"},"recommendations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recommendations"},"peer_comparison":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Peer Comparison","description":"Graph/leaderboard/percentile peer comparison for the Business Brief (core#9377, core#9517). `source=\"graph\"` carries real named gaps against a same-account peer; `source=\"leaderboard\"` carries real named gaps against a public leaderboard peer when no same-account peer exists; `source=\"percentile\"` is the retained percentile fallback. Omitted (null) on the report read path, which stays within its existing load budget — fetch it from GET /ax-audit/reports/{id}/peer-comparison and render it async."}},"type":"object","required":["report_id","url","score","max_score","grade","checks","scanned_at"],"title":"FullAuditResponse"},"FullProfileData":{"properties":{"id":{"type":"string","title":"Id"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"banner_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Banner Url"},"cover_photo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Photo Url"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"ask_me_anything":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ask Me Anything"},"social_links":{"additionalProperties":true,"type":"object","title":"Social Links"},"is_partner":{"type":"boolean","title":"Is Partner","default":false},"is_affiliate":{"type":"boolean","title":"Is Affiliate","default":false},"total_stream_hours":{"type":"number","title":"Total Stream Hours","default":0},"profile_visibility":{"type":"string","title":"Profile Visibility","default":"public"},"show_online_status":{"type":"boolean","title":"Show Online Status","default":true},"allow_messages_from":{"type":"string","title":"Allow Messages From","default":"everyone"},"show_read_receipts":{"type":"boolean","title":"Show Read Receipts","default":true},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"followers_count":{"type":"integer","title":"Followers Count","default":0},"following_count":{"type":"integer","title":"Following Count","default":0},"friends_count":{"type":"integer","title":"Friends Count","default":0},"posts_count":{"type":"integer","title":"Posts Count","default":0}},"type":"object","required":["id"],"title":"FullProfileData","description":"Full profile payload returned by ProfileService.get_profile() when the\nviewer is authorized to see the complete profile (Issue #2191 response\nmodel coverage — mirrors the handler's literal return dict field-for-field)."},"FullSystemRestoreCapability":{"properties":{"available":{"type":"boolean","title":"Available"},"estimated_time_hours":{"type":"integer","title":"Estimated Time Hours"},"automated":{"type":"boolean","title":"Automated"}},"type":"object","required":["available","estimated_time_hours","automated"],"title":"FullSystemRestoreCapability"},"FundWalletRequest":{"properties":{"amount_usd":{"type":"number","exclusiveMinimum":0,"title":"Amount Usd","description":"Amount to add (USD)"},"source":{"type":"string","title":"Source","description":"Funding source: stripe, circle, manual","default":"stripe"}},"type":"object","required":["amount_usd"],"title":"FundWalletRequest"},"FundWalletResponse":{"properties":{"transaction_id":{"type":"string","title":"Transaction Id"},"agent_id":{"type":"string","title":"Agent Id"},"amount_usd":{"type":"number","title":"Amount Usd"},"new_balance_usd":{"type":"number","title":"New Balance Usd"},"source":{"type":"string","title":"Source"}},"type":"object","required":["transaction_id","agent_id","amount_usd","new_balance_usd","source"],"title":"FundWalletResponse"},"FunnelStageRequest":{"properties":{"session_id":{"type":"string","title":"Session Id","description":"User session ID"},"stage":{"type":"string","title":"Stage","description":"Funnel stage: visited_pricing, started_checkout, etc."},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"utm_params":{"anyOf":[{"$ref":"#/components/schemas/UTMParams"},{"type":"null"}]},"conversion_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Conversion Value"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["session_id","stage"],"title":"FunnelStageRequest","description":"Request schema for updating funnel stage"},"FunnelStageResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"FunnelStageResponse","description":"Response for POST /funnel"},"GarbageCollectResponse":{"properties":{"status":{"type":"string","title":"Status"},"agents_collected":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Agents Collected"},"agent_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Agent Ids"},"collected_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collected At"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"GarbageCollectResponse","description":"state_expiry_service.garbage_collect()"},"GatewaySearchResponse":{"properties":{"message":{"$ref":"#/components/schemas/app__api__v1__endpoints__beckn_network__BecknAckMessage"},"context":{"additionalProperties":true,"type":"object","title":"Context"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"bpp_count":{"type":"integer","title":"Bpp Count"},"forwarded":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forwarded"},"errors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Errors"}},"type":"object","required":["message","context","bpp_count"],"title":"GatewaySearchResponse"},"GeneralSettingsRecord":{"properties":{"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"legal_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name"},"ein":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ein"},"incorporation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incorporation Date"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"address_line1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line1"},"address_line2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line2"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"signing_officer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signing Officer Name"},"signing_officer_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signing Officer Title"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","title":"GeneralSettingsRecord"},"GenerateDatabaseWithZerodbResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"database_type":{"type":"string","title":"Database Type"},"schema_sql":{"title":"Schema Sql"},"migration_files":{"title":"Migration Files"},"model_definitions":{"title":"Model Definitions"},"api_endpoints":{"title":"Api Endpoints"},"database_config":{"title":"Database Config"},"sample_data_sql":{"title":"Sample Data Sql"},"performance_suggestions":{"title":"Performance Suggestions"},"generation_metadata":{"$ref":"#/components/schemas/DatabaseGenerationMetadata"}},"type":"object","required":["project_id","database_type","generation_metadata"],"title":"GenerateDatabaseWithZerodbResponse"},"GenerateFilePresignedUrlResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"GenerateFilePresignedUrlResponse"},"GenerateFreshApiKeysResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"keys":{"items":{"$ref":"#/components/schemas/FreshApiKeyItem"},"type":"array","title":"Keys"},"api_base_url":{"type":"string","title":"Api Base Url"},"usage":{"type":"string","title":"Usage"}},"type":"object","required":["success","message","keys","api_base_url","usage"],"title":"GenerateFreshApiKeysResponse"},"GeneratePeriodsResponse":{"properties":{"count":{"type":"integer","title":"Count"},"periods":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Periods"}},"type":"object","required":["count","periods"],"title":"GeneratePeriodsResponse"},"GeneratePresignedDownloadUrlResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"file_path":{"type":"string","title":"File Path"},"presigned_url":{"type":"string","title":"Presigned Url"},"expires_in_seconds":{"type":"integer","title":"Expires In Seconds"},"expires_at":{"type":"string","title":"Expires At"},"generated_at":{"type":"string","title":"Generated At"},"status":{"type":"string","title":"Status"}},"type":"object","required":["project_id","file_path","presigned_url","expires_in_seconds","expires_at","generated_at","status"],"title":"GeneratePresignedDownloadUrlResponse"},"GeneratePresignedUrlResponse":{"properties":{"presigned_url":{"type":"string","title":"Presigned Url"},"file_id":{"type":"string","title":"File Id"},"file_name":{"type":"string","title":"File Name"},"expires_at":{"type":"string","title":"Expires At"},"expiry_minutes":{"type":"integer","title":"Expiry Minutes"},"operation_type":{"type":"string","title":"Operation Type"}},"type":"object","required":["presigned_url","file_id","file_name","expires_at","expiry_minutes","operation_type"],"title":"GeneratePresignedUrlResponse","description":"generate_presigned_url returns db_service.generate_presigned_url's\nresult verbatim, per DatabaseService.generate_presigned_url."},"GenerateRecommendationsRequest":{"properties":{"analysis_window_days":{"type":"integer","maximum":365,"minimum":1,"title":"Analysis Window Days","description":"Analysis window in days","default":30},"force_refresh":{"type":"boolean","title":"Force Refresh","description":"Force refresh of cached recommendations","default":false},"include_experimental":{"type":"boolean","title":"Include Experimental","description":"Include experimental recommendations","default":false}},"type":"object","title":"GenerateRecommendationsRequest"},"GenerateResultResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"vendor_count":{"type":"integer","title":"Vendor Count"},"vendor_ids":{"items":{"type":"string"},"type":"array","title":"Vendor Ids"},"confirmation_document":{"additionalProperties":true,"type":"object","title":"Confirmation Document"},"toast_message":{"type":"string","title":"Toast Message"}},"type":"object","required":["task_id","vendor_count","vendor_ids","confirmation_document","toast_message"],"title":"GenerateResultResponse"},"GenerateStatusResponse":{"properties":{"can_generate":{"type":"boolean","title":"Can Generate"},"ready_count":{"type":"integer","title":"Ready Count"},"confirm_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confirm Message"}},"type":"object","required":["can_generate","ready_count"],"title":"GenerateStatusResponse"},"GenerateTemplateResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"template":{"$ref":"#/components/schemas/GeneratedTemplateSummary"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","template","timestamp"],"title":"GenerateTemplateResponse","description":"Response for POST /langflow-templates/generate."},"GenerateTestCasesResponse":{"properties":{"template_id":{"type":"string","title":"Template Id"},"version_id":{"type":"string","title":"Version Id"},"test_cases":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Test Cases"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["template_id","version_id","test_cases","count"],"title":"GenerateTestCasesResponse"},"GenerateTokenResponse":{"properties":{"token":{"type":"string","title":"Token"},"expires_at":{"type":"string","title":"Expires At"},"ttl_seconds":{"type":"integer","title":"Ttl Seconds"}},"type":"object","required":["token","expires_at","ttl_seconds"],"title":"GenerateTokenResponse"},"GeneratedFile":{"properties":{"path":{"type":"string","title":"Path"},"content":{"type":"string","title":"Content"},"language":{"type":"string","title":"Language"}},"type":"object","required":["path","content","language"],"title":"GeneratedFile","description":"A single AI-generated WordPress file."},"GeneratedTemplateSummary":{"properties":{"template_id":{"type":"string","title":"Template Id"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"complexity":{"type":"string","title":"Complexity"},"components":{"items":{"type":"string"},"type":"array","title":"Components"},"files":{"items":{"type":"string"},"type":"array","title":"Files"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["template_id","name","type","complexity","components","files","metadata"],"title":"GeneratedTemplateSummary","description":"The trimmed template summary returned by POST /generate (not the\nfull stored template — only id/name/type/complexity/components/file\nnames/metadata)."},"GeographicBreakdown":{"properties":{"country_code":{"type":"string","maxLength":2,"minLength":2,"title":"Country Code","description":"ISO 3166-1 alpha-2 country code"},"country_name":{"type":"string","title":"Country Name","description":"Country name"},"viewer_count":{"type":"integer","minimum":0,"title":"Viewer Count","description":"Number of viewers from this country"},"percentage":{"type":"number","maximum":100,"minimum":0,"title":"Percentage","description":"Percentage of total viewers"}},"type":"object","required":["country_code","country_name","viewer_count","percentage"],"title":"GeographicBreakdown","description":"Geographic viewer distribution by country","example":{"country_code":"US","country_name":"United States","percentage":36.5,"viewer_count":187}},"GeographicBreakdownItem":{"properties":{"country_code":{"type":"string","maxLength":2,"minLength":2,"title":"Country Code","description":"ISO 3166-1 alpha-2 country code"},"viewer_count":{"type":"integer","minimum":0,"title":"Viewer Count","description":"Total viewers from this country"},"authenticated_viewers":{"type":"integer","minimum":0,"title":"Authenticated Viewers","description":"Authenticated viewers from this country"},"anonymous_viewers":{"type":"integer","minimum":0,"title":"Anonymous Viewers","description":"Anonymous viewers from this country"},"percentage":{"type":"number","maximum":100,"minimum":0,"title":"Percentage","description":"Percentage of total viewers"}},"type":"object","required":["country_code","viewer_count","authenticated_viewers","anonymous_viewers","percentage"],"title":"GeographicBreakdownItem","description":"Geographic breakdown by country","example":{"anonymous_viewers":181,"authenticated_viewers":342,"country_code":"US","percentage":36.5,"viewer_count":523}},"GeographicBreakdownResponse":{"properties":{"stream_id":{"type":"string","format":"uuid","title":"Stream Id"},"breakdown":{"items":{"$ref":"#/components/schemas/GeographicBreakdown"},"type":"array","title":"Breakdown"},"total_viewers":{"type":"integer","minimum":0,"title":"Total Viewers","description":"Total viewers with country data"}},"type":"object","required":["stream_id","breakdown","total_viewers"],"title":"GeographicBreakdownResponse","description":"List of geographic viewer distribution","example":{"breakdown":[{"country_code":"US","country_name":"United States","percentage":36.5,"viewer_count":187},{"country_code":"GB","country_name":"United Kingdom","percentage":18,"viewer_count":92},{"country_code":"CA","country_name":"Canada","percentage":10.5,"viewer_count":54}],"stream_id":"987e6543-e21b-12d3-a456-426614174000","total_viewers":512}},"GetAbTestResultsResponse":{"properties":{"test_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Test Id"},"template_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Id"},"version_a_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version A Id"},"version_b_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version B Id"},"tested_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tested At"},"winner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Winner"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"version_a_performance":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Version A Performance"},"version_b_performance":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Version B Performance"},"recommendations":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Recommendations"},"detailed_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Detailed Results"},"duration_seconds":{"anyOf":[{},{"type":"null"}],"title":"Duration Seconds"}},"additionalProperties":true,"type":"object","title":"GetAbTestResultsResponse","description":"Returns whatever was previously cached under `ab_test_results:{test_id}`\nverbatim (see PromptEvaluationService._process_ab_test_results for the\nshape it writes in the real flow). Modeled with every field optional and\nextra=\"allow\" since the handler is a pure cache passthrough -- it does not\nitself guarantee any particular shape, and callers/tests may exercise it\nwith a partial or synthetic cached value."},"GetAgentLearningHistoryResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"tasks":{"items":{"$ref":"#/components/schemas/AgentLearningTaskSummary"},"type":"array","title":"Tasks"},"total_tasks":{"type":"integer","title":"Total Tasks"}},"type":"object","required":["agent_id","tasks","total_tasks"],"title":"GetAgentLearningHistoryResponse"},"GetAgentLogsMetricsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"time_range_hours":{"type":"integer","title":"Time Range Hours"},"timestamp":{"type":"string","title":"Timestamp"},"active_agents":{"type":"integer","title":"Active Agents"},"completed_tasks":{"type":"integer","title":"Completed Tasks"},"error_rate":{"type":"number","title":"Error Rate"},"avg_duration_ms":{"type":"number","title":"Avg Duration Ms"},"total_logs":{"type":"integer","title":"Total Logs"},"total_sessions":{"type":"integer","title":"Total Sessions"},"logs_by_level":{"additionalProperties":{"type":"integer"},"type":"object","title":"Logs By Level"},"recent_errors":{"items":{"$ref":"#/components/schemas/AgentLogsRecentError"},"type":"array","title":"Recent Errors"},"agent_ids":{"items":{"type":"string"},"type":"array","title":"Agent Ids"}},"type":"object","required":["project_id","time_range_hours","timestamp","active_agents","completed_tasks","error_rate","avg_duration_ms","total_logs","total_sessions","logs_by_level","recent_errors","agent_ids"],"title":"GetAgentLogsMetricsResponse"},"GetAgentLogsStatsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"total_logs":{"type":"integer","title":"Total Logs"},"log_levels":{"additionalProperties":{"type":"integer"},"type":"object","title":"Log Levels"},"unique_agents":{"type":"integer","title":"Unique Agents"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["project_id","total_logs","log_levels","unique_agents","timestamp"],"title":"GetAgentLogsStatsResponse"},"GetAgentPerformanceResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"total_interactions":{"type":"integer","title":"Total Interactions"},"successful_interactions":{"type":"integer","title":"Successful Interactions"},"success_rate_percent":{"type":"number","title":"Success Rate Percent"},"average_duration_ms":{"type":"number","title":"Average Duration Ms"},"average_rating":{"type":"number","title":"Average Rating"}},"type":"object","required":["agent_id","total_interactions","successful_interactions","success_rate_percent","average_duration_ms","average_rating"],"title":"GetAgentPerformanceResponse"},"GetAgentSwarmProjectResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"project_type":{"type":"string","title":"Project Type"},"description":{"type":"string","title":"Description"},"status":{"type":"string","title":"Status"},"current_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Stage"},"agents_config":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Agents Config"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"overall_progress":{"type":"integer","title":"Overall Progress"},"estimated_completion":{"type":"string","title":"Estimated Completion"},"logs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Logs"},"tier":{"anyOf":[{},{"type":"null"}],"title":"Tier"},"database_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Database Enabled"},"workflow_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Id"},"stages_completed":{"type":"integer","title":"Stages Completed"},"errors":{"items":{},"type":"array","title":"Errors"},"warnings":{"items":{},"type":"array","title":"Warnings"}},"type":"object","required":["project_id","project_name","project_type","description","status","agents_config","created_at","updated_at","overall_progress","estimated_completion","logs","stages_completed","errors","warnings"],"title":"GetAgentSwarmProjectResponse"},"GetAgentTraceResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"time_window_minutes":{"type":"integer","title":"Time Window Minutes"},"timestamp":{"type":"string","title":"Timestamp"},"total_events":{"type":"integer","title":"Total Events"},"trace_events":{"items":{"$ref":"#/components/schemas/AgentTraceEvent"},"type":"array","title":"Trace Events"},"sessions":{"items":{"$ref":"#/components/schemas/AgentTraceSessionSummary"},"type":"array","title":"Sessions"},"total_sessions":{"type":"integer","title":"Total Sessions"},"agents":{"items":{"$ref":"#/components/schemas/AgentTraceAgentSummary"},"type":"array","title":"Agents"},"total_agents":{"type":"integer","title":"Total Agents"},"filters":{"$ref":"#/components/schemas/AgentTraceFilters"}},"type":"object","required":["project_id","time_window_minutes","timestamp","total_events","trace_events","sessions","total_sessions","agents","total_agents","filters"],"title":"GetAgentTraceResponse"},"GetAgentTypesResponse":{"properties":{"agent_types":{"items":{"type":"string"},"type":"array","title":"Agent Types"}},"type":"object","required":["agent_types"],"title":"GetAgentTypesResponse"},"GetAlertRulesResponse":{"properties":{"alert_rules":{"items":{"$ref":"#/components/schemas/AlertRuleConfig"},"type":"array","title":"Alert Rules"},"total_rules":{"type":"integer","title":"Total Rules"}},"type":"object","required":["alert_rules","total_rules"],"title":"GetAlertRulesResponse","description":"GET /deployment/alert-rules — all configured alert rules."},"GetAuditLogsResponse":{"properties":{"logs":{"items":{"$ref":"#/components/schemas/app__schemas__admin__audit__AuditLogEntry"},"type":"array","title":"Logs"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"skip":{"type":"integer","title":"Skip"},"filters_applied":{"$ref":"#/components/schemas/AuditLogFiltersApplied"}},"type":"object","required":["logs","total","limit","skip","filters_applied"],"title":"GetAuditLogsResponse"},"GetAuditSummaryResponse":{"properties":{"period":{"type":"string","title":"Period"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"total_events":{"type":"integer","title":"Total Events"},"high_severity_events":{"type":"integer","title":"High Severity Events"},"failed_logins":{"type":"integer","title":"Failed Logins"},"successful_logins":{"type":"integer","title":"Successful Logins"},"user_changes":{"type":"integer","title":"User Changes"},"admin_actions":{"type":"integer","title":"Admin Actions"},"data_exports":{"type":"integer","title":"Data Exports"},"compliance_events":{"type":"integer","title":"Compliance Events"},"top_actions":{"items":{"$ref":"#/components/schemas/AuditTopAction"},"type":"array","title":"Top Actions"},"top_users":{"items":{"$ref":"#/components/schemas/AuditTopUser"},"type":"array","title":"Top Users"},"hourly_distribution":{"items":{"$ref":"#/components/schemas/AuditHourlyBucket"},"type":"array","title":"Hourly Distribution"},"risk_indicators":{"$ref":"#/components/schemas/AuditRiskIndicators"}},"type":"object","required":["period","start_date","end_date","total_events","high_severity_events","failed_logins","successful_logins","user_changes","admin_actions","data_exports","compliance_events","top_actions","top_users","hourly_distribution","risk_indicators"],"title":"GetAuditSummaryResponse"},"GetCollaborationDataResponse":{"properties":{"active_teams":{"type":"integer","title":"Active Teams"},"shared_projects":{"type":"integer","title":"Shared Projects"},"comments_today":{"type":"integer","title":"Comments Today"},"active_sessions":{"type":"integer","title":"Active Sessions"},"recent_logins_24h":{"type":"integer","title":"Recent Logins 24H"},"team_members":{"items":{"$ref":"#/components/schemas/TeamMember"},"type":"array","title":"Team Members"},"collaboration_metrics":{"$ref":"#/components/schemas/CollaborationMetrics"}},"type":"object","required":["active_teams","shared_projects","comments_today","active_sessions","recent_logins_24h","team_members","collaboration_metrics"],"title":"GetCollaborationDataResponse"},"GetCrossProjectContextResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Present only on not_found/error branches"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"relationships":{"anyOf":[{"items":{"$ref":"#/components/schemas/ProjectRelationshipEntry"},"type":"array"},{"type":"null"}],"title":"Relationships"},"organization_projects":{"anyOf":[{"items":{"$ref":"#/components/schemas/OrganizationProjectRef"},"type":"array"},{"type":"null"}],"title":"Organization Projects"},"common_dependencies":{"anyOf":[{"items":{"$ref":"#/components/schemas/SharedDependency"},"type":"array"},{"type":"null"}],"title":"Common Dependencies"},"cross_references":{"anyOf":[{"items":{"$ref":"#/components/schemas/CrossReferenceSummary"},"type":"array"},{"type":"null"}],"title":"Cross References"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present only when status is error"}},"type":"object","required":["project_id"],"title":"GetCrossProjectContextResponse","description":"Response for GET /cross-project/context (CrossProjectResolver.get_cross_project_context)."},"GetDatabaseHealthResponse":{"properties":{"overall_health":{"type":"string","title":"Overall Health"},"last_checked":{"type":"string","title":"Last Checked"},"checks":{"$ref":"#/components/schemas/DatabaseHealthChecks"},"performance_indicators":{"$ref":"#/components/schemas/PerformanceIndicators"},"alerts":{"items":{"type":"string"},"type":"array","title":"Alerts"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["overall_health","last_checked","checks","performance_indicators","alerts","recommendations"],"title":"GetDatabaseHealthResponse"},"GetDatabaseMetricsResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"period":{"type":"string","title":"Period"},"overall_performance":{"$ref":"#/components/schemas/OverallPerformance"},"database_statistics":{"$ref":"#/components/schemas/DatabaseStatistics"},"connection_metrics":{"$ref":"#/components/schemas/ConnectionPoolMetrics"},"query_performance":{"$ref":"#/components/schemas/QueryPerformanceMetrics"},"index_usage":{"$ref":"#/components/schemas/IndexUsageMetrics"},"table_metrics":{"$ref":"#/components/schemas/TableSizeMetrics"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["timestamp","period","overall_performance","database_statistics","connection_metrics","query_performance","index_usage","table_metrics","recommendations"],"title":"GetDatabaseMetricsResponse"},"GetDatabaseStatusResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"database_enabled":{"type":"boolean","title":"Database Enabled"},"vector_dimensions":{"type":"integer","title":"Vector Dimensions"},"quantum_enabled":{"type":"boolean","title":"Quantum Enabled"},"mcp_enabled":{"type":"boolean","title":"Mcp Enabled"},"config":{"additionalProperties":true,"type":"object","title":"Config"},"usage":{"$ref":"#/components/schemas/DatabaseStatusUsage"}},"type":"object","required":["project_id","database_enabled","vector_dimensions","quantum_enabled","mcp_enabled","config","usage"],"title":"GetDatabaseStatusResponse"},"GetDisasterRecoveryDashboardResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"backup_status":{"$ref":"#/components/schemas/BackupStatusOverview"},"recovery_capabilities":{"$ref":"#/components/schemas/RecoveryCapabilities"},"system_health":{"$ref":"#/components/schemas/SystemHealthForDr"},"backup_schedule":{"$ref":"#/components/schemas/BackupScheduleStatus"},"storage_capacity":{"$ref":"#/components/schemas/StorageCapacityAnalysis"},"compliance_status":{"additionalProperties":true,"type":"object","title":"Compliance Status"},"recent_operations":{"items":{"$ref":"#/components/schemas/DrOperationEntry"},"type":"array","title":"Recent Operations"},"risk_assessment":{"$ref":"#/components/schemas/DisasterRiskAssessment"}},"type":"object","required":["timestamp","backup_status","recovery_capabilities","system_health","backup_schedule","storage_capacity","compliance_status","recent_operations","risk_assessment"],"title":"GetDisasterRecoveryDashboardResponse"},"GetDrComplianceStatusResponse":{"properties":{"backup_frequency":{"additionalProperties":true,"type":"object","title":"Backup Frequency"},"retention_policy":{"additionalProperties":true,"type":"object","title":"Retention Policy"},"testing_schedule":{"additionalProperties":true,"type":"object","title":"Testing Schedule"},"geographical_distribution":{"additionalProperties":true,"type":"object","title":"Geographical Distribution"},"encryption_status":{"additionalProperties":true,"type":"object","title":"Encryption Status"},"access_controls":{"additionalProperties":true,"type":"object","title":"Access Controls"},"documentation":{"additionalProperties":true,"type":"object","title":"Documentation"},"overall_score":{"type":"number","title":"Overall Score"}},"type":"object","required":["backup_frequency","retention_policy","testing_schedule","geographical_distribution","encryption_status","access_controls","documentation","overall_score"],"title":"GetDrComplianceStatusResponse"},"GetEnterpriseAuditLogsResponse":{"properties":{"logs":{"items":{"$ref":"#/components/schemas/EnterpriseAuditLogEntry"},"type":"array","title":"Logs"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["logs","total"],"title":"GetEnterpriseAuditLogsResponse"},"GetEnterprisePerformanceMetricsResponse":{"properties":{"avg_latency_ms":{"title":"Avg Latency Ms"},"p95_latency_ms":{"title":"P95 Latency Ms"},"requests_today":{"type":"integer","title":"Requests Today"},"errors_today":{"type":"integer","title":"Errors Today"},"error_rate_pct":{"type":"number","title":"Error Rate Pct"},"uptime_pct":{"type":"number","title":"Uptime Pct"}},"type":"object","required":["avg_latency_ms","p95_latency_ms","requests_today","errors_today","error_rate_pct","uptime_pct"],"title":"GetEnterprisePerformanceMetricsResponse"},"GetEvaluationDashboardResponse":{"properties":{"overview":{"$ref":"#/components/schemas/EvaluationDashboardOverview"},"recent_evaluations":{"items":{},"type":"array","title":"Recent Evaluations"},"categories":{"title":"Categories"},"most_used_templates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Most Used Templates"},"evaluation_trends":{"$ref":"#/components/schemas/EvaluationDashboardTrends"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["overview","recent_evaluations","categories","most_used_templates","evaluation_trends","recommendations"],"title":"GetEvaluationDashboardResponse"},"GetEvaluationHistoryResponse":{"properties":{"version_id":{"type":"string","title":"Version Id"},"history":{"items":{},"type":"array","title":"History"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["version_id","history","count"],"title":"GetEvaluationHistoryResponse"},"GetEvaluatorsForCategoryResponse":{"properties":{"category":{"type":"string","title":"Category"},"evaluators":{"items":{"type":"string"},"type":"array","title":"Evaluators"},"descriptions":{"additionalProperties":{"type":"string"},"type":"object","title":"Descriptions"}},"type":"object","required":["category","evaluators","descriptions"],"title":"GetEvaluatorsForCategoryResponse"},"GetEventStatsResponse":{"properties":{"total_events":{"type":"integer","title":"Total Events"},"events_by_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"Events By Type"},"events_by_source":{"additionalProperties":{"type":"integer"},"type":"object","title":"Events By Source"},"events_per_hour":{"type":"number","title":"Events Per Hour"},"events_per_day":{"type":"number","title":"Events Per Day"},"time_range":{"type":"string","title":"Time Range"}},"type":"object","required":["total_events","events_by_type","events_by_source","events_per_hour","events_per_day","time_range"],"title":"GetEventStatsResponse"},"GetFileMetadataResponse":{"properties":{"file_path":{"type":"string","title":"File Path"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Present only for not_found/error branches"},"file_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"current_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Hash"},"first_seen_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Seen At"},"last_modified_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified At"},"first_author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Author"},"last_author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Author"},"change_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Change Count"},"line_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Line Count"},"complexity_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complexity Score"},"security_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Classification"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"},"change_history":{"anyOf":[{"items":{"$ref":"#/components/schemas/FileChangeHistoryEntry"},"type":"array"},{"type":"null"}],"title":"Change History"},"dependencies":{"anyOf":[{"items":{"$ref":"#/components/schemas/DependencyInfo"},"type":"array"},{"type":"null"}],"title":"Dependencies"},"dependents":{"anyOf":[{"items":{"$ref":"#/components/schemas/FileDependentInfo"},"type":"array"},{"type":"null"}],"title":"Dependents"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present only when status is error"}},"type":"object","required":["file_path"],"title":"GetFileMetadataResponse","description":"Response for GET /metadata/file (FileMetadataTracker.get_file_metadata)."},"GetGitCodeOwnershipResponse":{"properties":{"status":{"type":"string","title":"Status","description":"success | error"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"file_ownership":{"anyOf":[{"additionalProperties":{"items":{"$ref":"#/components/schemas/FileOwnershipEntry"},"type":"array"},"type":"object"},{"type":"null"}],"title":"File Ownership"},"developer_expertise":{"anyOf":[{"additionalProperties":{"items":{"$ref":"#/components/schemas/DeveloperExpertiseEntry"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Developer Expertise"}},"type":"object","required":["status"],"title":"GetGitCodeOwnershipResponse","description":"Response for POST /git/ownership (GitContextProvider.get_code_ownership)."},"GetGitConfigResponse":{"properties":{"config":{"additionalProperties":true,"type":"object","title":"Config"},"supported_providers":{"items":{"type":"string"},"type":"array","title":"Supported Providers"},"operation_types":{"items":{"type":"string"},"type":"array","title":"Operation Types"}},"type":"object","required":["config","supported_providers","operation_types"],"title":"GetGitConfigResponse","description":"Response for GET /git-integration/config."},"GetGitFileHistoryResponse":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Present only on the error branch"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Path"},"commit_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Commit Count"},"history":{"anyOf":[{"items":{"$ref":"#/components/schemas/FileCommitHistoryEntry"},"type":"array"},{"type":"null"}],"title":"History"},"blame":{"anyOf":[{"items":{"$ref":"#/components/schemas/FileBlameEntry"},"type":"array"},{"type":"null"}],"title":"Blame"}},"type":"object","title":"GetGitFileHistoryResponse","description":"Response for POST /git/file-history (GitContextProvider.get_file_history).\n\nNote: the service's success branch returns no \"status\" key at all\n(only the error branches do), so status is Optional here."},"GetHealthChecksResponse":{"properties":{"health_checks":{"items":{"$ref":"#/components/schemas/HealthCheckConfig"},"type":"array","title":"Health Checks"},"current_results":{"items":{"$ref":"#/components/schemas/HealthCheckResult"},"type":"array","title":"Current Results"},"summary":{"$ref":"#/components/schemas/HealthCheckResultsSummary"}},"type":"object","required":["health_checks","current_results","summary"],"title":"GetHealthChecksResponse","description":"GET /deployment/health-checks — configured checks + a live run's results."},"GetLearningInsightsResponse":{"properties":{"overall_stats":{"$ref":"#/components/schemas/OverallLearningStats"},"interaction_types":{"items":{"$ref":"#/components/schemas/LearningInsightEntry"},"type":"array","title":"Interaction Types"}},"type":"object","required":["overall_stats","interaction_types"],"title":"GetLearningInsightsResponse"},"GetMessagesResponse":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__live_chat__ChatMessage"},"type":"array","title":"Messages"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["messages","count"],"title":"GetMessagesResponse"},"GetMonitoringStatusResponse":{"properties":{"monitoring_active":{"type":"boolean","title":"Monitoring Active"},"health_check_interval_seconds":{"type":"integer","title":"Health Check Interval Seconds"},"performance_check_interval_seconds":{"type":"integer","title":"Performance Check Interval Seconds"},"configured_health_checks":{"type":"integer","title":"Configured Health Checks"},"configured_alert_rules":{"type":"integer","title":"Configured Alert Rules"},"deployment_history_count":{"type":"integer","title":"Deployment History Count"},"current_deployment":{"$ref":"#/components/schemas/MonitoringStatusCurrentDeployment"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["monitoring_active","health_check_interval_seconds","performance_check_interval_seconds","configured_health_checks","configured_alert_rules","deployment_history_count","current_deployment","timestamp"],"title":"GetMonitoringStatusResponse","description":"GET /deployment/monitoring/status — current monitoring system state."},"GetOptimizationHistoryResponse":{"properties":{"optimizations":{"items":{"$ref":"#/components/schemas/OptimizationHistoryEntry"},"type":"array","title":"Optimizations"},"total":{"type":"integer","title":"Total"},"success_rate":{"type":"number","title":"Success Rate"},"average_duration":{"type":"string","title":"Average Duration"},"total_space_reclaimed":{"type":"string","title":"Total Space Reclaimed"},"performance_improvements":{"type":"string","title":"Performance Improvements"}},"type":"object","required":["optimizations","total","success_rate","average_duration","total_space_reclaimed","performance_improvements"],"title":"GetOptimizationHistoryResponse"},"GetOrganizationsResponse":{"properties":{"organizations":{"items":{"$ref":"#/components/schemas/AdminOrganizationListItem"},"type":"array","title":"Organizations"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"skip":{"type":"integer","title":"Skip"},"active_count":{"type":"integer","title":"Active Count"}},"type":"object","required":["organizations","total","limit","skip","active_count"],"title":"GetOrganizationsResponse"},"GetPerformanceBaselineResponse":{"properties":{"baselines":{"additionalProperties":{"type":"number"},"type":"object","title":"Baselines"},"current_validation":{"$ref":"#/components/schemas/PerformanceValidationResult"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["baselines","current_validation","timestamp"],"title":"GetPerformanceBaselineResponse","description":"GET /deployment/performance/baseline — configured baselines + a live check."},"GetProjectAnalyticsResponse":{"properties":{"total_projects":{"type":"integer","title":"Total Projects"},"active_projects":{"type":"integer","title":"Active Projects"},"recent_projects":{"type":"integer","title":"Recent Projects"},"total_users":{"type":"integer","title":"Total Users"},"success_rate":{"type":"number","title":"Success Rate"},"api_calls":{"type":"integer","title":"Api Calls"},"avg_latency_ms":{"title":"Avg Latency Ms"},"errors_5xx":{"type":"integer","title":"Errors 5Xx"},"project_trend":{"type":"string","title":"Project Trend"},"timeframe":{"type":"string","title":"Timeframe"}},"type":"object","required":["total_projects","active_projects","recent_projects","total_users","success_rate","api_calls","avg_latency_ms","errors_5xx","project_trend","timeframe"],"title":"GetProjectAnalyticsResponse"},"GetProjectAnalyticsStatsResponse":{"properties":{"vector_count":{"type":"integer","title":"Vector Count"},"query_count":{"type":"integer","title":"Query Count"},"avg_query_time":{"type":"number","title":"Avg Query Time"},"storage_mb":{"type":"number","title":"Storage Mb"}},"type":"object","required":["vector_count","query_count","avg_query_time","storage_mb"],"title":"GetProjectAnalyticsStatsResponse"},"GetProjectMetricsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"file_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Count"},"total_lines":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Lines"},"avg_complexity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Complexity"},"max_complexity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Complexity"},"total_changes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Changes"},"security_files":{"anyOf":[{"$ref":"#/components/schemas/SecurityFileCounts"},{"type":"null"}]},"file_types":{"anyOf":[{"items":{"$ref":"#/components/schemas/FileTypeBreakdown"},"type":"array"},{"type":"null"}],"title":"File Types"},"authors":{"anyOf":[{"items":{"$ref":"#/components/schemas/AuthorContribution"},"type":"array"},{"type":"null"}],"title":"Authors"},"hotspots":{"anyOf":[{"items":{"$ref":"#/components/schemas/FileHotspot"},"type":"array"},{"type":"null"}],"title":"Hotspots"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Present only on the error branch"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present only when status is error"}},"type":"object","required":["project_id"],"title":"GetProjectMetricsResponse","description":"Response for GET /metadata/project (FileMetadataTracker.get_project_metrics)."},"GetProjectSpawnStatusResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"spawn_requests":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Spawn Requests"},"summary":{"$ref":"#/components/schemas/SpawnStatusSummary"}},"type":"object","required":["project_id","spawn_requests","summary"],"title":"GetProjectSpawnStatusResponse"},"GetProjectStatsResponse":{"properties":{"vectors":{"type":"integer","title":"Vectors"},"tables":{"type":"integer","title":"Tables"},"files":{"type":"integer","title":"Files"},"events":{"type":"integer","title":"Events"},"memory_items":{"type":"integer","title":"Memory Items"},"storage_mb":{"type":"number","title":"Storage Mb"}},"type":"object","required":["vectors","tables","files","events","memory_items","storage_mb"],"title":"GetProjectStatsResponse"},"GetRecentActivityResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"total_activities":{"type":"integer","title":"Total Activities"},"activities":{"items":{"$ref":"#/components/schemas/app__zerodb__schemas__database_public_responses__RecentActivityItem"},"type":"array","title":"Activities"},"filters":{"$ref":"#/components/schemas/RecentActivityFilters"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["project_id","total_activities","activities","filters","timestamp"],"title":"GetRecentActivityResponse"},"GetScalingRecommendationsResponse":{"properties":{"current_status":{"$ref":"#/components/schemas/ScalingCurrentStatus"},"scaling_recommendations":{"$ref":"#/components/schemas/app__schemas__admin__performance__ScalingRecommendationsBuckets"},"capacity_planning":{"$ref":"#/components/schemas/app__schemas__admin__performance__CapacityPlanning"},"configuration_tuning":{"$ref":"#/components/schemas/ConfigurationTuning"}},"type":"object","required":["current_status","scaling_recommendations","capacity_planning","configuration_tuning"],"title":"GetScalingRecommendationsResponse"},"GetSecurityMetricsResponse":{"properties":{"vulnerability_scans":{"type":"integer","title":"Vulnerability Scans"},"security_issues":{"type":"integer","title":"Security Issues"},"compliance_score":{"type":"number","title":"Compliance Score"},"total_api_keys":{"type":"integer","title":"Total Api Keys"},"active_api_keys":{"type":"integer","title":"Active Api Keys"},"expired_keys":{"type":"integer","title":"Expired Keys"},"failed_login_attempts":{"type":"integer","title":"Failed Login Attempts"},"security_alerts":{"items":{"anyOf":[{"$ref":"#/components/schemas/SecurityAlert"},{"type":"null"}]},"type":"array","title":"Security Alerts"},"compliance_standards":{"items":{"$ref":"#/components/schemas/ComplianceStandardStatus"},"type":"array","title":"Compliance Standards"}},"type":"object","required":["vulnerability_scans","security_issues","compliance_score","total_api_keys","active_api_keys","expired_keys","failed_login_attempts","security_alerts","compliance_standards"],"title":"GetSecurityMetricsResponse"},"GetSessionDetailsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"session_id":{"type":"string","title":"Session Id"},"start_time":{"type":"string","title":"Start Time"},"end_time":{"type":"string","title":"End Time"},"duration_ms":{"type":"number","title":"Duration Ms"},"total_logs":{"type":"integer","title":"Total Logs"},"level_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Level Counts"},"agents":{"items":{"type":"string"},"type":"array","title":"Agents"},"status":{"type":"string","title":"Status"},"logs":{"items":{"$ref":"#/components/schemas/SessionLogEntry"},"type":"array","title":"Logs"}},"type":"object","required":["project_id","session_id","start_time","end_time","duration_ms","total_logs","level_counts","agents","status","logs"],"title":"GetSessionDetailsResponse"},"GetSnapshotDetailsResponse":{"properties":{"status":{"type":"string","title":"Status","description":"not_found | error | the snapshot's DB status on success"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"snapshot_id":{"anyOf":[{},{"type":"null"}],"title":"Snapshot Id","description":"str on not_found/error branches, int on success"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"file_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Count"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"config_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Config Id"},"trigger_context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trigger Context"},"config_details":{"anyOf":[{"$ref":"#/components/schemas/AutoSnapshotConfigDetails"},{"type":"null"}]},"file_listing":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"File Listing"}},"type":"object","required":["status"],"title":"GetSnapshotDetailsResponse","description":"Response for GET /snapshots/{snapshot_id} (SnapshotSystem.get_snapshot_details).\n\nNote: the service's success branch builds a dict literal with \"status\"\nset twice (\"success\", then overwritten by the snapshot row's own DB\nstatus such as \"completed\") -- the second assignment wins in Python, so\nthe real returned \"status\" value is the snapshot's DB status, not the\nliteral string \"success\". Modeled as a plain str to reflect that."},"GetStartedRequest":{"properties":{"entity_type":{"type":"string","minLength":1,"title":"Entity Type"},"needs":{"items":{"type":"string"},"type":"array","title":"Needs"},"company":{"type":"string","minLength":1,"title":"Company"},"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["entity_type","company","email"],"title":"GetStartedRequest"},"GetStartedResponse":{"properties":{"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"deal_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deal Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"GetStartedResponse"},"GetSupportedComplianceStandardsResponse":{"properties":{"supported_standards":{"additionalProperties":{"$ref":"#/components/schemas/ComplianceStandardInfo"},"type":"object","title":"Supported Standards"},"total_standards":{"type":"integer","title":"Total Standards"},"last_updated":{"type":"string","title":"Last Updated"}},"type":"object","required":["supported_standards","total_standards","last_updated"],"title":"GetSupportedComplianceStandardsResponse"},"GetTaskLogsResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"logs":{"items":{"$ref":"#/components/schemas/TaskLogEntry"},"type":"array","title":"Logs"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["task_id","logs","total","message"],"title":"GetTaskLogsResponse"},"GetTeamActivityResponse":{"properties":{"active_users":{"type":"integer","title":"Active Users"},"new_signups":{"type":"integer","title":"New Signups"},"api_calls":{"type":"integer","title":"Api Calls"},"timeframe":{"type":"string","title":"Timeframe"}},"type":"object","required":["active_users","new_signups","api_calls","timeframe"],"title":"GetTeamActivityResponse"},"GetTemplateEvaluationMetricsResponse":{"properties":{"template_id":{"type":"string","title":"Template Id"},"template_name":{"type":"string","title":"Template Name"},"total_versions":{"type":"integer","title":"Total Versions"},"evaluated_versions":{"type":"integer","title":"Evaluated Versions"},"average_score":{"type":"number","title":"Average Score"},"versions_metrics":{"items":{"$ref":"#/components/schemas/TemplateVersionMetricEntry"},"type":"array","title":"Versions Metrics"}},"type":"object","required":["template_id","template_name","total_versions","evaluated_versions","average_score","versions_metrics"],"title":"GetTemplateEvaluationMetricsResponse"},"GetTemplateResponse":{"properties":{"template":{"additionalProperties":true,"type":"object","title":"Template"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["template","timestamp"],"title":"GetTemplateResponse","description":"Response for GET /langflow-templates/templates/{template_id}.\n\n``template`` is the full stored template dict (template_id, name,\ntype, complexity, description, components, files, metadata) — kept\nas Dict[str, Any] since its `files` values are raw generated file\ncontents (JSON/Python/Markdown strings) rather than a fixed schema."},"GetTranscriptResponse":{"properties":{"id":{"type":"string","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Messages"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"share_url":{"type":"string","title":"Share Url"},"created_at":{"type":"string","title":"Created At"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["id","messages","share_url","created_at","expires_at"],"title":"GetTranscriptResponse","description":"Public response for retrieving a shared transcript."},"GetUserAnalyticsResponse":{"properties":{"period":{"type":"string","title":"Period"},"total_users":{"type":"integer","title":"Total Users"},"active_users":{"type":"integer","title":"Active Users"},"verified_users":{"type":"integer","title":"Verified Users"},"admin_users":{"type":"integer","title":"Admin Users"},"recent_logins":{"type":"integer","title":"Recent Logins"},"new_users_period":{"type":"integer","title":"New Users Period"},"user_growth":{"items":{"$ref":"#/components/schemas/UserGrowthPoint"},"type":"array","title":"User Growth"},"activity_breakdown":{"$ref":"#/components/schemas/UserActivityBreakdown"}},"type":"object","required":["period","total_users","active_users","verified_users","admin_users","recent_logins","new_users_period","user_growth","activity_breakdown"],"title":"GetUserAnalyticsResponse"},"GetUserAuditTrailResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"user_email":{"type":"string","title":"User Email"},"events":{"items":{"$ref":"#/components/schemas/UserAuditTrailEvent"},"type":"array","title":"Events"},"total_events":{"type":"integer","title":"Total Events"},"summary":{"$ref":"#/components/schemas/UserAuditTrailSummary"}},"type":"object","required":["user_id","user_email","events","total_events","summary"],"title":"GetUserAuditTrailResponse"},"GetUserFeedbackResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"total_feedback":{"type":"integer","title":"Total Feedback"},"average_rating":{"type":"number","title":"Average Rating"},"positive_feedback":{"type":"integer","title":"Positive Feedback"},"negative_feedback":{"type":"integer","title":"Negative Feedback"}},"type":"object","required":["user_id","total_feedback","average_rating","positive_feedback","negative_feedback"],"title":"GetUserFeedbackResponse"},"GetUserSubscriptionResponse":{"properties":{"user_id":{"anyOf":[{},{"type":"null"}],"title":"User Id"},"email":{"anyOf":[{},{"type":"null"}],"title":"Email"},"plan":{"anyOf":[{},{"type":"null"}],"title":"Plan"},"effective_tier":{"anyOf":[{},{"type":"null"}],"title":"Effective Tier"},"subscription":{"anyOf":[{"$ref":"#/components/schemas/AdminUserSubscriptionRecord"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"GetUserSubscriptionResponse","description":"GET /{user_id}/subscription -- `_read_user_subscription`'s return dict.\n\n`extra=\"allow\"`: there is no redaction or permission-scoping step between\nthe helper and the response that a passthrough field could bypass -- the\nhelper's own SELECT list is the entire field set, and it is enumerated\nabove. Allowing extras means a future key added to that SELECT shows up\ninstead of being silently filtered out of a live admin response."},"GetUsersResponse":{"properties":{"users":{"items":{"$ref":"#/components/schemas/AdminUserListItem"},"type":"array","title":"Users"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"skip":{"type":"integer","title":"Skip"},"active_count":{"type":"integer","title":"Active Count"},"admin_count":{"type":"integer","title":"Admin Count"},"verified_count":{"type":"integer","title":"Verified Count"}},"type":"object","required":["users","total","limit","skip","active_count","admin_count","verified_count"],"title":"GetUsersResponse"},"GetVectorNamespacesResponse":{"properties":{"namespaces":{"items":{"$ref":"#/components/schemas/VectorNamespaceInfo"},"type":"array","title":"Namespaces"},"total_memory_count":{"type":"integer","title":"Total Memory Count"}},"type":"object","required":["namespaces","total_memory_count"],"title":"GetVectorNamespacesResponse"},"GetVectorResponse":{"properties":{"id":{"type":"string","title":"Id"},"namespace":{"type":"string","title":"Namespace"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"vector":{"items":{"type":"number"},"type":"array","title":"Vector"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","namespace","metadata","vector","created_at","updated_at"],"title":"GetVectorResponse"},"GiftCodeInfoRequest":{"properties":{"code":{"type":"string","title":"Code","description":"Gift code to check"}},"type":"object","required":["code"],"title":"GiftCodeInfoRequest","description":"Request schema for getting gift code information"},"GiftCodeRedeemRequest":{"properties":{"code":{"type":"string","title":"Code","description":"Gift code to redeem (e.g., NY2026-ABCD1)"},"referral_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referral Source","description":"Where user found the code"}},"type":"object","required":["code"],"title":"GiftCodeRedeemRequest","description":"Request schema for redeeming a gift code"},"GitAnalysisRequest":{"properties":{"repo_path":{"type":"string","title":"Repo Path","description":"Path to the Git repository"},"project_id":{"type":"string","title":"Project Id","description":"ID of the project"}},"type":"object","required":["repo_path","project_id"],"title":"GitAnalysisRequest"},"GitBlameLine":{"properties":{"line_number":{"type":"integer","title":"Line Number","description":"The line number (1-based)."},"content":{"type":"string","title":"Content","description":"The content of the line."},"commit_hash":{"type":"string","title":"Commit Hash","description":"The commit hash responsible for this line."},"author_name":{"type":"string","title":"Author Name","description":"The author's name for this line's commit."},"author_email":{"type":"string","title":"Author Email","description":"The author's email for this line's commit."},"date":{"type":"string","format":"date-time","title":"Date","description":"The date and time of the commit for this line."}},"type":"object","required":["line_number","content","commit_hash","author_name","author_email","date"],"title":"GitBlameLine","description":"Represents a single line in a Git blame output."},"GitBranchInfo":{"properties":{"name":{"type":"string","title":"Name"},"is_default":{"type":"boolean","title":"Is Default"},"last_commit":{"$ref":"#/components/schemas/GitCommitSummary"},"ahead":{"type":"integer","title":"Ahead"},"behind":{"type":"integer","title":"Behind"}},"type":"object","required":["name","is_default","last_commit","ahead","behind"],"title":"GitBranchInfo"},"GitBranchListResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"items":{"$ref":"#/components/schemas/GitBranchInfo"},"type":"array","title":"Data"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["success","data","total"],"title":"GitBranchListResponse","description":"Return shape of GET /git/branches/{repo_id}."},"GitBranchRequest":{"properties":{"project_path":{"type":"string","minLength":1,"title":"Project Path"},"branch_name":{"type":"string","maxLength":100,"minLength":1,"title":"Branch Name"},"operation":{"type":"string","pattern":"^(create|checkout|delete|merge)$","title":"Operation"},"source_branch":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Branch"}},"type":"object","required":["project_path","branch_name","operation"],"title":"GitBranchRequest","description":"Request model for Git branch operations"},"GitCommit":{"properties":{"commit_hash":{"type":"string","title":"Commit Hash","description":"The full commit hash."},"author_name":{"type":"string","title":"Author Name","description":"The author's name."},"author_email":{"type":"string","title":"Author Email","description":"The author's email."},"date":{"type":"string","format":"date-time","title":"Date","description":"The date and time of the commit."},"message":{"type":"string","title":"Message","description":"The commit message."}},"type":"object","required":["commit_hash","author_name","author_email","date","message"],"title":"GitCommit","description":"Represents a single Git commit in history."},"GitCommitRequest":{"properties":{"project_path":{"type":"string","minLength":1,"title":"Project Path"},"commit_message":{"type":"string","maxLength":500,"minLength":1,"title":"Commit Message"},"files":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Files"},"auto_push":{"type":"boolean","title":"Auto Push","default":true},"branch":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Branch"}},"type":"object","required":["project_path","commit_message"],"title":"GitCommitRequest","description":"Request model for Git commit operations"},"GitCommitSummary":{"properties":{"sha":{"type":"string","title":"Sha"},"message":{"type":"string","title":"Message"},"date":{"type":"string","title":"Date"}},"type":"object","required":["sha","message","date"],"title":"GitCommitSummary"},"GitConfiguration":{"properties":{"user_name":{"type":"string","minLength":1,"title":"User Name"},"user_email":{"type":"string","minLength":1,"title":"User Email"},"default_branch":{"type":"string","title":"Default Branch","default":"main"},"auto_commit":{"type":"boolean","title":"Auto Commit","default":true},"auto_push":{"type":"boolean","title":"Auto Push","default":false},"commit_message_template":{"type":"string","title":"Commit Message Template","default":"Auto-commit: {action} - {timestamp}"}},"type":"object","required":["user_name","user_email"],"title":"GitConfiguration","description":"Git configuration model"},"GitDashboardRepositoryEntry":{"properties":{"name":{"type":"string","title":"Name"},"path":{"type":"string","title":"Path"},"current_branch":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Branch"},"has_changes":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Changes"},"changed_files_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Changed Files Count"},"last_commit":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Last Commit"},"remotes":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Remotes"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["name","path"],"title":"GitDashboardRepositoryEntry","description":"One repository entry in the dashboard listing. On a status-fetch\nerror the entry only has name/path/error — every other field is kept\noptional to preserve that real shape."},"GitDashboardResponse":{"properties":{"repositories":{"items":{"$ref":"#/components/schemas/GitDashboardRepositoryEntry"},"type":"array","title":"Repositories"},"repository_count":{"type":"integer","title":"Repository Count"},"recent_operations":{"items":{"$ref":"#/components/schemas/GitOperationResponse"},"type":"array","title":"Recent Operations"},"git_config":{"additionalProperties":true,"type":"object","title":"Git Config"},"base_path":{"type":"string","title":"Base Path"},"supported_providers":{"items":{"type":"string"},"type":"array","title":"Supported Providers"},"operation_types":{"items":{"type":"string"},"type":"array","title":"Operation Types"}},"type":"object","required":["repositories","repository_count","recent_operations","git_config","base_path","supported_providers","operation_types"],"title":"GitDashboardResponse","description":"Response for GET /git-integration/dashboard."},"GitFileChange":{"properties":{"commit_hash":{"type":"string","title":"Commit Hash","description":"The full commit hash."},"author_name":{"type":"string","title":"Author Name","description":"The author's name."},"author_email":{"type":"string","title":"Author Email","description":"The author's email."},"date":{"type":"string","format":"date-time","title":"Date","description":"The date and time of the commit."},"message":{"type":"string","title":"Message","description":"The commit message."}},"type":"object","required":["commit_hash","author_name","author_email","date","message"],"title":"GitFileChange","description":"Represents a change to a file within a commit."},"GitHubConnectionStatusData":{"properties":{"connected":{"type":"boolean","title":"Connected","default":false},"has_token":{"type":"boolean","title":"Has Token","default":false},"github_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Username"},"github_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Email"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"has_required_scopes":{"type":"boolean","title":"Has Required Scopes","default":false},"missing_scopes":{"items":{"type":"string"},"type":"array","title":"Missing Scopes"},"last_validated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Validated"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"GitHubConnectionStatusData","description":"``data`` payload for GET .../github/connection-status"},"GitHubCreateIssueRequest":{"properties":{"repo":{"type":"string","title":"Repo","description":"Repository in owner/repo format"},"title":{"type":"string","title":"Title","description":"Issue title"},"body":{"type":"string","title":"Body","description":"Issue body (markdown)","default":""},"labels":{"items":{"type":"string"},"type":"array","title":"Labels","description":"Label names"}},"type":"object","required":["repo","title"],"title":"GitHubCreateIssueRequest"},"GitHubCreateIssueResponse":{"properties":{"number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number"},"html_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Html Url"},"title":{"type":"string","title":"Title"},"message":{"type":"string","title":"Message"}},"type":"object","required":["title","message"],"title":"GitHubCreateIssueResponse"},"GitHubRepositoriesData":{"properties":{"repositories":{"items":{"$ref":"#/components/schemas/GitHubRepositoryItem"},"type":"array","title":"Repositories"},"total":{"type":"integer","title":"Total","default":0},"limit":{"type":"integer","title":"Limit","default":30},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"GitHubRepositoriesData","description":"``data`` payload for GET .../github/repositories"},"GitHubRepositoriesResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/GitHubRepositoriesData"}},"type":"object","required":["data"],"title":"GitHubRepositoriesResponse","description":"Response schema for GET /api/v1/public/github/repositories"},"GitHubRepositoryInfo":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"full_name":{"type":"string","title":"Full Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"private":{"type":"boolean","title":"Private"},"fork":{"type":"boolean","title":"Fork"},"archived":{"type":"boolean","title":"Archived"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"stars_count":{"type":"integer","title":"Stars Count","default":0},"forks_count":{"type":"integer","title":"Forks Count","default":0},"open_issues_count":{"type":"integer","title":"Open Issues Count","default":0},"default_branch":{"type":"string","title":"Default Branch","default":"main"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"pushed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Pushed At"},"html_url":{"type":"string","title":"Html Url"},"clone_url":{"type":"string","title":"Clone Url"}},"type":"object","required":["id","name","full_name","private","fork","archived","created_at","updated_at","html_url","clone_url"],"title":"GitHubRepositoryInfo","description":"Model for GitHub repository information"},"GitHubRepositoryItem":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"private":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Private"},"html_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Html Url"},"clone_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Clone Url"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"stargazers_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stargazers Count"},"forks_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forks Count"},"open_issues_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Open Issues Count"},"default_branch":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Branch"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"pushed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pushed At"}},"type":"object","title":"GitHubRepositoryItem","description":"A single repository entry as returned by GET .../github/repositories"},"GitHubSettingsResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"github_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Username"},"github_user_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Github User Id"},"github_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Email"},"enable_repo_access":{"type":"boolean","title":"Enable Repo Access"},"auto_sync_repos":{"type":"boolean","title":"Auto Sync Repos"},"sync_private_repos":{"type":"boolean","title":"Sync Private Repos"},"token_last_validated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Token Last Validated"},"token_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Scope"},"token_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Token Expires At"},"has_token":{"type":"boolean","title":"Has Token","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["id","user_id","enable_repo_access","auto_sync_repos","sync_private_repos","created_at","updated_at"],"title":"GitHubSettingsResponse","description":"Model for returning GitHub settings (without sensitive data)"},"GitHubStatusResponse":{"properties":{"repo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repo Url","description":"GitHub repository URL"},"repo_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repo Name","description":"Repository name (owner/repo)"},"issues_created":{"type":"integer","title":"Issues Created","description":"Total issues created","default":0},"issues_closed":{"type":"integer","title":"Issues Closed","description":"Total issues closed","default":0},"pull_requests_total":{"type":"integer","title":"Pull Requests Total","description":"Total pull requests","default":0},"pull_requests_merged":{"type":"integer","title":"Pull Requests Merged","description":"Merged pull requests","default":0},"pull_requests_open":{"type":"integer","title":"Pull Requests Open","description":"Open pull requests","default":0},"last_commit_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Commit At","description":"Last commit timestamp (ISO 8601)"},"branch":{"type":"string","title":"Branch","description":"Default branch name","default":"main"},"build_status":{"type":"string","title":"Build Status","description":"Build status: success, pending, running, failed, unknown","default":"unknown"}},"type":"object","title":"GitHubStatusResponse","description":"Response schema for GitHub integration status"},"GitHubSyncAuthResponse":{"properties":{"authenticated":{"type":"boolean","title":"Authenticated"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["authenticated","organization_id"],"title":"GitHubSyncAuthResponse","description":"Response for GitHub sync authentication status."},"GitHubSyncRequest":{"properties":{"access_token":{"type":"string","title":"Access Token"},"gclid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gclid"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"stripe_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Session Id"}},"type":"object","required":["access_token"],"title":"GitHubSyncRequest"},"GitHubSyncResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email":{"type":"string","title":"Email"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"is_new_user":{"type":"boolean","title":"Is New User"},"access_token":{"type":"string","title":"Access Token"},"refresh_token":{"type":"string","title":"Refresh Token"}},"type":"object","required":["user_id","username","email","full_name","is_new_user","access_token","refresh_token"],"title":"GitHubSyncResponse"},"GitHubTokenCreate":{"properties":{"github_token":{"type":"string","maxLength":255,"minLength":40,"title":"Github Token"},"enable_repo_access":{"type":"boolean","title":"Enable Repo Access","default":true},"auto_sync_repos":{"type":"boolean","title":"Auto Sync Repos","default":false},"sync_private_repos":{"type":"boolean","title":"Sync Private Repos","default":false}},"type":"object","required":["github_token"],"title":"GitHubTokenCreate","description":"Model for creating/updating GitHub token"},"GitHubTokenDeleteResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"GitHubTokenDeleteResponse","description":"Response for DELETE /token."},"GitHubTokenRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"GitHubTokenRequest","description":"Request to import a GitHub PAT."},"GitHubTokenResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"GitHubTokenResponse","description":"Response after importing a GitHub PAT."},"GitHubTokenStoreData":{"properties":{"connected":{"type":"boolean","title":"Connected","default":true},"github_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Username"}},"type":"object","title":"GitHubTokenStoreData","description":"``data`` payload for POST .../github/token"},"GitHubTokenStoreResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/GitHubTokenStoreData"}},"type":"object","required":["data"],"title":"GitHubTokenStoreResponse","description":"Response schema for POST /api/v1/public/github/token"},"GitHubTokenUpdate":{"properties":{"enable_repo_access":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enable Repo Access"},"auto_sync_repos":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Sync Repos"},"sync_private_repos":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Sync Private Repos"}},"type":"object","title":"GitHubTokenUpdate","description":"Model for updating GitHub settings without token"},"GitHubTokenValidationResponse":{"properties":{"is_valid":{"type":"boolean","title":"Is Valid"},"github_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Username"},"github_user_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Github User Id"},"github_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Email"},"scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scopes"},"rate_limit_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rate Limit Remaining"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["is_valid"],"title":"GitHubTokenValidationResponse","description":"Response model for token validation"},"GitHubUserInfo":{"properties":{"id":{"type":"integer","title":"Id"},"login":{"type":"string","title":"Login"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"blog":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blog"},"avatar_url":{"type":"string","title":"Avatar Url"},"html_url":{"type":"string","title":"Html Url"},"public_repos":{"type":"integer","title":"Public Repos","default":0},"public_gists":{"type":"integer","title":"Public Gists","default":0},"followers":{"type":"integer","title":"Followers","default":0},"following":{"type":"integer","title":"Following","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","login","avatar_url","html_url","created_at","updated_at"],"title":"GitHubUserInfo","description":"Model for GitHub user information"},"GitHubUserInfoResponse":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id"},"login":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Login"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"html_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Html Url"},"public_repos":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Public Repos"},"followers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Followers"},"following":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Following"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"blog":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blog"}},"type":"object","title":"GitHubUserInfoResponse","description":"Response schema for GET /api/v1/public/github/user.\n\nReal GitHub user profile data fetched via the user's stored OAuth/PAT\ntoken (app.api.v1.endpoints.github.get_github_user). Refs #2191."},"GitOperationResponse":{"properties":{"operation_id":{"type":"string","title":"Operation Id"},"status":{"$ref":"#/components/schemas/GitStatus"},"operation_type":{"$ref":"#/components/schemas/GitOperationType"},"project_path":{"type":"string","title":"Project Path"},"result":{"additionalProperties":true,"type":"object","title":"Result"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"execution_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Execution Time"}},"type":"object","required":["operation_id","status","operation_type","project_path","result","started_at"],"title":"GitOperationResponse","description":"Response model for Git operations"},"GitOperationType":{"type":"string","enum":["init","clone","add","commit","push","pull","branch","merge","tag"],"title":"GitOperationType","description":"Git operation types"},"GitProvider":{"type":"string","enum":["github","gitlab","bitbucket","custom"],"title":"GitProvider","description":"Git hosting providers"},"GitRepositoriesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"items":{"$ref":"#/components/schemas/GitRepositorySummary"},"type":"array","title":"Data"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["success","data","total"],"title":"GitRepositoriesResponse","description":"Response for GET /git/repositories."},"GitRepositoryRequest":{"properties":{"repository_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repository Url"},"repository_name":{"type":"string","maxLength":100,"minLength":1,"title":"Repository Name"},"provider":{"$ref":"#/components/schemas/GitProvider","default":"github"},"private":{"type":"boolean","title":"Private","default":true},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"project_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Path"}},"type":"object","required":["repository_name"],"title":"GitRepositoryRequest","description":"Request model for Git repository operations"},"GitRepositorySummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"branch":{"type":"string","title":"Branch"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"last_sync":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sync"},"commits_count":{"type":"integer","title":"Commits Count"},"languages":{"items":{"type":"string"},"type":"array","title":"Languages"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","branch","commits_count","languages","created_at"],"title":"GitRepositorySummary"},"GitStatus":{"type":"string","enum":["pending","in_progress","completed","failed"],"title":"GitStatus","description":"Git operation status"},"GmailReplyRequest":{"properties":{"thread_id":{"type":"string","title":"Thread Id","description":"Gmail thread ID"},"body":{"type":"string","title":"Body","description":"Reply body (plain text or HTML)"},"cc":{"items":{"type":"string"},"type":"array","title":"Cc","description":"CC recipients"}},"type":"object","required":["thread_id","body"],"title":"GmailReplyRequest"},"GmailReplyResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thread Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"GmailReplyResponse"},"GoalCreate":{"properties":{"goal_type":{"type":"string","title":"Goal Type","description":"Goal type: followers, stream_hours, average_viewers, peak_viewers"},"target":{"type":"integer","minimum":1,"title":"Target","description":"Target value"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Goal title"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description","description":"Goal description"}},"type":"object","required":["goal_type","target","title"],"title":"GoalCreate","description":"Schema for creating a custom goal","example":{"description":"Milestone for streamer growth","goal_type":"followers","target":5000,"title":"Reach 5000 followers"}},"GoalItem":{"properties":{"id":{"type":"string","title":"Id","description":"Goal identifier"},"type":{"type":"string","title":"Type","description":"Goal type: followers, stream_hours, average_viewers"},"target":{"type":"integer","minimum":0,"title":"Target","description":"Target value"},"current":{"type":"number","minimum":0,"title":"Current","description":"Current value"},"progress_percentage":{"type":"number","maximum":100,"minimum":0,"title":"Progress Percentage","description":"Progress percentage"},"completed":{"type":"boolean","title":"Completed","description":"Whether goal is completed"},"title":{"type":"string","title":"Title","description":"Goal title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Goal description"}},"type":"object","required":["id","type","target","current","progress_percentage","completed","title"],"title":"GoalItem","description":"Single goal/milestone item","example":{"completed":false,"current":750,"description":"250 more followers needed","id":"followers_1000","progress_percentage":75,"target":1000,"title":"Reach 1000 followers","type":"followers"}},"GoalsResponse":{"properties":{"goals":{"items":{"$ref":"#/components/schemas/GoalItem"},"type":"array","title":"Goals"},"total_goals":{"type":"integer","minimum":0,"title":"Total Goals","description":"Number of active goals"},"current_stats":{"$ref":"#/components/schemas/CurrentStats"}},"type":"object","required":["goals","total_goals","current_stats"],"title":"GoalsResponse","description":"Goals and milestones response","example":{"current_stats":{"average_viewers":23.5,"follower_count":750,"peak_viewers":87,"total_stream_hours":45},"goals":[{"completed":false,"current":750,"description":"250 more followers needed","id":"followers_1000","progress_percentage":75,"target":1000,"title":"Reach 1000 followers","type":"followers"}],"total_goals":3}},"GoogleAdsSummaryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["success","data"],"title":"GoogleAdsSummaryResponse","description":"`data` (today/month/campaigns, optional top-level `error`) stays\nDict[str, Any] for the same reason as RevenueSummaryResponse.data."},"GoogleOAuthRequest":{"properties":{"code":{"type":"string","title":"Code"},"redirect_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redirect Uri"},"stripe_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Session Id"}},"type":"object","required":["code"],"title":"GoogleOAuthRequest","description":"Google OAuth callback request model"},"GpuDropletSize":{"properties":{"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"price_hourly":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Hourly"},"vcpus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vcpus"},"memory_mb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Mb"},"disk_gb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Disk Gb"},"regions":{"items":{"type":"string"},"type":"array","title":"Regions"},"available":{"type":"boolean","title":"Available","default":false}},"additionalProperties":true,"type":"object","title":"GpuDropletSize","description":"One entry from digitalocean_service.list_gpu_droplet_sizes()."},"GpuInferenceSize":{"properties":{"gpu_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gpu Slug"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"price_hourly":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Hourly"},"gpu_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Gpu Count"},"vram_gb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vram Gb"},"regions":{"items":{"type":"string"},"type":"array","title":"Regions"},"cpu":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cpu"},"memory_gb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Gb"}},"additionalProperties":true,"type":"object","title":"GpuInferenceSize","description":"One entry from digitalocean_service.list_inference_sizes()."},"GpuModelConfig":{"properties":{"model_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Slug"},"model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Name"},"is_gated":{"type":"boolean","title":"Is Gated","default":false},"compatible_gpu_slugs":{"items":{"type":"string"},"type":"array","title":"Compatible Gpu Slugs"}},"additionalProperties":true,"type":"object","title":"GpuModelConfig","description":"One entry from digitalocean_service.list_available_models()."},"GpuModelConfigsResponse":{"properties":{"models":{"items":{"$ref":"#/components/schemas/GpuModelConfig"},"type":"array","title":"Models"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["models","total"],"title":"GpuModelConfigsResponse"},"GpuSizesResponse":{"properties":{"gpu_sizes":{"items":{"$ref":"#/components/schemas/GpuInferenceSize"},"type":"array","title":"Gpu Sizes"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["gpu_sizes","total"],"title":"GpuSizesResponse"},"GpuTrainingNodeDestroyResponse":{"properties":{"destroyed":{"type":"boolean","title":"Destroyed"},"droplet_id":{"type":"integer","title":"Droplet Id"}},"type":"object","required":["destroyed","droplet_id"],"title":"GpuTrainingNodeDestroyResponse","description":"Built in-handler — a closed shape, so no extra fields are allowed."},"GpuTrainingNodeRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Droplet name"},"size_slug":{"type":"string","title":"Size Slug","description":"GPU droplet size","default":"gpu-mi300x8-1536gb"},"region":{"type":"string","title":"Region","description":"DO region","default":"atl1"},"ssh_key_ids":{"items":{"type":"integer"},"type":"array","title":"Ssh Key Ids","description":"DO SSH key IDs to inject (optional — omit for a fully cloud-init-driven, hands-off run where the node self-runs and self-destroys)"},"user_data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Data","description":"cloud-init to bootstrap the job"}},"type":"object","required":["name"],"title":"GpuTrainingNodeRequest"},"GpuTrainingNodeResponse":{"properties":{"droplet_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Droplet Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"size_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size Slug"},"hourly_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Hourly Cost Usd"}},"additionalProperties":true,"type":"object","title":"GpuTrainingNodeResponse","description":"Result of digitalocean_service.provision_gpu_training_node().\n\nhourly_cost_usd is Optional: the live DO price lookup is best-effort and the\nstatic fallback table may not carry the slug, in which case it is None."},"GpuTrainingNodeStatusResponse":{"properties":{"droplet_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Droplet Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"public_ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Ip"}},"additionalProperties":true,"type":"object","title":"GpuTrainingNodeStatusResponse","description":"Result of digitalocean_service.get_gpu_node_status().\n\npublic_ip is None while the droplet is still booting."},"GpuTrainingSizesResponse":{"properties":{"sizes":{"items":{"$ref":"#/components/schemas/GpuDropletSize"},"type":"array","title":"Sizes"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["sizes","total"],"title":"GpuTrainingSizesResponse"},"GrantPermissionRequest":{"properties":{"grantee_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Grantee User Id","description":"User to grant access to"},"grantee_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Grantee Api Key Id","description":"API key to grant access to"},"role":{"type":"string","title":"Role","description":"Permission role to grant"},"model_scope":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Model Scope","description":"Scope permission to a specific model (optional)"}},"type":"object","required":["role"],"title":"GrantPermissionRequest"},"GrantPermissionResponse":{"properties":{"permission_id":{"type":"string","title":"Permission Id"},"role":{"type":"string","title":"Role"},"granted_at":{"type":"string","title":"Granted At"},"grantee_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grantee User Id"},"grantee_api_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grantee Api Key Id"},"model_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Scope"}},"type":"object","required":["permission_id","role","granted_at"],"title":"GrantPermissionResponse"},"GraphContext":{"properties":{"entity":{"type":"string","title":"Entity"},"entity_type":{"type":"string","title":"Entity Type"},"connections":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Connections","default":[]}},"type":"object","required":["entity","entity_type"],"title":"GraphContext"},"GraphEntityTypeCount":{"properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["count"],"title":"GraphEntityTypeCount"},"GraphNode":{"properties":{"id":{"type":"string","title":"Id"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"}},"additionalProperties":true,"type":"object","required":["id"],"title":"GraphNode","description":"A node in a traversal result. ``properties`` is user-defined JSONB."},"GraphPredicateCount":{"properties":{"predicate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicate"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["count"],"title":"GraphPredicateCount"},"GraphRAGRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Search query text"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Maximum results to return","default":10},"graph_weight":{"type":"number","maximum":1,"minimum":0,"title":"Graph Weight","description":"Blend factor: 0=pure vector, 1=pure graph","default":0.3},"max_hops":{"type":"integer","maximum":5,"minimum":1,"title":"Max Hops","description":"Maximum graph traversal depth","default":2}},"type":"object","required":["query"],"title":"GraphRAGRequest"},"GraphRAGResponse":{"properties":{"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results"},"query":{"type":"string","title":"Query"},"graph_weight":{"type":"number","title":"Graph Weight"},"total":{"type":"integer","title":"Total"},"max_hops":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Hops"},"entities_traversed":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entities Traversed"}},"additionalProperties":true,"type":"object","required":["query","graph_weight","total"],"title":"GraphRAGResponse","description":"Response for POST /memory/v2/graph/graphrag.\n\n``results`` items are a spread of the ZeroMemory ``recall()`` dict plus\nvector_score/graph_boost/score, so they are intentionally left as\nfree-form dicts — forcing a model there would drop recall fields.\n\n``max_hops`` and ``entities_traversed`` are ABSENT from the early return\ntaken when vector search finds no candidates, hence Optional + the route's\n``response_model_exclude_unset=True``."},"GraphRelationship":{"properties":{"id":{"type":"string","title":"Id"},"subject":{"type":"string","title":"Subject"},"predicate":{"type":"string","title":"Predicate"},"object":{"type":"string","title":"Object"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"}},"type":"object","required":["id","subject","predicate","object","confidence"],"title":"GraphRelationship"},"GraphStatsResponse":{"properties":{"node_count":{"type":"integer","title":"Node Count"},"edge_count":{"type":"integer","title":"Edge Count"},"entity_types":{"items":{"$ref":"#/components/schemas/GraphEntityTypeCount"},"type":"array","title":"Entity Types"},"top_entities":{"items":{"$ref":"#/components/schemas/GraphTopEntity"},"type":"array","title":"Top Entities"},"predicate_distribution":{"items":{"$ref":"#/components/schemas/GraphPredicateCount"},"type":"array","title":"Predicate Distribution"},"density":{"type":"number","title":"Density"}},"type":"object","required":["node_count","edge_count","density"],"title":"GraphStatsResponse","description":"Response for GET /memory/v2/graph/stats"},"GraphTopEntity":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"connections":{"type":"integer","title":"Connections"}},"type":"object","required":["connections"],"title":"GraphTopEntity"},"GraphTraverseEdge":{"properties":{"id":{"type":"string","title":"Id"},"source":{"type":"string","title":"Source"},"target":{"type":"string","title":"Target"},"predicate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicate"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"depth":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Depth"}},"additionalProperties":true,"type":"object","required":["id","source","target"],"title":"GraphTraverseEdge","description":"An edge in a traversal result, carrying the hop depth it was found at."},"GroupRecommendationsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total number of results"},"limit":{"type":"integer","title":"Limit","description":"Results per page"},"offset":{"type":"integer","title":"Offset","description":"Results offset"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results exist"},"groups":{"items":{"$ref":"#/components/schemas/app__schemas__search__RecommendedGroup"},"type":"array","title":"Groups","description":"Recommended groups"}},"type":"object","required":["total","limit","offset","has_more"],"title":"GroupRecommendationsResponse","description":"Group recommendations response"},"GroupSearchResult":{"properties":{"id":{"type":"string","title":"Id","description":"Group ID"},"name":{"type":"string","title":"Name","description":"Group name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Group description"},"privacy":{"type":"string","title":"Privacy","description":"Privacy setting"},"member_count":{"type":"integer","title":"Member Count","description":"Number of members","default":0},"post_count":{"type":"integer","title":"Post Count","description":"Number of posts","default":0},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Primary category"},"relevance_score":{"type":"number","maximum":1,"minimum":0,"title":"Relevance Score","description":"Search relevance score"}},"type":"object","required":["id","name","privacy","relevance_score"],"title":"GroupSearchResult","description":"Group search result item","example":{"category":"Technology","description":"Community for AI and ML developers","id":"g1r2o3u4-5p6i-7890-abcd-ef1234567890","member_count":2456,"name":"AI Developers","post_count":1234,"privacy":"public","relevance_score":0.92}},"GroveNoticeViewedResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"GroveNoticeViewedResponse","description":"Response for POST /api/oauth/account/grove_notice_viewed."},"GrovePromoResponse":{"properties":{"promos":{"items":{},"type":"array","title":"Promos"},"active_promo":{"anyOf":[{},{"type":"null"}],"title":"Active Promo"}},"type":"object","title":"GrovePromoResponse","description":"Grove promotions (playful internal shim; none active by default)."},"GrowthBookEvalRequest":{"properties":{"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes","default":{}}},"type":"object","title":"GrowthBookEvalRequest","description":"Request body sent by the GrowthBook SDK."},"GrowthBookEvalResponse":{"properties":{"status":{"type":"integer","title":"Status"},"features":{"additionalProperties":true,"type":"object","title":"Features"}},"type":"object","required":["status","features"],"title":"GrowthBookEvalResponse","description":"GrowthBook SDK remote-eval protocol response shape."},"GrowthExperimentEntry":{"properties":{"slug":{"type":"string","title":"Slug"},"status":{"type":"string","title":"Status"},"impressions":{"type":"integer","title":"Impressions"},"conversions":{"type":"integer","title":"Conversions"},"conversion_rate":{"type":"number","title":"Conversion Rate"},"kill_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kill Date"}},"type":"object","required":["slug","status","impressions","conversions","conversion_rate"],"title":"GrowthExperimentEntry"},"GrowthMetric":{"properties":{"metric_name":{"type":"string","title":"Metric Name","description":"Name of the metric"},"current_value":{"type":"string","title":"Current Value","description":"Current period value"},"previous_value":{"type":"string","title":"Previous Value","description":"Previous period value"},"change_percent":{"type":"number","title":"Change Percent","description":"Percentage change"},"period":{"$ref":"#/components/schemas/GrowthPeriod","description":"Comparison period"},"is_positive":{"type":"boolean","title":"Is Positive","description":"Whether growth is positive"}},"type":"object","required":["metric_name","current_value","previous_value","change_percent","period","is_positive"],"title":"GrowthMetric","description":"Growth metric with comparison"},"GrowthMetrics":{"properties":{"total_companies":{"type":"integer","title":"Total Companies","default":0},"companies_created_24h":{"type":"integer","title":"Companies Created 24H","default":0},"active_companies":{"type":"integer","title":"Active Companies","default":0},"total_users":{"type":"integer","title":"Total Users","default":0},"users_24h":{"type":"integer","title":"Users 24H","default":0},"total_projects":{"type":"integer","title":"Total Projects","default":0},"projects_24h":{"type":"integer","title":"Projects 24H","default":0}},"type":"object","title":"GrowthMetrics","description":"Live company-creation + growth counters — the Polsia /live headline. Refs #6576.\n\nReal platform growth, NO fabrication. Each field maps to a real prod table:\n\n - total_companies ......... COUNT(organizations) — a \"company\" = an org/workspace,\n the cleanest fit for the builder's company concept.\n - companies_created_24h ... organizations created in the last 24h (the headline counter).\n - active_companies ........ subscriptions with status in (active, trialing) AND a\n real stripe_subscription_id (Refs #6905) — the paying\n base (mirrors Polsia's \"active/paying\"). Filtering on\n stripe_subscription_id excludes free/trial plan-state\n rows that also live in `subscriptions` with these\n statuses but were never a Stripe-billed company.\n - total_users / users_24h . COUNT(users) all-time + last 24h (supporting growth).\n - total_projects / projects_24h . COUNT(projects) all-time + last 24h (builder output).\n\nThese are NON-windowed (fixed all-time totals + a fixed 24h delta), so they are\ncomputed ONCE in _SharedParts and reused across the daily/weekly/30d window builds\n— they never slow the per-window path or get recomputed 3× (Refs #6575)."},"GrowthPeriod":{"type":"string","enum":["mom","yoy","wow"],"title":"GrowthPeriod","description":"Growth comparison periods"},"GrowthSummary":{"properties":{"period":{"type":"string","title":"Period"},"dau_today":{"type":"integer","title":"Dau Today"},"dau_yesterday":{"type":"integer","title":"Dau Yesterday"},"dau_7d_avg":{"type":"number","title":"Dau 7D Avg"},"mau_current":{"type":"integer","title":"Mau Current"},"mau_previous":{"type":"integer","title":"Mau Previous"},"mau_growth_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mau Growth Pct"},"total_sessions_7d":{"type":"integer","title":"Total Sessions 7D"},"total_sessions_30d":{"type":"integer","title":"Total Sessions 30D"},"avg_session_duration_sec":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Session Duration Sec"},"new_users_7d":{"type":"integer","title":"New Users 7D"},"new_users_30d":{"type":"integer","title":"New Users 30D"},"tier_breakdown":{"items":{"$ref":"#/components/schemas/TierBreakdown"},"type":"array","title":"Tier Breakdown"},"dau_trend":{"items":{"$ref":"#/components/schemas/DailyMetric"},"type":"array","title":"Dau Trend"},"top_models":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__growth_metrics__ModelUsage"},"type":"array","title":"Top Models"}},"type":"object","required":["period","dau_today","dau_yesterday","dau_7d_avg","mau_current","mau_previous","total_sessions_7d","total_sessions_30d","new_users_7d","new_users_30d","tier_breakdown","dau_trend","top_models"],"title":"GrowthSummary"},"GrowthTimelinePoint":{"properties":{"date":{"type":"string","title":"Date","description":"Date in YYYY-MM-DD format"},"new_followers":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"New Followers","description":"New followers on this day"},"total_followers":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Total Followers","description":"Cumulative follower count"},"total_views":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Total Views","description":"Total views on this day"},"unique_viewers":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Unique Viewers","description":"Unique viewers on this day"},"avg_peak_viewers":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Avg Peak Viewers","description":"Average peak viewers"}},"type":"object","required":["date"],"title":"GrowthTimelinePoint","description":"Single data point in growth timeline","example":{"avg_peak_viewers":45.8,"date":"2025-12-23","new_followers":12,"total_followers":892,"total_views":342,"unique_viewers":187}},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HackathonDetailResponse":{"properties":{"hackathon":{"$ref":"#/components/schemas/HackathonEvent","description":"Hackathon details"},"cached":{"type":"boolean","title":"Cached","description":"Whether response was from cache","default":false}},"type":"object","required":["hackathon"],"title":"HackathonDetailResponse","description":"Response for single hackathon details"},"HackathonEvent":{"properties":{"hackathon_id":{"type":"string","title":"Hackathon Id","description":"Unique hackathon ID"},"name":{"type":"string","title":"Name","description":"Hackathon name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Hackathon description"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date","description":"End date"},"timezone":{"type":"string","title":"Timezone","description":"Timezone","default":"UTC"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"Location"},"format":{"$ref":"#/components/schemas/HackathonFormat","description":"Event format","default":"in_person"},"topic":{"$ref":"#/components/schemas/HackathonTopic","description":"Primary topic","default":"general"},"status":{"$ref":"#/components/schemas/HackathonStatus","description":"Event status","default":"upcoming"},"registration_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Url","description":"Registration URL"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website Url","description":"Website URL"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","description":"Cover image URL"},"organizer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organizer Name","description":"Organizer name"},"participant_count":{"type":"integer","title":"Participant Count","description":"Number of participants","default":0},"max_participants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Participants","description":"Maximum participants"},"prizes":{"items":{"$ref":"#/components/schemas/HackathonPrize"},"type":"array","title":"Prizes","description":"Prize information"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Hackathon tags"}},"type":"object","required":["hackathon_id","name","start_date"],"title":"HackathonEvent","description":"Hackathon event from dotHack API"},"HackathonFormat":{"type":"string","enum":["in_person","virtual","hybrid"],"title":"HackathonFormat","description":"Hackathon format types"},"HackathonHealthResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'ok' when this route responds"},"service":{"type":"string","title":"Service","description":"Service identifier"}},"type":"object","required":["status","service"],"title":"HackathonHealthResponse","description":"Static health document for the hackathon code-review surface.\n\nRefs #8449. Both keys are unconditionally present and the body is fully\nstatic, so no `response_model_exclude_unset` is needed or wanted."},"HackathonListResponse":{"properties":{"hackathons":{"items":{"$ref":"#/components/schemas/HackathonEvent"},"type":"array","title":"Hackathons","description":"List of hackathons"},"total_count":{"type":"integer","title":"Total Count","description":"Total number of hackathons","default":0},"has_more":{"type":"boolean","title":"Has More","description":"Whether more hackathons exist","default":false},"cached":{"type":"boolean","title":"Cached","description":"Whether response was from cache","default":false},"cache_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cache Expires At","description":"Cache expiration time"}},"type":"object","title":"HackathonListResponse","description":"Response for hackathon listing"},"HackathonPrize":{"properties":{"name":{"type":"string","title":"Name","description":"Prize name"},"amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Amount","description":"Prize amount"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Prize description"}},"type":"object","required":["name"],"title":"HackathonPrize","description":"Prize information for a hackathon"},"HackathonStatus":{"type":"string","enum":["upcoming","ongoing","completed","cancelled"],"title":"HackathonStatus","description":"Hackathon status types"},"HackathonTopic":{"type":"string","enum":["ai_ml","web3","fintech","healthtech","edtech","sustainability","general"],"title":"HackathonTopic","description":"Hackathon topic categories"},"HallucinationCheckRequest":{"properties":{"claim":{"type":"string","title":"Claim","description":"Claim to verify against memories"},"memories":{"items":{"type":"string"},"type":"array","title":"Memories","description":"ZeroDB memory strings representing ground truth"}},"type":"object","required":["claim"],"title":"HallucinationCheckRequest"},"HallucinationCheckResponse":{"properties":{"grounded":{"type":"boolean","title":"Grounded"},"confidence":{"type":"number","title":"Confidence"},"evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence"}},"type":"object","required":["grounded","confidence","evidence"],"title":"HallucinationCheckResponse"},"HealthCheckConfig":{"properties":{"name":{"type":"string","title":"Name"},"url":{"type":"string","title":"Url"},"method":{"type":"string","title":"Method"},"timeout_seconds":{"type":"integer","title":"Timeout Seconds"},"expected_status":{"type":"integer","title":"Expected Status"},"critical":{"type":"boolean","title":"Critical"}},"type":"object","required":["name","url","method","timeout_seconds","expected_status","critical"],"title":"HealthCheckConfig","description":"One configured health check (from ``HealthCheck`` dataclass, without\n``headers``/``expected_response_pattern`` — the handler only re-serializes\na subset of fields for this listing)."},"HealthCheckItem":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"response_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Time"},"usage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Usage"},"available":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Available"},"cache_efficiency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cache Efficiency"},"active":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Active"},"utilization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utilization"},"last_backup":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Backup"},"backup_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backup Size"},"replicas":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Replicas"}},"type":"object","required":["status","message"],"title":"HealthCheckItem"},"HealthCheckRequest":{"properties":{"name":{"type":"string","title":"Name"},"url":{"type":"string","title":"Url"},"method":{"type":"string","title":"Method","default":"GET"},"timeout_seconds":{"type":"integer","title":"Timeout Seconds","default":10},"expected_status":{"type":"integer","title":"Expected Status","default":200},"expected_response_pattern":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Response Pattern"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers","default":{}},"critical":{"type":"boolean","title":"Critical","default":true}},"type":"object","required":["name","url"],"title":"HealthCheckRequest","description":"Request model for adding a health check"},"HealthCheckResponse":{"properties":{"overall_health":{"type":"string","title":"Overall Health"},"kong_status":{"type":"string","title":"Kong Status"},"websocket_status":{"type":"string","title":"Websocket Status"},"container_status":{"type":"string","title":"Container Status"},"billing_status":{"type":"string","title":"Billing Status"},"uptime_percentage":{"type":"number","title":"Uptime Percentage"},"health_score":{"type":"number","title":"Health Score"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"last_incident":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Incident"}},"type":"object","required":["overall_health","kong_status","websocket_status","container_status","billing_status","uptime_percentage","health_score","timestamp"],"title":"HealthCheckResponse","description":"Response model for health check"},"HealthCheckResult":{"properties":{"name":{"type":"string","title":"Name"},"url":{"type":"string","title":"Url"},"passed":{"type":"boolean","title":"Passed"},"critical":{"type":"boolean","title":"Critical"},"timestamp":{"type":"string","title":"Timestamp"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Status Code"},"response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time Ms"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["name","url","passed","critical","timestamp"],"title":"HealthCheckResult","description":"One health check's live execution result, from ``_run_health_checks``.\n\n``status_code``/``response_time_ms`` are present on success; ``error`` is\npresent instead when the request itself raised (timeout, DNS failure, etc)."},"HealthCheckResultsSummary":{"properties":{"total_checks":{"type":"integer","title":"Total Checks"},"passed":{"type":"integer","title":"Passed"},"failed":{"type":"integer","title":"Failed"},"critical_failures":{"type":"integer","title":"Critical Failures"}},"type":"object","required":["total_checks","passed","failed","critical_failures"],"title":"HealthCheckResultsSummary"},"HealthChecksConfig":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"interval":{"type":"integer","title":"Interval"},"timeout":{"type":"integer","title":"Timeout"},"healthy_threshold":{"type":"integer","title":"Healthy Threshold"},"unhealthy_threshold":{"type":"integer","title":"Unhealthy Threshold"},"path":{"type":"string","title":"Path"}},"type":"object","required":["enabled","interval","timeout","healthy_threshold","unhealthy_threshold","path"],"title":"HealthChecksConfig"},"HealthComponentStatus":{"properties":{"status":{"type":"string","title":"Status"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"additionalProperties":true,"type":"object","required":["status"],"title":"HealthComponentStatus"},"HealthStatus":{"properties":{"status":{"type":"string","title":"Status","description":"Overall status: healthy, degraded, or unhealthy"},"timestamp":{"type":"string","title":"Timestamp"},"services":{"additionalProperties":{"$ref":"#/components/schemas/ServiceHealthDetail"},"type":"object","title":"Services"},"checks":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Checks"},"healthy_services":{"type":"integer","title":"Healthy Services"},"total_services":{"type":"integer","title":"Total Services"}},"type":"object","required":["status","timestamp","services","checks","healthy_services","total_services"],"title":"HealthStatus"},"HeartbeatConfig":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Enable heartbeat monitoring"},"interval":{"anyOf":[{"$ref":"#/components/schemas/HeartbeatIntervalEnum"},{"type":"null"}],"description":"Heartbeat interval"},"checklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Checklist","description":"Tasks to execute on heartbeat"}},"type":"object","required":["enabled"],"title":"HeartbeatConfig","description":"Heartbeat configuration schema"},"HeartbeatExecutionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Execution ID"},"agent_id":{"type":"string","format":"uuid","title":"Agent Id","description":"Agent instance ID"},"status":{"$ref":"#/components/schemas/HeartbeatExecutionStatusEnum","description":"Execution status"},"checklist_items":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Checklist Items","description":"Checklist items executed"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At","description":"Execution start time"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At","description":"Execution completion time"},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Seconds","description":"Execution duration in seconds"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error message if failed"}},"type":"object","required":["id","agent_id","status"],"title":"HeartbeatExecutionResponse","description":"Response schema for heartbeat execution"},"HeartbeatExecutionStatusEnum":{"type":"string","enum":["pending","running","completed","failed","skipped"],"title":"HeartbeatExecutionStatusEnum","description":"Heartbeat execution status"},"HeartbeatIntervalEnum":{"type":"string","enum":["5m","15m","30m","1h","2h"],"title":"HeartbeatIntervalEnum","description":"Heartbeat interval options"},"HeartbeatRequest":{"properties":{"user_id":{"type":"string","title":"User Id","description":"Must match the session owner (UUID)"}},"type":"object","required":["user_id"],"title":"HeartbeatRequest"},"HelpCategory":{"type":"string","enum":["getting_started","api_usage","collaboration","administration","troubleshooting","advanced","integration"],"title":"HelpCategory","description":"Help category types"},"HelpDashboardResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"overview_metrics":{"additionalProperties":true,"type":"object","title":"Overview Metrics"},"popular_content":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Popular Content"},"recent_updates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recent Updates"},"user_activity":{"additionalProperties":true,"type":"object","title":"User Activity"},"content_statistics":{"additionalProperties":true,"type":"object","title":"Content Statistics"},"search_analytics":{"additionalProperties":true,"type":"object","title":"Search Analytics"},"feedback_summary":{"additionalProperties":true,"type":"object","title":"Feedback Summary"},"content_gaps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Content Gaps"}},"type":"object","required":["timestamp","overview_metrics","popular_content","recent_updates","user_activity","content_statistics","search_analytics","feedback_summary","content_gaps"],"title":"HelpDashboardResponse","description":"Response for GET /help-documentation/dashboard.\n\nEvery nested section is built from fixed-shape (mock) helper\nfunctions but kept as Dict[str, Any]/List[Dict[str, Any]] here since\ntheir internal key sets are not enforced by any request input and are\ndocumentation detail rather than the contract this pass targets."},"HelpdeskSetupSummary":{"properties":{"inbox_id":{"type":"string","title":"Inbox Id"},"inbox_token":{"type":"string","title":"Inbox Token"},"company_name":{"type":"string","title":"Company Name"},"tier":{"type":"string","title":"Tier"},"limits":{"additionalProperties":{"type":"integer"},"type":"object","title":"Limits"}},"type":"object","required":["inbox_id","inbox_token","company_name","tier","limits"],"title":"HelpdeskSetupSummary"},"HelpdeskStatusHelpdeskInfo":{"properties":{"inbox_id":{"type":"string","title":"Inbox Id"},"name":{"type":"string","title":"Name"},"inbox_token":{"type":"string","title":"Inbox Token"},"site_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Site Url"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["inbox_id","name","inbox_token"],"title":"HelpdeskStatusHelpdeskInfo"},"HelpdeskStatusResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"setup_complete":{"type":"boolean","title":"Setup Complete"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"helpdesk":{"anyOf":[{"$ref":"#/components/schemas/HelpdeskStatusHelpdeskInfo"},{"type":"null"}]},"usage":{"anyOf":[{"$ref":"#/components/schemas/HelpdeskUsageInfo"},{"type":"null"}]},"widget_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Widget Config"}},"type":"object","required":["ok","setup_complete"],"title":"HelpdeskStatusResponse","description":"Returned by GET /status. `helpdesk`/`usage`/`widget_config` are omitted\nwhen the customer has not yet run POST /setup (`setup_complete=False`)."},"HelpdeskUsageInfo":{"properties":{"total_conversations":{"type":"integer","title":"Total Conversations"},"total_messages":{"type":"integer","title":"Total Messages"}},"type":"object","required":["total_conversations","total_messages"],"title":"HelpdeskUsageInfo"},"HistoricalAggregatedStats":{"properties":{"avg_response_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Response Time","description":"Mean response time over window"},"peak_requests_per_hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Peak Requests Per Hour","description":"Peak hourly request count"},"uptime_percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Uptime Percentage","description":"Uptime percentage over window"}},"additionalProperties":true,"type":"object","title":"HistoricalAggregatedStats","description":"`historical_data.aggregated_stats` block (admin + include_historical)."},"HistoricalMetricsData":{"properties":{"time_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Range","description":"Requested time range"},"data_points":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Data Points","description":"Historical data points"},"aggregated_stats":{"anyOf":[{"$ref":"#/components/schemas/HistoricalAggregatedStats"},{"type":"null"}],"description":"Aggregates over the window"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"Implementation note, when applicable"}},"additionalProperties":true,"type":"object","title":"HistoricalMetricsData","description":"`historical_data` block, present only for admins requesting history."},"HookCreate":{"properties":{"event_type":{"type":"string","maxLength":100,"minLength":1,"title":"Event Type","description":"Event type to trigger on (e.g. zerodb.vector.stored)"},"hook_name":{"type":"string","maxLength":100,"minLength":1,"title":"Hook Name","description":"Handler name (e.g. auto_embed)"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"Scope to project (NULL = all projects)"},"hook_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Hook Config","description":"Handler-specific configuration"}},"type":"object","required":["event_type","hook_name"],"title":"HookCreate"},"HookResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"event_type":{"type":"string","title":"Event Type"},"hook_type":{"type":"string","title":"Hook Type"},"hook_name":{"type":"string","title":"Hook Name"},"hook_config":{"title":"Hook Config"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","user_id","project_id","event_type","hook_type","hook_name","hook_config","is_active","created_at","updated_at"],"title":"HookResponse"},"HookUpdate":{"properties":{"hook_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Hook Config"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}},"type":"object","title":"HookUpdate"},"HourlyTrendRow":{"properties":{"hour":{"type":"string","title":"Hour"},"count":{"type":"integer","title":"Count"}},"additionalProperties":true,"type":"object","required":["hour","count"],"title":"HourlyTrendRow","description":"One hourly bucket of security events."},"HumanFeedbackRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Agent type or ID being rated"},"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"Quality score (0=bad, 1=good)"},"feedback_text":{"type":"string","title":"Feedback Text","description":"Optional text feedback","default":""},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context","description":"Additional context"}},"type":"object","required":["agent_id","score"],"title":"HumanFeedbackRequest","description":"Request model for human RLHF feedback on agent outputs"},"HumanFeedbackResponse":{"properties":{"status":{"type":"string","title":"Status"},"agent_id":{"type":"string","title":"Agent Id"},"score":{"type":"number","title":"Score"},"feedback_type":{"type":"string","title":"Feedback Type"},"message":{"type":"string","title":"Message"},"recorded_at":{"type":"string","title":"Recorded At"}},"type":"object","required":["status","agent_id","score","feedback_type","message","recorded_at"],"title":"HumanFeedbackResponse","description":"Response for POST /dashboard/human-feedback."},"ICEServer":{"properties":{"urls":{"items":{"type":"string"},"type":"array","title":"Urls","description":"List of server URLs"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username","description":"TURN username for authentication"},"credential":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential","description":"TURN credential for authentication"}},"type":"object","required":["urls"],"title":"ICEServer","description":"ICE server configuration (STUN/TURN)","example":{"credential":"secret456","urls":["turn:turn.ainative.studio:3478"],"username":"user123"}},"ICEServersResponse":{"properties":{"ice_servers":{"items":{"$ref":"#/components/schemas/ICEServer"},"type":"array","title":"Ice Servers","description":"List of STUN/TURN servers"}},"type":"object","required":["ice_servers"],"title":"ICEServersResponse","description":"Response model for ICE servers endpoint"},"IPBlockActionResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"reason":{"type":"string","title":"Reason"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","reason","timestamp"],"title":"IPBlockActionResponse","description":"Result of a manual block/unblock IP action."},"IPReputationResponse":{"properties":{"ip_reputation":{"items":{"$ref":"#/components/schemas/IPReputationRow"},"type":"array","title":"Ip Reputation"},"total_ips":{"type":"integer","title":"Total Ips"},"filters_applied":{"additionalProperties":true,"type":"object","title":"Filters Applied"},"timestamp":{"type":"string","title":"Timestamp"}},"additionalProperties":true,"type":"object","required":["ip_reputation","total_ips","filters_applied","timestamp"],"title":"IPReputationResponse","description":"GET /ip-reputation."},"IPReputationRow":{"properties":{"ip_address":{"type":"string","title":"Ip Address"},"trust_score":{"type":"number","title":"Trust Score"},"request_count":{"type":"integer","title":"Request Count"},"failed_auth_attempts":{"type":"integer","title":"Failed Auth Attempts"},"suspicious_requests":{"type":"integer","title":"Suspicious Requests"},"blocked":{"type":"boolean","title":"Blocked"},"block_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Block Reason"},"first_seen":{"type":"string","title":"First Seen"},"last_seen":{"type":"string","title":"Last Seen"}},"additionalProperties":true,"type":"object","required":["ip_address","trust_score","request_count","failed_auth_attempts","suspicious_requests","blocked","first_seen","last_seen"],"title":"IPReputationRow","description":"One IP reputation record. `block_reason` is None for non-blocked IPs."},"IPWhitelistConfig":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"mode":{"type":"string","title":"Mode","default":"allowlist"},"entries":{"items":{"$ref":"#/components/schemas/IPWhitelistResponse"},"type":"array","title":"Entries"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["enabled","entries","total"],"title":"IPWhitelistConfig","description":"IP whitelist configuration response"},"IPWhitelistEntry":{"properties":{"ip":{"type":"string","title":"Ip","description":"IP address or CIDR notation (e.g., 192.168.1.0/24)"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the IP entry"}},"type":"object","required":["ip"],"title":"IPWhitelistEntry","description":"IP whitelist entry model"},"IPWhitelistResponse":{"properties":{"id":{"type":"string","title":"Id"},"ip":{"type":"string","title":"Ip"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"type":"string","title":"Created At"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["id","ip","description","created_at","user_id"],"title":"IPWhitelistResponse","description":"IP whitelist response model"},"IdeCliQuotaResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"tier":{"type":"string","title":"Tier"},"plan_name":{"type":"string","title":"Plan Name"},"completions":{"$ref":"#/components/schemas/QuotaStatus"},"chat":{"$ref":"#/components/schemas/QuotaStatus"},"context_window_tokens":{"type":"integer","title":"Context Window Tokens"},"memory_entries":{"type":"integer","title":"Memory Entries"},"models":{"items":{"type":"string"},"type":"array","title":"Models"},"codebase_indexing":{"type":"boolean","title":"Codebase Indexing","default":false},"custom_instructions":{"type":"boolean","title":"Custom Instructions","default":false},"shared_context":{"type":"boolean","title":"Shared Context","default":false}},"additionalProperties":true,"type":"object","required":["user_id","tier","plan_name","completions","chat","context_window_tokens","memory_entries"],"title":"IdeCliQuotaResponse"},"IgnoreResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Ignore relationship ID"},"ignorer_id":{"type":"string","title":"Ignorer Id","description":"Ignorer user ID"},"ignored_id":{"type":"string","title":"Ignored Id","description":"Ignored user ID"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the ignore was created"}},"type":"object","required":["id","ignorer_id","ignored_id","created_at"],"title":"IgnoreResponse","description":"Response for ignore operations"},"ImageGenerateRequest":{"properties":{"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt","description":"Text prompt for image generation"},"model":{"type":"string","title":"Model","description":"Model to use: qwen-image (RunPod), fal-flux, etc.","default":"qwen-image"},"width":{"type":"integer","maximum":2048,"minimum":256,"title":"Width","description":"Image width in pixels","default":1024},"height":{"type":"integer","maximum":2048,"minimum":256,"title":"Height","description":"Image height in pixels","default":1024},"style":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Style","description":"Optional style/LoRA for generation"}},"type":"object","required":["prompt"],"title":"ImageGenerateRequest","description":"Request schema for image generation"},"ImageRequest":{"properties":{"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt","description":"Image generation prompt"},"width":{"type":"integer","maximum":2048,"minimum":512,"title":"Width","description":"Image width","default":1024},"height":{"type":"integer","maximum":2048,"minimum":512,"title":"Height","description":"Image height","default":1024},"style":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Style","description":"Optional LoRA style"}},"type":"object","required":["prompt"],"title":"ImageRequest","description":"Request schema for image generation","example":{"height":1024,"prompt":"A futuristic cityscape at sunset with neon lights","width":1024}},"ImageResponse":{"properties":{"image_base64":{"type":"string","title":"Image Base64","description":"Base64-encoded image file"},"format":{"type":"string","title":"Format","description":"Image format (jpg, png)"},"width":{"type":"integer","title":"Width","description":"Image width"},"height":{"type":"integer","title":"Height","description":"Image height"},"usage_id":{"type":"string","title":"Usage Id","description":"Usage record ID"},"credits_used":{"type":"integer","title":"Credits Used","description":"Credits deducted"},"credits_remaining":{"type":"integer","title":"Credits Remaining","description":"User's remaining credits"}},"type":"object","required":["image_base64","format","width","height","usage_id","credits_used","credits_remaining"],"title":"ImageResponse","description":"Response schema for image generation"},"ImpactCategoryInfo":{"properties":{"category":{"type":"string","title":"Category"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["category","name","description"],"title":"ImpactCategoryInfo"},"ImportDataResponse":{"properties":{"import_id":{"type":"string","title":"Import Id"},"status":{"type":"string","title":"Status"},"vectors_imported":{"type":"integer","title":"Vectors Imported"},"errors":{"type":"integer","title":"Errors"},"error_details":{"items":{"type":"string"},"type":"array","title":"Error Details","description":"Omitted (defaults to []) on the early empty-records return path."},"message":{"type":"string","title":"Message"}},"type":"object","required":["import_id","status","vectors_imported","errors","message"],"title":"ImportDataResponse"},"ImportDocResult":{"properties":{"ok":{"type":"boolean","title":"Ok"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Id"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"},"memory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Type"}},"type":"object","required":["ok"],"title":"ImportDocResult","description":"One per-document result from import_document() — `ok=False` rows carry\n`error` and omit the success-only fields; Optional reflects that split."},"ImportRequest":{"properties":{"documents":{"items":{},"type":"array","title":"Documents","description":"One or more MIF/Vault-LD docs (str or JSON obj)"},"format":{"type":"string","title":"Format","description":"mif-json | mif-md | vault-ld"},"namespace":{"type":"string","title":"Namespace","description":"Target namespace — REQUIRED (global|project:|session:)"}},"type":"object","required":["documents","format","namespace"],"title":"ImportRequest"},"ImportResponse":{"properties":{"imported":{"type":"integer","title":"Imported"},"failed":{"type":"integer","title":"Failed"},"results":{"items":{"$ref":"#/components/schemas/ImportDocResult"},"type":"array","title":"Results"}},"type":"object","required":["imported","failed","results"],"title":"ImportResponse"},"ImportVaultLDResponse":{"properties":{"status":{"type":"string","title":"Status"},"lossless":{"type":"boolean","title":"Lossless"},"flagged":{"items":{},"type":"array","title":"Flagged"},"entities_written":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Entities Written"},"edges_written":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Edges Written"},"ontology_written":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ontology Written"}},"additionalProperties":true,"type":"object","required":["status","lossless"],"title":"ImportVaultLDResponse","description":"Response for POST /memory/v2/graph/import/vault-ld.\n\n``flagged`` lists constructs that could not round-trip losslessly (blank\nnodes, language-tagged literals) so a lossy import is visible rather than\nsilently dropping data (SPEC §5.6, Refs #5776). The three counter fields\nare spread in from graph_bridge.import_vault_graph's summary."},"Impression":{"properties":{"impression_id":{"type":"string","title":"Impression Id","description":"Unique impression identifier"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID"},"creative_id":{"type":"string","title":"Creative Id","description":"Creative ID"},"event_id":{"type":"string","title":"Event Id","description":"Event ID"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User ID (None if anonymous)"},"placement":{"$ref":"#/components/schemas/PlacementType","description":"Ad placement location"},"device_type":{"$ref":"#/components/schemas/DeviceType","description":"Device type"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent","description":"Browser user agent"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address","description":"Client IP address"},"credit_cost":{"type":"number","minimum":0,"title":"Credit Cost","description":"Credits deducted for this impression (based on placement)"},"organizer_revenue":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Organizer Revenue","description":"Revenue allocated to organizer (60% default)"},"platform_revenue":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Platform Revenue","description":"Revenue allocated to platform (40% default)"},"tracked_at":{"type":"string","format":"date-time","title":"Tracked At","description":"Timestamp when impression was tracked"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Record creation timestamp"}},"type":"object","required":["impression_id","campaign_id","creative_id","event_id","placement","device_type","credit_cost","tracked_at","created_at"],"title":"Impression","description":"Schema for impression response\n\nReturned after successfully tracking an impression.\nIncludes all tracked data plus system-generated fields.\nIssue #614: Added revenue split fields","example":{"campaign_id":"camp_abc123","created_at":"2026-01-05T14:30:00Z","creative_id":"creative_def456","credit_cost":0.02,"device_type":"desktop","event_id":"event_pai2026","impression_id":"imp_abc123def456","ip_address":"192.168.1.100","organizer_revenue":0.012,"placement":"header","platform_revenue":0.008,"tracked_at":"2026-01-05T14:30:00Z","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)","user_id":"user_xyz789"}},"ImpressionCreate":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID that served the ad"},"creative_id":{"type":"string","title":"Creative Id","description":"Creative ID that was displayed"},"event_id":{"type":"string","title":"Event Id","description":"Event ID where ad was shown"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User ID if authenticated, None for anonymous users"},"placement":{"$ref":"#/components/schemas/PlacementType","description":"Ad placement location on page"},"device_type":{"$ref":"#/components/schemas/DeviceType","description":"Device type used to view ad"},"user_agent":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"User Agent","description":"Browser user agent string"},"ip_address":{"anyOf":[{"type":"string","maxLength":45},{"type":"null"}],"title":"Ip Address","description":"Client IP address for fraud detection"}},"type":"object","required":["campaign_id","creative_id","event_id","placement","device_type"],"title":"ImpressionCreate","description":"Schema for creating an impression tracking record\n\nRequired for tracking when an ad is displayed to a user.\nUsed by ad serving system to log impressions for billing and analytics.","example":{"campaign_id":"camp_abc123","creative_id":"creative_def456","device_type":"desktop","event_id":"event_pai2026","ip_address":"192.168.1.100","placement":"header","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)","user_id":"user_xyz789"}},"ImprovementReportRequest":{"properties":{"feature_type":{"type":"string","title":"Feature Type","description":"Feature to analyze"},"date_range":{"additionalProperties":{"type":"string"},"type":"object","title":"Date Range","description":"Date range for analysis"},"min_interactions":{"type":"integer","minimum":1,"title":"Min Interactions","description":"Minimum interactions required","default":10}},"type":"object","required":["feature_type","date_range"],"title":"ImprovementReportRequest","description":"Request schema for generating improvement reports","example":{"date_range":{"end":"2025-01-31","start":"2025-01-01"},"feature_type":"team_suggestions","min_interactions":10}},"ImprovementSummary":{"properties":{"improved":{"type":"integer","title":"Improved"},"degraded":{"type":"integer","title":"Degraded"},"neutral":{"type":"integer","title":"Neutral"}},"type":"object","required":["improved","degraded","neutral"],"title":"ImprovementSummary"},"ImprovementTrends":{"properties":{"quality_improvement":{"type":"string","title":"Quality Improvement"},"security_improvement":{"type":"string","title":"Security Improvement"},"performance_improvement":{"type":"string","title":"Performance Improvement"},"test_coverage_improvement":{"type":"string","title":"Test Coverage Improvement"}},"type":"object","required":["quality_improvement","security_improvement","performance_improvement","test_coverage_improvement"],"title":"ImprovementTrends"},"InboxSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"site_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Site Url"},"token":{"type":"string","title":"Token"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","name","token","created_at"],"title":"InboxSummary"},"IndexRepositoryRequest":{"properties":{"repository_id":{"type":"string","format":"uuid4","title":"Repository Id","description":"Repository identifier"},"files":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Files","description":"Files to index"}},"type":"object","required":["repository_id","files"],"title":"IndexRepositoryRequest","description":"Request model for repository indexing."},"IndexRequest":{"properties":{"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"ZeroDB project UUID"},"repo_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repo Hash","description":"Git remote hash (alternative to project_id)"},"fragments":{"items":{"$ref":"#/components/schemas/CodeFragment-Input"},"type":"array","maxItems":100,"minItems":1,"title":"Fragments","description":"Up to 100 code fragments to embed and store"}},"type":"object","required":["fragments"],"title":"IndexRequest"},"IndexResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"indexed":{"type":"integer","title":"Indexed"},"errors":{"type":"integer","title":"Errors","default":0},"embedded":{"type":"integer","title":"Embedded","description":"Fragments stored WITH a usable embedding (semantically searchable)","default":0},"embedding_errors":{"type":"integer","title":"Embedding Errors","description":"Fragments stored without an embedding because generation failed. They remain text-searchable but are not semantically ranked.","default":0}},"type":"object","required":["indexed"],"title":"IndexResponse"},"IndexStatusResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"project_id":{"type":"string","title":"Project Id"},"status":{"type":"string","title":"Status","description":"empty | indexed"},"total_fragments":{"type":"integer","title":"Total Fragments"},"total_files":{"type":"integer","title":"Total Files"},"last_indexed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Indexed At"},"languages":{"additionalProperties":{"type":"integer"},"type":"object","title":"Languages"}},"type":"object","required":["project_id","status","total_fragments","total_files","last_indexed_at","languages"],"title":"IndexStatusResponse"},"IndexUsageMetrics":{"properties":{"total_indexes":{"type":"integer","title":"Total Indexes"},"unused_indexes":{"type":"integer","title":"Unused Indexes"},"duplicate_indexes":{"type":"integer","title":"Duplicate Indexes"},"index_usage":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Index Usage"},"index_cache_hit_ratio":{"type":"number","title":"Index Cache Hit Ratio"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["total_indexes","unused_indexes","duplicate_indexes","index_usage","index_cache_hit_ratio","recommendations"],"title":"IndexUsageMetrics"},"IndexingStatsResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable status message"},"project_id":{"type":"string","title":"Project Id","description":"Project identifier"},"stats":{"$ref":"#/components/schemas/RepositoryIndexingStats","description":"Indexing statistics"},"note":{"type":"string","title":"Note","description":"Implementation note"}},"type":"object","required":["message","project_id","stats","note"],"title":"IndexingStatsResponse","description":"Response for GET /indexing/repositories/{project_id}/stats."},"IndustriesResponse":{"properties":{"industries":{"items":{"$ref":"#/components/schemas/IndustryOption"},"type":"array","title":"Industries"}},"type":"object","required":["industries"],"title":"IndustriesResponse"},"IndustryBenchmarkResponse":{"properties":{"industry":{"type":"string","title":"Industry"},"median":{"type":"integer","title":"Median"},"p25":{"type":"integer","title":"P25"},"p75":{"type":"integer","title":"P75"},"top_10":{"type":"integer","title":"Top 10"},"sample_size":{"type":"integer","title":"Sample Size"},"is_estimated":{"type":"boolean","title":"Is Estimated","default":true}},"type":"object","required":["industry","median","p25","p75","top_10","sample_size"],"title":"IndustryBenchmarkResponse"},"IndustryListResponse":{"properties":{"industries":{"items":{"type":"string"},"type":"array","title":"Industries"}},"type":"object","required":["industries"],"title":"IndustryListResponse"},"IndustryOption":{"properties":{"key":{"type":"string","title":"Key"},"description":{"type":"string","title":"Description"}},"type":"object","required":["key","description"],"title":"IndustryOption"},"InferOntologyResponse":{"properties":{"proposed_ontology":{"$ref":"#/components/schemas/ProposedOntology"},"total_entities":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Entities"},"generic_entity_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Generic Entity Count"},"diff":{"anyOf":[{"$ref":"#/components/schemas/OntologyDiff"},{"type":"null"}]}},"additionalProperties":true,"type":"object","required":["proposed_ontology"],"title":"InferOntologyResponse","description":"Response for POST /memory/v2/graph/ontology/infer.\n\n``diff`` is genuinely ``None`` when no project_id was supplied — that is a\nreal null on the wire today, not an unset field, so it is modeled as a\nnullable field rather than excluded."},"InferenceMetrics":{"properties":{"period":{"type":"string","title":"Period"},"request_count":{"type":"integer","title":"Request Count"},"error_count":{"type":"integer","title":"Error Count"},"error_rate":{"type":"number","title":"Error Rate"},"latency_ms":{"$ref":"#/components/schemas/app__api__v1__endpoints__inference_observability__LatencyPercentiles"},"total_tokens":{"type":"integer","title":"Total Tokens"},"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"avg_tokens_per_request":{"type":"number","title":"Avg Tokens Per Request"},"total_cost_usd":{"type":"number","title":"Total Cost Usd"},"requests_per_hour":{"type":"number","title":"Requests Per Hour"}},"type":"object","required":["period","request_count","error_count","error_rate","latency_ms","total_tokens","prompt_tokens","completion_tokens","avg_tokens_per_request","total_cost_usd","requests_per_hour"],"title":"InferenceMetrics"},"InferredEntityType":{"properties":{"name":{"type":"string","title":"Name"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"}},"additionalProperties":true,"type":"object","required":["name"],"title":"InferredEntityType"},"InferredPredicate":{"properties":{"name":{"type":"string","title":"Name"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"target_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Type"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"}},"additionalProperties":true,"type":"object","required":["name"],"title":"InferredPredicate"},"InfrastructureHealth":{"properties":{"score":{"type":"integer","title":"Score"},"status":{"type":"string","title":"Status"},"issues":{"items":{"type":"string"},"type":"array","title":"Issues"},"healthy_instances":{"type":"integer","title":"Healthy Instances"},"total_instances":{"type":"integer","title":"Total Instances"},"last_checked":{"type":"string","title":"Last Checked"}},"type":"object","required":["score","status","issues","healthy_instances","total_instances","last_checked"],"title":"InfrastructureHealth"},"InfrastructureResult":{"properties":{"submarine_cables":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Submarine Cables"},"bgp_prefixes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Bgp Prefixes"},"broadband":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Broadband"},"network_probes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Network Probes"},"total_assets":{"type":"integer","title":"Total Assets","default":0},"source":{"type":"string","title":"Source","default":"sensor_network"},"historical_data":{"items":{},"type":"array","title":"Historical Data"}},"type":"object","title":"InfrastructureResult"},"InfrastructureStatusResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"overall_health":{"$ref":"#/components/schemas/InfrastructureHealth"},"system_metrics":{"$ref":"#/components/schemas/app__schemas__admin__scaling__SystemMetrics"},"load_balancer":{"$ref":"#/components/schemas/LoadBalancerStatus"},"autoscaling":{"$ref":"#/components/schemas/AutoscalingConfiguration"},"instances":{"items":{"$ref":"#/components/schemas/InstanceInfo"},"type":"array","title":"Instances"},"capacity_planning":{"$ref":"#/components/schemas/app__schemas__admin__scaling__CapacityPlanning"},"scaling_recommendations":{"items":{"type":"string"},"type":"array","title":"Scaling Recommendations"}},"type":"object","required":["timestamp","overall_health","system_metrics","load_balancer","autoscaling","instances","capacity_planning","scaling_recommendations"],"title":"InfrastructureStatusResponse"},"InitRepositoryResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"repository":{"additionalProperties":true,"type":"object","title":"Repository"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","repository","timestamp"],"title":"InitRepositoryResponse","description":"Response for POST /git-integration/repository/init."},"InitializeRailwayProjectResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"project":{"additionalProperties":true,"type":"object","title":"Project"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","project","timestamp"],"title":"InitializeRailwayProjectResponse","description":"Response for POST /railway-deployment/initialize."},"InitiateRestoreResponse":{"properties":{"recovery_id":{"type":"string","title":"Recovery Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"estimated_duration_minutes":{"type":"integer","title":"Estimated Duration Minutes"}},"type":"object","required":["recovery_id","status","message","estimated_duration_minutes"],"title":"InitiateRestoreResponse"},"InsightResponse":{"properties":{"insight_id":{"type":"string","title":"Insight Id"},"category":{"type":"string","title":"Category"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"recommendation":{"type":"string","title":"Recommendation"},"confidence":{"type":"number","title":"Confidence"},"affected_prompts":{"items":{"type":"string"},"type":"array","title":"Affected Prompts"},"supporting_feedback":{"items":{"type":"string"},"type":"array","title":"Supporting Feedback"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"priority":{"type":"string","title":"Priority"}},"type":"object","required":["insight_id","category","title","description","recommendation","confidence","affected_prompts","supporting_feedback","created_at","priority"],"title":"InsightResponse"},"InstallCliResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"cli_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cli Path"},"install_output":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Install Output"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status","message"],"title":"InstallCliResponse","description":"Response for POST /railway-deployment/cli/install.\n\nSuccess and failure share different key sets on this endpoint (no\nHTTPException on a bad `npm install` exit code — it returns 200 with\nstatus: \"failed\" instead), so every field beyond `status`/`message`\nis optional to preserve both real shapes."},"InstallPluginRequest":{"properties":{"plugin_id":{"type":"string","minLength":1,"title":"Plugin Id","description":"Plugin ID from the registry"}},"type":"object","required":["plugin_id"],"title":"InstallPluginRequest","description":"Body for POST /agents/{agent_id}/plugins."},"InstallToolResponse":{"properties":{"message":{"type":"string","title":"Message"},"status":{"$ref":"#/components/schemas/ToolStatus"}},"type":"object","required":["message","status"],"title":"InstallToolResponse","description":"Response for POST /scaffolding-tools/install/{tool}."},"InstallationProfile":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"features":{"items":{"type":"string"},"type":"array","title":"Features"},"tier":{"type":"string","title":"Tier"}},"type":"object","required":["name","description","features","tier"],"title":"InstallationProfile"},"InstallationProfilesResponse":{"properties":{"profiles":{"items":{"$ref":"#/components/schemas/InstallationProfile"},"type":"array","title":"Profiles"}},"type":"object","required":["profiles"],"title":"InstallationProfilesResponse"},"InstalledPluginListResponse":{"properties":{"plugins":{"items":{"$ref":"#/components/schemas/InstalledPluginResponse"},"type":"array","title":"Plugins"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["plugins","total"],"title":"InstalledPluginListResponse","description":"List of installed plugins for an agent."},"InstalledPluginResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"plugin_id":{"type":"string","title":"Plugin Id"},"plugin_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plugin Name"},"plugin_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plugin Version"},"plugin_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plugin Description"},"tools":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tools"},"installed_by":{"type":"string","title":"Installed By"},"installed_at":{"type":"string","format":"date-time","title":"Installed At"}},"type":"object","required":["id","agent_id","plugin_id","installed_by","installed_at"],"title":"InstalledPluginResponse","description":"Response for a single installed plugin."},"InstalledSkillsResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"skills":{"items":{"$ref":"#/components/schemas/SkillResponse"},"type":"array","title":"Skills"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["skills","total"],"title":"InstalledSkillsResponse","description":"List of user's installed skills."},"InstanceCurrentStatus":{"properties":{"health":{"type":"string","title":"Health"},"last_restart":{"type":"string","title":"Last Restart"},"uptime_seconds":{"type":"integer","title":"Uptime Seconds"},"active_connections":{"type":"integer","title":"Active Connections"}},"type":"object","required":["health","last_restart","uptime_seconds","active_connections"],"title":"InstanceCurrentStatus"},"InstanceHealthChecks":{"properties":{"last_check":{"type":"string","title":"Last Check"},"status":{"type":"string","title":"Status"},"response_time_ms":{"type":"integer","title":"Response Time Ms"},"consecutive_failures":{"type":"integer","title":"Consecutive Failures"}},"type":"object","required":["last_check","status","response_time_ms","consecutive_failures"],"title":"InstanceHealthChecks"},"InstanceInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"region":{"type":"string","title":"Region"},"availability_zone":{"type":"string","title":"Availability Zone"},"instance_type":{"type":"string","title":"Instance Type"},"cpu_cores":{"type":"integer","title":"Cpu Cores"},"memory_gb":{"type":"integer","title":"Memory Gb"},"disk_gb":{"type":"integer","title":"Disk Gb"},"private_ip":{"type":"string","title":"Private Ip"},"public_ip":{"type":"string","title":"Public Ip"},"launch_time":{"type":"string","title":"Launch Time"},"uptime_hours":{"type":"integer","title":"Uptime Hours"},"metrics":{"$ref":"#/components/schemas/InstanceMetricsSnapshot"},"health_checks":{"$ref":"#/components/schemas/InstanceHealthChecks"}},"type":"object","required":["id","name","status","region","availability_zone","instance_type","cpu_cores","memory_gb","disk_gb","private_ip","public_ip","launch_time","uptime_hours","metrics","health_checks"],"title":"InstanceInfo"},"InstanceMetricSeries":{"properties":{"timestamps":{"items":{"type":"string"},"type":"array","title":"Timestamps"},"values":{"items":{"type":"number"},"type":"array","title":"Values"},"unit":{"type":"string","title":"Unit"},"average":{"type":"number","title":"Average"},"max":{"type":"number","title":"Max"},"min":{"type":"number","title":"Min"}},"type":"object","required":["timestamps","values","unit","average","max","min"],"title":"InstanceMetricSeries"},"InstanceMetricsBundle":{"properties":{"cpu_utilization":{"$ref":"#/components/schemas/InstanceMetricSeries"},"memory_utilization":{"$ref":"#/components/schemas/InstanceMetricSeries"},"network_throughput":{"$ref":"#/components/schemas/InstanceMetricSeries"}},"type":"object","required":["cpu_utilization","memory_utilization","network_throughput"],"title":"InstanceMetricsBundle"},"InstanceMetricsResponse":{"properties":{"instance_id":{"type":"string","title":"Instance Id"},"period":{"type":"string","title":"Period"},"metrics":{"$ref":"#/components/schemas/InstanceMetricsBundle"},"current_status":{"$ref":"#/components/schemas/InstanceCurrentStatus"}},"type":"object","required":["instance_id","period","metrics","current_status"],"title":"InstanceMetricsResponse"},"InstanceMetricsSnapshot":{"properties":{"cpu_utilization":{"type":"number","title":"Cpu Utilization"},"memory_utilization":{"type":"number","title":"Memory Utilization"},"disk_utilization":{"type":"number","title":"Disk Utilization"},"network_in_mbps":{"type":"number","title":"Network In Mbps"},"network_out_mbps":{"type":"number","title":"Network Out Mbps"},"active_connections":{"type":"integer","title":"Active Connections"}},"type":"object","required":["cpu_utilization","memory_utilization","disk_utilization","network_in_mbps","network_out_mbps","active_connections"],"title":"InstanceMetricsSnapshot"},"InstantAnswerRequest":{"properties":{"question":{"type":"string","maxLength":500,"minLength":3,"title":"Question"},"contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Email"},"conversation_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Context"}},"type":"object","required":["question"],"title":"InstantAnswerRequest"},"InstantAnswerResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"answered":{"type":"boolean","title":"Answered"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer"},"sources":{"items":{"$ref":"#/components/schemas/DocSource"},"type":"array","title":"Sources","default":[]},"confidence":{"type":"number","title":"Confidence","default":0},"deflectable":{"type":"boolean","title":"Deflectable","default":false}},"type":"object","required":["answered"],"title":"InstantAnswerResponse"},"InstantDBRequest":{"properties":{"agree_terms":{"type":"boolean","title":"Agree Terms","default":false},"on_behalf_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"On Behalf Of"},"dealroom":{"type":"boolean","title":"Dealroom","default":false},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"workspace_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workspace Id"},"permanent":{"type":"boolean","title":"Permanent","default":false}},"type":"object","title":"InstantDBRequest","description":"Request body for instant-db provisioning — Issue #1227."},"InstantDbClaimByProjectRequest":{"properties":{"project_id":{"type":"string","minLength":1,"title":"Project Id","description":"UUID of the unclaimed project"}},"type":"object","required":["project_id"],"title":"InstantDbClaimByProjectRequest"},"InstantDbClaimRequest":{"properties":{"token":{"type":"string","minLength":1,"title":"Token","description":"Claim token from claim_url"},"project_id":{"type":"string","minLength":1,"title":"Project Id","description":"UUID of the temp project"}},"type":"object","required":["token","project_id"],"title":"InstantDbClaimRequest","description":"Request body for claiming a temp instant-db project."},"InstantDbClaimResponse":{"properties":{"claimed":{"type":"boolean","title":"Claimed"},"project_id":{"type":"string","title":"Project Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"message":{"type":"string","title":"Message"},"login_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Login Url"}},"type":"object","required":["claimed","project_id","message"],"title":"InstantDbClaimResponse","description":"Response body returned after a successful claim."},"InstantDbProvisionResponse":{"properties":{"api_key":{"type":"string","title":"Api Key"},"project_id":{"type":"string","title":"Project Id"},"base_url":{"type":"string","title":"Base Url"},"expires_at":{"type":"string","title":"Expires At"},"claim_url":{"type":"string","title":"Claim Url"},"mcp_url":{"type":"string","title":"Mcp Url"},"quickstart":{"additionalProperties":true,"type":"object","title":"Quickstart"},"limits":{"additionalProperties":true,"type":"object","title":"Limits"},"quick_start":{"additionalProperties":true,"type":"object","title":"Quick Start"},"connection_string":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection String"},"terms_agreed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Terms Agreed At"},"mcp":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Mcp"},"database":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Database"},"verify":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Verify"},"next_steps":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Next Steps"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning"},"support":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Support"},"dealroom":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dealroom"}},"additionalProperties":true,"type":"object","required":["api_key","project_id","base_url","expires_at","claim_url","mcp_url","quickstart","limits","quick_start"],"title":"InstantDbProvisionResponse","description":"Response body for POST /instant-db — Refs #8449.\n\nDerived from create_instant_db's REAL construction, not inferred: the base\ndict literal plus every `response[...] = ` assignment that follows it.\n\nTwo deliberate configuration choices, both load-bearing:\n\n* ``extra=\"allow\"`` — the handler assembles this payload across ~130 lines\n of branching code. With the default ``extra=\"ignore\"`` any key added to\n the handler later would be silently stripped from every live response\n with no test failure (the #8721 bug class).\n* The route sets ``response_model_exclude_unset=True`` — ``support`` and\n ``dealroom`` are only set on some requests (``support`` when a ServiceOS\n inbox token was provisioned, ``dealroom`` when ``body.dealroom`` was\n requested). Without exclude_unset they would serialize as explicit\n ``null`` on every response, changing the payload every existing caller\n already receives."},"InstantDbUnclaimedItem":{"properties":{"project_id":{"type":"string","title":"Project Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["project_id"],"title":"InstantDbUnclaimedItem","description":"One unclaimed, unexpired instant-db project. Deliberately omits the\nraw claim token -- that stays server-side; claim-by-project proves\nidentity via auth instead."},"InstantDbUnclaimedResponse":{"properties":{"projects":{"items":{"$ref":"#/components/schemas/InstantDbUnclaimedItem"},"type":"array","title":"Projects"}},"type":"object","required":["projects"],"title":"InstantDbUnclaimedResponse"},"IntakeItemOut":{"properties":{"id":{"type":"string","title":"Id"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Ref"},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"sender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"raw_excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Excerpt"},"classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Classification"},"extracted":{"anyOf":[{},{"type":"null"}],"title":"Extracted"},"github_issue_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Github Issue Urls"},"swarm_project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Swarm Project Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"spawn_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Spawn Status"},"spawn_phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Spawn Phase"}},"type":"object","required":["id"],"title":"IntakeItemOut","description":"See IntakeItem.to_dict / intake_service.to_dict_with_spawn."},"IntakeListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/IntakeItemOut"},"type":"array","title":"Items"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["items","count"],"title":"IntakeListResponse"},"IntegrationHint":{"properties":{"integration_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Integration Type"},"ok":{"type":"boolean","title":"Ok"},"hint":{"type":"string","title":"Hint"}},"type":"object","required":["integration_type","ok","hint"],"title":"IntegrationHint"},"IntegrationTypePath":{"type":"string","enum":["zero_invoice","zero_crm","zero_books","zero_pipeline","stripe","quickbooks","mercury"],"title":"IntegrationTypePath"},"IntegrationsSummaryResponse":{"properties":{"connected_count":{"type":"integer","title":"Connected Count"},"total_sources":{"type":"integer","title":"Total Sources"},"issue_count":{"type":"integer","title":"Issue Count"},"hints":{"items":{"$ref":"#/components/schemas/IntegrationHint"},"type":"array","title":"Hints"}},"type":"object","required":["connected_count","total_sources","issue_count","hints"],"title":"IntegrationsSummaryResponse"},"IntelligencePackagesResponse":{"properties":{"total_downloads":{"type":"integer","title":"Total Downloads"},"packages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Packages"},"days":{"type":"integer","title":"Days"},"generated_at":{"type":"string","title":"Generated At"},"source":{"type":"string","title":"Source"}},"type":"object","required":["total_downloads","packages","days","generated_at","source"],"title":"IntelligencePackagesResponse","description":"npm + PyPI download stats from the data lake. Refs #3354 #3361"},"IntelligenceSummaryResponse":{"properties":{"agent_runs_today":{"type":"integer","title":"Agent Runs Today"},"agent_runs_week":{"type":"integer","title":"Agent Runs Week"},"api_calls_today":{"type":"integer","title":"Api Calls Today"},"billing_revenue_week":{"type":"number","title":"Billing Revenue Week"},"top_packages_downloads":{"type":"integer","title":"Top Packages Downloads"},"generated_at":{"type":"string","title":"Generated At"},"source":{"type":"string","title":"Source"}},"type":"object","required":["agent_runs_today","agent_runs_week","api_calls_today","billing_revenue_week","top_packages_downloads","generated_at","source"],"title":"IntelligenceSummaryResponse","description":"Lightweight aggregate summary for the intelligence dashboard. Refs #3354 #3369"},"IntentActionRequest":{"properties":{"action":{"type":"string","title":"Action","description":"accept or reject"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Optional message to the business agent"}},"type":"object","required":["action"],"title":"IntentActionRequest","description":"Accept or reject a match."},"IntentActionResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'ok' on success"},"action":{"type":"string","title":"Action","description":"The action applied: accept or reject"},"agent_id":{"type":"string","title":"Agent Id","description":"The matched agent the action targeted"}},"type":"object","required":["status","action","agent_id"],"title":"IntentActionResponse","description":"Acknowledgement for accepting/rejecting a matched business agent.\n\n`agent_id` is echoed straight from the path parameter, so it is returned\nverbatim even when it matches no row in the intent's `matches` array —\npinned by test_unknown_agent_id_echoed_back_unchanged."},"IntentConstraint":{"properties":{"type":{"type":"string","title":"Type","description":"Constraint type: budget, location, timeline, certification, etc."},"operator":{"type":"string","title":"Operator","description":"Operator: max, min, equals, contains","default":"max"},"value":{"title":"Value","description":"Constraint value"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency","description":"Currency code for budget constraints"}},"type":"object","required":["type","value"],"title":"IntentConstraint","description":"A single constraint on an intent (budget, location, timeline, etc.)."},"IntentCreateRequest":{"properties":{"text":{"type":"string","maxLength":2000,"minLength":10,"title":"Text","description":"Natural language intent"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Override auto-detected category"},"max_matches":{"type":"integer","maximum":50,"minimum":1,"title":"Max Matches","description":"Maximum number of matches to return","default":10},"auto_negotiate":{"type":"boolean","title":"Auto Negotiate","description":"Let agents auto-negotiate on your behalf","default":false}},"type":"object","required":["text"],"title":"IntentCreateRequest","description":"Request body for POST /intents — submit a new intent."},"IntentListResponse":{"properties":{"intents":{"items":{"$ref":"#/components/schemas/IntentResponse"},"type":"array","title":"Intents"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["intents","total"],"title":"IntentListResponse","description":"Response for listing user's intents."},"IntentMatch":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"type":"string","title":"Agent Name"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"similarity_score":{"type":"number","maximum":1,"minimum":0,"title":"Similarity Score"},"readiness_score":{"type":"number","maximum":100,"minimum":0,"title":"Readiness Score","default":0},"status":{"type":"string","title":"Status","default":"proposed"}},"type":"object","required":["agent_id","agent_name","capabilities","similarity_score"],"title":"IntentMatch","description":"A single match between an intent and a business agent."},"IntentParsed":{"properties":{"category":{"type":"string","title":"Category","description":"Primary category: procurement, hiring, service, partnership, research"},"subcategory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategory","description":"Specific subcategory"},"constraints":{"items":{"$ref":"#/components/schemas/IntentConstraint"},"type":"array","title":"Constraints"},"preferences":{"items":{"type":"string"},"type":"array","title":"Preferences","description":"Soft preferences (not hard constraints)"},"urgency":{"type":"string","title":"Urgency","description":"immediate, this_week, this_month, exploring","default":"exploring"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords","description":"Extracted keywords for matching"}},"type":"object","required":["category"],"title":"IntentParsed","description":"LLM-parsed structured representation of a raw intent."},"IntentResponse":{"properties":{"intent_id":{"type":"string","title":"Intent Id"},"raw_text":{"type":"string","title":"Raw Text"},"parsed":{"$ref":"#/components/schemas/IntentParsed"},"status":{"type":"string","title":"Status"},"matches":{"items":{"$ref":"#/components/schemas/IntentMatch"},"type":"array","title":"Matches"},"match_count":{"type":"integer","title":"Match Count","default":0},"created_at":{"type":"string","title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["intent_id","raw_text","parsed","status","created_at"],"title":"IntentResponse","description":"Response for a single intent with matches."},"InteractionDetail":{"properties":{"interaction_id":{"type":"string","title":"Interaction Id"},"interaction_type":{"type":"string","title":"Interaction Type"},"user_input":{"type":"string","title":"User Input"},"agent_response":{"type":"string","title":"Agent Response"},"feedback":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Feedback"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["interaction_id","interaction_type","user_input","agent_response","created_at"],"title":"InteractionDetail","description":"Detailed interaction with feedback"},"InteractionRecordModel":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"User/agent prompt text"},"response":{"type":"string","title":"Response","description":"Assistant/agent response text"},"reward":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Reward","description":"Optional reward 0.0-1.0"},"is_positive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Positive"},"system_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Prompt"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["prompt","response"],"title":"InteractionRecordModel"},"InteractionResponse":{"properties":{"interaction_id":{"type":"string","title":"Interaction Id","description":"Unique interaction ID"},"session_id":{"type":"string","title":"Session Id","description":"Session identifier"},"logged_at":{"type":"string","format":"date-time","title":"Logged At","description":"Timestamp when logged"}},"type":"object","required":["interaction_id","session_id","logged_at"],"title":"InteractionResponse","description":"Response schema for logged interactions","example":{"interaction_id":"550e8400-e29b-41d4-a716-446655440000","logged_at":"2025-01-15T10:30:00Z","session_id":"sess_123abc"}},"IntrospectionRequest":{"properties":{"token":{"type":"string","title":"Token","description":"The token to introspect"}},"type":"object","required":["token"],"title":"IntrospectionRequest","description":"RFC 7662 token introspection request."},"IntrospectionResponse":{"properties":{"active":{"type":"boolean","title":"Active"},"sub":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sub"},"iss":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Iss"},"aud":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aud"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"delegation_chain":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Delegation Chain"},"delegation_depth":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Delegation Depth"},"exp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Exp"},"jti":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jti"}},"type":"object","required":["active"],"title":"IntrospectionResponse","description":"RFC 7662 token introspection response."},"InventoryFormat":{"type":"string","enum":["video","banner","native","audio"],"title":"InventoryFormat","description":"Format types for ad creatives"},"InventoryListResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total number of inventory items matching filters"},"limit":{"type":"integer","title":"Limit","description":"Results per page"},"offset":{"type":"integer","title":"Offset","description":"Number of results skipped"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results are available"},"items":{"items":{"$ref":"#/components/schemas/ContentInventory"},"type":"array","title":"Items","description":"List of inventory items for current page"}},"type":"object","required":["total","limit","offset","has_more","items"],"title":"InventoryListResponse","description":"Paginated response for inventory listing"},"InviteAgentRequest":{"properties":{"email":{"type":"string","maxLength":255,"title":"Email"},"name":{"type":"string","maxLength":255,"title":"Name"},"role":{"type":"string","pattern":"^(agent|admin)$","title":"Role","default":"agent"}},"type":"object","required":["email","name"],"title":"InviteAgentRequest","description":"Invite a team member as a support agent."},"InviteAgentResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"agent":{"$ref":"#/components/schemas/InviteAgentSummary"},"message":{"type":"string","title":"Message"}},"type":"object","required":["ok","agent","message"],"title":"InviteAgentResponse"},"InviteAgentSummary":{"properties":{"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role"}},"type":"object","required":["email","name","role"],"title":"InviteAgentSummary"},"InvoiceBackfillRequest":{"properties":{"user_id":{"type":"string","title":"User Id"},"target_month":{"type":"string","title":"Target Month"}},"type":"object","required":["user_id","target_month"],"title":"InvoiceBackfillRequest"},"InvoiceBackfillResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"target_month":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Month"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success"],"title":"InvoiceBackfillResponse","description":"Success shape has task_id/user_id/target_month; the except branch\nreturns only success+error. Optional + exclude_none preserves both\nshapes exactly."},"InvoiceCreate":{"properties":{"user_id":{"type":"string","title":"User Id","description":"Customer user ID"},"line_items":{"items":{"$ref":"#/components/schemas/LineItem"},"type":"array","minItems":1,"title":"Line Items","description":"Line items"},"due_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due Date","description":"Payment due date"},"period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period Start","description":"Billing period start"},"period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period End","description":"Billing period end"},"subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Id","description":"Related subscription ID"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Custom metadata"},"currency":{"type":"string","title":"Currency","description":"Currency code","default":"USD"}},"type":"object","required":["user_id","line_items"],"title":"InvoiceCreate","description":"Schema for creating a new invoice","example":{"currency":"USD","due_date":"2025-12-01T00:00:00Z","line_items":[{"amount":9900,"description":"Professional Plan - Monthly","quantity":1,"unit_price":9900}],"metadata":{"plan":"professional"},"user_id":"550e8400-e29b-41d4-a716-446655440000"}},"InvoiceDownloadData":{"properties":{"invoice_id":{"type":"string","title":"Invoice Id"},"invoice_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Number"},"pdf_url":{"type":"string","title":"Pdf Url"},"amount":{"type":"number","title":"Amount"},"currency":{"type":"string","title":"Currency"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","required":["invoice_id","pdf_url","amount","currency"],"title":"InvoiceDownloadData"},"InvoiceDownloadResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/InvoiceDownloadData"}},"type":"object","required":["success","data"],"title":"InvoiceDownloadResponse","description":"Response for GET /billing/invoices/{invoice_id}/download (returns a PDF URL as JSON, not the binary)."},"InvoiceEmailResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"already_sent":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Already Sent"},"previous_sends":{"anyOf":[{"items":{"$ref":"#/components/schemas/PreviousInvoiceSend"},"type":"array"},{"type":"null"}],"title":"Previous Sends"},"log_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Log Id"},"invoice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Id"},"invoice_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Number"},"email_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Type"},"recipient":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient"},"forced":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Forced"}},"additionalProperties":true,"type":"object","required":["success"],"title":"InvoiceEmailResponse","description":"Response for POST /billing/invoices/{invoice_id}/email and\nPOST /billing/invoices/{invoice_id}/resend-email.\n\nThe handler has three distinct success-path shapes (already-sent with no\nforce_send, already-sent per the email service, and a fresh send) so most\nfields are optional and only present on the branch that produced them."},"InvoiceListData":{"properties":{"items":{"items":{"$ref":"#/components/schemas/InvoiceListItem"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","total","page","page_size","has_more"],"title":"InvoiceListData"},"InvoiceListItem":{"properties":{"id":{"type":"string","title":"Id"},"number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Number"},"amount":{"type":"number","title":"Amount"},"amount_paid":{"type":"number","title":"Amount Paid"},"currency":{"type":"string","title":"Currency"},"status":{"type":"string","title":"Status"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End"},"due_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due Date"},"paid_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paid At"},"invoice_pdf":{"type":"string","title":"Invoice Pdf"},"line_items":{"items":{},"type":"array","title":"Line Items"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"email_sent_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Sent At"},"customer_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Email"}},"additionalProperties":true,"type":"object","required":["id","amount","amount_paid","currency","status","invoice_pdf","line_items","metadata"],"title":"InvoiceListItem","description":"A single invoice as returned by GET /billing/invoices."},"InvoicePdfResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the PDF is ready"},"invoice_id":{"type":"string","title":"Invoice Id","description":"Invoice ID"},"pdf_url":{"type":"string","title":"Pdf Url","description":"URL of the (existing or freshly generated) invoice PDF"},"message":{"type":"string","title":"Message","description":"Human-readable status message"}},"type":"object","required":["success","invoice_id","pdf_url","message"],"title":"InvoicePdfResponse","description":"Schema for the invoice PDF URL response","example":{"invoice_id":"550e8400-e29b-41d4-a716-446655440000","message":"PDF ready for download","pdf_url":"https://storage.example.com/invoices/inv_123.pdf","success":true}},"InvoiceStatus":{"type":"string","enum":["draft","sent","paid","overdue","cancelled","void"],"title":"InvoiceStatus","description":"Invoice status enum"},"InvoiceUpdate":{"properties":{"line_items":{"anyOf":[{"items":{"$ref":"#/components/schemas/LineItem"},"type":"array"},{"type":"null"}],"title":"Line Items","description":"Updated line items"},"due_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due Date","description":"Updated due date"},"period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period Start","description":"Updated period start"},"period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period End","description":"Updated period end"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Updated metadata"}},"type":"object","title":"InvoiceUpdate","description":"Schema for updating a draft invoice","example":{"due_date":"2025-12-15T00:00:00Z","line_items":[{"amount":12900,"description":"Professional Plan - Monthly (Updated)","quantity":1,"unit_price":12900}]}},"InvoicesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success"],"title":"InvoicesResponse","description":"`data` is typed as Dict[str, Any] rather than a strict nested model:\nindividual invoice rows have real, genuinely-nullable DB fields\n(number, period_start/end, due_date, paid_at, created_at) whose\n`None` value must keep serializing as explicit `null` — nesting\nstrict BaseModels under response_model_exclude_none=True would\nincorrectly strip those real null values from each invoice in the\nlist, which is a different (and here undesired) behavior from the\ngenuinely-conditional outer `data`/`error` presence this\nexclude_none is meant to preserve."},"JSONRPCError":{"properties":{"jsonrpc":{"type":"string","title":"Jsonrpc","default":"2.0"},"id":{"type":"string","title":"Id"},"error":{"additionalProperties":true,"type":"object","title":"Error"}},"type":"object","required":["id","error"],"title":"JSONRPCError"},"JSONRPCParams":{"properties":{"task":{"type":"string","maxLength":10000,"minLength":1,"title":"Task","description":"Task message to send to the agent"},"context_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context Id","description":"Optional conversation context ID"}},"type":"object","required":["task"],"title":"JSONRPCParams"},"JSONRPCRequest":{"properties":{"jsonrpc":{"type":"string","title":"Jsonrpc","description":"JSONRPC version","default":"2.0"},"method":{"type":"string","title":"Method","description":"JSONRPC method name"},"id":{"type":"string","title":"Id","description":"Request ID"},"params":{"$ref":"#/components/schemas/JSONRPCParams"}},"type":"object","required":["method","id","params"],"title":"JSONRPCRequest"},"JSONRPCResponse":{"properties":{"jsonrpc":{"type":"string","title":"Jsonrpc","default":"2.0"},"id":{"type":"string","title":"Id"},"result":{"anyOf":[{"$ref":"#/components/schemas/JSONRPCResult"},{"type":"null"}]},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"}},"type":"object","required":["id"],"title":"JSONRPCResponse"},"JSONRPCResult":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"},"output":{"type":"string","title":"Output"}},"type":"object","required":["task_id","status","output"],"title":"JSONRPCResult"},"JsonRpcError":{"properties":{"code":{"type":"integer","title":"Code","description":"Error code"},"message":{"type":"string","title":"Message","description":"Error message"},"data":{"anyOf":[{},{"type":"null"}],"title":"Data","description":"Additional error data"}},"type":"object","required":["code","message"],"title":"JsonRpcError","description":"JSON-RPC 2.0 error object."},"JsonRpcResponse":{"properties":{"jsonrpc":{"type":"string","title":"Jsonrpc","default":"2.0"},"result":{"anyOf":[{},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"$ref":"#/components/schemas/JsonRpcError"},{"type":"null"}]},"id":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"title":"Id"}},"type":"object","title":"JsonRpcResponse","description":"JSON-RPC 2.0 response object.\n\nPer spec section 5, a response MUST contain either `result` or `error`,\nnever both. `None` fields are excluded from serialization so that\nsuccess responses never include `\"error\": null` and vice versa.\nRefs #2535"},"JudgePreferenceRequest":{"properties":{"judge_id":{"type":"string","format":"uuid","title":"Judge Id","description":"Judge user ID"},"hackathon_id":{"type":"string","format":"uuid","title":"Hackathon Id","description":"Hackathon ID"},"preference_type":{"type":"string","minLength":1,"title":"Preference Type","description":"Type of preference (scoring_pattern, category_weights, etc.)"},"preference_data":{"additionalProperties":true,"type":"object","title":"Preference Data","description":"Preference data (scores, weights, patterns)"}},"type":"object","required":["judge_id","hackathon_id","preference_type","preference_data"],"title":"JudgePreferenceRequest","description":"Request schema for storing judge preferences"},"JudgeScoringHistoryResponse":{"properties":{"judge_id":{"type":"string","format":"uuid","title":"Judge Id","description":"Judge ID"},"scoring_patterns":{"items":{"$ref":"#/components/schemas/JudgeScoringPattern"},"type":"array","title":"Scoring Patterns","description":"Historical scoring patterns"},"total_hackathons":{"type":"integer","title":"Total Hackathons","description":"Total hackathons judged"},"consistency_score":{"type":"number","title":"Consistency Score","description":"Scoring consistency metric (0-1)"}},"type":"object","required":["judge_id","scoring_patterns","total_hackathons","consistency_score"],"title":"JudgeScoringHistoryResponse","description":"Response schema for judge scoring history"},"JudgeScoringPattern":{"properties":{"average_score":{"type":"number","title":"Average Score","description":"Average score given"},"score_variance":{"type":"number","title":"Score Variance","description":"Variance in scoring"},"category_preferences":{"additionalProperties":{"type":"number"},"type":"object","title":"Category Preferences","description":"Category weight preferences"},"common_feedback_themes":{"items":{"type":"string"},"type":"array","title":"Common Feedback Themes","description":"Common feedback patterns"},"total_projects_scored":{"type":"integer","title":"Total Projects Scored","description":"Total projects scored"}},"type":"object","required":["average_score","score_variance","category_preferences","common_feedback_themes","total_projects_scored"],"title":"JudgeScoringPattern","description":"Judge scoring pattern data"},"JumpRequest":{"properties":{"question_id":{"type":"string","title":"Question Id"}},"type":"object","required":["question_id"],"title":"JumpRequest"},"JumpResponse":{"properties":{"idx":{"type":"integer","title":"Idx"},"answers":{"additionalProperties":true,"type":"object","title":"Answers"}},"type":"object","required":["idx","answers"],"title":"JumpResponse"},"KongMetricsData":{"properties":{"request_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Request Count","description":"Total gateway requests"},"response_time_avg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time Avg","description":"Mean response time (ms)"},"response_time_p95":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time P95","description":"95th percentile response time (ms)"},"response_time_p99":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time P99","description":"99th percentile response time (ms)"},"error_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Error Rate","description":"Fraction of requests that errored"},"error_4xx_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Error 4Xx Count","description":"4xx response count"},"error_5xx_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Error 5Xx Count","description":"5xx response count"},"rate_limit_hits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rate Limit Hits","description":"Requests rejected by rate limiting"},"bandwidth_in":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bandwidth In","description":"Inbound bytes"},"bandwidth_out":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bandwidth Out","description":"Outbound bytes"},"active_connections":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Connections","description":"Currently open connections"},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp","description":"Collection timestamp"}},"additionalProperties":true,"type":"object","title":"KongMetricsData","description":"Mirror of mcp_proxy_metrics_service.KongMetrics (API-gateway metrics)."},"KongMetricsEnvelope":{"properties":{"kong_metrics":{"$ref":"#/components/schemas/KongMetricsData","description":"API-gateway metrics"},"collection_time":{"type":"string","title":"Collection Time","description":"ISO timestamp of collection"}},"additionalProperties":true,"type":"object","required":["kong_metrics","collection_time"],"title":"KongMetricsEnvelope","description":"`data` block of the gateway/kong metrics routes."},"KongMetricsResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always true on a 200"},"data":{"$ref":"#/components/schemas/KongMetricsEnvelope","description":"Gateway metrics payload"}},"additionalProperties":true,"type":"object","required":["success","data"],"title":"KongMetricsResponse","description":"GET /api/v1/mcp/proxy/metrics/gateway (and the deprecated /metrics/kong alias)"},"KpiMetric":{"properties":{"metric_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Name"},"metric_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Metric Value"},"metric_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Unit"},"period_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Id"},"delta_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Percent"},"delta_absolute":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Absolute"},"comparison_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comparison Type"}},"type":"object","title":"KpiMetric"},"KpiMetricItem":{"properties":{"metric_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Name"},"metric_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Metric Value"},"metric_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Unit"},"period_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Id"},"delta_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Percent"},"delta_absolute":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Absolute"},"comparison_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comparison Type"}},"type":"object","title":"KpiMetricItem"},"KpiSummary":{"properties":{"metrics":{"items":{"$ref":"#/components/schemas/KpiMetricItem"},"type":"array","title":"Metrics"},"period_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"}},"type":"object","required":["metrics"],"title":"KpiSummary"},"KpiSummaryResponse":{"properties":{"metrics":{"items":{"$ref":"#/components/schemas/KpiMetric"},"type":"array","title":"Metrics"},"period_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Id"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["metrics","organization_id"],"title":"KpiSummaryResponse"},"LLMTokenUsage":{"properties":{"input":{"type":"integer","title":"Input","default":0},"output":{"type":"integer","title":"Output","default":0}},"type":"object","title":"LLMTokenUsage","description":"Token usage counts for LLM invocations."},"LakeAnalytics":{"properties":{"agent_runs_30d":{"type":"integer","title":"Agent Runs 30D"},"agent_success_rate_pct":{"type":"number","title":"Agent Success Rate Pct"},"api_requests_30d":{"type":"integer","title":"Api Requests 30D"},"total_credits_30d":{"type":"number","title":"Total Credits 30D"},"loop_quality":{"$ref":"#/components/schemas/LoopQualityTrend"},"packages":{"$ref":"#/components/schemas/PackageStats"},"business":{"anyOf":[{"$ref":"#/components/schemas/BusinessSignals"},{"type":"null"}]},"rlhf_quality_score_7d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rlhf Quality Score 7D"},"regional_economy":{"anyOf":[{"$ref":"#/components/schemas/RegionalEconomicSignals"},{"type":"null"}]},"source":{"type":"string","title":"Source","default":"lake"}},"type":"object","required":["agent_runs_30d","agent_success_rate_pct","api_requests_30d","total_credits_30d","loop_quality","packages"],"title":"LakeAnalytics","description":"Historical analytics from the MinIO data lake. Refs #3356"},"LakeAnalyticsResponse":{"properties":{"agent_runs_total":{"type":"integer","title":"Agent Runs Total"},"agent_success_rate_pct":{"type":"number","title":"Agent Success Rate Pct"},"agent_trend":{"items":{"$ref":"#/components/schemas/AgentRunTrend"},"type":"array","title":"Agent Trend"},"improving":{"type":"boolean","title":"Improving"},"loop_quality_trend":{"items":{"$ref":"#/components/schemas/LoopQualityPoint"},"type":"array","title":"Loop Quality Trend","default":[]},"loop_quality_overall":{"type":"number","title":"Loop Quality Overall","default":0},"loop_quality_improving":{"type":"boolean","title":"Loop Quality Improving","default":false},"api_requests_total":{"type":"integer","title":"Api Requests Total"},"api_cost_credits_total":{"type":"number","title":"Api Cost Credits Total"},"api_error_rate_pct":{"type":"number","title":"Api Error Rate Pct"},"api_avg_latency_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Api Avg Latency Ms"},"api_latency_p50_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Api Latency P50 Ms"},"api_latency_samples":{"type":"integer","title":"Api Latency Samples","default":0},"top_models":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__lake_analytics__ModelUsage"},"type":"array","title":"Top Models"},"api_daily_volume":{"items":{"$ref":"#/components/schemas/DayVolume"},"type":"array","title":"Api Daily Volume"},"package_downloads_total":{"type":"integer","title":"Package Downloads Total"},"top_packages":{"items":{"$ref":"#/components/schemas/PackageEntry"},"type":"array","title":"Top Packages"},"days":{"type":"integer","title":"Days"},"generated_at":{"type":"string","title":"Generated At"},"source":{"type":"string","title":"Source"}},"type":"object","required":["agent_runs_total","agent_success_rate_pct","agent_trend","improving","api_requests_total","api_cost_credits_total","api_error_rate_pct","api_avg_latency_ms","top_models","api_daily_volume","package_downloads_total","top_packages","days","generated_at","source"],"title":"LakeAnalyticsResponse"},"LakehouseAnalyticsResponse":{"properties":{"period_days":{"type":"integer","title":"Period Days"},"total_requests":{"type":"integer","title":"Total Requests"},"period_requests":{"type":"integer","title":"Period Requests"},"avg_latency_ms":{"type":"number","title":"Avg Latency Ms"},"table_count":{"type":"integer","title":"Table Count"},"total_size_gb":{"type":"number","title":"Total Size Gb"},"source":{"type":"string","title":"Source"}},"type":"object","required":["period_days","total_requests","period_requests","avg_latency_ms","table_count","total_size_gb","source"],"title":"LakehouseAnalyticsResponse"},"LakehouseConnectorSummary":{"properties":{"online":{"type":"integer","title":"Online"},"degraded":{"type":"integer","title":"Degraded"},"offline":{"type":"integer","title":"Offline"},"total":{"type":"integer","title":"Total"},"health_pct":{"type":"number","title":"Health Pct"}},"type":"object","required":["online","degraded","offline","total","health_pct"],"title":"LakehouseConnectorSummary"},"LakehouseConnectorsResponse":{"properties":{"connectors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Connectors"},"summary":{"$ref":"#/components/schemas/LakehouseConnectorSummary"}},"type":"object","required":["connectors","summary"],"title":"LakehouseConnectorsResponse"},"LakehouseConsumerGroup":{"properties":{"group_id":{"type":"string","title":"Group Id"},"topic":{"type":"string","title":"Topic"},"members":{"type":"integer","title":"Members"},"lag":{"type":"integer","title":"Lag"},"state":{"type":"string","title":"State"}},"type":"object","required":["group_id","topic","members","lag","state"],"title":"LakehouseConsumerGroup"},"LakehouseDeleteResponse":{"properties":{"objects_deleted":{"type":"integer","title":"Objects Deleted"},"sensor_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sensor Type"},"project_id":{"type":"string","title":"Project Id"}},"type":"object","required":["objects_deleted","project_id"],"title":"LakehouseDeleteResponse"},"LakehouseIngestRequest":{"properties":{"sensor_type":{"type":"string","title":"Sensor Type","description":"Logical table / sensor type to write into (e.g. 'ais')"},"records":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":5000,"minItems":1,"title":"Records","description":"Rows to write (1..INGEST_MAX_RECORDS)"}},"type":"object","required":["sensor_type","records"],"title":"LakehouseIngestRequest"},"LakehouseIngestResponse":{"properties":{"records_written":{"type":"integer","title":"Records Written"},"sensor_type":{"type":"string","title":"Sensor Type"},"project_id":{"type":"string","title":"Project Id"}},"type":"object","required":["records_written","sensor_type","project_id"],"title":"LakehouseIngestResponse"},"LakehousePipeline":{"properties":{"dag_id":{"type":"string","title":"Dag Id"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"schedule":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule"},"is_paused":{"type":"boolean","title":"Is Paused"},"is_active":{"type":"boolean","title":"Is Active"},"owners":{"items":{"type":"string"},"type":"array","title":"Owners"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"next_dagrun":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Dagrun"},"last_parsed_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Parsed Time"}},"type":"object","required":["dag_id","is_paused","is_active","owners","tags"],"title":"LakehousePipeline"},"LakehousePipelinesResponse":{"properties":{"pipelines":{"items":{"$ref":"#/components/schemas/LakehousePipeline"},"type":"array","title":"Pipelines"},"total":{"type":"integer","title":"Total"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["pipelines","total"],"title":"LakehousePipelinesResponse","description":"`error` is only present when the Airflow proxy call failed or\nreturned a non-200 status; a healthy response omits it entirely."},"LakehouseQueryRequest":{"properties":{"sql":{"type":"string","title":"Sql","description":"SQL query (SELECT only)"},"max_rows":{"type":"integer","maximum":10000,"title":"Max Rows","description":"Maximum rows to return","default":1000}},"type":"object","required":["sql"],"title":"LakehouseQueryRequest"},"LakehouseQueryResponse":{"properties":{"columns":{"items":{"type":"string"},"type":"array","title":"Columns"},"rows":{"items":{"items":{},"type":"array"},"type":"array","title":"Rows"},"row_count":{"type":"integer","title":"Row Count"},"execution_time_ms":{"type":"number","title":"Execution Time Ms"},"truncated":{"type":"boolean","title":"Truncated","default":false}},"type":"object","required":["columns","rows","row_count","execution_time_ms"],"title":"LakehouseQueryResponse"},"LakehouseStatsResponse":{"properties":{"total_files":{"type":"integer","title":"Total Files"},"total_bytes":{"type":"integer","title":"Total Bytes"},"sensor_types":{"type":"integer","title":"Sensor Types"},"tables":{"items":{"$ref":"#/components/schemas/LakehouseTableInfo"},"type":"array","title":"Tables"}},"type":"object","required":["total_files","total_bytes","sensor_types","tables"],"title":"LakehouseStatsResponse"},"LakehouseStreamsResponse":{"properties":{"topics":{"items":{"$ref":"#/components/schemas/LakehouseTopic"},"type":"array","title":"Topics"},"consumer_groups":{"items":{"$ref":"#/components/schemas/LakehouseConsumerGroup"},"type":"array","title":"Consumer Groups"},"status":{"type":"string","title":"Status"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["topics","consumer_groups","status"],"title":"LakehouseStreamsResponse","description":"`error` is only present when RedPanda was unreachable (status\n\"unreachable\"); the connected-status response omits it entirely."},"LakehouseTable":{"properties":{"name":{"type":"string","title":"Name"},"format":{"type":"string","title":"Format"},"rows":{"type":"integer","title":"Rows"},"partitions":{"type":"integer","title":"Partitions"},"size_mb":{"type":"number","title":"Size Mb"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Updated"}},"type":"object","required":["name","format","rows","partitions","size_mb"],"title":"LakehouseTable"},"LakehouseTableInfo":{"properties":{"name":{"type":"string","title":"Name"},"format":{"type":"string","title":"Format","default":"parquet"},"file_count":{"type":"integer","title":"File Count","default":0},"total_bytes":{"type":"integer","title":"Total Bytes","default":0},"last_modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified"}},"type":"object","required":["name"],"title":"LakehouseTableInfo"},"LakehouseTableStats":{"properties":{"total_tables":{"type":"integer","title":"Total Tables"},"total_rows":{"type":"integer","title":"Total Rows"},"total_size_mb":{"type":"number","title":"Total Size Mb"}},"type":"object","required":["total_tables","total_rows","total_size_mb"],"title":"LakehouseTableStats"},"LakehouseTablesResponse":{"properties":{"tables":{"items":{"$ref":"#/components/schemas/LakehouseTable"},"type":"array","title":"Tables"},"stats":{"$ref":"#/components/schemas/LakehouseTableStats"}},"type":"object","required":["tables","stats"],"title":"LakehouseTablesResponse"},"LakehouseTopic":{"properties":{"topic":{"type":"string","title":"Topic"},"partitions":{"type":"integer","title":"Partitions"},"messages":{"type":"integer","title":"Messages"},"retention_hours":{"type":"integer","title":"Retention Hours"},"throughput_msg_sec":{"type":"integer","title":"Throughput Msg Sec"}},"type":"object","required":["topic","partitions","messages","retention_hours","throughput_msg_sec"],"title":"LakehouseTopic"},"LangChainComponent":{"type":"string","enum":["llm","chain","agent","tool","memory","prompt_template","output_parser","retriever","vectorstore","embeddings"],"title":"LangChainComponent","description":"LangChain component types"},"LangChainComponentsResponse":{"properties":{"components":{"additionalProperties":{"$ref":"#/components/schemas/ComponentInfo"},"type":"object","title":"Components"},"total_components":{"type":"integer","title":"Total Components"}},"type":"object","required":["components","total_components"],"title":"LangChainComponentsResponse","description":"Response for GET /langflow-templates/components."},"LangflowDashboardResponse":{"properties":{"templates":{"items":{"$ref":"#/components/schemas/TemplateListEntry"},"type":"array","title":"Templates"},"statistics":{"$ref":"#/components/schemas/DashboardStatistics"},"available_types":{"items":{"type":"string"},"type":"array","title":"Available Types"},"available_components":{"items":{"type":"string"},"type":"array","title":"Available Components"},"complexity_levels":{"items":{"type":"string"},"type":"array","title":"Complexity Levels"},"base_templates":{"additionalProperties":{"$ref":"#/components/schemas/BaseTemplateInfo"},"type":"object","title":"Base Templates"}},"type":"object","required":["templates","statistics","available_types","available_components","complexity_levels","base_templates"],"title":"LangflowDashboardResponse","description":"Response for GET /langflow-templates/dashboard."},"LangflowExportRequest":{"properties":{"template_id":{"type":"string","title":"Template Id"},"export_format":{"type":"string","pattern":"^(json|yaml|python)$","title":"Export Format","default":"json"},"include_dependencies":{"type":"boolean","title":"Include Dependencies","default":true},"include_documentation":{"type":"boolean","title":"Include Documentation","default":true}},"type":"object","required":["template_id"],"title":"LangflowExportRequest","description":"Request model for exporting Langflow templates"},"LangflowTemplateRequest":{"properties":{"template_name":{"type":"string","maxLength":100,"minLength":1,"title":"Template Name"},"template_type":{"$ref":"#/components/schemas/TemplateType"},"complexity":{"$ref":"#/components/schemas/FlowComplexity","default":"simple"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"components":{"items":{"$ref":"#/components/schemas/LangChainComponent"},"type":"array","title":"Components"},"requirements":{"additionalProperties":true,"type":"object","title":"Requirements"},"include_examples":{"type":"boolean","title":"Include Examples","default":true},"include_tests":{"type":"boolean","title":"Include Tests","default":true}},"type":"object","required":["template_name","template_type"],"title":"LangflowTemplateRequest","description":"Request model for Langflow template generation"},"LeadScoreFactors":{"properties":{"is_tech":{"type":"boolean","title":"Is Tech"},"has_phone":{"type":"boolean","title":"Has Phone"},"city":{"type":"string","title":"City"}},"type":"object","required":["is_tech","has_phone","city"],"title":"LeadScoreFactors"},"LeadScoreResponse":{"properties":{"score":{"type":"number","title":"Score"},"grade":{"type":"string","title":"Grade"},"factors":{"$ref":"#/components/schemas/LeadScoreFactors"}},"type":"object","required":["score","grade","factors"],"title":"LeadScoreResponse"},"LeaderboardEntry":{"properties":{"agent_registration_id":{"type":"string","title":"Agent Registration Id"},"agent_id":{"type":"string","title":"Agent Id"},"score":{"type":"integer","title":"Score"},"tier":{"type":"string","title":"Tier"},"reliability":{"type":"number","title":"Reliability"},"responsiveness":{"type":"number","title":"Responsiveness"},"compliance":{"type":"number","title":"Compliance"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["agent_registration_id","agent_id","score","tier","reliability","responsiveness","compliance"],"title":"LeaderboardEntry"},"LearnedSkillRequest":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name","default":""},"description":{"type":"string","maxLength":500,"title":"Description","default":""},"content":{"type":"string","minLength":1,"title":"Content"},"confidence":{"type":"number","maximum":1,"minimum":0,"title":"Confidence"},"source_session":{"type":"string","maxLength":255,"title":"Source Session"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"}},"type":"object","required":["content","confidence","source_session"],"title":"LearnedSkillRequest","description":"Request body for storing a session-learned skill."},"LearnedSkillResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"skill_id":{"type":"string","title":"Skill Id"},"confidence":{"type":"number","title":"Confidence"},"source_session":{"type":"string","title":"Source Session"}},"type":"object","required":["skill_id","confidence","source_session"],"title":"LearnedSkillResponse","description":"Response after storing a learned skill."},"LearningInsightEntry":{"properties":{"interaction_type":{"type":"string","title":"Interaction Type"},"interaction_count":{"type":"integer","title":"Interaction Count"},"success_rate":{"type":"number","title":"Success Rate"},"average_rating":{"type":"number","title":"Average Rating"},"unique_agents":{"type":"integer","title":"Unique Agents"}},"type":"object","required":["interaction_type","interaction_count","success_rate","average_rating","unique_agents"],"title":"LearningInsightEntry"},"LearningSignalsSummary":{"properties":{"reinforce_count":{"type":"integer","title":"Reinforce Count"},"discourage_count":{"type":"integer","title":"Discourage Count"},"average_weight":{"type":"number","title":"Average Weight"}},"type":"object","required":["reinforce_count","discourage_count","average_weight"],"title":"LearningSignalsSummary"},"LearningTaskRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"task_type":{"type":"string","title":"Task Type"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters","default":{}}},"type":"object","required":["agent_id","task_type"],"title":"LearningTaskRequest"},"LegacyProfileUpdateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},"type":"object","required":["success","message"],"title":"LegacyProfileUpdateResponse","description":"Response for the deprecated PUT /profile/ endpoint\n(app.api.v1.endpoints.profile.update_user_profile). Refs #2191."},"LicenseDetailResponse":{"properties":{"license_id":{"type":"string","title":"License Id"},"org_id":{"type":"string","title":"Org Id"},"status":{"type":"string","title":"Status"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"allowed_replicas":{"type":"integer","title":"Allowed Replicas"},"support_tier":{"type":"string","title":"Support Tier"},"issued_at":{"type":"string","title":"Issued At"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"last_validated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Validated At"},"total_events":{"type":"integer","title":"Total Events"}},"type":"object","required":["license_id","org_id","status","expires_at","allowed_replicas","support_tier","issued_at","notes","last_validated_at","total_events"],"title":"LicenseDetailResponse"},"LicenseIssueRequest":{"properties":{"org_id":{"type":"string","format":"uuid","title":"Org Id"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"allowed_replicas":{"type":"integer","maximum":1000,"minimum":1,"title":"Allowed Replicas","default":1},"support_tier":{"type":"string","pattern":"^(standard|enterprise|platinum)$","title":"Support Tier","default":"standard"},"notes":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Notes"}},"type":"object","required":["org_id"],"title":"LicenseIssueRequest"},"LicenseIssueResponse":{"properties":{"license_key":{"type":"string","title":"License Key"},"license_id":{"type":"string","title":"License Id"},"org_id":{"type":"string","title":"Org Id"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"allowed_replicas":{"type":"integer","title":"Allowed Replicas"},"support_tier":{"type":"string","title":"Support Tier"}},"type":"object","required":["license_key","license_id","org_id","expires_at","allowed_replicas","support_tier"],"title":"LicenseIssueResponse"},"LicenseValidateRequest":{"properties":{"license_key":{"type":"string","maxLength":64,"minLength":4,"title":"License Key"},"deployment_id":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Deployment Id"},"hostname":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Hostname"},"version":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Version"}},"type":"object","required":["license_key"],"title":"LicenseValidateRequest"},"LicenseValidateResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"allowed_replicas":{"type":"integer","title":"Allowed Replicas","default":0},"support_tier":{"type":"string","title":"Support Tier","default":"standard"},"message":{"type":"string","title":"Message","default":""}},"type":"object","required":["valid"],"title":"LicenseValidateResponse"},"LineItem":{"properties":{"description":{"type":"string","minLength":1,"title":"Description","description":"Item description"},"quantity":{"type":"integer","exclusiveMinimum":0,"title":"Quantity","description":"Quantity"},"unit_price":{"type":"integer","exclusiveMinimum":0,"title":"Unit Price","description":"Unit price in cents"},"amount":{"type":"integer","exclusiveMinimum":0,"title":"Amount","description":"Total amount in cents (quantity * unit_price)"}},"type":"object","required":["description","quantity","unit_price","amount"],"title":"LineItem","description":"Line item in an invoice","example":{"amount":9900,"description":"Professional Plan - Monthly Subscription","quantity":1,"unit_price":9900}},"LinkedInCommentResponse":{"properties":{"commented":{"type":"boolean","title":"Commented"},"platform":{"type":"string","title":"Platform"},"post_url":{"type":"string","title":"Post Url"},"steps_taken":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Steps Taken"},"summary":{"type":"string","title":"Summary"}},"type":"object","required":["commented","platform","post_url","summary"],"title":"LinkedInCommentResponse"},"LinkedInCookieRequest":{"properties":{"li_at":{"type":"string","minLength":20,"title":"Li At","description":"The LinkedIn 'li_at' session cookie value (from your browser)."}},"type":"object","required":["li_at"],"title":"LinkedInCookieRequest"},"LinkedInCookieStoredResponse":{"properties":{"stored":{"type":"boolean","title":"Stored"},"platform":{"type":"string","title":"Platform"},"note":{"type":"string","title":"Note"}},"type":"object","required":["stored","platform","note"],"title":"LinkedInCookieStoredResponse"},"LinkedInPostRequest":{"properties":{"text":{"type":"string","minLength":1,"title":"Text"},"visibility":{"type":"string","title":"Visibility","default":"PUBLIC"},"link_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Url"}},"type":"object","required":["text"],"title":"LinkedInPostRequest"},"ListActiveAgentsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"active_agents":{"items":{"$ref":"#/components/schemas/ActiveAgentItem"},"type":"array","title":"Active Agents"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["project_id","active_agents","count"],"title":"ListActiveAgentsResponse"},"ListAgentSwarmProjectsPublicResponse":{"properties":{"projects":{"items":{"$ref":"#/components/schemas/PublicAgentSwarmProjectListItem"},"type":"array","title":"Projects"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"skip":{"type":"integer","title":"Skip"}},"type":"object","required":["projects","total","limit","skip"],"title":"ListAgentSwarmProjectsPublicResponse"},"ListAgentSwarmProjectsResponse":{"properties":{"projects":{"items":{"$ref":"#/components/schemas/AgentSwarmProjectListItem"},"type":"array","title":"Projects"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"skip":{"type":"integer","title":"Skip"}},"type":"object","required":["projects","total","limit","skip"],"title":"ListAgentSwarmProjectsResponse"},"ListAgentTasksResponse":{"properties":{"tasks":{"items":{"$ref":"#/components/schemas/AgentTaskSummary"},"type":"array","title":"Tasks"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["tasks","total","limit","offset","has_more"],"title":"ListAgentTasksResponse"},"ListAgentTracesResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"traces":{"items":{"$ref":"#/components/schemas/AgentTraceGroup"},"type":"array","title":"Traces"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["project_id","traces","count"],"title":"ListAgentTracesResponse"},"ListApprovalsResponse":{"properties":{"approvals":{"items":{"$ref":"#/components/schemas/ApprovalRecord"},"type":"array","title":"Approvals"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["approvals","count"],"title":"ListApprovalsResponse"},"ListBackupsResponse":{"properties":{"backups":{"items":{"$ref":"#/components/schemas/BackupListEntry"},"type":"array","title":"Backups"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["backups","total","limit","offset"],"title":"ListBackupsResponse"},"ListBundlesResponse":{"properties":{"bundles":{"items":{"$ref":"#/components/schemas/BundleInfo"},"type":"array","title":"Bundles"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["bundles","total","limit","offset"],"title":"ListBundlesResponse"},"ListByPrefixRequest":{"properties":{"prefix":{"type":"string","title":"Prefix","description":"Key prefix to match (e.g. 'cody:agent:', 'cody:skill:usage:')"},"limit":{"type":"integer","maximum":200,"minimum":1,"title":"Limit","description":"Max results","default":50},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"Optional session scope"}},"type":"object","required":["prefix"],"title":"ListByPrefixRequest"},"ListByPrefixResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/ListByPrefixResultItem"},"type":"array","title":"Results"},"count":{"type":"integer","title":"Count"},"prefix":{"type":"string","title":"Prefix"},"match_type":{"type":"string","title":"Match Type"},"note":{"type":"string","title":"Note"}},"type":"object","required":["results","count","prefix","match_type","note"],"title":"ListByPrefixResponse"},"ListByPrefixResultItem":{"properties":{"id":{"type":"string","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"memory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Type"},"importance":{"type":"number","title":"Importance"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","title","content","tags","metadata","namespace","memory_type","importance","created_at"],"title":"ListByPrefixResultItem"},"ListConversationsResponse":{"properties":{"conversations":{"items":{"$ref":"#/components/schemas/ConversationSummary"},"type":"array","title":"Conversations"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["conversations","count"],"title":"ListConversationsResponse"},"ListDeploymentWebhooksResponse":{"properties":{"webhooks":{"items":{"$ref":"#/components/schemas/DeploymentWebhookResponse"},"type":"array","title":"Webhooks"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["webhooks","count"],"title":"ListDeploymentWebhooksResponse"},"ListDocumentationFilters":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"doc_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type"},"target_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Role"},"is_public":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Public"}},"type":"object","title":"ListDocumentationFilters"},"ListDocumentationResponse":{"properties":{"documentation":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Documentation"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"filters":{"$ref":"#/components/schemas/ListDocumentationFilters"}},"type":"object","required":["documentation","total","limit","offset","filters"],"title":"ListDocumentationResponse","description":"Response for GET /help-documentation/content."},"ListEnterpriseAccountsResponse":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/EnterpriseAccountEntry"},"type":"array","title":"Accounts"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["accounts","total"],"title":"ListEnterpriseAccountsResponse"},"ListEntitiesResponse":{"properties":{"entities":{"items":{"$ref":"#/components/schemas/app__schemas__context_graph__EntityItem"},"type":"array","title":"Entities"},"total":{"type":"integer","title":"Total"}},"additionalProperties":true,"type":"object","required":["total"],"title":"ListEntitiesResponse","description":"Response for GET /memory/v2/graph/entities."},"ListEvaluationSchedulesResponse":{"properties":{"schedules":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Schedules"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["schedules","count"],"title":"ListEvaluationSchedulesResponse"},"ListFilesResponse":{"properties":{"files":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Files"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["files","total","page","page_size","has_more"],"title":"ListFilesResponse"},"ListInboxesResponse":{"properties":{"inboxes":{"items":{"$ref":"#/components/schemas/InboxSummary"},"type":"array","title":"Inboxes"}},"type":"object","required":["inboxes"],"title":"ListInboxesResponse"},"ListMemoriesItem":{"properties":{"id":{"type":"string","title":"Id"},"memory_id":{"type":"string","title":"Memory Id"},"content":{"title":"Content"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"memory_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Memory Metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","memory_id","content"],"title":"ListMemoriesItem"},"ListMemoriesResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ListMemoriesItem"},"type":"array","title":"Data"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["data","total","limit","offset","has_more"],"title":"ListMemoriesResponse"},"ListOAuthClientsResponse":{"properties":{"clients":{"items":{"$ref":"#/components/schemas/OAuthClientSummary"},"type":"array","title":"Clients"},"total":{"type":"integer","title":"Total","description":"Number of clients returned"}},"type":"object","required":["total"],"title":"ListOAuthClientsResponse","description":"Response for GET /clients. Refs #6091, #8449."},"ListOnboardingFlowsResponse":{"properties":{"onboarding_flows":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Onboarding Flows"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"filters":{"$ref":"#/components/schemas/OnboardingFlowFilters"}},"type":"object","required":["onboarding_flows","total","limit","offset","filters"],"title":"ListOnboardingFlowsResponse","description":"Response for GET /onboarding-tutorials/flows."},"ListOrdersResponse":{"properties":{"tab":{"type":"string","title":"Tab"},"orders":{"items":{"$ref":"#/components/schemas/Order"},"type":"array","title":"Orders"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["tab","orders","organization_id"],"title":"ListOrdersResponse"},"ListPaymentMethodsResponse":{"properties":{"payment_methods":{"items":{"$ref":"#/components/schemas/PaymentMethod"},"type":"array","title":"Payment Methods"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["payment_methods","organization_id"],"title":"ListPaymentMethodsResponse"},"ListPermissionsResponse":{"properties":{"permissions":{"items":{"$ref":"#/components/schemas/PermissionItem"},"type":"array","title":"Permissions"}},"type":"object","required":["permissions"],"title":"ListPermissionsResponse"},"ListPostgresBackupsResponse":{"properties":{"volume_instance_id":{"type":"string","title":"Volume Instance Id"},"backups":{"items":{"$ref":"#/components/schemas/PostgresBackupSummary"},"type":"array","title":"Backups"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["volume_instance_id","backups","count"],"title":"ListPostgresBackupsResponse"},"ListProjectCodeFilesResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"files":{"items":{"$ref":"#/components/schemas/ProjectCodeFileEntry"},"type":"array","title":"Files"},"total_files":{"type":"integer","title":"Total Files"},"prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prefix"},"status":{"type":"string","title":"Status"}},"type":"object","required":["project_id","files","total_files","status"],"title":"ListProjectCodeFilesResponse"},"ListRailwayProjectsResponse":{"properties":{"projects":{"items":{"$ref":"#/components/schemas/RailwayProjectEntry"},"type":"array","title":"Projects"},"project_count":{"type":"integer","title":"Project Count"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["projects","project_count","timestamp"],"title":"ListRailwayProjectsResponse","description":"Response for GET /railway-deployment/projects."},"ListRepositoriesEntry":{"properties":{"name":{"type":"string","title":"Name"},"path":{"type":"string","title":"Path"},"status":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Status"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["name","path"],"title":"ListRepositoriesEntry"},"ListRepositoriesResponse":{"properties":{"repositories":{"items":{"$ref":"#/components/schemas/ListRepositoriesEntry"},"type":"array","title":"Repositories"},"total_count":{"type":"integer","title":"Total Count"},"base_path":{"type":"string","title":"Base Path"}},"type":"object","required":["repositories","total_count","base_path"],"title":"ListRepositoriesResponse","description":"Response for GET /git-integration/repositories."},"ListScopesResponse":{"properties":{"scopes":{"items":{"$ref":"#/components/schemas/OAuthScope"},"type":"array","title":"Scopes"},"total":{"type":"integer","title":"Total","description":"Number of scopes available"}},"type":"object","required":["total"],"title":"ListScopesResponse","description":"Response for GET /scopes. Refs #6091, #8449."},"ListSnapshotsResponse":{"properties":{"status":{"type":"string","title":"Status","description":"success | error"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"snapshots":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__schemas__code_context__SnapshotListEntry"},"type":"array"},{"type":"null"}],"title":"Snapshots"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"},"has_more":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has More"}},"type":"object","required":["status"],"title":"ListSnapshotsResponse","description":"Response for GET /snapshots/list (SnapshotSystem.list_snapshots)."},"ListSupportedIDEsResponse":{"properties":{"supported_ides":{"items":{"$ref":"#/components/schemas/SupportedIDE"},"type":"array","title":"Supported Ides"},"discovery_url":{"type":"string","title":"Discovery Url"}},"type":"object","required":["supported_ides","discovery_url"],"title":"ListSupportedIDEsResponse"},"ListTutorialsFilters":{"properties":{"tutorial_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tutorial Type"},"target_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Role"},"difficulty_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Difficulty Level"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}},"type":"object","title":"ListTutorialsFilters"},"ListTutorialsResponse":{"properties":{"tutorials":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tutorials"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"filters":{"$ref":"#/components/schemas/ListTutorialsFilters"}},"type":"object","required":["tutorials","total","limit","offset","filters"],"title":"ListTutorialsResponse","description":"Response for GET /onboarding-tutorials/tutorials."},"ListVectorsResponse":{"properties":{"vectors":{"items":{"$ref":"#/components/schemas/VectorListItem"},"type":"array","title":"Vectors"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["vectors","total","page","page_size","has_more"],"title":"ListVectorsResponse"},"ListVersionsResponse":{"properties":{"versions":{"items":{"$ref":"#/components/schemas/SerializedPromptVersion"},"type":"array","title":"Versions"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["versions","total","skip","limit"],"title":"ListVersionsResponse","description":"Response for GET /templates/{template_id}/versions."},"ListWebhooksResponse":{"properties":{"webhooks":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__webhook_registration__WebhookResponse"},"type":"array","title":"Webhooks"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["webhooks","count"],"title":"ListWebhooksResponse"},"LoadBalancerAdvancedConfig":{"properties":{"connection_draining":{"$ref":"#/components/schemas/ConnectionDraining"},"rate_limiting":{"$ref":"#/components/schemas/RateLimiting"},"compression":{"$ref":"#/components/schemas/Compression"}},"type":"object","required":["connection_draining","rate_limiting","compression"],"title":"LoadBalancerAdvancedConfig"},"LoadBalancerBackend":{"properties":{"id":{"type":"string","title":"Id"},"address":{"type":"string","title":"Address"},"weight":{"type":"integer","title":"Weight"},"status":{"type":"string","title":"Status"},"active_connections":{"type":"integer","title":"Active Connections"},"response_time_ms":{"type":"integer","title":"Response Time Ms"},"success_rate":{"type":"number","title":"Success Rate"},"last_health_check":{"type":"string","title":"Last Health Check"}},"type":"object","required":["id","address","weight","status","active_connections","response_time_ms","success_rate","last_health_check"],"title":"LoadBalancerBackend"},"LoadBalancerConfigResponse":{"properties":{"general":{"$ref":"#/components/schemas/LoadBalancerGeneralConfig"},"ssl":{"$ref":"#/components/schemas/LoadBalancerSslConfig"},"advanced":{"$ref":"#/components/schemas/LoadBalancerAdvancedConfig"},"monitoring":{"$ref":"#/components/schemas/LoadBalancerMonitoringConfig"}},"type":"object","required":["general","ssl","advanced","monitoring"],"title":"LoadBalancerConfigResponse"},"LoadBalancerGeneralConfig":{"properties":{"algorithm":{"type":"string","title":"Algorithm"},"session_persistence":{"$ref":"#/components/schemas/SessionPersistence"},"health_checks":{"$ref":"#/components/schemas/HealthChecksConfig"}},"type":"object","required":["algorithm","session_persistence","health_checks"],"title":"LoadBalancerGeneralConfig"},"LoadBalancerMonitoringConfig":{"properties":{"metrics_enabled":{"type":"boolean","title":"Metrics Enabled"},"logging_level":{"type":"string","title":"Logging Level"},"access_logs":{"type":"boolean","title":"Access Logs"},"error_logs":{"type":"boolean","title":"Error Logs"}},"type":"object","required":["metrics_enabled","logging_level","access_logs","error_logs"],"title":"LoadBalancerMonitoringConfig"},"LoadBalancerPerformanceMetrics":{"properties":{"total_requests":{"type":"integer","title":"Total Requests"},"requests_per_second":{"type":"number","title":"Requests Per Second"},"average_response_time":{"type":"number","title":"Average Response Time"},"error_rate":{"type":"number","title":"Error Rate"},"throughput_mbps":{"type":"number","title":"Throughput Mbps"}},"type":"object","required":["total_requests","requests_per_second","average_response_time","error_rate","throughput_mbps"],"title":"LoadBalancerPerformanceMetrics"},"LoadBalancerSslConfig":{"properties":{"termination":{"type":"boolean","title":"Termination"},"protocols":{"items":{"type":"string"},"type":"array","title":"Protocols"},"ciphers":{"type":"string","title":"Ciphers"},"certificate_expiry":{"type":"string","title":"Certificate Expiry"}},"type":"object","required":["termination","protocols","ciphers","certificate_expiry"],"title":"LoadBalancerSslConfig"},"LoadBalancerStatus":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"algorithm":{"type":"string","title":"Algorithm"},"health_check_interval":{"type":"integer","title":"Health Check Interval"},"timeout":{"type":"integer","title":"Timeout"},"retry_attempts":{"type":"integer","title":"Retry Attempts"},"sticky_sessions":{"type":"boolean","title":"Sticky Sessions"},"ssl_termination":{"type":"boolean","title":"Ssl Termination"},"backends":{"items":{"$ref":"#/components/schemas/LoadBalancerBackend"},"type":"array","title":"Backends"},"traffic_distribution":{"additionalProperties":{"type":"number"},"type":"object","title":"Traffic Distribution"},"performance_metrics":{"$ref":"#/components/schemas/LoadBalancerPerformanceMetrics"}},"type":"object","required":["enabled","algorithm","health_check_interval","timeout","retry_attempts","sticky_sessions","ssl_termination","backends","traffic_distribution","performance_metrics"],"title":"LoadBalancerStatus"},"LoadBalancerUpdateDetails":{"properties":{"updated_fields":{"items":{"type":"string"},"type":"array","title":"Updated Fields"},"applied_at":{"type":"string","title":"Applied At"},"applied_by":{"title":"Applied By"},"previous_config":{"$ref":"#/components/schemas/LoadBalancerConfigResponse"},"new_config":{"additionalProperties":true,"type":"object","title":"New Config"},"restart_required":{"type":"boolean","title":"Restart Required"}},"type":"object","required":["updated_fields","applied_at","applied_by","previous_config","new_config","restart_required"],"title":"LoadBalancerUpdateDetails"},"LoadBalancerUpdateResponse":{"properties":{"message":{"type":"string","title":"Message"},"update_details":{"$ref":"#/components/schemas/LoadBalancerUpdateDetails"}},"type":"object","required":["message","update_details"],"title":"LoadBalancerUpdateResponse"},"LoadTestMetrics":{"properties":{"total_requests":{"type":"number","title":"Total Requests"},"successful_requests":{"type":"number","title":"Successful Requests"},"failed_requests":{"type":"number","title":"Failed Requests"},"average_response_time":{"type":"number","title":"Average Response Time"},"max_response_time":{"type":"number","title":"Max Response Time"},"min_response_time":{"type":"number","title":"Min Response Time"},"requests_per_second":{"type":"number","title":"Requests Per Second"},"error_rate":{"type":"number","title":"Error Rate"},"throughput":{"type":"number","title":"Throughput"}},"type":"object","required":["total_requests","successful_requests","failed_requests","average_response_time","max_response_time","min_response_time","requests_per_second","error_rate","throughput"],"title":"LoadTestMetrics","description":"Load test run metrics."},"LoadTestResult":{"properties":{"id":{"type":"string","title":"Id"},"scenario_id":{"type":"string","title":"Scenario Id"},"scenario_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scenario Name"},"start_time":{"type":"string","title":"Start Time"},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time"},"status":{"type":"string","title":"Status"},"credits_cost":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Cost"},"metrics":{"$ref":"#/components/schemas/LoadTestMetrics"}},"type":"object","required":["id","scenario_id","start_time","status","metrics"],"title":"LoadTestResult"},"LoadTestResultsData":{"properties":{"results":{"items":{"$ref":"#/components/schemas/LoadTestResult"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["results","total"],"title":"LoadTestResultsData"},"LoadTestResultsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/LoadTestResultsData"}},"type":"object","required":["success","data"],"title":"LoadTestResultsResponse","description":"Response for GET /load-testing/results."},"LoadTestRunData":{"properties":{"id":{"type":"string","title":"Id","description":"Load test run ID"},"scenario_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scenario Id","description":"Scenario ID that was run"},"start_time":{"type":"string","title":"Start Time","description":"ISO start timestamp"},"status":{"type":"string","title":"Status","description":"Run status, e.g. running"},"credits_cost":{"type":"integer","title":"Credits Cost","description":"Credits charged for this run"},"estimated_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Duration","description":"Estimated duration in seconds"},"metrics":{"$ref":"#/components/schemas/LoadTestMetrics"}},"type":"object","required":["id","start_time","status","credits_cost","metrics"],"title":"LoadTestRunData"},"LoadTestRunResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/LoadTestRunData"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","data","message"],"title":"LoadTestRunResponse","description":"Response for POST /load-testing/run."},"LoadTestScenario":{"properties":{"id":{"type":"string","title":"Id","description":"Scenario ID"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Scenario name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Scenario description"},"target_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Url","description":"Target URL under test"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method","description":"HTTP method used"},"headers":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Headers","description":"Headers sent with each request"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body","description":"Request body template"},"users":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Users","description":"Concurrent virtual users"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration","description":"Test duration in seconds"},"ramp_up_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ramp Up Time","description":"Ramp-up time in seconds"},"rate_limit_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rate Limit Tier","description":"Rate limit tier used for the run"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"ISO creation timestamp"}},"additionalProperties":true,"type":"object","required":["id"],"title":"LoadTestScenario","description":"A stored load test scenario."},"LoadTestScenarioCreateData":{"properties":{"id":{"type":"string","title":"Id","description":"Newly created scenario ID"}},"additionalProperties":true,"type":"object","required":["id"],"title":"LoadTestScenarioCreateData","description":"Payload of a newly created load test scenario.\n\nIncludes the generated `id` plus whatever fields the client submitted in\nthe request body (the handler echoes back `scenario_data` verbatim), so\nextra client-supplied keys are permitted."},"LoadTestScenarioCreateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/LoadTestScenarioCreateData"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","data","message"],"title":"LoadTestScenarioCreateResponse","description":"Response for POST /load-testing/scenarios."},"LoadTestScenariosData":{"properties":{"scenarios":{"items":{"$ref":"#/components/schemas/LoadTestScenario"},"type":"array","title":"Scenarios"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["scenarios","total"],"title":"LoadTestScenariosData"},"LoadTestScenariosResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/LoadTestScenariosData"}},"type":"object","required":["success","data"],"title":"LoadTestScenariosResponse","description":"Response for GET /load-testing/scenarios."},"LogEvent":{"properties":{"message":{"type":"string","title":"Message","description":"Log message / event name","default":""},"service":{"type":"string","title":"Service","description":"Service tag","default":"cody-cli"},"ddsource":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ddsource","description":"Log source"},"ddtags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ddtags","description":"Comma-separated tags"},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hostname","description":"Client hostname"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Log level","default":"info"},"timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Timestamp","description":"Unix ms timestamp"},"event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"},"event_properties":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Event Properties"}},"type":"object","title":"LogEvent","description":"Single Datadog-compatible log event."},"LogoResponse":{"properties":{"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url"},"preview_grayscale":{"type":"boolean","title":"Preview Grayscale","default":true}},"type":"object","title":"LogoResponse"},"LogoutResponse":{"properties":{"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["message"],"title":"LogoutResponse","description":"POST /auth/logout"},"LogsPagination":{"properties":{"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total":{"type":"integer","title":"Total"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["page","page_size","total","total_pages"],"title":"LogsPagination"},"LogsResponse":{"properties":{"deployment_id":{"type":"string","format":"uuid","title":"Deployment Id"},"lines":{"items":{"type":"string"},"type":"array","title":"Lines"}},"type":"object","required":["deployment_id","lines"],"title":"LogsResponse"},"LoopQualityPoint":{"properties":{"date":{"type":"string","title":"Date"},"avg_score":{"type":"number","title":"Avg Score"},"signals":{"type":"integer","title":"Signals"}},"type":"object","required":["date","avg_score","signals"],"title":"LoopQualityPoint"},"LoopQualityTrend":{"properties":{"overall_success_rate_pct":{"type":"number","title":"Overall Success Rate Pct"},"improving":{"type":"boolean","title":"Improving"},"trend":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Trend"},"source":{"type":"string","title":"Source"}},"type":"object","required":["overall_success_rate_pct","improving","trend","source"],"title":"LoopQualityTrend","description":"Recursive loop quality trend from the data lake. Refs #3356"},"LoopStatusResponse":{"properties":{"redpanda":{"additionalProperties":true,"type":"object","title":"Redpanda"},"lake":{"additionalProperties":true,"type":"object","title":"Lake"},"predictions":{"additionalProperties":true,"type":"object","title":"Predictions"},"loop_latency_estimate_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Loop Latency Estimate Min"},"overall":{"type":"string","title":"Overall"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["redpanda","lake","predictions","overall","timestamp"],"title":"LoopStatusResponse","description":"Health of each intelligence-loop layer. Refs #3410"},"LumaAuthParams":{"properties":{"api_key":{"type":"string","title":"Api Key","description":"Luma API key"},"organizer_id":{"type":"string","title":"Organizer Id","description":"PAI Palooza organizer ID"}},"type":"object","required":["api_key","organizer_id"],"title":"LumaAuthParams","description":"Parameters for Luma API authorization"},"LumaAuthResponse":{"properties":{"authorized":{"type":"boolean","title":"Authorized","description":"Whether authorization succeeded"},"luma_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Luma User Id","description":"Luma user ID"},"events_count":{"type":"integer","title":"Events Count","description":"Number of events accessible","default":0},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if failed"}},"type":"object","required":["authorized"],"title":"LumaAuthResponse","description":"Response from Luma authorization"},"LumaEvent":{"properties":{"luma_event_id":{"type":"string","title":"Luma Event Id","description":"Luma event ID"},"name":{"type":"string","title":"Name","description":"Event name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Event description"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Event start time"},"end_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Time","description":"Event end time"},"timezone":{"type":"string","title":"Timezone","description":"Event timezone","default":"UTC"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"Event location"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image Url","description":"Cover image URL"},"status":{"$ref":"#/components/schemas/LumaEventStatus","description":"Event status","default":"draft"},"attendee_count":{"type":"integer","title":"Attendee Count","description":"Number of attendees","default":0},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"Luma event URL"}},"type":"object","required":["luma_event_id","name","start_time"],"title":"LumaEvent","description":"Luma event data from API"},"LumaEventListResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/LumaEvent"},"type":"array","title":"Events","description":"List of Luma events"},"total_count":{"type":"integer","title":"Total Count","description":"Total number of events","default":0},"has_more":{"type":"boolean","title":"Has More","description":"Whether more events exist","default":false}},"type":"object","required":["events"],"title":"LumaEventListResponse","description":"Response with list of Luma events"},"LumaEventStatus":{"type":"string","enum":["draft","published","cancelled","completed"],"title":"LumaEventStatus","description":"Luma event statuses"},"LumaImportParams":{"properties":{"luma_event_id":{"type":"string","title":"Luma Event Id","description":"Luma event ID to import"},"organizer_id":{"type":"string","title":"Organizer Id","description":"PAI Palooza organizer ID"},"expected_attendees":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expected Attendees","description":"Override attendee estimate"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories","description":"Event categories"}},"type":"object","required":["luma_event_id","organizer_id"],"title":"LumaImportParams","description":"Parameters for importing a Luma event"},"LumaImportResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether import succeeded"},"pai_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pai Event Id","description":"Created PAI Palooza event ID"},"luma_event_id":{"type":"string","title":"Luma Event Id","description":"Luma event ID"},"status":{"$ref":"#/components/schemas/LumaImportStatus","description":"Import status"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if failed"}},"type":"object","required":["success","luma_event_id","status"],"title":"LumaImportResponse","description":"Response from importing a Luma event"},"LumaImportStatus":{"type":"string","enum":["pending","imported","synced","failed"],"title":"LumaImportStatus","description":"Import status for Luma events"},"LumaSyncResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether sync succeeded"},"pai_event_id":{"type":"string","title":"Pai Event Id","description":"PAI Palooza event ID"},"luma_event_id":{"type":"string","title":"Luma Event Id","description":"Luma event ID"},"updated_fields":{"items":{"type":"string"},"type":"array","title":"Updated Fields","description":"Fields that were updated"},"status":{"$ref":"#/components/schemas/LumaImportStatus","description":"Sync status"},"synced_at":{"type":"string","format":"date-time","title":"Synced At","description":"Sync timestamp"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if failed"}},"type":"object","required":["success","pai_event_id","luma_event_id","status","synced_at"],"title":"LumaSyncResponse","description":"Response from syncing a Luma event"},"MCPAnalyticsResponse":{"properties":{"logs":{"items":{"$ref":"#/components/schemas/MCPLogEntry"},"type":"array","title":"Logs"},"total_requests":{"type":"integer","title":"Total Requests","description":"Total matching rows (before pagination)","default":0},"total_credits":{"type":"number","title":"Total Credits","description":"Sum of credits_consumed across all matching rows","default":0},"by_model":{"items":{"$ref":"#/components/schemas/ModelBreakdown"},"type":"array","title":"By Model","description":"Per-model breakdown of request count and credits"},"offset":{"type":"integer","title":"Offset","description":"Current page offset","default":0},"limit":{"type":"integer","title":"Limit","description":"Page size used","default":100}},"type":"object","title":"MCPAnalyticsResponse","description":"Full response for GET /api/v1/analytics/mcp-requests."},"MCPAvailableServersResponse":{"properties":{"servers":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Servers","description":"List of available MCP servers from catalog"},"total":{"type":"integer","title":"Total","description":"Total number of available servers"},"user_enabled":{"items":{"type":"string"},"type":"array","title":"User Enabled","description":"Servers currently enabled by user"}},"type":"object","required":["servers","total","user_enabled"],"title":"MCPAvailableServersResponse","description":"Response model for listing available MCP servers"},"MCPBillingResponse":{"properties":{"period":{"type":"string","title":"Period"},"period_start":{"type":"string","format":"date-time","title":"Period Start"},"period_end":{"type":"string","format":"date-time","title":"Period End"},"total_credits_consumed":{"type":"integer","title":"Total Credits Consumed"},"total_api_calls":{"type":"integer","title":"Total Api Calls"},"total_instances":{"type":"integer","title":"Total Instances"},"daily_breakdown":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Daily Breakdown","default":[]}},"type":"object","required":["period","period_start","period_end","total_credits_consumed","total_api_calls","total_instances"],"title":"MCPBillingResponse","description":"Response model for MCP billing summary"},"MCPCatalogResponse":{"properties":{"servers":{"items":{"$ref":"#/components/schemas/MCPDiscoveryResult"},"type":"array","title":"Servers"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["servers","total","limit","offset"],"title":"MCPCatalogResponse","description":"Response for catalog listing."},"MCPCategoriesResponse":{"properties":{"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"total_servers":{"type":"integer","title":"Total Servers"}},"additionalProperties":true,"type":"object","required":["categories","total_servers"],"title":"MCPCategoriesResponse","description":"GET /categories — distinct catalog categories plus active server count."},"MCPClearCacheResponse":{"properties":{"message":{"type":"string","title":"Message"},"instance_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instance Id"},"cleared_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cleared At"}},"additionalProperties":true,"type":"object","required":["message"],"title":"MCPClearCacheResponse","description":"POST /registry/clear-cache — SPARSE by design.\n\nThe single-instance branch returns message/instance_id/cleared_at; the\nclear-everything branch returns ONLY message/cleared_at. exclude_unset on\nthe route is what keeps the second branch from growing a null\n`instance_id`."},"MCPContainerCacheInfo":{"properties":{"cached":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Cached"},"cached_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cached At"},"cache_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cache Status"}},"additionalProperties":true,"type":"object","title":"MCPContainerCacheInfo","description":"The flattened cache view built by GET /instances."},"MCPContainerHealthStatus":{"properties":{"healthy":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Healthy"},"response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time Ms"},"last_check":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Check"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"additionalProperties":true,"type":"object","title":"MCPContainerHealthStatus","description":"The flattened health view built by GET /instances."},"MCPDiscoverRequest":{"properties":{"query":{"type":"string","maxLength":1000,"minLength":1,"title":"Query","description":"Natural language query"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Max results to return","default":10},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Filter by tags"},"trust_min":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"title":"Trust Min","description":"Minimum trust score"},"price_max":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Price Max","description":"Maximum price per query"},"weight_relevance":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Weight Relevance","description":"Relevance weight (default 0.5)"},"weight_trust":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Weight Trust","description":"Trust weight (default 0.3)"},"weight_cost":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Weight Cost","description":"Cost efficiency weight (default 0.1)"},"weight_popularity":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Weight Popularity","description":"Popularity weight (default 0.1)"}},"type":"object","required":["query"],"title":"MCPDiscoverRequest","description":"Semantic search request for MCP discovery."},"MCPDiscoverResponse":{"properties":{"query":{"type":"string","title":"Query"},"results":{"items":{"$ref":"#/components/schemas/MCPDiscoveryResult"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"},"weights":{"additionalProperties":{"type":"number"},"type":"object","title":"Weights","description":"Ranking weights used"}},"type":"object","required":["query","results","total"],"title":"MCPDiscoverResponse","description":"Response for semantic MCP discovery."},"MCPDiscoveryResult":{"properties":{"server_id":{"type":"string","title":"Server Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"version":{"type":"string","title":"Version"},"status":{"type":"string","title":"Status"},"category":{"type":"string","title":"Category"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"tools_count":{"type":"integer","title":"Tools Count","default":0},"price_per_query":{"type":"number","title":"Price Per Query","default":0},"trust_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Trust Score"},"usage_count":{"type":"integer","title":"Usage Count","default":0},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"is_active":{"type":"boolean","title":"Is Active","description":"Whether the server is currently active/available. Inactive servers are surfaced (badged) rather than hidden — Refs #6511","default":true},"relevance_score":{"type":"number","title":"Relevance Score","description":"Cosine similarity score","default":0},"composite_score":{"type":"number","title":"Composite Score","description":"Final composite ranking score","default":0},"score_breakdown":{"additionalProperties":{"type":"number"},"type":"object","title":"Score Breakdown","description":"Per-factor score breakdown"}},"type":"object","required":["server_id","name","description","version","status","category"],"title":"MCPDiscoveryResult","description":"A single ranked discovery result."},"MCPIDEConfigResponse":{"properties":{"ide":{"type":"string","title":"Ide"},"file_path":{"type":"string","title":"File Path"},"instructions":{"type":"string","title":"Instructions"},"config":{"additionalProperties":true,"type":"object","title":"Config"}},"type":"object","required":["ide","file_path","instructions","config"],"title":"MCPIDEConfigResponse","description":"Pre-filled MCP config for the requested IDE. `config` shape is\nIDE-specific (mcpServers/mcp.servers block), so it stays a dict."},"MCPInstanceActionResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"MCPInstanceActionResponse","description":"start / stop / delete — a status word plus a human message.\n\n`status` is deliberately a free-form str, not a Literal: DELETE returns\n\"terminating\" on the normal path and \"deleted\" when the instance was\nalready terminated."},"MCPInstanceContainerInfo":{"properties":{"container_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container Id"},"external_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Endpoint"},"proxy_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Proxy Enabled"},"endpoint_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Endpoint Available"},"health_status":{"anyOf":[{"$ref":"#/components/schemas/MCPContainerHealthStatus"},{"type":"null"}]},"cache_info":{"anyOf":[{"$ref":"#/components/schemas/MCPContainerCacheInfo"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"MCPInstanceContainerInfo","description":"The container view on GET /instances.\n\nRefs #8794: `internal_endpoint` is deliberately NOT declared. It resolved\nto the container-internal address built by\nMCPContainerRegistry._construct_container_endpoint() (literally\n`ws://{container_id}:3000`) — a hostname:port that only resolves on the\nprivate container network and is unreachable from outside the backend's\nown infrastructure. `external_endpoint` is the field a customer can\nactually connect to."},"MCPInstanceContainerRegistry":{"properties":{"external_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Endpoint"},"proxy_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Proxy Enabled"},"endpoint_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Endpoint Available"},"health_status":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Health Status"},"cache_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Cache Info"},"registry_performance":{"anyOf":[{"$ref":"#/components/schemas/MCPRegistryPerformance"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"MCPInstanceContainerRegistry","description":"The container-registry view on GET /instances/{instance_id}.\n\nRefs #8794: `internal_endpoint` and `container_internal_url` are\ndeliberately NOT declared. Both carried the container-internal address\n(`ws://{container_id}:3000`, see\nMCPContainerRegistry._construct_container_endpoint) which only resolves on\nthe private container network — a customer cannot connect to it even if\nthey wanted to. `external_endpoint` remains the real customer-facing\naddress. The values are still computed and stored server-side for the\nproxy/health-check paths that consume them; they are just not serialized\nhere."},"MCPInstanceDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"server_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Server Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"container_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"deployed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deployed At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"last_ping":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ping"},"total_api_calls":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Api Calls"},"total_credits_used":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Credits Used"},"resource_limits":{"anyOf":[{"$ref":"#/components/schemas/MCPInstanceResourceLimits"},{"type":"null"}]},"container_registry":{"anyOf":[{"$ref":"#/components/schemas/MCPInstanceContainerRegistry"},{"type":"null"}]}},"additionalProperties":true,"type":"object","required":["id"],"title":"MCPInstanceDetailResponse","description":"GET /instances/{instance_id}"},"MCPInstanceEndpointInfoResponse":{"properties":{"instance_id":{"type":"string","title":"Instance Id"},"endpoint_resolution":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Endpoint Resolution"},"database_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Database Info"},"registry_statistics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Registry Statistics"},"resolution_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Timestamp"}},"additionalProperties":true,"type":"object","required":["instance_id"],"title":"MCPInstanceEndpointInfoResponse","description":"GET /instances/{instance_id}/endpoint.\n\n`endpoint_resolution` and `registry_statistics` are the registry's own\ndicts, passed through untyped so nothing inside them is filtered."},"MCPInstanceListItem":{"properties":{"id":{"type":"string","title":"Id"},"server_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Server Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"last_heartbeat":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Heartbeat"},"usage_stats":{"anyOf":[{"$ref":"#/components/schemas/MCPInstanceUsageStats"},{"type":"null"}]},"container_info":{"anyOf":[{"$ref":"#/components/schemas/MCPInstanceContainerInfo"},{"type":"null"}]}},"additionalProperties":true,"type":"object","required":["id"],"title":"MCPInstanceListItem","description":"One entry of GET /instances — the shape lib/mcp-service.ts\ngetInstances() normalizes into its MCPInstance type."},"MCPInstanceListResponse":{"properties":{"instances":{"items":{"$ref":"#/components/schemas/MCPInstanceListItem"},"type":"array","title":"Instances"}},"additionalProperties":true,"type":"object","required":["instances"],"title":"MCPInstanceListResponse","description":"GET /instances — the frontend reads `.instances`."},"MCPInstanceResourceLimits":{"properties":{"cpu_limit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpu Limit"},"memory_limit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Limit"},"storage_limit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Storage Limit"}},"additionalProperties":true,"type":"object","title":"MCPInstanceResourceLimits"},"MCPInstanceStatus":{"type":"string","enum":["creating","starting","running","stopping","stopped","error","terminated"],"title":"MCPInstanceStatus","description":"MCP Server Instance status enumeration"},"MCPInstanceUsageStats":{"properties":{"total_requests":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Requests"},"credits_used":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Credits Used"},"uptime_hours":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Uptime Hours"}},"additionalProperties":true,"type":"object","title":"MCPInstanceUsageStats"},"MCPLogEntry":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","description":"Log entry UUID"},"instance_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instance Id","description":"MCP instance / agent ID"},"endpoint":{"type":"string","title":"Endpoint","description":"API endpoint path","default":""},"method":{"type":"string","title":"Method","description":"HTTP method","default":"GET"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Status Code","description":"HTTP response status code"},"response_time_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Time Ms","description":"Latency in milliseconds"},"credits_consumed":{"type":"number","title":"Credits Consumed","description":"Credits charged for this request","default":0},"endpoint_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Category","description":"Category / model tag"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project / customer UUID"},"tool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Name","description":"MCP tool name, if applicable"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"ISO-8601 timestamp"}},"type":"object","title":"MCPLogEntry","description":"Single mcp_request_logs row returned to the caller."},"MCPOperationRequest":{"properties":{"operation":{"type":"string","title":"Operation","description":"Operation name"},"params":{"additionalProperties":true,"type":"object","title":"Params","description":"Operation parameters"}},"type":"object","required":["operation"],"title":"MCPOperationRequest","description":"Request schema for MCP operations"},"MCPOperationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"operation":{"type":"string","title":"Operation"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"},"timestamp":{"type":"string","title":"Timestamp"},"execution_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Execution Time Ms"}},"type":"object","required":["success","operation","timestamp"],"title":"MCPOperationResponse","description":"Response schema for MCP operations"},"MCPRefreshEndpointResponse":{"properties":{"instance_id":{"type":"string","title":"Instance Id"},"refresh_successful":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Refresh Successful"},"endpoint_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Endpoint Info"},"refreshed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refreshed At"}},"additionalProperties":true,"type":"object","required":["instance_id"],"title":"MCPRefreshEndpointResponse","description":"POST /instances/{instance_id}/refresh-endpoint"},"MCPRegistryPerformance":{"properties":{"cache_ttl_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cache Ttl Seconds"},"health_check_timeout":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Health Check Timeout"}},"additionalProperties":true,"type":"object","title":"MCPRegistryPerformance","description":"NOTE: `cache_ttl_seconds` is read from\nMCPContainerRegistry.get_endpoint_statistics()[\"performance_config\"],\nwhich does NOT contain that key (it lives under \"cache_statistics\"), so\nthis field is always null on GET /instances/{id} today. Declared anyway\nso the existing (null) key keeps appearing instead of disappearing from\nthe live contract. Pre-existing behavior, not changed by #8449."},"MCPRegistryStatisticsResponse":{"properties":{"registry_statistics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Registry Statistics"},"user_statistics":{"anyOf":[{"$ref":"#/components/schemas/MCPRegistryUserStatistics"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"additionalProperties":true,"type":"object","title":"MCPRegistryStatisticsResponse","description":"GET /registry/statistics"},"MCPRegistryUserStatistics":{"properties":{"total_instances":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Instances"},"running_instances":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Running Instances"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},"additionalProperties":true,"type":"object","title":"MCPRegistryUserStatistics","description":"Caller-scoped counts only — `user_id` is the authenticated user's own\nid, never another tenant's."},"MCPReindexResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'completed' on a 2xx","examples":["completed"]},"indexed":{"type":"integer","title":"Indexed","description":"Servers successfully re-embedded"},"failed":{"type":"integer","title":"Failed","description":"Servers whose embedding failed"},"total":{"type":"integer","title":"Total","description":"Active servers considered"}},"type":"object","required":["status","indexed","failed","total"],"title":"MCPReindexResponse","description":"Result of an admin catalog reindex — POST /reindex.\n\n``status`` is a literal set by the handler, not service data: a 2xx always\ncarries ``\"completed\"``, and a failure is a 500 rather than a 200 with a\ndifferent status string."},"MCPServerCatalogResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"type":"string","title":"Category"},"features":{"items":{"type":"string"},"type":"array","title":"Features","default":[]},"credits_per_hour":{"type":"integer","title":"Credits Per Hour"},"setup_fee":{"type":"integer","title":"Setup Fee","default":0},"status":{"$ref":"#/components/schemas/MCPServerStatus"},"is_recommended":{"type":"boolean","title":"Is Recommended","default":false},"config_template":{"additionalProperties":true,"type":"object","title":"Config Template","default":{}},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"}},"type":"object","required":["id","name","description","category","credits_per_hour","status"],"title":"MCPServerCatalogResponse","description":"Response model for MCP server catalog"},"MCPServerConfig":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":true},"priority":{"type":"integer","title":"Priority","description":"Execution priority (higher = higher priority)","default":0},"timeout_seconds":{"type":"integer","title":"Timeout Seconds","description":"Request timeout in seconds","default":30},"retry_attempts":{"type":"integer","title":"Retry Attempts","description":"Number of retry attempts on failure","default":3},"custom_config":{"additionalProperties":true,"type":"object","title":"Custom Config","description":"Server-specific configuration"}},"type":"object","title":"MCPServerConfig","description":"Configuration for a specific MCP server"},"MCPServerDetail":{"properties":{"name":{"type":"string","title":"Name","description":"Unique server identifier"},"description":{"type":"string","title":"Description","description":"Human-readable description"},"version":{"type":"string","title":"Version","description":"Semantic version"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities","description":"Capability tags (e.g. vectors, memory, cms)"},"status":{"type":"string","title":"Status","description":"Availability status: available or maintenance"},"tools_count":{"type":"integer","title":"Tools Count","description":"Number of tools exposed"},"endpoint_url":{"type":"string","title":"Endpoint Url","description":"URL or install command"},"tools":{"items":{"$ref":"#/components/schemas/MCPToolInfo"},"type":"array","title":"Tools","description":"Complete list of tools"}},"type":"object","required":["name","description","version","capabilities","status","tools_count","endpoint_url","tools"],"title":"MCPServerDetail","description":"Full detail view of an MCP server, including tool list."},"MCPServerDetailResponse":{"properties":{"server_id":{"type":"string","title":"Server Id","description":"Server UUID as a string"},"name":{"type":"string","title":"Name","description":"Unique catalog name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Operator-authored description; nullable column"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","description":"Server version, e.g. '0.1.1'"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Catalog status, e.g. 'available'"},"category":{"type":"string","title":"Category","description":"Catalog category (non-nullable)"},"features":{"items":{"type":"string"},"type":"array","title":"Features","description":"Operator-authored feature labels"},"credits_per_hour":{"type":"integer","title":"Credits Per Hour","description":"Billing rate (non-nullable)"},"config_template":{"additionalProperties":true,"type":"object","title":"Config Template","description":"Client configuration template (vendor JSONB)"},"capabilities":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Capabilities","description":"Full capability manifest; None when no manifest row exists (LEFT JOIN on mcp_capability_manifests)"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Catalog tags, sorted"},"pricing":{"additionalProperties":true,"type":"object","title":"Pricing","description":"Pricing blob (vendor JSONB)"},"is_active":{"type":"boolean","title":"Is Active","description":"Whether the server is active. Inactive servers are surfaced (badged) rather than hidden — Refs #6511"},"tools":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tools","description":"Tool declarations from the capability manifest (vendor JSONB)"},"tools_count":{"type":"integer","title":"Tools Count","description":"len(tools) — Refs #6511","default":0},"trust_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Trust Score","description":"Derived from the operator's is_recommended flag"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url","description":"Real Gateway URL for Gateway-backed servers, None otherwise — Refs #7137, #7986"}},"type":"object","required":["server_id","name","category","credits_per_hour","is_active"],"title":"MCPServerDetailResponse","description":"Full detail for one catalog server — GET /catalog/{server_id}.\n\nRicher than ``MCPDiscoveryResult`` (the list/search row): this adds the\ncapability manifest, config template, pricing blob and the resolved tool\nlist, and omits the ranking fields that only exist in a search result."},"MCPServerEnableRequest":{"properties":{"priority":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Priority","description":"Set server priority"},"timeout_seconds":{"anyOf":[{"type":"integer","maximum":300,"minimum":1},{"type":"null"}],"title":"Timeout Seconds","description":"Set server timeout"},"retry_attempts":{"anyOf":[{"type":"integer","maximum":10,"minimum":0},{"type":"null"}],"title":"Retry Attempts","description":"Set retry attempts"},"custom_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Custom Config","description":"Set custom configuration"}},"type":"object","title":"MCPServerEnableRequest","description":"Request model for enabling/disabling a specific MCP server"},"MCPServerInstanceCreate":{"properties":{"server_id":{"type":"string","format":"uuid","title":"Server Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"config":{"additionalProperties":true,"type":"object","title":"Config","default":{}}},"type":"object","required":["server_id","name"],"title":"MCPServerInstanceCreate","description":"Request model for creating MCP server instance"},"MCPServerInstanceResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"server_id":{"type":"string","format":"uuid","title":"Server Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"config":{"additionalProperties":true,"type":"object","title":"Config","default":{}},"container_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container Id"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"health_check_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Health Check Url"},"status":{"$ref":"#/components/schemas/MCPInstanceStatus"},"last_ping":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Ping"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"cpu_limit":{"type":"number","title":"Cpu Limit","default":1},"memory_limit":{"type":"integer","title":"Memory Limit","default":1024},"storage_limit":{"type":"integer","title":"Storage Limit","default":5120},"total_credits_used":{"type":"integer","title":"Total Credits Used","default":0},"total_api_calls":{"type":"integer","title":"Total Api Calls","default":0},"last_billing_check":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Billing Check"},"auto_scale_enabled":{"type":"boolean","title":"Auto Scale Enabled","default":true},"min_instances":{"type":"integer","title":"Min Instances","default":1},"max_instances":{"type":"integer","title":"Max Instances","default":3},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"deployed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deployed At"},"terminated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Terminated At"},"container_registry":{"anyOf":[{"$ref":"#/components/schemas/ContainerRegistryInfo"},{"type":"null"}]}},"type":"object","required":["id","user_id","server_id","name","description","container_id","endpoint_url","health_check_url","status","last_ping","error_message","last_billing_check","created_at","updated_at","deployed_at","terminated_at"],"title":"MCPServerInstanceResponse","description":"Response model for MCP server instance with enhanced container registry information"},"MCPServerInstanceUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config"},"cpu_limit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpu Limit"},"memory_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Limit"},"auto_scale_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Scale Enabled"},"min_instances":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Instances"},"max_instances":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Instances"}},"type":"object","title":"MCPServerInstanceUpdate","description":"Request model for updating MCP server instance"},"MCPServerListResponse":{"properties":{"servers":{"items":{"$ref":"#/components/schemas/MCPServerSummary"},"type":"array","title":"Servers"},"total":{"type":"integer","title":"Total","description":"Total count of servers in response"}},"type":"object","required":["servers","total"],"title":"MCPServerListResponse","description":"Response wrapper for the server list endpoint."},"MCPServerStatus":{"type":"string","enum":["available","deprecated","beta","maintenance","discontinued"],"title":"MCPServerStatus","description":"MCP Server status enumeration"},"MCPServerStatusResponse":{"properties":{"server_name":{"type":"string","title":"Server Name"},"enabled":{"type":"boolean","title":"Enabled"},"config":{"$ref":"#/components/schemas/MCPServerConfig"},"message":{"type":"string","title":"Message"}},"type":"object","required":["server_name","enabled","config","message"],"title":"MCPServerStatusResponse","description":"Response model for MCP server enable/disable operations"},"MCPServerSummary":{"properties":{"name":{"type":"string","title":"Name","description":"Unique server identifier"},"description":{"type":"string","title":"Description","description":"Human-readable description"},"version":{"type":"string","title":"Version","description":"Semantic version"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities","description":"Capability tags (e.g. vectors, memory, cms)"},"status":{"type":"string","title":"Status","description":"Availability status: available or maintenance"},"tools_count":{"type":"integer","title":"Tools Count","description":"Number of tools exposed"},"endpoint_url":{"type":"string","title":"Endpoint Url","description":"URL or install command"}},"type":"object","required":["name","description","version","capabilities","status","tools_count","endpoint_url"],"title":"MCPServerSummary","description":"Summary view of an MCP server for list responses."},"MCPServersListResponse":{"properties":{"servers":{"items":{"$ref":"#/components/schemas/app__schemas__mcp_servers__MCPServerInfo"},"type":"array","title":"Servers","description":"List of MCP servers"},"total":{"type":"integer","title":"Total","description":"Total number of MCP servers"}},"type":"object","required":["servers","total"],"title":"MCPServersListResponse","description":"Response for GET /v1/mcp_servers."},"MCPSettingsResponse":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"enabled_servers":{"items":{"type":"string"},"type":"array","title":"Enabled Servers","description":"List of enabled MCP server names"},"server_configs":{"additionalProperties":{"$ref":"#/components/schemas/MCPServerConfig"},"type":"object","title":"Server Configs","description":"Per-server configuration"},"global_timeout_seconds":{"type":"integer","title":"Global Timeout Seconds","description":"Global timeout for all MCP operations","default":30},"max_concurrent_requests":{"type":"integer","title":"Max Concurrent Requests","description":"Maximum concurrent MCP requests","default":5},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["user_id","created_at","updated_at"],"title":"MCPSettingsResponse","description":"Response model for user's MCP settings"},"MCPSettingsUpdate":{"properties":{"enabled_servers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Enabled Servers","description":"Update list of enabled servers"},"server_configs":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/MCPServerConfig"},"type":"object"},{"type":"null"}],"title":"Server Configs","description":"Update server configurations"},"global_timeout_seconds":{"anyOf":[{"type":"integer","maximum":300,"minimum":1},{"type":"null"}],"title":"Global Timeout Seconds","description":"Update global timeout (1-300 seconds)"},"max_concurrent_requests":{"anyOf":[{"type":"integer","maximum":20,"minimum":1},{"type":"null"}],"title":"Max Concurrent Requests","description":"Update max concurrent requests (1-20)"}},"type":"object","title":"MCPSettingsUpdate","description":"Request model for updating MCP settings"},"MCPToolCall":{"properties":{"tool":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool"},"operation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operation"},"arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Arguments"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters"},"params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Params"}},"type":"object","title":"MCPToolCall"},"MCPToolCallResult":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"status":{"type":"string","title":"Status"},"output":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Output"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"context_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context Id"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"}},"type":"object","required":["agent_id","status"],"title":"MCPToolCallResult","description":"Result of invoking a swarm agent (see agent_mcp_service.call_tool)."},"MCPToolDefinition":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"inputSchema":{"additionalProperties":true,"type":"object","title":"Inputschema"},"_agent_id":{"type":"string","title":"Agent Id"}},"type":"object","required":["name","description","inputSchema","_agent_id"],"title":"MCPToolDefinition","description":"One MCP tool definition (see agent_mcp_service.list_tools).\n\n``_agent_id`` is a real field returned by the service (a stable\nreference used for routing to call_tool) — kept here, not just an\ninternal artifact, since existing tests read it directly."},"MCPToolInfo":{"properties":{"name":{"type":"string","title":"Name","description":"Tool name"},"description":{"type":"string","title":"Description","description":"What the tool does"}},"type":"object","required":["name","description"],"title":"MCPToolInfo","description":"A single tool exposed by an MCP server."},"MCPToolListResponse":{"properties":{"tools":{"items":{"$ref":"#/components/schemas/MCPToolDefinition"},"type":"array","title":"Tools"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["tools","count"],"title":"MCPToolListResponse"},"MCPToolManifestResponse":{"properties":{"schema_version":{"type":"string","title":"Schema Version"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"endpoint":{"type":"string","title":"Endpoint"},"auth":{"type":"string","title":"Auth"},"tool_categories":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Tool Categories"},"total_tools":{"type":"integer","title":"Total Tools"},"operations_url":{"type":"string","title":"Operations Url"},"health_url":{"type":"string","title":"Health Url"},"verify_key_url":{"type":"string","title":"Verify Key Url"},"usage":{"$ref":"#/components/schemas/MCPToolManifestUsage"}},"type":"object","required":["schema_version","name","description","endpoint","auth","tool_categories","total_tools","operations_url","health_url","verify_key_url","usage"],"title":"MCPToolManifestResponse","description":"Static tool manifest returned by GET /mcp — Fixes #2808."},"MCPToolManifestUsage":{"properties":{"example":{"$ref":"#/components/schemas/MCPToolManifestUsageExample"}},"type":"object","required":["example"],"title":"MCPToolManifestUsage"},"MCPToolManifestUsageExample":{"properties":{"method":{"type":"string","title":"Method"},"url":{"type":"string","title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers"},"body":{"additionalProperties":true,"type":"object","title":"Body"}},"type":"object","required":["method","url","headers","body"],"title":"MCPToolManifestUsageExample"},"MCPTrackAPICallResponse":{"properties":{"status":{"type":"string","title":"Status"},"credits_charged":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Charged"},"call_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Call Id"}},"additionalProperties":true,"type":"object","required":["status"],"title":"MCPTrackAPICallResponse","description":"POST /track-api-call"},"MCPUsageLogResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"server_id":{"type":"string","format":"uuid","title":"Server Id"},"instance_id":{"type":"string","format":"uuid","title":"Instance Id"},"period_start":{"type":"string","format":"date-time","title":"Period Start"},"period_end":{"type":"string","format":"date-time","title":"Period End"},"cpu_hours":{"type":"number","title":"Cpu Hours","default":0},"memory_hours":{"type":"number","title":"Memory Hours","default":0},"storage_hours":{"type":"number","title":"Storage Hours","default":0},"network_bytes":{"type":"integer","title":"Network Bytes","default":0},"total_api_calls":{"type":"integer","title":"Total Api Calls","default":0},"successful_calls":{"type":"integer","title":"Successful Calls","default":0},"failed_calls":{"type":"integer","title":"Failed Calls","default":0},"avg_response_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Response Time"},"credits_consumed":{"type":"integer","title":"Credits Consumed"},"cost_breakdown":{"additionalProperties":true,"type":"object","title":"Cost Breakdown","default":{}},"billing_status":{"type":"string","title":"Billing Status","default":"pending"},"usage_metadata":{"additionalProperties":true,"type":"object","title":"Usage Metadata","default":{}},"created_at":{"type":"string","format":"date-time","title":"Created At"},"billed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Billed At"}},"type":"object","required":["id","user_id","server_id","instance_id","period_start","period_end","avg_response_time","credits_consumed","created_at","billed_at"],"title":"MCPUsageLogResponse","description":"Response model for MCP usage logs"},"MFABackupCodesResponse":{"properties":{"backup_codes":{"items":{"type":"string"},"type":"array","title":"Backup Codes","description":"10 new single-use backup codes"},"message":{"type":"string","title":"Message","default":"Backup codes regenerated. Store these securely — they will not be shown again."}},"type":"object","required":["backup_codes"],"title":"MFABackupCodesResponse","description":"Response for backup code regeneration"},"MFADisableRequest":{"properties":{"password":{"type":"string","minLength":1,"title":"Password","description":"Current password for confirmation"},"backup_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backup Code","description":"Backup code (alternative to TOTP)"}},"type":"object","required":["password"],"title":"MFADisableRequest","description":"Request to disable MFA — requires password confirmation"},"MFADisableResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable confirmation"}},"type":"object","required":["message"],"title":"MFADisableResponse","description":"Response after MFA is disabled (Refs #8449).\n\nDeliberately a SINGLE message field. A disable confirmation has no reason\nto echo a password hash, TOTP secret, or any remaining backup code, and\nkeeping the model this narrow means a future handler change cannot start\nleaking one through this route. The field is unconditional on the 200 path,\nso no `response_model_exclude_unset` is needed."},"MFASetupResponse":{"properties":{"secret":{"type":"string","title":"Secret","description":"Base32-encoded TOTP secret (show once)"},"qr_uri":{"type":"string","title":"Qr Uri","description":"otpauth:// URI for QR code generation"},"backup_codes":{"items":{"type":"string"},"type":"array","title":"Backup Codes","description":"10 single-use backup codes (show once)"}},"type":"object","required":["secret","qr_uri","backup_codes"],"title":"MFASetupResponse","description":"Response for MFA setup — contains secret, QR URI, and backup codes","example":{"backup_codes":["A1B2C3D4","E5F6G7H8","..."],"qr_uri":"otpauth://totp/AINative:user@example.com?secret=JBSWY3DPEHPK3PXP&issuer=AINative","secret":"JBSWY3DPEHPK3PXP"}},"MFAVerifyRequest":{"properties":{"code":{"type":"string","maxLength":8,"minLength":6,"title":"Code","description":"6-digit TOTP code or 8-char backup code"}},"type":"object","required":["code"],"title":"MFAVerifyRequest","description":"Request to verify a TOTP code (setup confirmation or login)","example":{"code":"123456"}},"MFAVerifyResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the code was valid"},"message":{"type":"string","title":"Message","description":"Human-readable result"},"access_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token","description":"Full access token (only after successful login MFA)"},"refresh_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Token","description":"Refresh token (only after successful login MFA)"}},"type":"object","required":["success","message"],"title":"MFAVerifyResponse","description":"Response for MFA verification","example":{"access_token":"eyJ...","message":"MFA verification successful","refresh_token":"eyJ...","success":true}},"MagicLinkRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"MagicLinkRequest","description":"Request body for sending a magic link email. Refs #3866"},"MagicLinkSentResponse":{"properties":{"status":{"type":"string","title":"Status"},"email":{"type":"string","title":"Email"}},"additionalProperties":true,"type":"object","required":["status","email"],"title":"MagicLinkSentResponse","description":"POST /auth/magic-link — confirms the Stytch magic-link email was sent."},"MagicLinkVerifyRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"MagicLinkVerifyRequest","description":"Request body for verifying a magic link token. Refs #3866"},"MaintenanceTableResult":{"properties":{"table":{"type":"string","title":"Table"},"status":{"type":"string","title":"Status"},"size_before_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Size Before Mb"},"size_after_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Size After Mb"},"space_freed_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Space Freed Mb"},"rows_analyzed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Analyzed"},"indexes_rebuilt":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Indexes Rebuilt"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["table","status"],"title":"MaintenanceTableResult"},"ManageBranchResponse":{"properties":{"status":{"type":"string","title":"Status"},"branch_result":{"additionalProperties":true,"type":"object","title":"Branch Result"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","branch_result","timestamp"],"title":"ManageBranchResponse","description":"Response for POST /git-integration/branch."},"ManagedChatCompletionRequest":{"properties":{"messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","minItems":1,"title":"Messages","description":"Array of chat messages with role and content"},"tools":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tools","description":"Optional tool definitions for function calling"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Preferred model (must be available in user's plan). OpenAI-compatible parameter."},"max_iterations":{"anyOf":[{"type":"integer","maximum":10,"minimum":1},{"type":"null"}],"title":"Max Iterations","description":"Max tool calling iterations (capped by plan limits)"},"temperature":{"anyOf":[{"type":"number","maximum":2,"minimum":0},{"type":"null"}],"title":"Temperature","description":"Sampling temperature","default":0.7},"max_tokens":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Max Tokens","description":"Maximum tokens to generate"},"stream":{"type":"boolean","title":"Stream","description":"Whether to stream responses with SSE events (tool execution progress)","default":false},"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thread Id","description":"Thread ID for conversation continuity. Pass an existing UUID to resume a thread, or 'new' to auto-create one. When omitted, the request is stateless (original behavior)."},"thread_max_messages":{"anyOf":[{"type":"integer","maximum":200,"minimum":1},{"type":"null"}],"title":"Thread Max Messages","description":"Max previous messages to load from thread as context (1-200)","default":50}},"type":"object","required":["messages"],"title":"ManagedChatCompletionRequest","description":"Request schema for managed chat completion\n\nUsers specify messages and optional tools. The system selects\nthe appropriate model based on their subscription tier.","example":{"max_tokens":1000,"messages":[{"content":"What is the capital of France?","role":"user"}],"model":"sdxl","temperature":0.7}},"ManagedSite":{"properties":{"site_id":{"type":"string","title":"Site Id"},"name":{"type":"string","title":"Name"},"url":{"type":"string","title":"Url"},"wp_version":{"type":"string","title":"Wp Version"},"theme":{"type":"string","title":"Theme"},"plugins_count":{"type":"integer","title":"Plugins Count"},"status":{"type":"string","title":"Status"},"last_backup":{"type":"string","title":"Last Backup"},"last_update":{"type":"string","title":"Last Update"},"performance_score":{"type":"integer","title":"Performance Score"},"security_score":{"type":"integer","title":"Security Score"},"uptime":{"type":"number","title":"Uptime"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["site_id","name","url","wp_version","theme","plugins_count","status","last_backup","last_update","performance_score","security_score","uptime","created_at"],"title":"ManagedSite","description":"A single managed WordPress site summary entry."},"ManagedSitesResponse":{"properties":{"sites":{"items":{"$ref":"#/components/schemas/ManagedSite"},"type":"array","title":"Sites"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"skip":{"type":"integer","title":"Skip"},"summary":{"$ref":"#/components/schemas/ManagedSitesSummary"}},"type":"object","required":["sites","total","limit","skip","summary"],"title":"ManagedSitesResponse","description":"Response for GET /wordpress-agent/sites."},"ManagedSitesSummary":{"properties":{"total_sites":{"type":"integer","title":"Total Sites"},"active_sites":{"type":"integer","title":"Active Sites"},"maintenance_sites":{"type":"integer","title":"Maintenance Sites"},"offline_sites":{"type":"integer","title":"Offline Sites"}},"type":"object","required":["total_sites","active_sites","maintenance_sites","offline_sites"],"title":"ManagedSitesSummary"},"ManualPayoutRequest":{"properties":{"organizer_id":{"type":"string","title":"Organizer Id","description":"Organizer ID to pay out"},"override_threshold":{"type":"boolean","title":"Override Threshold","description":"If true, bypass the $100 minimum threshold","default":false}},"type":"object","required":["organizer_id"],"title":"ManualPayoutRequest","description":"Request to manually trigger a payout for an organizer."},"ManualScalingResponse":{"properties":{"scaling_id":{"type":"string","title":"Scaling Id"},"action":{"type":"string","title":"Action"},"instance_count":{"type":"integer","title":"Instance Count"},"reason":{"type":"string","title":"Reason"},"status":{"type":"string","title":"Status"},"initiated_at":{"type":"string","title":"Initiated At"},"initiated_by":{"title":"Initiated By"},"estimated_completion":{"type":"string","title":"Estimated Completion"}},"type":"object","required":["scaling_id","action","instance_count","reason","status","initiated_at","initiated_by","estimated_completion"],"title":"ManualScalingResponse"},"MarkPaidRequest":{"properties":{"payment_method":{"type":"string","title":"Payment Method","description":"Payment method","default":"manual"},"payment_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Reference","description":"Payment reference/transaction ID"},"paid_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Paid At","description":"Payment timestamp (defaults to now)"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes","description":"Additional notes"}},"type":"object","title":"MarkPaidRequest","description":"Schema for manually marking invoice as paid","example":{"notes":"Wire transfer received","payment_method":"bank_transfer","payment_reference":"WIRE-12345"}},"MarketplaceOverview":{"properties":{"datasets":{"items":{"$ref":"#/components/schemas/DatasetStats"},"type":"array","title":"Datasets"},"total_records":{"type":"integer","title":"Total Records"}},"type":"object","required":["datasets","total_records"],"title":"MarketplaceOverview"},"MaterializeVaultResponse":{"properties":{"vault":{"additionalProperties":{"type":"string"},"type":"object","title":"Vault"},"file_count":{"type":"integer","title":"File Count"},"note_count":{"type":"integer","title":"Note Count"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"project_scoping_honored":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Project Scoping Honored","description":"False when a requested project_id did NOT narrow the entity set (the result is the caller's whole cross-project set). Absent when no project_id was requested, or once scoping is real. Refs core#9432, core#9439."},"project_scoping_warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Scoping Warning","description":"Human-readable explanation, present only alongside project_scoping_honored=False."}},"additionalProperties":true,"type":"object","required":["file_count","note_count"],"title":"MaterializeVaultResponse","description":"Response for POST /memory/v2/graph/vault-ld/materialize.\n\n``vault`` is an open-ended ``{relative_path: file_text}`` map — dynamic\nkeys, so ``Dict[str, str]`` and never a typed sub-model."},"McpConnectionsStubResponse":{"properties":{"connections":{"items":{},"type":"array","title":"Connections"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["connections","total","message"],"title":"McpConnectionsStubResponse","description":"Response for GET /mcp/connections."},"McpRequest":{"properties":{"tool":{"type":"string","title":"Tool","description":"Tool name to invoke (see get_data_room_index)"},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments","description":"Optional tool arguments (reserved)"}},"type":"object","required":["tool"],"title":"McpRequest"},"McpToolResponse":{"properties":{"tool":{"type":"string","title":"Tool"},"tier":{"type":"integer","title":"Tier"},"data":{"title":"Data"}},"type":"object","required":["tool","tier","data"],"title":"McpToolResponse","description":"Envelope for POST /mcp. `data`'s inner shape is genuinely\ntool-dependent (static roster/traction copy, live financials, or\ngenerated formation-doc links) so it is intentionally left as Any\nrather than a single invented shape."},"MediaModelInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"category":{"type":"string","title":"Category"},"provider":{"type":"string","title":"Provider"},"cost_credits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cost Credits"},"description":{"type":"string","title":"Description"},"tier":{"type":"string","title":"Tier","default":"standard"}},"type":"object","required":["id","name","category","provider","description"],"title":"MediaModelInfo","description":"Model information for the /models endpoint"},"MediaModelsListResponse":{"properties":{"models":{"items":{"$ref":"#/components/schemas/MediaModelInfo"},"type":"array","title":"Models"},"total":{"type":"integer","title":"Total"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"}},"type":"object","required":["models","total","categories"],"title":"MediaModelsListResponse"},"MediaMusicResponse":{"properties":{"audio_base64":{"type":"string","title":"Audio Base64","description":"Base64-encoded audio data"},"duration_seconds":{"type":"number","title":"Duration Seconds","description":"Duration of generated music in seconds"},"cost_credits":{"type":"integer","title":"Cost Credits","description":"Credits charged (with 100% markup)"},"format":{"type":"string","title":"Format","description":"Audio format (mp3 for MiniMax, wav for HuggingFace)"},"prompt":{"type":"string","title":"Prompt","description":"Prompt used for generation"}},"additionalProperties":true,"type":"object","required":["audio_base64","duration_seconds","cost_credits","format","prompt"],"title":"MediaMusicResponse","description":"POST /generate/music. Built inline by this module's handler, identical\nfield-for-field to audio.py's MusicResponse."},"MediaSpeechSimpleResponse":{"properties":{"audio_base64":{"type":"string","title":"Audio Base64","description":"Base64-encoded MP3 audio"},"duration_seconds":{"type":"number","title":"Duration Seconds","description":"Duration of generated audio in seconds"},"cost_credits":{"type":"integer","title":"Cost Credits","description":"Credits charged"},"format":{"type":"string","title":"Format","description":"Audio format (mp3)"}},"additionalProperties":true,"type":"object","required":["audio_base64","duration_seconds","cost_credits","format"],"title":"MediaSpeechSimpleResponse","description":"Second shape of POST /generate/speech.\n\nThe non-minimax (facebook-mms / AudioModel-backed) branch builds its own\ndict with duration in SECONDS and a cost_credits field, where the\nMultimodalService branch reports duration_ms plus usage_id/credits_*.\nTwo genuinely different payloads, so the route is typed as a Union rather\nthan flattened into one over-wide optional model -- flattening would\nadvertise usage_id/credits_remaining on a branch that never sets them.\n\nField-for-field identical to audio.py's TTSResponse."},"MediaUsageRecord":{"properties":{"id":{"type":"string","title":"Id"},"endpoint_type":{"type":"string","title":"Endpoint Type"},"credits_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Used"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","endpoint_type"],"title":"MediaUsageRecord"},"MediaUsageResponse":{"properties":{"usage_records":{"items":{"$ref":"#/components/schemas/MediaUsageRecord"},"type":"array","title":"Usage Records"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["usage_records","total","skip","limit"],"title":"MediaUsageResponse"},"MemberActionResponse":{"properties":{"message":{"type":"string","title":"Message"},"organization_id":{"type":"string","title":"Organization Id"},"member_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Member Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},"type":"object","required":["message","organization_id"],"title":"MemberActionResponse","example":{"member_id":"member-456","message":"Member operation completed successfully","organization_id":"org-123"}},"MemberAdd":{"properties":{"user_id":{"type":"string","title":"User Id","description":"User ID to add as member","examples":["a9b717be-f449-43c6-abb4-18a1a6a0c70e"]},"role":{"$ref":"#/components/schemas/TenantRole","description":"Member role","default":"MEMBER","examples":["ADMIN"]},"permissions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissions","description":"Custom permissions for the member"}},"type":"object","required":["user_id"],"title":"MemberAdd","description":"Schema for adding a member to tenant","examples":[{"role":"ADMIN","user_id":"a9b717be-f449-43c6-abb4-18a1a6a0c70e"}]},"MemberAddRequest":{"properties":{"user_id":{"type":"string","title":"User Id"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","default":"member"}},"type":"object","required":["user_id"],"title":"MemberAddRequest","example":{"role":"admin","user_id":"user-123"}},"MemberResponse":{"properties":{"user_id":{"type":"string","title":"User Id","description":"User ID"},"tenant_id":{"type":"string","title":"Tenant Id","description":"Tenant ID"},"role":{"type":"string","title":"Role","description":"Member role"},"joined_at":{"type":"string","format":"date-time","title":"Joined At","description":"When member was added"}},"type":"object","required":["user_id","tenant_id","role","joined_at"],"title":"MemberResponse","description":"Schema for single member response"},"MemberRoleUpdate":{"properties":{"role":{"$ref":"#/components/schemas/TenantRole","description":"New role for member"}},"type":"object","required":["role"],"title":"MemberRoleUpdate","description":"Schema for updating member role"},"MembersResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CommunityMember"},"type":"array","title":"Data"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["data","total"],"title":"MembersResponse"},"MemoryBatchCreate":{"properties":{"memories":{"items":{"$ref":"#/components/schemas/MemoryCreate"},"type":"array","maxItems":100,"minItems":1,"title":"Memories"}},"type":"object","required":["memories"],"title":"MemoryBatchCreate","description":"MemoryBatchCreate schema","example":{"memories":[{"content":"Use connection pooling for better performance","corpus_names":["project_x"],"tags":["database","performance"],"title":"Database Connection Pooling"},{"content":"Implement rate limiting for all external APIs","corpus_names":["project_x"],"tags":["api","security"],"title":"API Rate Limiting"}]}},"MemoryBatchCreateResponse":{"properties":{"ids":{"items":{"type":"string"},"type":"array","title":"Ids","description":"IDs of the newly created memories"},"count":{"type":"integer","title":"Count","description":"Number of memories created"},"success":{"type":"boolean","title":"Success"}},"type":"object","required":["ids","count","success"],"title":"MemoryBatchCreateResponse","description":"Response for POST /memory/batch."},"MemoryConsumer":{"properties":{"type_name":{"type":"string","title":"Type Name"},"count":{"type":"integer","title":"Count"},"size_bytes":{"type":"integer","title":"Size Bytes"}},"type":"object","required":["type_name","count","size_bytes"],"title":"MemoryConsumer"},"MemoryContextEntry":{"properties":{"id":{"type":"string","title":"Id"},"content":{"type":"string","title":"Content"},"role":{"type":"string","title":"Role"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"},"relevance_score":{"type":"number","title":"Relevance Score"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","content","role","relevance_score","metadata"],"title":"MemoryContextEntry"},"MemoryContextResponse":{"properties":{"context":{"items":{"$ref":"#/components/schemas/MemoryContextEntry"},"type":"array","title":"Context"},"total_tokens":{"type":"integer","title":"Total Tokens"},"max_tokens":{"type":"integer","title":"Max Tokens"},"session_id":{"type":"string","title":"Session Id"}},"type":"object","required":["context","total_tokens","max_tokens","session_id"],"title":"MemoryContextResponse"},"MemoryCountResponse":{"properties":{"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"},"namespaces":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Namespaces"}},"type":"object","title":"MemoryCountResponse","description":"Either a single-namespace count OR an all-namespaces breakdown,\nmatching count_memories()'s two branches — all fields Optional so one\nmodel covers both without implying either is always present."},"MemoryCreate":{"properties":{"title":{"type":"string","title":"Title","description":"Title of the memory"},"content":{"type":"string","title":"Content","description":"Content of the memory"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Tags associated with the memory"},"corpus_names":{"items":{"type":"string"},"type":"array","title":"Corpus Names","description":"Corpus names this memory belongs to"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata about the memory"},"is_pinned":{"type":"boolean","title":"Is Pinned","description":"Whether the memory is pinned","default":false}},"type":"object","required":["title","content"],"title":"MemoryCreate","description":"Schema for memory creation requests\n\nProvides validation for incoming memory creation data","example":{"content":"The database connection should be configured with connection pooling for better performance","corpus_names":["project_x"],"is_pinned":true,"metadata":{"line":42,"source_file":"database.py"},"tags":["database","performance","insight"],"title":"Important Code Insight"}},"MemoryCreateRequest":{"properties":{"content":{"type":"string","title":"Content"},"memory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Type","default":"general"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","default":[]},"priority":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Priority","default":5},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"}},"type":"object","required":["content"],"title":"MemoryCreateRequest"},"MemoryCreateResponse":{"properties":{"id":{"type":"string","title":"Id","description":"ID of the newly created memory"},"success":{"type":"boolean","title":"Success"}},"type":"object","required":["id","success"],"title":"MemoryCreateResponse","description":"Response for POST /memory/."},"MemoryEntry":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Memory ID"},"content":{"type":"string","title":"Content","description":"Memory content"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Memory metadata"},"relevance_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Relevance Score","description":"Relevance score (0-1)"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"}},"type":"object","required":["id","content","metadata","created_at"],"title":"MemoryEntry","description":"Single memory entry in responses"},"MemoryHistoryEntry":{"properties":{"id":{"type":"string","title":"Id","description":"History entry ID"},"memory_id":{"type":"string","title":"Memory Id","description":"ID of the memory that was accessed"},"action_type":{"type":"string","title":"Action Type","description":"Action type: create, access, update, or delete"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","description":"ISO timestamp of the action"},"memory_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Title","description":"Title of the memory, if it still exists"}},"type":"object","required":["id","memory_id","action_type"],"title":"MemoryHistoryEntry","description":"A single memory access/modification history entry."},"MemoryIsolationEvidence":{"properties":{"namespaces_active":{"type":"integer","title":"Namespaces Active"}},"type":"object","required":["namespaces_active"],"title":"MemoryIsolationEvidence"},"MemoryItem":{"properties":{"content":{"type":"string","maxLength":5000,"minLength":1,"title":"Content"},"memory_type":{"type":"string","title":"Memory Type","default":"auto"},"entities":{"items":{"type":"string"},"type":"array","title":"Entities"}},"type":"object","required":["content"],"title":"MemoryItem"},"MemoryMetrics":{"properties":{"total_gb":{"type":"number","title":"Total Gb"},"available_gb":{"type":"number","title":"Available Gb"},"used_gb":{"type":"number","title":"Used Gb"},"usage_percent":{"type":"number","title":"Usage Percent"},"cached_gb":{"type":"number","title":"Cached Gb"}},"type":"object","required":["total_gb","available_gb","used_gb","usage_percent","cached_gb"],"title":"MemoryMetrics"},"MemoryMutationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"id":{"type":"string","title":"Id","description":"ID of the affected memory"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","id","message"],"title":"MemoryMutationResponse","description":"Response for PUT and DELETE /memory/{memory_id}."},"MemoryOperationResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Operation success status"},"memory_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Memory Id","description":"Created/updated memory ID"},"message":{"type":"string","title":"Message","description":"Operation message"}},"type":"object","required":["success","message"],"title":"MemoryOperationResponse","description":"Generic success response for memory operations"},"MemoryOperations":{"properties":{"remember":{"type":"integer","title":"Remember","default":0},"recall":{"type":"integer","title":"Recall","default":0},"forget":{"type":"integer","title":"Forget","default":0}},"type":"object","title":"MemoryOperations","description":"Counts of memory operations by type."},"MemoryProfileResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"rss_mb":{"type":"number","title":"Rss Mb"},"vms_mb":{"type":"number","title":"Vms Mb"},"percent":{"type":"number","title":"Percent"},"top_object_types":{"items":{"$ref":"#/components/schemas/MemoryConsumer"},"type":"array","title":"Top Object Types"},"tracemalloc_top":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tracemalloc Top"},"sqlalchemy_pool":{"additionalProperties":true,"type":"object","title":"Sqlalchemy Pool"},"gc_counts":{"items":{"type":"integer"},"type":"array","title":"Gc Counts"},"alert_level":{"type":"string","title":"Alert Level"}},"type":"object","required":["timestamp","rss_mb","vms_mb","percent","top_object_types","tracemalloc_top","sqlalchemy_pool","gc_counts","alert_level"],"title":"MemoryProfileResponse"},"MemoryRecordCreate":{"properties":{"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id","description":"MCP agent identifier"},"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"Message role (system/user/assistant)"},"content":{"type":"string","title":"Content","description":"Memory content"},"memory_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Memory Metadata","description":"Memory metadata"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"Project ID (set automatically)"},"embedding":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Embedding","description":"Content embedding"}},"type":"object","required":["content"],"title":"MemoryRecordCreate","description":"Schema for creating memory records"},"MemoryRecordResponse":{"properties":{"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id","description":"MCP agent identifier"},"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"Message role (system/user/assistant)"},"content":{"type":"string","title":"Content","description":"Memory content"},"memory_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Memory Metadata","description":"Memory metadata"},"memory_id":{"type":"string","format":"uuid","title":"Memory Id","description":"Unique identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Unique identifier"},"embedding":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Embedding"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"}},"type":"object","required":["content","memory_id","project_id","embedding","created_at"],"title":"MemoryRecordResponse","description":"Complete memory record response schema"},"MemoryRoleStats":{"properties":{"count":{"type":"integer","title":"Count"},"tokens":{"type":"integer","title":"Tokens"}},"type":"object","required":["count","tokens"],"title":"MemoryRoleStats"},"MemorySearch":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Query text for semantic search"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Filter by tags"},"corpus_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Corpus Names","description":"Filter by corpus names"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Maximum number of results to return","default":10}},"type":"object","title":"MemorySearch","description":"MemorySearch schema","example":{"corpus_names":["project_x"],"limit":5,"query":"database connection pooling","tags":["database","performance"]}},"MemorySearchFilters":{"properties":{"hackathon_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Hackathon Id","description":"Filter by hackathon"},"preference_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preference Type","description":"Filter by preference type"},"workflow_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Type","description":"Filter by workflow type"}},"type":"object","title":"MemorySearchFilters","description":"Filters for memory search"},"MemorySessionDetail":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"status":{"type":"string","title":"Status"},"message_count":{"type":"integer","title":"Message Count"},"context_size":{"type":"integer","title":"Context Size"}},"type":"object","required":["id","agent_id","status","message_count","context_size"],"title":"MemorySessionDetail"},"MemorySessionsListResponse":{"properties":{"sessions":{"items":{"$ref":"#/components/schemas/MemorySessionDetail"},"type":"array","title":"Sessions"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["sessions","total","page","page_size"],"title":"MemorySessionsListResponse"},"MemoryStatisticsResponse":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"tags_count":{"additionalProperties":{"type":"integer"},"type":"object","title":"Tags Count","description":"Dictionary of items"},"corpus_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Corpus Counts","description":"Dictionary of items"},"recent_count":{"type":"integer","title":"Recent Count"},"frequently_accessed":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Frequently Accessed","description":"List of items"},"recently_created":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recently Created","description":"List of items"},"recently_accessed":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recently Accessed","description":"List of items"},"storage_usage":{"additionalProperties":true,"type":"object","title":"Storage Usage","description":"Dictionary of items"}},"type":"object","required":["total_count","recent_count"],"title":"MemoryStatisticsResponse","description":"MemoryStatisticsResponse schema","example":{"corpus_counts":{"documentation":22,"project_x":20},"frequently_accessed":[{"access_count":25,"id":"123e4567-e89b-12d3-a456-426614174000","title":"Database Best Practices"}],"recent_count":5,"recently_accessed":[{"id":"123e4567-e89b-12d3-a456-426614174002","last_accessed_at":"2025-04-22T15:45:00Z","title":"Code Review Guidelines"}],"recently_created":[{"created_at":"2025-04-22T14:30:00Z","id":"123e4567-e89b-12d3-a456-426614174001","title":"API Authentication"}],"storage_usage":{"average_memory_size":29762,"total_bytes":1250000},"tags_count":{"database":15,"performance":8},"total_count":42}},"MemoryStatsResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"total_memories":{"type":"integer","title":"Total Memories"},"total_tokens":{"type":"integer","title":"Total Tokens"},"total_size_bytes":{"type":"integer","title":"Total Size Bytes"},"by_role":{"additionalProperties":{"$ref":"#/components/schemas/MemoryRoleStats"},"type":"object","title":"By Role"},"context_window_usage":{"type":"number","title":"Context Window Usage"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Updated"}},"type":"object","required":["session_id","total_memories","total_tokens","total_size_bytes","by_role","context_window_usage"],"title":"MemoryStatsResponse"},"MemoryTagResponse":{"properties":{"tag_name":{"type":"string","title":"Tag Name"},"usage_count":{"type":"integer","title":"Usage Count"}},"type":"object","required":["tag_name","usage_count"],"title":"MemoryTagResponse","description":"MemoryTagResponse schema"},"MemoryUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"corpus_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Corpus Names"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"is_pinned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Pinned"}},"type":"object","title":"MemoryUpdate","description":"MemoryUpdate schema","example":{"content":"Updated memory content with more details","corpus_names":["project_x","documentation"],"is_pinned":true,"metadata":{"importance":"high","updated_by":"user123"},"tags":["updated","important","memory"],"title":"Updated Memory Title"}},"MemoryUpdateRequest":{"properties":{"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"memory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Type"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"priority":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Priority"}},"type":"object","title":"MemoryUpdateRequest"},"MercuryAccountStatus":{"properties":{"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"},"account_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Kind"},"current_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Balance"},"available_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Available Balance"},"status":{"type":"string","title":"Status","description":"active | stale"},"last_synced_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Synced At"}},"type":"object","required":["status"],"title":"MercuryAccountStatus"},"MercuryConnectionResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"status":{"type":"string","title":"Status","description":"connected | expired | disconnected | error | manual"},"needs_reconnect":{"type":"boolean","title":"Needs Reconnect","default":false},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nickname"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"accounts":{"items":{"$ref":"#/components/schemas/MercuryAccountStatus"},"type":"array","title":"Accounts"},"initial_sync_status":{"type":"string","title":"Initial Sync Status","description":"State of the one-time full-history backfill kicked off by /connect: pending | complete | failed | disconnected. Poll this after connecting -- /connect returns before the history lands (Refs #7619).","default":"disconnected"},"initial_sync_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Initial Sync Error","description":"Why the initial backfill failed, if it did."},"last_synced_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Synced At"}},"type":"object","required":["org_id","status"],"title":"MercuryConnectionResponse"},"MergeEntitiesResponse":{"properties":{"merged_entity":{"$ref":"#/components/schemas/MergedEntity"},"entities_merged":{"type":"integer","title":"Entities Merged"},"edges_repointed":{"type":"integer","title":"Edges Repointed"},"canonical":{"type":"string","title":"Canonical"},"canonical_id":{"type":"string","title":"Canonical Id"},"merged":{"items":{"type":"string"},"type":"array","title":"Merged"},"merged_count":{"type":"integer","title":"Merged Count"}},"type":"object","required":["merged_entity","entities_merged","edges_repointed","canonical","canonical_id","merged_count"],"title":"MergeEntitiesResponse","description":"Response for POST /memory/v2/graph/entity/merge"},"MergeIdentityRequest":{"properties":{"temp_api_key":{"type":"string","title":"Temp Api Key","description":"The tmp_ API key from the temp identity"}},"type":"object","required":["temp_api_key"],"title":"MergeIdentityRequest"},"MergeIdentityResponse":{"properties":{"status":{"type":"string","title":"Status"},"temp_user_id":{"type":"string","title":"Temp User Id"},"projects_transferred":{"type":"integer","title":"Projects Transferred"},"keys_transferred":{"type":"integer","title":"Keys Transferred"}},"additionalProperties":true,"type":"object","required":["status","temp_user_id","projects_transferred","keys_transferred"],"title":"MergeIdentityResponse","description":"POST /auth/merge-identity — result of migrating a temp InstantDB\nidentity's projects/keys into the authenticated user's account (Refs #5029)."},"MergeRequest":{"properties":{"canonical":{"type":"string","title":"Canonical","description":"Canonical entity name to keep"},"merge":{"items":{"type":"string"},"type":"array","title":"Merge","description":"Entity names to merge into canonical"}},"type":"object","required":["canonical","merge"],"title":"MergeRequest"},"MergedEntity":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"canonical_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Name"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"},"memory_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Count"}},"type":"object","title":"MergedEntity"},"MessageCreate":{"properties":{"sender_agent_id":{"type":"string","title":"Sender Agent Id"},"recipient_agent_id":{"type":"string","title":"Recipient Agent Id"},"project_id":{"type":"string","title":"Project Id"},"message":{"type":"string","title":"Message"},"message_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message Type"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["sender_agent_id","recipient_agent_id","project_id","message"],"title":"MessageCreate"},"MessageReadRequest":{"properties":{"thread_id":{"type":"string","format":"uuid","title":"Thread Id","description":"UUID of the message thread"}},"type":"object","required":["thread_id"],"title":"MessageReadRequest","description":"Request to mark a message as read"},"MessageReadResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"receipt_id":{"type":"string","title":"Receipt Id"}},"type":"object","required":["success","message","receipt_id"],"title":"MessageReadResponse","description":"Response after marking message as read"},"MessageRole":{"type":"string","enum":["user","assistant","system","tool"],"title":"MessageRole","description":"Valid message roles in a transcript."},"MessageUnreadRequest":{"properties":{"thread_id":{"type":"string","format":"uuid","title":"Thread Id","description":"UUID of the message thread"},"message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Message Id","description":"Optional UUID of message to reset to. If None, marks all as unread"}},"type":"object","required":["thread_id"],"title":"MessageUnreadRequest","description":"Request to mark a message as unread"},"MessagesListResponse":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/app__api__api_v1__endpoints__agent_coordination__MessageResponse"},"type":"array","title":"Messages"},"total":{"type":"integer","title":"Total"},"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["messages","total","offset","limit"],"title":"MessagesListResponse","example":{"limit":50,"messages":[{"created_at":"2025-01-01T00:00:00Z","id":"msg-123","message":"Task completed successfully","message_type":"task_update","metadata":{"status":"completed"},"project_id":"project-101","read_status":false,"recipient_agent_id":"agent-789","sender_agent_id":"agent-456"}],"offset":0,"total":1}},"MessagesResponse":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__serviceos_public__ChatMessage"},"type":"array","title":"Messages"},"conversation_id":{"type":"string","title":"Conversation Id"}},"type":"object","required":["messages","conversation_id"],"title":"MessagesResponse"},"MetadataTrackingRequest":{"properties":{"file_path":{"type":"string","title":"File Path","description":"Path to the file"},"project_id":{"type":"string","title":"Project Id","description":"ID of the project"},"content":{"type":"string","title":"Content","description":"File content"},"author":{"type":"string","title":"Author","description":"Author of the change"},"commit_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commit Id","description":"Optional commit ID"}},"type":"object","required":["file_path","project_id","content","author"],"title":"MetadataTrackingRequest"},"MetricScalingPolicy":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"metric":{"type":"string","title":"Metric"},"scale_up":{"$ref":"#/components/schemas/PolicyThreshold"},"scale_down":{"anyOf":[{"$ref":"#/components/schemas/PolicyThreshold"},{"type":"null"}]}},"type":"object","required":["enabled","metric","scale_up"],"title":"MetricScalingPolicy"},"MetricTimeSeries":{"properties":{"timestamps":{"items":{"type":"string"},"type":"array","title":"Timestamps"},"values":{"items":{"type":"number"},"type":"array","title":"Values"},"unit":{"type":"string","title":"Unit"},"average":{"type":"number","title":"Average"},"max":{"type":"number","title":"Max"},"min":{"type":"number","title":"Min"}},"type":"object","required":["timestamps","values","unit","average","max","min"],"title":"MetricTimeSeries"},"MetricsCollectionMetadata":{"properties":{"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","description":"Metrics payload version"},"service":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service","description":"Emitting service name"},"collection_duration_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Collection Duration Ms","description":"Wall-clock collection time in milliseconds"}},"additionalProperties":true,"type":"object","title":"MetricsCollectionMetadata","description":"`collection_metadata` block of the comprehensive metrics payload."},"MetricsExportRequest":{"properties":{"format":{"$ref":"#/components/schemas/MetricsFormat","description":"Export format","default":"json"},"time_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Range","description":"Time range for metrics (1h, 24h, 7d)","default":"1h"},"include_historical":{"type":"boolean","title":"Include Historical","description":"Include historical data","default":false},"services":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Services","description":"Specific services to include"}},"type":"object","title":"MetricsExportRequest","description":"Request model for metrics export"},"MetricsFormat":{"type":"string","enum":["json","prometheus","influxdb"],"title":"MetricsFormat","description":"Supported metrics export formats"},"MigrationStatusResponse":{"properties":{"migration_applied":{"type":"boolean","title":"Migration Applied"},"tables":{"additionalProperties":{"$ref":"#/components/schemas/MigrationTableStatus"},"type":"object","title":"Tables"},"endpoints_operational":{"type":"boolean","title":"Endpoints Operational"}},"type":"object","required":["migration_applied","tables","endpoints_operational"],"title":"MigrationStatusResponse","description":"Response for GET /admin/run-migration/migration-status."},"MigrationTableStatus":{"properties":{"exists":{"type":"boolean","title":"Exists"},"row_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Row Count"}},"type":"object","required":["exists"],"title":"MigrationTableStatus"},"MinimalProfileData":{"properties":{"id":{"type":"string","title":"Id"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"profile_visibility":{"type":"string","title":"Profile Visibility","default":"public"},"message":{"type":"string","title":"Message","default":"This profile is private"}},"type":"object","required":["id"],"title":"MinimalProfileData","description":"Minimal profile payload returned by ProfileService._get_minimal_profile()\nfor viewers not authorized to see the full profile (e.g. private profile\nviewed by a non-friend). Refs #2191."},"MissPattern":{"properties":{"pattern":{"type":"string","title":"Pattern"},"miss_count":{"type":"integer","title":"Miss Count"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["pattern","miss_count","reason"],"title":"MissPattern"},"ModelBreakdown":{"properties":{"model":{"type":"string","title":"Model"},"request_count":{"type":"integer","title":"Request Count"},"credits":{"type":"number","title":"Credits"}},"type":"object","required":["model","request_count","credits"],"title":"ModelBreakdown","description":"Per-model (endpoint_category) aggregate."},"ModelBreakdownResponse":{"properties":{"period":{"type":"string","title":"Period"},"models":{"items":{"$ref":"#/components/schemas/ModelMetrics"},"type":"array","title":"Models"}},"type":"object","required":["period","models"],"title":"ModelBreakdownResponse"},"ModelCapabilities":{"properties":{"intelligence":{"type":"integer","title":"Intelligence"},"speed":{"type":"integer","title":"Speed"},"cost":{"type":"integer","title":"Cost"}},"type":"object","required":["intelligence","speed","cost"],"title":"ModelCapabilities"},"ModelCapabilityEnum":{"type":"string","enum":["code_chat","code_explanation","code_completion","code_review","refactoring","debugging","chat","completion","text_generation","embedding","function_calling","vision","analysis","vector_search","image-generation","text-to-image","image-editing","video-generation","image-to-video","text-to-video","audio-transcription","audio-translation","text-to-speech","music-generation","speech-synthesis"],"title":"ModelCapabilityEnum","description":"Model capability enum for API schemas"},"ModelCatalogResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"models":{"items":{"$ref":"#/components/schemas/ModelEntry"},"type":"array","title":"Models"}},"type":"object","required":["ok","models"],"title":"ModelCatalogResponse"},"ModelDistributionEntry":{"properties":{"model":{"type":"string","title":"Model","description":"Model name"},"requests":{"type":"integer","title":"Requests","description":"Number of requests"},"percentage":{"type":"number","title":"Percentage","description":"Percentage of total requests"}},"type":"object","required":["model","requests","percentage"],"title":"ModelDistributionEntry","description":"Model usage statistics"},"ModelDistributionResponse":{"properties":{"total_requests":{"type":"integer","title":"Total Requests","description":"Total requests in period"},"models":{"items":{"$ref":"#/components/schemas/ModelDistributionEntry"},"type":"array","title":"Models","description":"Model usage statistics (sorted by request count descending)"}},"type":"object","required":["total_requests","models"],"title":"ModelDistributionResponse","description":"Model distribution statistics response","example":{"models":[{"model":"llama-3.3-70b-instruct","percentage":69,"requests":100},{"model":"llama-3.3-8b-instruct","percentage":31,"requests":45}],"total_requests":145}},"ModelEntry":{"properties":{"id":{"type":"string","title":"Id"},"provider":{"type":"string","title":"Provider"},"backend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backend"},"label":{"type":"string","title":"Label"},"capabilities":{"$ref":"#/components/schemas/ModelCapabilities"},"context_window":{"type":"integer","title":"Context Window"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"tier":{"type":"string","title":"Tier"},"pricing":{"$ref":"#/components/schemas/ModelPricing"}},"type":"object","required":["id","provider","label","capabilities","context_window","tags","tier","pricing"],"title":"ModelEntry"},"ModelMetrics":{"properties":{"model":{"type":"string","title":"Model"},"provider":{"type":"string","title":"Provider"},"request_count":{"type":"integer","title":"Request Count"},"total_tokens":{"type":"integer","title":"Total Tokens"},"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_cost_usd":{"type":"number","title":"Total Cost Usd"},"avg_latency_ms":{"type":"number","title":"Avg Latency Ms"},"error_count":{"type":"integer","title":"Error Count"}},"type":"object","required":["model","provider","request_count","total_tokens","prompt_tokens","completion_tokens","total_cost_usd","avg_latency_ms","error_count"],"title":"ModelMetrics"},"ModelOption":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"category":{"type":"string","title":"Category"},"context_window":{"type":"integer","title":"Context Window"},"max_output_tokens":{"type":"integer","title":"Max Output Tokens"},"plan_required":{"type":"string","title":"Plan Required"},"supports_tools":{"type":"boolean","title":"Supports Tools"},"supports_streaming":{"type":"boolean","title":"Supports Streaming"}},"type":"object","required":["id","name","category","context_window","max_output_tokens","plan_required","supports_tools","supports_streaming"],"title":"ModelOption","description":"A single model available in the platform catalog."},"ModelPricing":{"properties":{"input":{"type":"number","title":"Input"},"output":{"type":"number","title":"Output"},"cache_read":{"type":"number","title":"Cache Read"}},"type":"object","required":["input","output","cache_read"],"title":"ModelPricing"},"ModelRecommendation":{"properties":{"recommended_model_id":{"type":"string","title":"Recommended Model Id"},"rationale":{"type":"string","title":"Rationale"},"estimated_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Tokens"},"alternatives":{"items":{"$ref":"#/components/schemas/Alternative"},"type":"array","title":"Alternatives"},"upgrade_alternatives":{"items":{"$ref":"#/components/schemas/UpgradeAlternative"},"type":"array","title":"Upgrade Alternatives"}},"type":"object","required":["recommended_model_id","rationale"],"title":"ModelRecommendation"},"ModelStatsResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"total":{"type":"integer","title":"Total"},"by_tier":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Tier"},"by_tag":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Tag"}},"type":"object","required":["ok","total","by_tier","by_tag"],"title":"ModelStatsResponse"},"ModelUsageItem":{"properties":{"model":{"type":"string","title":"Model"},"provider":{"type":"string","title":"Provider"},"request_count":{"type":"integer","title":"Request Count"},"total_tokens":{"type":"integer","title":"Total Tokens"},"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"cost_usd":{"type":"number","title":"Cost Usd"}},"type":"object","required":["model","provider","request_count","total_tokens","prompt_tokens","completion_tokens","cost_usd"],"title":"ModelUsageItem"},"ModelVersionCreate":{"properties":{"version":{"type":"string","title":"Version","description":"Semantic version number (MAJOR.MINOR.PATCH)","example":"1.0.0"},"description":{"type":"string","title":"Description","description":"Description of this model version","example":"Initial production release"},"change_log":{"type":"string","title":"Change Log","description":"Changes introduced in this version","example":"First stable release with all core features"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters","description":"Model parameters for this version","example":{"max_tokens":1024,"temperature":0.7}},"model_id":{"type":"string","format":"uuid","title":"Model Id","description":"ID of the AI model this version belongs to","example":"123e4567-e89b-12d3-a456-426614174000"}},"type":"object","required":["version","description","change_log","parameters","model_id"],"title":"ModelVersionCreate","description":"Schema for creating a new model version"},"ModelVersionCreateSchema":{"properties":{"version":{"type":"string","title":"Version","description":"Semantic version string (MAJOR.MINOR.PATCH)"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the model version"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"Configuration for this version","default":{}},"active":{"type":"boolean","title":"Active","description":"Whether this version is active","default":false},"deprecated":{"type":"boolean","title":"Deprecated","description":"Whether this version is deprecated","default":false},"release_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release Notes","description":"Release notes for this version"},"model_id":{"type":"string","title":"Model Id","description":"ID of the AI model this version belongs to"}},"type":"object","required":["version","model_id"],"title":"ModelVersionCreateSchema","description":"Schema for creating a new model version","example":{"active":true,"config":{"max_tokens":2048,"temperature":0.7},"description":"Initial stable release","model_id":"550e8400-e29b-41d4-a716-446655440000","release_notes":"Initial stable release with basic code completion","version":"1.0.0"}},"ModelVersionRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique identifier for this version","example":"123e4567-e89b-12d3-a456-426614174000"},"model_id":{"type":"string","format":"uuid","title":"Model Id","description":"ID of the AI model this version belongs to","example":"123e4567-e89b-12d3-a456-426614174000"},"version":{"type":"string","title":"Version","description":"Semantic version number (MAJOR.MINOR.PATCH)","example":"1.0.0"},"description":{"type":"string","title":"Description","description":"Description of this model version","example":"Initial production release"},"change_log":{"type":"string","title":"Change Log","description":"Changes introduced in this version","example":"First stable release with all core features"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters","description":"Model parameters for this version","example":{"max_tokens":1024,"temperature":0.7}},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When this version was created","example":"2023-01-01T00:00:00Z"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"When this version was last updated","example":"2023-01-02T00:00:00Z"},"is_active":{"type":"boolean","title":"Is Active","description":"Whether this version is active","example":true}},"type":"object","required":["id","model_id","version","description","change_log","parameters","created_at","updated_at","is_active"],"title":"ModelVersionRead","description":"Schema for reading a model version"},"ModelVersionReadSchema":{"properties":{"version":{"type":"string","title":"Version","description":"Semantic version string (MAJOR.MINOR.PATCH)"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the model version"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"Configuration for this version","default":{}},"active":{"type":"boolean","title":"Active","description":"Whether this version is active","default":false},"deprecated":{"type":"boolean","title":"Deprecated","description":"Whether this version is deprecated","default":false},"release_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release Notes","description":"Release notes for this version"},"id":{"type":"string","title":"Id","description":"Unique identifier for the model version"},"model_id":{"type":"string","title":"Model Id","description":"ID of the AI model this version belongs to"},"major":{"type":"integer","title":"Major","description":"Major version number"},"minor":{"type":"integer","title":"Minor","description":"Minor version number"},"patch":{"type":"integer","title":"Patch","description":"Patch version number"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Time when the version was created"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Time when the version was last updated"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By","description":"User who created this version"}},"type":"object","required":["version","id","model_id","major","minor","patch","created_at"],"title":"ModelVersionReadSchema","description":"Schema for reading a model version"},"ModelVersionUpdate":{"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Updated description of this model version","example":"Improved production release"},"change_log":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Log","description":"Updated change log for this version","example":"Fixed stability issues and improved performance"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters","description":"Updated model parameters for this version","example":{"max_tokens":2048,"temperature":0.8}},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active","description":"Whether this version is active","example":true}},"type":"object","title":"ModelVersionUpdate","description":"ModelVersionUpdate schema"},"ModelVersionUpdateSchema":{"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the model version"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"Configuration for this version"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active","description":"Whether this version is active"},"deprecated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Deprecated","description":"Whether this version is deprecated"},"release_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release Notes","description":"Release notes for this version"}},"type":"object","title":"ModelVersionUpdateSchema","description":"\u0001"},"ModelsListResponse":{"properties":{"models":{"items":{"$ref":"#/components/schemas/AIModelReadSchema"},"type":"array","title":"Models","description":"Array of AI model objects"},"total":{"type":"integer","title":"Total","description":"Total number of models"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","description":"Current page number"},"page_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Size","description":"Number of items per page"}},"type":"object","required":["models","total"],"title":"ModelsListResponse","description":"Schema for list of AI models with metadata"},"ModeratePostResponse":{"properties":{"post_id":{"type":"string","title":"Post Id","description":"Post that was moderated"},"moderation_result":{"$ref":"#/components/schemas/ModerationResultDetail","description":"AI moderation verdict"},"current_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Status","description":"Post's moderation status after the call"},"auto_applied":{"type":"boolean","title":"Auto Applied","description":"Whether the verdict was applied to the post"}},"type":"object","required":["post_id","moderation_result","auto_applied"],"title":"ModeratePostResponse","description":"Result of running AI moderation on a post.\n\nTight field set (extra ignored) because this route has no admin gate."},"ModerationActionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"action_taken":{"type":"string","title":"Action Taken"},"affected_resource_id":{"type":"string","format":"uuid","title":"Affected Resource Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["success","message","action_taken","affected_resource_id","timestamp"],"title":"ModerationActionResponse","description":"Response schema for moderation actions"},"ModerationQueueResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ReportResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"ModerationQueueResponse","description":"Response schema for moderation queue"},"ModerationResultDetail":{"properties":{"is_safe":{"type":"boolean","title":"Is Safe","description":"Whether content passed moderation"},"confidence":{"type":"number","title":"Confidence","description":"Model confidence in the verdict"},"flags":{"items":{"type":"string"},"type":"array","title":"Flags","description":"Violation categories detected"},"suggested_status":{"type":"string","title":"Suggested Status","description":"Status the model recommends"},"details":{"additionalProperties":true,"type":"object","title":"Details","description":"Per-category scores"}},"type":"object","required":["is_safe","confidence","flags","suggested_status","details"],"title":"ModerationResultDetail","description":"AI moderation verdict for a single post.\n\nNo extra=\"allow\": see the module-level note — the route returning this is\nreachable by any authenticated tenant member, so its field set is pinned."},"ModerationStatusUpdateResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the override was applied"},"post_id":{"type":"string","title":"Post Id","description":"Post that was updated"},"moderation_status":{"type":"string","title":"Moderation Status","description":"New moderation status"},"moderator_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Moderator Notes","description":"Moderator's note, null when none was supplied"}},"additionalProperties":true,"type":"object","required":["success","post_id","moderation_status"],"title":"ModerationStatusUpdateResponse","description":"Confirmation of a manual admin moderation override.\n\nBuilt by the handler itself (the delegate returns a bare bool).\nmoderator_notes stays Optional and is NOT excluded when unset — it is the\naudit-trail field, so \"no note given\" must serialize as explicit null."},"ModeratorCreate":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User ID to grant moderator/VIP badge"},"badge_type":{"type":"string","title":"Badge Type","description":"Badge type: 'moderator' or 'vip'","default":"moderator"}},"type":"object","required":["user_id"],"title":"ModeratorCreate","description":"Schema for adding a moderator or VIP","example":{"badge_type":"moderator","user_id":"550e8400-e29b-41d4-a716-446655440000"}},"ModeratorListResponse":{"properties":{"moderators":{"items":{"$ref":"#/components/schemas/ModeratorResponse"},"type":"array","title":"Moderators"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Total number of moderators"}},"type":"object","required":["moderators","total"],"title":"ModeratorListResponse","description":"List of moderators for a stream","example":{"moderators":[{"badge_type":"moderator","granted_at":"2025-12-23T14:30:00Z","id":"mod11111-2222-3333-4444-555566667777","user_id":"550e8400-e29b-41d4-a716-446655440000","username":"johndoe"}],"total":1}},"ModeratorResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"username":{"type":"string","title":"Username"},"badge_type":{"type":"string","title":"Badge Type"},"granted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Granted At"}},"type":"object","required":["id","user_id","username","badge_type"],"title":"ModeratorResponse","description":"Schema for moderator response","example":{"badge_type":"moderator","granted_at":"2025-12-23T14:30:00Z","id":"mod11111-2222-3333-4444-555566667777","user_id":"550e8400-e29b-41d4-a716-446655440000","username":"johndoe"}},"MongoQueryRequest":{"properties":{"filter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter","description":"MongoDB-style filter object with operators ($eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $contains, $regex)"},"sort":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Sort","description":"Sort specification {field: 1} for ASC or {field: -1} for DESC"},"limit":{"type":"integer","maximum":10000,"minimum":1,"title":"Limit","description":"Maximum number of results to return (1-10000)","default":50},"skip":{"type":"integer","minimum":0,"title":"Skip","description":"Number of results to skip (for pagination). Accepts both 'skip' and 'offset'.","default":0},"projection":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Projection","description":"Field projection (MongoDB convention). {\"row_data\": 0} excludes row_data from results. Refs #4713"}},"type":"object","title":"MongoQueryRequest","description":"MongoDB-style query request for table rows"},"MongoQueryResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total count of matching rows"},"skip":{"type":"integer","title":"Skip","description":"Number of rows skipped"},"limit":{"type":"integer","title":"Limit","description":"Maximum rows per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more rows are available"},"filter_summary":{"additionalProperties":true,"type":"object","title":"Filter Summary","description":"Summary of applied filters"},"execution_time_ms":{"type":"number","title":"Execution Time Ms","description":"Query execution time in milliseconds"},"data":{"items":{"$ref":"#/components/schemas/ZeroDBRowResponse"},"type":"array","title":"Data","description":"List of matching rows"}},"type":"object","required":["total","skip","limit","has_more","filter_summary","execution_time_ms","data"],"title":"MongoQueryResponse","description":"MongoDB-style query response with pagination metadata"},"MonitoringControlResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"stopped_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stopped At"}},"type":"object","required":["status","message"],"title":"MonitoringControlResponse","description":"Result of starting/stopping the performance monitoring system."},"MonitoringHealthCheckResponse":{"properties":{"monitoring_active":{"type":"boolean","title":"Monitoring Active"},"last_collection":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Collection"},"total_snapshots":{"type":"integer","title":"Total Snapshots"},"total_alerts":{"type":"integer","title":"Total Alerts"},"total_request_metrics":{"type":"integer","title":"Total Request Metrics"},"collection_interval_seconds":{"type":"integer","title":"Collection Interval Seconds"},"memory_usage":{"additionalProperties":{"type":"number"},"type":"object","title":"Memory Usage"},"system_health":{"type":"string","title":"System Health"},"uptime_seconds":{"type":"number","title":"Uptime Seconds"}},"type":"object","required":["monitoring_active","total_snapshots","total_alerts","total_request_metrics","collection_interval_seconds","memory_usage","system_health","uptime_seconds"],"title":"MonitoringHealthCheckResponse","description":"Health check for the performance monitoring system itself."},"MonitoringHealthComponents":{"properties":{"metric_collector":{"$ref":"#/components/schemas/MonitoringHealthMetricCollector"},"database_pool":{"anyOf":[{"$ref":"#/components/schemas/MonitoringHealthDatabasePool"},{"type":"null"}]},"alert_manager":{"$ref":"#/components/schemas/MonitoringHealthNotConfigured"},"notification_system":{"$ref":"#/components/schemas/MonitoringHealthNotConfigured"}},"type":"object","required":["metric_collector","alert_manager","notification_system"],"title":"MonitoringHealthComponents"},"MonitoringHealthDatabasePool":{"properties":{"status":{"type":"string","title":"Status"},"checked_out":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Checked Out"},"checked_in":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Checked In"},"pool_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pool Size"},"overflow":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Overflow"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"data_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Source"}},"type":"object","required":["status"],"title":"MonitoringHealthDatabasePool","description":"REAL -- live SQLAlchemy pool counters (Refs #8270)."},"MonitoringHealthMetricCollector":{"properties":{"status":{"type":"string","title":"Status"},"uptime_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Uptime Seconds"},"registered_metric_families":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Registered Metric Families"},"http_requests_observed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Http Requests Observed"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"data_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Source"}},"type":"object","required":["status"],"title":"MonitoringHealthMetricCollector","description":"REAL -- live Prometheus registry + process uptime (Refs #8270)."},"MonitoringHealthNotConfigured":{"properties":{"status":{"type":"string","title":"Status"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"simulated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Simulated"}},"type":"object","required":["status"],"title":"MonitoringHealthNotConfigured","description":"SIMULATED subsystem -- reports `not_configured` instead of inventing\nhealthy-looking figures (Refs #8270)."},"MonitoringHealthResponse":{"properties":{"overall_status":{"type":"string","title":"Overall Status"},"last_checked":{"type":"string","title":"Last Checked"},"components":{"$ref":"#/components/schemas/MonitoringHealthComponents"},"simulated_components":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Simulated Components","description":"Components reported as not_configured rather than simulated (#8270)."}},"type":"object","required":["overall_status","last_checked","components"],"title":"MonitoringHealthResponse","description":"Response for GET /monitoring/health."},"MonitoringServiceAlertManager":{"properties":{"status":{"type":"string","title":"Status"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"simulated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Simulated"}},"type":"object","required":["status"],"title":"MonitoringServiceAlertManager","description":"SIMULATED -- reports `not_configured` honestly (Refs #8270)."},"MonitoringServiceDatabasePool":{"properties":{"status":{"type":"string","title":"Status"},"checked_out":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Checked Out"},"pool_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pool Size"},"data_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Source"}},"type":"object","required":["status"],"title":"MonitoringServiceDatabasePool","description":"REAL -- live SQLAlchemy pool counters (Refs #8270)."},"MonitoringServiceMetricCollection":{"properties":{"status":{"type":"string","title":"Status"},"last_update":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Update"},"registered_metric_families":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Registered Metric Families"},"http_requests_observed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Http Requests Observed"},"data_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Source"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status"],"title":"MonitoringServiceMetricCollection","description":"REAL -- live Prometheus registry (Refs #8270)."},"MonitoringServicesStatus":{"properties":{"metric_collection":{"$ref":"#/components/schemas/MonitoringServiceMetricCollection"},"database_pool":{"anyOf":[{"$ref":"#/components/schemas/MonitoringServiceDatabasePool"},{"type":"null"}]},"alert_manager":{"$ref":"#/components/schemas/MonitoringServiceAlertManager"}},"type":"object","required":["metric_collection","alert_manager"],"title":"MonitoringServicesStatus"},"MonitoringStatusCurrentDeployment":{"properties":{"deployment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deployment Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","title":"MonitoringStatusCurrentDeployment","description":"Nested ``current_deployment`` block within the monitoring-status response."},"MonthlyBackupSchedule":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"day":{"type":"integer","title":"Day"},"time":{"type":"string","title":"Time"},"last_run":{"type":"string","title":"Last Run"}},"type":"object","required":["enabled","day","time","last_run"],"title":"MonthlyBackupSchedule"},"MultimodalGPUConfig":{"properties":{"runpod_configured":{"type":"boolean","title":"Runpod Configured","description":"Whether RUNPOD_API_KEY is set in this environment"},"cogvideox_endpoint":{"type":"string","title":"Cogvideox Endpoint","description":"RunPod CogVideoX endpoint id"},"api_timeout":{"type":"integer","title":"Api Timeout","description":"GPU API timeout in seconds"},"rate_limit":{"type":"integer","title":"Rate Limit","description":"GPU API rate limit"}},"type":"object","required":["runpod_configured","cogvideox_endpoint","api_timeout","rate_limit"],"title":"MultimodalGPUConfig","description":"GPU/provider configuration reported by the health route."},"MultimodalHealthResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'healthy' when this route responds"},"service":{"type":"string","title":"Service","description":"Service identifier: 'multimodal_gpu'"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO-8601 UTC timestamp of this check"},"endpoints":{"additionalProperties":{"type":"string"},"type":"object","title":"Endpoints","description":"Operation name -> availability ('operational')"},"gpu_config":{"$ref":"#/components/schemas/MultimodalGPUConfig","description":"GPU/provider config"},"provider":{"type":"string","title":"Provider","description":"GPU provider: 'runpod'"},"deployment":{"type":"string","title":"Deployment","description":"Hosting platform: 'railway'"}},"type":"object","required":["status","service","timestamp","endpoints","gpu_config","provider","deployment"],"title":"MultimodalHealthResponse","description":"Health/discovery document for the multimodal GPU service (Refs #8449).\n\nEvery key is unconditionally present — only the VALUES vary with\nenvironment config — so no `response_model_exclude_unset` is needed.\n\n`timestamp` is a plain `str`, NOT a `datetime`: the handler calls\n`.isoformat()` itself, so the value is already a string on the wire, and a\n`datetime` annotation would hand re-serialization to FastAPI and could\nchange the emitted form. `api_timeout`/`rate_limit` are `int` because the\nhandler coerces those env vars with `int(...)`; typing them `str` would\nturn JSON numbers into JSON strings."},"MusicGenerateRequest":{"properties":{"prompt":{"type":"string","maxLength":500,"minLength":1,"title":"Prompt","description":"Music description prompt"},"model":{"type":"string","title":"Model","description":"Model: minimax-music-v2, huggingface-music","default":"minimax-music-v2"},"duration":{"type":"integer","maximum":60,"minimum":5,"title":"Duration","description":"Duration in seconds","default":10}},"type":"object","required":["prompt"],"title":"MusicGenerateRequest","description":"Request schema for music generation"},"MusicRequest":{"properties":{"prompt":{"type":"string","maxLength":500,"minLength":1,"title":"Prompt","description":"Music description"},"model_id":{"type":"string","title":"Model Id","description":"Music generation model ID","default":"minimax-music-v2"},"duration":{"type":"integer","maximum":60,"minimum":5,"title":"Duration","description":"Duration in seconds","default":10}},"type":"object","required":["prompt"],"title":"MusicRequest","description":"Request schema for music generation"},"MusicResponse":{"properties":{"audio_base64":{"type":"string","title":"Audio Base64","description":"Base64-encoded audio data"},"duration_seconds":{"type":"number","title":"Duration Seconds","description":"Duration of generated music"},"cost_credits":{"type":"integer","title":"Cost Credits","description":"Credits charged (with 100% markup)"},"format":{"type":"string","title":"Format","description":"Audio format"},"prompt":{"type":"string","title":"Prompt","description":"Prompt used for generation"}},"type":"object","required":["audio_base64","duration_seconds","cost_credits","format","prompt"],"title":"MusicResponse","description":"Response schema for music generation"},"MyInvoicePaymentIntentResponse":{"properties":{"client_secret":{"type":"string","title":"Client Secret","description":"Stripe Payment Intent client secret"},"invoice_id":{"type":"string","title":"Invoice Id","description":"Invoice ID"},"amount":{"type":"integer","title":"Amount","description":"Amount in cents"},"currency":{"type":"string","title":"Currency","description":"Currency code"}},"type":"object","required":["client_secret","invoice_id","amount","currency"],"title":"MyInvoicePaymentIntentResponse","description":"Schema for POST /me/invoices/{invoice_id}/payment-intent.\n\nNote: unlike app.models.invoice.PaymentIntentResponse (used by the admin\n/invoices/{invoice_id}/payment-intent endpoint), this handler's dict does\nNOT include publishable_key -- the frontend for this customer-facing\nroute is expected to already have the publishable key configured.","example":{"amount":9900,"client_secret":"pi_xxx_secret_yyy","currency":"USD","invoice_id":"550e8400-e29b-41d4-a716-446655440000"}},"MyInvoicePdfResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the PDF is ready"},"pdf_url":{"type":"string","title":"Pdf Url","description":"URL of the (existing or freshly generated) invoice PDF"},"invoice_id":{"type":"string","title":"Invoice Id","description":"Invoice ID"}},"type":"object","required":["success","pdf_url","invoice_id"],"title":"MyInvoicePdfResponse","description":"Schema for GET /me/invoices/{invoice_id}/pdf (no publishable_key, unlike the admin invoice PDF response).","example":{"invoice_id":"550e8400-e29b-41d4-a716-446655440000","pdf_url":"https://storage.example.com/invoices/inv_123.pdf","success":true}},"MyScanRow":{"properties":{"report_id":{"type":"string","title":"Report Id"},"url":{"type":"string","title":"Url"},"score":{"type":"integer","title":"Score"},"grade":{"type":"string","title":"Grade"},"scanned_at":{"type":"string","title":"Scanned At"}},"type":"object","required":["report_id","url","score","grade","scanned_at"],"title":"MyScanRow"},"MyScansResponse":{"properties":{"scans":{"items":{"$ref":"#/components/schemas/MyScanRow"},"type":"array","title":"Scans"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["scans","total","page","page_size"],"title":"MyScansResponse"},"NamedDescriptionEntry":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["name","description"],"title":"NamedDescriptionEntry"},"NamespaceConfigItem":{"properties":{"namespace":{"type":"string","title":"Namespace"},"ttl_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Days"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["namespace","ttl_days","updated_at"],"title":"NamespaceConfigItem"},"NamespaceConfigListResponse":{"properties":{"configs":{"items":{"$ref":"#/components/schemas/NamespaceConfigItem"},"type":"array","title":"Configs"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["configs","total"],"title":"NamespaceConfigListResponse"},"NamespaceConfigRequest":{"properties":{"namespace":{"type":"string","title":"Namespace","description":"Namespace to configure (e.g. 'project:agent-run-logs')"},"ttl_days":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Ttl Days","description":"Days before memories expire. Null = permanent."}},"type":"object","required":["namespace"],"title":"NamespaceConfigRequest"},"NamespaceConfigResponse":{"properties":{"namespace":{"type":"string","title":"Namespace"},"ttl_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Days"},"user_id":{"type":"string","title":"User Id"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["namespace","ttl_days","user_id","updated_at"],"title":"NamespaceConfigResponse"},"NamespaceItem":{"properties":{"name":{"type":"string","title":"Name"},"vector_count":{"type":"integer","title":"Vector Count"},"dimensions":{"type":"integer","title":"Dimensions"},"description":{"type":"string","title":"Description"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["name","vector_count","dimensions","description","created_at","updated_at"],"title":"NamespaceItem"},"NamespacesResponse":{"properties":{"namespaces":{"items":{"$ref":"#/components/schemas/NamespaceItem"},"type":"array","title":"Namespaces"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["namespaces","total"],"title":"NamespacesResponse"},"NativeCreativeResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Creative ID"},"sponsor_id":{"type":"string","title":"Sponsor Id","description":"Sponsor ID"},"type":{"$ref":"#/components/schemas/CreativeType","description":"Creative type","default":"native"},"status":{"$ref":"#/components/schemas/CreativeStatus","description":"Approval status"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"call_to_action":{"type":"string","title":"Call To Action"},"destination_url":{"type":"string","title":"Destination Url"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","description":"Optional native ad image URL"},"sponsor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor Name","description":"Advertiser name"},"sponsor_logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor Logo Url","description":"Sponsor logo URL"},"has_image":{"type":"boolean","title":"Has Image","description":"Whether creative includes image","default":false},"char_count":{"additionalProperties":{"type":"integer"},"type":"object","title":"Char Count","description":"Character counts for text fields"},"reviewed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed By"},"reviewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reviewed At"},"rejection_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rejection Reason"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","sponsor_id","status","title","description","call_to_action","destination_url","char_count","created_at"],"title":"NativeCreativeResponse","description":"Schema for native creative response","example":{"call_to_action":"Start Free Trial","char_count":{"description":76,"title":28},"created_at":"2026-01-05T12:00:00Z","description":"Join 10,000+ developers using ZeroDB for semantic search. Free trial available.","destination_url":"https://ainative.studio/signup","has_image":true,"id":"creative_ghi789","image_url":"https://r2.ainative.studio/ad-creatives/sponsors/spon_xyz789/native/creative_ghi789.png","sponsor_id":"spon_xyz789","sponsor_logo_url":"https://ainative.studio/logo.png","sponsor_name":"AI Native Studio","status":"pending_review","title":"Transform Your AI Development","type":"native"}},"NdaAcceptRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project UUID from the dealroom session"},"roster_id":{"type":"string","title":"Roster Id","description":"NDA roster identifier — must be 'DEALROOM-NDA-v1'"},"on_behalf_of":{"type":"string","title":"On Behalf Of","description":"Entity name accepting the NDA (e.g. investor firm name)","default":""}},"type":"object","required":["project_id","roster_id"],"title":"NdaAcceptRequest"},"NdaAcceptResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"tier":{"type":"integer","title":"Tier"},"project_id":{"type":"string","title":"Project Id"},"roster_id":{"type":"string","title":"Roster Id"},"agreed_at":{"type":"string","title":"Agreed At"},"on_behalf_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"On Behalf Of"},"unlocks":{"items":{"type":"string"},"type":"array","title":"Unlocks"},"next":{"type":"string","title":"Next"}},"type":"object","required":["accepted","tier","project_id","roster_id","agreed_at","unlocks","next"],"title":"NdaAcceptResponse"},"NeighborItem":{"properties":{"id":{"type":"string","title":"Id"},"source_id":{"type":"string","title":"Source Id"},"target_id":{"type":"string","title":"Target Id"},"predicate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicate"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"},"source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Name"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"target_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Name"},"target_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Type"},"valid_from":{"anyOf":[{},{"type":"null"}],"title":"Valid From"},"valid_until":{"anyOf":[{},{"type":"null"}],"title":"Valid Until"},"superseded_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Superseded By"}},"additionalProperties":true,"type":"object","required":["id","source_id","target_id"],"title":"NeighborItem","description":"One entry of GET /memory/v2/graph/neighbors/{entity_name}.\n\n``valid_from``/``valid_until`` are the raw timestamp columns here, NOT\npre-isoformatted strings like the sibling ``list_contradictions`` returns\n(a real inconsistency in GraphService, noted in the PR, not fixed here).\nThey are typed ``Any`` so neither a datetime nor an already-serialized\nstring is rejected or silently coerced into a different wire value."},"NetworkConnectivityHealth":{"properties":{"status":{"type":"string","title":"Status"},"latency_ms":{"type":"integer","title":"Latency Ms"},"external_access":{"type":"boolean","title":"External Access"}},"type":"object","required":["status","latency_ms","external_access"],"title":"NetworkConnectivityHealth"},"NetworkMetricsTimeseries":{"properties":{"latency":{"$ref":"#/components/schemas/MetricTimeSeries"},"throughput":{"$ref":"#/components/schemas/MetricTimeSeries"},"packet_loss":{"$ref":"#/components/schemas/MetricTimeSeries"}},"type":"object","required":["latency","throughput","packet_loss"],"title":"NetworkMetricsTimeseries"},"NotificationCountResponse":{"properties":{"count":{"type":"integer","title":"Count"}},"type":"object","required":["count"],"title":"NotificationCountResponse","description":"Schema for unread notification count response","example":{"count":5}},"NotificationCreate":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"message":{"type":"string","minLength":1,"title":"Message"},"action_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Url"},"user_id":{"type":"string","format":"uuid","title":"User Id"}},"type":"object","required":["type","title","message","user_id"],"title":"NotificationCreate","description":"Schema for creating a notification","example":{"action_url":"/dashboard","message":"Your account has been successfully created. Start building AI applications today!","title":"Welcome to AINative Studio","type":"INFO","user_id":"550e8400-e29b-41d4-a716-446655440000"}},"NotificationItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"type":{"type":"string","title":"Type","description":"Notification type: new_follower, milestone, etc."},"is_read":{"type":"boolean","title":"Is Read","description":"Whether notification has been read"},"created_at":{"type":"string","title":"Created At","description":"ISO 8601 timestamp"},"data":{"additionalProperties":true,"type":"object","title":"Data","description":"Notification-specific data"}},"type":"object","required":["id","type","is_read","created_at","data"],"title":"NotificationItem","description":"Single notification item","example":{"created_at":"2025-12-23T14:30:00Z","data":{"follower":{"id":"550e8400-e29b-41d4-a716-446655440000","username":"newFollower"}},"id":"notif-1111-2222-3333-4444-555566667777","is_read":false,"type":"new_follower"}},"NotificationListResponse":{"properties":{"notifications":{"items":{"$ref":"#/components/schemas/NotificationResponse"},"type":"array","title":"Notifications"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["notifications","total","limit","offset","has_more"],"title":"NotificationListResponse","description":"Schema for paginated notification list response","example":{"has_more":true,"limit":20,"notifications":[{"action_url":"/features/agents","created_at":"2025-12-07T10:00:00Z","id":"123e4567-e89b-12d3-a456-426614174000","message":"Check out our new AI agent framework!","read":false,"title":"New feature available","type":"INFO","updated_at":"2025-12-07T10:00:00Z","user_id":"550e8400-e29b-41d4-a716-446655440000"}],"offset":0,"total":42}},"NotificationLogResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Log entry ID"},"channel_id":{"type":"string","title":"Channel Id","description":"Channel ID"},"channel_type":{"$ref":"#/components/schemas/ChannelType","description":"Channel type"},"recipient":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient","description":"Notification recipient"},"status":{"$ref":"#/components/schemas/NotificationStatus","description":"Notification status"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error message if failed"},"response_time_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Time Ms","description":"Response time in milliseconds"},"extra_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra Data","description":"Additional metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"}},"type":"object","required":["id","channel_id","channel_type","status","created_at"],"title":"NotificationLogResponse","description":"Response schema for notification log entry","example":{"channel_id":"550e8400-e29b-41d4-a716-446655440000","channel_type":"slack","created_at":"2025-01-07T12:00:00Z","extra_data":{},"id":"660e8400-e29b-41d4-a716-446655440000","recipient":"#alerts","response_time_ms":234,"status":"success"}},"NotificationMonitoringResponse":{"properties":{"statistics":{"$ref":"#/components/schemas/NotificationStatisticsSummary","description":"Overall statistics for the date range"},"channel_health":{"items":{"$ref":"#/components/schemas/ChannelHealthStatus"},"type":"array","title":"Channel Health","description":"Health metrics for each channel"},"recent_logs":{"items":{"$ref":"#/components/schemas/NotificationLogResponse"},"type":"array","title":"Recent Logs","description":"Recent notification logs"},"total_logs":{"type":"integer","title":"Total Logs","description":"Total logs matching filters","default":0},"limit":{"type":"integer","title":"Limit","description":"Results per page","default":50},"offset":{"type":"integer","title":"Offset","description":"Current offset","default":0},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results available","default":false},"date_range":{"additionalProperties":{"type":"string"},"type":"object","title":"Date Range","description":"Date range used for query (start_date, end_date)"}},"type":"object","required":["statistics","date_range"],"title":"NotificationMonitoringResponse","description":"Main response schema for GET /admin/monitoring/notifications\nIssue #142\n\nReturns comprehensive notification monitoring data including:\n- Overall statistics\n- Per-channel health metrics\n- Recent notification logs\n- Pagination metadata","example":{"channel_health":[{"avg_response_time_ms":245.5,"channel_id":"550e8400-e29b-41d4-a716-446655440000","channel_name":"Primary SMTP","channel_type":"email_smtp","enabled":true,"last_failure_at":"2025-12-06T15:45:00Z","last_success_at":"2025-12-07T12:30:00Z","status":"active","success_rate":96.67,"total_delivered":2900,"total_failed":80,"total_pending":20,"total_sent":3000}],"date_range":{"end_date":"2025-12-07","start_date":"2025-11-07"},"has_more":true,"limit":50,"offset":0,"recent_logs":[],"statistics":{"avg_delivery_time_ms":325.8,"overall_success_rate":96,"total_delivered":4800,"total_failed":150,"total_pending":50,"total_sent":5000},"total_logs":5000}},"NotificationMonitoringStatus":{"type":"string","enum":["success","failed","pending"],"title":"NotificationMonitoringStatus","description":"Notification delivery status for monitoring"},"NotificationPreferences-Input":{"properties":{"email_on_payout_sent":{"type":"boolean","title":"Email On Payout Sent"},"email_on_payout_paid":{"type":"boolean","title":"Email On Payout Paid"},"email_on_payout_failed":{"type":"boolean","title":"Email On Payout Failed"},"sms_on_payout_paid":{"type":"boolean","title":"Sms On Payout Paid"}},"type":"object","required":["email_on_payout_sent","email_on_payout_paid","email_on_payout_failed","sms_on_payout_paid"],"title":"NotificationPreferences","description":"Notification preferences"},"NotificationPreferencesResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/app__schemas__settings__NotificationPreferences"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["data"],"title":"NotificationPreferencesResponse","description":"Response for GET/PUT /settings/notifications/preferences"},"NotificationPreferencesUpdateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"NotificationPreferencesUpdateResponse","description":"PUT /notifications/preferences, PUT /dashboard/notifications/preferences"},"NotificationResponse":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"message":{"type":"string","minLength":1,"title":"Message"},"action_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Url"},"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"read":{"type":"boolean","title":"Read"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["type","title","message","id","user_id","read","created_at","updated_at"],"title":"NotificationResponse","description":"Schema for notification response","example":{"action_url":"/dashboard","created_at":"2025-12-07T10:00:00Z","id":"123e4567-e89b-12d3-a456-426614174000","message":"Your account has been successfully created.","read":false,"title":"Welcome to AINative Studio","type":"INFO","updated_at":"2025-12-07T10:00:00Z","user_id":"550e8400-e29b-41d4-a716-446655440000"}},"NotificationStatisticsSummary":{"properties":{"total_sent":{"type":"integer","title":"Total Sent","description":"Total notifications sent","default":0},"total_delivered":{"type":"integer","title":"Total Delivered","description":"Total successfully delivered","default":0},"total_failed":{"type":"integer","title":"Total Failed","description":"Total failed","default":0},"total_pending":{"type":"integer","title":"Total Pending","description":"Total pending","default":0},"overall_success_rate":{"type":"number","maximum":100,"minimum":0,"title":"Overall Success Rate","description":"Overall success rate (0-100)","default":0},"avg_delivery_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Delivery Time Ms","description":"Average delivery time in milliseconds"}},"type":"object","title":"NotificationStatisticsSummary","description":"Overall notification statistics for date range"},"NotificationStatsResponse":{"properties":{"total":{"type":"integer","title":"Total"},"unread":{"type":"integer","title":"Unread"},"byType":{"additionalProperties":{"type":"integer"},"type":"object","title":"Bytype"},"byCategory":{"additionalProperties":{"type":"integer"},"type":"object","title":"Bycategory"}},"type":"object","required":["total","unread","byType","byCategory"],"title":"NotificationStatsResponse","description":"GET /notifications/stats, GET /dashboard/notifications/stats"},"NotificationStatus":{"type":"string","enum":["success","failed","pending"],"title":"NotificationStatus","description":"Notification delivery status"},"NotificationUpdate":{"properties":{"read":{"type":"boolean","title":"Read"}},"type":"object","required":["read"],"title":"NotificationUpdate","description":"Schema for updating a notification - only read status","example":{"read":true}},"NotificationsResponse":{"properties":{"notifications":{"items":{"$ref":"#/components/schemas/NotificationItem"},"type":"array","title":"Notifications"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Total notification count"},"unread_count":{"type":"integer","minimum":0,"title":"Unread Count","description":"Unread notification count"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Items per page"},"offset":{"type":"integer","minimum":0,"title":"Offset","description":"Offset for pagination"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more notifications exist"}},"type":"object","required":["notifications","total","unread_count","limit","offset","has_more"],"title":"NotificationsResponse","description":"Notifications response with pagination","example":{"has_more":false,"limit":20,"notifications":[],"offset":0,"total":15,"unread_count":7}},"NotionCreatePageRequest":{"properties":{"parent_id":{"type":"string","title":"Parent Id","description":"Parent page or database ID"},"title":{"type":"string","title":"Title","description":"Page title"},"content":{"type":"string","title":"Content","description":"Page content (plain text or markdown)","default":""}},"type":"object","required":["parent_id","title"],"title":"NotionCreatePageRequest"},"NotionCreatePageResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"title":{"type":"string","title":"Title"},"message":{"type":"string","title":"Message"}},"type":"object","required":["title","message"],"title":"NotionCreatePageResponse"},"NuclearProofResponse":{"properties":{"NUCLEAR_PROOF":{"type":"string","title":"Nuclear Proof"},"chat_sessions":{"items":{"$ref":"#/components/schemas/app__api__api_v1__endpoints__organizations__ChatSessionResponse"},"type":"array","title":"Chat Sessions"},"authentication_working":{"type":"boolean","title":"Authentication Working"},"user_id":{"type":"string","title":"User Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["NUCLEAR_PROOF","chat_sessions","authentication_working","user_id","message"],"title":"NuclearProofResponse","example":{"NUCLEAR_PROOF":"CHAT_SESSIONS_WORKING","authentication_working":true,"chat_sessions":[{"created_at":"2025-01-01T00:00:00Z","id":"chat-session-1","status":"active","title":"AI Development Discussion","user_id":"user-123"}],"message":"🚀 CHAT FUNCTIONALITY IS 100% WORKING!","user_id":"user-123"}},"OAuthCallbackResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"},"platform":{"type":"string","title":"Platform"},"account_id":{"type":"string","title":"Account Id"},"member_urn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Member Urn"}},"type":"object","required":["connected","platform","account_id"],"title":"OAuthCallbackResponse"},"OAuthClientSummary":{"properties":{"id":{"type":"string","title":"Id"},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"agent_registration_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Registration Id"},"agent_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Type"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"grant_types":{"items":{"type":"string"},"type":"array","title":"Grant Types"},"redirect_uris":{"items":{"type":"string"},"type":"array","title":"Redirect Uris"},"token_ttl_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Token Ttl Seconds"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"revoked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revoked At"}},"type":"object","required":["id"],"title":"OAuthClientSummary","description":"One OAuth client as AgentOAuthService.list_clients returns it.\n\nSECURITY (Refs #8449): this model is deliberately an EXPLICIT field list\nand does NOT set ``extra=\"allow\"``. The client secret lives in this domain\n-- create_client and rotate_client_secret each return one, exactly once --\nso the listing/update surface pins its fields closed. ``list_clients``\nselects no secret column today, so this changes nothing on the wire; it\nmakes the guarantee structural rather than incidental, so a future service\nchange that starts returning ``client_secret``/``client_secret_hash``\ncannot leak it through GET /clients or PUT /clients/{id}.\n\nEvery field below Optional-with-default mirrors a real nullable value:\n``agent_name`` is None when the owning registration's agent_card has no\n\"name\", ``agent_type`` and the timestamps come from nullable columns, and\n``agent_registration_id``/``agent_type``/``token_ttl_seconds`` are absent\nentirely from update_client's documented sparse fallback return."},"OAuthProfileResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan"}},"type":"object","required":["id","email"],"title":"OAuthProfileResponse","description":"Lightweight profile returned by GET /api/oauth/profile."},"OAuthScope":{"properties":{"id":{"type":"string","title":"Id","description":"Scope identifier, e.g. 'zerodb.read'"},"name":{"type":"string","title":"Name","description":"Display name (same as id today)"},"description":{"type":"string","title":"Description","description":"Human-readable scope description"},"category":{"type":"string","title":"Category","description":"Scope prefix, e.g. 'zerodb'"}},"type":"object","required":["id","name","description","category"],"title":"OAuthScope","description":"One selectable OAuth scope, as the Cloud Auth scope picker reads it."},"OnboardingAnalyticsResponse":{"properties":{"timeframe":{"type":"string","title":"Timeframe"},"user_role":{"type":"string","title":"User Role"},"onboarding_metrics":{"additionalProperties":true,"type":"object","title":"Onboarding Metrics"},"tutorial_metrics":{"additionalProperties":true,"type":"object","title":"Tutorial Metrics"},"engagement_analysis":{"additionalProperties":true,"type":"object","title":"Engagement Analysis"},"completion_trends":{"additionalProperties":true,"type":"object","title":"Completion Trends"},"user_feedback_analysis":{"additionalProperties":true,"type":"object","title":"User Feedback Analysis"},"improvement_recommendations":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Improvement Recommendations"}},"type":"object","required":["timeframe","user_role","onboarding_metrics","tutorial_metrics","engagement_analysis","completion_trends","user_feedback_analysis","improvement_recommendations"],"title":"OnboardingAnalyticsResponse","description":"Response for GET /onboarding-tutorials/analytics."},"OnboardingChapter":{"properties":{"chapter":{"type":"string","title":"Chapter"},"total_steps":{"type":"integer","title":"Total Steps"},"completed_steps":{"type":"integer","title":"Completed Steps"},"percent_complete":{"type":"integer","title":"Percent Complete"},"is_complete":{"type":"boolean","title":"Is Complete"},"steps":{"items":{"$ref":"#/components/schemas/OnboardingStep"},"type":"array","title":"Steps"}},"type":"object","required":["chapter","total_steps","completed_steps","percent_complete","is_complete","steps"],"title":"OnboardingChapter"},"OnboardingCompleteToast":{"properties":{"message":{"type":"string","title":"Message"},"action_label":{"type":"string","title":"Action Label"},"action_route":{"type":"string","title":"Action Route"}},"type":"object","required":["message","action_label","action_route"],"title":"OnboardingCompleteToast"},"OnboardingDashboardResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"overview_metrics":{"additionalProperties":true,"type":"object","title":"Overview Metrics"},"user_progress":{"additionalProperties":true,"type":"object","title":"User Progress"},"tutorial_performance":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tutorial Performance"},"completion_rates":{"additionalProperties":true,"type":"object","title":"Completion Rates"},"engagement_metrics":{"additionalProperties":true,"type":"object","title":"Engagement Metrics"},"feedback_summary":{"additionalProperties":true,"type":"object","title":"Feedback Summary"},"popular_tutorials":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Popular Tutorials"},"improvement_opportunities":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Improvement Opportunities"}},"type":"object","required":["timestamp","overview_metrics","user_progress","tutorial_performance","completion_rates","engagement_metrics","feedback_summary","popular_tutorials","improvement_opportunities"],"title":"OnboardingDashboardResponse","description":"Response for GET /onboarding-tutorials/dashboard.\n\nNested sections come from fixed-shape (mock) helper functions but\nare kept as Dict[str, Any]/List[Dict[str, Any]] since their internal\nkey sets are documentation detail rather than the contract this pass\ntargets."},"OnboardingFlowCreate":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"target_role":{"$ref":"#/components/schemas/app__api__admin__onboarding_tutorials__UserRole"},"stages":{"items":{"$ref":"#/components/schemas/OnboardingStage"},"type":"array","title":"Stages"},"estimated_duration_minutes":{"type":"integer","title":"Estimated Duration Minutes"},"is_mandatory":{"type":"boolean","title":"Is Mandatory","default":false}},"type":"object","required":["name","description","target_role","stages","estimated_duration_minutes"],"title":"OnboardingFlowCreate"},"OnboardingFlowFilters":{"properties":{"target_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Role"},"is_mandatory":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Mandatory"}},"type":"object","title":"OnboardingFlowFilters"},"OnboardingProgressResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"total_steps":{"type":"integer","title":"Total Steps"},"completed_steps":{"type":"integer","title":"Completed Steps"},"percent_complete":{"type":"integer","title":"Percent Complete"},"is_complete":{"type":"boolean","title":"Is Complete"},"chapters":{"items":{"$ref":"#/components/schemas/OnboardingChapter"},"type":"array","title":"Chapters"}},"type":"object","required":["organization_id","total_steps","completed_steps","percent_complete","is_complete","chapters"],"title":"OnboardingProgressResponse"},"OnboardingStage":{"type":"string","enum":["welcome","account_setup","workspace_creation","first_project","collaboration_intro","advanced_features","completion"],"title":"OnboardingStage","description":"Onboarding stages"},"OnboardingStep":{"properties":{"step_id":{"type":"string","title":"Step Id"},"chapter":{"type":"string","title":"Chapter"},"is_complete":{"type":"boolean","title":"Is Complete"}},"type":"object","required":["step_id","chapter","is_complete"],"title":"OnboardingStep"},"OntologyApplyRequest":{"properties":{"entity_types":{"items":{"$ref":"#/components/schemas/OntologyEntityType"},"type":"array","title":"Entity Types","description":"Entity type definitions"},"predicates":{"items":{"$ref":"#/components/schemas/OntologyPredicate"},"type":"array","title":"Predicates","description":"Predicate definitions"}},"type":"object","required":["entity_types","predicates"],"title":"OntologyApplyRequest"},"OntologyDiff":{"properties":{"has_existing_ontology":{"type":"boolean","title":"Has Existing Ontology"},"new_entity_types":{"items":{},"type":"array","title":"New Entity Types"},"new_predicates":{"items":{},"type":"array","title":"New Predicates"},"existing_entity_types":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Existing Entity Types"},"existing_predicates":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Existing Predicates"}},"additionalProperties":true,"type":"object","required":["has_existing_ontology"],"title":"OntologyDiff","description":"The ontology diff computed when infer_ontology is given a project_id.\n\n``existing_entity_types``/``existing_predicates`` are emitted ONLY when\n``has_existing_ontology`` is True; the no-stored-ontology branch returns\njust the three other keys. Hence Optional + exclude_unset on the route."},"OntologyEntityType":{"properties":{"name":{"type":"string","title":"Name","description":"Entity type name"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","description":"Occurrence count"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence","description":"Confidence score"}},"type":"object","required":["name"],"title":"OntologyEntityType"},"OntologyGetResponse":{"properties":{"id":{"type":"string","title":"Id"},"project_id":{"type":"string","title":"Project Id"},"user_id":{"type":"string","title":"User Id"},"entity_types":{"items":{},"type":"array","title":"Entity Types"},"predicates":{"additionalProperties":true,"type":"object","title":"Predicates"},"constraints":{"additionalProperties":true,"type":"object","title":"Constraints"},"version":{"type":"integer","title":"Version"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","project_id","user_id","version"],"title":"OntologyGetResponse","description":"Response for GET /memory/v2/graph/ontology.\n\n``entity_types``/``predicates``/``constraints`` are stored as free-form\nJSONB (predicates especially: an arbitrary nested per-type mapping), so\nthey stay loosely typed rather than being forced into rigid sub-models."},"OntologyPredicate":{"properties":{"name":{"type":"string","title":"Name","description":"Predicate name"},"source_type":{"type":"string","title":"Source Type","description":"Expected source entity type"},"target_type":{"type":"string","title":"Target Type","description":"Expected target entity type"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","description":"Occurrence count"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence","description":"Confidence score"}},"type":"object","required":["name","source_type","target_type"],"title":"OntologyPredicate"},"OntologyRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project UUID"},"entity_types":{"items":{"type":"string"},"type":"array","title":"Entity Types","description":"Allowed entity types"},"predicates":{"additionalProperties":{"additionalProperties":{"type":"string"},"type":"object"},"type":"object","title":"Predicates","description":"Allowed predicates per entity type, e.g. {'customer': {'places': 'order'}}"},"constraints":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Constraints","description":"Optional constraints"}},"type":"object","required":["project_id","entity_types"],"title":"OntologyRequest","description":"Request body for creating/updating a project ontology. Refs #1545"},"OntologySuggestionItem":{"properties":{"type":{"type":"string","title":"Type"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"entity_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Entity Count"},"breakdown":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Breakdown"},"predicates":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Predicates"},"entity_types":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Entity Types"}},"additionalProperties":true,"type":"object","required":["type"],"title":"OntologySuggestionItem","description":"One suggestion from GET /memory/v2/graph/ontology/suggestions.\n\nHeterogeneous by design: only ``type``/``priority``/``message`` are shared.\nThe payload field depends on ``type`` — ``reclassify_generic`` carries\nentity_count+breakdown, ``add_predicates`` carries predicates,\n``add_entity_types`` carries entity_types. All payload fields are therefore\nOptional and the route uses ``response_model_exclude_unset=True`` so each\nsuggestion keeps exactly the keys its own branch produced."},"OntologySuggestionsResponse":{"properties":{"suggestions":{"items":{"$ref":"#/components/schemas/OntologySuggestionItem"},"type":"array","title":"Suggestions"},"count":{"type":"integer","title":"Count"}},"additionalProperties":true,"type":"object","required":["count"],"title":"OntologySuggestionsResponse","description":"Response for GET /memory/v2/graph/ontology/suggestions."},"OntologyUpsertResponse":{"properties":{"id":{"type":"string","title":"Id"},"project_id":{"type":"string","title":"Project Id"},"user_id":{"type":"string","title":"User Id"},"entity_types":{"items":{},"type":"array","title":"Entity Types"},"predicates":{"additionalProperties":true,"type":"object","title":"Predicates"},"constraints":{"additionalProperties":true,"type":"object","title":"Constraints"},"version":{"type":"integer","title":"Version"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","project_id","user_id","version","status"],"title":"OntologyUpsertResponse","description":"Response for POST /memory/v2/graph/ontology (create or update).\n\nUnlike the GET response, upsert never returns created_at/updated_at and\nalways returns a ``status`` of \"created\" or \"updated\" — kept as a\nseparate model rather than unioning optional fields onto the GET shape,\nsince either choice risks an untruthful null appearing on the wire."},"OpenClawCommand":{"properties":{"command":{"type":"string","title":"Command","description":"Command name (e.g., 'send_message')"},"session_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Key","description":"Target session key"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Message content if applicable"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO 8601 timestamp of command execution"},"status":{"type":"string","title":"Status","description":"Command status: 'success', 'failed', 'pending'"}},"type":"object","required":["command","timestamp","status"],"title":"OpenClawCommand","description":"Command executed on OpenClaw Gateway"},"OptimizationHistoryEntry":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"started_at":{"type":"string","title":"Started At"},"completed_at":{"type":"string","title":"Completed At"},"duration":{"type":"string","title":"Duration"},"status":{"type":"string","title":"Status"},"started_by":{"title":"Started By"},"results":{"$ref":"#/components/schemas/OptimizationHistoryResults"}},"type":"object","required":["id","type","started_at","completed_at","duration","status","started_by","results"],"title":"OptimizationHistoryEntry"},"OptimizationHistoryResults":{"properties":{"tables_processed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tables Processed"},"space_reclaimed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Space Reclaimed"},"performance_improvement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Performance Improvement"},"indexes_analyzed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Indexes Analyzed"},"unused_indexes_found":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Unused Indexes Found"},"recommendations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Recommendations"}},"type":"object","title":"OptimizationHistoryResults"},"OptimizationOpportunity":{"properties":{"area":{"type":"string","title":"Area"},"description":{"type":"string","title":"Description"},"potential_improvement":{"type":"string","title":"Potential Improvement"},"implementation_effort":{"type":"string","title":"Implementation Effort"}},"type":"object","required":["area","description","potential_improvement","implementation_effort"],"title":"OptimizationOpportunity"},"OptimizationResponse":{"properties":{"test_id":{"type":"string","title":"Test Id"},"optimization_strategy":{"type":"string","title":"Optimization Strategy"},"optimization_timestamp":{"type":"string","format":"date-time","title":"Optimization Timestamp"},"expected_improvement":{"type":"number","title":"Expected Improvement"},"confidence":{"type":"number","title":"Confidence"},"suggested_variants":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Suggested Variants"}},"type":"object","required":["test_id","optimization_strategy","optimization_timestamp","expected_improvement","confidence","suggested_variants"],"title":"OptimizationResponse"},"OptimizationTask":{"properties":{"task":{"type":"string","title":"Task"},"description":{"type":"string","title":"Description"},"estimated_duration":{"type":"string","title":"Estimated Duration"},"impact":{"type":"string","title":"Impact"}},"type":"object","required":["task","description","estimated_duration","impact"],"title":"OptimizationTask"},"OptimizeCodeContextResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Service status"},"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"optimization_results":{"additionalProperties":true,"type":"object","title":"Optimization Results","description":"Optimization report, including the vector_search sub-report"}},"additionalProperties":true,"type":"object","required":["status","project_id","optimization_results"],"title":"OptimizeCodeContextResponse","description":"Result of running vector-index optimization for a project."},"OptimizeDatabaseResponse":{"properties":{"optimization_id":{"type":"string","title":"Optimization Id"},"status":{"type":"string","title":"Status"},"tasks":{"items":{"$ref":"#/components/schemas/OptimizationTask"},"type":"array","title":"Tasks"},"started_at":{"type":"string","title":"Started At"},"started_by":{"title":"Started By"},"estimated_completion":{"type":"string","title":"Estimated Completion"}},"type":"object","required":["optimization_id","status","tasks","started_at","started_by","estimated_completion"],"title":"OptimizeDatabaseResponse"},"OptimizePromptsForProjectResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"optimizations_available":{"items":{},"type":"array","title":"Optimizations Available"},"estimated_improvements":{"additionalProperties":true,"type":"object","title":"Estimated Improvements"},"recommendations":{"items":{"$ref":"#/components/schemas/PromptOptimizationRecommendation"},"type":"array","title":"Recommendations"},"auto_apply":{"type":"boolean","title":"Auto Apply"}},"type":"object","required":["project_id","optimizations_available","estimated_improvements","recommendations","auto_apply"],"title":"OptimizePromptsForProjectResponse"},"OptimizePromptsRequest":{"properties":{"optimization_strategy":{"type":"string","title":"Optimization Strategy","description":"Optimization strategy (bayesian, genetic, gradient)","default":"bayesian"}},"type":"object","title":"OptimizePromptsRequest"},"Order":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"total":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total"},"tag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","title":"Order"},"OrderLineItem":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"order_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id"},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Name"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"discount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Discount"},"cost":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cost"},"annual":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Annual"}},"type":"object","title":"OrderLineItem"},"OrgBillingUsageResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"org_name":{"type":"string","title":"Org Name"},"org_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Domain"},"tier":{"type":"string","title":"Tier"},"time_range":{"type":"string","title":"Time Range"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"total_tokens":{"type":"integer","title":"Total Tokens"},"total_requests":{"type":"integer","title":"Total Requests"},"total_cost_usd":{"type":"number","title":"Total Cost Usd"},"project_count":{"type":"integer","title":"Project Count"},"projects":{"items":{"$ref":"#/components/schemas/OrgProjectUsage"},"type":"array","title":"Projects"}},"type":"object","required":["org_id","org_name","org_domain","tier","time_range","start_date","end_date","total_tokens","total_requests","total_cost_usd","project_count","projects"],"title":"OrgBillingUsageResponse"},"OrgMembership":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"is_default":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Default"}},"additionalProperties":true,"type":"object","title":"OrgMembership","description":"One entry of ``/auth/me``'s ``organizations`` list (Refs #7546)."},"OrgPolicySettings":{"properties":{"org_id":{"type":"string","format":"uuid","title":"Org Id"},"policies":{"additionalProperties":true,"type":"object","title":"Policies","description":"Policy settings blob managed by org admins"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["org_id","policies"],"title":"OrgPolicySettings","description":"Org-managed policy settings pushed to CLI clients."},"OrgProjectCreate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name","description":"Project name"},"on_behalf_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"On Behalf Of","description":"User ID to create project for (optional)"}},"type":"object","title":"OrgProjectCreate"},"OrgProjectCreateResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"name":{"type":"string","title":"Name"},"organization_id":{"type":"string","title":"Organization Id"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["project_id","name","organization_id","created_at"],"title":"OrgProjectCreateResponse"},"OrgProjectUsage":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"tier":{"type":"string","title":"Tier"},"total_tokens":{"type":"integer","title":"Total Tokens"},"total_requests":{"type":"integer","title":"Total Requests"},"cost_usd":{"type":"number","title":"Cost Usd"}},"type":"object","required":["project_id","project_name","tier","total_tokens","total_requests","cost_usd"],"title":"OrgProjectUsage"},"OrgSettingsResponse":{"properties":{"organization":{"anyOf":[{},{"type":"null"}],"title":"Organization"},"allowed_models":{"items":{"type":"string"},"type":"array","title":"Allowed Models"},"require_approval":{"type":"boolean","title":"Require Approval","default":false}},"type":"object","title":"OrgSettingsResponse","description":"Organization-level settings for the CLI."},"OrgStorageBreakdown":{"properties":{"zerodb_rows_gb":{"type":"number","title":"Zerodb Rows Gb"},"zerodb_files_gb":{"type":"number","title":"Zerodb Files Gb"},"lakehouse_gb":{"type":"number","title":"Lakehouse Gb"},"vectors_gb":{"type":"number","title":"Vectors Gb"},"video_gb":{"type":"number","title":"Video Gb","description":"Video bytes (subset of zerodb_files_gb) in GB","default":0},"total_gb":{"type":"number","title":"Total Gb"}},"type":"object","required":["zerodb_rows_gb","zerodb_files_gb","lakehouse_gb","vectors_gb","total_gb"],"title":"OrgStorageBreakdown"},"OrgStorageResponse":{"properties":{"scope":{"type":"string","title":"Scope","description":"'account' — summed across all the user's orgs/projects"},"project_count":{"type":"integer","title":"Project Count"},"plan":{"type":"string","title":"Plan"},"breakdown":{"$ref":"#/components/schemas/OrgStorageBreakdown"},"current_total_gb":{"type":"number","title":"Current Total Gb"},"included_gb":{"type":"number","title":"Included Gb"},"overage_gb":{"type":"number","title":"Overage Gb"},"cost_estimate_usd":{"type":"number","title":"Cost Estimate Usd"},"measured_live":{"type":"boolean","title":"Measured Live","description":"True if lakehouse was measured live from MinIO (vs the daily snapshot)"}},"type":"object","required":["scope","project_count","plan","breakdown","current_total_gb","included_gb","overage_gb","cost_estimate_usd","measured_live"],"title":"OrgStorageResponse"},"Organization":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","title":"Organization"},"OrganizationCreateRequest":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["name"],"title":"OrganizationCreateRequest","example":{"description":"A sample organization for testing","name":"My New Organization"}},"OrganizationCreateResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","name","status","created_at"],"title":"OrganizationCreateResponse","example":{"created_at":"2025-01-01T00:00:00Z","id":"org-new-789","name":"New Organization","status":"active"}},"OrganizationMembership":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"role":{"type":"string","title":"Role"},"is_default":{"type":"boolean","title":"Is Default"}},"type":"object","required":["id","role","is_default"],"title":"OrganizationMembership","description":"One entry of the caller's org membership list (Refs #7666)."},"OrganizationProjectRef":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"}},"type":"object","required":["project_id","project_name"],"title":"OrganizationProjectRef"},"OrganizationResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},"type":"object","required":["id","name","status","created_at"],"title":"OrganizationResponse","example":{"created_at":"2025-01-01T00:00:00Z","id":"org-123","name":"Acme Corporation","status":"active","user_id":"user-456"}},"OrganizationUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","title":"OrganizationUpdateRequest","example":{"description":"Updated description","name":"Updated Organization Name","status":"active"}},"OrganizationUpdateResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","name","status","updated_at"],"title":"OrganizationUpdateResponse","example":{"id":"org-123","name":"Updated Organization Name","status":"active","updated_at":"2025-01-01T00:00:00Z"}},"OrganizerCreate":{"properties":{"organization_name":{"type":"string","maxLength":200,"minLength":2,"title":"Organization Name"},"contact_email":{"type":"string","format":"email","title":"Contact Email"},"contact_phone":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Contact Phone"},"revenue_share_percent":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"string"}],"title":"Revenue Share Percent","default":"60.0"},"user_id":{"type":"string","format":"uuid","title":"User Id"}},"type":"object","required":["organization_name","contact_email","user_id"],"title":"OrganizerCreate","description":"Schema for creating an organizer"},"OrganizerPattern":{"properties":{"workflow_type":{"type":"string","title":"Workflow Type","description":"Type of workflow"},"frequency":{"type":"integer","title":"Frequency","description":"Number of times performed"},"average_duration_minutes":{"type":"number","title":"Average Duration Minutes","description":"Average time spent"},"common_actions":{"items":{"type":"string"},"type":"array","title":"Common Actions","description":"Common action patterns"},"success_rate":{"type":"number","title":"Success Rate","description":"Success rate (0-1)"}},"type":"object","required":["workflow_type","frequency","average_duration_minutes","common_actions","success_rate"],"title":"OrganizerPattern","description":"Organizer workflow pattern data"},"OrganizerPatternsResponse":{"properties":{"organizer_id":{"type":"string","format":"uuid","title":"Organizer Id","description":"Organizer ID"},"patterns":{"items":{"$ref":"#/components/schemas/OrganizerPattern"},"type":"array","title":"Patterns","description":"Workflow patterns"},"total_hackathons_managed":{"type":"integer","title":"Total Hackathons Managed","description":"Total hackathons managed"},"efficiency_score":{"type":"number","title":"Efficiency Score","description":"Efficiency metric (0-1)"}},"type":"object","required":["organizer_id","patterns","total_hackathons_managed","efficiency_score"],"title":"OrganizerPatternsResponse","description":"Response schema for organizer patterns"},"OrganizerResponse":{"properties":{"organization_name":{"type":"string","maxLength":200,"minLength":2,"title":"Organization Name"},"contact_email":{"type":"string","format":"email","title":"Contact Email"},"contact_phone":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Contact Phone"},"revenue_share_percent":{"type":"string","title":"Revenue Share Percent","default":"60.0"},"id":{"type":"string","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"stripe_connect_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Connect Account Id"},"total_revenue_earned":{"type":"string","title":"Total Revenue Earned","default":"0.0"},"total_payouts":{"type":"string","title":"Total Payouts","default":"0.0"},"status":{"$ref":"#/components/schemas/OrganizerStatus","default":"pending"},"verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Verified At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["organization_name","contact_email","id","user_id","created_at","updated_at"],"title":"OrganizerResponse","description":"Schema for organizer response"},"OrganizerRevenueResponse":{"properties":{"organizer_id":{"type":"string","title":"Organizer Id"},"total_revenue_earned":{"type":"string","title":"Total Revenue Earned"},"total_payouts":{"type":"string","title":"Total Payouts"},"pending_balance":{"type":"string","title":"Pending Balance"},"payout_threshold":{"type":"string","title":"Payout Threshold","default":"100.0"},"payout_eligible":{"type":"boolean","title":"Payout Eligible"},"revenue_by_event":{"items":{"$ref":"#/components/schemas/app__schemas__paipalooza__organizer__RevenueBreakdown"},"type":"array","title":"Revenue By Event"},"period_start":{"type":"string","format":"date-time","title":"Period Start"},"period_end":{"type":"string","format":"date-time","title":"Period End"},"period_revenue":{"type":"string","title":"Period Revenue"},"period_impressions":{"type":"integer","title":"Period Impressions"}},"type":"object","required":["organizer_id","total_revenue_earned","total_payouts","pending_balance","payout_eligible","period_start","period_end","period_revenue","period_impressions"],"title":"OrganizerRevenueResponse","description":"Schema for organizer revenue tracking"},"OrganizerStatus":{"type":"string","enum":["pending","active","suspended","deactivated"],"title":"OrganizerStatus","description":"Organizer account status"},"OrganizerUpdate":{"properties":{"organization_name":{"anyOf":[{"type":"string","maxLength":200,"minLength":2},{"type":"null"}],"title":"Organization Name"},"contact_email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Contact Email"},"contact_phone":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Contact Phone"}},"type":"object","title":"OrganizerUpdate","description":"Schema for updating an organizer"},"OrganizerWorkflowRequest":{"properties":{"organizer_id":{"type":"string","format":"uuid","title":"Organizer Id","description":"Organizer user ID"},"hackathon_id":{"type":"string","format":"uuid","title":"Hackathon Id","description":"Hackathon ID"},"workflow_type":{"type":"string","minLength":1,"title":"Workflow Type","description":"Type of workflow (project_review, team_management, etc.)"},"workflow_data":{"additionalProperties":true,"type":"object","title":"Workflow Data","description":"Workflow data (actions, decisions, patterns)"}},"type":"object","required":["organizer_id","hackathon_id","workflow_type","workflow_data"],"title":"OrganizerWorkflowRequest","description":"Request schema for storing organizer workflows"},"OutboundPaymentDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"owner_id":{"type":"string","title":"Owner Id"},"agent_id":{"type":"string","title":"Agent Id"},"payment_id":{"type":"string","title":"Payment Id"},"target_url":{"type":"string","title":"Target Url"},"recipient":{"type":"string","title":"Recipient"},"token":{"type":"string","title":"Token"},"network":{"type":"string","title":"Network"},"amount":{"type":"integer","title":"Amount"},"credits_charged":{"type":"integer","title":"Credits Charged"},"status":{"type":"string","title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","owner_id","agent_id","payment_id","target_url","recipient","token","network","amount","credits_charged","status"],"title":"OutboundPaymentDetailResponse","description":"Full detail for a single outbound x402 payment (Refs #8449).\n\nMirrors X402OutboundService.get_payment() exactly. Deliberately NO\n`extra=\"allow\"`: the delegate returns `owner_id` (an internal user UUID)\npurely so the handler can run its ownership check, and the route already\n403s a non-owner. An open `extra` here would let any future service field\n— including anything a later scoping/redaction step strips — flow straight\nout to the client on a financial record. Fields are therefore enumerated."},"OutboundPaymentResponse":{"properties":{"payment_id":{"type":"string","title":"Payment Id"},"agent_id":{"type":"string","title":"Agent Id"},"target_url":{"type":"string","title":"Target Url"},"recipient":{"type":"string","title":"Recipient"},"amount":{"type":"integer","title":"Amount"},"credits_charged":{"type":"integer","title":"Credits Charged"},"status":{"type":"string","title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["payment_id","agent_id","target_url","recipient","amount","credits_charged","status"],"title":"OutboundPaymentResponse","description":"Single outbound payment record."},"OutlineResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"form_route":{"type":"string","title":"Form Route"},"total_questions":{"type":"integer","title":"Total Questions"},"answered_count":{"type":"integer","title":"Answered Count"},"percent_complete":{"type":"integer","title":"Percent Complete"},"current_idx":{"type":"integer","title":"Current Idx"},"done":{"type":"boolean","title":"Done"},"sections":{"items":{"$ref":"#/components/schemas/OutlineSection"},"type":"array","title":"Sections"}},"type":"object","required":["organization_id","form_route","total_questions","answered_count","percent_complete","current_idx","done","sections"],"title":"OutlineResponse"},"OutlineSection":{"properties":{"section":{"type":"string","title":"Section"},"total":{"type":"integer","title":"Total"},"answered":{"type":"integer","title":"Answered"}},"type":"object","required":["section","total","answered"],"title":"OutlineSection"},"OutreachRequest":{"properties":{"connections":{"items":{"$ref":"#/components/schemas/ConnectionInput"},"type":"array","maxItems":15,"minItems":1,"title":"Connections"},"base_message":{"type":"string","maxLength":2000,"minLength":10,"title":"Base Message"},"tone":{"type":"string","pattern":"^(warm|direct|formal)$","title":"Tone","default":"warm"},"max_per_day":{"type":"integer","maximum":15,"minimum":1,"title":"Max Per Day","default":15},"min_delay_seconds":{"type":"integer","minimum":5,"title":"Min Delay Seconds","default":90}},"type":"object","required":["connections","base_message"],"title":"OutreachRequest"},"OutreachResponse":{"properties":{"total":{"type":"integer","title":"Total"},"sent":{"type":"integer","title":"Sent"},"failed":{"type":"integer","title":"Failed"},"results":{"items":{"$ref":"#/components/schemas/OutreachResultItem"},"type":"array","title":"Results"}},"type":"object","required":["total","sent","failed","results"],"title":"OutreachResponse"},"OutreachResultItem":{"properties":{"name":{"type":"string","title":"Name"},"firm":{"type":"string","title":"Firm"},"status":{"type":"string","title":"Status"},"message_sent":{"type":"string","title":"Message Sent"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["name","firm","status","message_sent","timestamp"],"title":"OutreachResultItem"},"OverageCreditGrantResponse":{"properties":{"is_enabled":{"type":"boolean","title":"Is Enabled","default":false},"monthly_limit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Monthly Limit"},"used_credits":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Used Credits"}},"type":"object","title":"OverageCreditGrantResponse","description":"Overage credit grant status for an organization."},"OverallCompletionRates":{"properties":{"onboarding_completion":{"type":"number","title":"Onboarding Completion"},"tutorial_completion":{"type":"number","title":"Tutorial Completion"},"step_completion":{"type":"number","title":"Step Completion"}},"type":"object","required":["onboarding_completion","tutorial_completion","step_completion"],"title":"OverallCompletionRates"},"OverallLearningStats":{"properties":{"total_interactions":{"type":"integer","title":"Total Interactions"},"total_agents":{"type":"integer","title":"Total Agents"},"overall_success_rate":{"type":"number","title":"Overall Success Rate"}},"type":"object","required":["total_interactions","total_agents","overall_success_rate"],"title":"OverallLearningStats"},"OverallPerformance":{"properties":{"score":{"type":"integer","title":"Score"},"level":{"type":"string","title":"Level"},"health_status":{"type":"string","title":"Health Status"}},"type":"object","required":["score","level","health_status"],"title":"OverallPerformance"},"OverrideRequest":{"properties":{"due_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due Date"},"is_done":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Done"}},"type":"object","title":"OverrideRequest"},"OverrideResponse":{"properties":{"deadline_id":{"type":"string","title":"Deadline Id"},"organization_id":{"type":"string","title":"Organization Id"}},"additionalProperties":true,"type":"object","required":["deadline_id","organization_id"],"title":"OverrideResponse","description":"The overridden deadline, re-computed with the new values applied."},"OversightLevel":{"type":"string","enum":["none","logging","approval_required","human_in_loop"],"title":"OversightLevel"},"PITRRestorePostgresResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"target_timestamp":{"type":"string","title":"Target Timestamp"}},"type":"object","required":["success","message","target_timestamp"],"title":"PITRRestorePostgresResponse"},"PRAnalysisInfoResponse":{"properties":{"status":{"type":"string","title":"Status"},"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version"},"description":{"type":"string","title":"Description"}},"type":"object","required":["status","name","version","description"],"title":"PRAnalysisInfoResponse","description":"Service metadata for the Quantum PR Analysis API."},"PRAnalysisResultResponse":{"properties":{"analysis":{"type":"string","title":"Analysis"},"quantum_score":{"type":"number","title":"Quantum Score"},"suggestions":{"items":{"type":"string"},"type":"array","title":"Suggestions"}},"type":"object","required":["analysis","quantum_score","suggestions"],"title":"PRAnalysisResultResponse","description":"Result of a quantum-enhanced PR analysis run."},"PackageEntry":{"properties":{"name":{"type":"string","title":"Name"},"ecosystem":{"type":"string","title":"Ecosystem"},"downloads":{"type":"integer","title":"Downloads"}},"type":"object","required":["name","ecosystem","downloads"],"title":"PackageEntry"},"PackageStats":{"properties":{"total_downloads":{"type":"integer","title":"Total Downloads"},"top_packages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Packages"},"source":{"type":"string","title":"Source"}},"type":"object","required":["total_downloads","top_packages","source"],"title":"PackageStats","description":"npm + PyPI download stats from the data lake. Refs #3361"},"PaginatedChatSessions":{"properties":{"sessions":{"items":{"$ref":"#/components/schemas/app__schemas__chat__ChatSessionResponse"},"type":"array","title":"Sessions"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["sessions","total","skip","limit"],"title":"PaginatedChatSessions","description":"Schema for paginated chat sessions"},"PaginatedQuantumJobs":{"properties":{"jobs":{"items":{"$ref":"#/components/schemas/QuantumJobResponse"},"type":"array","title":"Jobs"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["jobs","total","skip","limit"],"title":"PaginatedQuantumJobs","description":"Schema for paginated quantum jobs"},"PaginatedResponse":{"properties":{"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["data","total","page","per_page","has_more"],"title":"PaginatedResponse"},"PaginatedRowsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total count of rows"},"skip":{"type":"integer","title":"Skip","description":"Number of rows skipped"},"limit":{"type":"integer","title":"Limit","description":"Maximum rows per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more rows are available"},"data":{"items":{"$ref":"#/components/schemas/ZeroDBRowResponse"},"type":"array","title":"Data","description":"List of rows"}},"type":"object","required":["total","skip","limit","has_more","data"],"title":"PaginatedRowsResponse","description":"Paginated response for rows listing"},"PaginatedTablesResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total count of tables"},"skip":{"type":"integer","title":"Skip","description":"Number of tables skipped"},"limit":{"type":"integer","title":"Limit","description":"Maximum tables per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more tables are available"},"data":{"items":{"$ref":"#/components/schemas/ZeroDBTableResponse"},"type":"array","title":"Data","description":"List of tables"}},"type":"object","required":["total","skip","limit","has_more","data"],"title":"PaginatedTablesResponse","description":"Paginated response for tables listing"},"PaginatedVectorsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total count of vectors"},"offset":{"type":"integer","title":"Offset","description":"Number of vectors skipped"},"limit":{"type":"integer","title":"Limit","description":"Maximum vectors per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more vectors are available"},"vectors":{"items":{"$ref":"#/components/schemas/VectorResponse"},"type":"array","title":"Vectors","description":"List of vectors"}},"type":"object","required":["total","offset","limit","has_more","vectors"],"title":"PaginatedVectorsResponse","description":"Paginated response for vectors listing"},"PaginatedVideosResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/app__api__videos__VideoResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"pages":{"type":"integer","title":"Pages"},"per_page":{"type":"integer","title":"Per Page"}},"type":"object","required":["items","total","page","pages","per_page"],"title":"PaginatedVideosResponse","description":"Paginated video list with metadata"},"PairRequest":{"properties":{"pairing_token":{"type":"string","title":"Pairing Token","description":"UUID pairing token from Cody CLI"},"device_id":{"type":"string","maxLength":255,"minLength":1,"title":"Device Id","description":"Unique device identifier"},"device_name":{"type":"string","maxLength":255,"minLength":1,"title":"Device Name","description":"Human-readable device name"},"push_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Push Token","description":"APNs or FCM push token"}},"type":"object","required":["pairing_token","device_id","device_name"],"title":"PairRequest"},"PairResponse":{"properties":{"mobile_session_token":{"type":"string","title":"Mobile Session Token"},"session_id":{"type":"string","title":"Session Id"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["mobile_session_token","session_id","expires_at"],"title":"PairResponse"},"ParsedRuleEntry":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"category":{"type":"string","title":"Category"},"content":{"type":"string","title":"Content"},"enabled":{"type":"boolean","title":"Enabled"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","name","category","content","enabled","created_at"],"title":"ParsedRuleEntry"},"ParticipantResponse":{"properties":{"participant_id":{"type":"string","format":"uuid","title":"Participant Id","description":"Participant identifier"},"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User identifier"},"session_id":{"type":"string","format":"uuid","title":"Session Id","description":"Session identifier"},"is_host":{"type":"boolean","title":"Is Host","description":"Whether participant is the host"},"audio_enabled":{"type":"boolean","title":"Audio Enabled","description":"Audio enabled status"},"video_enabled":{"type":"boolean","title":"Video Enabled","description":"Video enabled status"},"joined_at":{"type":"string","format":"date-time","title":"Joined At","description":"Join timestamp"},"left_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Left At","description":"Leave timestamp"}},"type":"object","required":["participant_id","user_id","session_id","is_host","audio_enabled","video_enabled","joined_at"],"title":"ParticipantResponse","description":"Response model for session participant"},"PartitionInfo":{"properties":{"name":{"type":"string","title":"Name"},"file_count":{"type":"integer","title":"File Count"},"total_bytes":{"type":"integer","title":"Total Bytes"},"total_mb":{"type":"number","title":"Total Mb"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Updated"}},"type":"object","required":["name","file_count","total_bytes","total_mb"],"title":"PartitionInfo","description":"Summary stats for a single lakehouse partition."},"PartitionSchemaField":{"properties":{"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"nullable":{"type":"boolean","title":"Nullable"}},"type":"object","required":["name","type","nullable"],"title":"PartitionSchemaField","description":"One column in a partition's Parquet schema."},"PartitionSchemaResponse":{"properties":{"name":{"type":"string","title":"Name"},"file_count":{"type":"integer","title":"File Count"},"total_bytes":{"type":"integer","title":"Total Bytes"},"total_mb":{"type":"number","title":"Total Mb"},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Updated"},"schema":{"items":{"$ref":"#/components/schemas/PartitionSchemaField"},"type":"array","title":"Schema"},"sample_rows":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sample Rows"},"sample_file":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sample File"}},"type":"object","required":["name","file_count","total_bytes","total_mb"],"title":"PartitionSchemaResponse","description":"Schema and sample rows for a single partition."},"PassportBankAccount":{"properties":{"provider":{"type":"string","title":"Provider","description":"Bank provider this account came from","default":"mercury"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name","description":"Masked display name, e.g. 'Mercury Checking ••••5728'"},"account_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Kind"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"active | stale"}},"type":"object","title":"PassportBankAccount","description":"A bank account as it appears on the passport.\n\n``account_name`` arrives already masked from Mercury (e.g. \"Mercury\nChecking ••••5728\"); no unmasked account or routing number is ever carried\non this model."},"PasswordChangeRequest":{"properties":{"current_password":{"type":"string","minLength":1,"title":"Current Password","description":"Current password for verification"},"new_password":{"type":"string","maxLength":128,"minLength":8,"title":"New Password","description":"New password (must be different from current)"}},"type":"object","required":["current_password","new_password"],"title":"PasswordChangeRequest","description":"Schema for password change request","example":{"current_password":"OldPassword123!","new_password":"NewSecurePassword456!"}},"PasswordChangeResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Success message"},"changed_at":{"type":"string","format":"date-time","title":"Changed At","description":"Timestamp of password change"}},"type":"object","required":["message","changed_at"],"title":"PasswordChangeResponse","description":"Schema for password change response","example":{"changed_at":"2024-01-27T12:00:00","message":"Password changed successfully"}},"PasswordReset":{"properties":{"email":{"type":"string","pattern":"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$","title":"Email","description":"User email address"}},"type":"object","required":["email"],"title":"PasswordReset","description":"Password reset request schema","example":{"email":"user@example.com"}},"PasswordResetConfirm":{"properties":{"token":{"type":"string","title":"Token","description":"Password reset token"},"new_password":{"type":"string","maxLength":128,"minLength":8,"title":"New Password","description":"New password"}},"type":"object","required":["token","new_password"],"title":"PasswordResetConfirm","description":"Password reset confirmation schema","example":{"new_password":"newsecurepassword123","token":"reset-token-here"}},"PasswordResetEmailRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email","description":"Recipient email address"},"reset_token":{"type":"string","minLength":10,"title":"Reset Token","description":"Password reset token"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url","description":"Custom callback URL (optional)"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id","description":"Organization UUID for branding (optional)"}},"type":"object","required":["email","reset_token"],"title":"PasswordResetEmailRequest","description":"Request model for password reset email","example":{"callback_url":"https://myapp.com/reset-password","email":"user@example.com","organization_id":"550e8400-e29b-41d4-a716-446655440000","reset_token":"abc123xyz789"}},"PatternAnalysisResponse":{"properties":{"pattern_id":{"type":"string","title":"Pattern Id"},"pattern_name":{"type":"string","title":"Pattern Name"},"description":{"type":"string","title":"Description"},"affected_prompts":{"items":{"type":"string"},"type":"array","title":"Affected Prompts"},"recommendation_count":{"type":"integer","title":"Recommendation Count"},"avg_impact_score":{"type":"number","title":"Avg Impact Score"},"pattern_frequency":{"type":"number","title":"Pattern Frequency"},"suggested_actions":{"items":{"type":"string"},"type":"array","title":"Suggested Actions"}},"type":"object","required":["pattern_id","pattern_name","description","affected_prompts","recommendation_count","avg_impact_score","pattern_frequency","suggested_actions"],"title":"PatternAnalysisResponse"},"PaymentIntentResponse":{"properties":{"client_secret":{"type":"string","title":"Client Secret","description":"Stripe Payment Intent client secret"},"publishable_key":{"type":"string","title":"Publishable Key","description":"Stripe publishable key"},"amount":{"type":"integer","title":"Amount","description":"Amount in cents"},"currency":{"type":"string","title":"Currency","description":"Currency code"},"invoice_id":{"type":"string","title":"Invoice Id","description":"Invoice ID"}},"type":"object","required":["client_secret","publishable_key","amount","currency","invoice_id"],"title":"PaymentIntentResponse","description":"Schema for payment intent creation response","example":{"amount":9900,"client_secret":"pi_xxx_secret_yyy","currency":"USD","invoice_id":"550e8400-e29b-41d4-a716-446655440000","publishable_key":"pk_live_xxx"}},"PaymentMethod":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"stripe_payment_method_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Payment Method Id"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"brand_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Display Name"},"last4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last4"},"exp_month":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Exp Month"},"exp_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Exp Year"},"is_default":{"type":"boolean","title":"Is Default","default":false},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","title":"PaymentMethod"},"PaymentMethodItem":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"bank_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bank Name"},"account_holder_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Holder Name"},"last4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last4"},"currency":{"type":"string","title":"Currency"},"is_default":{"type":"boolean","title":"Is Default"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","type","currency","is_default","status"],"title":"PaymentMethodItem"},"PaymentMethodResponse":{"properties":{"type":{"type":"string","title":"Type","description":"Payment method type (e.g., 'card')","example":"card"},"last4":{"type":"string","maxLength":4,"minLength":4,"title":"Last4","description":"Last 4 digits of card number","example":"4242"},"exp_month":{"type":"integer","maximum":12,"minimum":1,"title":"Exp Month","description":"Card expiration month (1-12)","example":12},"exp_year":{"type":"integer","minimum":2024,"title":"Exp Year","description":"Card expiration year","example":2025},"brand":{"type":"string","title":"Brand","description":"Card brand (visa, mastercard, etc.)","example":"visa"}},"type":"object","required":["type","last4","exp_month","exp_year","brand"],"title":"PaymentMethodResponse","description":"Payment method information - only exposes last 4 digits for security","example":{"brand":"visa","exp_month":12,"exp_year":2025,"last4":"4242","type":"card"}},"PaymentMethodsData":{"properties":{"payment_methods":{"items":{"$ref":"#/components/schemas/StripePaymentMethod"},"type":"array","title":"Payment Methods"}},"type":"object","required":["payment_methods"],"title":"PaymentMethodsData"},"PaymentMethodsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PaymentMethodsData"}},"type":"object","required":["success","data"],"title":"PaymentMethodsResponse","description":"Response for GET /billing/payment-methods."},"PaymentProofRequest":{"properties":{"payment_id":{"type":"string","title":"Payment Id","description":"Unique payment identifier"},"recipient":{"type":"string","title":"Recipient","description":"Payment recipient identifier"},"amount":{"type":"integer","exclusiveMinimum":0,"title":"Amount","description":"Payment amount"},"token":{"type":"string","title":"Token","description":"Token type (e.g. AINATIVE_CREDITS, USDC)"},"network":{"type":"string","title":"Network","description":"Payment network (ainative, hedera, circle)"},"instance_id":{"type":"string","title":"Instance Id","description":"Target MCP instance ID"},"payer_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payer Agent Id","description":"Paying agent identifier"},"tx_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tx Hash","description":"On-chain transaction hash"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","description":"ISO 8601 timestamp"}},"type":"object","required":["payment_id","recipient","amount","token","network","instance_id"],"title":"PaymentProofRequest","description":"Incoming x402 payment proof for verification."},"PaymentRequirementsResponse":{"properties":{"amount":{"type":"integer","title":"Amount"},"recipient":{"type":"string","title":"Recipient"},"token":{"type":"string","title":"Token"},"network":{"type":"string","title":"Network"},"description":{"type":"string","title":"Description"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"instance_id":{"type":"string","title":"Instance Id"},"tool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Name"}},"type":"object","required":["amount","recipient","token","network","description","instance_id"],"title":"PaymentRequirementsResponse","description":"x402 payment requirements for an MCP instance."},"PaymentVerificationResponse":{"properties":{"verified":{"type":"boolean","title":"Verified"},"payment_id":{"type":"string","title":"Payment Id"},"record_id":{"type":"string","title":"Record Id"},"instance_id":{"type":"string","title":"Instance Id"},"amount":{"type":"integer","title":"Amount"},"net_earnings":{"type":"integer","title":"Net Earnings"},"platform_fee":{"type":"integer","title":"Platform Fee"},"access_granted":{"type":"boolean","title":"Access Granted"}},"type":"object","required":["verified","payment_id","record_id","instance_id","amount","net_earnings","platform_fee","access_granted"],"title":"PaymentVerificationResponse","description":"Response after verifying an x402 payment proof."},"PaymentWebhookResult":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Id"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success","message"],"title":"PaymentWebhookResult","description":"Shape returned by handle_payment_intent_webhook — always 200 to Stripe.\n\n`error` is only present when processing raised after signature\nverification succeeded (still 200'd deliberately, see module docstring)."},"PaymentWebhookTestStatus":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"webhook_secret_configured":{"type":"boolean","title":"Webhook Secret Configured"},"stripe_api_key_configured":{"type":"boolean","title":"Stripe Api Key Configured"},"endpoint":{"type":"string","title":"Endpoint"},"supported_events":{"items":{"type":"string"},"type":"array","title":"Supported Events"}},"type":"object","required":["success","message","webhook_secret_configured","stripe_api_key_configured","endpoint","supported_events"],"title":"PaymentWebhookTestStatus"},"PayoutEligibilityCheck":{"properties":{"organizer_id":{"type":"string","title":"Organizer Id","description":"Organizer ID"},"pending_balance":{"type":"number","title":"Pending Balance","description":"Current pending balance in USD"},"payout_threshold":{"type":"number","title":"Payout Threshold","description":"Minimum required for payout","default":100},"eligible":{"type":"boolean","title":"Eligible","description":"Whether organizer is eligible for payout"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Explanation if not eligible"},"has_stripe_account":{"type":"boolean","title":"Has Stripe Account","description":"Whether organizer has Stripe Connect","default":false}},"type":"object","required":["organizer_id","pending_balance","eligible"],"title":"PayoutEligibilityCheck","description":"Result of a payout eligibility check."},"PayoutHistoryItem":{"properties":{"id":{"type":"string","title":"Id"},"amount_cents":{"type":"integer","title":"Amount Cents"},"stripe_transfer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Transfer Id"},"status":{"type":"string","title":"Status"},"earnings_period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Earnings Period Start"},"earnings_period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Earnings Period End"},"earnings_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Earnings Count"},"platform_fee_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Platform Fee Cents"},"net_payout_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Payout Cents"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["id","amount_cents","status"],"title":"PayoutHistoryItem"},"PayoutHistoryResponse":{"properties":{"payouts":{"items":{"$ref":"#/components/schemas/PayoutHistoryItem"},"type":"array","title":"Payouts"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["payouts","limit","offset","count"],"title":"PayoutHistoryResponse","description":"GET /developer/payouts/payout/history"},"PayoutListItem":{"properties":{"id":{"type":"string","title":"Id"},"amount_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Cents"},"stripe_transfer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Transfer Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["id"],"title":"PayoutListItem","description":"One row of list_payouts' projection (Refs #8449).\n\nDeliberately NOT PayoutHistoryItem: list_payouts SELECTs the same wide\nrow as get_payout_history but projects only these six keys, dropping\nearnings_period_*/earnings_count/platform_fee_cents/net_payout_cents.\nReusing the wider model would document period and fee fields that this\nendpoint never sends."},"PayoutListResponse":{"properties":{"payouts":{"items":{"$ref":"#/components/schemas/PayoutListItem"},"type":"array","title":"Payouts"},"total":{"type":"integer","title":"Total","default":0}},"type":"object","title":"PayoutListResponse","description":"GET /api/v1/public/developer/payouts and .../developer/earnings.\n\nServed by list_payouts, which is `@router.get(\"\")` registered BEFORE\nget_developer_earnings' identical `@router.get(\"\")` on the same router --\nso Starlette's in-order match makes list_payouts the live handler on\nboth paths and get_developer_earnings' EarningsResponse unreachable\nthere (it stays reachable at .../payouts/earnings and\n.../payouts/overview). Typed per the winning handler.\n\n`total` is len(payouts) on the returned page, not a full-table count --\nthe handler has no COUNT(*) query. On any DB error the handler's bare\n`except Exception` returns `{\"payouts\": [], \"total\": 0}`, which this\nmodel also accepts.\n\nNo extra=\"allow\": the payload is financial data projected from a\ndeveloper-scoped query (WHERE developer_id = caller), and the handler\ndeliberately drops the fee/period columns it selects. Allowing extras\nwould let a future widening of the projection leak them back out\nundeclared."},"PayoutProcessingResult":{"properties":{"total_organizers_checked":{"type":"integer","title":"Total Organizers Checked","description":"Total organizers evaluated","default":0},"eligible_organizers":{"type":"integer","title":"Eligible Organizers","description":"Number of eligible organizers","default":0},"successful_payouts":{"type":"integer","title":"Successful Payouts","description":"Number of successful payouts","default":0},"failed_payouts":{"type":"integer","title":"Failed Payouts","description":"Number of failed payouts","default":0},"total_amount_paid":{"type":"number","title":"Total Amount Paid","description":"Total amount paid out in USD","default":0},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","description":"List of error messages"},"processed_at":{"type":"string","format":"date-time","title":"Processed At"}},"type":"object","title":"PayoutProcessingResult","description":"Result of batch payout processing."},"PayoutRequest":{"properties":{"confirm":{"type":"boolean","title":"Confirm","description":"Confirm payout request","default":false}},"type":"object","title":"PayoutRequest","description":"Request for manual payout"},"PayoutResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"amount_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Cents"},"transfer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transfer Id"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"}},"type":"object","required":["success","message"],"title":"PayoutResponse","description":"Response for payout request"},"PayoutTransactionResponse":{"properties":{"payout_id":{"type":"string","title":"Payout Id","description":"Internal payout ID"},"stripe_payout_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Payout Id","description":"Stripe payout ID"},"organizer_id":{"type":"string","title":"Organizer Id","description":"Organizer ID"},"amount":{"type":"number","title":"Amount","description":"Payout amount in USD"},"status":{"type":"string","title":"Status","description":"Payout status (pending, completed, failed)"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Reason"}},"type":"object","required":["payout_id","organizer_id","amount","status"],"title":"PayoutTransactionResponse","description":"Response for a payout transaction."},"PeerComparisonResponse":{"properties":{"source":{"type":"string","title":"Source","description":"\"graph\" for a same-account peer gap, \"leaderboard\" for a public-leaderboard peer gap when no same-account peer exists, else \"percentile\""},"gaps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Gaps","description":"Named checks a real same-industry peer passes and this site does not; each carries the peer's domain, the check's display name, its AR-* category, the peer's own evidence, and a ready sentence. Always empty on the percentile fallback."},"peer_count":{"type":"integer","title":"Peer Count","description":"Same-account graph peers found. 0 with source=\"percentile\" or source=\"leaderboard\" means no same-account peer yet; >0 with source=\"percentile\" means same-account peers exist but none passes anything this site fails.","default":0},"percentile":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Percentile"},"measured":{"type":"boolean","title":"Measured","description":"False means the percentile derives from hand-set seed values, not measurements — the UI must not claim a rank (#9077).","default":false},"label":{"type":"string","title":"Label","default":""},"industry":{"type":"string","title":"Industry","default":""}},"type":"object","required":["source"],"title":"PeerComparisonResponse","description":"The brief's comparison section — graph arm, public-leaderboard arm\n(core#9517), or percentile fallback.\n\nAll three arms carry the same keys (see `PEER_COMPARISON_KEYS`) so the\nbrief has ONE renderer: AC-3 requires it never show a broken or empty\nsection, which is not achievable if the arms differ in shape."},"PeerSwarmHeartbeat":{"properties":{"peer_id":{"type":"string","title":"Peer Id","description":"Identifier for the peer node, e.g. 'tobys-macbook-air'"},"agents_active":{"type":"integer","minimum":0,"title":"Agents Active","description":"Number of active agents reported by the peer gateway"},"improvement_loops":{"type":"integer","minimum":0,"title":"Improvement Loops","description":"Session/loop count from the peer gateway","default":0},"gateway_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gateway Version","description":"OpenClaw version string, if available"},"agents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Agents","description":"List of active agent names"},"metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metrics","description":"Per-agent metrics (JSONB)"}},"type":"object","required":["peer_id","agents_active"],"title":"PeerSwarmHeartbeat"},"PendingApprovalsResponse":{"properties":{"pending":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_approvals__ApprovalRequestItem"},"type":"array","title":"Pending"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["pending","count"],"title":"PendingApprovalsResponse"},"PenguinModeResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"model":{"type":"string","title":"Model"}},"type":"object","required":["enabled","model"],"title":"PenguinModeResponse","description":"Penguin mode configuration (playful internal shim)."},"PercentileResponse":{"properties":{"score":{"type":"integer","title":"Score"},"industry":{"type":"string","title":"Industry"},"percentile":{"type":"integer","title":"Percentile"},"industry_median":{"type":"integer","title":"Industry Median"},"your_position":{"type":"string","title":"Your Position"},"is_estimated":{"type":"boolean","title":"Is Estimated","default":true}},"type":"object","required":["score","industry","percentile","industry_median","your_position"],"title":"PercentileResponse"},"PerformanceAlertRow":{"properties":{"id":{"type":"integer","title":"Id"},"type":{"type":"string","title":"Type"},"severity":{"type":"string","title":"Severity"},"message":{"type":"string","title":"Message"},"endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint"},"metric_value":{"type":"number","title":"Metric Value"},"threshold":{"type":"number","title":"Threshold"},"timestamp":{"type":"string","title":"Timestamp"},"resolved":{"type":"boolean","title":"Resolved"}},"additionalProperties":true,"type":"object","required":["id","type","severity","message","metric_value","threshold","timestamp","resolved"],"title":"PerformanceAlertRow","description":"One alert row. `endpoint` is Optional on the dataclass itself."},"PerformanceAlertStatistics":{"properties":{"total_alerts":{"type":"integer","title":"Total Alerts"},"active_alerts":{"type":"integer","title":"Active Alerts"},"critical_alerts":{"type":"integer","title":"Critical Alerts"},"resolved_alerts":{"type":"integer","title":"Resolved Alerts"},"alert_types":{"additionalProperties":{"type":"integer"},"type":"object","title":"Alert Types"}},"additionalProperties":true,"type":"object","required":["total_alerts","active_alerts","critical_alerts","resolved_alerts","alert_types"],"title":"PerformanceAlertStatistics","description":"Alert rollups. `alert_types` is keyed by live alert_type values."},"PerformanceAlertsResponse":{"properties":{"alerts":{"items":{"$ref":"#/components/schemas/PerformanceAlertRow"},"type":"array","title":"Alerts"},"statistics":{"$ref":"#/components/schemas/PerformanceAlertStatistics"},"filters_applied":{"additionalProperties":true,"type":"object","title":"Filters Applied"}},"additionalProperties":true,"type":"object","required":["alerts","statistics","filters_applied"],"title":"PerformanceAlertsResponse","description":"GET /alerts -- always fully populated, even with zero alerts."},"PerformanceAnalyticsMetrics":{"properties":{"response_time_ms":{"type":"number","title":"Response Time Ms"},"throughput_rps":{"type":"integer","title":"Throughput Rps"},"error_rate":{"type":"number","title":"Error Rate"},"cache_hit_rate":{"type":"number","title":"Cache Hit Rate"}},"type":"object","required":["response_time_ms","throughput_rps","error_rate","cache_hit_rate"],"title":"PerformanceAnalyticsMetrics"},"PerformanceAnalyticsResponse":{"properties":{"metrics":{"$ref":"#/components/schemas/PerformanceAnalyticsMetrics"},"time_range":{"type":"string","title":"Time Range"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["metrics","time_range","timestamp"],"title":"PerformanceAnalyticsResponse","description":"Response for GET /analytics/performance."},"PerformanceHistory":{"properties":{"available":{"type":"boolean","title":"Available"},"hours_requested":{"type":"integer","title":"Hours Requested"},"request_history":{"items":{"$ref":"#/components/schemas/RequestHistoryPoint"},"type":"array","title":"Request History"},"token_history":{"items":{"$ref":"#/components/schemas/TokenHistoryPoint"},"type":"array","title":"Token History"}},"type":"object","required":["available","hours_requested","request_history","token_history"],"title":"PerformanceHistory"},"PerformanceIndicators":{"properties":{"query_performance":{"type":"string","title":"Query Performance"},"index_efficiency":{"type":"string","title":"Index Efficiency"},"cache_hit_ratio":{"type":"string","title":"Cache Hit Ratio"},"connection_efficiency":{"type":"string","title":"Connection Efficiency"}},"type":"object","required":["query_performance","index_efficiency","cache_hit_ratio","connection_efficiency"],"title":"PerformanceIndicators"},"PerformanceMetricsBreakdown":{"properties":{"system":{"anyOf":[{"$ref":"#/components/schemas/SystemMetricsTimeseries"},{"type":"null"}]},"application":{"anyOf":[{"$ref":"#/components/schemas/ApplicationMetricsTimeseries"},{"type":"null"}]},"database":{"anyOf":[{"$ref":"#/components/schemas/DatabaseMetricsTimeseries"},{"type":"null"}]},"network":{"anyOf":[{"$ref":"#/components/schemas/NetworkMetricsTimeseries"},{"type":"null"}]}},"type":"object","title":"PerformanceMetricsBreakdown","description":"Only the sections matching the requested (or all) metric_type are\npopulated by the handler -- all Optional to reflect that."},"PerformanceMetricsData":{"properties":{"current":{"$ref":"#/components/schemas/app__schemas__dashboard_stats_public__SystemMetrics"},"history":{"$ref":"#/components/schemas/PerformanceHistory"}},"type":"object","required":["current","history"],"title":"PerformanceMetricsData"},"PerformanceRecommendationRow":{"properties":{"type":{"type":"string","title":"Type"},"priority":{"type":"string","title":"Priority"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"action":{"type":"string","title":"Action"}},"additionalProperties":true,"type":"object","required":["type","priority","title","description","action"],"title":"PerformanceRecommendationRow","description":"One generated recommendation (all five fields are always set)."},"PerformanceRecommendationsResponse":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/PerformanceRecommendationRow"},"type":"array","title":"Recommendations"},"generated_at":{"type":"string","title":"Generated At"},"total_recommendations":{"type":"integer","title":"Total Recommendations"},"priority_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Priority Counts"}},"additionalProperties":true,"type":"object","required":["recommendations","generated_at","total_recommendations","priority_counts"],"title":"PerformanceRecommendationsResponse","description":"GET /recommendations."},"PerformanceReportResponse":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"report_period":{"additionalProperties":true,"type":"object","title":"Report Period"},"performance_summary":{"additionalProperties":true,"type":"object","title":"Performance Summary"},"versions_performance":{"additionalProperties":true,"type":"object","title":"Versions Performance"},"ab_test_results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Ab Test Results"},"quality_trends":{"additionalProperties":true,"type":"object","title":"Quality Trends"},"benchmark_comparison":{"additionalProperties":true,"type":"object","title":"Benchmark Comparison"},"usage_analytics":{"additionalProperties":true,"type":"object","title":"Usage Analytics"},"error_analysis":{"additionalProperties":true,"type":"object","title":"Error Analysis"},"optimization_recommendations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Optimization Recommendations"}},"type":"object","required":["prompt_id","report_period","performance_summary","versions_performance","ab_test_results","quality_trends","benchmark_comparison","usage_analytics","error_analysis","optimization_recommendations"],"title":"PerformanceReportResponse"},"PerformanceThresholdLevels":{"properties":{"response_time_warning":{"type":"number","title":"Response Time Warning"},"response_time_critical":{"type":"number","title":"Response Time Critical"},"cost_warning":{"type":"number","title":"Cost Warning"}},"type":"object","required":["response_time_warning","response_time_critical","cost_warning"],"title":"PerformanceThresholdLevels"},"PerformanceTrends":{"properties":{"hit_ratio_trend":{"items":{"$ref":"#/components/schemas/app__schemas__admin__caching__TrendPoint"},"type":"array","title":"Hit Ratio Trend"},"response_time_trend":{"items":{"$ref":"#/components/schemas/app__schemas__admin__caching__TrendPoint"},"type":"array","title":"Response Time Trend"},"memory_usage_trend":{"items":{"$ref":"#/components/schemas/app__schemas__admin__caching__TrendPoint"},"type":"array","title":"Memory Usage Trend"},"throughput_trend":{"items":{"$ref":"#/components/schemas/app__schemas__admin__caching__TrendPoint"},"type":"array","title":"Throughput Trend"}},"type":"object","required":["hit_ratio_trend","response_time_trend","memory_usage_trend","throughput_trend"],"title":"PerformanceTrends"},"PerformanceValidationResult":{"properties":{"passed":{"type":"boolean","title":"Passed"},"failures":{"items":{"type":"string"},"type":"array","title":"Failures"},"metrics":{"additionalProperties":true,"type":"object","title":"Metrics"}},"type":"object","required":["passed","failures"],"title":"PerformanceValidationResult","description":"The live validation result nested under ``current_validation``.\n\nModeled loosely (``Dict[str, Any]`` for ``metrics``) because\n``_validate_performance_baseline`` returns ``metrics: {}`` on its\nexception branch (no fixed numeric fields guaranteed) alongside the\npopulated case's four float metrics."},"PeriodResolveResponse":{"properties":{"key":{"type":"string","title":"Key"},"period":{"additionalProperties":true,"type":"object","title":"Period"},"comparison_period":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Comparison Period"}},"type":"object","required":["key","period"],"title":"PeriodResolveResponse"},"PermissionItem":{"properties":{"permission_id":{"type":"string","title":"Permission Id"},"role":{"type":"string","title":"Role"},"grantee_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grantee User Id"},"grantee_api_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grantee Api Key Id"},"model_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Scope"},"granted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Granted At"},"revoked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revoked At"}},"type":"object","required":["permission_id","role"],"title":"PermissionItem"},"PermissionsManifest":{"properties":{"allowed_tools":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Tools","description":"Whitelist of MCP tool names this key may invoke. Omit to allow all tools."},"allowed_namespaces":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Namespaces","description":"Whitelist of namespaces this key may access. Valid formats: 'global', 'project:', 'project/', 'session:'. Omit to allow all namespaces."},"denied_routes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Denied Routes","description":"Glob patterns for routes this key is explicitly denied. Example: '/api/v1/billing/**'. Supports ** wildcard."},"max_memory_bytes":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Max Memory Bytes","description":"Maximum memory this key may store, in bytes. Max: 104857600 (100MB)."}},"type":"object","title":"PermissionsManifest","description":"RBAC permission manifest for an agent API key (Issue #2891)."},"PermissionsRequest":{"properties":{"permissions":{"additionalProperties":true,"type":"object","title":"Permissions"}},"type":"object","required":["permissions"],"title":"PermissionsRequest"},"PermissionsResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"permissions":{"additionalProperties":true,"type":"object","title":"Permissions"}},"type":"object","required":["permissions"],"title":"PermissionsResponse"},"PhoneLoginRequest":{"properties":{"phone":{"type":"string","title":"Phone","description":"Phone number in any reasonable format; normalized to E.164 server-side."},"otp_code":{"type":"string","title":"Otp Code","description":"6-digit code from /auth/send-phone-otp (purpose=login)."}},"type":"object","required":["phone","otp_code"],"title":"PhoneLoginRequest","description":"Schema for POST /auth/login-phone (Refs #8459)."},"PhoneRegisterRequest":{"properties":{"phone":{"type":"string","title":"Phone","description":"Phone number in any reasonable format; normalized to E.164 server-side."},"otp_code":{"type":"string","title":"Otp Code","description":"6-digit code from /auth/send-phone-otp (purpose=register)."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"preferred_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preferred Name"},"ext":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ext","description":"Ad attribution data (gclid, utm_source, utm_medium, etc.)"},"signup_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signup Source","description":"Where the signup came from, same semantics as UserCreate.signup_source."}},"type":"object","required":["phone","otp_code"],"title":"PhoneRegisterRequest","description":"Schema for POST /auth/register-phone (Refs #8459).\n\nMirrors UserCreate's attribution fields (ext/signup_source) so phone\nsignups get the same client-app + ad attribution as /register\n(core#8424's signup_client_id fix, resolve_signup_client_id())."},"PhoneUpdateRequest":{"properties":{"new_phone_number":{"type":"string","maxLength":20,"minLength":10,"title":"New Phone Number","description":"New phone number in E.164 format"},"verification_code":{"type":"string","maxLength":6,"minLength":6,"title":"Verification Code","description":"Current 2FA code for verification"}},"type":"object","required":["new_phone_number","verification_code"],"title":"PhoneUpdateRequest","description":"Request to update phone number","example":{"new_phone_number":"+14155552672","verification_code":"123456"}},"PlacementType":{"type":"string","enum":["header","sidebar","content","video","footer"],"title":"PlacementType","description":"Ad placement types on event pages"},"PlanArtifactCreate":{"properties":{"title":{"type":"string","maxLength":200,"title":"Title"},"type":{"type":"string","enum":["plan","prd","task"],"title":"Type","default":"plan"},"content":{"type":"string","title":"Content","description":"Markdown content of the plan/PRD/task"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["title","content"],"title":"PlanArtifactCreate"},"PlanArtifactResponse":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"type":{"type":"string","title":"Type"},"content":{"type":"string","title":"Content"},"status":{"type":"string","title":"Status"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","title","type","content","status","session_id","created_at","updated_at"],"title":"PlanArtifactResponse"},"PlanArtifactUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"status":{"anyOf":[{"type":"string","enum":["draft","active","completed"]},{"type":"null"}],"title":"Status"}},"type":"object","title":"PlanArtifactUpdate"},"PlanHistoryEntry":{"properties":{"version":{"type":"integer","title":"Version"},"updated_at":{"type":"string","title":"Updated At"},"diff":{"type":"string","title":"Diff"}},"type":"object","required":["version","updated_at","diff"],"title":"PlanHistoryEntry"},"PlanInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"interval":{"type":"string","title":"Interval","default":"month"}},"type":"object","required":["id","name"],"title":"PlanInfo"},"PlansData":{"properties":{"plans":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Plans"},"plan_family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Family"}},"additionalProperties":true,"type":"object","title":"PlansData","description":"The `data` envelope of the plan-catalog routes.\n\n`plans` stays an open List[Dict[str, Any]] on purpose. The two backing\nservices return DIFFERENT key sets for a plan —\nplan_catalog_service._row_to_dict yields 20 keys (credits,\nincluded_llm_tokens, trial_period_days, button_text, …) while\nide_cli_plan_service.get_ide_cli_plans_from_db yields a different 19\n(plan_family, per_seat, completions_per_month, codebase_indexing, …) — and\n`plan_family=all` concatenates both in one list. A strict per-plan schema\nwould silently drop whichever keys it did not enumerate, breaking the\npricing page for one family or the other."},"PlansResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/PlansData"}},"additionalProperties":true,"type":"object","required":["data"],"title":"PlansResponse"},"PlatformAgentSummary":{"properties":{"agents_running":{"type":"integer","title":"Agents Running"},"total_traces_today":{"type":"integer","title":"Total Traces Today"},"error_rate_today":{"type":"number","title":"Error Rate Today"},"total_credits_today":{"type":"number","title":"Total Credits Today"},"memory_ops_today":{"type":"integer","title":"Memory Ops Today"},"improvement_ops_today":{"type":"integer","title":"Improvement Ops Today"},"period":{"type":"string","title":"Period","default":"24h"}},"type":"object","required":["agents_running","total_traces_today","error_rate_today","total_credits_today","memory_ops_today","improvement_ops_today"],"title":"PlatformAgentSummary"},"PlatformAnalyticsResponse":{"properties":{"active_sessions":{"type":"integer","title":"Active Sessions"},"total_active_users":{"type":"integer","title":"Total Active Users"},"total_active_agents":{"type":"integer","title":"Total Active Agents"},"total_connections":{"type":"integer","title":"Total Connections"},"platform_metrics":{"additionalProperties":true,"type":"object","title":"Platform Metrics"},"sessions_summary":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sessions Summary"}},"type":"object","required":["active_sessions","total_active_users","total_active_agents","total_connections","platform_metrics","sessions_summary"],"title":"PlatformAnalyticsResponse","description":"Platform collaboration analytics"},"PlatformInfo":{"properties":{"system":{"type":"string","title":"System"},"release":{"type":"string","title":"Release"},"machine":{"type":"string","title":"Machine"},"processor":{"type":"string","title":"Processor"}},"type":"object","required":["system","release","machine","processor"],"title":"PlatformInfo"},"PlatformIntelligenceResponse":{"properties":{"stats":{"$ref":"#/components/schemas/PlatformIntelligenceStats"},"agent_events":{"items":{"$ref":"#/components/schemas/AgentEvent"},"type":"array","title":"Agent Events"},"recent_memories":{"anyOf":[{"items":{"$ref":"#/components/schemas/RecentMemory"},"type":"array"},{"type":"null"}],"title":"Recent Memories"},"lake":{"anyOf":[{"$ref":"#/components/schemas/LakeAnalytics"},{"type":"null"}]},"ads":{"anyOf":[{"$ref":"#/components/schemas/AdsStats"},{"type":"null"}]},"stack":{"anyOf":[{"items":{"$ref":"#/components/schemas/StackService"},"type":"array"},{"type":"null"}],"title":"Stack"},"recursive_loops":{"anyOf":[{"$ref":"#/components/schemas/RecursiveLoopMetrics"},{"type":"null"}]},"growth":{"anyOf":[{"$ref":"#/components/schemas/GrowthMetrics"},{"type":"null"}]},"stale":{"type":"boolean","title":"Stale","default":false},"warming":{"type":"boolean","title":"Warming","default":false},"window":{"type":"string","title":"Window","default":"daily"},"ok":{"type":"boolean","title":"Ok"}},"type":"object","required":["stats","agent_events","ok"],"title":"PlatformIntelligenceResponse"},"PlatformIntelligenceStats":{"properties":{"uptime_pct":{"type":"number","title":"Uptime Pct"},"requests_total":{"type":"integer","title":"Requests Total"},"agents_active":{"type":"integer","title":"Agents Active"},"models_served":{"type":"integer","title":"Models Served"},"memory_queries_today":{"type":"integer","title":"Memory Queries Today"},"total_memories":{"type":"integer","title":"Total Memories","default":0},"memories_stored_today":{"type":"integer","title":"Memories Stored Today","default":0},"tasks_completed_today":{"type":"integer","title":"Tasks Completed Today"},"tokens_processed_today":{"type":"integer","title":"Tokens Processed Today"},"tokens_window":{"type":"string","title":"Tokens Window","default":"today"},"improvement_loops":{"type":"integer","title":"Improvement Loops"},"improvement_loops_db_verified":{"type":"integer","title":"Improvement Loops Db Verified","default":0},"improvement_loops_self_reported":{"type":"integer","title":"Improvement Loops Self Reported","default":0},"last_updated":{"type":"string","title":"Last Updated"},"latency_p99_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latency P99 Ms"},"window":{"type":"string","title":"Window","default":"daily"}},"type":"object","required":["uptime_pct","requests_total","agents_active","models_served","memory_queries_today","tasks_completed_today","tokens_processed_today","improvement_loops","last_updated"],"title":"PlatformIntelligenceStats"},"PluginCreateRequest":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name"},"version":{"type":"string","maxLength":32,"minLength":1,"title":"Version"},"description":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Description"},"tools":{"items":{"$ref":"#/components/schemas/ToolSchema"},"type":"array","minItems":1,"title":"Tools","description":"At least one tool is required"},"npm_package":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Npm Package"},"pypi_package":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Pypi Package"},"visibility":{"type":"string","enum":["public","private","org"],"title":"Visibility","description":"public, private, or org","default":"private"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"}},"type":"object","required":["name","version","tools"],"title":"PluginCreateRequest","description":"Body for POST /plugins."},"PluginListResponse":{"properties":{"plugins":{"items":{"$ref":"#/components/schemas/PluginResponse"},"type":"array","title":"Plugins"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["plugins","total","page","page_size"],"title":"PluginListResponse","description":"Paginated plugin list."},"PluginResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"author_id":{"type":"string","title":"Author Id"},"tools":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tools"},"npm_package":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Npm Package"},"pypi_package":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pypi Package"},"visibility":{"type":"string","title":"Visibility"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"install_count":{"type":"integer","title":"Install Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","version","author_id","tools","visibility","tags","install_count","created_at","updated_at"],"title":"PluginResponse","description":"Response for a single plugin."},"PluginUpdateRequest":{"properties":{"version":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Version"},"description":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Description"},"tools":{"anyOf":[{"items":{"$ref":"#/components/schemas/ToolSchema"},"type":"array"},{"type":"null"}],"title":"Tools"},"npm_package":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Npm Package"},"pypi_package":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Pypi Package"},"visibility":{"anyOf":[{"type":"string","enum":["public","private","org"]},{"type":"null"}],"title":"Visibility"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"}},"type":"object","title":"PluginUpdateRequest","description":"Body for PUT /plugins/{plugin_id}."},"PointInTimeRecoveryCapability":{"properties":{"available":{"type":"boolean","title":"Available"},"max_recovery_age_days":{"type":"integer","title":"Max Recovery Age Days"},"granularity_minutes":{"type":"integer","title":"Granularity Minutes"}},"type":"object","required":["available","max_recovery_age_days","granularity_minutes"],"title":"PointInTimeRecoveryCapability"},"PolicyDeleteResponse":{"properties":{"detail":{"type":"string","title":"Detail","description":"Human-readable confirmation"},"policy_id":{"type":"string","title":"Policy Id","description":"The policy that was soft-deleted"}},"type":"object","required":["detail","policy_id"],"title":"PolicyDeleteResponse","description":"Confirmation body for the soft-delete route (Refs #8449).\n\nBoth keys are unconditional on the 200 path — the handler returns one flat\ndict literal with no branch-dependent fields — so no\n`response_model_exclude_unset` is needed. `policy_id` echoes the path\nparam verbatim and is therefore a plain `str`, not a UUID."},"PolicyLimitsResponse":{"properties":{"allowed_tools":{"items":{"type":"string"},"type":"array","title":"Allowed Tools"},"blocked_tools":{"items":{"type":"string"},"type":"array","title":"Blocked Tools"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens"},"allowed_models":{"items":{"type":"string"},"type":"array","title":"Allowed Models"},"require_approval_for":{"items":{"type":"string"},"type":"array","title":"Require Approval For"},"custom_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Instructions"}},"type":"object","title":"PolicyLimitsResponse","description":"Policy limits for the CLI client (empty = no restrictions)."},"PolicyResponse":{"properties":{"id":{"type":"string","title":"Id"},"workspace_id":{"type":"string","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"default_effect":{"type":"string","title":"Default Effect"},"enforcement_mode":{"type":"string","title":"Enforcement Mode"},"intent_classifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent Classifier"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By"},"current_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Version"},"rules":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Rules"}},"type":"object","required":["id","workspace_id","name","status","default_effect","enforcement_mode"],"title":"PolicyResponse"},"PolicyRuleSchema":{"properties":{"priority":{"type":"integer","title":"Priority","default":0},"effect":{"type":"string","pattern":"^(allow|deny|require_approval)$","title":"Effect"},"tool":{"type":"string","title":"Tool","default":"*"},"capability":{"type":"string","title":"Capability","default":"*"},"target":{"type":"string","title":"Target","default":"*"},"arg_predicates":{"additionalProperties":true,"type":"object","title":"Arg Predicates"},"scope":{"additionalProperties":true,"type":"object","title":"Scope"},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["effect"],"title":"PolicyRuleSchema"},"PolicyThreshold":{"properties":{"threshold":{"type":"integer","title":"Threshold"},"comparison":{"type":"string","title":"Comparison"},"evaluation_periods":{"type":"integer","title":"Evaluation Periods"},"period_seconds":{"type":"integer","title":"Period Seconds"},"adjustment_type":{"type":"string","title":"Adjustment Type"},"adjustment_value":{"type":"integer","title":"Adjustment Value"},"cooldown_seconds":{"type":"integer","title":"Cooldown Seconds"}},"type":"object","required":["threshold","comparison","evaluation_periods","period_seconds","adjustment_type","adjustment_value","cooldown_seconds"],"title":"PolicyThreshold"},"PolicyUpdateDetails":{"properties":{"updated_policies":{"items":{"type":"string"},"type":"array","title":"Updated Policies"},"applied_at":{"type":"string","title":"Applied At"},"applied_by":{"title":"Applied By"},"validation_results":{"additionalProperties":{"type":"string"},"type":"object","title":"Validation Results"}},"type":"object","required":["updated_policies","applied_at","applied_by","validation_results"],"title":"PolicyUpdateDetails"},"PoolListResponse":{"properties":{"pools":{"items":{"$ref":"#/components/schemas/PoolStatusResponse"},"type":"array","title":"Pools"},"total_pools":{"type":"integer","title":"Total Pools"}},"type":"object","required":["pools","total_pools"],"title":"PoolListResponse"},"PoolMetricsResponse":{"properties":{"total_pools":{"type":"integer","title":"Total Pools"},"total_warm":{"type":"integer","title":"Total Warm"},"total_in_use":{"type":"integer","title":"Total In Use"},"total_capacity":{"type":"integer","title":"Total Capacity"},"overall_hit_rate":{"type":"number","title":"Overall Hit Rate"},"cold_start_distribution":{"additionalProperties":true,"type":"object","title":"Cold Start Distribution"},"regions":{"items":{"$ref":"#/components/schemas/PoolStatusResponse"},"type":"array","title":"Regions"}},"type":"object","required":["total_pools","total_warm","total_in_use","total_capacity","overall_hit_rate","cold_start_distribution","regions"],"title":"PoolMetricsResponse"},"PoolStatusResponse":{"properties":{"region":{"type":"string","title":"Region"},"total_size":{"type":"integer","title":"Total Size"},"warm_count":{"type":"integer","title":"Warm Count"},"in_use_count":{"type":"integer","title":"In Use Count"},"target_size":{"type":"integer","title":"Target Size"},"min_size":{"type":"integer","title":"Min Size"},"max_size":{"type":"integer","title":"Max Size"},"auto_drain_enabled":{"type":"boolean","title":"Auto Drain Enabled"},"last_acquisition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Acquisition"},"last_resize":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Resize"},"hit_rate":{"type":"number","title":"Hit Rate"}},"type":"object","required":["region","total_size","warm_count","in_use_count","target_size","min_size","max_size","auto_drain_enabled","hit_rate"],"title":"PoolStatusResponse"},"PopularCategoriesResponse":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/PopularCategory"},"type":"array","title":"Categories","description":"Popular categories ranked by viewer count"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Total number of categories returned"}},"type":"object","required":["categories","total"],"title":"PopularCategoriesResponse","description":"Schema for popular categories response (Issue #378)","example":{"categories":[{"id":"123e4567-e89b-12d3-a456-426614174000","live_stream_count":25,"name":"Technology","slug":"technology","stream_count":342,"total_viewers":1523}],"total":20}},"PopularCategory":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon Url"},"stream_count":{"type":"integer","minimum":0,"title":"Stream Count","description":"Total streams in category"},"live_stream_count":{"type":"integer","minimum":0,"title":"Live Stream Count","description":"Current live streams"},"total_viewers":{"type":"integer","minimum":0,"title":"Total Viewers","description":"Total concurrent viewers"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","slug","stream_count","live_stream_count","total_viewers"],"title":"PopularCategory","description":"Schema for popular category in ranking (Issue #378)","example":{"created_at":"2025-01-01T00:00:00Z","description":"Technology and programming streams","icon_url":"https://storage.ainative.studio/icons/tech.svg","id":"123e4567-e89b-12d3-a456-426614174000","live_stream_count":25,"name":"Technology","slug":"technology","stream_count":342,"total_viewers":1523,"updated_at":"2025-12-23T14:30:00Z"}},"PopularProjectTypeEntry":{"properties":{"type":{"type":"string","title":"Type"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["type","count"],"title":"PopularProjectTypeEntry"},"PopularSearchesResponse":{"properties":{"searches":{"items":{"type":"string"},"type":"array","title":"Searches","description":"List of popular search terms"}},"type":"object","required":["searches"],"title":"PopularSearchesResponse","description":"Popular search terms","example":{"searches":["Python programming","Web development","Game development","AI and machine learning","Mobile app development"]}},"PopularTag":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"stream_count":{"type":"integer","title":"Stream Count","description":"Current number of streams with this tag"},"live_stream_count":{"type":"integer","title":"Live Stream Count","description":"Number of live streams with this tag"}},"type":"object","required":["id","name","slug","stream_count","live_stream_count"],"title":"PopularTag","description":"Popular/trending tag with additional metrics","example":{"id":"tag-1111-2222-3333-4444-555566667777","live_stream_count":8,"name":"FastAPI","slug":"fastapi","stream_count":42}},"PopularTagsResponse":{"properties":{"tags":{"items":{"$ref":"#/components/schemas/PopularTag"},"type":"array","title":"Tags"},"total":{"type":"integer","title":"Total","description":"Total number of popular tags returned"}},"type":"object","required":["tags","total"],"title":"PopularTagsResponse","description":"Response for popular/trending tags","example":{"tags":[{"id":"tag-1111-2222-3333-4444-555566667777","live_stream_count":8,"name":"FastAPI","slug":"fastapi","stream_count":42}],"total":20}},"PopulateSlugsResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable outcome"},"updated":{"type":"integer","minimum":0,"title":"Updated","description":"Number of models given a slug"}},"type":"object","required":["message","updated"],"title":"PopulateSlugsResponse","description":"Result of the one-time slug backfill. Refs #1153, typed in #8449.\n\nBoth branches (nothing-to-do and backfilled-N) return exactly these two\nfields, so this is a closed shape — no extra=\"allow\" needed."},"PostCodySettingsResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"settings":{"additionalProperties":true,"type":"object","title":"Settings"}},"type":"object","required":["ok","settings"],"title":"PostCodySettingsResponse"},"PostCreate":{"properties":{"content":{"type":"string","maxLength":10000,"minLength":1,"title":"Content","description":"Post text content (required)"},"media_urls":{"items":{"type":"string"},"type":"array","title":"Media Urls","description":"Array of media URLs (images/videos)"},"visibility":{"$ref":"#/components/schemas/PostVisibility","description":"Post visibility level","default":"public"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Array of tags"},"location":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Location","description":"Location string"},"is_nsfw":{"type":"boolean","title":"Is Nsfw","description":"NSFW content flag","default":false}},"type":"object","required":["content"],"title":"PostCreate","description":"Schema for creating a new post","example":{"content":"Hello, world! This is my first post.","media_urls":["https://cdn.example.com/image1.jpg"],"tags":["introduction","hello"],"visibility":"public"}},"PostLoveActionResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the operation succeeded"},"message":{"type":"string","title":"Message","description":"Human-readable result message"},"post_id":{"type":"string","title":"Post Id","description":"Post that was loved"},"loves_count":{"type":"integer","title":"Loves Count","description":"Post's love count after the operation"},"is_new":{"type":"boolean","title":"Is New","description":"False when the user had already loved this post"}},"additionalProperties":true,"type":"object","required":["success","message","post_id","loves_count","is_new"],"title":"PostLoveActionResponse","description":"Result of loving a post.\n\nKept separate from PostUnloveActionResponse: love returns `is_new` and\nunlove returns `was_removed`. A single shared model with both optional\nwould emit the irrelevant one as null on each route, inventing a field\nthe service never set."},"PostLovePagination":{"properties":{"skip":{"type":"integer","title":"Skip","description":"Records skipped"},"limit":{"type":"integer","title":"Limit","description":"Page size"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more records follow this page"}},"additionalProperties":true,"type":"object","required":["skip","limit","has_more"],"title":"PostLovePagination","description":"Pagination envelope for the post-loves listing."},"PostLoveUser":{"properties":{"user_id":{"type":"string","title":"User Id","description":"User ID"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username","description":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name","description":"Display name, if set"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"Avatar URL, if set"},"loved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Loved At","description":"ISO timestamp of the love"}},"additionalProperties":true,"type":"object","required":["user_id"],"title":"PostLoveUser","description":"One user who loved a post.\n\nThese are the only user-identifying fields ContentService.get_post_loves\nemits; full_name and avatar_url are genuinely nullable on the User model,\nso they are Optional and must serialize as null rather than be omitted."},"PostLovesListResponse":{"properties":{"post_id":{"type":"string","title":"Post Id","description":"Post ID"},"total_count":{"type":"integer","title":"Total Count","description":"Total loves across all pages"},"loves":{"items":{"$ref":"#/components/schemas/PostLoveUser"},"type":"array","title":"Loves","description":"Users on this page (empty list when the post has no loves)"},"pagination":{"$ref":"#/components/schemas/PostLovePagination","description":"Pagination metadata"}},"additionalProperties":true,"type":"object","required":["post_id","total_count","loves","pagination"],"title":"PostLovesListResponse","description":"Paginated list of users who loved a post.\n\nShape is uniform across the cases the review asked about: a post with\nloves and a post with zero loves both return this envelope (with `loves`\nan empty list and total_count 0); a non-existent post raises 404 instead,\nso no Union is needed. response_model_exclude_unset is deliberately NOT\nused — it would strip the empty `loves` list and the 0 counts."},"PostRecommendationsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total number of results"},"limit":{"type":"integer","title":"Limit","description":"Results per page"},"offset":{"type":"integer","title":"Offset","description":"Results offset"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results exist"},"posts":{"items":{"$ref":"#/components/schemas/app__schemas__search__RecommendedPost"},"type":"array","title":"Posts","description":"Recommended posts"}},"type":"object","required":["total","limit","offset","has_more"],"title":"PostRecommendationsResponse","description":"Post recommendations response"},"PostResponse":{"properties":{"content":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Content","description":"Post text content (max 10,000 chars)"},"media_urls":{"items":{"type":"string"},"type":"array","title":"Media Urls","description":"Array of media URLs (images/videos)"},"visibility":{"$ref":"#/components/schemas/PostVisibility","description":"Post visibility level","default":"public"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Array of tags"},"location":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Location","description":"Location string"},"is_nsfw":{"type":"boolean","title":"Is Nsfw","description":"NSFW content flag","default":false},"id":{"type":"string","format":"uuid","title":"Id","description":"Post unique identifier"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id","description":"Tenant identifier"},"author_id":{"type":"string","format":"uuid","title":"Author Id","description":"Post author user ID"},"group_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Group Id","description":"Associated group ID"},"post_type":{"type":"string","title":"Post Type","description":"Post type","default":"text"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Post title"},"loves_count":{"type":"integer","title":"Loves Count","description":"Number of loves/likes","default":0},"comments_count":{"type":"integer","title":"Comments Count","description":"Number of comments","default":0},"bookmarks_count":{"type":"integer","title":"Bookmarks Count","description":"Number of bookmarks","default":0},"shares_count":{"type":"integer","title":"Shares Count","description":"Number of shares","default":0},"views_count":{"type":"integer","title":"Views Count","description":"Number of views","default":0},"moderation_status":{"type":"string","title":"Moderation Status","description":"Moderation status","default":"pending"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At","description":"Publication timestamp"},"deleted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deleted At","description":"Deletion timestamp"}},"type":"object","required":["id","tenant_id","author_id","created_at"],"title":"PostResponse","description":"Schema for post responses","example":{"author_id":"123e4567-e89b-12d3-a456-426614174002","bookmarks_count":1,"comments_count":2,"content":"Hello, world!","created_at":"2025-01-20T12:00:00Z","id":"123e4567-e89b-12d3-a456-426614174000","loves_count":5,"media_urls":[],"moderation_status":"approved","published_at":"2025-01-20T12:00:00Z","shares_count":0,"tags":["introduction"],"tenant_id":"123e4567-e89b-12d3-a456-426614174001","views_count":100,"visibility":"public"}},"PostSearchResult":{"properties":{"id":{"type":"string","title":"Id","description":"Post ID"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Post title"},"body":{"type":"string","title":"Body","description":"Post body (truncated)"},"user_id":{"type":"string","title":"User Id","description":"Author user ID"},"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id","description":"Group ID if group post"},"post_type":{"type":"string","title":"Post Type","description":"Post type"},"loves_count":{"type":"integer","title":"Loves Count","description":"Number of loves","default":0},"comments_count":{"type":"integer","title":"Comments Count","description":"Number of comments","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"relevance_score":{"type":"number","maximum":1,"minimum":0,"title":"Relevance Score","description":"Search relevance score"}},"type":"object","required":["id","body","user_id","post_type","created_at","relevance_score"],"title":"PostSearchResult","description":"Post search result item","example":{"body":"Neural networks are the foundation of modern AI...","comments_count":15,"created_at":"2026-01-20T14:30:00Z","id":"p1o2s3t4-5i6d-7890-abcd-ef1234567890","loves_count":42,"post_type":"text","relevance_score":0.88,"title":"Introduction to Neural Networks","user_id":"a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d"}},"PostUnloveActionResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the operation succeeded"},"message":{"type":"string","title":"Message","description":"Human-readable result message"},"post_id":{"type":"string","title":"Post Id","description":"Post that was unloved"},"loves_count":{"type":"integer","title":"Loves Count","description":"Post's love count after the operation"},"was_removed":{"type":"boolean","title":"Was Removed","description":"False when no love existed to remove (idempotent no-op)"}},"additionalProperties":true,"type":"object","required":["success","message","post_id","loves_count","was_removed"],"title":"PostUnloveActionResponse","description":"Result of removing a love from a post."},"PostUpdate":{"properties":{"content":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Content","description":"Updated post content"},"media_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Media Urls","description":"Updated media URLs"},"visibility":{"anyOf":[{"$ref":"#/components/schemas/PostVisibility"},{"type":"null"}],"description":"Updated visibility"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Updated tags"},"location":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Location","description":"Updated location"},"is_nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Nsfw","description":"Updated NSFW flag"}},"type":"object","title":"PostUpdate","description":"Schema for updating an existing post","example":{"content":"Updated post content","visibility":"friends"}},"PostVisibility":{"type":"string","enum":["public","friends","private"],"title":"PostVisibility","description":"Post visibility levels"},"PostgreSQLBackupCreateRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Optional backup name"}},"type":"object","title":"PostgreSQLBackupCreateRequest","description":"Request model for creating an on-demand backup. Refs #5319."},"PostgreSQLBackupRestoreRequest":{"properties":{"backup_id":{"type":"string","title":"Backup Id","description":"ID of the backup to restore"}},"type":"object","required":["backup_id"],"title":"PostgreSQLBackupRestoreRequest","description":"Request model for restoring a backup. Refs #5319."},"PostgreSQLBackupScheduleRequest":{"properties":{"kinds":{"items":{"type":"string"},"type":"array","title":"Kinds","description":"Schedules to enable: any of DAILY (6d retention), WEEKLY (1mo), MONTHLY (3mo). Empty list clears."}},"type":"object","required":["kinds"],"title":"PostgreSQLBackupScheduleRequest","description":"Request model for setting automated backup schedules. Refs #5319."},"PostgreSQLConnectionResponse":{"properties":{"database_url":{"type":"string","title":"Database Url"},"host":{"type":"string","title":"Host"},"port":{"type":"integer","title":"Port"},"database":{"type":"string","title":"Database"},"username":{"type":"string","title":"Username"},"password":{"type":"string","title":"Password"},"connection_string":{"type":"string","title":"Connection String"}},"type":"object","required":["database_url","host","port","database","username","password","connection_string"],"title":"PostgreSQLConnectionResponse","description":"Response model for PostgreSQL connection details"},"PostgreSQLCredentialRotateRequest":{"properties":{"credential_type":{"type":"string","title":"Credential Type","description":"Credential type: primary, readonly, admin","default":"primary"}},"type":"object","title":"PostgreSQLCredentialRotateRequest","description":"Request model for credential rotation"},"PostgreSQLInstanceResponse":{"properties":{"id":{"type":"string","title":"Id"},"project_id":{"type":"string","title":"Project Id"},"status":{"type":"string","title":"Status"},"instance_size":{"type":"string","title":"Instance Size"},"postgres_version":{"type":"string","title":"Postgres Version"},"monthly_cost_usd":{"type":"number","title":"Monthly Cost Usd"},"connection_count":{"type":"integer","title":"Connection Count"},"cpu_usage_percent":{"type":"number","title":"Cpu Usage Percent"},"memory_usage_percent":{"type":"number","title":"Memory Usage Percent"},"storage_usage_gb":{"type":"number","title":"Storage Usage Gb"},"created_at":{"type":"string","title":"Created At"},"last_health_check_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Health Check At"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"database_host":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database Host"},"database_port":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Database Port"},"database_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database Name"},"database_user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database User"}},"type":"object","required":["id","project_id","status","instance_size","postgres_version","monthly_cost_usd","connection_count","cpu_usage_percent","memory_usage_percent","storage_usage_gb","created_at","last_health_check_at","error_message"],"title":"PostgreSQLInstanceResponse","description":"Response model for PostgreSQL instance details"},"PostgreSQLPITRRestoreRequest":{"properties":{"target_timestamp":{"type":"string","title":"Target Timestamp","description":"ISO 8601 timestamp to restore to"},"new_service_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Service Name","description":"Optional name for the restored sibling instance"}},"type":"object","required":["target_timestamp"],"title":"PostgreSQLPITRRestoreRequest","description":"Request model for point-in-time recovery restore. Refs #5319."},"PostgreSQLProvisionRequest":{"properties":{"instance_size":{"type":"string","title":"Instance Size","description":"Instance size: micro-1, standard-2, standard-4, performance-8, performance-16","default":"micro-1"},"postgres_version":{"type":"string","title":"Postgres Version","description":"PostgreSQL version: 17, 16, 15","default":"17"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Tags for organization","default":[]}},"type":"object","title":"PostgreSQLProvisionRequest","description":"Request model for provisioning dedicated PostgreSQL"},"PostgreSQLScaleRequest":{"properties":{"instance_size":{"type":"string","title":"Instance Size","description":"Target tier: micro-1, standard-2, standard-4, performance-8, performance-16"}},"type":"object","required":["instance_size"],"title":"PostgreSQLScaleRequest","description":"Request model for scaling a Postgres instance to a new tier. Refs #4995."},"PostgreSQLUpgradeRequest":{"properties":{"target_version":{"type":"string","title":"Target Version","description":"Target PostgreSQL major version: 15, 16, 17, 18"}},"type":"object","required":["target_version"],"title":"PostgreSQLUpgradeRequest","description":"Request model for upgrading Postgres major version. Refs #4996."},"PostgreSQLUsageResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"total_queries_24h":{"type":"integer","title":"Total Queries 24H"},"total_credits_consumed_24h":{"type":"number","title":"Total Credits Consumed 24H"},"avg_query_time_ms":{"type":"number","title":"Avg Query Time Ms"},"top_query_types":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Query Types"},"connection_usage":{"additionalProperties":true,"type":"object","title":"Connection Usage"},"storage_usage_gb":{"type":"number","title":"Storage Usage Gb"},"monthly_cost_usd":{"type":"number","title":"Monthly Cost Usd"}},"type":"object","required":["project_id","total_queries_24h","total_credits_consumed_24h","avg_query_time_ms","top_query_types","connection_usage","storage_usage_gb","monthly_cost_usd"],"title":"PostgreSQLUsageResponse","description":"Response model for PostgreSQL usage statistics"},"PostgresBackupSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdat"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expiresat"},"usedMB":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Usedmb"},"referencedMB":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Referencedmb"},"scheduleId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduleid"}},"type":"object","required":["id"],"title":"PostgresBackupSummary","description":"Shape returned by Railway's volumeInstanceBackupCreate/List mutations.\n\nRailway may omit fields depending on backup state, so everything but the\nid is optional."},"PostgresDatabasesStubResponse":{"properties":{"databases":{"items":{},"type":"array","title":"Databases"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["databases","total","message"],"title":"PostgresDatabasesStubResponse","description":"Response for GET /postgres/databases."},"PostgresExtensionInfo":{"properties":{"name":{"type":"string","title":"Name","description":"Extension name"},"version":{"type":"string","title":"Version","description":"Extension version"},"description":{"type":"string","title":"Description","description":"Extension description"}},"type":"object","required":["name","version","description"],"title":"PostgresExtensionInfo","description":"Schema for PostgreSQL extension information"},"PostgresPricingResponse":{"properties":{"tiers":{"items":{"$ref":"#/components/schemas/PostgresTier"},"type":"array","title":"Tiers"},"currency":{"type":"string","title":"Currency"},"billing_period":{"type":"string","title":"Billing Period"},"includes":{"items":{"type":"string"},"type":"array","title":"Includes"}},"type":"object","required":["tiers","currency","billing_period","includes"],"title":"PostgresPricingResponse"},"PostgresProvisionStubResponse":{"properties":{"database_id":{"type":"string","title":"Database Id"},"database_name":{"type":"string","title":"Database Name"},"host":{"type":"string","title":"Host"},"port":{"type":"integer","title":"Port"},"user":{"type":"string","title":"User"},"connection_string":{"type":"string","title":"Connection String"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["database_id","database_name","host","port","user","connection_string","status","created_at","message"],"title":"PostgresProvisionStubResponse","description":"Response for POST /postgres/provision."},"PostgresQueryLogEntry":{"properties":{"id":{"type":"string","title":"Id"},"query_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query Type"},"complexity_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Complexity Score"},"execution_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Execution Time Ms"},"rows_affected":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Affected"},"credits_consumed":{"type":"number","title":"Credits Consumed"},"client_ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Ip"},"timestamp":{"type":"string","title":"Timestamp"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"}},"type":"object","required":["id","credits_consumed","timestamp"],"title":"PostgresQueryLogEntry"},"PostgresQueryLogsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"total_logs":{"type":"integer","title":"Total Logs"},"query_type_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query Type Filter"},"logs":{"items":{"$ref":"#/components/schemas/PostgresQueryLogEntry"},"type":"array","title":"Logs"}},"type":"object","required":["project_id","total_logs","logs"],"title":"PostgresQueryLogsResponse"},"PostgresRotatedConnection":{"properties":{"host":{"type":"string","title":"Host"},"port":{"type":"integer","title":"Port"},"database":{"type":"string","title":"Database"},"username":{"type":"string","title":"Username"},"password":{"type":"string","title":"Password"},"connection_string":{"type":"string","title":"Connection String"}},"type":"object","required":["host","port","database","username","password","connection_string"],"title":"PostgresRotatedConnection"},"PostgresServiceStatus":{"properties":{"exists":{"type":"boolean","title":"Exists","description":"Whether a PostgreSQL service is provisioned for this project"},"id":{"anyOf":[{},{"type":"null"}],"title":"Id","description":"Service record ID"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Provisioning status, e.g. active/provisioning/error"},"railway_service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Railway Service Id","description":"Railway service ID backing this instance"},"instance_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instance Size","description":"Provisioned instance size"},"monthly_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Monthly Cost Usd","description":"Estimated monthly cost in USD"},"connection_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Connection Count","description":"Current active connection count"},"cpu_usage_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpu Usage Percent","description":"CPU usage percentage"},"memory_usage_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Memory Usage Percent","description":"Memory usage percentage"},"storage_usage_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Storage Usage Gb","description":"Storage usage in GB"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"ISO creation timestamp"},"last_health_check_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Health Check At","description":"ISO timestamp of last health check"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Last recorded error, if any"},"postgres_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postgres Version","description":"Provisioned PostgreSQL version"},"database_host":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database Host","description":"Database host"},"database_port":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Database Port","description":"Database port"},"database_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database Name","description":"Database name"},"database_user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database User","description":"Database user"}},"type":"object","required":["exists"],"title":"PostgresServiceStatus","description":"Response model for the PostgreSQL provisioning status check.\n\nWhen no service has been provisioned for the project, only `exists`\n(False) is present — all other fields are therefore optional.","example":{"connection_count":2,"cpu_usage_percent":3.2,"created_at":"2026-01-01T00:00:00","database_host":"db.example.com","database_name":"project_db","database_port":5432,"database_user":"project_user","exists":true,"id":1,"instance_size":"shared","last_health_check_at":"2026-01-02T00:00:00","memory_usage_percent":12.5,"monthly_cost_usd":5,"postgres_version":"17","railway_service_id":"abc123","status":"active","storage_usage_gb":0.4}},"PostgresTier":{"properties":{"name":{"type":"string","title":"Name"},"display_name":{"type":"string","title":"Display Name"},"vcpus":{"type":"integer","title":"Vcpus"},"ram_gb":{"type":"integer","title":"Ram Gb"},"storage_gb":{"type":"integer","title":"Storage Gb"},"monthly_price_usd":{"type":"number","title":"Monthly Price Usd"},"connections":{"type":"integer","title":"Connections"},"pg_versions":{"items":{"type":"string"},"type":"array","title":"Pg Versions"}},"type":"object","required":["name","display_name","vcpus","ram_gb","storage_gb","monthly_price_usd","connections","pg_versions"],"title":"PostgresTier"},"PostgresqlInstancesStubResponse":{"properties":{"instances":{"items":{},"type":"array","title":"Instances"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["instances","total","message"],"title":"PostgresqlInstancesStubResponse","description":"Response for GET /postgresql/instances."},"PowerAnalysis":{"properties":{"achieved_power":{"type":"number","title":"Achieved Power"},"required_sample_size":{"type":"integer","title":"Required Sample Size"},"recommendation":{"type":"string","title":"Recommendation"}},"type":"object","required":["achieved_power","required_sample_size","recommendation"],"title":"PowerAnalysis"},"PreferencesResponse":{"properties":{"preferences":{"additionalProperties":true,"type":"object","title":"Preferences","description":"Free-form user preferences (e.g. onboarding_completed)."}},"type":"object","title":"PreferencesResponse","description":"Response schema: the full preferences blob."},"PresetConfigRequest":{"properties":{"preset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset","description":"Named preset: speed, latency, cost, balanced"},"gpu_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gpu Type","description":"GPU type (e.g. H100, L40S)"},"quantization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantization","description":"Quantization (e.g. fp16, int8)"},"batch_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch Size","description":"Batch strategy: max, min, auto"},"speculative_decoding":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Speculative Decoding","description":"Enable speculative decoding"}},"type":"object","title":"PresetConfigRequest"},"PresetConfigResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"preset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset"},"gpu_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gpu Type"},"quantization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantization"},"batch_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch Size"},"speculative_decoding":{"type":"boolean","title":"Speculative Decoding","default":false},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["deployment_id"],"title":"PresetConfigResponse"},"PresignUploadResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"upload_url":{"type":"string","title":"Upload Url"},"method":{"type":"string","title":"Method"},"file_key":{"type":"string","title":"File Key"},"bucket":{"type":"string","title":"Bucket"},"expires_in_seconds":{"type":"integer","title":"Expires In Seconds"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"instructions":{"type":"string","title":"Instructions"}},"type":"object","required":["success","upload_url","method","file_key","bucket","expires_in_seconds","instructions"],"title":"PresignUploadResponse"},"PreviewTargetingResponse":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign the preview is for"},"targeting":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Targeting","description":"Targeting config echoed back; null when unconfigured"},"matching_events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Matching Events","description":"Events that would receive ads, capped by `limit`"},"total_matched":{"type":"integer","title":"Total Matched","description":"Total matching events before the limit was applied"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"Explanatory note; present ONLY on the no-targeting branch"},"similarity_scores":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Similarity Scores","description":"Per-event semantic similarity; present ONLY when targeting is set"}},"type":"object","required":["campaign_id","matching_events","total_matched"],"title":"PreviewTargetingResponse","description":"Targeting preview for a campaign (Refs #8449).\n\nThis route has TWO mutually-exclusive key sets, so it declares\n`response_model_exclude_unset=True`:\n\n no targeting configured\n {campaign_id, targeting: null, matching_events, total_matched, note}\n targeting configured\n {campaign_id, targeting, matching_events, total_matched,\n similarity_scores}\n\n`note` and `similarity_scores` never co-occur. Without exclude_unset this\nmodel would start emitting whichever one does not apply as an explicit\nnull, adding a key the route has never sent on that branch.\n\n`targeting` is `Optional[Dict]` because the no-targeting branch genuinely\nemits `targeting: null` (that key IS present and null there, unlike `note`\n/ `similarity_scores`, which are absent)."},"PreviousInvoiceSend":{"properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"sent_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sent At"}},"type":"object","title":"PreviousInvoiceSend"},"PricingCheckoutResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PricingCheckoutSessionData"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["success","data"],"title":"PricingCheckoutResponse","description":"POST /pricing/checkout"},"PricingCheckoutSessionData":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"plan_id":{"type":"string","title":"Plan Id"},"plan_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Name"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"success_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Success Url"},"cancel_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancel Url"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"additionalProperties":true,"type":"object","required":["plan_id"],"title":"PricingCheckoutSessionData","description":"Both the real-Stripe-session branch and the zerodb_free short-circuit\nbranch of create_checkout_session() populate this same field set."},"PricingConfigData":{"properties":{"currency":{"type":"string","title":"Currency"},"credit_cost":{"type":"number","title":"Credit Cost"},"supported_payment_methods":{"items":{"type":"string"},"type":"array","title":"Supported Payment Methods"},"billing_cycles":{"items":{"type":"string"},"type":"array","title":"Billing Cycles"},"free_trial_credits":{"type":"integer","title":"Free Trial Credits"},"max_credits_per_plan":{"additionalProperties":{"type":"integer"},"type":"object","title":"Max Credits Per Plan"},"features":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Features"}},"type":"object","required":["currency","credit_cost","supported_payment_methods","billing_cycles","free_trial_credits","max_credits_per_plan","features"],"title":"PricingConfigData"},"PricingConfigResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PricingConfigData"}},"type":"object","required":["success","data"],"title":"PricingConfigResponse","description":"GET /pricing/config"},"PricingEstimate":{"properties":{"base_price":{"type":"number","title":"Base Price","description":"Base price for the format (eCPM)"},"adjusted_price":{"type":"number","title":"Adjusted Price","description":"Final price after all adjustments (eCPM)"},"factors":{"$ref":"#/components/schemas/PricingFactors","description":"Detailed pricing factors"},"suggested_ecpm":{"type":"number","title":"Suggested Ecpm","description":"Suggested effective CPM bid"},"event_id":{"type":"integer","title":"Event Id","description":"Event ID this pricing applies to"},"format":{"$ref":"#/components/schemas/AdFormat","description":"Ad format"},"demand_adjustment":{"anyOf":[{"$ref":"#/components/schemas/DemandAdjustment"},{"type":"null"}],"description":"Demand-based price adjustment based on fill rate"}},"type":"object","required":["base_price","adjusted_price","factors","suggested_ecpm","event_id","format"],"title":"PricingEstimate","description":"Pricing estimate for ad inventory.","example":{"adjusted_price":19.32,"base_price":10,"demand_adjustment":{"fill_rate":0.85,"multiplier":1.5,"reason":"High demand (>80% filled)"},"event_id":1,"factors":{"attendees_multiplier":1.2,"base_price":10,"scarcity_multiplier":1.4,"targeting_multiplier":1.15},"format":"video","suggested_ecpm":19.32}},"PricingFactors":{"properties":{"base_price":{"type":"number","title":"Base Price","description":"Base price for the ad format"},"attendees_multiplier":{"type":"number","title":"Attendees Multiplier","description":"Multiplier based on event size"},"scarcity_multiplier":{"type":"number","title":"Scarcity Multiplier","description":"Multiplier based on inventory fill rate"},"targeting_multiplier":{"type":"number","title":"Targeting Multiplier","description":"Multiplier based on targeting specificity"}},"type":"object","required":["base_price","attendees_multiplier","scarcity_multiplier","targeting_multiplier"],"title":"PricingFactors","description":"Detailed breakdown of pricing calculation factors.","example":{"attendees_multiplier":1.2,"base_price":10,"scarcity_multiplier":1.4,"targeting_multiplier":1.15}},"PricingPlan":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"credits":{"type":"integer","title":"Credits"},"price":{"type":"number","title":"Price"},"currency":{"type":"string","title":"Currency"},"interval":{"type":"string","title":"Interval"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"features":{"items":{"type":"string"},"type":"array","title":"Features"},"popular":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Popular"}},"additionalProperties":true,"type":"object","required":["id","name","credits","price","currency","interval"],"title":"PricingPlan","description":"One entry of PRICING_PLANS / billing_configuration DB rows.\n\nFields beyond the common core vary slightly by plan (e.g. cta_text,\nbutton_text only appear on the cody_vcto plan) so extras are permitted\nrather than silently dropped."},"PricingPlanResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PricingPlan"}},"type":"object","required":["success","data"],"title":"PricingPlanResponse","description":"GET /pricing/plans/{plan_id}"},"PricingPlansData":{"properties":{"plans":{"items":{"$ref":"#/components/schemas/PricingPlan"},"type":"array","title":"Plans"},"currency":{"type":"string","title":"Currency"},"embedding_model":{"type":"string","title":"Embedding Model"},"embedding_engine":{"type":"string","title":"Embedding Engine"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["plans","currency","embedding_model","embedding_engine","updated_at"],"title":"PricingPlansData"},"PricingPlansResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PricingPlansData"}},"type":"object","required":["success","data"],"title":"PricingPlansResponse","description":"GET /pricing/plans"},"PricingResponse":{"properties":{"instance_id":{"type":"string","title":"Instance Id"},"price_per_query":{"type":"number","title":"Price Per Query"},"currency":{"type":"string","title":"Currency"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["instance_id","price_per_query","currency"],"title":"PricingResponse","description":"Response for MCP pricing"},"PricingVerifyData":{"properties":{"paid":{"type":"boolean","title":"Paid"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"payment_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Status"},"plan_id":{"type":"string","title":"Plan Id"},"plan_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Id"}},"type":"object","required":["paid","plan_id"],"title":"PricingVerifyData"},"PricingVerifyResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PricingVerifyData"}},"type":"object","required":["success","data"],"title":"PricingVerifyResponse","description":"POST /pricing/verify"},"PrivacySettingsUpdate":{"properties":{"profile_visibility":{"type":"string","enum":["public","friends","private"],"title":"Profile Visibility","description":"Who can view the user's profile","default":"public"},"show_online_status":{"type":"boolean","title":"Show Online Status","description":"Whether to show online/offline status to others","default":true},"allow_messages_from":{"type":"string","enum":["everyone","friends","none"],"title":"Allow Messages From","description":"Who can send direct messages to the user","default":"everyone"},"show_read_receipts":{"type":"boolean","title":"Show Read Receipts","description":"Whether to send read receipts to message senders","default":true}},"type":"object","title":"PrivacySettingsUpdate","description":"Schema for updating privacy settings only\n\nAllows users to update privacy preferences independently from profile data"},"ProbeFinding":{"properties":{"id":{"type":"string","title":"Id","description":"Stable probe finding id, e.g. 'unauth-sweep::/admin/'"},"name":{"type":"string","title":"Name","description":"Human-readable finding name"},"severity":{"$ref":"#/components/schemas/Severity","description":"crit|high|med|low|info"},"vuln_class":{"type":"string","title":"Vuln Class","description":"Vulnerability class, e.g. 'broken_auth', 'idor', 'privilege_escalation', 'webhook_forgery'"},"endpoint":{"type":"string","title":"Endpoint","description":"Target endpoint path that was probed"},"method":{"type":"string","title":"Method","description":"HTTP method used","default":"GET"},"evidence":{"type":"string","title":"Evidence","description":"Short evidence string / response excerpt","default":""},"expected":{"type":"string","title":"Expected","description":"What a secure target should have returned","default":""},"actual":{"type":"string","title":"Actual","description":"What the target actually returned","default":""},"confirmed":{"type":"boolean","title":"Confirmed","description":"True only after an adversarial re-check reproduced the issue","default":false}},"type":"object","required":["id","name","severity","vuln_class","endpoint"],"title":"ProbeFinding","description":"A single result from a probe.\n\nA finding is produced whether or not a vulnerability was confirmed; an\n``info`` finding with ``confirmed=False`` records that a probe ran but\nfound nothing actionable (e.g. keys were not supplied, or the target\nbehaved correctly)."},"ProcessConversationRequest":{"properties":{"messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Messages","description":"List of {role, content} message dicts"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id","description":"Entity the conversation is about"},"namespace":{"type":"string","title":"Namespace","description":"Memory namespace for storing extracted memories. Required. Refs #2960"}},"type":"object","required":["messages","namespace"],"title":"ProcessConversationRequest"},"ProcessConversationResponse":{"properties":{"extracted":{"type":"integer","title":"Extracted"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id"},"messages_processed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Messages Processed"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"degraded":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Degraded"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning"}},"type":"object","required":["extracted"],"title":"ProcessConversationResponse","description":"process_conversation() has a 3rd, early-return shape ({extracted: 0,\nmessage: ...}) for an empty messages list, on top of the normal success\nand degraded-LLM-call shapes — hence entity_id/messages_processed/message\nbeing Optional even though they're set on the two non-empty-input paths."},"ProcessFileChunkingResponse":{"properties":{"file_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Id","description":"ID of the tracked file record"},"file_path":{"type":"string","title":"File Path","description":"Path to the processed file"},"file_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Hash","description":"Content hash of the file"},"chunks":{"anyOf":[{"items":{"$ref":"#/components/schemas/ChunkData"},"type":"array"},{"type":"null"}],"title":"Chunks","description":"Chunks produced or reused"},"status":{"type":"string","title":"Status","description":"processed | unchanged | error"},"chunk_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Chunk Count","description":"Number of chunks in the result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message, present only when status is error"}},"type":"object","required":["file_path","status"],"title":"ProcessFileChunkingResponse","description":"Response for POST /chunks/process (ChunkingEngine.process_file)."},"ProcessMetrics":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"active_connections":{"type":"integer","title":"Active Connections"}},"type":"object","required":["total_count","active_connections"],"title":"ProcessMetrics"},"ProductListResponse":{"properties":{"products":{"items":{"$ref":"#/components/schemas/CatalogProduct"},"type":"array","title":"Products"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["products","organization_id"],"title":"ProductListResponse"},"ProfileDataFallback":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name"},"display_name":{"type":"string","title":"Display Name"},"avatar_url":{"type":"string","title":"Avatar Url"},"preferences":{"additionalProperties":true,"type":"object","title":"Preferences"},"role":{"type":"string","title":"Role"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"stats":{"$ref":"#/components/schemas/ProfileStatsFallback"}},"type":"object","required":["id","email","name","display_name","avatar_url","preferences","role","is_active","stats"],"title":"ProfileDataFallback"},"ProfileFallbackResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ProfileDataFallback"}},"type":"object","required":["success","data"],"title":"ProfileFallbackResponse","description":"Returned instead of the real profile when get_profile() raises."},"ProfileRequest":{"properties":{"entity_id":{"type":"string","title":"Entity Id","description":"Entity to get profile for"}},"type":"object","required":["entity_id"],"title":"ProfileRequest"},"ProfileStatsAchievement":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"icon":{"type":"string","title":"Icon"},"date_awarded":{"type":"string","title":"Date Awarded"}},"type":"object","required":["id","title","icon","date_awarded"],"title":"ProfileStatsAchievement"},"ProfileStatsCompletions":{"properties":{"week_7_day":{"type":"integer","title":"Week 7 Day","default":0},"total":{"type":"integer","title":"Total","default":0},"current_streak":{"type":"integer","title":"Current Streak","default":0}},"type":"object","title":"ProfileStatsCompletions"},"ProfileStatsData":{"properties":{"total_prompts":{"type":"integer","title":"Total Prompts","default":0},"total_sessions":{"type":"integer","title":"Total Sessions","default":0},"last_active":{"type":"string","title":"Last Active"},"account_created":{"type":"string","title":"Account Created"},"top_coding_languages":{"items":{"$ref":"#/components/schemas/ProfileStatsLanguage"},"type":"array","title":"Top Coding Languages"},"completions":{"$ref":"#/components/schemas/ProfileStatsCompletions"},"primary_ide":{"type":"string","title":"Primary Ide","default":"Unknown"},"weekly_activity":{"items":{"$ref":"#/components/schemas/WeeklyActivityDay"},"type":"array","title":"Weekly Activity"},"achievements":{"items":{"$ref":"#/components/schemas/ProfileStatsAchievement"},"type":"array","title":"Achievements"}},"type":"object","required":["last_active","account_created","completions"],"title":"ProfileStatsData","description":"``data`` payload of GET /profile/stats"},"ProfileStatsFallback":{"properties":{"total_sessions":{"type":"integer","title":"Total Sessions"},"total_credits_used":{"type":"integer","title":"Total Credits Used"}},"type":"object","required":["total_sessions","total_credits_used"],"title":"ProfileStatsFallback"},"ProfileStatsLanguage":{"properties":{"language":{"type":"string","title":"Language"},"percent":{"type":"integer","title":"Percent"}},"type":"object","required":["language","percent"],"title":"ProfileStatsLanguage"},"ProfileStatsResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/ProfileStatsData"}},"type":"object","required":["data"],"title":"ProfileStatsResponse","description":"Response for GET /profile/stats (legacy, deprecated endpoint)"},"ProfileUpdate":{"properties":{"profile_visibility":{"type":"string","enum":["public","friends","private"],"title":"Profile Visibility","description":"Who can view the user's profile","default":"public"},"show_online_status":{"type":"boolean","title":"Show Online Status","description":"Whether to show online/offline status to others","default":true},"allow_messages_from":{"type":"string","enum":["everyone","friends","none"],"title":"Allow Messages From","description":"Who can send direct messages to the user","default":"everyone"},"show_read_receipts":{"type":"boolean","title":"Show Read Receipts","description":"Whether to send read receipts to message senders","default":true},"bio":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Bio","description":"User biography or about me text"},"avatar_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Avatar Url","description":"Profile avatar image URL"},"cover_photo_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Cover Photo Url","description":"Profile cover/header photo URL"},"location":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Location","description":"User location (city, country, etc.)"},"website":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Website","description":"Personal website URL"},"ask_me_anything":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Ask Me Anything","description":"Ask Me Anything section - topics user can help with"}},"type":"object","title":"ProfileUpdate","description":"Schema for updating user profile\n\nAll fields are optional - only provided fields will be updated"},"ProfileUpdateRequest":{"properties":{"profile_visibility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Visibility"},"show_online_status":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Show Online Status"},"allow_messages_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Allow Messages From"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"cover_photo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Photo Url"}},"type":"object","title":"ProfileUpdateRequest","description":"Request to update user profile settings. Refs #2395"},"ProgressResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"form_route":{"type":"string","title":"Form Route"},"answers":{"additionalProperties":true,"type":"object","title":"Answers"},"idx":{"type":"integer","title":"Idx"},"done":{"type":"boolean","title":"Done"}},"type":"object","required":["organization_id","form_route","answers","idx","done"],"title":"ProgressResponse"},"ProjectActionRequest":{"properties":{"action":{"type":"string","title":"Action"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","required":["action"],"title":"ProjectActionRequest","description":"Request for project actions (pause, stop, resume)"},"ProjectActionResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the action was applied"},"message":{"type":"string","title":"Message","description":"Human-readable confirmation"},"project_id":{"type":"string","title":"Project Id","description":"Project the action applied to"}},"additionalProperties":true,"type":"object","required":["success","message","project_id"],"title":"ProjectActionResponse","description":"Result of a pause / stop / resume action on a project.\n\nAll three handlers return this identical 3-key body on success; their\nfailure paths raise HTTP 400 instead, so no Union is needed."},"ProjectAgentsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project identifier"},"project_name":{"type":"string","title":"Project Name","description":"Project display name"},"total_agents":{"type":"integer","title":"Total Agents","description":"Total agents assigned"},"active_agents":{"type":"integer","title":"Active Agents","description":"Agents currently working"},"agents":{"items":{"$ref":"#/components/schemas/AgentInfo"},"type":"array","title":"Agents","description":"Per-agent status detail"}},"additionalProperties":true,"type":"object","required":["project_id","project_name","total_agents","active_agents"],"title":"ProjectAgentsResponse","description":"The agent roster for a single project.\n\nA projection of ActiveProjectSummary down to the agent-related fields."},"ProjectApiEntry":{"properties":{"name":{"type":"string","title":"Name"},"display":{"type":"string","title":"Display"},"description":{"type":"string","title":"Description"},"enabled":{"type":"boolean","title":"Enabled"},"enabled_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enabled At"},"enabled_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enabled By"}},"type":"object","required":["name","display","description","enabled"],"title":"ProjectApiEntry","description":"One API registry entry as returned by api_registry_service.\n\nenabled_at/enabled_by are Optional AND omitted-when-unset because\nget_project_apis has two branches with different key sets: the success\npath sets all six keys, while its `except` fallback returns only\nname/display/description/enabled. The route therefore declares\nresponse_model_exclude_unset=True so the fallback response is not padded\nwith two invented nulls. Refs #8449.\n\nenabled_by is str, not UUID: the service already stringifies it\n(`str(row[3])`), and enabled_at is a pre-serialized `.isoformat()` string,\nso declaring datetime/UUID here would change the emitted JSON."},"ProjectApiRegistryResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"apis":{"items":{"$ref":"#/components/schemas/ProjectApiEntry"},"type":"array","title":"Apis"}},"type":"object","required":["project_id"],"title":"ProjectApiRegistryResponse","description":"Response model for GET /{project_id}/api-registry — Refs #8449."},"ProjectArtifactEntry":{"properties":{"type":{"type":"string","title":"Type"},"name":{"type":"string","title":"Name"},"files":{"items":{"type":"string"},"type":"array","title":"Files"},"size":{"type":"string","title":"Size"},"generated_by":{"type":"string","title":"Generated By"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["type","name","files","size","generated_by","created_at"],"title":"ProjectArtifactEntry"},"ProjectArtifactsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"artifacts":{"items":{"$ref":"#/components/schemas/ProjectArtifactEntry"},"type":"array","title":"Artifacts"},"total_size":{"type":"string","title":"Total Size"},"download_url":{"type":"string","title":"Download Url"}},"type":"object","required":["project_id","artifacts","total_size","download_url"],"title":"ProjectArtifactsResponse"},"ProjectAxScoreTrend":{"properties":{"delta":{"type":"integer","title":"Delta"},"direction":{"type":"string","title":"Direction"}},"type":"object","required":["delta","direction"],"title":"ProjectAxScoreTrend"},"ProjectAxSummary":{"properties":{"domain":{"type":"string","title":"Domain"},"score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Score"},"grade":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade"},"trend":{"anyOf":[{"$ref":"#/components/schemas/ProjectAxScoreTrend"},{"type":"null"}]},"scanned_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scanned At"}},"type":"object","required":["domain"],"title":"ProjectAxSummary"},"ProjectCodeFileEntry":{"properties":{"path":{"type":"string","title":"Path"},"size":{"type":"integer","title":"Size"},"last_modified":{"anyOf":[{},{"type":"null"}],"title":"Last Modified"},"etag":{"anyOf":[{},{"type":"null"}],"title":"Etag"}},"type":"object","required":["path","size"],"title":"ProjectCodeFileEntry"},"ProjectContextResponse":{"properties":{"entities":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__cody_context__EntityItem"},"type":"array","title":"Entities"},"edges":{"items":{"$ref":"#/components/schemas/EdgeItem"},"type":"array","title":"Edges"},"summary":{"type":"string","title":"Summary"}},"type":"object","required":["entities","edges","summary"],"title":"ProjectContextResponse"},"ProjectCostBreakdown":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"model_inference_usd":{"type":"number","title":"Model Inference Usd","description":"Total model inference cost","default":0},"total_tokens":{"type":"integer","title":"Total Tokens","description":"Total tokens consumed","default":0},"request_count":{"type":"integer","title":"Request Count","description":"Total API requests","default":0},"avg_latency_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Latency Ms","description":"Average inference latency in milliseconds, from ai_usage_logs.latency_ms"},"cost_per_inference":{"type":"number","title":"Cost Per Inference","description":"model_inference_usd / max(request_count, 1)","default":0},"tokens_per_inference":{"type":"number","title":"Tokens Per Inference","description":"total_tokens / max(request_count, 1)","default":0},"top_models":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Models","description":"Top models by cost"}},"type":"object","required":["project_id"],"title":"ProjectCostBreakdown"},"ProjectCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name","description":"Project name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description","description":"Project description"},"tier":{"type":"string","pattern":"^(free|pro|scale|enterprise)$","title":"Tier","description":"Project tier","default":"free"},"database_enabled":{"type":"boolean","title":"Database Enabled","description":"Enable database features","default":true},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id","description":"Organization ID (optional)"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry","description":"Industry for auto-seeding (saas, ecommerce, finance, healthcare, realestate, general)"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City filter for auto-seeding (sf, nyc, austin, seattle, denver)"}},"type":"object","required":["name"],"title":"ProjectCreate","description":"Request model for creating a new project"},"ProjectDatabaseSchemaResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"schema":{"additionalProperties":true,"type":"object","title":"Schema"},"retrieved_at":{"type":"string","title":"Retrieved At"}},"type":"object","required":["project_id","schema","retrieved_at"],"title":"ProjectDatabaseSchemaResponse"},"ProjectDownloadResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"download_url":{"type":"string","title":"Download Url"},"status":{"type":"string","title":"Status"},"expires_at":{"type":"string","title":"Expires At"},"size":{"type":"string","title":"Size"}},"type":"object","required":["project_id","download_url","status","expires_at","size"],"title":"ProjectDownloadResponse"},"ProjectFileItem":{"properties":{"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"path":{"type":"string","title":"Path"},"size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size"}},"type":"object","required":["name","type","path"],"title":"ProjectFileItem"},"ProjectFilesResponse":{"properties":{"type":{"type":"string","title":"Type"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"items":{"anyOf":[{"items":{"$ref":"#/components/schemas/ProjectFileItem"},"type":"array"},{"type":"null"}],"title":"Items"}},"type":"object","required":["type"],"title":"ProjectFilesResponse"},"ProjectLogEntry":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"agent":{"type":"string","title":"Agent"},"level":{"type":"string","title":"Level"},"message":{"type":"string","title":"Message"},"details":{"type":"string","title":"Details"}},"type":"object","required":["timestamp","agent","level","message","details"],"title":"ProjectLogEntry"},"ProjectLogsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"logs":{"items":{"$ref":"#/components/schemas/ProjectLogEntry"},"type":"array","title":"Logs"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["project_id","logs","total","limit"],"title":"ProjectLogsResponse"},"ProjectRelationshipCreate":{"properties":{"source_project_id":{"type":"string","title":"Source Project Id"},"target_project_id":{"type":"string","title":"Target Project Id"},"relationship_type":{"type":"string","title":"Relationship Type"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["source_project_id","target_project_id","relationship_type"],"title":"ProjectRelationshipCreate","description":"Request model for creating a project relationship."},"ProjectRelationshipCreateResponse":{"properties":{"status":{"type":"string","title":"Status"},"relationship_id":{"title":"Relationship Id"},"relationship_status":{"type":"string","title":"Relationship Status"},"source_project_id":{"type":"string","title":"Source Project Id"},"target_project_id":{"type":"string","title":"Target Project Id"},"relationship_type":{"type":"string","title":"Relationship Type"}},"type":"object","required":["status","relationship_id","relationship_status","source_project_id","target_project_id","relationship_type"],"title":"ProjectRelationshipCreateResponse","description":"Response for POST /project-context/ (create_project_relationship)."},"ProjectRelationshipEntry":{"properties":{"relationship_id":{"type":"integer","title":"Relationship Id"},"relationship_type":{"type":"string","title":"Relationship Type"},"direction":{"type":"string","title":"Direction","description":"outgoing | incoming"},"other_project_id":{"type":"string","title":"Other Project Id"},"other_project_name":{"type":"string","title":"Other Project Name"},"same_organization":{"type":"boolean","title":"Same Organization"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["relationship_id","relationship_type","direction","other_project_id","other_project_name","same_organization"],"title":"ProjectRelationshipEntry"},"ProjectRelationshipItem":{"properties":{"id":{"title":"Id"},"relationship_type":{"type":"string","title":"Relationship Type"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"created_at":{"title":"Created At"},"updated_at":{"title":"Updated At"},"target_project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target Project Id"},"target_project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Project Name"},"source_project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Project Id"},"source_project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Project Name"}},"additionalProperties":true,"type":"object","required":["id","relationship_type"],"title":"ProjectRelationshipItem","description":"A single relationship row.\n\nOutgoing rows carry target_project_id/target_project_name; incoming\nrows carry source_project_id/source_project_name instead — both sets\nare optional here and extra columns are allowed since the two queries\nproject different columns.\n\ncore#8247 FIXED: source_project_id/target_project_id were declared\n`Optional[str]`, but `project_relationships.source_project_id` and\n`.target_project_id` are `UUID` columns and the service layer builds\nrows straight off asyncpg (`dict(row)`), so they arrive as real\n`uuid.UUID` objects. Pydantic v2 does not coerce UUID -> str, so every\npopulated response died with a ResponseValidationError (HTTP 500).\nDeclaring them as `UUID` accepts both the asyncpg value and a plain\nstring while still serializing to -- and documenting in OpenAPI -- the\ncanonical UUID string the `str` annotation was always reaching for."},"ProjectRelationshipsResponse":{"properties":{"status":{"type":"string","title":"Status"},"project_id":{"type":"string","title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"outgoing_relationships":{"items":{"$ref":"#/components/schemas/ProjectRelationshipItem"},"type":"array","title":"Outgoing Relationships"},"incoming_relationships":{"items":{"$ref":"#/components/schemas/ProjectRelationshipItem"},"type":"array","title":"Incoming Relationships"},"total_outgoing":{"type":"integer","title":"Total Outgoing"},"total_incoming":{"type":"integer","title":"Total Incoming"}},"type":"object","required":["status","project_id","outgoing_relationships","incoming_relationships","total_outgoing","total_incoming"],"title":"ProjectRelationshipsResponse","description":"Response for GET /project-context/relationships/{project_id}."},"ProjectResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tier":{"type":"string","title":"Tier"},"status":{"type":"string","title":"Status"},"user_id":{"type":"string","title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"database_enabled":{"type":"boolean","title":"Database Enabled"},"vector_dimensions":{"type":"integer","title":"Vector Dimensions"},"quantum_enabled":{"type":"boolean","title":"Quantum Enabled"},"mcp_enabled":{"type":"boolean","title":"Mcp Enabled"},"database_config":{"additionalProperties":true,"type":"object","title":"Database Config"},"railway_project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Railway Project Id"},"usage":{"$ref":"#/components/schemas/app__zerodb__api__project_router__ProjectUsage"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}},"type":"object","required":["id","name","description","tier","status","user_id","organization_id","database_enabled","vector_dimensions","quantum_enabled","mcp_enabled","database_config","railway_project_id","usage","created_at","updated_at"],"title":"ProjectResponse","description":"Response model for project data"},"ProjectSimilaritiesResponse":{"properties":{"status":{"type":"string","title":"Status"},"project_id":{"type":"string","title":"Project Id"},"comparison_projects":{"items":{"$ref":"#/components/schemas/ComparisonProject"},"type":"array","title":"Comparison Projects"},"similarities":{"items":{"$ref":"#/components/schemas/ProjectSimilarityGroup"},"type":"array","title":"Similarities"},"total_projects_with_similarities":{"type":"integer","title":"Total Projects With Similarities"}},"type":"object","required":["status","project_id","comparison_projects","similarities","total_projects_with_similarities"],"title":"ProjectSimilaritiesResponse","description":"Response for GET /project-context/similarities/{project_id}."},"ProjectSimilarityGroup":{"properties":{"project_id":{"title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"similar_chunks":{"items":{"$ref":"#/components/schemas/SimilarChunkPair"},"type":"array","title":"Similar Chunks"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["project_id","similar_chunks","count"],"title":"ProjectSimilarityGroup"},"ProjectSortOption":{"type":"string","enum":["most_recent","alphabetical","progress","agents_active"],"title":"ProjectSortOption","description":"Sort options for project listing"},"ProjectStatsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/app__schemas__dashboard_stats_public__ProjectStats"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["success","data"],"title":"ProjectStatsResponse","description":"Response for GET /v1/projects/{project_id}/stats."},"ProjectStatus":{"type":"string","enum":["pending","in_progress","completed","failed","paused","cancelled"],"title":"ProjectStatus","description":"Project execution status"},"ProjectStatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"project_status":{"additionalProperties":true,"type":"object","title":"Project Status"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","project_status","timestamp"],"title":"ProjectStatusResponse","description":"Response for GET /railway-deployment/project/{project_name}/status."},"ProjectStorageStatusResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"storage_status":{"type":"string","title":"Storage Status"},"ready":{"type":"boolean","title":"Ready"},"recorded_status":{"type":"string","title":"Recorded Status"},"live_bucket_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Live Bucket Exists"}},"type":"object","required":["project_id","storage_status","ready","recorded_status"],"title":"ProjectStorageStatusResponse"},"ProjectTransferRequest":{"properties":{"target_organization_id":{"type":"string","title":"Target Organization Id","description":"Workspace ID to transfer the project to"}},"type":"object","required":["target_organization_id"],"title":"ProjectTransferRequest"},"ProjectType":{"type":"string","enum":["webapp","api","fullstack","wordpress","react","vue","typescript","python"],"title":"ProjectType","description":"Project types for scaffolding"},"ProjectUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"tier":{"anyOf":[{"type":"string","pattern":"^(free|pro|scale|enterprise)$"},{"type":"null"}],"title":"Tier"},"status":{"anyOf":[{"type":"string","pattern":"^(ACTIVE|SUSPENDED|DELETED)$"},{"type":"null"}],"title":"Status"},"database_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Database Enabled"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id","description":"Workspace/organization to assign this project to"}},"type":"object","title":"ProjectUpdate","description":"Request model for updating a project"},"ProjectedGrowth":{"properties":{"30_days":{"$ref":"#/components/schemas/ProjectedGrowthWindow"},"90_days":{"$ref":"#/components/schemas/ProjectedGrowthWindow"}},"type":"object","required":["30_days","90_days"],"title":"ProjectedGrowth"},"ProjectedGrowthWindow":{"properties":{"cpu_increase":{"type":"string","title":"Cpu Increase"},"memory_increase":{"type":"string","title":"Memory Increase"},"storage_increase":{"type":"string","title":"Storage Increase"},"traffic_increase":{"type":"string","title":"Traffic Increase"}},"type":"object","required":["cpu_increase","memory_increase","storage_increase","traffic_increase"],"title":"ProjectedGrowthWindow"},"ProjectsFallbackResponse":{"properties":{"projects":{"items":{},"type":"array","title":"Projects","default":[]},"total":{"type":"integer","title":"Total","default":0},"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"ProjectsFallbackResponse","description":"Returned instead of the real project list when list_projects() raises\n(reachable: list_projects does unguarded DB queries with no internal\ntry/except, so any DB error propagates into this wrapper's fallback)."},"ProjectsSummaryResponse":{"properties":{"total_projects":{"type":"integer","title":"Total Projects","default":0},"projects_by_tier":{"additionalProperties":{"type":"integer"},"type":"object","title":"Projects By Tier"},"total_usage":{"$ref":"#/components/schemas/ProjectsSummaryUsage"},"active_projects":{"type":"integer","title":"Active Projects","default":0}},"type":"object","required":["total_usage"],"title":"ProjectsSummaryResponse","description":"Response model for GET /stats/summary — Refs #8449.\n\nprojects_by_tier is an open Dict[str, int] rather than a fixed model: its\nkeys are whatever `projects.tier` values the user's rows actually carry,\nso a newly introduced tier must flow through without a schema change."},"ProjectsSummaryUsage":{"properties":{"vectors_count":{"type":"integer","title":"Vectors Count","default":0},"tables_count":{"type":"integer","title":"Tables Count","default":0},"events_count":{"type":"integer","title":"Events Count","default":0},"memory_usage_mb":{"type":"integer","title":"Memory Usage Mb","default":0},"storage_usage_mb":{"type":"integer","title":"Storage Usage Mb","default":0}},"type":"object","title":"ProjectsSummaryUsage","description":"Summed usage counters across all of a user's live projects.\n\nField names deliberately match the un-aliased column names the handler\naccumulates into, NOT ProjectUsage's serialization aliases\n(vectors/tables/...). The two payloads have always differed here and\nrenaming would break existing callers. Refs #8449."},"PromptAnalyticsDashboardData":{"properties":{"code_reviews":{"type":"integer","title":"Code Reviews"},"bugs_fixed":{"type":"integer","title":"Bugs Fixed"},"optimizations":{"type":"integer","title":"Optimizations"},"refactorings":{"type":"integer","title":"Refactorings"}},"type":"object","required":["code_reviews","bugs_fixed","optimizations","refactorings"],"title":"PromptAnalyticsDashboardData"},"PromptAnalyticsDashboardResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PromptAnalyticsDashboardData"}},"type":"object","required":["success","data"],"title":"PromptAnalyticsDashboardResponse"},"PromptAnalyticsHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"timestamp":{"type":"string","title":"Timestamp"},"features":{"items":{"type":"string"},"type":"array","title":"Features"}},"type":"object","required":["status","service","timestamp","features"],"title":"PromptAnalyticsHealthResponse","description":"Response for GET /health."},"PromptAnalyticsSummary":{"properties":{"prompt_id":{"type":"string","format":"uuid","title":"Prompt Id"},"total_views":{"type":"integer","title":"Total Views"},"total_copies":{"type":"integer","title":"Total Copies"},"total_downloads":{"type":"integer","title":"Total Downloads"},"total_shares":{"type":"integer","title":"Total Shares"},"total_ratings":{"type":"integer","title":"Total Ratings"},"average_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Average Rating"},"download_by_format":{"additionalProperties":{"type":"integer"},"type":"object","title":"Download By Format"},"shares_by_platform":{"additionalProperties":{"type":"integer"},"type":"object","title":"Shares By Platform"}},"type":"object","required":["prompt_id","total_views","total_copies","total_downloads","total_shares","total_ratings"],"title":"PromptAnalyticsSummary","description":"Summary of prompt analytics"},"PromptAnalyticsTimeRange":{"properties":{"days":{"type":"integer","title":"Days"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"}},"type":"object","required":["days","start_date","end_date"],"title":"PromptAnalyticsTimeRange"},"PromptBulkOperation":{"properties":{"action":{"type":"string","title":"Action","description":"Bulk action to perform"},"template_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Template Ids","description":"List of template IDs"},"version_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Version Ids","description":"List of version IDs"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters","description":"Operation parameters"}},"type":"object","required":["action","template_ids"],"title":"PromptBulkOperation","description":"Schema for bulk operations on prompts"},"PromptBulkResult":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether operation was successful"},"processed_count":{"type":"integer","title":"Processed Count","description":"Number of items processed"},"failed_count":{"type":"integer","title":"Failed Count","description":"Number of items that failed"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","description":"List of errors"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results","description":"Detailed results"}},"type":"object","required":["success","processed_count","failed_count"],"title":"PromptBulkResult","description":"Result of bulk operations"},"PromptEvaluationHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","service","timestamp"],"title":"PromptEvaluationHealthResponse"},"PromptEvaluationMetrics":{"properties":{"total_tests":{"type":"integer","title":"Total Tests"},"passed_tests":{"type":"integer","title":"Passed Tests"},"failed_tests":{"type":"integer","title":"Failed Tests"},"duration_seconds":{"title":"Duration Seconds"}},"type":"object","required":["total_tests","passed_tests","failed_tests","duration_seconds"],"title":"PromptEvaluationMetrics"},"PromptEvaluationScores":{"properties":{"overall_score":{"type":"number","title":"Overall Score"},"success_rate":{"type":"number","title":"Success Rate"},"cost_per_evaluation":{"type":"number","title":"Cost Per Evaluation"}},"type":"object","required":["overall_score","success_rate","cost_per_evaluation"],"title":"PromptEvaluationScores"},"PromptFooProviderInfo":{"properties":{"provider":{"type":"string","title":"Provider"},"description":{"type":"string","title":"Description"}},"type":"object","required":["provider","description"],"title":"PromptFooProviderInfo"},"PromptManagementHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","timestamp"],"title":"PromptManagementHealthResponse","description":"Response for GET /health."},"PromptOptimizationRecommendation":{"properties":{"agent_type":{"type":"string","title":"Agent Type"},"task_type":{"type":"string","title":"Task Type"},"current_performance":{"type":"number","title":"Current Performance"},"potential_improvement":{"type":"number","title":"Potential Improvement"},"recommendation":{"type":"string","title":"Recommendation"}},"type":"object","required":["agent_type","task_type","current_performance","potential_improvement","recommendation"],"title":"PromptOptimizationRecommendation"},"PromptTemplateCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name","description":"Template name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Template description"},"category":{"type":"string","maxLength":100,"minLength":1,"title":"Category","description":"Template category"},"use_case":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Use Case","description":"Template use case description"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id","description":"Team ID for the template"}},"type":"object","required":["name","category"],"title":"PromptTemplateCreate","description":"Schema for creating prompt templates"},"PromptTemplateDetailResponse":{"properties":{"template":{"$ref":"#/components/schemas/PromptTemplateResponse"},"versions":{"items":{"$ref":"#/components/schemas/PromptVersionResponse"},"type":"array","title":"Versions"}},"type":"object","required":["template","versions"],"title":"PromptTemplateDetailResponse"},"PromptTemplateResponse":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"use_case":{"type":"string","title":"Use Case"},"current_version":{"type":"string","title":"Current Version"},"version_count":{"type":"integer","title":"Version Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"created_by":{"type":"string","title":"Created By"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}},"type":"object","required":["prompt_id","name","description","category","use_case","current_version","version_count","created_at","updated_at","created_by"],"title":"PromptTemplateResponse"},"PromptTemplateStats":{"properties":{"total_templates":{"type":"integer","title":"Total Templates","description":"Total number of templates"},"active_templates":{"type":"integer","title":"Active Templates","description":"Number of active templates"},"total_versions":{"type":"integer","title":"Total Versions","description":"Total number of versions"},"categories":{"additionalProperties":{"type":"integer"},"type":"object","title":"Categories","description":"Templates by category"},"most_used_templates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Most Used Templates","description":"Most used templates"}},"type":"object","required":["total_templates","active_templates","total_versions","categories","most_used_templates"],"title":"PromptTemplateStats","description":"Statistics for prompt templates"},"PromptTemplateUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name","description":"Template name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Template description"},"category":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Category","description":"Template category"},"use_case":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Use Case","description":"Template use case description"},"current_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Version","description":"Current version number"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active","description":"Whether template is active"}},"type":"object","title":"PromptTemplateUpdate","description":"Schema for updating prompt templates\n\nUpdated to use standard 'metadata' field name (no alias) to match AINative API standard."},"PromptTestCreatedResponse":{"properties":{"message":{"type":"string","title":"Message"},"config_id":{"type":"string","title":"Config Id"},"test_name":{"type":"string","title":"Test Name"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["message","config_id","test_name","created_at"],"title":"PromptTestCreatedResponse","description":"Response for POST /prompts/test."},"PromptTestRequest":{"properties":{"test_name":{"type":"string","title":"Test Name","description":"Name of the test suite"},"prompts":{"items":{"type":"string"},"type":"array","title":"Prompts","description":"List of prompt variations to test"},"test_cases":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Test Cases","description":"Test cases with inputs and expected outputs"},"providers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Providers","description":"AI providers to test against"},"metrics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Metrics","description":"Evaluation metrics to use"}},"type":"object","required":["test_name","prompts","test_cases"],"title":"PromptTestRequest","description":"Request to create prompt test"},"PromptTestRunResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"PromptTestRunResponse","description":"Response for POST /prompts/test/{config_id}/run.\n\nReal shape is PromptFooService.run_prompt_test()'s own result dict."},"PromptType":{"type":"string","enum":["cli_example","business","financial","research","content_pipeline","general"],"title":"PromptType","description":"Types of prompts that can be extracted"},"PromptUsageCreate":{"properties":{"agent_type":{"type":"string","title":"Agent Type","description":"Type of agent using the prompt"},"task_type":{"type":"string","title":"Task Type","description":"Type of task being performed"},"model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Name","description":"Name of the AI model used"},"input_tokens":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Input Tokens","description":"Number of input tokens"},"output_tokens":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Output Tokens","description":"Number of output tokens"},"latency_ms":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Latency Ms","description":"Response latency in milliseconds"},"success":{"type":"boolean","title":"Success","description":"Whether the usage was successful"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error message if unsuccessful"},"evaluation_score":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Evaluation Score","description":"Evaluation score"},"feedback":{"additionalProperties":true,"type":"object","title":"Feedback","description":"User feedback"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"},"version_id":{"type":"string","format":"uuid","title":"Version Id","description":"Version ID that was used"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id","description":"User ID who used the prompt"},"model_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Model Id","description":"AI model ID used"}},"type":"object","required":["agent_type","task_type","success","version_id"],"title":"PromptUsageCreate","description":"Schema for creating prompt usage records"},"PromptUsageResponse":{"properties":{"agent_type":{"type":"string","title":"Agent Type","description":"Type of agent using the prompt"},"task_type":{"type":"string","title":"Task Type","description":"Type of task being performed"},"model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Name","description":"Name of the AI model used"},"input_tokens":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Input Tokens","description":"Number of input tokens"},"output_tokens":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Output Tokens","description":"Number of output tokens"},"latency_ms":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Latency Ms","description":"Response latency in milliseconds"},"success":{"type":"boolean","title":"Success","description":"Whether the usage was successful"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error message if unsuccessful"},"evaluation_score":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Evaluation Score","description":"Evaluation score"},"feedback":{"additionalProperties":true,"type":"object","title":"Feedback","description":"User feedback"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"},"id":{"type":"string","format":"uuid","title":"Id","description":"Usage ID"},"version_id":{"type":"string","format":"uuid","title":"Version Id","description":"Version ID"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id","description":"User ID"},"model_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Model Id","description":"AI model ID"},"used_at":{"type":"string","format":"date-time","title":"Used At","description":"Usage timestamp"}},"type":"object","required":["agent_type","task_type","success","id","version_id","used_at"],"title":"PromptUsageResponse","description":"Schema for prompt usage responses"},"PromptUsageStats":{"properties":{"total_usage":{"type":"integer","title":"Total Usage","description":"Total usage count"},"successful_usage":{"type":"integer","title":"Successful Usage","description":"Successful usage count"},"success_rate":{"type":"number","title":"Success Rate","description":"Success rate"},"avg_latency":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Latency","description":"Average latency in ms"},"avg_evaluation_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Evaluation Score","description":"Average evaluation score"},"usage_by_agent":{"additionalProperties":{"type":"integer"},"type":"object","title":"Usage By Agent","description":"Usage by agent type"},"usage_by_task":{"additionalProperties":{"type":"integer"},"type":"object","title":"Usage By Task","description":"Usage by task type"},"usage_over_time":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Usage Over Time","description":"Usage over time"}},"type":"object","required":["total_usage","successful_usage","success_rate","usage_by_agent","usage_by_task","usage_over_time"],"title":"PromptUsageStats","description":"Statistics for prompt usage"},"PromptVersionCreate":{"properties":{"content":{"type":"string","minLength":1,"title":"Content","description":"Prompt content"},"template_variables":{"items":{"type":"string"},"type":"array","title":"Template Variables","description":"Template variables"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Version tags"},"deployment_config":{"additionalProperties":true,"type":"object","title":"Deployment Config","description":"Deployment configuration"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"},"version_number":{"type":"string","title":"Version Number","description":"Version number (e.g., '1.0.0')"},"status":{"type":"string","title":"Status","description":"Version status","default":"draft"}},"type":"object","required":["content","version_number"],"title":"PromptVersionCreate","description":"Schema for creating prompt versions"},"PromptVersionDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"prompt_template_id":{"type":"string","title":"Prompt Template Id"},"version_number":{"anyOf":[{},{"type":"null"}],"title":"Version Number"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"template_variables":{"items":{},"type":"array","title":"Template Variables","default":[]},"tags":{"items":{},"type":"array","title":"Tags","default":[]},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"performance_metrics":{"additionalProperties":true,"type":"object","title":"Performance Metrics","default":{}},"test_results":{"additionalProperties":true,"type":"object","title":"Test Results","default":{}},"deployment_config":{"additionalProperties":true,"type":"object","title":"Deployment Config","default":{}},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}},"created_by":{"type":"string","title":"Created By"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"is_active":{"type":"boolean","title":"Is Active","default":true},"usage_count":{"type":"integer","title":"Usage Count"},"success_rate":{"type":"number","title":"Success Rate"},"avg_evaluation_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Evaluation Score"}},"type":"object","required":["id","prompt_template_id","created_by","usage_count","success_rate"],"title":"PromptVersionDetailResponse","description":"Exact shape of GET /admin/prompts/versions/{version_id} --\n`_serialize_version()`'s fields plus the three usage-stat fields\n(`get_version()` in app/api/admin/prompt_management.py) copied from\nPromptUsageStats (app/schemas/prompt.py): total_usage -> usage_count,\nsuccess_rate, avg_evaluation_score."},"PromptVersionResponse":{"properties":{"version_id":{"type":"string","title":"Version Id"},"prompt_id":{"type":"string","title":"Prompt Id"},"version_number":{"type":"string","title":"Version Number"},"content":{"type":"string","title":"Content"},"template_variables":{"items":{"type":"string"},"type":"array","title":"Template Variables"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"created_by":{"type":"string","title":"Created By"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"performance_metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Performance Metrics"},"test_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Test Results"}},"type":"object","required":["version_id","prompt_id","version_number","content","template_variables","status","created_at","created_by","tags"],"title":"PromptVersionResponse"},"PromptVersionUpdate":{"properties":{"content":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Content","description":"Prompt content"},"template_variables":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Template Variables","description":"Template variables"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Version status"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Version tags"},"deployment_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Deployment Config","description":"Deployment configuration"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active","description":"Whether version is active"}},"type":"object","title":"PromptVersionUpdate","description":"Schema for updating prompt versions\n\nUpdated to use standard 'metadata' field name (no alias) to match AINative API standard."},"PromptVersioningHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"timestamp":{"type":"string","title":"Timestamp"},"features":{"items":{"type":"string"},"type":"array","title":"Features"}},"type":"object","required":["status","service","timestamp","features"],"title":"PromptVersioningHealthResponse"},"PropertyResult":{"properties":{"business":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Business"},"parcels":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Parcels"},"knowledge_graph_entities":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Knowledge Graph Entities"},"nearby_sensors":{"additionalProperties":true,"type":"object","title":"Nearby Sensors"},"total_matches":{"type":"integer","title":"Total Matches","default":0},"source":{"type":"string","title":"Source","default":"lakehouse"},"historical_data":{"items":{},"type":"array","title":"Historical Data"}},"type":"object","title":"PropertyResult"},"ProposedOntology":{"properties":{"entity_types":{"items":{"$ref":"#/components/schemas/InferredEntityType"},"type":"array","title":"Entity Types"},"predicates":{"items":{"$ref":"#/components/schemas/InferredPredicate"},"type":"array","title":"Predicates"}},"additionalProperties":true,"type":"object","title":"ProposedOntology"},"ProspectRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":2,"title":"Query","description":"Natural language query"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Filter by city key (sf, nyc, austin, seattle, denver, la)"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry","description":"Filter by industry (saas, ecommerce, finance, healthcare, realestate)"},"min_score":{"type":"number","maximum":100,"minimum":0,"title":"Min Score","description":"Minimum combined score","default":0},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","default":20}},"type":"object","required":["query"],"title":"ProspectRequest"},"ProspectResponse":{"properties":{"query":{"type":"string","title":"Query"},"results":{"items":{"$ref":"#/components/schemas/ProspectResult"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"},"vector_matches":{"type":"integer","title":"Vector Matches"},"graph_boosts":{"type":"integer","title":"Graph Boosts"}},"type":"object","required":["query","results","total","vector_matches","graph_boosts"],"title":"ProspectResponse"},"ProspectResult":{"properties":{"business_name":{"type":"string","title":"Business Name"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"is_tech":{"type":"boolean","title":"Is Tech","default":false},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"lead_score":{"type":"number","title":"Lead Score","default":0},"vector_score":{"type":"number","title":"Vector Score","default":0},"graph_score":{"type":"number","title":"Graph Score","default":0},"combined_score":{"type":"number","title":"Combined Score","default":0},"graph_connections":{"items":{"type":"string"},"type":"array","title":"Graph Connections","default":[]},"enrichment":{"additionalProperties":true,"type":"object","title":"Enrichment","default":{}}},"type":"object","required":["business_name"],"title":"ProspectResult"},"ProviderInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"status":{"type":"string","title":"Status"},"regions":{"items":{"$ref":"#/components/schemas/ProviderRegion"},"type":"array","title":"Regions"}},"type":"object","required":["id","name","type","status","regions"],"title":"ProviderInfo","description":"Cloud provider information."},"ProviderKeyInfo":{"properties":{"has_key":{"type":"boolean","title":"Has Key","default":false},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"last_validated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Validated"},"is_active":{"type":"boolean","title":"Is Active","default":false}},"type":"object","title":"ProviderKeyInfo","description":"Safe (non-secret) info about a stored BYOK provider key"},"ProviderKeysResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"additionalProperties":{"$ref":"#/components/schemas/ProviderKeyInfo"},"type":"object","title":"Data"}},"type":"object","title":"ProviderKeysResponse","description":"Response for GET /settings/provider-keys.\n\nKeyed by ``{provider}_api_key`` (e.g. ``openai_api_key``) — the set of keys\npresent depends on which providers the user has configured, so this is\nintentionally a mapping rather than fixed fields."},"ProviderKeysUpdateResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"ProviderKeysUpdateResponse","description":"Response for PUT /settings/provider-keys"},"ProviderRegion":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"ProviderRegion","description":"A region where a provider is available."},"ProviderSummaryResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"total_earnings_cents":{"type":"integer","title":"Total Earnings Cents"},"total_queries":{"type":"integer","title":"Total Queries"},"unique_consumers":{"type":"integer","title":"Unique Consumers"},"instance_count":{"type":"integer","title":"Instance Count"},"top_tools":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__content_provider_analytics__ToolStat"},"type":"array","title":"Top Tools"}},"type":"object","required":["user_id","total_earnings_cents","total_queries","unique_consumers","instance_count","top_tools"],"title":"ProviderSummaryResponse"},"ProvidersListResponse":{"properties":{"providers":{"items":{"$ref":"#/components/schemas/ProviderInfo"},"type":"array","title":"Providers"}},"type":"object","required":["providers"],"title":"ProvidersListResponse","description":"Response for listing providers."},"ProvisionDefaultsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"tier":{"type":"string","title":"Tier"},"apis":{"items":{"$ref":"#/components/schemas/ProvisionedApiEntry"},"type":"array","title":"Apis"}},"type":"object","required":["project_id","tier"],"title":"ProvisionDefaultsResponse","description":"Response model for POST /{project_id}/api-registry/provision-defaults.\n\n`tier` echoes the raw query parameter verbatim (the service lowercases\ninternally), so it stays a plain str with no pattern constraint — an\nunrecognised tier currently falls back to the \"free\" default set rather\nthan 422-ing, and typing must not change that. Refs #8449."},"ProvisionPostgresResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"project_id":{"type":"string","title":"Project Id"},"instance_size":{"type":"string","title":"Instance Size"},"postgres_version":{"type":"string","title":"Postgres Version"},"estimated_completion_time_minutes":{"type":"integer","title":"Estimated Completion Time Minutes"},"status":{"type":"string","title":"Status"}},"type":"object","required":["success","message","project_id","instance_size","postgres_version","estimated_completion_time_minutes","status"],"title":"ProvisionPostgresResponse"},"ProvisionRequest":{"properties":{"provider":{"type":"string","minLength":1,"title":"Provider"},"region":{"type":"string","minLength":1,"title":"Region"}},"type":"object","required":["provider","region"],"title":"ProvisionRequest","description":"Request to provision a cloud environment."},"ProvisionedApiEntry":{"properties":{"api_name":{"type":"string","title":"Api Name"},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["api_name","enabled"],"title":"ProvisionedApiEntry","description":"One entry from provision_defaults — Refs #8449."},"ProxyHealthStatusData":{"properties":{"overall_health":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Overall Health","description":"healthy | degraded | unhealthy"},"kong_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kong Status","description":"API-gateway component status"},"websocket_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Websocket Status","description":"WebSocket component status"},"container_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container Status","description":"Container component status"},"billing_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Status","description":"Billing component status"},"uptime_percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Uptime Percentage","description":"Uptime percentage"},"last_incident":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Incident","description":"Timestamp of last incident"},"health_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Health Score","description":"Composite health score (0-100)"},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp","description":"Collection timestamp"}},"additionalProperties":true,"type":"object","title":"ProxyHealthStatusData","description":"Mirror of mcp_proxy_metrics_service.ProxyHealthStatus, as nested data."},"PublicAgentSwarmAgentConfigEntry":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"status":{"type":"string","title":"Status"}},"type":"object","required":["enabled","status"],"title":"PublicAgentSwarmAgentConfigEntry"},"PublicAgentSwarmProjectListItem":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"project_type":{"type":"string","title":"Project Type"},"description":{"type":"string","title":"Description"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"progress":{"type":"integer","title":"Progress"},"tier":{"anyOf":[{},{"type":"null"}],"title":"Tier"},"database_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Database Enabled"}},"type":"object","required":["project_id","project_name","project_type","description","status","created_at","updated_at","progress"],"title":"PublicAgentSwarmProjectListItem"},"PublicApiInfoResponse":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"version":{"type":"string","title":"Version"},"access_level":{"type":"string","title":"Access Level"},"endpoints_count":{"type":"integer","title":"Endpoints Count"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"documentation":{"type":"string","title":"Documentation"},"authentication_note":{"type":"string","title":"Authentication Note"}},"type":"object","required":["name","description","version","access_level","endpoints_count","categories","documentation","authentication_note"],"title":"PublicApiInfoResponse","description":"GET /api/v1/public/"},"PublicBillingInfoResponse":{"properties":{"payment_method":{"anyOf":[{"$ref":"#/components/schemas/PaymentMethodResponse"},{"type":"null"}],"description":"Primary payment method on file (only last 4 digits shown for security)"},"next_billing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Billing Date","description":"Next billing date in ISO 8601 format","example":"2025-01-15T00:00:00Z"},"amount_due":{"type":"number","minimum":0,"title":"Amount Due","description":"Amount due on next billing date in dollars (not cents)","example":99},"currency":{"type":"string","maxLength":3,"minLength":3,"title":"Currency","description":"Currency code (ISO 4217)","example":"USD"},"billing_cycle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Cycle","description":"Billing cycle frequency (monthly, yearly, etc.)","example":"monthly"}},"type":"object","required":["amount_due","currency"],"title":"PublicBillingInfoResponse","description":"Public billing information response for authenticated users\nIssue #323 - Returns user-scoped billing data without admin privileges","example":{"amount_due":99,"billing_cycle":"monthly","currency":"USD","next_billing_date":"2025-01-15T00:00:00Z","payment_method":{"brand":"visa","exp_month":12,"exp_year":2025,"last4":"4242","type":"card"}}},"PublicBillingResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PublicBillingInfoResponse"}},"type":"object","required":["success","data"],"title":"PublicBillingResponse","description":"Response for GET /billing."},"PublicCodyChatChoice":{"properties":{"index":{"type":"integer","title":"Index"},"message":{"additionalProperties":{"type":"string"},"type":"object","title":"Message"},"finish_reason":{"type":"string","title":"Finish Reason"}},"type":"object","required":["index","message","finish_reason"],"title":"PublicCodyChatChoice"},"PublicCodyChatRequest":{"properties":{"messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":20,"minItems":1,"title":"Messages","description":"OpenAI-format message list"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Model alias to use","default":"llama-70b"},"max_tokens":{"anyOf":[{"type":"integer","maximum":2048,"minimum":1},{"type":"null"}],"title":"Max Tokens","description":"Maximum tokens to generate","default":2048},"stream":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Stream","description":"Streaming not yet supported on this endpoint","default":false}},"type":"object","required":["messages"],"title":"PublicCodyChatRequest","description":"Request body for public Cody chat inference."},"PublicCodyChatResponse":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","title":"Object"},"model":{"type":"string","title":"Model"},"choices":{"items":{"$ref":"#/components/schemas/PublicCodyChatChoice"},"type":"array","title":"Choices"},"usage":{"$ref":"#/components/schemas/PublicCodyChatUsage"}},"type":"object","required":["id","object","model","choices","usage"],"title":"PublicCodyChatResponse","description":"OpenAI-compatible chat completion shape. Refs #3044.\n\nThe handler always returns a JSONResponse directly (needed for the\nX-Cody-* response headers), so FastAPI does not validate/serialize\nagainst this model at runtime — it documents the real success shape\nfor OpenAPI/AEO consumers only."},"PublicCodyChatUsage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"PublicCodyChatUsage"},"PublicDatabaseStatsResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"api_version":{"type":"string","title":"Api Version"},"database_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database Size"},"active_connections":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Connections"},"uptime_hours":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Uptime Hours"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["timestamp","api_version"],"title":"PublicDatabaseStatsResponse","description":"Response for GET /database/stats. The metric fields are omitted when\nthe inner metrics query fails (replaced by `error`); `error` is also set\nalone (with no metric fields) if the outer handler catches first."},"PublicDatabaseStatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"timestamp":{"type":"string","title":"Timestamp"},"api_version":{"type":"string","title":"Api Version"},"database_connectivity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database Connectivity"}},"type":"object","required":["status","timestamp","api_version"],"title":"PublicDatabaseStatusResponse","description":"Response for GET /database/status. `database_connectivity` is omitted\nonly if the outer handler's own try/except caught an unexpected error\nbefore the connectivity check ran."},"PublicGitHubTokenRequest":{"properties":{"token":{"type":"string","title":"Token"},"enable_repo_access":{"type":"boolean","title":"Enable Repo Access","default":true},"auto_sync_repos":{"type":"boolean","title":"Auto Sync Repos","default":false},"sync_private_repos":{"type":"boolean","title":"Sync Private Repos","default":false}},"type":"object","required":["token"],"title":"PublicGitHubTokenRequest","description":"Body the agent-swarm wizard posts to /api/v1/public/github/token.\n\nNote the field is ``token`` (what the frontend sends), distinct from the\nadmin github_settings router's ``github_token``. Refs #235."},"PublicPrefixesGetResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"bucket_name":{"type":"string","title":"Bucket Name"},"public_prefixes":{"items":{"type":"string"},"type":"array","title":"Public Prefixes"},"status":{"type":"string","title":"Status"}},"type":"object","required":["project_id","bucket_name","public_prefixes","status"],"title":"PublicPrefixesGetResponse","description":"Response for GET /projects/{project_id}/public-prefixes."},"PublicPrefixesRequest":{"properties":{"prefixes":{"items":{"type":"string"},"type":"array","maxItems":20,"minItems":1,"title":"Prefixes","description":"Key prefixes to make publicly readable (e.g. ['profile-photos/', 'avatars/'])"}},"type":"object","required":["prefixes"],"title":"PublicPrefixesRequest"},"PublicPrefixesResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"bucket_name":{"type":"string","title":"Bucket Name"},"public_prefixes":{"items":{"type":"string"},"type":"array","title":"Public Prefixes"},"status":{"type":"string","title":"Status"}},"type":"object","required":["project_id","bucket_name","public_prefixes","status"],"title":"PublicPrefixesResponse"},"PublicUserAnalytics":{"properties":{"username":{"type":"string","title":"Username","description":"Username (handle)"},"fullName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fullname","description":"User's full name"},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatarurl","description":"Profile avatar URL"},"totalStreamViews":{"type":"integer","minimum":0,"title":"Totalstreamviews","description":"Total views across all streams"},"totalFollowers":{"type":"integer","minimum":0,"title":"Totalfollowers","description":"Total number of followers"},"avgConcurrentViewers":{"type":"number","minimum":0,"title":"Avgconcurrentviewers","description":"Average concurrent viewers per stream"},"totalStreamHours":{"type":"integer","minimum":0,"title":"Totalstreamhours","description":"Total hours streamed"},"mostPopularCategory":{"anyOf":[{"$ref":"#/components/schemas/CategorySummary"},{"type":"null"}],"description":"Category with most streams"},"isPartner":{"type":"boolean","title":"Ispartner","description":"Partner status"},"isAffiliate":{"type":"boolean","title":"Isaffiliate","description":"Affiliate status"}},"type":"object","required":["username","totalStreamViews","totalFollowers","avgConcurrentViewers","totalStreamHours","isPartner","isAffiliate"],"title":"PublicUserAnalytics","description":"Public analytics for a user's streaming profile","example":{"avatarUrl":"https://example.com/avatar.jpg","avgConcurrentViewers":45.5,"fullName":"John Doe","isAffiliate":false,"isPartner":true,"mostPopularCategory":{"name":"Game Development","slug":"game-development","streamCount":15},"totalFollowers":250,"totalStreamHours":120,"totalStreamViews":1500,"username":"awesome_streamer"}},"PublishAcceptedResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/PublishJobResult"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"PublishAcceptedResponse"},"PublishJobResult":{"properties":{"platform":{"type":"string","title":"Platform"},"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["platform","task_id","status"],"title":"PublishJobResult"},"PublishJobResultDetail":{"properties":{"platform_post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Post Url"}},"type":"object","title":"PublishJobResultDetail"},"PublishRequest":{"properties":{"reel_url":{"type":"string","title":"Reel Url"},"caption":{"type":"string","title":"Caption","default":""},"platforms":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Platforms"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"scheduled_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled At"}},"type":"object","required":["reel_url","platforms"],"title":"PublishRequest"},"PublishSkillRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"description":{"type":"string","maxLength":500,"minLength":1,"title":"Description"},"content":{"type":"string","minLength":1,"title":"Content"},"version":{"type":"string","maxLength":20,"title":"Version","default":"1.0.0"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"category":{"type":"string","maxLength":50,"title":"Category","default":"general"},"compatibility":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Compatibility"},"trigger_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Trigger Patterns"},"commands":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Commands"},"examples":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Examples"},"tier":{"type":"string","maxLength":30,"title":"Tier","default":"org-private"}},"type":"object","required":["name","description","content"],"title":"PublishSkillRequest","description":"Request body for publishing an org-private skill."},"PublishSkillResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"skill_id":{"type":"string","title":"Skill Id"},"name":{"type":"string","title":"Name"},"tier":{"type":"string","title":"Tier"},"origin":{"type":"string","title":"Origin"}},"type":"object","required":["skill_id","name","tier","origin"],"title":"PublishSkillResponse","description":"Response after publishing a skill."},"PublishStatusResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"},"platform":{"type":"string","title":"Platform"},"progress":{"type":"integer","title":"Progress"},"result":{"anyOf":[{"$ref":"#/components/schemas/PublishJobResultDetail"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["task_id","status","platform","progress"],"title":"PublishStatusResponse"},"PushChangesResponse":{"properties":{"status":{"type":"string","title":"Status"},"push_result":{"additionalProperties":true,"type":"object","title":"Push Result"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","push_result","timestamp"],"title":"PushChangesResponse","description":"Response for POST /git-integration/push."},"PushRegisterRequest":{"properties":{"device_id":{"type":"string","maxLength":255,"minLength":1,"title":"Device Id"},"push_token":{"type":"string","minLength":1,"title":"Push Token"},"platform":{"type":"string","enum":["ios","android"],"title":"Platform"}},"type":"object","required":["device_id","push_token","platform"],"title":"PushRegisterRequest"},"PushRegisterResponse":{"properties":{"registered":{"type":"boolean","title":"Registered"}},"type":"object","required":["registered"],"title":"PushRegisterResponse"},"QnnCircuitInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"num_qubits":{"type":"integer","title":"Num Qubits"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","name","status","num_qubits","created_at"],"title":"QnnCircuitInfo"},"QualityDeltaResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"delta":{"type":"number","title":"Delta"},"trend":{"type":"string","title":"Trend"},"baseline_avg":{"type":"number","title":"Baseline Avg"},"current_avg":{"type":"number","title":"Current Avg"},"current_runs":{"type":"integer","title":"Current Runs"},"baseline_runs":{"type":"integer","title":"Baseline Runs"}},"type":"object","required":["agent_id","delta","trend","baseline_avg","current_avg","current_runs","baseline_runs"],"title":"QualityDeltaResponse"},"QualityInsightsResponse":{"properties":{"overall_quality_score":{"type":"number","title":"Overall Quality Score"},"trend":{"type":"string","title":"Trend"},"agent_insights":{"additionalProperties":{"$ref":"#/components/schemas/AgentInsight"},"type":"object","title":"Agent Insights"},"improvement_opportunities":{"items":{"type":"string"},"type":"array","title":"Improvement Opportunities"},"success_patterns":{"items":{"type":"string"},"type":"array","title":"Success Patterns"},"failure_patterns":{"items":{"type":"string"},"type":"array","title":"Failure Patterns"}},"type":"object","required":["overall_quality_score","trend","agent_insights","improvement_opportunities","success_patterns","failure_patterns"],"title":"QualityInsightsResponse","description":"Response for GET /dashboard/quality/insights."},"QualityOutput":{"properties":{"quality":{"type":"string","title":"Quality","description":"Quality level (e.g., '720p')"},"url":{"type":"string","title":"Url","description":"URL to HLS playlist for this quality"},"bitrate":{"type":"string","title":"Bitrate","description":"Video bitrate (e.g., '2500k')"},"resolution":{"type":"string","title":"Resolution","description":"Resolution (e.g., '1280x720')"},"segment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Segment Count","description":"Number of HLS segments"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes","description":"Total size in bytes"},"status":{"type":"string","title":"Status","description":"Status: completed, processing, failed"}},"type":"object","required":["quality","url","bitrate","resolution","status"],"title":"QualityOutput","description":"Schema for a single quality output"},"QualitySummaryResponse":{"properties":{"analysis_timestamp":{"type":"string","title":"Analysis Timestamp"},"time_window_days":{"type":"integer","title":"Time Window Days"},"prompts_analyzed":{"type":"integer","title":"Prompts Analyzed"},"overall_metrics":{"additionalProperties":true,"type":"object","title":"Overall Metrics"},"prompt_summaries":{"additionalProperties":true,"type":"object","title":"Prompt Summaries"},"trending_analysis":{"additionalProperties":true,"type":"object","title":"Trending Analysis"},"alert_summary":{"additionalProperties":true,"type":"object","title":"Alert Summary"}},"type":"object","required":["analysis_timestamp","time_window_days","prompts_analyzed","overall_metrics","prompt_summaries","trending_analysis","alert_summary"],"title":"QualitySummaryResponse"},"QualityThresholdLevels":{"properties":{"critical":{"type":"number","title":"Critical"},"warning":{"type":"number","title":"Warning"},"good":{"type":"number","title":"Good"},"excellent":{"type":"number","title":"Excellent"}},"type":"object","required":["critical","warning","good","excellent"],"title":"QualityThresholdLevels"},"QualityTrendingConfigResponse":{"properties":{"trend_directions":{"items":{"type":"string"},"type":"array","title":"Trend Directions"},"alert_severities":{"items":{"type":"string"},"type":"array","title":"Alert Severities"},"confidence_levels":{"items":{"type":"string"},"type":"array","title":"Confidence Levels"},"default_settings":{"$ref":"#/components/schemas/QualityTrendingDefaultSettings"},"supported_alert_types":{"items":{"type":"string"},"type":"array","title":"Supported Alert Types"},"supported_conditions":{"$ref":"#/components/schemas/QualityTrendingSupportedConditions"},"features":{"items":{"type":"string"},"type":"array","title":"Features"}},"type":"object","required":["trend_directions","alert_severities","confidence_levels","default_settings","supported_alert_types","supported_conditions","features"],"title":"QualityTrendingConfigResponse","description":"Response for GET /config."},"QualityTrendingDefaultSettings":{"properties":{"min_data_points":{"type":"integer","title":"Min Data Points"},"default_time_window_days":{"type":"integer","title":"Default Time Window Days"},"anomaly_threshold":{"type":"number","title":"Anomaly Threshold"},"trend_significance_threshold":{"type":"number","title":"Trend Significance Threshold"},"default_cooldown_minutes":{"type":"integer","title":"Default Cooldown Minutes"}},"type":"object","required":["min_data_points","default_time_window_days","anomaly_threshold","trend_significance_threshold","default_cooldown_minutes"],"title":"QualityTrendingDefaultSettings"},"QualityTrendingSupportedConditions":{"properties":{"quality_threshold":{"items":{"type":"string"},"type":"array","title":"Quality Threshold"},"trend_condition":{"items":{"type":"string"},"type":"array","title":"Trend Condition"},"anomaly_detection":{"items":{"type":"boolean"},"type":"array","title":"Anomaly Detection"}},"type":"object","required":["quality_threshold","trend_condition","anomaly_detection"],"title":"QualityTrendingSupportedConditions"},"QuantumCircuit":{"properties":{"id":{"type":"string","title":"Id"},"original_circuit_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Circuit Id","description":"Original circuit ID if this circuit is a derivative"},"qubits":{"type":"integer","maximum":100,"minimum":1,"title":"Qubits","description":"Number of qubits in the circuit"},"circuit_definition":{"additionalProperties":true,"type":"object","title":"Circuit Definition","description":"Detailed quantum circuit configuration"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["qubits","circuit_definition"],"title":"QuantumCircuit","description":"Legacy quantum circuit schema"},"QuantumCompressRequest":{"properties":{"vector_embedding":{"items":{"type":"number"},"type":"array","maxItems":4096,"minItems":1,"title":"Vector Embedding","description":"Vector to compress (1-4096 dimensions)"},"compression_ratio":{"anyOf":[{"type":"number","maximum":0.8,"minimum":0.2},{"type":"null"}],"title":"Compression Ratio","description":"Target compression ratio (ignored, kept for backward compat)","default":0.5},"preserve_similarity":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Preserve Similarity","description":"Preserve similarity relationships during compression","default":true},"precision":{"anyOf":[{"type":"integer","maximum":32,"minimum":8},{"type":"null"}],"title":"Precision","description":"Bit precision for radius quantization (8, 16, or 32)","default":16},"method":{"anyOf":[{"type":"string","pattern":"^(quantum_harmonic|sparse_encode|entropy_reduce|turboquant|polarquant|qjl)$"},{"type":"null"}],"title":"Method","description":"Compression algorithm: turboquant (default), polarquant, qjl. Legacy names quantum_harmonic/sparse_encode/entropy_reduce are mapped automatically.","default":"quantum_harmonic"}},"type":"object","required":["vector_embedding"],"title":"QuantumCompressRequest","description":"Request schema for TurboQuant vector compression"},"QuantumCompressResponse":{"properties":{"compressed_data":{"type":"string","title":"Compressed Data","description":"Base64-encoded compressed vector data"},"original_dimensions":{"type":"integer","title":"Original Dimensions","description":"Original vector dimensions"},"compressed_dimensions":{"type":"integer","title":"Compressed Dimensions","description":"Compressed representation dimensions"},"compression_ratio":{"type":"number","title":"Compression Ratio","description":"Actual compression ratio achieved"},"compression_metadata":{"additionalProperties":true,"type":"object","title":"Compression Metadata","description":"Metadata about the compression (entropy, sparsity, magnitude)"},"stats":{"additionalProperties":true,"type":"object","title":"Stats","description":"Compression statistics (original_size, compressed_size, compression_time_ms, algorithm)"}},"type":"object","required":["compressed_data","original_dimensions","compressed_dimensions","compression_ratio","compression_metadata","stats"],"title":"QuantumCompressResponse","description":"Response schema for quantum vector compression"},"QuantumCompressionCurrentStats":{"properties":{"total_vectors":{"type":"integer","title":"Total Vectors"},"estimated_current_size_mb":{"type":"number","title":"Estimated Current Size Mb"},"estimated_compressed_size_mb":{"type":"number","title":"Estimated Compressed Size Mb"},"potential_savings_mb":{"type":"number","title":"Potential Savings Mb"},"savings_percentage":{"type":"number","title":"Savings Percentage"}},"type":"object","required":["total_vectors","estimated_current_size_mb","estimated_compressed_size_mb","potential_savings_mb","savings_percentage"],"title":"QuantumCompressionCurrentStats"},"QuantumCompressionSettings":{"properties":{"algorithm":{"type":"string","title":"Algorithm"},"compression_ratio":{"type":"number","title":"Compression Ratio"},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["algorithm","compression_ratio","enabled"],"title":"QuantumCompressionSettings"},"QuantumDeviceResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"device_id":{"type":"string","title":"Device Id"},"name":{"type":"string","title":"Name"},"provider":{"type":"string","title":"Provider"},"device_type":{"type":"string","title":"Device Type"},"qubits":{"type":"integer","title":"Qubits"},"topology":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Topology"},"status":{"type":"string","title":"Status"},"is_available":{"type":"boolean","title":"Is Available"},"queue_length":{"type":"integer","title":"Queue Length"},"avg_wait_time":{"type":"integer","title":"Avg Wait Time"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"}},"type":"object","required":["id","device_id","name","provider","device_type","qubits","topology","status","is_available","queue_length","avg_wait_time","meta_data"],"title":"QuantumDeviceResponse","description":"Schema for quantum device API responses"},"QuantumExecuteResponse":{"properties":{"id":{"type":"string","title":"Id"},"device_id":{"type":"string","title":"Device Id"},"status":{"type":"string","title":"Status"},"shots":{"type":"integer","title":"Shots"},"result":{"$ref":"#/components/schemas/QuantumExecutionResult"},"created_at":{"type":"string","title":"Created At"},"completed_at":{"type":"string","title":"Completed At"}},"type":"object","required":["id","device_id","status","shots","result","created_at","completed_at"],"title":"QuantumExecuteResponse","description":"Response for POST /quantum/execute (legacy execute endpoint)."},"QuantumExecutionRequest":{"properties":{"device_id":{"type":"string","title":"Device Id"},"circuit_definition":{"additionalProperties":true,"type":"object","title":"Circuit Definition"},"shots":{"type":"integer","maximum":100000,"minimum":1,"title":"Shots","default":1000},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters"}},"type":"object","required":["device_id","circuit_definition"],"title":"QuantumExecutionRequest","description":"Schema for quantum execution requests"},"QuantumExecutionResult":{"properties":{"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"},"success":{"type":"boolean","title":"Success"},"execution_time":{"type":"number","title":"Execution Time"}},"type":"object","required":["counts","success","execution_time"],"title":"QuantumExecutionResult"},"QuantumHealthMetrics":{"properties":{"active_jobs":{"type":"integer","title":"Active Jobs"},"available_devices":{"type":"integer","title":"Available Devices"},"queue_status":{"type":"string","title":"Queue Status"},"tables_initialized":{"type":"boolean","title":"Tables Initialized"}},"type":"object","required":["active_jobs","available_devices","queue_status","tables_initialized"],"title":"QuantumHealthMetrics"},"QuantumHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"healthy":{"type":"boolean","title":"Healthy"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"},"metrics":{"$ref":"#/components/schemas/QuantumHealthMetrics"}},"type":"object","required":["status","healthy","message","timestamp","metrics"],"title":"QuantumHealthResponse","description":"Response for GET /quantum/health."},"QuantumInfoResponse":{"properties":{"status":{"type":"string","title":"Status"},"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version"},"timestamp":{"type":"string","title":"Timestamp"},"description":{"type":"string","title":"Description"},"supported_providers":{"items":{"type":"string"},"type":"array","title":"Supported Providers"},"max_qubits":{"type":"integer","title":"Max Qubits"},"concurrent_jobs":{"type":"integer","title":"Concurrent Jobs"}},"type":"object","required":["status","name","version","timestamp","description","supported_providers","max_qubits","concurrent_jobs"],"title":"QuantumInfoResponse","description":"Response for GET /quantum/info."},"QuantumJobCreate":{"properties":{"device_id":{"type":"string","title":"Device Id"},"job_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Name"},"circuit_definition":{"additionalProperties":true,"type":"object","title":"Circuit Definition"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters"},"shots":{"type":"integer","maximum":100000,"minimum":1,"title":"Shots","default":1000}},"type":"object","required":["device_id","circuit_definition"],"title":"QuantumJobCreate","description":"Schema for creating quantum jobs"},"QuantumJobResponse":{"properties":{"device_id":{"type":"string","title":"Device Id"},"job_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Name"},"circuit_definition":{"additionalProperties":true,"type":"object","title":"Circuit Definition"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters"},"shots":{"type":"integer","maximum":100000,"minimum":1,"title":"Shots","default":1000},"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"status":{"type":"string","title":"Status"},"provider":{"type":"string","title":"Provider"},"external_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Job Id"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"estimated_runtime":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Runtime"},"actual_runtime":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Actual Runtime"},"queue_position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Queue Position"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["device_id","circuit_definition","id","user_id","organization_id","status","provider","external_job_id","result","error_message","estimated_runtime","actual_runtime","queue_position","created_at","started_at","completed_at"],"title":"QuantumJobResponse","description":"Schema for quantum job API responses"},"QuantumReviewResponse":{"properties":{"review":{"type":"string","title":"Review"},"quantum_suggestions":{"items":{"type":"string"},"type":"array","title":"Quantum Suggestions"},"confidence":{"type":"number","title":"Confidence"}},"type":"object","required":["review","quantum_suggestions","confidence"],"title":"QuantumReviewResponse","description":"Result of a quantum-enhanced code review run."},"QuarantineRequest":{"properties":{"content":{"type":"string","maxLength":500000,"title":"Content","description":"Raw extracted text to sanitize"},"content_type":{"type":"string","enum":["pdf_extract","html","ocr","markdown"],"title":"Content Type","description":"Source format of the content"},"strip_links":{"type":"boolean","title":"Strip Links","description":"Strip external links from the sanitized output","default":true}},"type":"object","required":["content","content_type"],"title":"QuarantineRequest"},"QuarantineResponse":{"properties":{"sanitized":{"type":"string","title":"Sanitized","description":"Cleaned text safe to pass to agents"},"threats_detected":{"items":{"type":"string"},"type":"array","title":"Threats Detected","description":"List of threat categories found: hidden_unicode, html_comment_injection, script_injection, base64_blob, external_links"},"stripped_count":{"type":"integer","title":"Stripped Count","description":"Total number of individual items stripped across all threat categories"},"safe_to_use":{"type":"boolean","title":"Safe To Use","description":"False if high-risk threats (script_injection, base64_blob) were detected even after stripping — review before use"}},"type":"object","required":["sanitized","threats_detected","stripped_count","safe_to_use"],"title":"QuarantineResponse"},"QueryExecutionRequest":{"properties":{"sql":{"type":"string","maxLength":50000,"minLength":1,"title":"Sql","description":"SQL query to execute"},"timeout_seconds":{"anyOf":[{"type":"integer","maximum":300,"minimum":1},{"type":"null"}],"title":"Timeout Seconds","description":"Query timeout in seconds (max 5 minutes)","default":30},"read_only":{"type":"boolean","title":"Read Only","description":"Execute in read-only mode (SELECT only)","default":false},"use_prepared_statement":{"type":"boolean","title":"Use Prepared Statement","description":"Use prepared statements for better performance","default":false},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters","description":"Query parameters for prepared statements"},"max_rows":{"anyOf":[{"type":"integer","maximum":10000,"minimum":1},{"type":"null"}],"title":"Max Rows","description":"Maximum rows to return","default":1000}},"type":"object","required":["sql"],"title":"QueryExecutionRequest","description":"SQL Query Execution Request"},"QueryExecutionResponse":{"properties":{"query_id":{"type":"string","title":"Query Id","description":"Unique query execution ID"},"project_id":{"type":"string","title":"Project Id","description":"Project identifier"},"query_type":{"type":"string","title":"Query Type","description":"Query type (SELECT, INSERT, UPDATE, DELETE, etc.)"},"success":{"type":"boolean","title":"Success","description":"Query execution success status"},"execution_time_ms":{"type":"number","title":"Execution Time Ms","description":"Query execution time in milliseconds"},"rows_affected":{"type":"integer","title":"Rows Affected","description":"Number of rows affected by the query"},"rows_returned":{"type":"integer","title":"Rows Returned","description":"Number of rows returned by the query"},"columns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Columns","description":"Column names for SELECT queries"},"data":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Data","description":"Query results for SELECT queries"},"credits_consumed":{"type":"number","title":"Credits Consumed","description":"Total credits consumed by the query"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if query failed"},"warnings":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Warnings","description":"Query warnings (e.g., missing indexes, slow query)","default":[]},"query_plan":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Query Plan","description":"Query execution plan (if requested)"}},"type":"object","required":["query_id","project_id","query_type","success","execution_time_ms","rows_affected","rows_returned","credits_consumed"],"title":"QueryExecutionResponse","description":"SQL Query Execution Response"},"QueryHistoryItem":{"properties":{"id":{"type":"string","title":"Id","description":"History entry ID"},"query":{"type":"string","title":"Query","description":"SQL query text"},"query_type":{"type":"string","title":"Query Type","description":"Type of query"},"execution_time_ms":{"type":"number","minimum":0,"title":"Execution Time Ms","description":"Execution time in milliseconds"},"rows_returned":{"type":"integer","minimum":0,"title":"Rows Returned","description":"Number of rows returned","default":0},"success":{"type":"boolean","title":"Success","description":"Success status"},"executed_at":{"type":"string","format":"date-time","title":"Executed At","description":"Execution timestamp"},"credits_consumed":{"type":"integer","minimum":0,"title":"Credits Consumed","description":"Credits consumed","default":0}},"type":"object","required":["id","query","query_type","execution_time_ms","success","executed_at"],"title":"QueryHistoryItem","description":"Query history item model","example":{"credits_consumed":1,"executed_at":"2025-12-03T10:00:00Z","execution_time_ms":45.2,"id":"hist_abc123","query":"SELECT * FROM users LIMIT 10","query_type":"SELECT","rows_returned":10,"success":true}},"QueryHistoryResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/QueryHistoryItem"},"type":"array","title":"Items","description":"List of query history items","default":[]},"total":{"type":"integer","minimum":0,"title":"Total","description":"Total number of history items"},"limit":{"type":"integer","minimum":1,"title":"Limit","description":"Items per page"},"offset":{"type":"integer","minimum":0,"title":"Offset","description":"Pagination offset"}},"type":"object","required":["total","limit","offset"],"title":"QueryHistoryResponse","description":"Response model for query history","example":{"items":[{"credits_consumed":1,"executed_at":"2025-12-03T10:00:00Z","execution_time_ms":45.2,"id":"hist_abc123","query":"SELECT * FROM users","query_type":"SELECT","rows_returned":10,"success":true}],"limit":20,"offset":0,"total":50}},"QueryPerformanceMetrics":{"properties":{"period":{"type":"string","title":"Period"},"slow_queries":{"items":{"$ref":"#/components/schemas/SlowQueryEntry"},"type":"array","title":"Slow Queries"},"average_query_time":{"type":"number","title":"Average Query Time"},"queries_per_second":{"type":"number","title":"Queries Per Second"},"query_cache_hit_ratio":{"type":"number","title":"Query Cache Hit Ratio"},"long_running_queries":{"type":"integer","title":"Long Running Queries"},"blocked_queries":{"type":"integer","title":"Blocked Queries"},"deadlocks":{"type":"integer","title":"Deadlocks"}},"type":"object","required":["period","slow_queries","average_query_time","queries_per_second","query_cache_hit_ratio","long_running_queries","blocked_queries","deadlocks"],"title":"QueryPerformanceMetrics"},"QueryPlanCache":{"properties":{"cached_plans":{"type":"integer","title":"Cached Plans"},"cache_hits":{"type":"integer","title":"Cache Hits"},"cache_misses":{"type":"integer","title":"Cache Misses"},"hit_ratio":{"type":"number","title":"Hit Ratio"}},"type":"object","required":["cached_plans","cache_hits","cache_misses","hit_ratio"],"title":"QueryPlanCache"},"QueryResultItem":{"properties":{"id":{"type":"string","title":"Id"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["id","score"],"title":"QueryResultItem"},"QueryStatisticsResponse":{"properties":{"total_queries":{"type":"integer","title":"Total Queries"},"slow_queries":{"type":"integer","title":"Slow Queries"},"slow_query_percentage":{"type":"number","title":"Slow Query Percentage"},"avg_execution_time_ms":{"type":"number","title":"Avg Execution Time Ms"},"time_window_hours":{"type":"integer","title":"Time Window Hours"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"}},"type":"object","required":["total_queries","slow_queries","slow_query_percentage","avg_execution_time_ms","time_window_hours","tenant_id"],"title":"QueryStatisticsResponse","description":"Query statistics response model"},"QueuedInvoice":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"task_id":{"type":"string","title":"Task Id"}},"type":"object","required":["user_id","email","task_id"],"title":"QueuedInvoice"},"QuotaStatus":{"properties":{"allowed":{"type":"boolean","title":"Allowed"},"remaining":{"type":"integer","title":"Remaining"},"limit":{"type":"integer","title":"Limit"}},"additionalProperties":true,"type":"object","required":["allowed","remaining","limit"],"title":"QuotaStatus","description":"One quota counter, as returned by check_completion_quota /\ncheck_chat_quota.\n\n`remaining` and `limit` use -1 as the \"unlimited\" sentinel, so neither may\nbe constrained to a non-negative value."},"RLHFComparisonInteractions":{"properties":{"response_a":{"$ref":"#/components/schemas/RLHFComparisonSide","description":"Result for response A"},"response_b":{"$ref":"#/components/schemas/RLHFComparisonSide","description":"Result for response B"}},"type":"object","required":["response_a","response_b"],"title":"RLHFComparisonInteractions","description":"Both sides of a comparison RLHF interaction"},"RLHFComparisonResponse":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project the interactions belong to"},"comparison_created":{"type":"boolean","title":"Comparison Created","description":"Whether the comparison pair was created successfully"},"preferred_response":{"type":"string","title":"Preferred Response","description":"Which response was marked preferred: 'A' or 'B'"},"interactions":{"$ref":"#/components/schemas/RLHFComparisonInteractions","description":"The two created interactions"},"message":{"type":"string","title":"Message","description":"Human-readable confirmation message"}},"type":"object","required":["project_id","comparison_created","preferred_response","interactions","message"],"title":"RLHFComparisonResponse","description":"Response returned after creating a comparison (A/B) RLHF interaction pair"},"RLHFComparisonSide":{"properties":{"interaction_id":{"type":"string","title":"Interaction Id","description":"Identifier of the interaction created for this response"},"feedback":{"type":"string","title":"Feedback","description":"Feedback category assigned: positive or negative"},"reward":{"type":"number","title":"Reward","description":"Reward assigned to this response"},"preferred":{"type":"boolean","title":"Preferred","description":"Whether this response was the preferred one"}},"type":"object","required":["interaction_id","feedback","reward","preferred"],"title":"RLHFComparisonSide","description":"Result for one side (A or B) of a comparison RLHF interaction"},"RLHFDatasetCreate":{"properties":{"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"input_prompt":{"type":"string","title":"Input Prompt","description":"Input prompt"},"model_output":{"type":"string","title":"Model Output","description":"Model output"},"reward_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward Score","description":"Reward score"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes","description":"Additional notes"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"Project ID (set automatically)"}},"type":"object","required":["input_prompt","model_output"],"title":"RLHFDatasetCreate","description":"Schema for creating RLHF datasets"},"RLHFDatasetResponse":{"properties":{"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"input_prompt":{"type":"string","title":"Input Prompt","description":"Input prompt"},"model_output":{"type":"string","title":"Model Output","description":"Model output"},"reward_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward Score","description":"Reward score"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes","description":"Additional notes"},"dataset_id":{"type":"string","format":"uuid","title":"Dataset Id","description":"Unique identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Unique identifier"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"}},"type":"object","required":["input_prompt","model_output","dataset_id","project_id","created_at"],"title":"RLHFDatasetResponse","description":"Complete RLHF dataset response schema"},"RLHFDeployment":{"properties":{"id":{"type":"string","title":"Id"},"model_name":{"type":"string","title":"Model Name"},"version":{"type":"string","title":"Version"},"deployed_at":{"type":"string","title":"Deployed At"},"status":{"type":"string","title":"Status"},"performance_metrics":{"$ref":"#/components/schemas/RLHFDeploymentPerformanceMetrics"}},"type":"object","required":["id","model_name","version","deployed_at","status","performance_metrics"],"title":"RLHFDeployment"},"RLHFDeploymentPerformanceMetrics":{"properties":{"accuracy":{"type":"number","title":"Accuracy"},"latency_ms":{"type":"integer","title":"Latency Ms"},"throughput":{"type":"integer","title":"Throughput"}},"type":"object","required":["accuracy","latency_ms","throughput"],"title":"RLHFDeploymentPerformanceMetrics"},"RLHFDeploymentsData":{"properties":{"deployments":{"items":{"$ref":"#/components/schemas/RLHFDeployment"},"type":"array","title":"Deployments"}},"type":"object","required":["deployments"],"title":"RLHFDeploymentsData"},"RLHFDeploymentsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"$ref":"#/components/schemas/RLHFDeploymentsData"}},"type":"object","required":["success","message","data"],"title":"RLHFDeploymentsResponse"},"RLHFExportDateRange":{"properties":{"earliest":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Earliest"},"latest":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest"}},"type":"object","title":"RLHFExportDateRange"},"RLHFExportResponse":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project the export belongs to"},"format":{"type":"string","title":"Format","description":"Export format: json, csv, parquet, openai, or anthropic"},"data":{"title":"Data","description":"Exported data: a JSON array for 'json', a string payload for csv/openai/anthropic, or a base64-encoded string for parquet"},"count":{"type":"integer","title":"Count","description":"Number of interactions included in the export"},"exported_at":{"type":"string","title":"Exported At","description":"ISO 8601 timestamp the export was generated"},"filters":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Filters","description":"Filters that were applied to select the exported interactions"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Informational message, e.g. when no interactions matched"},"encoding":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encoding","description":"Data encoding for line-delimited formats, e.g. 'jsonl' (openai/anthropic formats only)"}},"type":"object","required":["project_id","format","count","exported_at"],"title":"RLHFExportResponse","description":"Result of an RLHF data export request"},"RLHFExportStatsResponse":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"feedback_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Feedback Breakdown"},"model_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Model Breakdown"},"date_range":{"anyOf":[{"$ref":"#/components/schemas/RLHFExportDateRange"},{"type":"null"}]},"average_reward":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Reward"}},"type":"object","required":["total_count","feedback_breakdown","model_breakdown"],"title":"RLHFExportStatsResponse"},"RLHFInteractionBatchCreated":{"properties":{"interaction_id":{"type":"string","title":"Interaction Id","description":"Identifier of the created interaction"},"index":{"type":"integer","title":"Index","description":"Index of the item within the submitted batch"},"status":{"type":"string","title":"Status","description":"Per-item status, always 'created' for entries in this list"}},"type":"object","required":["interaction_id","index","status"],"title":"RLHFInteractionBatchCreated","description":"A single successfully-created interaction within a batch creation request"},"RLHFInteractionBatchError":{"properties":{"index":{"type":"integer","title":"Index","description":"Index of the item within the submitted batch"},"error":{"type":"string","title":"Error","description":"Error message explaining why this item failed"},"interaction_data":{"additionalProperties":true,"type":"object","title":"Interaction Data","description":"The original submitted payload for this item"}},"type":"object","required":["index","error","interaction_data"],"title":"RLHFInteractionBatchError","description":"A single failed item within a batch RLHF interaction creation request"},"RLHFInteractionBatchResponse":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project the interactions belong to"},"created_count":{"type":"integer","title":"Created Count","description":"Number of interactions successfully created"},"failed_count":{"type":"integer","title":"Failed Count","description":"Number of interactions that failed to create"},"created_interactions":{"items":{"$ref":"#/components/schemas/RLHFInteractionBatchCreated"},"type":"array","title":"Created Interactions","description":"Successfully created interactions, in submission order"},"errors":{"items":{"$ref":"#/components/schemas/RLHFInteractionBatchError"},"type":"array","title":"Errors","description":"Failed items, in submission order"},"message":{"type":"string","title":"Message","description":"Human-readable summary of the batch result"}},"type":"object","required":["project_id","created_count","failed_count","message"],"title":"RLHFInteractionBatchResponse","description":"Response returned after a batch RLHF interaction creation request"},"RLHFInteractionDeleteResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable confirmation message"},"interaction_id":{"type":"string","title":"Interaction Id","description":"Identifier of the deleted interaction"}},"type":"object","required":["message","interaction_id"],"title":"RLHFInteractionDeleteResponse","description":"Response returned after deleting an RLHF interaction"},"RLHFInteractionListResponse":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project the interactions belong to"},"interactions":{"items":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFInteractionResponse__1"},"type":"array","title":"Interactions","description":"Page of matching interactions"},"total":{"type":"integer","title":"Total","description":"Total count across all pages"},"offset":{"type":"integer","title":"Offset","description":"Pagination offset (requested)"},"limit":{"type":"integer","title":"Limit","description":"Items per page (requested)"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more pages exist after this one"}},"type":"object","required":["project_id","interactions","total","offset","limit","has_more"],"title":"RLHFInteractionListResponse","description":"Paginated list of RLHF interactions for a project.\n\nFollows this codebase's offset-based pagination convention (see\ndocs/api/PAGINATION_POLICY.md and app.schemas.common.PaginatedResponse):\ntotal/offset/limit/has_more plus the page of items. The item field is\nnamed `interactions` (rather than the generic `data`) to preserve the\nexisting response shape for current API consumers."},"RLHFInteractionLogResponse":{"properties":{"interaction_id":{"type":"string","title":"Interaction Id","description":"Unique identifier of the newly logged interaction"},"project_id":{"type":"string","title":"Project Id","description":"Project the interaction belongs to"},"status":{"type":"string","title":"Status","description":"Log status, e.g. 'logged'"},"feedback":{"type":"string","title":"Feedback","description":"Feedback category assigned to the interaction"},"reward":{"type":"number","title":"Reward","description":"Numeric reward signal assigned to the interaction"},"rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating","description":"Raw 1-5 star rating, if one was submitted"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO 8601 timestamp the interaction was created"}},"type":"object","required":["interaction_id","project_id","status","feedback","reward","timestamp"],"title":"RLHFInteractionLogResponse","description":"Response returned immediately after logging a new RLHF interaction"},"RLHFOverviewData":{"properties":{"total_feedback":{"type":"integer","title":"Total Feedback"},"active_models":{"type":"integer","title":"Active Models"},"avg_quality_score":{"type":"number","title":"Avg Quality Score"},"improvement_rate":{"type":"number","title":"Improvement Rate"},"pending_reviews":{"type":"integer","title":"Pending Reviews"},"recent_deployments":{"type":"integer","title":"Recent Deployments"}},"type":"object","required":["total_feedback","active_models","avg_quality_score","improvement_rate","pending_reviews","recent_deployments"],"title":"RLHFOverviewData"},"RLHFOverviewResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"$ref":"#/components/schemas/RLHFOverviewData"}},"type":"object","required":["success","message","data"],"title":"RLHFOverviewResponse","description":"ApiResponse envelope the frontend expects: {success, message, data}."},"RLHFQualityInsightsData":{"properties":{"overall_quality_score":{"type":"number","title":"Overall Quality Score"},"trend":{"type":"string","title":"Trend"},"top_issues":{"items":{"$ref":"#/components/schemas/RLHFTopIssue"},"type":"array","title":"Top Issues"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["overall_quality_score","trend","top_issues","recommendations"],"title":"RLHFQualityInsightsData"},"RLHFQualityInsightsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"$ref":"#/components/schemas/RLHFQualityInsightsData"}},"type":"object","required":["success","message","data"],"title":"RLHFQualityInsightsResponse"},"RLHFRealtimeStatusData":{"properties":{"active_sessions":{"type":"integer","title":"Active Sessions"},"feedback_rate":{"type":"integer","title":"Feedback Rate"},"processing_queue":{"type":"integer","title":"Processing Queue"},"system_health":{"type":"string","title":"System Health"}},"type":"object","required":["active_sessions","feedback_rate","processing_queue","system_health"],"title":"RLHFRealtimeStatusData"},"RLHFRealtimeStatusResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"$ref":"#/components/schemas/RLHFRealtimeStatusData"}},"type":"object","required":["success","message","data"],"title":"RLHFRealtimeStatusResponse"},"RLHFSessionActionResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","description":"Session identifier (alias of session_id)"},"session_id":{"type":"string","title":"Session Id","description":"Unique session identifier"},"project_id":{"type":"string","title":"Project Id","description":"Project the session belongs to"},"status":{"type":"string","title":"Status","description":"Session status after the action"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At","description":"ISO 8601 timestamp the session started"},"stopped_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stopped At","description":"ISO 8601 timestamp the session stopped"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"Session configuration"},"total_interactions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Interactions","description":"Total interactions logged in this session"},"total_feedback_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Feedback Count","description":"Total interactions with non-mixed feedback"},"interaction_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Interaction Count","description":"Alias of total_interactions"},"message":{"type":"string","title":"Message","description":"Human-readable confirmation message"},"exported_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Exported Data","description":"Exported interactions for the session, present only when export_data=true was requested"}},"type":"object","required":["session_id","project_id","status","message"],"title":"RLHFSessionActionResponse","description":"Response returned after starting/stopping an RLHF session"},"RLHFSessionDeleteResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable confirmation message"},"session_id":{"type":"string","title":"Session Id","description":"Identifier of the deleted session"}},"type":"object","required":["message","session_id"],"title":"RLHFSessionDeleteResponse","description":"Response returned after deleting an RLHF session"},"RLHFSessionListResponse":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project the sessions belong to"},"data":{"items":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFSessionResponse__1"},"type":"array","title":"Data","description":"Page of matching sessions"},"sessions":{"items":{"$ref":"#/components/schemas/app__zerodb__schemas__database__RLHFSessionResponse__1"},"type":"array","title":"Sessions","description":"Alias of data, kept for compatibility"},"total":{"type":"integer","title":"Total","description":"Total count across all pages"},"offset":{"type":"integer","title":"Offset","description":"Pagination offset (requested)"},"limit":{"type":"integer","title":"Limit","description":"Items per page (requested)"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more pages exist after this one"}},"type":"object","required":["project_id","data","sessions","total","offset","limit","has_more"],"title":"RLHFSessionListResponse","description":"Paginated list of RLHF sessions for a project.\n\nFollows this codebase's offset-based pagination convention (see\ndocs/api/PAGINATION_POLICY.md and app.schemas.common.PaginatedResponse):\ntotal/offset/limit/has_more plus the page of items, exposed as both\n`data` (the shared convention's field name) and `sessions` (a\npre-existing alias kept for current API consumers)."},"RLHFSingleReviewResponse":{"properties":{"interaction_id":{"type":"string","title":"Interaction Id","description":"Identifier of the created interaction"},"project_id":{"type":"string","title":"Project Id","description":"Project the interaction belongs to"},"rating":{"type":"integer","title":"Rating","description":"Submitted star rating, 1-5"},"feedback":{"type":"string","title":"Feedback","description":"Feedback category derived from the rating"},"reward":{"type":"number","title":"Reward","description":"Reward value derived from the rating"},"created_at":{"type":"string","title":"Created At","description":"ISO 8601 timestamp the interaction was created"},"message":{"type":"string","title":"Message","description":"Human-readable confirmation message"}},"type":"object","required":["interaction_id","project_id","rating","feedback","reward","created_at","message"],"title":"RLHFSingleReviewResponse","description":"Response returned after creating a single-review (star rating) RLHF interaction"},"RLHFStatsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project the statistics belong to"},"total_interactions":{"type":"integer","title":"Total Interactions","description":"Total number of interactions matching the filters"},"average_reward":{"type":"number","title":"Average Reward","description":"Average reward across matching interactions"},"interactions_by_feedback":{"additionalProperties":{"type":"integer"},"type":"object","title":"Interactions By Feedback","description":"Interaction counts grouped by feedback category"},"interactions_by_model":{"additionalProperties":{"type":"integer"},"type":"object","title":"Interactions By Model","description":"Interaction counts grouped by model name"},"total_sessions":{"type":"integer","title":"Total Sessions","description":"Distinct RLHF sessions with at least one interaction"},"active_sessions":{"type":"integer","title":"Active Sessions","description":"Currently active RLHF sessions"},"exported_datasets":{"type":"integer","title":"Exported Datasets","description":"Number of RLHF datasets exported"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO 8601 timestamp the statistics were computed"}},"type":"object","required":["project_id","total_interactions","average_reward","total_sessions","active_sessions","exported_datasets","timestamp"],"title":"RLHFStatsResponse","description":"Aggregate RLHF statistics for a project"},"RLHFTopIssue":{"properties":{"category":{"type":"string","title":"Category"},"count":{"type":"integer","title":"Count"},"severity":{"type":"string","title":"Severity"}},"type":"object","required":["category","count","severity"],"title":"RLHFTopIssue"},"RSVPCreate":{"properties":{"status":{"$ref":"#/components/schemas/RSVPStatusEnum","description":"RSVP status"},"response_message":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Response Message","description":"Optional response message"}},"type":"object","required":["status"],"title":"RSVPCreate","description":"Schema for creating an RSVP","example":{"response_message":"Looking forward to it!","status":"going"}},"RSVPResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"RSVP ID"},"event_id":{"type":"string","format":"uuid","title":"Event Id","description":"Event ID"},"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User ID"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id","description":"Tenant ID"},"status":{"$ref":"#/components/schemas/RSVPStatusEnum","description":"RSVP status"},"response_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Message","description":"Response message"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["id","event_id","user_id","tenant_id","status","created_at"],"title":"RSVPResponse","description":"Schema for RSVP response","example":{"created_at":"2026-01-20T10:00:00Z","event_id":"550e8400-e29b-41d4-a716-446655440000","id":"660e8400-e29b-41d4-a716-446655440000","response_message":"Looking forward to it!","status":"going","tenant_id":"123e4567-e89b-12d3-a456-426614174000","user_id":"789e4567-e89b-12d3-a456-426614174000"}},"RSVPStatus":{"type":"string","enum":["going","interested","not_going"],"title":"RSVPStatus","description":"RSVP status options"},"RSVPStatusEnum":{"type":"string","enum":["going","interested","not_going"],"title":"RSVPStatusEnum","description":"RSVP status options"},"RSVPUpdate":{"properties":{"status":{"$ref":"#/components/schemas/RSVPStatusEnum","description":"Updated RSVP status"},"response_message":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Response Message"}},"type":"object","required":["status"],"title":"RSVPUpdate","description":"Schema for updating an RSVP","example":{"response_message":"Unable to attend, sorry!","status":"not_going"}},"RailwayDashboardResponse":{"properties":{"projects":{"items":{"$ref":"#/components/schemas/RailwayProjectEntry"},"type":"array","title":"Projects"},"active_deployments":{"items":{"$ref":"#/components/schemas/app__api__admin__railway_deployment__DeploymentResponse"},"type":"array","title":"Active Deployments"},"deployment_statistics":{"$ref":"#/components/schemas/app__schemas__admin__railway_deployment__DeploymentStatistics"},"railway_cli_available":{"type":"boolean","title":"Railway Cli Available"},"supported_environments":{"items":{"type":"string"},"type":"array","title":"Supported Environments"},"supported_services":{"items":{"type":"string"},"type":"array","title":"Supported Services"},"deployment_strategies":{"items":{"type":"string"},"type":"array","title":"Deployment Strategies"}},"type":"object","required":["projects","active_deployments","deployment_statistics","railway_cli_available","supported_environments","supported_services","deployment_strategies"],"title":"RailwayDashboardResponse","description":"Response for GET /railway-deployment/dashboard."},"RailwayDeploymentRequest":{"properties":{"project_name":{"type":"string","maxLength":100,"minLength":1,"title":"Project Name"},"project_path":{"type":"string","minLength":1,"title":"Project Path"},"environment":{"$ref":"#/components/schemas/DeploymentEnvironment","default":"development"},"service_type":{"$ref":"#/components/schemas/RailwayService","default":"web"},"deployment_strategy":{"$ref":"#/components/schemas/DeploymentStrategy","default":"immediate"},"auto_domain":{"type":"boolean","title":"Auto Domain","default":true},"custom_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Domain"},"environment_variables":{"additionalProperties":{"type":"string"},"type":"object","title":"Environment Variables"},"build_command":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Build Command"},"start_command":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Command"},"dockerfile_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dockerfile Path"},"port":{"type":"integer","title":"Port","default":3000},"health_check_path":{"type":"string","title":"Health Check Path","default":"/health"},"auto_scale":{"type":"boolean","title":"Auto Scale","default":true},"min_instances":{"type":"integer","title":"Min Instances","default":1},"max_instances":{"type":"integer","title":"Max Instances","default":10}},"type":"object","required":["project_name","project_path"],"title":"RailwayDeploymentRequest","description":"Request model for Railway deployment"},"RailwayProjectEntry":{"properties":{"name":{"type":"string","title":"Name"},"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["name","id","status"],"title":"RailwayProjectEntry"},"RailwayService":{"type":"string","enum":["web","database","redis","worker","cron"],"title":"RailwayService","description":"Railway service types"},"RangeListResponse":{"properties":{"ranges":{"items":{"$ref":"#/components/schemas/RangeOption"},"type":"array","title":"Ranges"}},"type":"object","required":["ranges"],"title":"RangeListResponse"},"RangeOption":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"}},"type":"object","required":["key","label"],"title":"RangeOption"},"RateLimitConfig":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"requests_per_minute":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Requests Per Minute"},"requests_per_hour":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Requests Per Hour"},"requests_per_day":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Requests Per Day"},"burst_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Burst Limit"},"kong_configured":{"type":"boolean","title":"Kong Configured","default":false}},"type":"object","title":"RateLimitConfig","description":"Rate limiting configuration"},"RateLimitResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"anyOf":[{"$ref":"#/components/schemas/RateLimitConfig"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"blocker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocker"}},"type":"object","title":"RateLimitResponse","description":"Response for rate limit settings"},"RateLimitStatus":{"properties":{"allowed":{"type":"boolean","title":"Allowed"},"current":{"type":"integer","title":"Current"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"},"reset_at":{"type":"string","title":"Reset At"}},"type":"object","required":["allowed","current","reset_at"],"title":"RateLimitStatus","description":"Single-period rate limit status"},"RateLimitStatusResponse":{"properties":{"hourly":{"additionalProperties":{"type":"integer"},"type":"object","title":"Hourly"},"daily":{"additionalProperties":{"type":"integer"},"type":"object","title":"Daily"}},"type":"object","required":["hourly","daily"],"title":"RateLimitStatusResponse","description":"Response model for rate limit status"},"RateLimiting":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"requests_per_second":{"type":"integer","title":"Requests Per Second"},"burst":{"type":"integer","title":"Burst"}},"type":"object","required":["enabled","requests_per_second","burst"],"title":"RateLimiting"},"RateLimits":{"properties":{"requests_per_minute":{"type":"integer","title":"Requests Per Minute"},"tokens_per_minute":{"type":"integer","title":"Tokens Per Minute"}},"type":"object","required":["requests_per_minute","tokens_per_minute"],"title":"RateLimits"},"RateLimitsResponse":{"properties":{"daily":{"$ref":"#/components/schemas/RateLimitStatus"},"monthly":{"$ref":"#/components/schemas/RateLimitStatus"},"plan":{"type":"string","title":"Plan"}},"type":"object","required":["daily","monthly","plan"],"title":"RateLimitsResponse","description":"Combined daily + monthly rate limit status"},"RatePromptRequest":{"properties":{"rating":{"anyOf":[{"type":"number","maximum":5,"minimum":0},{"type":"string"}],"title":"Rating","description":"Rating from 0 to 5"}},"type":"object","required":["rating"],"title":"RatePromptRequest","description":"Request to rate a prompt"},"RatePromptResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"new_average":{"type":"string","title":"New Average"},"total_ratings":{"type":"integer","title":"Total Ratings"}},"type":"object","required":["success","new_average","total_ratings"],"title":"RatePromptResponse","description":"Response after rating a prompt"},"ReadReceiptResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"user_email":{"type":"string","title":"User Email"},"read_at":{"type":"string","title":"Read At"},"last_read_message_id":{"type":"string","title":"Last Read Message Id"}},"type":"object","required":["user_id","user_email","read_at","last_read_message_id"],"title":"ReadReceiptResponse","description":"Read receipt information"},"RealTimeMetricsResponse":{"properties":{"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"time_window_minutes":{"type":"integer","title":"Time Window Minutes"},"metrics":{"additionalProperties":true,"type":"object","title":"Metrics"},"total_active_metrics":{"type":"integer","title":"Total Active Metrics"}},"type":"object","required":["timestamp","time_window_minutes","metrics","total_active_metrics"],"title":"RealTimeMetricsResponse"},"RealtimeActiveExperiment":{"properties":{"experiment_id":{"type":"string","title":"Experiment Id"},"name":{"type":"string","title":"Name"},"progress":{"type":"number","title":"Progress"},"status":{"type":"string","title":"Status"}},"type":"object","required":["experiment_id","name","progress","status"],"title":"RealtimeActiveExperiment"},"RealtimeEvent":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"event_type":{"type":"string","title":"Event Type"},"message":{"type":"string","title":"Message"}},"type":"object","required":["timestamp","event_type","message"],"title":"RealtimeEvent"},"RealtimeMonitoringStatusResponse":{"properties":{"monitoring_active":{"type":"boolean","title":"Monitoring Active"},"system_health":{"$ref":"#/components/schemas/RealtimeSystemHealth"},"active_experiments":{"items":{"$ref":"#/components/schemas/RealtimeActiveExperiment"},"type":"array","title":"Active Experiments"},"recent_events":{"items":{"$ref":"#/components/schemas/RealtimeEvent"},"type":"array","title":"Recent Events"},"websocket_endpoint":{"type":"string","title":"Websocket Endpoint"},"last_update":{"type":"string","title":"Last Update"}},"type":"object","required":["monitoring_active","system_health","active_experiments","recent_events","websocket_endpoint","last_update"],"title":"RealtimeMonitoringStatusResponse","description":"Response for GET /dashboard/realtime/status."},"RealtimeSystemHealth":{"properties":{"overall_status":{"type":"string","title":"Overall Status"},"cpu_usage":{"type":"number","title":"Cpu Usage"},"memory_usage":{"type":"number","title":"Memory Usage"},"disk_usage":{"type":"number","title":"Disk Usage"},"active_connections":{"type":"integer","title":"Active Connections"}},"type":"object","required":["overall_status","cpu_usage","memory_usage","disk_usage","active_connections"],"title":"RealtimeSystemHealth"},"RealtimeViewersResponse":{"properties":{"video_id":{"type":"string","format":"uuid","title":"Video Id"},"current_viewers":{"type":"integer","title":"Current Viewers"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["video_id","current_viewers","timestamp"],"title":"RealtimeViewersResponse","description":"Realtime viewers response"},"RecallNextSteps":{"properties":{"suggestion":{"type":"string","title":"Suggestion"},"action":{"type":"string","title":"Action"},"endpoint":{"type":"string","title":"Endpoint"},"docs":{"type":"string","title":"Docs"}},"type":"object","required":["suggestion","action","endpoint","docs"],"title":"RecallNextSteps"},"RecallRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Natural language search query"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id","description":"Filter by entity"},"layer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Layer","description":"Filter by layer: working, episodic, semantic"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Max results","default":10},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"As Of","description":"Return only memories whose graph edges were valid at this timestamp. Enables historical recall: 'where did John work as of 2024-01-01?'. Refs #2111"},"query_expansion":{"type":"boolean","title":"Query Expansion","description":"Expand query into semantic variants via LLM before search, merge results. Refs #2670","default":false},"rerank":{"type":"boolean","title":"Rerank","description":"Rerank results with an LLM relevance judge after retrieval. Refs #2671","default":false},"namespace":{"type":"string","title":"Namespace","description":"Namespace to search within. Defaults to 'global'. Refs #2884","default":"global"},"allow_cross_namespace":{"type":"boolean","title":"Allow Cross Namespace","description":"If True, search across all namespaces (ignores namespace filter). Refs #2884","default":false},"expand_context":{"type":"integer","maximum":10,"minimum":0,"title":"Expand Context","description":"Fetch N temporally adjacent memories per result to preserve conversational context. Refs #3427","default":0},"use_graph":{"type":"boolean","title":"Use Graph","description":"Augment vector search with graph traversal (hybrid graphrag_search). Refs #3426","default":false}},"type":"object","required":["query"],"title":"RecallRequest"},"RecallResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/RecallResultItem"},"type":"array","title":"Results"},"count":{"type":"integer","title":"Count"},"query_expansion":{"type":"boolean","title":"Query Expansion"},"reranked":{"type":"boolean","title":"Reranked"},"expand_context":{"type":"integer","title":"Expand Context"},"use_graph":{"type":"boolean","title":"Use Graph"},"next_steps":{"anyOf":[{"$ref":"#/components/schemas/RecallNextSteps"},{"type":"null"}],"description":"Present only when `results` is empty."}},"type":"object","required":["results","count","query_expansion","reranked","expand_context","use_graph"],"title":"RecallResponse"},"RecallResultItem":{"properties":{"id":{"type":"string","title":"Id"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"memory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Type"},"importance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Importance"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"score":{"type":"number","title":"Score"},"similarity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Similarity"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"namespace":{"type":"string","title":"Namespace"}},"type":"object","required":["id","content","memory_type","importance","confidence","entity_id","tags","metadata","source","source_url","score","similarity","created_at","namespace"],"title":"RecallResultItem"},"RecallTracesRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Natural language description of the task to find similar traces for"},"success_only":{"type":"boolean","title":"Success Only","description":"Return only successful traces","default":true},"limit":{"type":"integer","maximum":50,"minimum":1,"title":"Limit","description":"Max results","default":10}},"type":"object","required":["query"],"title":"RecallTracesRequest"},"RecallTracesResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/SimilarTrace"},"type":"array","title":"Results"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["results","count"],"title":"RecallTracesResponse"},"RecentActivity":{"properties":{"activities":{"items":{"$ref":"#/components/schemas/app__schemas__dashboard_stats_public__ActivityItem"},"type":"array","title":"Activities"},"count":{"type":"integer","title":"Count"},"time_window_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Time Window Hours"},"generated_at":{"type":"string","title":"Generated At"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present if activity tracking failed or is unavailable"}},"type":"object","required":["activities","count","generated_at"],"title":"RecentActivity"},"RecentActivityFilters":{"properties":{"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"log_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Log Level"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["limit"],"title":"RecentActivityFilters"},"RecentActivityResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/RecentActivity"},"user_email":{"type":"string","title":"User Email"},"is_admin":{"type":"boolean","title":"Is Admin"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["success","data","user_email","is_admin"],"title":"RecentActivityResponse","description":"Response for GET /database/events/activity."},"RecentBackupEntry":{"properties":{"filename":{"type":"string","title":"Filename"},"size_mb":{"type":"number","title":"Size Mb"},"created":{"type":"string","title":"Created"},"type":{"type":"string","title":"Type"}},"type":"object","required":["filename","size_mb","created","type"],"title":"RecentBackupEntry"},"RecentDeploymentDetail":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"agent_type":{"type":"string","title":"Agent Type"},"version":{"type":"string","title":"Version"},"status":{"type":"string","title":"Status"},"deployed_at":{"type":"string","title":"Deployed At"},"duration_minutes":{"type":"integer","title":"Duration Minutes"}},"type":"object","required":["deployment_id","agent_type","version","status","deployed_at","duration_minutes"],"title":"RecentDeploymentDetail"},"RecentEnrichedSignupsResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"count":{"type":"integer","title":"Count"},"signups":{"items":{"$ref":"#/components/schemas/EnrichedSignup"},"type":"array","title":"Signups"}},"type":"object","required":["count","signups"],"title":"RecentEnrichedSignupsResponse"},"RecentExecutionsResponse":{"properties":{"executions":{"items":{"$ref":"#/components/schemas/ToolExecutionEntry"},"type":"array","title":"Executions"},"count":{"type":"integer","title":"Count"},"limit":{"type":"integer","title":"Limit"},"period":{"anyOf":[{"$ref":"#/components/schemas/AnalyticsPeriod"},{"type":"null"}]},"filters":{"anyOf":[{"$ref":"#/components/schemas/AnalyticsFilters"},{"type":"null"}]}},"type":"object","required":["executions","count","limit"],"title":"RecentExecutionsResponse","description":"Response body for /recent."},"RecentIncident":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"severity":{"type":"string","title":"Severity"},"status":{"type":"string","title":"Status"},"started_at":{"type":"string","title":"Started At"},"resolved_at":{"type":"string","title":"Resolved At"},"duration_minutes":{"type":"integer","title":"Duration Minutes"},"affected_services":{"items":{"type":"string"},"type":"array","title":"Affected Services"},"root_cause":{"type":"string","title":"Root Cause"},"resolution":{"type":"string","title":"Resolution"}},"type":"object","required":["id","title","description","severity","status","started_at","resolved_at","duration_minutes","affected_services","root_cause","resolution"],"title":"RecentIncident"},"RecentMemory":{"properties":{"id":{"type":"string","title":"Id"},"content":{"type":"string","title":"Content"},"source":{"type":"string","title":"Source"},"memory_type":{"type":"string","title":"Memory Type"},"namespace":{"type":"string","title":"Namespace"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","content","source","memory_type","namespace","created_at"],"title":"RecentMemory","description":"A single memory record surfaced on the intelligence dashboard. Refs #5179"},"RecentScalingEvent":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"action":{"type":"string","title":"Action"},"trigger":{"type":"string","title":"Trigger"},"instances_added":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Instances Added"},"instances_removed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Instances Removed"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["timestamp","action","trigger","reason"],"title":"RecentScalingEvent"},"RecentStreamSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"ended_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ended At"},"viewer_count":{"type":"integer","title":"Viewer Count","default":0},"peak_viewers":{"type":"integer","title":"Peak Viewers","default":0}},"type":"object","required":["id","title","status"],"title":"RecentStreamSummary","description":"Summary of a recent stream for dashboard","example":{"ended_at":"2025-12-23T16:30:00Z","id":"987e6543-e21b-12d3-a456-426614174000","peak_viewers":87,"started_at":"2025-12-23T14:00:00Z","status":"ended","title":"Building with FastAPI","viewer_count":0}},"RecommendModelRequest":{"properties":{"prd_content":{"type":"string","minLength":1,"title":"Prd Content","description":"The full PRD text"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"}},"type":"object","required":["prd_content"],"title":"RecommendModelRequest"},"RecommendationCTRResponse":{"properties":{"video_id":{"type":"string","format":"uuid","title":"Video Id"},"total_recommendations":{"type":"integer","title":"Total Recommendations"},"total_clicks":{"type":"integer","title":"Total Clicks"},"click_through_rate":{"type":"number","maximum":1,"minimum":0,"title":"Click Through Rate"},"ctr_by_position":{"additionalProperties":true,"type":"object","title":"Ctr By Position"}},"type":"object","required":["video_id","total_recommendations","total_clicks","click_through_rate"],"title":"RecommendationCTRResponse","description":"Click-through rate analytics response"},"RecommendationClickRequest":{"properties":{"recommended_video_id":{"type":"string","format":"uuid","title":"Recommended Video Id"},"rank":{"type":"integer","minimum":1,"title":"Rank","description":"Position in recommendation list"}},"type":"object","required":["recommended_video_id","rank"],"title":"RecommendationClickRequest","description":"Request to track recommendation click"},"RecommendationClickResponse":{"properties":{"clicked":{"type":"boolean","title":"Clicked"},"source_video_id":{"type":"string","format":"uuid","title":"Source Video Id"},"recommended_video_id":{"type":"string","format":"uuid","title":"Recommended Video Id"},"rank":{"type":"integer","title":"Rank"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["clicked","source_video_id","recommended_video_id","rank","timestamp"],"title":"RecommendationClickResponse","description":"Response after tracking recommendation click"},"RecommendationConfidenceInfo":{"properties":{"confidence":{"type":"string","title":"Confidence"},"name":{"type":"string","title":"Name"},"range":{"type":"string","title":"Range"}},"type":"object","required":["confidence","name","range"],"title":"RecommendationConfidenceInfo"},"RecommendationFeedbackRequest":{"properties":{"recommendation_type":{"type":"string","title":"Recommendation Type","description":"Type: 'post', 'user', or 'group'"},"recommendation_id":{"type":"string","format":"uuid","title":"Recommendation Id","description":"ID of recommended item"},"feedback":{"type":"string","title":"Feedback","description":"Feedback: 'clicked', 'dismissed', 'reported'"}},"type":"object","required":["recommendation_type","recommendation_id","feedback"],"title":"RecommendationFeedbackRequest","description":"Request to provide feedback on a recommendation"},"RecommendationFeedbackResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"recommendation_type":{"type":"string","title":"Recommendation Type"},"recommendation_id":{"type":"string","format":"uuid","title":"Recommendation Id"},"feedback":{"type":"string","title":"Feedback"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["success","recommendation_type","recommendation_id","feedback","timestamp"],"title":"RecommendationFeedbackResponse","description":"Response after recording recommendation feedback"},"RecommendationItem":{"properties":{"priority":{"type":"string","title":"Priority","description":"Priority level (high/medium/low)"},"area":{"type":"string","title":"Area","description":"Area of improvement"},"suggestion":{"type":"string","title":"Suggestion","description":"Specific suggestion"},"impact":{"type":"string","title":"Impact","description":"Expected impact"}},"type":"object","required":["priority","area","suggestion","impact"],"title":"RecommendationItem","description":"Individual recommendation for improvement"},"RecommendationPriorityInfo":{"properties":{"priority":{"type":"string","title":"Priority"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["priority","name","description"],"title":"RecommendationPriorityInfo"},"RecommendationResponse":{"properties":{"recommendation_id":{"type":"string","title":"Recommendation Id"},"prompt_id":{"type":"string","title":"Prompt Id"},"recommendation_type":{"type":"string","title":"Recommendation Type"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"detailed_explanation":{"type":"string","title":"Detailed Explanation"},"implementation_steps":{"items":{"type":"string"},"type":"array","title":"Implementation Steps"},"priority":{"type":"string","title":"Priority"},"confidence":{"type":"string","title":"Confidence"},"confidence_score":{"type":"number","title":"Confidence Score"},"expected_impact":{"additionalProperties":{"type":"number"},"type":"object","title":"Expected Impact"},"estimated_effort":{"type":"string","title":"Estimated Effort"},"implementation_time":{"type":"string","title":"Implementation Time"},"data_sources":{"items":{"type":"string"},"type":"array","title":"Data Sources"},"supporting_metrics":{"additionalProperties":true,"type":"object","title":"Supporting Metrics"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["recommendation_id","prompt_id","recommendation_type","title","description","detailed_explanation","implementation_steps","priority","confidence","confidence_score","expected_impact","estimated_effort","implementation_time","data_sources","supporting_metrics","created_at"],"title":"RecommendationResponse"},"RecommendationSummaryResponse":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"total_recommendations":{"type":"integer","title":"Total Recommendations"},"high_priority_count":{"type":"integer","title":"High Priority Count"},"medium_priority_count":{"type":"integer","title":"Medium Priority Count"},"low_priority_count":{"type":"integer","title":"Low Priority Count"},"recommendations_by_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"Recommendations By Type"},"avg_confidence_score":{"type":"number","title":"Avg Confidence Score"},"analysis_timestamp":{"type":"string","title":"Analysis Timestamp"},"data_window_days":{"type":"integer","title":"Data Window Days"}},"type":"object","required":["prompt_id","total_recommendations","high_priority_count","medium_priority_count","low_priority_count","recommendations_by_type","avg_confidence_score","analysis_timestamp","data_window_days"],"title":"RecommendationSummaryResponse"},"RecommendationTypeInfo":{"properties":{"type":{"type":"string","title":"Type"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["type","name","description"],"title":"RecommendationTypeInfo"},"RecommendationTypesResponse":{"properties":{"recommendation_types":{"items":{"$ref":"#/components/schemas/RecommendationTypeInfo"},"type":"array","title":"Recommendation Types"},"priority_levels":{"items":{"$ref":"#/components/schemas/RecommendationPriorityInfo"},"type":"array","title":"Priority Levels"},"confidence_levels":{"items":{"$ref":"#/components/schemas/RecommendationConfidenceInfo"},"type":"array","title":"Confidence Levels"},"impact_categories":{"items":{"$ref":"#/components/schemas/ImpactCategoryInfo"},"type":"array","title":"Impact Categories"}},"type":"object","required":["recommendation_types","priority_levels","confidence_levels","impact_categories"],"title":"RecommendationTypesResponse","description":"Real shape returned by GET /recommendations/types -- matches\nget_recommendation_types()'s literal return dict exactly."},"RecommendedGroupsResponse":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/app__schemas__recommendations__RecommendedGroup"},"type":"array","title":"Recommendations"},"total":{"type":"integer","title":"Total"},"execution_time_ms":{"type":"number","title":"Execution Time Ms"},"strategy":{"type":"string","title":"Strategy","default":"hybrid"}},"type":"object","required":["recommendations","total","execution_time_ms"],"title":"RecommendedGroupsResponse","description":"Response for recommended groups endpoint"},"RecommendedPostsResponse":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/app__schemas__recommendations__RecommendedPost"},"type":"array","title":"Recommendations"},"total":{"type":"integer","title":"Total"},"execution_time_ms":{"type":"number","title":"Execution Time Ms"},"strategy":{"type":"string","title":"Strategy","default":"hybrid"}},"type":"object","required":["recommendations","total","execution_time_ms"],"title":"RecommendedPostsResponse","description":"Response for recommended posts endpoint"},"RecommendedStream":{"properties":{"stream":{"$ref":"#/components/schemas/StreamResponse"},"relevance_score":{"type":"number","minimum":0,"title":"Relevance Score","description":"Relevance score for this user"},"reason":{"type":"string","title":"Reason","description":"Why this stream is recommended"}},"type":"object","required":["stream","relevance_score","reason"],"title":"RecommendedStream","description":"Personalized stream recommendation","example":{"reason":"From a streamer you follow in your favorite category","relevance_score":95.2,"stream":{"id":"987e6543-e21b-12d3-a456-426614174000","status":"live","title":"Advanced FastAPI Patterns","viewer_count":234}}},"RecommendedStreamsResponse":{"properties":{"streams":{"items":{"$ref":"#/components/schemas/RecommendedStream"},"type":"array","title":"Streams"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Number of recommendations returned"}},"type":"object","required":["streams","total"],"title":"RecommendedStreamsResponse","description":"List of personalized recommendations","example":{"streams":[{"reason":"From a streamer you follow","relevance_score":95.2,"stream":{"id":"987e6543-e21b-12d3-a456-426614174000","title":"Advanced FastAPI","viewer_count":234}}],"total":10}},"RecommendedUsersResponse":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/app__schemas__recommendations__RecommendedUser"},"type":"array","title":"Recommendations"},"total":{"type":"integer","title":"Total"},"execution_time_ms":{"type":"number","title":"Execution Time Ms"},"strategy":{"type":"string","title":"Strategy","default":"hybrid"}},"type":"object","required":["recommendations","total","execution_time_ms"],"title":"RecommendedUsersResponse","description":"Response for recommended users endpoint"},"ReconciliationData":{"properties":{"date_range":{"$ref":"#/components/schemas/ConversionsDateRange"},"database_events":{"additionalProperties":{"type":"integer"},"type":"object","title":"Database Events"},"ga4_events":{"additionalProperties":true,"type":"object","title":"Ga4 Events","default":{}},"ga4_available":{"type":"boolean","title":"Ga4 Available"},"ga4_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Error"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Summary"},"discrepancies":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Discrepancies","default":[]}},"type":"object","required":["date_range","database_events","ga4_available"],"title":"ReconciliationData","description":"GA4-vs-database reconciliation payload.\n\nWhen GA4 is unavailable (``ga4_available=False``) only ``ga4_error``/\n``note`` are populated and ``summary``/``discrepancies`` are omitted;\nwhen GA4 succeeds, ``summary``/``discrepancies``/``ga4_events`` are\npopulated and ``ga4_error``/``note`` are omitted — both branches are\nreal, independently-returned shapes from the handler."},"ReconciliationGenerateResponse":{"properties":{"report_date":{"type":"string","title":"Report Date"},"generated_at":{"type":"string","title":"Generated At"},"outbound":{"$ref":"#/components/schemas/ReconciliationLegResponse"},"inbound":{"$ref":"#/components/schemas/ReconciliationLegResponse"},"has_alerts":{"type":"boolean","title":"Has Alerts"},"status":{"type":"string","title":"Status"},"report_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Id"}},"type":"object","required":["report_date","generated_at","outbound","inbound","has_alerts","status"],"title":"ReconciliationGenerateResponse","description":"Result of generating a daily reconciliation report (admin-only route).\n\nMirrors X402ReconciliationService.generate_report(). `report_id` is only\nset when `persist=True`; the handler always persists, but it stays\nOptional + `response_model_exclude_unset=True` on the route so a\nnon-persisting call would not start emitting `report_id: null`.\n\nThis payload aggregates ledgers PLATFORM-WIDE (no per-user filter), which\nis why the handler gates it behind `is_superuser`. No `extra=\"allow\"`:\nwidening a cross-tenant financial aggregate by default is the wrong\ndefault."},"ReconciliationLegResponse":{"properties":{"type":{"type":"string","title":"Type"},"report_date":{"type":"string","title":"Report Date"},"discrepancy":{"type":"integer","title":"Discrepancy"},"discrepancy_pct":{"type":"number","title":"Discrepancy Pct"},"alert":{"type":"boolean","title":"Alert"},"outbound_credits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Outbound Credits"},"outbound_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Outbound Count"},"credit_ledger_debits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credit Ledger Debits"},"credit_ledger_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credit Ledger Count"},"inbound_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Inbound Amount"},"inbound_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Inbound Count"},"earnings_ledger_base":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Earnings Ledger Base"},"earnings_ledger_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Earnings Ledger Count"}},"type":"object","required":["type","report_date","discrepancy","discrepancy_pct","alert"],"title":"ReconciliationLegResponse","description":"One side (outbound or inbound) of a reconciliation run.\n\nMirrors X402ReconciliationService.reconcile_outbound() /\nreconcile_inbound(). The two legs have disjoint figure names, so both\nsets are declared Optional on one model and the route uses\n`response_model_exclude_unset=True` — that keeps `outbound` carrying only\nits own keys and `inbound` only its own, exactly as today, instead of\npadding each leg with the other's fields as nulls."},"ReconciliationReportDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"report_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Date"},"report_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"report_data":{"additionalProperties":true,"type":"object","title":"Report Data"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id"],"title":"ReconciliationReportDetailResponse","description":"A stored reconciliation report with its full persisted payload\n(admin-only route).\n\nMirrors X402ReconciliationService.get_report(). `report_data` is the\nwhole generate_report() dict rehydrated from JSONB — typed as\n`Dict[str, Any]` so historical reports written by an older version of the\ngenerator keep round-tripping verbatim rather than being reshaped (and\nsilently truncated) by today's model."},"ReconciliationReportSummary":{"properties":{"id":{"type":"string","title":"Id"},"report_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Date"},"report_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"outbound_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Outbound Total"},"inbound_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Inbound Total"},"discrepancy_outbound":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Discrepancy Outbound"},"discrepancy_inbound":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Discrepancy Inbound"},"has_alerts":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Alerts"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id"],"title":"ReconciliationReportSummary","description":"One row of the reconciliation report list (admin-only route).\n\nMirrors X402ReconciliationService.list_reports(). Platform-wide totals,\nadmin-gated; explicit field list, no `extra=\"allow\"`."},"ReconciliationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ReconciliationData"}},"type":"object","required":["success","data"],"title":"ReconciliationResponse","description":"Response for GET /reconcile"},"RecordAttributionRequest":{"properties":{"new_organization_id":{"type":"string","minLength":1,"title":"New Organization Id"},"ref":{"type":"string","minLength":1,"title":"Ref","description":"Referring org's slug"}},"type":"object","required":["new_organization_id","ref"],"title":"RecordAttributionRequest","description":"Body for attributing a new org's signup to a referral link."},"RecordCostRequest":{"properties":{"task_id":{"type":"string","title":"Task Id","description":"UUID of the task incurring the cost"},"resource_type":{"type":"string","maxLength":64,"title":"Resource Type","description":"Resource category: llm_tokens, tool_call, compute_seconds, …"},"amount_credits":{"type":"number","minimum":0,"title":"Amount Credits","description":"Non-negative credit cost for this node"},"parent_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Task Id","description":"UUID of the parent task that spawned this one; null for root tasks"},"agent_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Agent Id","description":"Identifier of the agent that incurred the cost"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Arbitrary JSON metadata (model name, token counts, etc.)"}},"type":"object","required":["task_id","resource_type","amount_credits"],"title":"RecordCostRequest","description":"Body for POST /task-costs/record"},"RecordCostResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"task_id":{"type":"string","title":"Task Id"},"parent_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Task Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"resource_type":{"type":"string","title":"Resource Type"},"amount_credits":{"type":"number","title":"Amount Credits"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["task_id","resource_type","amount_credits"],"title":"RecordCostResponse","description":"Response for POST /task-costs/record"},"RecordDeploymentResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["deployment_id","status","message","timestamp"],"title":"RecordDeploymentResponse","description":"POST /deployment/deployments — deployment recorded, monitoring started."},"RecordInteractionResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"interaction_type":{"type":"string","title":"Interaction Type"},"success":{"type":"boolean","title":"Success"},"created_at":{"type":"string","title":"Created At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","agent_id","interaction_type","success","created_at","message"],"title":"RecordInteractionResponse"},"RecordMetricRequest":{"properties":{"metric_name":{"type":"string","title":"Metric Name","description":"Name of the metric"},"metric_type":{"type":"string","title":"Metric Type","description":"Type of metric (performance, quality, cost, usage, error)"},"value":{"type":"number","title":"Value","description":"Metric value"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"},"prompt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Id","description":"Associated prompt ID"},"version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version Id","description":"Associated version ID"},"test_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Test Id","description":"Associated test ID"}},"type":"object","required":["metric_name","metric_type","value"],"title":"RecordMetricRequest"},"RecordMetricResponse":{"properties":{"metric_id":{"type":"string","title":"Metric Id"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["metric_id","message","timestamp"],"title":"RecordMetricResponse","description":"Response for POST /metrics (201 Created)."},"RecordQualityRequest":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id","description":"Prompt identifier"},"quality_score":{"type":"number","maximum":1,"minimum":0,"title":"Quality Score","description":"Quality score (0.0-1.0)"},"evaluation_id":{"type":"string","title":"Evaluation Id","description":"Evaluation identifier"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"},"version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version Id","description":"Version identifier"},"test_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Test Id","description":"Test identifier"}},"type":"object","required":["prompt_id","quality_score","evaluation_id"],"title":"RecordQualityRequest"},"RecordQualityScoreResponse":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"quality_score":{"type":"number","title":"Quality Score"},"evaluation_id":{"type":"string","title":"Evaluation Id"},"status":{"type":"string","title":"Status"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message"}},"type":"object","required":["prompt_id","quality_score","evaluation_id","status","timestamp","message"],"title":"RecordQualityScoreResponse","description":"Response for POST /record."},"RecordedRunPayload":{"properties":{"intent":{"type":"string","title":"Intent","description":"The simulated user intent the probe ran, e.g. \"find_pricing\" — always present on a stored run."},"model":{"type":"string","title":"Model","description":"The exact model that made the selection, persisted verbatim by the call that made it (core#9418 AC-2) — never re-read from the env at read time, which could have changed since the scan ran."},"verdict":{"type":"string","title":"Verdict","description":"The probe's outcome: \"pass\", a mismatch, a warning, or not-applicable. Always present on a stored run."},"chosen_tool":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chosen Tool","description":"The tool the model actually selected. Null when the model's answer named no usable tool."},"chosen_arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Chosen Arguments","description":"The arguments the model passed, decoded. Null when it supplied none."},"expected_tools":{"items":{"type":"string"},"type":"array","title":"Expected Tools","description":"The tools the site registered that would have satisfied this intent."},"finding":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finding","description":"The human-readable finding naming the model and its pick."},"step_count":{"type":"integer","title":"Step Count","description":"Steps the simulated agent took."},"tool_call_count":{"type":"integer","title":"Tool Call Count","description":"Tool calls it made."},"duration_ms":{"type":"integer","title":"Duration Ms","description":"Wall-clock duration of the run."},"screenshot_file_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Screenshot File Key","description":"Storage key of the run screenshot."},"screenshot_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Screenshot Url","description":"Presigned URL for the run screenshot."},"screenshot_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Screenshot Size Bytes","description":"Size of the run screenshot."},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"When the run was recorded."}},"type":"object","required":["intent","model","verdict","step_count","tool_call_count","duration_ms"],"title":"RecordedRunPayload","description":"One stored WebMCP simulated-agent run (core#9418's row, read back).\n\nEvery field here was measured. The optional ones are optional because\nthe *measurement* can legitimately be absent (no tool was chosen, no\nscreenshot could be captured) — never because the run is a guess."},"RecordedRunResponse":{"properties":{"report_id":{"type":"string","title":"Report Id"},"recorded_run":{"anyOf":[{"$ref":"#/components/schemas/RecordedRunPayload"},{"type":"null"}],"description":"The stored run, or null when no run exists for this report. Null means the probe never ran — the site registered zero WebMCP tools, so no model call was attempted, or the model call did not complete (core#9418 AC-1/AC-3). It never means \"a run happened and measured nothing\"."},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Present only when `recorded_run` is null: a plain explanation of why there is no run, so the UI can say so explicitly instead of rendering an empty panel."}},"type":"object","required":["report_id"],"title":"RecordedRunResponse","description":"The Recorded Run panel's payload for one report (core#9443).\n\n`recorded_run` is null for the majority of scanned sites and that is a\nnormal, correct answer — not a failure and not an empty measurement.\n`reason` says which so the panel never has to infer \"didn't happen\"\nfrom a blank row of zeros."},"RecoveryCapabilities":{"properties":{"point_in_time_recovery":{"$ref":"#/components/schemas/PointInTimeRecoveryCapability"},"full_system_restore":{"$ref":"#/components/schemas/FullSystemRestoreCapability"},"selective_restore":{"$ref":"#/components/schemas/SelectiveRestoreCapability"},"disaster_recovery":{"$ref":"#/components/schemas/DisasterRecoveryCapability"}},"type":"object","required":["point_in_time_recovery","full_system_restore","selective_restore","disaster_recovery"],"title":"RecoveryCapabilities"},"RecoveryType":{"type":"string","enum":["point_in_time","full_restore","selective_restore","disaster_recovery"],"title":"RecoveryType","description":"Recovery operation types"},"RecursiveLoopMetrics":{"properties":{"rlhf_signals_total":{"type":"integer","title":"Rlhf Signals Total","default":0},"rlhf_signals_today":{"type":"integer","title":"Rlhf Signals Today","default":0},"loop_actions_total":{"type":"integer","title":"Loop Actions Total","default":0},"loop_actions_today":{"type":"integer","title":"Loop Actions Today","default":0},"improvement_verifications_total":{"type":"integer","title":"Improvement Verifications Total","default":0},"improvement_verifications_today":{"type":"integer","title":"Improvement Verifications Today","default":0},"consolidation_jobs_total":{"type":"integer","title":"Consolidation Jobs Total","default":0},"consolidation_jobs_today":{"type":"integer","title":"Consolidation Jobs Today","default":0},"rlhf_datasets_total":{"type":"integer","title":"Rlhf Datasets Total","default":0},"rlhf_datasets_today":{"type":"integer","title":"Rlhf Datasets Today","default":0},"lakehouse_signals_total":{"type":"integer","title":"Lakehouse Signals Total","default":0},"lakehouse_signals_today":{"type":"integer","title":"Lakehouse Signals Today","default":0}},"type":"object","title":"RecursiveLoopMetrics","description":"Recursive self-improvement loop signals — total + today windows. Refs #6558.\n\nSurfaces the loop tables that are tracked in prod but were never shown on the\nIntelligence page's \"Recursive Self-Improvement / The Feedback Loop\" section:\n - rlhf_signals ................... \"scored by analytics\" step\n - agent_loop_actions ............. actual loop actions taken by agents\n - agent_improvement_verifications adversarial-verify step\n - consolidation_jobs ............. episodic→semantic memory consolidation\n - zerodb_rlhf_datasets ........... RLHF training datasets built (feeds LoRA)\n - lakehouse_signals .............. file-bus → lakehouse pipeline volume\n\nDoes NOT double-count the existing improvement_loops card (which reads\nagent_run_log / mcp_request_logs / peer_swarm). These are distinct sources."},"RedisCommands":{"properties":{"total_commands_processed":{"type":"integer","title":"Total Commands Processed"},"instantaneous_ops_per_sec":{"type":"integer","title":"Instantaneous Ops Per Sec"},"keyspace_hits":{"type":"integer","title":"Keyspace Hits"},"keyspace_misses":{"type":"integer","title":"Keyspace Misses"}},"type":"object","required":["total_commands_processed","instantaneous_ops_per_sec","keyspace_hits","keyspace_misses"],"title":"RedisCommands"},"RedisConfig":{"properties":{"host":{"type":"string","title":"Host"},"port":{"type":"integer","title":"Port"},"max_connections":{"type":"integer","title":"Max Connections"},"connection_pool_size":{"type":"integer","title":"Connection Pool Size"},"default_ttl":{"type":"integer","title":"Default Ttl"},"max_memory_policy":{"type":"string","title":"Max Memory Policy"},"persistence_enabled":{"type":"boolean","title":"Persistence Enabled"}},"type":"object","required":["host","port","max_connections","connection_pool_size","default_ttl","max_memory_policy","persistence_enabled"],"title":"RedisConfig"},"RedisConnections":{"properties":{"connected_clients":{"type":"integer","title":"Connected Clients"},"max_clients":{"type":"integer","title":"Max Clients"},"total_connections_received":{"type":"integer","title":"Total Connections Received"},"rejected_connections":{"type":"integer","title":"Rejected Connections"}},"type":"object","required":["connected_clients","max_clients","total_connections_received","rejected_connections"],"title":"RedisConnections"},"RedisKeyStats":{"properties":{"total_keys":{"type":"integer","title":"Total Keys"},"expired_keys":{"type":"integer","title":"Expired Keys"},"evicted_keys":{"type":"integer","title":"Evicted Keys"},"key_patterns":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Key Patterns"}},"type":"object","required":["total_keys","expired_keys","evicted_keys"],"title":"RedisKeyStats"},"RedisMemoryUsage":{"properties":{"used_memory":{"type":"integer","title":"Used Memory"},"used_memory_human":{"type":"string","title":"Used Memory Human"},"used_memory_peak":{"type":"integer","title":"Used Memory Peak"},"used_memory_peak_human":{"type":"string","title":"Used Memory Peak Human"},"memory_fragmentation_ratio":{"type":"number","title":"Memory Fragmentation Ratio"}},"type":"object","required":["used_memory","used_memory_human","used_memory_peak","used_memory_peak_human","memory_fragmentation_ratio"],"title":"RedisMemoryUsage"},"RedisMetrics":{"properties":{"status":{"type":"string","title":"Status"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"memory_usage":{"$ref":"#/components/schemas/RedisMemoryUsage"},"connections":{"$ref":"#/components/schemas/RedisConnections"},"commands":{"$ref":"#/components/schemas/RedisCommands"},"persistence":{"anyOf":[{"$ref":"#/components/schemas/RedisPersistence"},{"type":"null"}]},"keys":{"$ref":"#/components/schemas/RedisKeyStats"},"hit_ratio":{"type":"number","title":"Hit Ratio"}},"type":"object","required":["status","memory_usage","connections","commands","keys","hit_ratio"],"title":"RedisMetrics","description":"Two real shapes: connected (full detail) and disconnected (mock fallback)."},"RedisPersistence":{"properties":{"rdb_last_save_time":{"type":"integer","title":"Rdb Last Save Time"},"rdb_changes_since_last_save":{"type":"integer","title":"Rdb Changes Since Last Save"},"aof_enabled":{"type":"integer","title":"Aof Enabled"}},"type":"object","required":["rdb_last_save_time","rdb_changes_since_last_save","aof_enabled"],"title":"RedisPersistence"},"RednovaScanBlockedResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'blocked'"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["status","detail"],"title":"RednovaScanBlockedResponse","description":"Returned instead of results when the safety guard refuses the target."},"RednovaScanRequest":{"properties":{"base_url":{"type":"string","title":"Base Url","description":"Target base URL to probe (your own staging)."},"allow_prod":{"type":"boolean","title":"Allow Prod","description":"Must be true to target a prod host.","default":false},"tenant_key_a":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Key A","description":"Optional tenant key (IDOR probe)."},"tenant_key_b":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Key B","description":"Optional second tenant key."}},"type":"object","required":["base_url"],"title":"RednovaScanRequest"},"RednovaScanResultResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'ok'"},"target":{"type":"string","title":"Target"},"summary":{"additionalProperties":true,"type":"object","title":"Summary","description":"Counts keyed by severity, plus 'total' and 'confirmed'"},"findings":{"items":{"$ref":"#/components/schemas/ProbeFinding"},"type":"array","title":"Findings"},"confirmed":{"type":"integer","title":"Confirmed"}},"type":"object","required":["status","target","summary","findings","confirmed"],"title":"RednovaScanResultResponse","description":"Returned when the probe suite ran to completion."},"RefListResponse":{"properties":{"refs":{"items":{},"type":"array","title":"Refs"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["refs","total"],"title":"RefListResponse"},"RefResponse":{"properties":{"ref_id":{"type":"string","title":"Ref Id"},"credential_id":{"type":"string","title":"Credential Id"},"agent_id":{"type":"string","title":"Agent Id"},"ttl_seconds":{"type":"integer","title":"Ttl Seconds"},"max_uses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Uses"},"expires_at":{"type":"string","title":"Expires At"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["ref_id","credential_id","agent_id","ttl_seconds","expires_at","created_at"],"title":"RefResponse"},"RefactoringApply":{"properties":{"suggestion_id":{"type":"string","title":"Suggestion Id","description":"ID of the suggestion to apply"},"modifications":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Modifications","description":"Optional modifications to the suggestion"}},"type":"object","required":["suggestion_id"],"title":"RefactoringApply","description":"RefactoringApply schema"},"RefactoringSuggestionCreate":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID to associate with the suggestions"},"file_path":{"type":"string","title":"File Path","description":"Path to the file being analyzed"},"code_content":{"type":"string","title":"Code Content","description":"Content of the file to analyze"},"analysis_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analysis Id","description":"Optional ID of previous code quality analysis"}},"type":"object","required":["project_id","file_path","code_content"],"title":"RefactoringSuggestionCreate","description":"RefactoringSuggestionCreate schema"},"RefactoringSuggestionRead":{"properties":{"suggestion_id":{"type":"string","title":"Suggestion Id","description":"Unique identifier for the suggestion"},"project_id":{"type":"string","title":"Project Id","description":"Project ID associated with the suggestion"},"file_path":{"type":"string","title":"File Path","description":"Path to the analyzed file"},"pattern":{"type":"string","title":"Pattern","description":"Type of refactoring pattern"},"description":{"type":"string","title":"Description","description":"Human-readable description of the suggestion"},"rationale":{"type":"string","title":"Rationale","description":"Explanation of why this refactoring is recommended"},"impact":{"type":"string","title":"Impact","description":"Impact level of the refactoring"},"diff":{"$ref":"#/components/schemas/CodeDiff","description":"Proposed code changes"},"created_at":{"type":"string","title":"Created At","description":"When the suggestion was generated"}},"type":"object","required":["suggestion_id","project_id","file_path","pattern","description","rationale","impact","diff","created_at"],"title":"RefactoringSuggestionRead","description":"RefactoringSuggestionRead schema"},"RefactoringSuggestionSummary":{"properties":{"suggestion_id":{"type":"string","title":"Suggestion Id","description":"Unique identifier for the suggestion"},"project_id":{"type":"string","title":"Project Id","description":"Project ID associated with the suggestion"},"file_path":{"type":"string","title":"File Path","description":"Path to the analyzed file"},"pattern":{"type":"string","title":"Pattern","description":"Type of refactoring pattern"},"description":{"type":"string","title":"Description","description":"Brief description of the suggestion"},"impact":{"type":"string","title":"Impact","description":"Impact level of the refactoring"},"created_at":{"type":"string","title":"Created At","description":"When the suggestion was generated"}},"type":"object","required":["suggestion_id","project_id","file_path","pattern","description","impact","created_at"],"title":"RefactoringSuggestionSummary","description":"RefactoringSuggestionSummary schema"},"ReferenceResolveRequest":{"properties":{"project_id":{"type":"string","title":"Project Id"},"reference":{"type":"string","title":"Reference"},"reference_type":{"type":"string","title":"Reference Type","default":"symbol"}},"type":"object","required":["project_id","reference"],"title":"ReferenceResolveRequest","description":"Request model for resolving a cross-project reference."},"ReferenceResolveResponse":{"properties":{"status":{"type":"string","title":"Status"},"reference":{"type":"string","title":"Reference"},"reference_type":{"type":"string","title":"Reference Type"},"source_project_id":{"type":"string","title":"Source Project Id"},"related_projects":{"items":{"$ref":"#/components/schemas/RelatedProjectRef"},"type":"array","title":"Related Projects"},"resolved_references":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Resolved References"},"total_references":{"type":"integer","title":"Total References"}},"type":"object","required":["status","reference","reference_type","source_project_id","related_projects","resolved_references","total_references"],"title":"ReferenceResolveResponse","description":"Response for POST /project-context/references/resolve\n(resolve_cross_project_reference).\n\nresolved_references is genuinely variant-shaped -- the service layer\nselects different columns per reference_type (symbol/import/file), so\nit is intentionally left as List[Dict[str, Any]] rather than forcing a\nmisleading single schema onto three different real shapes."},"ReferralAttributionResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"type":"string","title":"Organization Id"},"referring_organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referring Organization Id"},"referral_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referral Slug"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["organization_id"],"title":"ReferralAttributionResponse"},"ReferralEligibilityResponse":{"properties":{"eligible":{"type":"boolean","title":"Eligible","default":false},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"org_id":{"type":"string","title":"Org Id"}},"type":"object","required":["org_id"],"title":"ReferralEligibilityResponse","description":"Response for GET /api/oauth/organizations/{org_id}/referral/eligibility."},"ReferralLinkResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"org_slug":{"type":"string","title":"Org Slug"},"referral_url":{"type":"string","title":"Referral Url"}},"type":"object","required":["organization_id","org_slug","referral_url"],"title":"ReferralLinkResponse"},"ReferralRedemptionsResponse":{"properties":{"redemptions":{"items":{},"type":"array","title":"Redemptions","default":[]},"total":{"type":"integer","title":"Total","default":0},"org_id":{"type":"string","title":"Org Id"}},"type":"object","required":["org_id"],"title":"ReferralRedemptionsResponse","description":"Response for GET /api/oauth/organizations/{org_id}/referral/redemptions."},"ReflectRequest":{"properties":{"entity_id":{"type":"string","title":"Entity Id","description":"Entity to reflect on"},"namespace":{"type":"string","title":"Namespace","description":"Memory namespace for storing generated insights. Required. Refs #2960"}},"type":"object","required":["entity_id","namespace"],"title":"ReflectRequest"},"ReflectResponse":{"properties":{"entity_id":{"type":"string","title":"Entity Id"},"insights":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Insights","description":"Each item: {content: str, confidence: float}."},"memories_reviewed":{"type":"integer","title":"Memories Reviewed"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Present when there weren't enough memories (<3) to reflect on."},"new_semantic_memories":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"New Semantic Memories"},"profile_updated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Profile Updated"},"degraded":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Degraded","description":"True when the reflection LLM call failed/was truncated — memories were NOT consolidated."},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning"}},"type":"object","required":["entity_id","insights","memories_reviewed"],"title":"ReflectResponse"},"RefreshTokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"}},"additionalProperties":true,"type":"object","required":["access_token"],"title":"RefreshTokenResponse","description":"POST /auth/refresh — new access token issued from a valid refresh token.\n\nReplaces the previous ``response_model=dict`` placeholder with the real\nshape (no refresh token is reissued here — only a new access token)."},"RegionConfigRequest":{"properties":{"region":{"type":"string","title":"Region","description":"Datacenter region slug"},"latency_routing":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Latency Routing","description":"Enable latency-based routing"}},"type":"object","required":["region"],"title":"RegionConfigRequest"},"RegionConfigResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"region":{"type":"string","title":"Region"},"latency_routing":{"type":"boolean","title":"Latency Routing","default":false},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["deployment_id","region"],"title":"RegionConfigResponse"},"RegionalEconomicSignals":{"properties":{"unemployment_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Unemployment Rate"},"fred_series_count":{"type":"integer","title":"Fred Series Count","default":0},"federal_awards_ytd":{"type":"number","title":"Federal Awards Ytd","default":0},"federal_awards_count":{"type":"integer","title":"Federal Awards Count","default":0},"edd_total_employment":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Edd Total Employment"},"source":{"type":"string","title":"Source","default":"unavailable"}},"type":"object","title":"RegionalEconomicSignals","description":"Santa Cruz County open-data signals from the lake. Refs #3372"},"RegisterDeploymentWebhookRequest":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url","description":"HTTPS callback URL"},"events":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Events","description":"Deployment event types to subscribe to","examples":[["deployment.healthy","deployment.unhealthy"]]},"secret":{"anyOf":[{"type":"string","maxLength":256,"minLength":8},{"type":"null"}],"title":"Secret","description":"Signing secret for HMAC-SHA256 verification (min 8 chars)"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description","description":"Human-readable label"}},"type":"object","required":["url","events"],"title":"RegisterDeploymentWebhookRequest"},"RegisterProjectRelationshipResponse":{"properties":{"relationship_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Relationship Id"},"source_project_id":{"type":"string","title":"Source Project Id"},"target_project_id":{"type":"string","title":"Target Project Id"},"relationship_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relationship Type"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"status":{"type":"string","title":"Status","description":"created | updated | error"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present only when status is error"}},"type":"object","required":["source_project_id","target_project_id","status"],"title":"RegisterProjectRelationshipResponse","description":"Response for POST /cross-project/relationships."},"RegisterToolsRequest":{"properties":{"server_name":{"type":"string","minLength":1,"title":"Server Name"},"tools":{"items":{"$ref":"#/components/schemas/ToolDefinition"},"type":"array","title":"Tools"}},"type":"object","required":["server_name","tools"],"title":"RegisterToolsRequest"},"RegisterToolsResponse":{"properties":{"server_name":{"type":"string","title":"Server Name"},"tools_registered":{"type":"integer","title":"Tools Registered"},"hashes":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Hashes"}},"type":"object","required":["server_name","tools_registered","hashes"],"title":"RegisterToolsResponse"},"RegisterWebhookRequest":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url","description":"HTTPS URL that will receive POST events"},"events":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Events","description":"Event types to subscribe to","examples":[["memory.stored","vectors.indexed"]]},"secret":{"anyOf":[{"type":"string","maxLength":256,"minLength":8},{"type":"null"}],"title":"Secret","description":"Optional signing secret. When provided, each delivery includes an X-ZeroDB-Signature header (sha256=) for verification."}},"type":"object","required":["url","events"],"title":"RegisterWebhookRequest"},"RegisterWebhookResponse":{"properties":{"webhook_id":{"type":"string","title":"Webhook Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["webhook_id","url","events","created_at"],"title":"RegisterWebhookResponse"},"RegisteredHashEntry":{"properties":{"server_name":{"type":"string","title":"Server Name"},"tool_name":{"type":"string","title":"Tool Name"},"definition_hash":{"type":"string","title":"Definition Hash"},"registered_at":{"type":"string","title":"Registered At"}},"type":"object","required":["server_name","tool_name","definition_hash","registered_at"],"title":"RegisteredHashEntry"},"RegisteredRouterInfo":{"properties":{"prefix":{"type":"string","title":"Prefix"},"module":{"type":"string","title":"Module"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"}},"type":"object","required":["prefix","module","tags"],"title":"RegisteredRouterInfo"},"RegistryLookupRequest":{"properties":{"subscriber_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscriber Id"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},"type":"object","title":"RegistryLookupRequest"},"RegistryLookupResult":{"properties":{"subscriber_id":{"type":"string","title":"Subscriber Id"},"subscriber_url":{"type":"string","title":"Subscriber Url"},"type":{"type":"string","title":"Type"},"domain":{"type":"string","title":"Domain"},"signing_public_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signing Public Key"},"encryption_public_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encryption Public Key"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country":{"type":"string","title":"Country"},"status":{"type":"string","title":"Status"},"created":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created"}},"type":"object","required":["subscriber_id","subscriber_url","type","domain","country","status"],"title":"RegistryLookupResult"},"RegistrySubscribeResponse":{"properties":{"message":{"$ref":"#/components/schemas/app__api__v1__endpoints__beckn_network__BecknAckMessage"},"subscriber_id":{"type":"string","title":"Subscriber Id"},"action":{"type":"string","title":"Action"},"status":{"type":"string","title":"Status"}},"type":"object","required":["message","subscriber_id","action","status"],"title":"RegistrySubscribeResponse"},"ReindexDatabaseResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"operation":{"type":"string","title":"Operation"},"started_at":{"type":"string","title":"Started At"},"completed_at":{"type":"string","title":"Completed At"},"duration_seconds":{"type":"number","title":"Duration Seconds"},"tables_processed":{"type":"integer","title":"Tables Processed"},"tables_failed":{"type":"integer","title":"Tables Failed"},"results":{"items":{"$ref":"#/components/schemas/MaintenanceTableResult"},"type":"array","title":"Results"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","operation","started_at","completed_at","duration_seconds","tables_processed","tables_failed","results","message"],"title":"ReindexDatabaseResponse"},"ReindexRequest":{"properties":{"base_url":{"type":"string","title":"Base Url","description":"Docs site URL to crawl (defaults to DOCS_BASE_URL env var)","default":"https://docs.ainative.studio"}},"type":"object","title":"ReindexRequest"},"ReindexResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"ReindexResponse"},"RelateRequest":{"properties":{"subject":{"type":"string","title":"Subject","description":"Source entity"},"predicate":{"type":"string","title":"Predicate","description":"Relationship type"},"object":{"type":"string","title":"Object","description":"Target entity"},"confidence":{"type":"number","maximum":1,"minimum":0,"title":"Confidence","default":0.8}},"type":"object","required":["subject","predicate","object"],"title":"RelateRequest"},"RelateResponse":{"properties":{"relationship_id":{"type":"string","title":"Relationship Id"},"subject":{"type":"string","title":"Subject"},"predicate":{"type":"string","title":"Predicate"},"object":{"type":"string","title":"Object"}},"type":"object","required":["relationship_id","subject","predicate","object"],"title":"RelateResponse"},"RelatedProjectRef":{"properties":{"id":{"title":"Id"}},"type":"object","required":["id"],"title":"RelatedProjectRef"},"RelatedVideosResponse":{"properties":{"source_video_id":{"type":"string","format":"uuid","title":"Source Video Id"},"related_videos":{"items":{"$ref":"#/components/schemas/VideoRecommendationResponse"},"type":"array","title":"Related Videos"},"strategy":{"type":"string","title":"Strategy","default":"hybrid"},"total_candidates":{"type":"integer","title":"Total Candidates"},"execution_time_ms":{"type":"number","title":"Execution Time Ms"}},"type":"object","required":["source_video_id","related_videos","total_candidates","execution_time_ms"],"title":"RelatedVideosResponse","description":"Response for GET /videos/{id}/related endpoint"},"RememberRequest":{"properties":{"content":{"type":"string","title":"Content","description":"Memory content"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id","description":"Entity this memory is about"},"memory_type":{"type":"string","title":"Memory Type","description":"working, episodic, or semantic","default":"episodic"},"importance":{"type":"number","maximum":1,"minimum":0,"title":"Importance","description":"Importance score","default":0.5},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Tags for categorization"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project UUID for ontology-aware entity classification (Refs #2242)"},"namespace":{"type":"string","title":"Namespace","description":"Memory namespace: 'global', 'project:', or 'session:'. Defaults to 'global' (matches /recall and the documented examples). The service already defaults this internally, so requiring it only produced confusing 422s for clients following the docs. Refs #2884, #2960","default":"global"}},"type":"object","required":["content"],"title":"RememberRequest"},"RememberResponse":{"properties":{"memory_id":{"type":"string","title":"Memory Id"},"status":{"type":"string","title":"Status"},"memory_type":{"type":"string","title":"Memory Type"},"entities_extracted":{"type":"integer","title":"Entities Extracted"},"ontology_classified":{"type":"boolean","title":"Ontology Classified"},"namespace":{"type":"string","title":"Namespace"},"security_warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Warning","description":"Set when stored content was sanitized (hidden Unicode/HTML comment injection removed)."},"indexing":{"additionalProperties":true,"type":"object","title":"Indexing","description":"Async embedding-backfill status, added by the route handler."},"next_steps":{"additionalProperties":true,"type":"object","title":"Next Steps","description":"Suggested follow-up action, added by the route handler."}},"type":"object","required":["memory_id","status","memory_type","entities_extracted","ontology_classified","namespace","indexing","next_steps"],"title":"RememberResponse"},"RemoveContentRequest":{"properties":{"content_id":{"type":"string","format":"uuid","title":"Content Id","description":"UUID of content to remove"},"content_type":{"type":"string","title":"Content Type","description":"Type of content (POST, COMMENT, STREAM)"},"reason":{"type":"string","maxLength":500,"title":"Reason","description":"Reason for removal"},"notify_user":{"type":"boolean","title":"Notify User","description":"Whether to notify the content author","default":true}},"type":"object","required":["content_id","content_type","reason"],"title":"RemoveContentRequest","description":"Request schema for removing content"},"RemoveHealthCheckResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","timestamp"],"title":"RemoveHealthCheckResponse","description":"DELETE /deployment/health-checks/{health_check_name} — health check removed."},"RemoveIPWhitelistResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"entry_id":{"type":"string","title":"Entry Id"}},"type":"object","required":["success","message","entry_id"],"title":"RemoveIPWhitelistResponse","description":"Response for removing an IP from the whitelist"},"RemoveLogoResponse":{"properties":{"toast":{"type":"string","title":"Toast"}},"type":"object","required":["toast"],"title":"RemoveLogoResponse"},"RemoveMemoryRequest":{"properties":{"memory_id":{"type":"string","title":"Memory Id","description":"UUID of the memory to remove"}},"type":"object","required":["memory_id"],"title":"RemoveMemoryRequest"},"RemoveMemoryResponse":{"properties":{"memory_id":{"type":"string","title":"Memory Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["memory_id","status"],"title":"RemoveMemoryResponse"},"RemovePaymentMethodResponse":{"properties":{"message":{"type":"string","title":"Message"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning"}},"type":"object","required":["message"],"title":"RemovePaymentMethodResponse"},"RemoveRequest":{"properties":{"confirm":{"type":"boolean","title":"Confirm","default":false}},"type":"object","title":"RemoveRequest"},"RemoveResponse":{"properties":{"scheduled_for_removal":{"type":"boolean","title":"Scheduled For Removal"},"undoable":{"type":"boolean","title":"Undoable"},"effective_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Effective At"}},"type":"object","required":["scheduled_for_removal","undoable"],"title":"RemoveResponse"},"ReorderItemsRequest":{"properties":{"item_orders":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Item Orders","description":"List of {item_id: UUID, order_index: int}"}},"type":"object","required":["item_orders"],"title":"ReorderItemsRequest","description":"Schema for reordering album items"},"RepoAccessResponse":{"properties":{"has_access":{"type":"boolean","title":"Has Access"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"},"organization_id":{"type":"string","title":"Organization Id"},"owner":{"type":"string","title":"Owner"},"repo":{"type":"string","title":"Repo"}},"type":"object","required":["has_access","permissions","organization_id","owner","repo"],"title":"RepoAccessResponse","description":"Response for repo access check."},"ReportCategory":{"type":"string","enum":["SPAM","HARASSMENT","HATE_SPEECH","INAPPROPRIATE_CONTENT","MISINFORMATION","COPYRIGHT","OTHER"],"title":"ReportCategory","description":"Categories for content reports"},"ReportContentRequest":{"properties":{"content_id":{"type":"string","format":"uuid","title":"Content Id","description":"UUID of the content being reported"},"content_type":{"type":"string","title":"Content Type","description":"Type of content (POST, COMMENT, STREAM, etc.)"},"reason_category":{"$ref":"#/components/schemas/ReportCategory","description":"Category of the report"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Optional detailed description"}},"type":"object","required":["content_id","content_type","reason_category"],"title":"ReportContentRequest","description":"Request schema for reporting content"},"ReportDetailResponse":{"properties":{"report":{"$ref":"#/components/schemas/ReportRecord"},"metrics":{"anyOf":[{"$ref":"#/components/schemas/KpiSummary"},{"type":"null"}]}},"type":"object","required":["report"],"title":"ReportDetailResponse"},"ReportListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ReportRecord"},"type":"array","title":"Data"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["data","organization_id"],"title":"ReportListResponse"},"ReportRecord":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"report_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"is_verified":{"type":"boolean","title":"Is Verified","default":false},"verified_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verified At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By"}},"type":"object","title":"ReportRecord"},"ReportResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"reporter_id":{"type":"string","format":"uuid","title":"Reporter Id"},"content_id":{"type":"string","format":"uuid","title":"Content Id"},"content_type":{"type":"string","title":"Content Type"},"reason_category":{"type":"string","title":"Reason Category"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status"},"admin_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin Notes"},"reviewed_by_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Reviewed By Id"},"reviewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reviewed At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"ai_assessment":{"anyOf":[{"$ref":"#/components/schemas/AIAssessment"},{"type":"null"}],"description":"AI moderation assessment if available"}},"type":"object","required":["id","reporter_id","content_id","content_type","reason_category","description","status","admin_notes","reviewed_by_id","reviewed_at","created_at","updated_at"],"title":"ReportResponse","description":"Response schema for report details"},"ReportShareResponse":{"properties":{"report_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Id"},"share_token":{"type":"string","title":"Share Token"},"share_url":{"type":"string","title":"Share Url"},"share_created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Share Created At"}},"type":"object","required":["share_token","share_url"],"title":"ReportShareResponse"},"ReportStatus":{"type":"string","enum":["PENDING","UNDER_REVIEW","RESOLVED","REJECTED"],"title":"ReportStatus","description":"Status of content reports"},"ReportUnlockRequest":{"properties":{"report_id":{"type":"string","title":"Report Id","description":"Report ID to unlock"},"email":{"type":"string","format":"email","title":"Email","description":"Email to unlock full report"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"}},"type":"object","required":["report_id","email"],"title":"ReportUnlockRequest"},"ReportUnlockResponse":{"properties":{"report_id":{"type":"string","title":"Report Id"},"unlocked":{"type":"boolean","title":"Unlocked"},"email":{"type":"string","title":"Email"}},"type":"object","required":["report_id","unlocked","email"],"title":"ReportUnlockResponse"},"RepositoryAnalysis":{"properties":{"analysis_id":{"type":"string","title":"Analysis Id"},"repository_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repository Url"},"branch":{"type":"string","title":"Branch"},"analysis_type":{"type":"string","title":"Analysis Type"},"status":{"type":"string","title":"Status"},"started_by":{"type":"string","title":"Started By"},"started_at":{"type":"string","title":"Started At"},"completed_at":{"type":"string","title":"Completed At"},"results":{"$ref":"#/components/schemas/RepositoryAnalysisResults"}},"type":"object","required":["analysis_id","branch","analysis_type","status","started_by","started_at","completed_at","results"],"title":"RepositoryAnalysis"},"RepositoryAnalysisResults":{"properties":{"total_files":{"type":"integer","title":"Total Files"},"lines_of_code":{"type":"integer","title":"Lines Of Code"},"languages":{"additionalProperties":{"type":"number"},"type":"object","title":"Languages"},"code_quality":{"$ref":"#/components/schemas/CodeQualityScores"},"issues_found":{"items":{"$ref":"#/components/schemas/RepositoryIssue"},"type":"array","title":"Issues Found"},"suggestions":{"items":{"type":"string"},"type":"array","title":"Suggestions"}},"type":"object","required":["total_files","lines_of_code","languages","code_quality","issues_found","suggestions"],"title":"RepositoryAnalysisResults"},"RepositoryAnalyzeResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/RepositoryAnalysis"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","data","message"],"title":"RepositoryAnalyzeResponse","description":"Response for POST /git/analyze (analyze_repository).\n\nNOTE: analyze_repository currently returns hardcoded mock analysis data\n(fixed file/line counts, fixed quality scores) rather than performing a\nreal analysis -- this schema documents the real (mock) shape returned\ntoday, not a claim that the analysis itself is genuine."},"RepositoryCommit":{"properties":{"sha":{"type":"string","title":"Sha"},"message":{"type":"string","title":"Message"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"date":{"type":"string","title":"Date"}},"additionalProperties":true,"type":"object","required":["sha","message","date"],"title":"RepositoryCommit"},"RepositoryConnectResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/RepositoryConnection"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","data","message"],"title":"RepositoryConnectResponse","description":"Response for POST /git/ (connect_repository).\n\nNOTE: connect_repository currently returns a hardcoded mock connection\nconfirmation rather than performing a real repository connection --\nthis schema documents the real (mock) shape returned today."},"RepositoryConnection":{"properties":{"connection_id":{"type":"string","title":"Connection Id"},"repository_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repository Url"},"access_token":{"type":"string","title":"Access Token"},"status":{"type":"string","title":"Status"},"connected_by":{"type":"string","title":"Connected By"},"connected_at":{"type":"string","title":"Connected At"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"},"webhook_configured":{"type":"boolean","title":"Webhook Configured"}},"type":"object","required":["connection_id","access_token","status","connected_by","connected_at","permissions","webhook_configured"],"title":"RepositoryConnection"},"RepositoryContext":{"properties":{"repository_id":{"type":"string","title":"Repository Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"structure":{"additionalProperties":true,"type":"object","title":"Structure"},"recent_commits":{"items":{"$ref":"#/components/schemas/RepositoryCommit"},"type":"array","title":"Recent Commits"},"dependencies":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Dependencies"},"deployment":{"$ref":"#/components/schemas/RepositoryDeployment"}},"additionalProperties":true,"type":"object","required":["repository_id","name","description","structure","recent_commits","dependencies","deployment"],"title":"RepositoryContext"},"RepositoryContextResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/RepositoryContext"}},"type":"object","required":["success","data"],"title":"RepositoryContextResponse","description":"Response for GET /git/context/{repo_id}."},"RepositoryDeployment":{"properties":{"status":{"type":"string","title":"Status"},"url":{"type":"string","title":"Url"},"last_deployed":{"type":"string","title":"Last Deployed"}},"type":"object","required":["status","url","last_deployed"],"title":"RepositoryDeployment"},"RepositoryIndexingStats":{"properties":{"total_files":{"type":"integer","title":"Total Files","description":"Total number of indexed files"},"total_chunks":{"type":"integer","title":"Total Chunks","description":"Total number of indexed chunks"},"last_indexed":{"type":"string","title":"Last Indexed","description":"Timestamp of the last indexing run"},"indexing_duration_ms":{"type":"integer","title":"Indexing Duration Ms","description":"Duration of the last indexing run in milliseconds"}},"type":"object","required":["total_files","total_chunks","last_indexed","indexing_duration_ms"],"title":"RepositoryIndexingStats","description":"Nested stats block for GET /indexing/repositories/{project_id}/stats."},"RepositoryIssue":{"properties":{"type":{"type":"string","title":"Type"},"file":{"type":"string","title":"File"},"line":{"type":"integer","title":"Line"},"message":{"type":"string","title":"Message"}},"type":"object","required":["type","file","line","message"],"title":"RepositoryIssue"},"RepositorySearchResult":{"properties":{"file_path":{"type":"string","title":"File Path","description":"Path of the matched file"},"content":{"type":"string","title":"Content","description":"Matched content excerpt"},"similarity_score":{"type":"number","title":"Similarity Score","description":"Similarity score for the match"}},"type":"object","required":["file_path","content","similarity_score"],"title":"RepositorySearchResult","description":"A single search hit returned by the repository search endpoint."},"RepositoryStatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"repository_status":{"additionalProperties":true,"type":"object","title":"Repository Status"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","repository_status","timestamp"],"title":"RepositoryStatusResponse","description":"Response for GET /git-integration/status/{project_path}."},"RequestDomainBody":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":3,"title":"Domain"}},"type":"object","required":["domain"],"title":"RequestDomainBody"},"RequestEmailChangeRequest":{"properties":{"new_email":{"type":"string","format":"email","title":"New Email"},"app":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App","description":"Originating-app identifier (e.g. 'ax') resolving branding + confirm-link domain from email_service's _APP_EMAIL_BRANDING. Absent/unrecognized falls back to AINative Studio defaults."}},"type":"object","required":["new_email"],"title":"RequestEmailChangeRequest","description":"Request to begin changing the current user's email. Refs ainative-ax#167"},"RequestEmailChangeResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"RequestEmailChangeResponse"},"RequestHistoryPoint":{"properties":{"hour":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hour"},"request_count":{"type":"integer","title":"Request Count"},"avg_latency_ms":{"type":"number","title":"Avg Latency Ms"}},"type":"object","required":["request_count","avg_latency_ms"],"title":"RequestHistoryPoint"},"RequestTrackingData":{"properties":{"instance_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instance Id","description":"MCP instance ID"},"endpoint":{"type":"string","title":"Endpoint","description":"API endpoint called"},"method":{"type":"string","title":"Method","description":"HTTP method","default":"GET"},"status_code":{"type":"integer","title":"Status Code","description":"Response status code","default":200},"response_time_ms":{"type":"integer","title":"Response Time Ms","description":"Response time in milliseconds","default":0},"client_ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Ip","description":"Client IP address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent","description":"User agent string"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers","description":"Request headers"}},"type":"object","required":["endpoint"],"title":"RequestTrackingData","description":"Data structure for tracking request from API gateway"},"RerankRequest":{"properties":{"query":{"type":"string","maxLength":8192,"minLength":1,"title":"Query"},"documents":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Documents"},"model":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Model"},"top_n":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"title":"Top N"}},"type":"object","required":["query","documents"],"title":"RerankRequest"},"RerankResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/RerankResult"},"type":"array","title":"Results"},"model":{"type":"string","title":"Model"},"processing_time_ms":{"type":"number","title":"Processing Time Ms"}},"type":"object","required":["results","model","processing_time_ms"],"title":"RerankResponse"},"RerankResult":{"properties":{"document":{"type":"string","title":"Document"},"index":{"type":"integer","title":"Index"},"score":{"type":"number","title":"Score"}},"type":"object","required":["document","index","score"],"title":"RerankResult"},"ResearchRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":2,"title":"Query"},"sources":{"items":{"type":"string"},"type":"array","title":"Sources","description":"Sources to search: essays, transcripts, smb, graph, platform","default":["essays","transcripts","smb","graph","platform"]},"limit":{"type":"integer","maximum":50,"minimum":1,"title":"Limit","default":20},"synthesize":{"type":"boolean","title":"Synthesize","description":"LLM synthesis of results","default":false}},"type":"object","required":["query"],"title":"ResearchRequest"},"ResearchResponse":{"properties":{"query":{"type":"string","title":"Query"},"results":{"items":{"$ref":"#/components/schemas/ResearchResult"},"type":"array","title":"Results"},"graph_context":{"items":{"$ref":"#/components/schemas/GraphContext"},"type":"array","title":"Graph Context","default":[]},"synthesis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Synthesis"},"total":{"type":"integer","title":"Total"},"sources_searched":{"items":{"type":"string"},"type":"array","title":"Sources Searched"}},"type":"object","required":["query","results","total","sources_searched"],"title":"ResearchResponse"},"ResearchResult":{"properties":{"source":{"type":"string","title":"Source"},"title":{"type":"string","title":"Title"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"excerpt":{"type":"string","title":"Excerpt"},"score":{"type":"number","title":"Score"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"type":"object","required":["source","title","excerpt","score"],"title":"ResearchResult"},"ResendActivationResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Neutral confirmation, identical for existing and non-existing emails so account existence is not revealed"}},"type":"object","required":["message"],"title":"ResendActivationResponse","description":"Response for an activation-email resend request (Refs #8449).\n\nSECURITY: deliberately a SINGLE required `message` field and nothing else.\nThis route returns the identical neutral message whether or not the email\nhas an account, specifically so the response cannot be used to enumerate\naccounts. Adding an `exists`/`found`/`sent` field — or making `message`\noptional, so that its mere presence differed between branches — would\nreintroduce that oracle. No `response_model_exclude_unset` for the same\nreason: a key appearing on one branch and not the other IS the leak."},"ResendVerificationResponse":{"properties":{"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["message"],"title":"ResendVerificationResponse","description":"POST /auth/resend-verification\n\nAlways returns the same message regardless of whether the email exists or\nis already verified (privacy-preserving, prevents account enumeration)."},"ResendW9Response":{"properties":{"sent":{"type":"boolean","title":"Sent"},"vendor_id":{"type":"string","title":"Vendor Id"},"email":{"type":"string","title":"Email"}},"type":"object","required":["sent","vendor_id","email"],"title":"ResendW9Response"},"ResendWebhookHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"webhook_secret_configured":{"type":"boolean","title":"Webhook Secret Configured"}},"type":"object","required":["status","service","webhook_secret_configured"],"title":"ResendWebhookHealthResponse","description":"Health check response for the Resend webhook handler."},"ResendWebhookResponse":{"properties":{"status":{"type":"string","title":"Status"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event"},"event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"},"campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"},"invoice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Id"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["status"],"title":"ResendWebhookResponse","description":"Result of processing a Resend email-event webhook.\n\nThe handler's real return shapes vary by route taken: campaign events\nadd mode+event+campaign, invoice events add mode+event_type+invoice_id,\nan unrecognized/untagged event returns just status(+reason or\n+event_type), and a genuinely unexpected error caught by the trailing\nhandler returns status=\"error\" with error+note instead of raising (kept\nas 200 to avoid Resend retry storms). All non-status fields are\ntherefore optional so one model covers every real branch."},"ResetPasswordResponse":{"properties":{"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["message"],"title":"ResetPasswordResponse","description":"POST /auth/reset-password"},"ResizeRequest":{"properties":{"target_size":{"type":"integer","maximum":50,"minimum":5,"title":"Target Size","description":"New target pool size"}},"type":"object","required":["target_size"],"title":"ResizeRequest"},"ResolveAlert":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Note","description":"Resolution note"}},"type":"object","title":"ResolveAlert","description":"Schema for resolving an alert (Refs #8270)","example":{"note":"SMTP provider recovered; failure rate back under 2%."}},"ResolveContradictionRequest":{"properties":{"action":{"type":"string","title":"Action","description":"Resolution action: accept_new, keep_both, or reject_new"}},"type":"object","required":["action"],"title":"ResolveContradictionRequest"},"ResolveContradictionResponse":{"properties":{"action":{"type":"string","title":"Action"},"old_edge_id":{"type":"string","title":"Old Edge Id"},"new_edge_id":{"type":"string","title":"New Edge Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["action","old_edge_id","new_edge_id","status"],"title":"ResolveContradictionResponse","description":"Response for POST /memory/v2/graph/contradictions/{edge_id}/resolve"},"ResolveCrossProjectReferenceResponse":{"properties":{"reference":{"type":"string","title":"Reference"},"source_project_id":{"type":"string","title":"Source Project Id"},"resolved_references":{"anyOf":[{"items":{"$ref":"#/components/schemas/ResolvedReference"},"type":"array"},{"type":"null"}],"title":"Resolved References"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Present only on the error branch"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present only when status is error"}},"type":"object","required":["reference","source_project_id"],"title":"ResolveCrossProjectReferenceResponse","description":"Response for POST /cross-project/resolve."},"ResolveEntityResponse":{"properties":{"query":{"type":"string","title":"Query"},"matches":{"items":{"$ref":"#/components/schemas/ResolveMatch"},"type":"array","title":"Matches"}},"additionalProperties":true,"type":"object","required":["query"],"title":"ResolveEntityResponse","description":"Response for GET /memory/v2/graph/resolve."},"ResolveMatch":{"properties":{"id":{"type":"string","title":"Id"},"canonical_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Name"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases"},"memory_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Count"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"}},"additionalProperties":true,"type":"object","required":["id"],"title":"ResolveMatch"},"ResolveRefRequest":{"properties":{"ref_id":{"type":"string","title":"Ref Id","description":"Opaque credential reference"},"agent_id":{"type":"string","title":"Agent Id","description":"Requesting agent ID"}},"type":"object","required":["ref_id","agent_id"],"title":"ResolveRefRequest","description":"Request body for POST /api/v1/cloud/credentials/refs/resolve (internal)."},"ResolveRefResponse":{"properties":{"credential_type":{"type":"string","title":"Credential Type","description":"Vault credential type"},"value":{"type":"string","title":"Value","description":"Decrypted credential value -- never log this"},"target_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Domain","description":"Domain this credential is scoped to, if any"}},"additionalProperties":false,"type":"object","required":["credential_type","value"],"title":"ResolveRefResponse","description":"Returned by POST /resolve -- carries a DECRYPTED SECRET.\n\n`extra=\"forbid\"` is deliberate and security-relevant: this is the one\nresponse in this router that contains a plaintext credential, so the\nschema is pinned shut rather than left open. The handler hand-picks\nexactly these 3 keys out of\n``CredentialRefService.resolve_ref`` ->\n``CredentialVaultService.decrypt_for_egress``, which itself returns\nexactly credential_type/value/target_domain. If that upstream dict ever\ngrows a field, this model must FAIL LOUDLY in tests rather than quietly\nforward a new secret-adjacent field to the caller.\n\n`value` is the plaintext credential and must never be logged.\nRefs #8449"},"ResolveReportRequest":{"properties":{"action_type":{"$ref":"#/components/schemas/app__models__content_report__ActionType","description":"Type of action taken"},"reason":{"type":"string","maxLength":500,"title":"Reason","description":"Reason for the action"},"notes":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Notes","description":"Additional notes"}},"type":"object","required":["action_type","reason"],"title":"ResolveReportRequest","description":"Request schema for resolving a report"},"ResolvedReference":{"properties":{"project_id":{"type":"string","title":"Project Id"},"relationship_type":{"type":"string","title":"Relationship Type"},"file_path":{"type":"string","title":"File Path"},"file_id":{"type":"integer","title":"File Id"},"chunk_id":{"type":"integer","title":"Chunk Id"},"start_line":{"type":"integer","title":"Start Line"},"end_line":{"type":"integer","title":"End Line"},"chunk_type":{"type":"string","title":"Chunk Type"},"match_quality":{"type":"number","title":"Match Quality"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["project_id","relationship_type","file_path","file_id","chunk_id","start_line","end_line","chunk_type","match_quality"],"title":"ResolvedReference"},"ResourceCapacity":{"properties":{"id":{"type":"string","title":"Id","description":"Capacity record identifier"},"agent_type":{"type":"string","title":"Agent Type","description":"Type of agent"},"total_instances":{"type":"integer","minimum":0,"title":"Total Instances","description":"Total number of instances"},"active_instances":{"type":"integer","minimum":0,"title":"Active Instances","description":"Number of active instances"},"idle_instances":{"type":"integer","minimum":0,"title":"Idle Instances","description":"Number of idle instances"},"avg_cpu_usage":{"type":"number","maximum":100,"minimum":0,"title":"Avg Cpu Usage","description":"Average CPU usage percentage"},"avg_memory_usage":{"type":"number","maximum":100,"minimum":0,"title":"Avg Memory Usage","description":"Average memory usage percentage"},"avg_response_time":{"type":"number","minimum":0,"title":"Avg Response Time","description":"Average response time in milliseconds"},"tasks_per_minute":{"type":"number","minimum":0,"title":"Tasks Per Minute","description":"Tasks processed per minute"},"queue_depth":{"type":"integer","minimum":0,"title":"Queue Depth","description":"Current queue depth"},"estimated_wait_time":{"type":"number","minimum":0,"title":"Estimated Wait Time","description":"Estimated wait time for new tasks in seconds"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"When this capacity report was last updated"}},"type":"object","required":["id","agent_type","total_instances","active_instances","idle_instances","avg_cpu_usage","avg_memory_usage","avg_response_time","tasks_per_minute","queue_depth","estimated_wait_time","updated_at"],"title":"ResourceCapacity","description":"Resource capacity information for agent types"},"ResourceThreshold":{"properties":{"resource_type":{"$ref":"#/components/schemas/ResourceType","description":"Type of resource"},"min_threshold":{"type":"number","title":"Min Threshold","description":"Minimum threshold value"},"max_threshold":{"type":"number","title":"Max Threshold","description":"Maximum threshold value"},"evaluation_period_seconds":{"type":"integer","minimum":1,"title":"Evaluation Period Seconds","description":"Period over which to evaluate metrics"},"consecutive_periods":{"type":"integer","minimum":1,"title":"Consecutive Periods","description":"Number of consecutive periods threshold must be crossed","default":1}},"type":"object","required":["resource_type","min_threshold","max_threshold","evaluation_period_seconds"],"title":"ResourceThreshold","description":"Threshold configuration for triggering scaling actions"},"ResourceType":{"type":"string","enum":["cpu","memory","gpu","tokens","requests","storage"],"title":"ResourceType","description":"Type of resource being managed"},"ResourceUsage":{"properties":{"cpu_usage":{"type":"number","title":"Cpu Usage"},"memory_usage":{"type":"number","title":"Memory Usage"},"api_calls_today":{"type":"integer","title":"Api Calls Today"},"tokens_consumed":{"type":"integer","title":"Tokens Consumed"}},"type":"object","required":["cpu_usage","memory_usage","api_calls_today","tokens_consumed"],"title":"ResourceUsage"},"ResponseTimeTrendPoint":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"value":{"type":"number","title":"Value"}},"additionalProperties":true,"type":"object","required":["timestamp","value"],"title":"ResponseTimeTrendPoint","description":"One 5-minute response-time bucket."},"ResponseTimeTrendsResponse":{"properties":{"trends":{"items":{"$ref":"#/components/schemas/ResponseTimeTrendPoint"},"type":"array","title":"Trends"},"statistics":{"additionalProperties":true,"type":"object","title":"Statistics"},"filters_applied":{"additionalProperties":true,"type":"object","title":"Filters Applied"}},"additionalProperties":true,"type":"object","required":["trends","statistics","filters_applied"],"title":"ResponseTimeTrendsResponse","description":"GET /trends/response-time.\n\n`statistics` is deliberately an open Dict rather than a model: the no-match\nbranch returns `{}` (an empty dict), while the populated branch returns the\nseven-key stats object. Typing it as a model with required fields would\nmake the empty branch fail validation."},"ResponsesIncompleteDetails":{"properties":{"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Why the response is incomplete"}},"additionalProperties":true,"type":"object","title":"ResponsesIncompleteDetails","description":"Reason a response is incomplete, when status is 'incomplete'."},"ResponsesInputMessage":{"properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"Input item type","default":"message"},"role":{"type":"string","title":"Role","description":"message role: user|assistant|system|developer","default":"user"},"content":{"anyOf":[{"type":"string"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"}],"title":"Content","description":"Message content","default":""}},"additionalProperties":true,"type":"object","title":"ResponsesInputMessage","description":"A single Responses-API input item of type \"message\"."},"ResponsesOutputContent":{"properties":{"type":{"type":"string","title":"Type","description":"Content part type","default":"output_text"},"text":{"type":"string","title":"Text","description":"Text content","default":""},"annotations":{"items":{},"type":"array","title":"Annotations","description":"Text annotations"}},"additionalProperties":true,"type":"object","title":"ResponsesOutputContent","description":"A single content part of a Responses-API output message item."},"ResponsesOutputItem":{"properties":{"type":{"type":"string","title":"Type","description":"Output item type","default":"message"},"id":{"type":"string","title":"Id","description":"Output item id"},"status":{"type":"string","title":"Status","description":"Output item status","default":"completed"},"role":{"type":"string","title":"Role","description":"Message role","default":"assistant"},"content":{"items":{"$ref":"#/components/schemas/ResponsesOutputContent"},"type":"array","title":"Content","description":"Message content parts"}},"additionalProperties":true,"type":"object","required":["id"],"title":"ResponsesOutputItem","description":"A single item in the Responses-API `output` array."},"ResponsesRequest":{"properties":{"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Model id (resolved by chat.py routing)"},"input":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/ResponsesInputMessage"},{"items":{"anyOf":[{"$ref":"#/components/schemas/ResponsesInputMessage"},{"additionalProperties":true,"type":"object"}]},"type":"array"}],"title":"Input","description":"Prompt input: string, message, or list of message items"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions","description":"System-level instructions"},"tools":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tools","description":"Tool/function definitions"},"tool_choice":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Choice","description":"Tool choice policy"},"max_output_tokens":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Max Output Tokens","description":"Max tokens to generate"},"temperature":{"anyOf":[{"type":"number","maximum":2,"minimum":0},{"type":"null"}],"title":"Temperature","description":"Sampling temperature"},"stream":{"type":"boolean","title":"Stream","description":"Stream the response (not yet supported — served non-streamed)","default":false},"previous_response_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Response Id","description":"Prior response id (not persisted yet)"},"store":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Store","description":"Whether to persist the response (no-op)"},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User","description":"End-user id for tracking"}},"additionalProperties":true,"type":"object","required":["input"],"title":"ResponsesRequest","description":"OpenAI Responses API request shape (subset muse actually sends).\n\nExtra fields are allowed and ignored so we stay forward-compatible with the\nparts of the Responses spec we don't yet map (store, reasoning, etc.)."},"ResponsesResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Response id"},"object":{"type":"string","title":"Object","description":"Object type","default":"response"},"created_at":{"type":"integer","title":"Created At","description":"Unix timestamp of creation"},"status":{"type":"string","title":"Status","description":"completed | incomplete | failed"},"model":{"type":"string","title":"Model","description":"Model id that served the request"},"output":{"items":{"$ref":"#/components/schemas/ResponsesOutputItem"},"type":"array","title":"Output","description":"Output items"},"output_text":{"type":"string","title":"Output Text","description":"Flattened assistant text","default":""},"usage":{"$ref":"#/components/schemas/ResponsesUsage"},"incomplete_details":{"anyOf":[{"$ref":"#/components/schemas/ResponsesIncompleteDetails"},{"type":"null"}],"description":"Set when status is 'incomplete'"},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error","description":"Error details, when status is 'failed'"}},"additionalProperties":true,"type":"object","required":["id","created_at","status","model","usage"],"title":"ResponsesResponse","description":"OpenAI Responses API response shape (subset this shim produces)."},"ResponsesUsage":{"properties":{"input_tokens":{"type":"integer","title":"Input Tokens","description":"Input (prompt) tokens","default":0},"output_tokens":{"type":"integer","title":"Output Tokens","description":"Output (completion) tokens","default":0},"total_tokens":{"type":"integer","title":"Total Tokens","description":"Total tokens","default":0}},"type":"object","title":"ResponsesUsage","description":"Token usage for a Responses-API response."},"RestartAgentSwarmProjectResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"restarted_at":{"type":"string","title":"Restarted At"},"estimated_completion":{"type":"string","title":"Estimated Completion"}},"type":"object","required":["project_id","status","message","restarted_at","estimated_completion"],"title":"RestartAgentSwarmProjectResponse"},"RestartPostgresResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"deployment_id":{"type":"string","title":"Deployment Id"}},"type":"object","required":["success","message","deployment_id"],"title":"RestartPostgresResponse"},"RestorePostgresBackupResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"backup_id":{"type":"string","title":"Backup Id"}},"type":"object","required":["success","message","backup_id"],"title":"RestorePostgresBackupResponse"},"RestoreSnapshotResponse":{"properties":{"status":{"type":"string","title":"Status","description":"not_found | error | success/failed (from archive extraction)"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"restoration_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Restoration Id"},"snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Id"},"snapshot_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Name"},"target_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Path"},"backup_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backup Path"},"files_restored":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Files Restored"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["status"],"title":"RestoreSnapshotResponse","description":"Response for POST /snapshots/restore (SnapshotSystem.restore_snapshot)."},"RetentionCurveResponse":{"properties":{"video_id":{"type":"string","format":"uuid","title":"Video Id"},"date":{"type":"string","format":"date","title":"Date"},"retention_data":{"items":{"type":"number"},"type":"array","title":"Retention Data","description":"Retention percentages at each interval"},"interval_seconds":{"type":"integer","title":"Interval Seconds"},"avg_retention":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Retention"},"drop_off_points":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Drop Off Points"},"total_views":{"type":"integer","title":"Total Views"}},"type":"object","required":["video_id","date","retention_data","interval_seconds","avg_retention","drop_off_points","total_views"],"title":"RetentionCurveResponse","description":"Retention curve response"},"RetentionPoint":{"properties":{"minute":{"type":"integer","minimum":0,"title":"Minute","description":"Minutes from stream start"},"retention_percentage":{"type":"number","maximum":100,"minimum":0,"title":"Retention Percentage","description":"Percentage of viewers still watching"},"viewer_count":{"type":"integer","minimum":0,"title":"Viewer Count","description":"Number of viewers at this point"}},"type":"object","required":["minute","retention_percentage","viewer_count"],"title":"RetentionPoint","description":"Single point in viewer retention curve","example":{"minute":30,"retention_percentage":72.5,"viewer_count":87}},"RetryAgentSwarmProjectResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"workflow_db_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Db Id"}},"type":"object","required":["project_id","status"],"title":"RetryAgentSwarmProjectResponse"},"RevenueAnalyticsResponse":{"properties":{"total_revenue":{"type":"number","minimum":0,"title":"Total Revenue","description":"Total lifetime revenue"},"this_month_revenue":{"type":"number","minimum":0,"title":"This Month Revenue","description":"Revenue this month"},"last_month_revenue":{"type":"number","minimum":0,"title":"Last Month Revenue","description":"Revenue last month"},"revenue_sources":{"$ref":"#/components/schemas/RevenueSource","description":"Breakdown by revenue source"},"top_supporters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Supporters","description":"Top supporters list"},"note":{"type":"string","title":"Note","description":"Note about feature availability"}},"type":"object","required":["total_revenue","this_month_revenue","last_month_revenue","revenue_sources","note"],"title":"RevenueAnalyticsResponse","description":"Revenue analytics (placeholder for future monetization)","example":{"last_month_revenue":0,"note":"Revenue tracking coming soon with monetization features","revenue_sources":{"ads":0,"donations":0,"other":0,"subscriptions":0},"this_month_revenue":0,"top_supporters":[],"total_revenue":0}},"RevenueBreakdownResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"transaction_count":{"type":"integer","title":"Transaction Count"},"total_volume_usd":{"type":"number","title":"Total Volume Usd"},"owner_earnings_usd":{"type":"number","title":"Owner Earnings Usd"},"platform_fees_usd":{"type":"number","title":"Platform Fees Usd"},"referral_payouts_usd":{"type":"number","title":"Referral Payouts Usd"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End"}},"type":"object","required":["user_id","transaction_count","total_volume_usd","owner_earnings_usd","platform_fees_usd","referral_payouts_usd"],"title":"RevenueBreakdownResponse"},"RevenueDaily":{"properties":{"date":{"type":"string","format":"date","title":"Date","description":"Date for metrics"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","default":0},"revenue":{"type":"string","title":"Revenue","default":0},"fill_rate":{"type":"number","maximum":1,"minimum":0,"title":"Fill Rate","default":0}},"type":"object","required":["date"],"title":"RevenueDaily","description":"Daily revenue metrics for time series"},"RevenueReportResponse":{"properties":{"total_revenue":{"type":"string","title":"Total Revenue","description":"Total platform revenue","default":"0.00"},"total_platform_share":{"type":"string","title":"Total Platform Share","description":"Total platform share","default":"0.00"},"total_organizer_payouts":{"type":"string","title":"Total Organizer Payouts","description":"Total organizer payouts","default":"0.00"},"pending_balances":{"type":"string","title":"Pending Balances","description":"Pending organizer balances","default":"0.00"},"by_event":{"anyOf":[{"items":{"$ref":"#/components/schemas/EventRevenue"},"type":"array"},{"type":"null"}],"title":"By Event","description":"Revenue by event"},"by_sponsor":{"anyOf":[{"items":{"$ref":"#/components/schemas/SponsorRevenue"},"type":"array"},{"type":"null"}],"title":"By Sponsor","description":"Revenue by sponsor"},"by_date":{"anyOf":[{"items":{"$ref":"#/components/schemas/DailyRevenue"},"type":"array"},{"type":"null"}],"title":"By Date","description":"Revenue by date"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date","description":"Start date filter"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date","description":"End date filter"},"generated_at":{"type":"string","format":"date-time","title":"Generated At","description":"Report generation timestamp"}},"type":"object","required":["generated_at"],"title":"RevenueReportResponse","description":"Revenue report response"},"RevenueSource":{"properties":{"subscriptions":{"type":"number","minimum":0,"title":"Subscriptions","description":"Revenue from subscriptions"},"donations":{"type":"number","minimum":0,"title":"Donations","description":"Revenue from donations"},"ads":{"type":"number","minimum":0,"title":"Ads","description":"Revenue from ads"},"other":{"type":"number","minimum":0,"title":"Other","description":"Other revenue sources"}},"type":"object","required":["subscriptions","donations","ads","other"],"title":"RevenueSource","description":"Revenue breakdown by source","example":{"ads":0,"donations":0,"other":0,"subscriptions":0}},"RevenueSummaryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["success","data"],"title":"RevenueSummaryResponse","description":"`data.stripe` / `data.mercury` are genuinely conditional dicts\n(each API call independently adds/omits keys, or adds an `error`\nkey on partial failure), so they stay Dict[str, Any] rather than a\nstrict sub-model to preserve the exact current key set."},"ReviewListResponse":{"properties":{"reviews":{"items":{"$ref":"#/components/schemas/ReviewRecord"},"type":"array","title":"Reviews"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["reviews","count"],"title":"ReviewListResponse"},"ReviewRecord":{"properties":{"id":{"title":"Id"},"agent_id":{"title":"Agent Id"},"owner_id":{"title":"Owner Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"context":{"anyOf":[{},{"type":"null"}],"title":"Context"},"status":{"type":"string","title":"Status"},"decided_by":{"anyOf":[{},{"type":"null"}],"title":"Decided By"},"decision_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decision Comment"},"decided_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decided At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","agent_id","owner_id","title","status"],"title":"ReviewRecord","description":"A full review row (see AgentReviewService._row_to_dict)."},"ReviewRequest":{"properties":{"typed_text":{"type":"string","title":"Typed Text","description":"Must exactly equal \"REVIEWED\""}},"type":"object","required":["typed_text"],"title":"ReviewRequest"},"RevocationRequest":{"properties":{"token":{"type":"string","title":"Token","description":"The token to revoke"}},"type":"object","required":["token"],"title":"RevocationRequest","description":"RFC 7009 token revocation request."},"RevocationResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'ok' per RFC 7009","default":"ok"}},"type":"object","title":"RevocationResponse","description":"Response for POST /token/revoke (RFC 7009). Refs #8449.\n\nRFC 7009 requires a 200 regardless of whether the token was found, and the\nbody is a bare acknowledgement. It carries NO token field by design: the\nrequest body holds a live bearer token, and echoing it into a response\nwould spread it to logs, proxies and browser history."},"RevokePermissionResponse":{"properties":{"revoked":{"type":"boolean","title":"Revoked"}},"type":"object","required":["revoked"],"title":"RevokePermissionResponse"},"RevokeRefResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always \"revoked\" on success"},"ref_id":{"type":"string","title":"Ref Id","description":"The ref that was revoked"}},"type":"object","required":["status","ref_id"],"title":"RevokeRefResponse","description":"Returned by DELETE /{ref_id}. A plain acknowledgement -- `status` is the\nliteral string \"revoked\" (the handler 404s instead of returning any other\nstatus), and `ref_id` echoes the path parameter.\nRefs #8449"},"RevokeRequest":{"properties":{"token":{"type":"string","title":"Token","description":"Token to revoke (access or refresh)"},"token_type_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Type Hint","description":"Optional hint: 'access_token' or 'refresh_token'"}},"type":"object","required":["token"],"title":"RevokeRequest","description":"POST /v1/oauth/revoke request body."},"RevokeResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"RevokeResponse","description":"POST /v1/oauth/revoke response (RFC 7009: always 200)."},"RisingStream":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status"},"viewer_count":{"type":"integer","minimum":0,"title":"Viewer Count"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"growth_rate":{"type":"number","minimum":0,"title":"Growth Rate","description":"Viewers per minute (viewer_count / minutes_streaming)"},"streamer":{"$ref":"#/components/schemas/StreamerInfo"}},"type":"object","required":["id","title","status","viewer_count","started_at","growth_rate","streamer"],"title":"RisingStream","description":"Rising stream from emerging creator with growth metrics","example":{"description":"Learning FastAPI and building my first API","growthRate":2.17,"id":"987e6543-e21b-12d3-a456-426614174000","startedAt":"2024-01-15T14:30:00Z","status":"live","streamer":{"avatarUrl":"https://example.com/avatar.jpg","displayName":"Emerging Dev","followerCount":450,"id":"550e8400-e29b-41d4-a716-446655440000","isVerified":false,"username":"emerging_dev"},"title":"First Coding Stream - Building a Web App","viewerCount":65}},"RisingStreamer":{"properties":{"stream":{"$ref":"#/components/schemas/StreamResponse"},"growth_rate":{"type":"number","minimum":0,"title":"Growth Rate","description":"Viewer growth rate (0.0-1.0 = 0-100%)"},"total_stream_hours":{"type":"number","minimum":0,"title":"Total Stream Hours","description":"Total hours streamed (lifetime)"}},"type":"object","required":["stream","growth_rate","total_stream_hours"],"title":"RisingStreamer","description":"Rising/new streamer with growth metrics","example":{"growth_rate":0.65,"stream":{"id":"987e6543-e21b-12d3-a456-426614174000","status":"live","streamer":{"display_name":"New Streamer","follower_count":23,"id":"550e8400-e29b-41d4-a716-446655440000","is_verified":false,"username":"newstreamer"},"title":"First Stream - Learning FastAPI","viewer_count":45},"total_stream_hours":12.5}},"RisingStreamersResponse":{"properties":{"streamers":{"items":{"$ref":"#/components/schemas/RisingStreamer"},"type":"array","title":"Streamers"},"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id","description":"Category filter applied (if any)"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Number of rising streamers returned"}},"type":"object","required":["streamers","total"],"title":"RisingStreamersResponse","description":"List of rising/new streamers","example":{"streamers":[{"growth_rate":0.65,"stream":{"id":"987e6543-e21b-12d3-a456-426614174000","title":"First coding stream!","viewer_count":45},"total_stream_hours":12.5}],"total":8}},"RisingStreamsResponse":{"properties":{"streams":{"items":{"$ref":"#/components/schemas/RisingStream"},"type":"array","title":"Streams"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Number of rising streams returned"},"limit":{"type":"integer","maximum":50,"minimum":1,"title":"Limit","description":"Maximum streams per page"}},"type":"object","required":["streams","total","limit"],"title":"RisingStreamsResponse","description":"List of rising streams from emerging creators","example":{"limit":10,"streams":[{"growthRate":2.5,"id":"987e6543-e21b-12d3-a456-426614174000","status":"live","streamer":{"displayName":"New Creator","followerCount":350,"username":"new_creator"},"title":"Fast Growing Stream","viewerCount":75}],"total":12}},"RiskFactor":{"properties":{"probability":{"type":"string","title":"Probability"},"impact":{"type":"string","title":"Impact"},"mitigation":{"type":"string","title":"Mitigation"}},"type":"object","required":["probability","impact","mitigation"],"title":"RiskFactor"},"RiskScoreResult":{"properties":{"composite_score":{"type":"number","maximum":100,"minimum":0,"title":"Composite Score"},"components":{"additionalProperties":true,"type":"object","title":"Components"},"lat":{"type":"number","title":"Lat"},"lng":{"type":"number","title":"Lng"},"source":{"type":"string","title":"Source","default":"computed"},"generated_at":{"type":"string","title":"Generated At","default":""},"historical_data":{"items":{},"type":"array","title":"Historical Data"}},"type":"object","required":["composite_score","lat","lng"],"title":"RiskScoreResult"},"RlhfDatasetsStubResponse":{"properties":{"datasets":{"items":{},"type":"array","title":"Datasets"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["datasets","total","message"],"title":"RlhfDatasetsStubResponse","description":"Response for GET /rlhf/datasets."},"RolesResponse":{"properties":{"roles":{"items":{"type":"string"},"type":"array","title":"Roles"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"}},"type":"object","required":["roles","permissions"],"title":"RolesResponse","description":"Response for GET /roles."},"RollbackDeploymentResponse":{"properties":{"status":{"type":"string","title":"Status"},"rollback_result":{"additionalProperties":true,"type":"object","title":"Rollback Result"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","rollback_result","timestamp"],"title":"RollbackDeploymentResponse","description":"Response for POST /railway-deployment/deployment/{deployment_id}/rollback."},"RollbackHistoryItem":{"properties":{"rollback_id":{"type":"string","title":"Rollback Id"},"deployment_id":{"type":"string","title":"Deployment Id"},"reason":{"type":"string","title":"Reason"},"rolled_back_at":{"type":"string","title":"Rolled Back At"}},"type":"object","required":["rollback_id","deployment_id","reason","rolled_back_at"],"title":"RollbackHistoryItem"},"RollbackRequest":{"properties":{"target_version":{"type":"integer","minimum":1,"title":"Target Version","description":"Scaffold version to roll back to"}},"type":"object","required":["target_version"],"title":"RollbackRequest"},"RollbackResponse":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"message":{"type":"string","title":"Message"},"deployment_result":{"additionalProperties":true,"type":"object","title":"Deployment Result"},"rolled_back_by":{"type":"string","title":"Rolled Back By"}},"type":"object","required":["prompt_id","message","deployment_result","rolled_back_by"],"title":"RollbackResponse"},"RootResponse":{"properties":{"message":{"type":"string","title":"Message"},"status":{"type":"string","title":"Status"},"openapi":{"type":"string","title":"Openapi"},"docs":{"type":"string","title":"Docs"},"authorization_server":{"type":"string","title":"Authorization Server"},"version":{"type":"string","title":"Version"}},"type":"object","required":["message","status","openapi","docs","authorization_server","version"],"title":"RootResponse","description":"Response for the API root discovery endpoint (Refs #7811)."},"RotateCredentialRequest":{"properties":{"new_value":{"type":"string","maxLength":8192,"minLength":1,"title":"New Value"}},"type":"object","required":["new_value"],"title":"RotateCredentialRequest","description":"Request body for POST /api/v1/cloud/credentials/{id}/rotate."},"RotateCredentialResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"masked_value":{"type":"string","title":"Masked Value"},"rotated_at":{"type":"string","title":"Rotated At"}},"type":"object","required":["id","name","masked_value","rotated_at"],"title":"RotateCredentialResponse"},"RotatePostgresCredentialsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"connection":{"$ref":"#/components/schemas/PostgresRotatedConnection"}},"type":"object","required":["success","message","connection"],"title":"RotatePostgresCredentialsResponse"},"RotateRequest":{"properties":{"api_key":{"type":"string","minLength":1,"title":"Api Key"}},"type":"object","required":["api_key"],"title":"RotateRequest"},"RotateSecretResponse":{"properties":{"id":{"type":"string","title":"Id"},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_secret":{"type":"string","title":"Client Secret"}},"type":"object","required":["id","client_secret"],"title":"RotateSecretResponse","description":"Response for POST /clients/{id}/rotate-secret. Secret shown only once."},"RotateViaRefRequest":{"properties":{"credential_id":{"type":"string","title":"Credential Id","description":"Vault credential ID to rotate"},"new_value":{"type":"string","maxLength":8192,"minLength":1,"title":"New Value"}},"type":"object","required":["credential_id","new_value"],"title":"RotateViaRefRequest","description":"Request body for POST /api/v1/cloud/credentials/refs/rotate."},"RotateViaRefResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"masked_value":{"type":"string","title":"Masked Value"},"rotated_at":{"type":"string","title":"Rotated At"},"active_refs":{"type":"integer","title":"Active Refs"}},"type":"object","required":["id","name","masked_value","rotated_at","active_refs"],"title":"RotateViaRefResponse"},"RouteRegistrationStatusResponse":{"properties":{"registered_count":{"type":"integer","title":"Registered Count"},"failed_count":{"type":"integer","title":"Failed Count"},"failed":{"items":{"$ref":"#/components/schemas/FailedRouterInfo"},"type":"array","title":"Failed"},"registered_modules":{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array","title":"Registered Modules"}},"type":"object","required":["registered_count","failed_count","failed","registered_modules"],"title":"RouteRegistrationStatusResponse","description":"GET /api/v1/public/health/routes"},"RouteRequest":{"properties":{"agent_id":{"type":"string","maxLength":255,"minLength":1,"title":"Agent Id"},"workload_type":{"type":"string","maxLength":100,"minLength":1,"title":"Workload Type"},"estimated_memory_mb":{"type":"integer","maximum":4096,"minimum":1,"title":"Estimated Memory Mb","default":64},"estimated_duration_seconds":{"type":"integer","maximum":3600,"minimum":1,"title":"Estimated Duration Seconds","default":5},"requires_file_system":{"type":"boolean","title":"Requires File System","default":false},"requires_network":{"type":"boolean","title":"Requires Network","default":true},"tool_names":{"items":{"type":"string"},"type":"array","title":"Tool Names"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["agent_id","workload_type"],"title":"RouteRequest"},"RouteResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"tier":{"type":"string","title":"Tier"},"reason":{"type":"string","title":"Reason"},"workload_type":{"type":"string","title":"Workload Type"},"estimated_memory_mb":{"type":"integer","title":"Estimated Memory Mb"},"override_applied":{"type":"boolean","title":"Override Applied"},"decided_at":{"type":"string","title":"Decided At"}},"type":"object","required":["id","agent_id","tier","reason","workload_type","estimated_memory_mb","override_applied","decided_at"],"title":"RouteResponse"},"RouterRegistrationSummary":{"properties":{"total":{"type":"integer","title":"Total"},"registered":{"type":"integer","title":"Registered"},"failed":{"type":"integer","title":"Failed"},"success_rate":{"type":"string","title":"Success Rate"}},"type":"object","required":["total","registered","failed","success_rate"],"title":"RouterRegistrationSummary"},"RouterStatusDebugResponse":{"properties":{"status":{"type":"string","title":"Status"},"registration_summary":{"$ref":"#/components/schemas/RouterRegistrationSummary"},"registered_routers":{"items":{"$ref":"#/components/schemas/RegisteredRouterInfo"},"type":"array","title":"Registered Routers"},"failed_routers":{"items":{"$ref":"#/components/schemas/FailedRouterInfo"},"type":"array","title":"Failed Routers"}},"type":"object","required":["status","registration_summary","registered_routers","failed_routers"],"title":"RouterStatusDebugResponse","description":"GET /api/v1/public/debug/router-status"},"RsvpRequest":{"properties":{"event_id":{"type":"string","minLength":1,"title":"Event Id"},"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["event_id","email"],"title":"RsvpRequest"},"RsvpStatusResponse":{"properties":{"event_id":{"type":"string","title":"Event Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","required":["event_id"],"title":"RsvpStatusResponse"},"RulesFileDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"content":{"type":"string","title":"Content"},"parsed_rules":{"title":"Parsed Rules"},"uploaded_at":{"type":"string","title":"Uploaded At"},"status":{"type":"string","title":"Status"},"is_active":{"type":"boolean","title":"Is Active"},"rules_count":{"type":"integer","title":"Rules Count"},"validation_errors":{"items":{},"type":"array","title":"Validation Errors"}},"type":"object","required":["id","filename","content","parsed_rules","uploaded_at","status","is_active","rules_count","validation_errors"],"title":"RulesFileDetailResponse"},"RulesFileListItem":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"content":{"type":"string","title":"Content"},"parsed_rules":{"title":"Parsed Rules"},"uploaded_at":{"type":"string","title":"Uploaded At"},"status":{"type":"string","title":"Status"},"is_active":{"type":"boolean","title":"Is Active"},"rules_count":{"type":"integer","title":"Rules Count"}},"type":"object","required":["id","filename","content","parsed_rules","uploaded_at","status","is_active","rules_count"],"title":"RulesFileListItem"},"RulesFileResponse":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"content":{"type":"string","title":"Content"},"parsed_rules":{"title":"Parsed Rules"},"uploaded_at":{"type":"string","title":"Uploaded At"},"status":{"type":"string","title":"Status"},"validation_errors":{"items":{},"type":"array","title":"Validation Errors"},"rules_count":{"type":"integer","title":"Rules Count"}},"type":"object","required":["id","filename","content","parsed_rules","uploaded_at","status","validation_errors","rules_count"],"title":"RulesFileResponse"},"RulesUploadRequest":{"properties":{"filename":{"type":"string","title":"Filename","description":"Name of the rules file"},"content":{"type":"string","title":"Content","description":"Content of the rules file"}},"type":"object","required":["filename","content"],"title":"RulesUploadRequest","description":"Request to upload a rules file"},"RunAbTestResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"template_id":{"type":"string","title":"Template Id"},"version_a_id":{"type":"string","title":"Version A Id"},"version_b_id":{"type":"string","title":"Version B Id"}},"type":"object","required":["status","message","template_id","version_a_id","version_b_id"],"title":"RunAbTestResponse"},"RunDebugAnalyticsMigrationResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"tables_created":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Tables Created"},"deployment_environments_count":{"type":"integer","title":"Deployment Environments Count"},"admin_user":{"type":"string","title":"Admin User"}},"type":"object","required":["status","message","tables_created","deployment_environments_count","admin_user"],"title":"RunDebugAnalyticsMigrationResponse","description":"Response for POST /admin/run-migration/run-debug-analytics-migration."},"RunEvalRequest":{"properties":{"model":{"type":"string","title":"Model","description":"Model name to score, as registered in inference_router (e.g. 'glm-5.2', a fine-tune slug, or 'qwen3-4b')."},"base_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Url","description":"OpenAI-compatible inference base URL. Defaults to the DigitalOcean inference endpoint when omitted."},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories","description":"Optional subset of EvalCategory values to run. Runs all seed tasks when omitted."}},"type":"object","required":["model"],"title":"RunEvalRequest"},"RunEvalResponse":{"properties":{"model":{"type":"string","title":"Model"},"total":{"type":"integer","title":"Total"},"passed":{"type":"integer","title":"Passed"},"score":{"type":"number","title":"Score"},"by_category":{"additionalProperties":{"additionalProperties":{"type":"integer"},"type":"object"},"type":"object","title":"By Category"},"outcomes":{"items":{"$ref":"#/components/schemas/TaskOutcomeModel"},"type":"array","title":"Outcomes"}},"type":"object","required":["model","total","passed","score","by_category","outcomes"],"title":"RunEvalResponse"},"RunHealthChecksResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/HealthCheckResult"},"type":"array","title":"Results"},"summary":{"$ref":"#/components/schemas/HealthCheckResultsSummary"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["results","summary","timestamp"],"title":"RunHealthChecksResponse","description":"GET /deployment/health-checks/run — a fresh on-demand health check run."},"SLABreachListResponse":{"properties":{"breaches":{"items":{"$ref":"#/components/schemas/SLABreachRecord"},"type":"array","title":"Breaches"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["breaches","total"],"title":"SLABreachListResponse"},"SLABreachRecord":{"properties":{"id":{"type":"string","title":"Id"},"deployment_id":{"type":"string","title":"Deployment Id"},"metric":{"type":"string","title":"Metric"},"observed_value":{"type":"number","title":"Observed Value"},"threshold_value":{"type":"number","title":"Threshold Value"},"breached_at":{"type":"string","title":"Breached At"}},"type":"object","required":["id","deployment_id","metric","observed_value","threshold_value","breached_at"],"title":"SLABreachRecord"},"SLABreachRequest":{"properties":{"metric":{"type":"string","enum":["ttft","throughput","concurrency"],"title":"Metric"},"observed_value":{"type":"number","title":"Observed Value","description":"The observed metric value"},"threshold_value":{"type":"number","title":"Threshold Value","description":"The configured threshold that was breached"}},"type":"object","required":["metric","observed_value","threshold_value"],"title":"SLABreachRequest"},"SLABreachResponse":{"properties":{"notified":{"type":"boolean","title":"Notified"}},"type":"object","required":["notified"],"title":"SLABreachResponse"},"SLAConfigRequest":{"properties":{"target_ttft_ms":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Target Ttft Ms","description":"Target time-to-first-token in ms"},"target_throughput_tps":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Target Throughput Tps","description":"Target throughput in tokens/sec"},"max_concurrency":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"title":"Max Concurrency","description":"Max concurrent requests (1-100)"},"breach_alert_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Breach Alert Email","description":"Email to notify on SLA breach"},"breach_webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Breach Webhook Url","description":"Webhook URL to POST on SLA breach"}},"type":"object","title":"SLAConfigRequest"},"SLAConfigResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"target_ttft_ms":{"type":"integer","title":"Target Ttft Ms","default":500},"target_throughput_tps":{"type":"number","title":"Target Throughput Tps","default":100},"max_concurrency":{"type":"integer","title":"Max Concurrency","default":10},"breach_alert_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Breach Alert Email"},"breach_webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Breach Webhook Url"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["deployment_id"],"title":"SLAConfigResponse"},"SLAStatusResponse":{"properties":{"status":{"type":"string","enum":["passing","breaching","unknown"],"title":"Status"},"ttft_p95_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ttft P95 Ms"},"throughput_tps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Throughput Tps"}},"type":"object","required":["status"],"title":"SLAStatusResponse"},"SOC2EvidenceResponse":{"properties":{"period":{"additionalProperties":{"type":"string"},"type":"object","title":"Period"},"access_controls":{"$ref":"#/components/schemas/AccessControlsEvidence"},"session_management":{"$ref":"#/components/schemas/SessionManagementEvidence"},"approval_gates":{"$ref":"#/components/schemas/ApprovalGatesEvidence"},"audit_log":{"$ref":"#/components/schemas/AuditLogEvidence"},"memory_isolation":{"$ref":"#/components/schemas/MemoryIsolationEvidence"}},"type":"object","required":["period","access_controls","session_management","approval_gates","audit_log","memory_isolation"],"title":"SOC2EvidenceResponse","description":"Aggregated SOC2 Type II evidence package for the requested date range.\n\nCovers:\n - CC6: Logical access controls (agent API keys)\n - CC7: System monitoring (audit log)\n - A1: Availability (agent sessions / dead-man switch)\n - C1: Confidentiality (memory namespace isolation)\n - PI1: Processing integrity (approval gates)\n\nRefs #2890"},"SQLQueryRequest":{"properties":{"sql":{"type":"string","maxLength":50000,"minLength":1,"title":"Sql","description":"SQL query to execute"},"timeout_seconds":{"type":"integer","maximum":300,"minimum":1,"title":"Timeout Seconds","description":"Query timeout in seconds","default":30},"read_only":{"type":"boolean","title":"Read Only","description":"Execute in read-only mode","default":false},"max_rows":{"type":"integer","maximum":10000,"minimum":1,"title":"Max Rows","description":"Maximum rows to return","default":1000}},"type":"object","required":["sql"],"title":"SQLQueryRequest","description":"Request model for SQL query execution","example":{"max_rows":1000,"read_only":false,"sql":"SELECT * FROM users LIMIT 10;","timeout_seconds":30}},"SQLQueryResponse":{"properties":{"query_id":{"type":"string","title":"Query Id","description":"Unique query execution ID"},"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"query_type":{"type":"string","enum":["SELECT","INSERT","UPDATE","DELETE","CREATE","ALTER","DROP","OTHER"],"title":"Query Type","description":"Type of SQL query"},"success":{"type":"boolean","title":"Success","description":"Query execution success status"},"execution_time_ms":{"type":"number","minimum":0,"title":"Execution Time Ms","description":"Query execution time in milliseconds"},"rows_affected":{"type":"integer","minimum":0,"title":"Rows Affected","description":"Number of rows affected by the query","default":0},"rows_returned":{"type":"integer","minimum":0,"title":"Rows Returned","description":"Number of rows returned","default":0},"columns":{"items":{"type":"string"},"type":"array","title":"Columns","description":"Column names in result set","default":[]},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data","description":"Query result data","default":[]},"credits_consumed":{"type":"integer","minimum":0,"title":"Credits Consumed","description":"Credits consumed for this query","default":0},"truncated":{"type":"boolean","title":"Truncated","description":"Whether results were truncated due to max_rows limit","default":false},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if query failed"},"executed_at":{"type":"string","format":"date-time","title":"Executed At","description":"Query execution timestamp"}},"type":"object","required":["query_id","project_id","query_type","success","execution_time_ms"],"title":"SQLQueryResponse","description":"Response model for SQL query execution","example":{"columns":["id","name","email"],"credits_consumed":1,"data":[{"email":"john@example.com","id":1,"name":"John Doe"}],"executed_at":"2025-12-03T10:00:00Z","execution_time_ms":45.2,"project_id":"proj_xyz789","query_id":"qry_abc123","query_type":"SELECT","rows_affected":0,"rows_returned":10,"success":true,"truncated":false}},"SQLValidationRequest":{"properties":{"sql":{"type":"string","minLength":1,"title":"Sql","description":"SQL query to validate"}},"type":"object","required":["sql"],"title":"SQLValidationRequest","description":"Request model for SQL validation","example":{"sql":"SELECT * FROM users WHERE id = 1"}},"SQLValidationResponse":{"properties":{"valid":{"type":"boolean","title":"Valid","description":"Whether the SQL is valid"},"query_type":{"type":"string","title":"Query Type","description":"Detected query type"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","description":"List of warnings","default":[]},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","description":"List of errors","default":[]},"is_dangerous":{"type":"boolean","title":"Is Dangerous","description":"Whether query is potentially dangerous","default":false},"danger_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Danger Reason","description":"Reason for danger flag"}},"type":"object","required":["valid","query_type"],"title":"SQLValidationResponse","description":"Response model for SQL validation","example":{"errors":[],"is_dangerous":false,"query_type":"SELECT","valid":true,"warnings":[]}},"SSOConfigCreate":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id","description":"UUID of the tenant"},"protocol":{"$ref":"#/components/schemas/SSOProtocol","description":"SSO protocol: saml or oidc"},"idp_entity_id":{"type":"string","maxLength":512,"minLength":1,"title":"Idp Entity Id","description":"IdP entity identifier"},"idp_sso_url":{"type":"string","maxLength":1024,"minLength":1,"title":"Idp Sso Url","description":"IdP SSO endpoint URL"},"idp_certificate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idp Certificate","description":"IdP X.509 signing certificate (PEM, for SAML)"},"oidc_client_id":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Oidc Client Id","description":"OIDC client ID"},"oidc_client_secret":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Oidc Client Secret","description":"OIDC client secret"},"oidc_discovery_url":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Oidc Discovery Url","description":"OIDC well-known discovery URL"},"oidc_scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Oidc Scopes","description":"OIDC scopes","default":["openid","email","profile"]},"default_role":{"type":"string","title":"Default Role","description":"Default role for JIT-provisioned users","default":"MEMBER"},"enforce_for_domains":{"items":{"type":"string"},"type":"array","title":"Enforce For Domains","description":"Email domains that require SSO"},"attribute_mapping":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Attribute Mapping","description":"Map IdP attributes to user fields (e.g. {'email': 'urn:oid:...'})"},"auto_provision":{"type":"boolean","title":"Auto Provision","description":"JIT-provision users on first SSO login","default":true}},"type":"object","required":["tenant_id","protocol","idp_entity_id","idp_sso_url"],"title":"SSOConfigCreate","description":"Request body to create an SSO configuration for a tenant."},"SSOConfigResponse":{"properties":{"id":{"type":"string","title":"Id"},"tenant_id":{"type":"string","title":"Tenant Id"},"protocol":{"type":"string","title":"Protocol"},"idp_entity_id":{"type":"string","title":"Idp Entity Id"},"idp_sso_url":{"type":"string","title":"Idp Sso Url"},"default_role":{"type":"string","title":"Default Role"},"enforce_for_domains":{"items":{"type":"string"},"type":"array","title":"Enforce For Domains"},"attribute_mapping":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Attribute Mapping"},"auto_provision":{"type":"boolean","title":"Auto Provision"},"status":{"type":"string","title":"Status"},"oidc_scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Oidc Scopes"},"oidc_discovery_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oidc Discovery Url"},"oidc_client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oidc Client Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"last_tested_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Tested At"}},"type":"object","required":["id","tenant_id","protocol","idp_entity_id","idp_sso_url","default_role","enforce_for_domains","attribute_mapping","auto_provision","status"],"title":"SSOConfigResponse"},"SSOConfigUpdate":{"properties":{"idp_entity_id":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Idp Entity Id"},"idp_sso_url":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Idp Sso Url"},"idp_certificate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idp Certificate"},"oidc_client_id":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Oidc Client Id"},"oidc_client_secret":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Oidc Client Secret"},"oidc_discovery_url":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Oidc Discovery Url"},"oidc_scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Oidc Scopes"},"default_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Role"},"enforce_for_domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Enforce For Domains"},"attribute_mapping":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Attribute Mapping"},"auto_provision":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Provision"},"status":{"anyOf":[{"$ref":"#/components/schemas/SSOStatus"},{"type":"null"}]}},"type":"object","title":"SSOConfigUpdate","description":"Request body to update an SSO configuration."},"SSODomainCheck":{"properties":{"email":{"type":"string","title":"Email"},"domain":{"type":"string","title":"Domain"},"sso_required":{"type":"boolean","title":"Sso Required"},"sso_login_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sso Login Url"},"protocol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Protocol"},"tenant_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Slug"}},"type":"object","required":["email","domain","sso_required"],"title":"SSODomainCheck"},"SSOProtocol":{"type":"string","enum":["saml","oidc"],"title":"SSOProtocol","description":"Request-side protocol selector.\n\nRefs #8683: the REAL stored values are uppercase (see\napp.models.sso.SSOProtocol and the ``ssoprotocol`` Postgres enum).\nThese lowercase members are the accepted request spellings only, and\nare always normalized through ``_to_db_protocol`` before reaching SQL.\nA lowercase literal in a WHERE clause silently matches nothing, and on\na native-enum column an INSERT of one raises\npsycopg2.errors.InvalidTextRepresentation."},"SSOStatus":{"type":"string","enum":["active","inactive","testing"],"title":"SSOStatus","description":"Request-side status selector -- see SSOProtocol's note. Refs #8683."},"SSOTestResult":{"properties":{"success":{"type":"boolean","title":"Success"},"protocol":{"type":"string","title":"Protocol"},"idp_reachable":{"type":"boolean","title":"Idp Reachable"},"certificate_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Certificate Valid"},"discovery_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Discovery Valid"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","protocol","idp_reachable","message"],"title":"SSOTestResult"},"SafeModeStatusResponse":{"properties":{"user_id":{"type":"string","title":"User Id","description":"User ID","example":"550e8400-e29b-41d4-a716-446655440000"},"safe_mode_enabled":{"type":"boolean","title":"Safe Mode Enabled","description":"Whether safe mode is currently enabled","example":true},"toxicity_threshold":{"type":"number","maximum":1,"minimum":0,"title":"Toxicity Threshold","description":"AI toxicity score threshold for filtering (0.0 - 1.0)","example":0.7},"filters_applied":{"items":{"type":"string"},"type":"array","title":"Filters Applied","description":"List of filters currently active","example":["nsfw_content","high_toxicity"]}},"type":"object","required":["user_id","safe_mode_enabled","toxicity_threshold"],"title":"SafeModeStatusResponse","description":"Response schema for safe mode status","example":{"filters_applied":["nsfw_content","high_toxicity"],"safe_mode_enabled":true,"toxicity_threshold":0.7,"user_id":"550e8400-e29b-41d4-a716-446655440000"}},"SafeModeToggleRequest":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Enable or disable safe mode","example":true}},"type":"object","required":["enabled"],"title":"SafeModeToggleRequest","description":"Request schema for toggling safe mode"},"SafeModeToggleResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the operation was successful","example":true},"message":{"type":"string","title":"Message","description":"Human-readable message","example":"Safe mode enabled successfully"},"safe_mode_enabled":{"type":"boolean","title":"Safe Mode Enabled","description":"New safe mode status","example":true}},"type":"object","required":["success","message","safe_mode_enabled"],"title":"SafeModeToggleResponse","description":"Response schema after toggling safe mode","example":{"message":"Safe mode enabled successfully","safe_mode_enabled":true,"success":true}},"SafeModeToggleResult":{"properties":{"success":{"type":"boolean","title":"Success"},"safe_mode_enabled":{"type":"boolean","title":"Safe Mode Enabled"},"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["success","safe_mode_enabled","message"],"title":"SafeModeToggleResult","description":"Response schema for PATCH /profiles/me/safe-mode.\n\nNamed distinctly from app.schemas.safe_mode.SafeModeToggleResponse, which\nbelongs to the separate /safe-mode endpoint module and carries a different\nfield set. ``extra=\"allow\"`` because the payload is a hand-built literal\nwith no redaction or permission filtering a passthrough key could bypass.\nRefs #8449."},"SafeModeUpdateRequest":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Enable or disable safe mode"}},"type":"object","required":["enabled"],"title":"SafeModeUpdateRequest","description":"Request schema for updating safe mode settings"},"SalesAgentChatRequest":{"properties":{"message":{"type":"string","maxLength":8000,"minLength":1,"title":"Message","description":"The sales rep's question or customer query to answer"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id","description":"Optional conversation ID for multi-turn context (unused in v1, reserved)"}},"type":"object","required":["message"],"title":"SalesAgentChatRequest","description":"Request body for the sales agent chat endpoint."},"SalesAgentChatResponse":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"message":{"type":"string","title":"Message"},"model":{"type":"string","title":"Model"}},"type":"object","required":["conversation_id","message","model"],"title":"SalesAgentChatResponse","description":"Response from the sales agent."},"SampleFeedback":{"properties":{"rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment"},"feedback_type":{"type":"string","title":"Feedback Type"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["feedback_type","created_at"],"title":"SampleFeedback","description":"Sample feedback entry"},"SandboxEndpoints":{"properties":{"api":{"type":"string","title":"Api","description":"Sandbox API endpoint URL"},"mcp":{"type":"string","title":"Mcp","description":"Sandbox MCP endpoint URL"}},"type":"object","required":["api","mcp"],"title":"SandboxEndpoints","description":"API/MCP endpoints exposed by a sandbox environment."},"SandboxEnvironmentCreateData":{"properties":{"id":{"type":"string","title":"Id","description":"Sandbox environment ID"},"name":{"type":"string","title":"Name","description":"Sandbox environment name"},"type":{"type":"string","title":"Type","description":"Environment type"},"status":{"type":"string","title":"Status","description":"Environment status"},"endpoints":{"$ref":"#/components/schemas/SandboxEndpoints"}},"type":"object","required":["id","name","type","status","endpoints"],"title":"SandboxEnvironmentCreateData","description":"Payload of a newly created sandbox environment."},"SandboxEnvironmentCreateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/SandboxEnvironmentCreateData"},"message":{"type":"string","title":"Message","description":"Human-readable confirmation message"}},"type":"object","required":["success","data","message"],"title":"SandboxEnvironmentCreateResponse","description":"Response for POST /sandbox/environments and POST /sandbox/create."},"SandboxEnvironmentSummary":{"properties":{"id":{"type":"string","title":"Id","description":"Sandbox environment ID"},"name":{"type":"string","title":"Name","description":"Sandbox environment name"},"type":{"type":"string","title":"Type","description":"Environment type, e.g. development/testing/staging"},"status":{"type":"string","title":"Status","description":"Environment status, e.g. active"},"endpoints":{"$ref":"#/components/schemas/SandboxEndpoints"}},"type":"object","required":["id","name","type","status","endpoints"],"title":"SandboxEnvironmentSummary","description":"A single sandbox environment, as returned in list responses."},"SandboxEnvironmentsData":{"properties":{"sandboxes":{"items":{"$ref":"#/components/schemas/SandboxEnvironmentSummary"},"type":"array","title":"Sandboxes"},"plan":{"type":"string","title":"Plan","description":"Effective plan used to compute the sandbox limit"},"limit":{"type":"integer","title":"Limit","description":"Maximum number of sandboxes allowed for this plan"},"usage":{"type":"integer","title":"Usage","description":"Number of sandbox environments currently provisioned"}},"type":"object","required":["sandboxes","plan","limit","usage"],"title":"SandboxEnvironmentsData","description":"Payload of the sandbox environments list response."},"SandboxEnvironmentsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/SandboxEnvironmentsData"}},"type":"object","required":["success","data"],"title":"SandboxEnvironmentsResponse","description":"Response for GET /sandbox/environments."},"SastResult":{"properties":{"tool":{"type":"string","title":"Tool"},"findings":{"items":{"$ref":"#/components/schemas/BanditFinding"},"type":"array","title":"Findings"},"status":{"type":"string","title":"Status"},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["tool","findings","status"],"title":"SastResult","description":"Bandit SAST scan sub-result."},"SaveAchDetailsRequest":{"properties":{"account_holder_name":{"type":"string","title":"Account Holder Name"},"routing_number":{"type":"string","title":"Routing Number"},"account_number":{"type":"string","title":"Account Number"},"account_type":{"type":"string","title":"Account Type"}},"type":"object","required":["account_holder_name","routing_number","account_number","account_type"],"title":"SaveAchDetailsRequest","description":"ACH bank-details form body."},"SaveAchDetailsResponse":{"properties":{"ach_details":{"$ref":"#/components/schemas/AchDetailsResponse"},"onboarding_percent_complete":{"type":"integer","title":"Onboarding Percent Complete"},"onboarding_is_complete":{"type":"boolean","title":"Onboarding Is Complete"},"show_completion_toast":{"type":"boolean","title":"Show Completion Toast"},"toast":{"anyOf":[{"$ref":"#/components/schemas/OnboardingCompleteToast"},{"type":"null"}]}},"type":"object","required":["ach_details","onboarding_percent_complete","onboarding_is_complete","show_completion_toast"],"title":"SaveAchDetailsResponse"},"SaveProfileRequest":{"properties":{"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"}},"type":"object","title":"SaveProfileRequest","description":"Personal profile body. Email is not accepted here -- it always comes\nfrom the authenticated identity, never a client-supplied value."},"SaveProfileResponse":{"properties":{"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"onboarding_percent_complete":{"type":"integer","title":"Onboarding Percent Complete","default":0},"onboarding_is_complete":{"type":"boolean","title":"Onboarding Is Complete","default":false},"show_completion_toast":{"type":"boolean","title":"Show Completion Toast","default":false},"toast":{"anyOf":[{"$ref":"#/components/schemas/ToastAction"},{"type":"null"}]}},"type":"object","title":"SaveProfileResponse"},"SaveSettingsRequest":{"properties":{"legal_name":{"type":"string","title":"Legal Name"},"ein":{"type":"string","title":"Ein"},"incorporation_date":{"type":"string","title":"Incorporation Date"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"address_line1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line1"},"address_line2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line2"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"signing_officer_name":{"type":"string","title":"Signing Officer Name"},"signing_officer_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signing Officer Title"}},"type":"object","required":["legal_name","ein","incorporation_date","signing_officer_name"],"title":"SaveSettingsRequest","description":"General settings body — company passport + signing officer."},"SaveSettingsResponse":{"properties":{"settings":{"$ref":"#/components/schemas/GeneralSettingsRecord"},"message":{"type":"string","title":"Message"},"onboarding_percent_complete":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Onboarding Percent Complete"},"onboarding_is_complete":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Onboarding Is Complete"}},"type":"object","required":["settings","message"],"title":"SaveSettingsResponse"},"ScaFinding":{"properties":{"package":{"type":"string","title":"Package"},"version":{"type":"string","title":"Version"},"vuln_id":{"type":"string","title":"Vuln Id"},"fix_versions":{"items":{"type":"string"},"type":"array","title":"Fix Versions"},"description":{"type":"string","title":"Description"}},"type":"object","required":["package","version","vuln_id","fix_versions","description"],"title":"ScaFinding","description":"A single pip-audit dependency vulnerability finding."},"ScaResult":{"properties":{"tool":{"type":"string","title":"Tool"},"findings":{"items":{"$ref":"#/components/schemas/ScaFinding"},"type":"array","title":"Findings"},"status":{"type":"string","title":"Status"},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["tool","findings","status"],"title":"ScaResult","description":"pip-audit SCA scan sub-result."},"ScaffoldVersionEntry":{"properties":{"version":{"type":"integer","title":"Version"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"rollback_from":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rollback From"},"rlhf_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rlhf Score"}},"type":"object","required":["version"],"title":"ScaffoldVersionEntry"},"ScaffoldVersionsResponse":{"properties":{"deployment_id":{"type":"string","format":"uuid","title":"Deployment Id"},"current_version":{"type":"integer","title":"Current Version"},"versions":{"items":{"$ref":"#/components/schemas/ScaffoldVersionEntry"},"type":"array","title":"Versions"}},"type":"object","required":["deployment_id","current_version","versions"],"title":"ScaffoldVersionsResponse"},"ScaffoldingDashboardResponse":{"properties":{"tools_status":{"items":{"$ref":"#/components/schemas/ToolStatus"},"type":"array","title":"Tools Status"},"recent_operations":{"items":{"$ref":"#/components/schemas/ScaffoldingResponse"},"type":"array","title":"Recent Operations"},"statistics":{"$ref":"#/components/schemas/ScaffoldingStatistics"}},"type":"object","required":["tools_status","recent_operations","statistics"],"title":"ScaffoldingDashboardResponse","description":"Response for GET /scaffolding-tools/dashboard."},"ScaffoldingOperationsResponse":{"properties":{"operations":{"items":{"$ref":"#/components/schemas/ScaffoldingResponse"},"type":"array","title":"Operations"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["operations","total"],"title":"ScaffoldingOperationsResponse","description":"Response for GET /scaffolding-tools/operations."},"ScaffoldingRequest":{"properties":{"tool":{"$ref":"#/components/schemas/ScaffoldingTool"},"project_name":{"type":"string","maxLength":100,"minLength":1,"title":"Project Name"},"project_type":{"$ref":"#/components/schemas/ProjectType"},"template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template"},"destination_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Path"},"options":{"additionalProperties":true,"type":"object","title":"Options"},"ai_enhancement":{"type":"boolean","title":"Ai Enhancement","default":true},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["tool","project_name","project_type"],"title":"ScaffoldingRequest","description":"Request model for scaffolding operations"},"ScaffoldingResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"status":{"$ref":"#/components/schemas/ScaffoldingStatus"},"tool":{"$ref":"#/components/schemas/ScaffoldingTool"},"project_name":{"type":"string","title":"Project Name"},"project_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Path"},"generated_files":{"items":{"type":"string"},"type":"array","title":"Generated Files"},"ai_enhancements":{"items":{"type":"string"},"type":"array","title":"Ai Enhancements"},"logs":{"items":{"type":"string"},"type":"array","title":"Logs"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["request_id","status","tool","project_name","created_at"],"title":"ScaffoldingResponse","description":"Response model for scaffolding operations"},"ScaffoldingStatistics":{"properties":{"total_operations":{"type":"integer","title":"Total Operations"},"successful_operations":{"type":"integer","title":"Successful Operations"},"failed_operations":{"type":"integer","title":"Failed Operations"},"in_progress_operations":{"type":"integer","title":"In Progress Operations"}},"type":"object","required":["total_operations","successful_operations","failed_operations","in_progress_operations"],"title":"ScaffoldingStatistics"},"ScaffoldingStatus":{"type":"string","enum":["pending","in_progress","completed","failed"],"title":"ScaffoldingStatus","description":"Status of scaffolding operations"},"ScaffoldingTool":{"type":"string","enum":["yeoman","create-t3-app","vite","wp-cli","create-react-app","nuxt","next"],"title":"ScaffoldingTool","description":"Available scaffolding tools"},"ScaleActionRequest":{"properties":{"replicas":{"type":"integer","maximum":100,"minimum":0,"title":"Replicas","description":"Target replica count (0 = scale to zero)"}},"type":"object","required":["replicas"],"title":"ScaleActionRequest"},"ScaleActionResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"name":{"type":"string","title":"Name"},"model_id":{"type":"string","title":"Model Id"},"gpu_type":{"type":"string","title":"Gpu Type"},"region":{"type":"string","title":"Region"},"replicas":{"type":"integer","title":"Replicas"},"status":{"type":"string","title":"Status"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["deployment_id","name","model_id","gpu_type","region","replicas","status"],"title":"ScaleActionResponse"},"ScalePostgresResponse":{"properties":{"status":{"type":"string","title":"Status"},"previous_tier":{"type":"string","title":"Previous Tier"},"new_tier":{"type":"string","title":"New Tier"},"monthly_cost_usd":{"type":"number","title":"Monthly Cost Usd"},"resources":{"additionalProperties":true,"type":"object","title":"Resources"},"project_id":{"type":"string","title":"Project Id"}},"type":"object","required":["status","previous_tier","new_tier","monthly_cost_usd","resources","project_id"],"title":"ScalePostgresResponse"},"ScaleRequest":{"properties":{"min_instances":{"type":"integer","maximum":10,"minimum":0,"title":"Min Instances"},"max_instances":{"type":"integer","maximum":50,"minimum":1,"title":"Max Instances"}},"type":"object","required":["min_instances","max_instances"],"title":"ScaleRequest"},"ScaleSwarmResponse":{"properties":{"message":{"type":"string","title":"Message"},"action":{"type":"string","title":"Action"},"previous_agents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous Agents"},"current_agents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Agents"},"new_agents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"New Agents"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"target_agents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Agents"}},"type":"object","required":["message","action"],"title":"ScaleSwarmResponse"},"ScaleThreshold":{"properties":{"cpu_percent":{"type":"integer","title":"Cpu Percent"},"memory_percent":{"type":"integer","title":"Memory Percent"},"response_time_ms":{"type":"integer","title":"Response Time Ms"},"error_rate_percent":{"type":"integer","title":"Error Rate Percent"}},"type":"object","required":["cpu_percent","memory_percent","response_time_ms","error_rate_percent"],"title":"ScaleThreshold"},"ScalingAction":{"type":"string","enum":["scale_up","scale_down","scale_to"],"title":"ScalingAction","description":"Type of scaling action"},"ScalingConfigRequest":{"properties":{"min_replicas":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Min Replicas","description":"Minimum replica count"},"max_replicas":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Max Replicas","description":"Maximum replica count"},"scale_to_zero":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Scale To Zero","description":"Allow scaling to zero replicas"},"cooldown_seconds":{"anyOf":[{"type":"integer","minimum":30},{"type":"null"}],"title":"Cooldown Seconds","description":"Cooldown between scale events (seconds)"}},"type":"object","title":"ScalingConfigRequest"},"ScalingConfigResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"min_replicas":{"type":"integer","title":"Min Replicas","default":1},"max_replicas":{"type":"integer","title":"Max Replicas","default":1},"scale_to_zero":{"type":"boolean","title":"Scale To Zero","default":false},"cooldown_seconds":{"type":"integer","title":"Cooldown Seconds","default":300},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["deployment_id"],"title":"ScalingConfigResponse"},"ScalingCurrentStatus":{"properties":{"database_size":{"type":"string","title":"Database Size"},"connection_utilization":{"type":"number","title":"Connection Utilization"},"cache_hit_ratio":{"type":"number","title":"Cache Hit Ratio"},"performance_level":{"type":"string","title":"Performance Level"}},"type":"object","required":["database_size","connection_utilization","cache_hit_ratio","performance_level"],"title":"ScalingCurrentStatus"},"ScalingEvent":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Event identifier"},"policy_id":{"type":"string","format":"uuid","title":"Policy Id","description":"Policy that triggered the event"},"agent_type":{"type":"string","title":"Agent Type","description":"Type of agent affected"},"trigger_type":{"$ref":"#/components/schemas/ScalingTrigger","description":"Type of trigger that caused the event"},"scaling_action":{"$ref":"#/components/schemas/ScalingAction","description":"Action taken"},"previous_count":{"type":"integer","minimum":0,"title":"Previous Count","description":"Previous instance count"},"new_count":{"type":"integer","minimum":0,"title":"New Count","description":"New instance count"},"reason":{"type":"string","title":"Reason","description":"Detailed reason for the scaling event"},"metrics_snapshot":{"additionalProperties":true,"type":"object","title":"Metrics Snapshot","description":"Snapshot of metrics at time of event"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"When the event occurred"},"executed_by":{"type":"string","title":"Executed By","description":"User or system that executed the event"}},"type":"object","required":["id","policy_id","agent_type","trigger_type","scaling_action","previous_count","new_count","reason","metrics_snapshot","timestamp","executed_by"],"title":"ScalingEvent","description":"Record of a scaling event"},"ScalingHistoryEvent":{"properties":{"id":{"type":"string","title":"Id"},"action":{"type":"string","title":"Action"},"trigger":{"type":"string","title":"Trigger"},"threshold_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Threshold Value"},"instances_affected":{"type":"integer","title":"Instances Affected"},"initiated_at":{"type":"string","title":"Initiated At"},"completed_at":{"type":"string","title":"Completed At"},"duration_seconds":{"type":"integer","title":"Duration Seconds"},"status":{"type":"string","title":"Status"},"reason":{"type":"string","title":"Reason"},"initiated_by":{"title":"Initiated By"}},"type":"object","required":["id","action","trigger","instances_affected","initiated_at","completed_at","duration_seconds","status","reason","initiated_by"],"title":"ScalingHistoryEvent"},"ScalingHistoryResponse":{"properties":{"scaling_events":{"items":{"$ref":"#/components/schemas/ScalingHistoryEvent"},"type":"array","title":"Scaling Events"},"total_events":{"type":"integer","title":"Total Events"},"summary":{"$ref":"#/components/schemas/ScalingHistorySummary"}},"type":"object","required":["scaling_events","total_events","summary"],"title":"ScalingHistoryResponse"},"ScalingHistorySummary":{"properties":{"scale_up_events":{"type":"integer","title":"Scale Up Events"},"scale_down_events":{"type":"integer","title":"Scale Down Events"},"manual_events":{"type":"integer","title":"Manual Events"},"automated_events":{"type":"integer","title":"Automated Events"},"success_rate":{"type":"number","title":"Success Rate"},"average_duration":{"type":"integer","title":"Average Duration"}},"type":"object","required":["scale_up_events","scale_down_events","manual_events","automated_events","success_rate","average_duration"],"title":"ScalingHistorySummary"},"ScalingPoliciesResponse":{"properties":{"cpu_scaling":{"$ref":"#/components/schemas/MetricScalingPolicy"},"memory_scaling":{"$ref":"#/components/schemas/MetricScalingPolicy"},"response_time_scaling":{"$ref":"#/components/schemas/MetricScalingPolicy"},"scheduled_scaling":{"$ref":"#/components/schemas/ScheduledScalingPolicy"}},"type":"object","required":["cpu_scaling","memory_scaling","response_time_scaling","scheduled_scaling"],"title":"ScalingPoliciesResponse"},"ScalingPoliciesUpdateResponse":{"properties":{"message":{"type":"string","title":"Message"},"update_details":{"$ref":"#/components/schemas/PolicyUpdateDetails"}},"type":"object","required":["message","update_details"],"title":"ScalingPoliciesUpdateResponse"},"ScalingPolicy":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Policy identifier"},"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name","description":"Policy name"},"agent_type":{"type":"string","minLength":1,"title":"Agent Type","description":"Type of agent this policy applies to"},"trigger_type":{"$ref":"#/components/schemas/ScalingTrigger"},"scaling_action":{"$ref":"#/components/schemas/ScalingAction"},"cooldown_seconds":{"type":"integer","minimum":0,"title":"Cooldown Seconds","description":"Cooldown period between scaling actions","default":300},"min_instances":{"type":"integer","minimum":1,"title":"Min Instances","description":"Minimum number of agent instances","default":1},"max_instances":{"type":"integer","minimum":1,"title":"Max Instances","description":"Maximum number of agent instances","default":10},"scaling_increment":{"type":"integer","minimum":1,"title":"Scaling Increment","description":"Number of instances to add/remove","default":1},"resource_thresholds":{"items":{"$ref":"#/components/schemas/ResourceThreshold"},"type":"array","title":"Resource Thresholds","description":"Resource thresholds for triggering"},"enabled":{"type":"boolean","title":"Enabled","description":"Whether this policy is enabled","default":true},"schedule":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schedule","description":"Schedule configuration if trigger is SCHEDULED"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["id","name","agent_type","trigger_type","scaling_action","resource_thresholds","created_at","updated_at"],"title":"ScalingPolicy","description":"Policy for automatic agent scaling"},"ScalingPolicyCreate":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name","description":"Policy name"},"agent_type":{"type":"string","minLength":1,"title":"Agent Type","description":"Type of agent this policy applies to"},"trigger_type":{"$ref":"#/components/schemas/ScalingTrigger"},"scaling_action":{"$ref":"#/components/schemas/ScalingAction"},"cooldown_seconds":{"type":"integer","minimum":0,"title":"Cooldown Seconds","description":"Cooldown period between scaling actions","default":300},"min_instances":{"type":"integer","minimum":1,"title":"Min Instances","description":"Minimum number of agent instances","default":1},"max_instances":{"type":"integer","minimum":1,"title":"Max Instances","description":"Maximum number of agent instances","default":10},"scaling_increment":{"type":"integer","minimum":1,"title":"Scaling Increment","description":"Number of instances to add/remove","default":1},"resource_thresholds":{"items":{"$ref":"#/components/schemas/ResourceThreshold"},"type":"array","title":"Resource Thresholds","description":"Resource thresholds for triggering"},"enabled":{"type":"boolean","title":"Enabled","description":"Whether this policy is enabled","default":true},"schedule":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schedule","description":"Schedule configuration if trigger is SCHEDULED"}},"type":"object","required":["name","agent_type","trigger_type","scaling_action","resource_thresholds"],"title":"ScalingPolicyCreate","description":"Create model for scaling policy"},"ScalingPolicySummary":{"properties":{"name":{"type":"string","title":"Name"},"metric":{"type":"string","title":"Metric"},"target_value":{"type":"integer","title":"Target Value"},"scale_up_adjustment":{"type":"integer","title":"Scale Up Adjustment"},"scale_down_adjustment":{"type":"integer","title":"Scale Down Adjustment"},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["name","metric","target_value","scale_up_adjustment","scale_down_adjustment","enabled"],"title":"ScalingPolicySummary"},"ScalingPolicyUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Name"},"trigger_type":{"anyOf":[{"$ref":"#/components/schemas/ScalingTrigger"},{"type":"null"}]},"scaling_action":{"anyOf":[{"$ref":"#/components/schemas/ScalingAction"},{"type":"null"}]},"cooldown_seconds":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Cooldown Seconds"},"min_instances":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Min Instances"},"max_instances":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Max Instances"},"scaling_increment":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Scaling Increment"},"resource_thresholds":{"anyOf":[{"items":{"$ref":"#/components/schemas/ResourceThreshold"},"type":"array"},{"type":"null"}],"title":"Resource Thresholds"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"schedule":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schedule"}},"type":"object","title":"ScalingPolicyUpdate","description":"Update model for scaling policy"},"ScalingTrigger":{"type":"string","enum":["load","queue","scheduled","manual"],"title":"ScalingTrigger","description":"Type of scaling trigger"},"ScanFinding":{"properties":{"severity":{"type":"string","enum":["critical","high","medium","low"],"title":"Severity"},"category":{"type":"string","title":"Category"},"description":{"type":"string","title":"Description"},"recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation"},"line":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Line"}},"type":"object","required":["severity","category","description"],"title":"ScanFinding"},"ScanRequest":{"properties":{"type":{"type":"string","enum":["settings","mcp_config","skill"],"title":"Type"},"content":{"type":"string","maxLength":100000,"title":"Content","description":"Raw file content as string"}},"type":"object","required":["type","content"],"title":"ScanRequest"},"ScanResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"scan_id":{"type":"string","title":"Scan Id"},"type":{"type":"string","title":"Type"},"threats":{"items":{"$ref":"#/components/schemas/ScanFinding"},"type":"array","title":"Threats"},"score":{"type":"integer","maximum":100,"minimum":0,"title":"Score"},"passed":{"type":"boolean","title":"Passed"},"summary":{"$ref":"#/components/schemas/app__api__v1__endpoints__security_scan__ScanSummary"},"scanned_at":{"type":"string","title":"Scanned At"}},"type":"object","required":["ok","scan_id","type","threats","score","passed","summary","scanned_at"],"title":"ScanResponse"},"ScheduleContinuousEvaluationResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"config":{"$ref":"#/components/schemas/ContinuousEvalScheduleConfig"}},"type":"object","required":["status","message","config"],"title":"ScheduleContinuousEvaluationResponse"},"ScheduleListResponse":{"properties":{"schedules":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__browser_schedules__ScheduleResponse"},"type":"array","title":"Schedules"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["schedules","total"],"title":"ScheduleListResponse"},"SchedulePostResponse":{"properties":{"id":{"type":"string","title":"Id"},"platform":{"type":"string","title":"Platform"},"scheduled_at":{"type":"string","title":"Scheduled At"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","platform","scheduled_at","status"],"title":"SchedulePostResponse"},"ScheduleRequest":{"properties":{"platform":{"type":"string","title":"Platform"},"text":{"type":"string","minLength":1,"title":"Text"},"scheduled_at":{"type":"string","title":"Scheduled At"},"link_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Url"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"}},"type":"object","required":["platform","text","scheduled_at"],"title":"ScheduleRequest"},"ScheduleUpdate":{"properties":{"start_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Time","description":"Stream start time in HH:MM format (UTC)"},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Time","description":"Stream end time in HH:MM format (UTC)"},"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Title","description":"Scheduled stream title"},"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id","description":"Category ID"},"is_recurring":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Recurring","description":"Whether this is recurring"}},"type":"object","title":"ScheduleUpdate","description":"Schema for updating a stream schedule entry","example":{"end_time":"21:00","start_time":"19:00","title":"Updated Stream Title"}},"ScheduledPostEntry":{"properties":{"id":{"type":"string","title":"Id"},"platform":{"type":"string","title":"Platform"},"text":{"type":"string","title":"Text"},"link_url":{"type":"string","title":"Link Url"},"scheduled_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled At"},"status":{"type":"string","title":"Status"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Url"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["id","platform","text","link_url","status"],"title":"ScheduledPostEntry"},"ScheduledPostsListResponse":{"properties":{"scheduled":{"items":{"$ref":"#/components/schemas/ScheduledPostEntry"},"type":"array","title":"Scheduled"}},"type":"object","required":["scheduled"],"title":"ScheduledPostsListResponse"},"ScheduledScalingEntry":{"properties":{"name":{"type":"string","title":"Name"},"min_instances":{"type":"integer","title":"Min Instances"},"max_instances":{"type":"integer","title":"Max Instances"},"desired_instances":{"type":"integer","title":"Desired Instances"},"cron":{"type":"string","title":"Cron"},"timezone":{"type":"string","title":"Timezone"}},"type":"object","required":["name","min_instances","max_instances","desired_instances","cron","timezone"],"title":"ScheduledScalingEntry"},"ScheduledScalingPolicy":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"schedules":{"items":{"$ref":"#/components/schemas/ScheduledScalingEntry"},"type":"array","title":"Schedules"}},"type":"object","required":["enabled","schedules"],"title":"ScheduledScalingPolicy"},"SchemaInfo":{"properties":{"schema_name":{"type":"string","title":"Schema Name","description":"Schema name"},"tables":{"items":{"$ref":"#/components/schemas/TableInfo"},"type":"array","title":"Tables","description":"Tables in schema","default":[]},"total_tables":{"type":"integer","minimum":0,"title":"Total Tables","description":"Total number of tables"},"total_size_bytes":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Total Size Bytes","description":"Total schema size"}},"type":"object","required":["schema_name","total_tables"],"title":"SchemaInfo","description":"Database schema information","example":{"schema_name":"public","tables":[],"total_size_bytes":1048576,"total_tables":10}},"SearchCodeChunksResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/SearchedChunk"},"type":"array","title":"Results"}},"type":"object","title":"SearchCodeChunksResponse","description":"Response for POST /chunks/search (wraps ChunkingEngine.search_chunks)."},"SearchContentData":{"properties":{"query":{"type":"string","title":"Query"},"results":{"items":{"$ref":"#/components/schemas/SearchResultItem"},"type":"array","title":"Results"},"total_results":{"type":"integer","title":"Total Results"},"search_type":{"type":"string","title":"Search Type"}},"type":"object","required":["query","results","total_results","search_type"],"title":"SearchContentData"},"SearchContentResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/SearchContentData"}},"type":"object","required":["success","data"],"title":"SearchContentResponse","description":"Response for POST /search/."},"SearchDocumentationResponse":{"properties":{"query":{"type":"string","title":"Query"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results"},"total_results":{"type":"integer","title":"Total Results"},"search_suggestions":{"items":{"type":"string"},"type":"array","title":"Search Suggestions"},"popular_searches":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Popular Searches"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["query","results","total_results","search_suggestions","popular_searches","timestamp"],"title":"SearchDocumentationResponse","description":"Response for POST /help-documentation/search."},"SearchFilters":{"properties":{"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Filter by programming language stored in vector metadata","example":"python"},"file_path_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Path Prefix","description":"Only return fragments whose file_path starts with this prefix","example":"src/"}},"type":"object","title":"SearchFilters","description":"Optional filters to narrow codebase search results."},"SearchHistoryData":{"properties":{"history":{"items":{"$ref":"#/components/schemas/SearchHistoryItem"},"type":"array","title":"History"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["history","total"],"title":"SearchHistoryData"},"SearchHistoryItem":{"properties":{"id":{"type":"string","title":"Id"},"query":{"type":"string","title":"Query"},"timestamp":{"type":"string","title":"Timestamp"},"results_count":{"type":"integer","title":"Results Count"}},"type":"object","required":["id","query","timestamp","results_count"],"title":"SearchHistoryItem"},"SearchHistoryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/SearchHistoryData"}},"type":"object","required":["success","data"],"title":"SearchHistoryResponse","description":"Response for GET /search/history."},"SearchMemoryResponse":{"properties":{"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["results","count"],"title":"SearchMemoryResponse"},"SearchMetricsResponse":{"properties":{"total_searches":{"type":"integer","title":"Total Searches","description":"Total number of searches"},"avg_execution_time_ms":{"type":"number","title":"Avg Execution Time Ms","description":"Average execution time"},"min_execution_time_ms":{"type":"number","title":"Min Execution Time Ms","description":"Minimum execution time"},"max_execution_time_ms":{"type":"number","title":"Max Execution Time Ms","description":"Maximum execution time"},"successful_searches":{"type":"integer","title":"Successful Searches","description":"Number of successful searches"},"failed_searches":{"type":"integer","title":"Failed Searches","description":"Number of failed searches"},"quantum_enhanced_searches":{"type":"integer","title":"Quantum Enhanced Searches","description":"Number of quantum-enhanced searches"},"classical_only_searches":{"type":"integer","title":"Classical Only Searches","description":"Number of classical-only searches"},"date_range":{"additionalProperties":true,"type":"object","title":"Date Range","description":"Date range for metrics"}},"type":"object","required":["total_searches","avg_execution_time_ms","min_execution_time_ms","max_execution_time_ms","successful_searches","failed_searches","quantum_enhanced_searches","classical_only_searches","date_range"],"title":"SearchMetricsResponse","description":"Response model for search metrics."},"SearchRepositoryResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable status message"},"query":{"type":"string","title":"Query","description":"Search query used"},"project_id":{"type":"string","title":"Project Id","description":"Project identifier"},"limit":{"type":"integer","title":"Limit","description":"Maximum number of results requested"},"results":{"items":{"$ref":"#/components/schemas/RepositorySearchResult"},"type":"array","title":"Results","description":"Search results"},"result_count":{"type":"integer","title":"Result Count","description":"Number of results returned"},"note":{"type":"string","title":"Note","description":"Implementation note"}},"type":"object","required":["message","query","project_id","limit","result_count","note"],"title":"SearchRepositoryResponse","description":"Response for GET /indexing/repositories/{project_id}/search."},"SearchResponse":{"properties":{"search_id":{"type":"string","format":"uuid4","title":"Search Id","description":"Search result identifier"},"query":{"type":"string","title":"Query","description":"Original search query"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results","description":"Search results"},"total_results":{"type":"integer","title":"Total Results","description":"Total number of results"},"execution_time_ms":{"type":"number","title":"Execution Time Ms","description":"Execution time in milliseconds"},"quantum_enhanced":{"type":"boolean","title":"Quantum Enhanced","description":"Whether quantum enhancement was used"}},"type":"object","required":["search_id","query","results","total_results","execution_time_ms","quantum_enhanced"],"title":"SearchResponse","description":"Response model for search results."},"SearchResultItem":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"relevance_score":{"type":"number","title":"Relevance Score"},"source":{"type":"string","title":"Source"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["id","title","content","relevance_score","source","timestamp"],"title":"SearchResultItem"},"SearchResultResponse":{"properties":{"search_id":{"type":"string","format":"uuid4","title":"Search Id","description":"Search result identifier"},"query":{"type":"string","title":"Query","description":"Original search query"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results","description":"Search results"},"quantum_parameters":{"additionalProperties":true,"type":"object","title":"Quantum Parameters","description":"Quantum parameters used"},"execution_time_ms":{"type":"number","title":"Execution Time Ms","description":"Execution time in milliseconds"},"created_at":{"type":"string","title":"Created At","description":"Creation timestamp"}},"type":"object","required":["search_id","query","results","quantum_parameters","execution_time_ms","created_at"],"title":"SearchResultResponse","description":"Response model for retrieving search results."},"SearchSuggestion":{"properties":{"text":{"type":"string","title":"Text","description":"Suggestion text"},"relevance_score":{"type":"number","maximum":1,"minimum":0,"title":"Relevance Score","description":"Relevance score"},"category":{"type":"string","title":"Category","description":"Suggestion category (topic, keyword, entity)"},"result_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Result Count","description":"Number of results for this suggestion"}},"type":"object","required":["text","relevance_score","category"],"title":"SearchSuggestion","description":"Individual search suggestion","example":{"category":"topic","relevance_score":0.95,"result_count":142,"text":"quantum neural networks"}},"SearchSuggestionResponse":{"properties":{"suggestions":{"items":{"$ref":"#/components/schemas/SearchSuggestion"},"type":"array","title":"Suggestions","description":"List of suggestions"},"query":{"type":"string","title":"Query","description":"Original query"},"total_suggestions":{"type":"integer","title":"Total Suggestions","description":"Total number of suggestions"},"response_time_ms":{"type":"integer","title":"Response Time Ms","description":"Response time in milliseconds"}},"type":"object","required":["query","total_suggestions","response_time_ms"],"title":"SearchSuggestionResponse","description":"Search suggestion response","example":{"query":"quantum","response_time_ms":45,"suggestions":[{"category":"topic","relevance_score":0.95,"result_count":142,"text":"quantum neural networks"}],"total_suggestions":1}},"SearchSuggestionsData":{"properties":{"query":{"type":"string","title":"Query"},"suggestions":{"items":{"type":"string"},"type":"array","title":"Suggestions"}},"type":"object","required":["query","suggestions"],"title":"SearchSuggestionsData"},"SearchedChunk":{"properties":{"id":{"type":"integer","title":"Id"},"content":{"type":"string","title":"Content"},"file_path":{"type":"string","title":"File Path"},"start_line":{"type":"integer","title":"Start Line"},"end_line":{"type":"integer","title":"End Line"},"chunk_type":{"type":"string","title":"Chunk Type"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"similarity":{"type":"number","title":"Similarity","description":"1.0 - vector distance"}},"type":"object","required":["id","content","file_path","start_line","end_line","chunk_type","similarity"],"title":"SearchedChunk","description":"A single search result chunk with similarity score."},"SecurityAlert":{"properties":{"severity":{"type":"string","title":"Severity"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["severity","message","timestamp"],"title":"SecurityAlert"},"SecurityConfigurationResponse":{"properties":{"rate_limiting":{"additionalProperties":{"type":"integer"},"type":"object","title":"Rate Limiting"},"brute_force_protection":{"additionalProperties":{"type":"integer"},"type":"object","title":"Brute Force Protection"},"monitoring":{"additionalProperties":true,"type":"object","title":"Monitoring"},"detection_patterns":{"additionalProperties":{"type":"integer"},"type":"object","title":"Detection Patterns"},"privileged_endpoints":{"items":{"type":"string"},"type":"array","title":"Privileged Endpoints"},"current_status":{"additionalProperties":{"type":"integer"},"type":"object","title":"Current Status"}},"type":"object","required":["rate_limiting","brute_force_protection","monitoring","detection_patterns","privileged_endpoints","current_status"],"title":"SecurityConfigurationResponse","description":"Current security monitoring configuration."},"SecurityEventRow":{"properties":{"event_id":{"type":"string","title":"Event Id"},"event_type":{"type":"string","title":"Event Type"},"threat_level":{"type":"string","title":"Threat Level"},"timestamp":{"type":"string","title":"Timestamp"},"source_ip":{"type":"string","title":"Source Ip"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"endpoint":{"type":"string","title":"Endpoint"},"method":{"type":"string","title":"Method"},"details":{"additionalProperties":true,"type":"object","title":"Details"},"mitigated":{"type":"boolean","title":"Mitigated"},"mitigation_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mitigation Action"}},"additionalProperties":true,"type":"object","required":["event_id","event_type","threat_level","timestamp","source_ip","endpoint","method","details","mitigated"],"title":"SecurityEventRow","description":"One security event. `user_agent` and `mitigation_action` are genuinely\nnullable on the SecurityEvent dataclass; `details` is a free-form,\nper-event-type payload and must not be flattened."},"SecurityEventType":{"type":"string","enum":["brute_force_attempt","suspicious_user_agent","rate_limit_exceeded","unauthorized_access_attempt","suspicious_request_pattern","potential_sql_injection","potential_xss_attempt","unusual_traffic_pattern","privileged_endpoint_access","api_key_misuse"],"title":"SecurityEventType","description":"Types of security events"},"SecurityEventsResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/SecurityEventRow"},"type":"array","title":"Events"},"total_events":{"type":"integer","title":"Total Events"},"filters_applied":{"additionalProperties":true,"type":"object","title":"Filters Applied"},"timestamp":{"type":"string","title":"Timestamp"}},"additionalProperties":true,"type":"object","required":["events","total_events","filters_applied","timestamp"],"title":"SecurityEventsResponse","description":"GET /events -- always fully populated, even with zero matches."},"SecurityFileCounts":{"properties":{"high":{"type":"integer","title":"High","default":0},"medium":{"type":"integer","title":"Medium","default":0},"low":{"type":"integer","title":"Low","default":0}},"type":"object","title":"SecurityFileCounts"},"SecurityIncidentListEntry":{"properties":{"incident_id":{"type":"string","title":"Incident Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"severity":{"type":"string","title":"Severity"},"status":{"type":"string","title":"Status"},"reported_by":{"type":"string","title":"Reported By"},"assigned_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned To"},"created_at":{"type":"string","title":"Created At"},"resolved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved At"},"affected_systems":{"items":{"type":"string"},"type":"array","title":"Affected Systems"},"security_classifications":{"items":{"type":"string"},"type":"array","title":"Security Classifications"},"compliance_impact":{"items":{"type":"string"},"type":"array","title":"Compliance Impact"}},"type":"object","required":["incident_id","title","description","severity","status","reported_by","created_at","affected_systems","security_classifications","compliance_impact"],"title":"SecurityIncidentListEntry"},"SecurityIncidentRequest":{"properties":{"title":{"type":"string","title":"Title","description":"Incident title"},"description":{"type":"string","title":"Description","description":"Incident description"},"severity":{"type":"string","title":"Severity","description":"Incident severity"},"affected_systems":{"items":{"type":"string"},"type":"array","title":"Affected Systems","description":"Affected systems"},"security_classifications":{"items":{"type":"string"},"type":"array","title":"Security Classifications","description":"Security classifications"},"compliance_impact":{"items":{"type":"string"},"type":"array","title":"Compliance Impact","description":"Compliance frameworks impacted"}},"type":"object","required":["title","description","severity","affected_systems"],"title":"SecurityIncidentRequest","description":"Request to create security incident"},"SecurityLevelEntry":{"properties":{"level":{"type":"string","title":"Level"},"description":{"type":"string","title":"Description"}},"type":"object","required":["level","description"],"title":"SecurityLevelEntry"},"SecurityMonitoringControlResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","timestamp"],"title":"SecurityMonitoringControlResponse","description":"Result of starting/stopping the security monitoring system."},"SecurityMonitoringHealthResponse":{"properties":{"monitoring_active":{"type":"boolean","title":"Monitoring Active"},"total_security_events":{"type":"integer","title":"Total Security Events"},"active_blocked_ips":{"type":"integer","title":"Active Blocked Ips"},"ip_reputation_entries":{"type":"integer","title":"Ip Reputation Entries"},"rate_limit_entries":{"type":"integer","title":"Rate Limit Entries"},"system_status":{"type":"string","title":"System Status"},"last_updated":{"type":"string","title":"Last Updated"}},"type":"object","required":["monitoring_active","total_security_events","active_blocked_ips","ip_reputation_entries","rate_limit_entries","system_status","last_updated"],"title":"SecurityMonitoringHealthResponse","description":"Health check for the security monitoring system itself."},"SecurityScanHistoryEntry":{"properties":{"id":{"type":"string","title":"Id"},"scan_id":{"type":"string","title":"Scan Id"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Seconds"},"sast_status":{"type":"string","title":"Sast Status"},"sca_status":{"type":"string","title":"Sca Status"},"total_findings":{"type":"integer","title":"Total Findings"},"high":{"type":"integer","title":"High"},"medium":{"type":"integer","title":"Medium"},"low":{"type":"integer","title":"Low"},"sca_vulns":{"type":"integer","title":"Sca Vulns"},"triggered_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Triggered By"},"sast_findings":{"items":{},"type":"array","title":"Sast Findings","default":[]},"sca_findings":{"items":{},"type":"array","title":"Sca Findings","default":[]}},"type":"object","required":["id","scan_id","sast_status","sca_status","total_findings","high","medium","low","sca_vulns"],"title":"SecurityScanHistoryEntry","description":"One persisted scan row from security_scan_history (Refs #8270)."},"SecurityScanHistoryResponse":{"properties":{"scans":{"items":{"$ref":"#/components/schemas/SecurityScanHistoryEntry"},"type":"array","title":"Scans"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"message":{"type":"string","title":"Message"}},"type":"object","required":["scans","total","limit","offset","message"],"title":"SecurityScanHistoryResponse","description":"Response for GET /scan-history.\n\n`scans` holds real persisted rows from security_scan_history, newest\nfirst. `total` is the full row count (independent of limit/offset) so\ncallers can paginate. Refs #8270"},"SecurityScanRunResponse":{"properties":{"scan_id":{"type":"string","title":"Scan Id"},"started_at":{"type":"string","title":"Started At"},"sast":{"$ref":"#/components/schemas/SastResult"},"sca":{"$ref":"#/components/schemas/ScaResult"},"summary":{"$ref":"#/components/schemas/app__schemas__admin__security_scan__ScanSummary"},"completed_at":{"type":"string","title":"Completed At"},"duration_seconds":{"type":"number","title":"Duration Seconds"}},"type":"object","required":["scan_id","started_at","sast","sca","summary","completed_at","duration_seconds"],"title":"SecurityScanRunResponse","description":"Response for POST /run-scan."},"SecuritySettingsResponse":{"properties":{"user_id":{"type":"string","title":"User Id","description":"User ID"},"email":{"type":"string","title":"Email","description":"User email address"},"email_verified":{"type":"boolean","title":"Email Verified","description":"Email verification status"},"two_factor_auth":{"$ref":"#/components/schemas/TwoFactorStatus","description":"2FA configuration"},"last_password_change":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Password Change","description":"Last password change timestamp"},"account_created":{"type":"string","format":"date-time","title":"Account Created","description":"Account creation date"}},"type":"object","required":["user_id","email","email_verified","two_factor_auth","account_created"],"title":"SecuritySettingsResponse","description":"Schema for comprehensive security settings response","example":{"account_created":"2024-01-01T09:00:00","email":"user@example.com","email_verified":true,"last_password_change":"2024-01-25T14:22:00","two_factor_auth":{"backup_codes_remaining":8,"enabled":true,"phone_number":"****1234","verified_at":"2024-01-20T10:30:00"},"user_id":"550e8400-e29b-41d4-a716-446655440000"}},"SeedDataResponse":{"properties":{"prospects":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Prospects"},"domains":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Domains"},"stats":{"$ref":"#/components/schemas/SeedDataStats"}},"type":"object","required":["prospects","domains","stats"],"title":"SeedDataResponse"},"SeedDataStats":{"properties":{"industry":{"type":"string","title":"Industry"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"prospects_count":{"type":"integer","title":"Prospects Count"},"domains_count":{"type":"integer","title":"Domains Count"},"description":{"type":"string","title":"Description"}},"type":"object","required":["industry","prospects_count","domains_count","description"],"title":"SeedDataStats"},"SeedDomainEntry":{"properties":{"domain":{"type":"string","title":"Domain","description":"Bare domain, e.g. 'stripe.com' (no scheme/path)"},"industry":{"type":"string","title":"Industry","description":"One of the known industry categories; defaults to 'saas'","default":"saas"}},"type":"object","required":["domain"],"title":"SeedDomainEntry"},"SeedTaskStatusResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"state":{"type":"string","title":"State"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"}},"type":"object","required":["task_id","state"],"title":"SeedTaskStatusResponse"},"SeededEntity":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"additionalProperties":true,"type":"object","required":["id"],"title":"SeededEntity","description":"A seed entity created by apply_template.\n\nNote the keys are ``name``/``type`` here, NOT canonical_name/entity_type\nas elsewhere in this module — pinned as-is to avoid changing the wire."},"SegmentEdit":{"properties":{"start_ms":{"type":"integer","title":"Start Ms"},"end_ms":{"type":"integer","title":"End Ms"},"text":{"type":"string","title":"Text"}},"type":"object","required":["start_ms","end_ms","text"],"title":"SegmentEdit"},"SelectPromptForAgentResponse":{"properties":{"version_id":{"type":"string","title":"Version Id"},"template_id":{"type":"string","title":"Template Id"},"content":{"type":"string","title":"Content"},"template_variables":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Template Variables"},"version_number":{"anyOf":[{},{"type":"null"}],"title":"Version Number"},"performance_metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Performance Metrics"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["version_id","template_id","content"],"title":"SelectPromptForAgentResponse","description":"Response for POST /select-prompt."},"SelectionStrategy":{"type":"string","enum":["rotation","performance","ab_test"],"title":"SelectionStrategy","description":"Creative selection strategies for campaign\n\nIssue #562: Controls how creatives are chosen when serving ads"},"SelectiveRestoreCapability":{"properties":{"available":{"type":"boolean","title":"Available"},"supported_components":{"items":{"type":"string"},"type":"array","title":"Supported Components"}},"type":"object","required":["available","supported_components"],"title":"SelectiveRestoreCapability"},"SendClaimEmailRequest":{"properties":{"email":{"type":"string","title":"Email","description":"Email address to send the claim link to"},"claim_url":{"type":"string","title":"Claim Url","description":"The claim URL from the provisioning response"},"project_id":{"type":"string","minLength":1,"title":"Project Id","description":"The project UUID"}},"type":"object","required":["email","claim_url","project_id"],"title":"SendClaimEmailRequest","description":"Request body for sending the claim email to an MCP user."},"SendClaimEmailResponse":{"properties":{"sent":{"type":"boolean","title":"Sent"},"email":{"type":"string","title":"Email"}},"type":"object","required":["sent","email"],"title":"SendClaimEmailResponse","description":"Response body for POST /instant-db/send-claim-email — Refs #8449.\n\nThe handler has exactly one success return, a literal\n``{\"sent\": True, \"email\": payload.email}``, so this shape is complete."},"SendEmailRequest":{"properties":{"to":{"items":{"type":"string","format":"email"},"type":"array","maxItems":50,"minItems":1,"title":"To","description":"Recipient email addresses"},"subject":{"type":"string","maxLength":500,"minLength":1,"title":"Subject","description":"Email subject"},"html_body":{"type":"string","minLength":1,"title":"Html Body","description":"HTML email body"},"text_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Body","description":"Plain text email body"},"from_email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"From Email","description":"Override sender email"},"from_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From Name","description":"Override sender name"},"reply_to":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Reply To","description":"Reply-to email address"},"cc":{"anyOf":[{"items":{"type":"string","format":"email"},"type":"array"},{"type":"null"}],"title":"Cc","description":"CC recipients"},"bcc":{"anyOf":[{"items":{"type":"string","format":"email"},"type":"array"},{"type":"null"}],"title":"Bcc","description":"BCC recipients"},"tags":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Tags","description":"Metadata tags for tracking"},"headers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Headers","description":"Custom email headers"},"provider_override":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Override","description":"Override provider (smtp, sendgrid, ses, resend)"}},"type":"object","required":["to","subject","html_body"],"title":"SendEmailRequest","description":"Request model for sending custom email","example":{"html_body":"

Welcome!

Thanks for signing up.

","subject":"Welcome to AINative!","tags":{"campaign":"onboarding","user_id":"123"},"text_body":"Welcome! Thanks for signing up.","to":["user@example.com"]}},"SendEmailResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message Id"},"provider":{"type":"string","title":"Provider"},"rate_limit_status":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Rate Limit Status"}},"type":"object","required":["success","message","provider"],"title":"SendEmailResponse","description":"Response model for email send"},"SendPhoneOtpRequest":{"properties":{"phone":{"type":"string","title":"Phone","description":"Phone number in any reasonable format; normalized to E.164 server-side."},"purpose":{"type":"string","title":"Purpose","description":"'register' or 'login'.","default":"register"}},"type":"object","required":["phone"],"title":"SendPhoneOtpRequest","description":"Schema for POST /auth/send-phone-otp (Refs #8459).\n\n`purpose` disambiguates register vs. login codes so one cannot be\nreplayed for the other (see PhoneOtpService). Defaults to \"register\"\nsince that is the first-contact case Builder's mobile UI needs."},"SendPhoneOtpResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"True when the code was sent."},"message":{"type":"string","title":"Message","description":"Human-readable confirmation."},"expires_in_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Minutes","description":"Minutes until the sent code expires."}},"additionalProperties":false,"type":"object","required":["success","message"],"title":"SendPhoneOtpResponse","description":"POST /auth/send-phone-otp — confirms an SMS verification code was sent.\n\nDeliberately NARROW (``extra=\"forbid\"``), unlike its siblings here. The\nhandler's delegate, ``PhoneOtpService.send_code()``, returns the normalized\nE.164 ``phone_number`` in its own success dict, and the plaintext OTP plus\nits bcrypt hash live in that same call's scope. ``extra=\"allow\"`` would make\nthis model a silent pass-through the day someone widens the handler's\n``return`` to ``**result``, leaking the normalized number (an account\nidentifier) or the code itself. Forbidding extras makes that a loud failure\ninstead. Refs #8449, #8459.\n\n``expires_in_minutes`` is Optional because the handler reads it with\n``.get()`` — a delegate branch that omits it must serialize as null rather\nthan 500."},"SequenceCreate":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By"}},"type":"object","required":["name","description"],"title":"SequenceCreate"},"SequenceResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"status":{"type":"string","title":"Status"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","description","status","created_at"],"title":"SequenceResponse","example":{"created_at":"2025-01-01T00:00:00Z","created_by":"user-456","description":"Sequential data processing tasks","id":"seq-123","name":"Data Processing Pipeline","status":"active","updated_at":"2025-01-01T00:00:00Z"}},"SequenceStatusResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"progress":{"type":"number","title":"Progress"},"tasks":{"items":{"$ref":"#/components/schemas/SequenceTaskResponse"},"type":"array","title":"Tasks"}},"type":"object","required":["id","name","status","progress","tasks"],"title":"SequenceStatusResponse","example":{"id":"seq-123","name":"Data Processing Pipeline","progress":0.5,"status":"running","tasks":[{"dependencies":[],"id":"seqtask-123","order_position":1,"sequence_id":"seq-123","status":"completed","task_id":"task-789"}]}},"SequenceTaskAdd":{"properties":{"task_id":{"type":"string","title":"Task Id"},"order_position":{"type":"integer","title":"Order Position"},"dependencies":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Dependencies"}},"type":"object","required":["task_id","order_position"],"title":"SequenceTaskAdd"},"SequenceTaskResponse":{"properties":{"id":{"type":"string","title":"Id"},"sequence_id":{"type":"string","title":"Sequence Id"},"task_id":{"type":"string","title":"Task Id"},"order_position":{"type":"integer","title":"Order Position"},"status":{"type":"string","title":"Status"},"dependencies":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Dependencies"}},"type":"object","required":["id","sequence_id","task_id","order_position","status"],"title":"SequenceTaskResponse","example":{"dependencies":["task-101"],"id":"seqtask-123","order_position":1,"sequence_id":"seq-456","status":"pending","task_id":"task-789"}},"SerializedPromptTemplate":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"use_case":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Use Case"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}},"current_version":{"anyOf":[{},{"type":"null"}],"title":"Current Version"},"created_by":{"type":"string","title":"Created By"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"is_active":{"type":"boolean","title":"Is Active","default":true}},"type":"object","required":["id","name","created_by"],"title":"SerializedPromptTemplate","description":"Exact shape of `_serialize_template()`."},"SerializedPromptVersion":{"properties":{"id":{"type":"string","title":"Id"},"prompt_template_id":{"type":"string","title":"Prompt Template Id"},"version_number":{"anyOf":[{},{"type":"null"}],"title":"Version Number"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"template_variables":{"items":{},"type":"array","title":"Template Variables","default":[]},"tags":{"items":{},"type":"array","title":"Tags","default":[]},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"performance_metrics":{"additionalProperties":true,"type":"object","title":"Performance Metrics","default":{}},"test_results":{"additionalProperties":true,"type":"object","title":"Test Results","default":{}},"deployment_config":{"additionalProperties":true,"type":"object","title":"Deployment Config","default":{}},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}},"created_by":{"type":"string","title":"Created By"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"is_active":{"type":"boolean","title":"Is Active","default":true}},"type":"object","required":["id","prompt_template_id","created_by"],"title":"SerializedPromptVersion","description":"Exact shape of `_serialize_version()`."},"ServiceHealth":{"properties":{"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"latency_ms":{"type":"number","title":"Latency Ms"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"tables_found":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tables Found"}},"type":"object","required":["name","status","latency_ms"],"title":"ServiceHealth","description":"Connectivity check result for a single dependency."},"ServiceHealthDetail":{"properties":{"status":{"type":"string","title":"Status"},"response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time Ms"},"usage_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Usage Percent"},"free_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Free Gb"},"available_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Available Gb"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"additionalProperties":true,"type":"object","required":["status"],"title":"ServiceHealthDetail","description":"Status block for a single dependency (database/redis/disk_space/memory)."},"ServiceKeyCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name","description":"Key name"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions","description":"Scoped permissions for this key","default":["org:projects:create","org:projects:read"]}},"type":"object","required":["name"],"title":"ServiceKeyCreate"},"ServiceKeyResponse":{"properties":{"key_id":{"type":"string","title":"Key Id"},"api_key":{"type":"string","title":"Api Key"},"prefix":{"type":"string","title":"Prefix"},"key_type":{"type":"string","title":"Key Type"},"organization_id":{"type":"string","title":"Organization Id"},"name":{"type":"string","title":"Name"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["key_id","api_key","prefix","key_type","organization_id","name","permissions","created_at"],"title":"ServiceKeyResponse"},"ServiceOSApiInfo":{"properties":{"base_url":{"type":"string","title":"Base Url"},"public_chat_url":{"type":"string","title":"Public Chat Url"},"docs":{"type":"string","title":"Docs"}},"type":"object","required":["base_url","public_chat_url","docs"],"title":"ServiceOSApiInfo"},"ServiceUsageEntry":{"properties":{"name":{"type":"string","title":"Name"},"requests":{"type":"integer","title":"Requests"}},"type":"object","required":["name","requests"],"title":"ServiceUsageEntry"},"ServicesHealthInfo":{"properties":{"auth_service":{"type":"string","title":"Auth Service","default":"operational"},"user_management":{"type":"string","title":"User Management","default":"operational"},"api_keys":{"type":"string","title":"Api Keys","default":"operational"},"zerodb":{"type":"string","title":"Zerodb","default":"operational"}},"type":"object","title":"ServicesHealthInfo","description":"Services health status"},"SessionCreateRequest":{"properties":{"preferences":{"additionalProperties":true,"type":"object","title":"Preferences"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","title":"SessionCreateRequest","description":"Request to create a new session"},"SessionEventCreate":{"properties":{"event_type":{"$ref":"#/components/schemas/SessionEventTypeEnum"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"event_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Event Data"}},"type":"object","required":["event_type"],"title":"SessionEventCreate","description":"Push an event to a coding session"},"SessionEventTypeEnum":{"type":"string","enum":["user_message","assistant_message","tool_use","tool_result","permission_request","permission_response","status_change","error","heartbeat"],"title":"SessionEventTypeEnum"},"SessionIngressPutRequest":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/TranscriptEntry"},"type":"array","title":"Entries"}},"type":"object","title":"SessionIngressPutRequest","description":"Request body for PUT /session/{session_id}. Refs #3168."},"SessionIngressPutResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"accepted":{"type":"integer","title":"Accepted"},"last_uuid":{"type":"string","title":"Last Uuid"}},"type":"object","required":["session_id","accepted","last_uuid"],"title":"SessionIngressPutResponse","description":"Response for PUT /session/{session_id}. Refs #3168."},"SessionInteractionDetail":{"properties":{"interaction_id":{"type":"string","title":"Interaction Id"},"type":{"type":"string","title":"Type"},"timestamp":{"type":"string","title":"Timestamp"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url"},"element_clicked":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Element Clicked"},"rating_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating Score"},"agent_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Type"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"}},"type":"object","required":["interaction_id","type","timestamp"],"title":"SessionInteractionDetail"},"SessionItem":{"properties":{"session_id":{"type":"string","title":"Session Id"},"project":{"type":"string","title":"Project"},"model":{"type":"string","title":"Model"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["session_id","project","model","status","created_at"],"title":"SessionItem"},"SessionLogEntry":{"properties":{"log_id":{"type":"string","title":"Log Id"},"timestamp":{"type":"string","title":"Timestamp"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"level":{"type":"string","title":"Level"},"message":{"type":"string","title":"Message"},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"}},"type":"object","required":["log_id","timestamp","level","message"],"title":"SessionLogEntry"},"SessionManagementEvidence":{"properties":{"sessions_created":{"type":"integer","title":"Sessions Created"},"sessions_terminated_by_deadman":{"type":"integer","title":"Sessions Terminated By Deadman"},"sessions_terminated_by_human":{"type":"integer","title":"Sessions Terminated By Human"}},"type":"object","required":["sessions_created","sessions_terminated_by_deadman","sessions_terminated_by_human"],"title":"SessionManagementEvidence"},"SessionMemoryRequest":{"properties":{"session_id":{"type":"string","minLength":1,"title":"Session Id"},"project":{"type":"string","minLength":1,"title":"Project"},"memories":{"items":{"$ref":"#/components/schemas/MemoryItem"},"type":"array","maxItems":50,"minItems":1,"title":"Memories"}},"type":"object","required":["session_id","project","memories"],"title":"SessionMemoryRequest"},"SessionMemoryResponse":{"properties":{"stored":{"type":"integer","title":"Stored"},"session_id":{"type":"string","title":"Session Id"}},"type":"object","required":["stored","session_id"],"title":"SessionMemoryResponse"},"SessionMetadataResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["session_id","status","created_at"],"title":"SessionMetadataResponse","description":"Response for GET session metadata."},"SessionPersistence":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"type":{"type":"string","title":"Type"},"timeout":{"type":"integer","title":"Timeout"}},"type":"object","required":["enabled","type","timeout"],"title":"SessionPersistence"},"SessionRetrievalResponse":{"properties":{"memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"stored_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stored At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Present when no matching session state was found"}},"type":"object","required":["metadata"],"title":"SessionRetrievalResponse"},"SessionState":{"properties":{"session_id":{"type":"string","title":"Session Id","description":"Unique session identifier"},"project_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Path","description":"Absolute path of project directory"},"files_modified":{"items":{"type":"string"},"type":"array","title":"Files Modified","description":"List of file paths modified this session"},"commands_run":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Commands Run","description":"Commands run with exit codes"},"errors_encountered":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors Encountered","description":"Errors with tool names"},"key_decisions":{"items":{"type":"string"},"type":"array","title":"Key Decisions","description":"Key decisions made"},"open_tasks":{"items":{"type":"string"},"type":"array","title":"Open Tasks","description":"Unfinished tasks at session end"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event","description":"pre_compact | session_end | checkpoint"}},"type":"object","required":["session_id"],"title":"SessionState"},"SessionStateResponse":{"properties":{"memory_id":{"type":"string","title":"Memory Id"},"session_id":{"type":"string","title":"Session Id"},"stored_at":{"type":"string","title":"Stored At"}},"type":"object","required":["memory_id","session_id","stored_at"],"title":"SessionStateResponse"},"SessionTerminateResponse":{"properties":{"message":{"type":"string","title":"Message"},"session_id":{"type":"string","title":"Session Id"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO timestamp the session was terminated"}},"type":"object","required":["message","session_id","timestamp"],"title":"SessionTerminateResponse","description":"Response for DELETE /sessions/{session_id}."},"SessionUpdateRequest":{"properties":{"preferences":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Preferences"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","title":"SessionUpdateRequest","description":"Request to update session data"},"SessionValidityResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"session_id":{"type":"string","title":"Session Id"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Present when the session could not be found"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At","description":"ISO expiry timestamp, when the session exists"},"last_activity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity","description":"ISO last-activity timestamp, when the session exists"}},"type":"object","required":["valid","session_id"],"title":"SessionValidityResponse","description":"Response for GET /sessions/{session_id}/valid.\n\nWhen the session does not exist, only `valid`, `reason`, and `session_id`\nare populated; when it does, `expires_at`/`last_activity` are populated\ninstead of `reason` — so both groups are optional."},"SessionsRevokeRequest":{"properties":{"verification_code":{"type":"string","maxLength":6,"minLength":6,"title":"Verification Code","description":"Current 2FA code for verification"}},"type":"object","required":["verification_code"],"title":"SessionsRevokeRequest","description":"Request to revoke all 2FA sessions","example":{"verification_code":"123456"}},"SessionsRevokeResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Revoke success status"},"message":{"type":"string","title":"Message","description":"Result message"},"sessions_revoked":{"type":"integer","title":"Sessions Revoked","description":"Number of sessions revoked"}},"type":"object","required":["success","message","sessions_revoked"],"title":"SessionsRevokeResponse","description":"Response after revoking sessions","example":{"message":"All 2FA sessions revoked successfully","sessions_revoked":3,"success":true}},"SetDefaultPaymentMethodResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"SetDefaultPaymentMethodResponse"},"SetPostgresBackupScheduleResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"schedules":{"items":{"type":"string"},"type":"array","title":"Schedules"}},"type":"object","required":["success","schedules"],"title":"SetPostgresBackupScheduleResponse"},"SetPricingRequest":{"properties":{"price_per_query":{"type":"number","maximum":10000,"minimum":0,"title":"Price Per Query","description":"Credit cost per query (0 = free)"},"currency":{"type":"string","title":"Currency","description":"Currency label","default":"credits"}},"type":"object","required":["price_per_query"],"title":"SetPricingRequest","description":"Request body for setting MCP pricing"},"SetPublicReadRequest":{"properties":{"project_id":{"type":"string","format":"uuid","title":"Project Id"},"prefixes":{"items":{"type":"string"},"type":"array","title":"Prefixes"}},"type":"object","required":["project_id","prefixes"],"title":"SetPublicReadRequest"},"SetTTLResponse":{"properties":{"status":{"type":"string","title":"Status"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"ttl_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Days"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"SetTTLResponse","description":"state_expiry_service.set_ttl()"},"SetThresholdsRequest":{"properties":{"quality_thresholds":{"additionalProperties":{"type":"number"},"type":"object","title":"Quality Thresholds","description":"Quality score thresholds"},"performance_thresholds":{"additionalProperties":{"type":"number"},"type":"object","title":"Performance Thresholds","description":"Performance metric thresholds"}},"type":"object","title":"SetThresholdsRequest"},"SetThresholdsResponse":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"quality_thresholds":{"additionalProperties":{"type":"number"},"type":"object","title":"Quality Thresholds"},"performance_thresholds":{"additionalProperties":{"type":"number"},"type":"object","title":"Performance Thresholds"},"set_by":{"type":"string","title":"Set By"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message"}},"type":"object","required":["prompt_id","quality_thresholds","performance_thresholds","set_by","timestamp","message"],"title":"SetThresholdsResponse","description":"Response for PUT /realtime-feedback/prompts/{prompt_id}/thresholds."},"SetUserSubscriptionResponse":{"properties":{"user_id":{"anyOf":[{},{"type":"null"}],"title":"User Id"},"email":{"anyOf":[{},{"type":"null"}],"title":"Email"},"plan":{"anyOf":[{},{"type":"null"}],"title":"Plan"},"effective_tier":{"anyOf":[{},{"type":"null"}],"title":"Effective Tier"},"subscription":{"anyOf":[{"$ref":"#/components/schemas/AdminUserSubscriptionRecord"},{"type":"null"}]},"message":{"anyOf":[{},{"type":"null"}],"title":"Message"},"created":{"anyOf":[{},{"type":"null"}],"title":"Created"},"tier":{"anyOf":[{},{"type":"null"}],"title":"Tier"}},"additionalProperties":true,"type":"object","title":"SetUserSubscriptionResponse","description":"PUT /{user_id}/subscription.\n\nThe handler returns `{\"message\": ..., **result}` where `result` is\n`_write_user_subscription_tier`'s `{\"created\", \"tier\", **read_shape}` --\ni.e. the GET shape plus three keys, which is why this subclasses it.\n\n`tier` here is the normalized UPPERCASE tier that was just written\n(e.g. \"ENTERPRISE\"); `effective_tier` inherited above is the lowercase\nresolved tier the dashboard will show. They are intentionally different\nvalues, not a duplicate field."},"SettlementStatusResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"pending_count":{"type":"integer","title":"Pending Count"},"pending_usd":{"type":"number","title":"Pending Usd"},"settled_count":{"type":"integer","title":"Settled Count"},"settled_usd":{"type":"number","title":"Settled Usd"},"total_earnings_usd":{"type":"number","title":"Total Earnings Usd"}},"type":"object","required":["user_id","pending_count","pending_usd","settled_count","settled_usd","total_earnings_usd"],"title":"SettlementStatusResponse"},"SetupDatabaseResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"tables_created":{"type":"integer","title":"Tables Created"},"database":{"type":"string","title":"Database"}},"type":"object","required":["success","message","tables_created","database"],"title":"SetupDatabaseResponse"},"SetupHelpdeskRequest":{"properties":{"company_name":{"type":"string","maxLength":255,"minLength":1,"title":"Company Name"},"site_url":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Site Url"},"brand_color":{"type":"string","maxLength":7,"title":"Brand Color","default":"#4B6FED"},"welcome_message":{"type":"string","maxLength":500,"title":"Welcome Message","default":"Hi! How can we help you today?"}},"type":"object","required":["company_name"],"title":"SetupHelpdeskRequest","description":"One-click helpdesk setup for a customer."},"SetupHelpdeskResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"helpdesk":{"$ref":"#/components/schemas/HelpdeskSetupSummary"},"widget":{"$ref":"#/components/schemas/WidgetSetupInfo"},"api":{"$ref":"#/components/schemas/ServiceOSApiInfo"},"next_steps":{"items":{"type":"string"},"type":"array","title":"Next Steps"}},"type":"object","required":["ok","helpdesk","widget","api","next_steps"],"title":"SetupHelpdeskResponse"},"Severity":{"type":"string","enum":["crit","high","med","low","info"],"title":"Severity","description":"Finding severity, ordered from most to least urgent."},"ShaclViolation":{"properties":{"focus_node":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Focus Node"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"}},"additionalProperties":true,"type":"object","title":"ShaclViolation"},"SharedDependency":{"properties":{"dependency_path":{"type":"string","title":"Dependency Path"},"dependency_type":{"type":"string","title":"Dependency Type"},"shared_with":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Shared With"}},"type":"object","required":["dependency_path","dependency_type"],"title":"SharedDependency"},"SharedTranscriptResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"transcript_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transcript Id"}},"type":"object","title":"SharedTranscriptResponse","description":"Result of submitting a shared session transcript."},"SidebarResponse":{"properties":{"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"},"badge_count":{"type":"integer","title":"Badge Count"}},"type":"object","required":["items","badge_count"],"title":"SidebarResponse"},"SignRequest":{"properties":{"typed_name":{"type":"string","title":"Typed Name","description":"Must match the officer on file"}},"type":"object","required":["typed_name"],"title":"SignRequest"},"SignatureRecord":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"document_file_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document File Id"},"document_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"reviewed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed At"},"reviewed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed By"},"signed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed At"},"signed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed By"},"signed_by_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed By Name"},"audit_trail":{"items":{"$ref":"#/components/schemas/AuditTrailEntry"},"type":"array","title":"Audit Trail"}},"type":"object","title":"SignatureRecord"},"SignatureSignedRecord":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"document_file_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document File Id"},"document_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"reviewed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed At"},"reviewed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed By"},"signed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed At"},"signed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed By"},"signed_by_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed By Name"},"audit_trail":{"items":{"$ref":"#/components/schemas/AuditTrailEntry"},"type":"array","title":"Audit Trail"},"stamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stamp"}},"type":"object","title":"SignatureSignedRecord"},"SignedCopyDownloadResponse":{"properties":{"document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Id"},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url"},"expires_in_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Seconds"}},"type":"object","title":"SignedCopyDownloadResponse"},"SigningOfficer":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"}},"type":"object","title":"SigningOfficer"},"SilaWebhookPayload":{"properties":{"event_type":{"type":"string","title":"Event Type","description":"Type of Sila event"},"transaction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction Id","description":"Sila transaction ID"},"reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Id","description":"Our internal reference ID"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Transaction status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Event message"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data","description":"Additional event data"}},"type":"object","required":["event_type"],"title":"SilaWebhookPayload","description":"Schema for Sila webhook payload"},"SilenceRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Agent identifier to record silence for"}},"type":"object","required":["agent_id"],"title":"SilenceRequest"},"SilenceResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"consecutive_silence_count":{"type":"integer","title":"Consecutive Silence Count"},"recorded_at":{"type":"string","title":"Recorded At"}},"type":"object","required":["agent_id","consecutive_silence_count","recorded_at"],"title":"SilenceResponse"},"SimilarChunkPair":{"properties":{"source_chunk":{"$ref":"#/components/schemas/CodeChunkPreview"},"target_chunk":{"$ref":"#/components/schemas/CodeChunkPreview"},"similarity_score":{"type":"number","title":"Similarity Score"}},"type":"object","required":["source_chunk","target_chunk","similarity_score"],"title":"SimilarChunkPair"},"SimilarCodeResult":{"properties":{"id":{"type":"integer","title":"Id"},"content":{"type":"string","title":"Content"},"file_path":{"type":"string","title":"File Path"},"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"start_line":{"type":"integer","title":"Start Line"},"end_line":{"type":"integer","title":"End Line"},"chunk_type":{"type":"string","title":"Chunk Type"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"similarity":{"type":"number","title":"Similarity"}},"type":"object","required":["id","content","file_path","project_id","project_name","start_line","end_line","chunk_type","similarity"],"title":"SimilarCodeResult"},"SimilarConversation":{"properties":{"conversation_id":{"type":"integer","title":"Conversation Id"},"subject":{"type":"string","title":"Subject"},"summary":{"type":"string","title":"Summary"},"resolution":{"type":"string","title":"Resolution"},"score":{"type":"number","title":"Score"},"url":{"type":"string","title":"Url"}},"type":"object","required":["conversation_id","subject","summary","resolution","score","url"],"title":"SimilarConversation"},"SimilarRequest":{"properties":{"query":{"type":"string","minLength":3,"title":"Query","description":"Search query — current conversation topic or message"},"top_k":{"type":"integer","maximum":20,"minimum":1,"title":"Top K","description":"Number of results to return","default":5},"min_score":{"type":"number","maximum":1,"minimum":0,"title":"Min Score","description":"Minimum similarity score threshold","default":0.7}},"type":"object","required":["query"],"title":"SimilarRequest"},"SimilarResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"results":{"items":{"$ref":"#/components/schemas/SimilarConversation"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["results","total"],"title":"SimilarResponse"},"SimilarTrace":{"properties":{"id":{"type":"string","title":"Id"},"session_id":{"type":"string","title":"Session Id"},"task":{"type":"string","title":"Task"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome"},"success":{"type":"boolean","title":"Success"},"similarity":{"type":"number","title":"Similarity"}},"type":"object","required":["id","session_id","task","success","similarity"],"title":"SimilarTrace"},"SimilaritySearchRequest":{"properties":{"query_text":{"type":"string","title":"Query Text","description":"Query text to find similar chunks for"},"limit":{"type":"integer","title":"Limit","description":"Maximum number of results to return","default":10},"threshold":{"type":"number","title":"Threshold","description":"Minimum similarity threshold (0.0 to 1.0)","default":0.7}},"type":"object","required":["query_text"],"title":"SimilaritySearchRequest"},"SimilaritySearchResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Service status"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project ID"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Query text that was searched"},"chunks":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Chunks","description":"Matching chunks with similarity scores"},"total_chunks":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Chunks","description":"Number of matches returned"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Embedding model used"},"cache_hit":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Cache Hit","description":"Whether results came from cache"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message when status=error"}},"additionalProperties":true,"type":"object","required":["status"],"title":"SimilaritySearchResponse","description":"Semantic similarity search results.\n\nThe handler also contains a batch branch keyed on a `query_texts`\nattribute, but SimilaritySearchRequest declares no such field and pydantic\nv2 models expose no undeclared attributes, so that branch is unreachable\nand its keys (batch_results/batch_count/optimized) are not modelled. They\nwould still pass through via extra=\"allow\" if the request schema ever\ngained `query_texts`."},"SimpleMessageResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"SimpleMessageResponse"},"SimulateRequest":{"properties":{"tool":{"type":"string","title":"Tool"},"target":{"type":"string","title":"Target","default":"*"},"capability":{"type":"string","title":"Capability","default":"*"},"args":{"additionalProperties":true,"type":"object","title":"Args"}},"type":"object","required":["tool"],"title":"SimulateRequest"},"SiteAnalytics":{"properties":{"visitors_today":{"type":"integer","title":"Visitors Today"},"page_views_today":{"type":"integer","title":"Page Views Today"},"bounce_rate":{"type":"number","title":"Bounce Rate"},"avg_session_duration":{"type":"string","title":"Avg Session Duration"}},"type":"object","required":["visitors_today","page_views_today","bounce_rate","avg_session_duration"],"title":"SiteAnalytics"},"SiteBackup":{"properties":{"backup_id":{"type":"string","title":"Backup Id"},"type":{"type":"string","title":"Type"},"created_at":{"type":"string","title":"Created At"},"size":{"type":"string","title":"Size"},"status":{"type":"string","title":"Status"}},"type":"object","required":["backup_id","type","created_at","size","status"],"title":"SiteBackup"},"SiteBackupCreateResponse":{"properties":{"backup_id":{"type":"string","title":"Backup Id"},"site_id":{"type":"string","title":"Site Id"},"type":{"type":"string","title":"Type"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"estimated_duration":{"type":"string","title":"Estimated Duration"},"message":{"type":"string","title":"Message"}},"type":"object","required":["backup_id","site_id","type","status","created_at","estimated_duration","message"],"title":"SiteBackupCreateResponse","description":"Response for POST /wordpress-agent/sites/{site_id}/backup."},"SiteCoreWebVitals":{"properties":{"lcp":{"type":"number","title":"Lcp"},"fid":{"type":"integer","title":"Fid"},"cls":{"type":"number","title":"Cls"}},"type":"object","required":["lcp","fid","cls"],"title":"SiteCoreWebVitals"},"SiteDetailsResponse":{"properties":{"site_id":{"type":"string","title":"Site Id"},"name":{"type":"string","title":"Name"},"url":{"type":"string","title":"Url"},"wp_version":{"type":"string","title":"Wp Version"},"php_version":{"type":"string","title":"Php Version"},"theme":{"$ref":"#/components/schemas/SiteTheme"},"plugins":{"items":{"$ref":"#/components/schemas/SitePlugin"},"type":"array","title":"Plugins"},"performance":{"$ref":"#/components/schemas/SitePerformance"},"security":{"$ref":"#/components/schemas/SiteSecurity"},"backups":{"items":{"$ref":"#/components/schemas/SiteBackup"},"type":"array","title":"Backups"},"analytics":{"$ref":"#/components/schemas/SiteAnalytics"}},"type":"object","required":["site_id","name","url","wp_version","php_version","theme","plugins","performance","security","backups","analytics"],"title":"SiteDetailsResponse","description":"Response for GET /wordpress-agent/sites/{site_id}."},"SitePerformance":{"properties":{"load_time":{"type":"number","title":"Load Time"},"page_speed_score":{"type":"integer","title":"Page Speed Score"},"core_web_vitals":{"$ref":"#/components/schemas/SiteCoreWebVitals"}},"type":"object","required":["load_time","page_speed_score","core_web_vitals"],"title":"SitePerformance"},"SitePlugin":{"properties":{"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version"},"status":{"type":"string","title":"Status"}},"type":"object","required":["name","version","status"],"title":"SitePlugin"},"SiteSecurity":{"properties":{"security_score":{"type":"integer","title":"Security Score"},"last_scan":{"type":"string","title":"Last Scan"},"vulnerabilities":{"type":"integer","title":"Vulnerabilities"},"malware_status":{"type":"string","title":"Malware Status"}},"type":"object","required":["security_score","last_scan","vulnerabilities","malware_status"],"title":"SiteSecurity"},"SiteTheme":{"properties":{"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version"},"author":{"type":"string","title":"Author"},"last_updated":{"type":"string","title":"Last Updated"}},"type":"object","required":["name","version","author","last_updated"],"title":"SiteTheme"},"SiteUpdateResponse":{"properties":{"update_id":{"type":"string","title":"Update Id"},"site_id":{"type":"string","title":"Site Id"},"updates":{"additionalProperties":true,"type":"object","title":"Updates"},"status":{"type":"string","title":"Status"},"backup_created":{"type":"boolean","title":"Backup Created"},"created_at":{"type":"string","title":"Created At"},"estimated_duration":{"type":"string","title":"Estimated Duration"},"message":{"type":"string","title":"Message"}},"type":"object","required":["update_id","site_id","updates","status","backup_created","created_at","estimated_duration","message"],"title":"SiteUpdateResponse","description":"Response for POST /wordpress-agent/sites/{site_id}/update."},"SkillCandidate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"confidence":{"type":"number","title":"Confidence"},"reinforcement_count":{"type":"integer","title":"Reinforcement Count"},"extracted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extracted At"},"ready_for_promotion":{"type":"boolean","title":"Ready For Promotion"}},"type":"object","required":["confidence","reinforcement_count","ready_for_promotion"],"title":"SkillCandidate"},"SkillCandidatesListResponse":{"properties":{"candidates":{"items":{"$ref":"#/components/schemas/SkillCandidate"},"type":"array","title":"Candidates"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["candidates","total"],"title":"SkillCandidatesListResponse"},"SkillCatalogResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"skills":{"items":{"$ref":"#/components/schemas/SkillResponse"},"type":"array","title":"Skills"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page","default":1},"page_size":{"type":"integer","title":"Page Size","default":50}},"type":"object","required":["skills","total"],"title":"SkillCatalogResponse","description":"List response for skill catalog."},"SkillDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"version":{"type":"string","title":"Version"},"author_name":{"type":"string","title":"Author Name"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"tier":{"type":"string","title":"Tier","default":"curated"},"origin":{"type":"string","title":"Origin","default":"ainative-curated"},"category":{"type":"string","title":"Category","default":"general"},"install_count":{"type":"integer","title":"Install Count","default":0},"compatibility":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Compatibility"},"trigger_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Trigger Patterns"},"token_cost_metadata":{"type":"integer","title":"Token Cost Metadata","default":0},"is_built_in":{"type":"boolean","title":"Is Built In","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"content":{"type":"string","title":"Content"},"examples":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Examples"},"references":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"References"},"commands":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Commands"},"dependencies":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Dependencies"},"validation_rules":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Validation Rules"}},"type":"object","required":["id","name","description","version","author_name","created_at","updated_at","content"],"title":"SkillDetailResponse","description":"Full skill detail including content."},"SkillInstallRequest":{"properties":{"skill_id":{"type":"string","title":"Skill Id"}},"type":"object","required":["skill_id"],"title":"SkillInstallRequest","description":"Request body for tracking a skill installation."},"SkillInstallResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"skill_id":{"type":"string","title":"Skill Id"},"install_count":{"type":"integer","title":"Install Count"}},"type":"object","required":["skill_id","install_count"],"title":"SkillInstallResponse","description":"Response after tracking installation."},"SkillPromotedResponse":{"properties":{"status":{"type":"string","title":"Status"},"name":{"type":"string","title":"Name"},"origin":{"type":"string","title":"Origin"}},"type":"object","required":["status","name","origin"],"title":"SkillPromotedResponse"},"SkillResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"version":{"type":"string","title":"Version"},"author_name":{"type":"string","title":"Author Name"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"tier":{"type":"string","title":"Tier","default":"curated"},"origin":{"type":"string","title":"Origin","default":"ainative-curated"},"category":{"type":"string","title":"Category","default":"general"},"install_count":{"type":"integer","title":"Install Count","default":0},"compatibility":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Compatibility"},"trigger_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Trigger Patterns"},"token_cost_metadata":{"type":"integer","title":"Token Cost Metadata","default":0},"is_built_in":{"type":"boolean","title":"Is Built In","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","description","version","author_name","created_at","updated_at"],"title":"SkillResponse","description":"Single skill in catalog response."},"SlackSendRequest":{"properties":{"channel":{"type":"string","title":"Channel","description":"Channel name or ID"},"message":{"type":"string","title":"Message","description":"Message text (Slack mrkdwn)"},"thread_ts":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thread Ts","description":"Thread timestamp to reply in"}},"type":"object","required":["channel","message"],"title":"SlackSendRequest"},"SlackSendResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"ts":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ts"},"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel"},"message":{"type":"string","title":"Message"}},"type":"object","required":["ok","message"],"title":"SlackSendResponse"},"SlotType":{"type":"string","enum":["video_preroll","banner_sidebar","email_header","content_native","audio_preroll"],"title":"SlotType","description":"Types of ad slots available for events"},"SlowQueryEntry":{"properties":{"query":{"type":"string","title":"Query"},"calls":{"type":"integer","title":"Calls"},"total_time":{"type":"number","title":"Total Time"},"mean_time":{"type":"number","title":"Mean Time"},"rows":{"type":"integer","title":"Rows"},"hit_percent":{"type":"number","title":"Hit Percent"}},"type":"object","required":["query","calls","total_time","mean_time","rows","hit_percent"],"title":"SlowQueryEntry"},"SlowQueryResponse":{"properties":{"id":{"type":"string","title":"Id"},"query_hash":{"type":"string","title":"Query Hash"},"query_preview":{"type":"string","title":"Query Preview"},"query_type":{"type":"string","title":"Query Type"},"execution_time_ms":{"type":"number","title":"Execution Time Ms"},"rows_examined":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Examined"},"rows_returned":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows Returned"},"endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"},"executed_at":{"type":"string","title":"Executed At"}},"type":"object","required":["id","query_hash","query_preview","query_type","execution_time_ms","rows_examined","rows_returned","endpoint","tenant_id","executed_at"],"title":"SlowQueryResponse","description":"Slow query response model"},"SnapshotComparisonRequest":{"properties":{"snapshot_id1":{"type":"string","title":"Snapshot Id1","description":"ID of the first snapshot"},"snapshot_id2":{"type":"string","title":"Snapshot Id2","description":"ID of the second snapshot"}},"type":"object","required":["snapshot_id1","snapshot_id2"],"title":"SnapshotComparisonRequest"},"SnapshotCreateRequest":{"properties":{"label":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Label","description":"Snapshot label"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional metadata"}},"type":"object","title":"SnapshotCreateRequest"},"SnapshotCreateResponse":{"properties":{"status":{"type":"string","title":"Status"},"snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"compressed_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Compressed Size Bytes"},"memory_records_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Records Count"},"has_sqlite":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Sqlite"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"SnapshotCreateResponse","description":"workspace_snapshot_service.create_snapshot()"},"SnapshotCreationRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"ID of the project"},"project_path":{"type":"string","title":"Project Path","description":"Path to the project directory"},"name":{"type":"string","title":"Name","description":"Name of the snapshot"},"description":{"type":"string","title":"Description","description":"Description of the snapshot"},"author":{"type":"string","title":"Author","description":"Author creating the snapshot"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Optional list of tags"}},"type":"object","required":["project_id","project_path","name","description","author"],"title":"SnapshotCreationRequest"},"SnapshotListResponse":{"properties":{"status":{"type":"string","title":"Status"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"total_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Count"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"},"offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Offset"},"has_more":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has More"},"snapshots":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_state__SnapshotListEntry"},"type":"array"},{"type":"null"}],"title":"Snapshots"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"SnapshotListResponse","description":"workspace_snapshot_service.list_snapshots()"},"SnapshotRequest":{"properties":{"url":{"type":"string","title":"Url"},"format":{"type":"string","title":"Format","default":"markdown"}},"type":"object","required":["url"],"title":"SnapshotRequest"},"SnapshotResponse":{"properties":{"url":{"type":"string","title":"Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"type":"string","title":"Content"},"word_count":{"type":"integer","title":"Word Count"},"snapshot_at":{"type":"string","title":"Snapshot At"},"zerodb_upserted":{"type":"boolean","title":"Zerodb Upserted"},"vector_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vector Id"}},"type":"object","required":["url","title","content","word_count","snapshot_at","zerodb_upserted","vector_id"],"title":"SnapshotResponse"},"SnapshotRestoreRequest":{"properties":{"snapshot_id":{"type":"string","title":"Snapshot Id","description":"ID of the snapshot to restore"},"target_path":{"type":"string","title":"Target Path","description":"Target path to restore to"},"backup":{"type":"boolean","title":"Backup","description":"Whether to backup existing files","default":true}},"type":"object","required":["snapshot_id","target_path"],"title":"SnapshotRestoreRequest"},"SnapshotRestoreResponse":{"properties":{"status":{"type":"string","title":"Status"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Id"},"restored_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Restored At"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"SnapshotRestoreResponse","description":"workspace_snapshot_service.restore_snapshot()"},"SnapshotSummaryRef":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","name"],"title":"SnapshotSummaryRef"},"SocialAccountSummary":{"properties":{"id":{"type":"string","title":"Id"},"platform":{"type":"string","title":"Platform"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"}},"type":"object","required":["id","platform"],"title":"SocialAccountSummary"},"SocialAnalyticsPoint":{"properties":{"date":{"type":"string","title":"Date"},"platform":{"type":"string","title":"Platform"},"views":{"type":"integer","title":"Views","default":0},"likes":{"type":"integer","title":"Likes","default":0},"comments":{"type":"integer","title":"Comments","default":0},"shares":{"type":"integer","title":"Shares","default":0},"saves":{"type":"integer","title":"Saves","default":0},"reach":{"type":"integer","title":"Reach","default":0},"impressions":{"type":"integer","title":"Impressions","default":0}},"type":"object","required":["date","platform"],"title":"SocialAnalyticsPoint"},"SocialAnalyticsSummaryEntry":{"properties":{"views":{"type":"integer","title":"Views"},"likes":{"type":"integer","title":"Likes"},"comments":{"type":"integer","title":"Comments"},"shares":{"type":"integer","title":"Shares"},"mom_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mom Delta"}},"type":"object","required":["views","likes","comments","shares"],"title":"SocialAnalyticsSummaryEntry"},"SocialLinks":{"properties":{"twitter":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Twitter","description":"Twitter/X username or URL"},"youtube":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Youtube","description":"YouTube channel URL"},"twitch":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Twitch","description":"Twitch username"},"discord":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Discord","description":"Discord server invite URL"},"github":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Github","description":"GitHub username"},"website":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Website","description":"Personal website URL"}},"type":"object","title":"SocialLinks","description":"Social media links for streamer profile","example":{"discord":"https://discord.gg/johndoe","github":"johndoe","twitch":"johndoe","twitter":"johndoe","website":"https://johndoe.dev","youtube":"https://youtube.com/@johndoe"}},"SocialPostRequest":{"properties":{"platform":{"type":"string","title":"Platform"},"text":{"type":"string","title":"Text","default":""},"visibility":{"type":"string","title":"Visibility","default":"PUBLIC"},"link_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Url"},"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel"},"subreddit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subreddit"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"}},"type":"object","required":["platform"],"title":"SocialPostRequest"},"SocialPostResponse":{"properties":{"published":{"type":"boolean","title":"Published"},"platform":{"type":"string","title":"Platform"},"post_url":{"type":"string","title":"Post Url"}},"type":"object","required":["published","platform","post_url"],"title":"SocialPostResponse"},"SocialStatsResponse":{"properties":{"followers_count":{"type":"integer","title":"Followers Count","description":"Number of followers"},"following_count":{"type":"integer","title":"Following Count","description":"Number of users following"},"friends_count":{"type":"integer","title":"Friends Count","description":"Number of friends"},"pending_requests_count":{"type":"integer","title":"Pending Requests Count","description":"Number of pending friend requests"}},"type":"object","required":["followers_count","following_count","friends_count","pending_requests_count"],"title":"SocialStatsResponse","description":"User's social statistics"},"SourceItem":{"properties":{"memory_id":{"type":"string","title":"Memory Id"},"score":{"type":"number","title":"Score"},"content_snippet":{"type":"string","title":"Content Snippet"}},"type":"object","required":["memory_id","score","content_snippet"],"title":"SourceItem"},"SparqlQueryRequest":{"properties":{"query":{"type":"string","title":"Query","description":"A SPARQL 1.1 SELECT/ASK/CONSTRUCT query"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Scope to a project namespace"},"max_rows":{"type":"integer","maximum":10000,"minimum":1,"title":"Max Rows","description":"Hard result cap","default":1000},"reason":{"type":"boolean","title":"Reason","description":"Include OWL-RL inferred triples","default":false}},"type":"object","required":["query"],"title":"SparqlQueryRequest","description":"A read-only SPARQL query over the caller's knowledge-graph projection."},"SparqlQueryResponse":{"properties":{"query_type":{"type":"string","title":"Query Type"},"truncated":{"type":"boolean","title":"Truncated"},"boolean":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Boolean"},"columns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Columns"},"rows":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Rows"},"project_scoping_honored":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Project Scoping Honored","description":"False when a requested project_id did NOT narrow the entity set (the result is the caller's whole cross-project set). Absent when no project_id was requested, or once scoping is real. Refs core#9432, core#9439."},"project_scoping_warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Scoping Warning","description":"Human-readable explanation, present only alongside project_scoping_honored=False."}},"additionalProperties":true,"type":"object","required":["query_type","truncated"],"title":"SparqlQueryResponse","description":"Response for POST /memory/v2/graph/sparql.\n\nMutually exclusive key sets: an ASK query returns ``boolean`` and no\ncolumns/rows; SELECT/CONSTRUCT return ``columns``+``rows`` and no boolean.\nRequires ``response_model_exclude_unset=True`` so an ASK result does not\ngrow a phantom ``\"rows\": null`` (and vice versa). SELECT row keys are the\nquery's own projected variable names, so rows stay free-form dicts."},"SpawnAgentRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Agent name"},"type":{"type":"string","title":"Type","description":"Agent type","default":"assistant"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities","description":"Agent capabilities"},"model_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Id","description":"Model ID for agent"},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Agent configuration"}},"type":"object","required":["name"],"title":"SpawnAgentRequest","description":"Request to spawn agent in session"},"SpawnAgentResponse":{"properties":{"message":{"type":"string","title":"Message"},"agent_id":{"type":"string","title":"Agent Id"},"session_id":{"type":"string","title":"Session Id"},"spawned_at":{"type":"string","title":"Spawned At"}},"type":"object","required":["message","agent_id","session_id","spawned_at"],"title":"SpawnAgentResponse","description":"Response for POST /collaboration/sessions/{session_id}/agents."},"SpawnStatusSummary":{"properties":{"pending":{"type":"integer","title":"Pending"},"spawning":{"type":"integer","title":"Spawning"},"executing":{"type":"integer","title":"Executing"},"completed":{"type":"integer","title":"Completed"},"failed":{"type":"integer","title":"Failed"}},"type":"object","required":["pending","spawning","executing","completed","failed"],"title":"SpawnStatusSummary"},"SpeechGenerateRequest":{"properties":{"text":{"type":"string","maxLength":5000,"minLength":1,"title":"Text","description":"Text to synthesize"},"model":{"type":"string","title":"Model","description":"Model: minimax-tts (RunPod/MiniMax), facebook-mms. 'elevenlabs'/'elevenlabs-tts' are cataloged but not currently available (503, Refs #8046).","default":"minimax-tts"},"voice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice","description":"Voice ID or speaker name"}},"type":"object","required":["text"],"title":"SpeechGenerateRequest","description":"Request schema for speech (TTS) generation"},"SpeechToSpeechResponse":{"properties":{"transcript":{"type":"string","title":"Transcript","description":"What the user said (ASR)"},"reply_text":{"type":"string","title":"Reply Text","description":"The assistant's reply text (LLM)"},"reply_audio_base64":{"type":"string","title":"Reply Audio Base64","description":"Base64 WAV/MP3 of the reply (TTS)"},"format":{"type":"string","title":"Format","description":"Reply audio format","default":"mp3"},"cost_credits":{"type":"integer","title":"Cost Credits","description":"Total credits charged (ASR+LLM+TTS, 100% markup)"}},"type":"object","required":["transcript","reply_text","reply_audio_base64","cost_credits"],"title":"SpeechToSpeechResponse"},"SponsorCreate":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User ID from existing auth system"},"company_name":{"type":"string","maxLength":200,"minLength":2,"title":"Company Name","description":"Company name"},"industry":{"type":"string","maxLength":100,"minLength":2,"title":"Industry","description":"Industry vertical"},"website_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Website Url","description":"Company website URL"},"contact_email":{"type":"string","format":"email","title":"Contact Email","description":"Primary contact email"},"billing_type":{"$ref":"#/components/schemas/BillingType","description":"Billing type","default":"prepaid"}},"type":"object","required":["user_id","company_name","industry","website_url","contact_email"],"title":"SponsorCreate","description":"Schema for creating a sponsor","example":{"billing_type":"prepaid","company_name":"AI Startup Inc","contact_email":"sponsor@aistartup.com","industry":"Artificial Intelligence","user_id":"550e8400-e29b-41d4-a716-446655440000","website_url":"https://aistartup.com"}},"SponsorResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Sponsor ID"},"user_id":{"type":"string","format":"uuid","title":"User Id","description":"Associated user ID"},"company_name":{"type":"string","title":"Company Name"},"industry":{"type":"string","title":"Industry"},"website_url":{"type":"string","title":"Website Url"},"contact_email":{"type":"string","title":"Contact Email"},"billing_type":{"$ref":"#/components/schemas/BillingType"},"ad_credits":{"type":"integer","title":"Ad Credits","description":"Total available ad credits"},"ad_credits_used":{"type":"integer","title":"Ad Credits Used","description":"Total credits used"},"auto_reload_enabled":{"type":"boolean","title":"Auto Reload Enabled","default":false},"auto_reload_threshold":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Auto Reload Threshold"},"auto_reload_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Auto Reload Amount"},"total_spend":{"type":"string","title":"Total Spend","description":"Total amount spent in USD"},"stripe_customer_id":{"type":"string","title":"Stripe Customer Id","description":"Stripe customer ID"},"status":{"$ref":"#/components/schemas/SponsorStatus"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","user_id","company_name","industry","website_url","contact_email","billing_type","ad_credits","ad_credits_used","total_spend","stripe_customer_id","status","created_at"],"title":"SponsorResponse","description":"Schema for sponsor response","example":{"ad_credits":1000,"ad_credits_used":350,"auto_reload_amount":500,"auto_reload_enabled":true,"auto_reload_threshold":100,"billing_type":"prepaid","company_name":"AI Startup Inc","contact_email":"sponsor@aistartup.com","created_at":"2026-01-05T12:00:00Z","id":"sponsor_abc123","industry":"Artificial Intelligence","status":"active","stripe_customer_id":"cus_abc123","total_spend":"350.00","updated_at":"2026-01-05T14:30:00Z","user_id":"550e8400-e29b-41d4-a716-446655440000","website_url":"https://aistartup.com"}},"SponsorRevenue":{"properties":{"sponsor_id":{"type":"string","title":"Sponsor Id","description":"Sponsor UUID"},"sponsor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor Name","description":"Sponsor name"},"total_spend":{"type":"string","title":"Total Spend","description":"Total spend","default":"0.00"},"campaigns_count":{"type":"integer","title":"Campaigns Count","description":"Number of campaigns","default":0},"impressions":{"type":"integer","title":"Impressions","description":"Total impressions","default":0},"clicks":{"type":"integer","title":"Clicks","description":"Total clicks","default":0},"avg_cpm":{"type":"string","title":"Avg Cpm","description":"Average CPM","default":"0.00"}},"type":"object","required":["sponsor_id"],"title":"SponsorRevenue","description":"Revenue breakdown by sponsor"},"SponsorSpend":{"properties":{"sponsor_id":{"type":"string","title":"Sponsor Id","description":"Sponsor UUID"},"sponsor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor Name","description":"Sponsor name"},"impressions":{"type":"integer","minimum":0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0,"title":"Clicks","default":0},"spend":{"type":"string","title":"Spend","description":"Total spend in USD","default":0},"revenue_share":{"type":"string","title":"Revenue Share","description":"Organizer's revenue share","default":0}},"type":"object","required":["sponsor_id"],"title":"SponsorSpend","description":"Sponsor spend breakdown for an event"},"SponsorStatus":{"type":"string","enum":["active","inactive","suspended"],"title":"SponsorStatus","description":"Sponsor account status"},"SponsorUpdate":{"properties":{"company_name":{"anyOf":[{"type":"string","maxLength":200,"minLength":2},{"type":"null"}],"title":"Company Name"},"industry":{"anyOf":[{"type":"string","maxLength":100,"minLength":2},{"type":"null"}],"title":"Industry"},"website_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Website Url"},"contact_email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Contact Email"},"auto_reload_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Reload Enabled"},"auto_reload_threshold":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Auto Reload Threshold","description":"Credits threshold for auto-reload"},"auto_reload_amount":{"anyOf":[{"type":"integer","minimum":10},{"type":"null"}],"title":"Auto Reload Amount","description":"Amount to reload in credits"}},"type":"object","title":"SponsorUpdate","description":"Schema for updating sponsor profile","example":{"auto_reload_amount":500,"auto_reload_enabled":true,"auto_reload_threshold":100,"company_name":"Updated Company Name","website_url":"https://newwebsite.com"}},"StackService":{"properties":{"layer":{"type":"string","title":"Layer"},"detail":{"type":"string","title":"Detail"},"status":{"type":"string","title":"Status"},"color":{"type":"string","title":"Color"}},"type":"object","required":["layer","detail","status","color"],"title":"StackService","description":"A single entry in the Platform Stack health display."},"StackTraceFrame":{"properties":{"file_path":{"type":"string","title":"File Path","description":"File path where the error occurred"},"line_number":{"type":"integer","title":"Line Number","description":"Line number where the error occurred"},"function_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Function Name","description":"Function or method name"},"code_snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Snippet","description":"Code snippet from the error location"},"is_app_code":{"type":"boolean","title":"Is App Code","description":"Whether this frame is from application code or library code","default":false}},"type":"object","required":["file_path","line_number"],"title":"StackTraceFrame","description":"Individual frame in a stack trace"},"StaleSource":{"properties":{"source_system":{"type":"string","title":"Source System"},"last_completed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Completed"},"hours_stale":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Hours Stale"}},"type":"object","required":["source_system"],"title":"StaleSource","description":"See data_lineage_service.check_staleness."},"StaleSourcesResponse":{"properties":{"threshold_hours":{"type":"integer","title":"Threshold Hours"},"stale_count":{"type":"integer","title":"Stale Count"},"stale_sources":{"items":{"$ref":"#/components/schemas/StaleSource"},"type":"array","title":"Stale Sources"}},"type":"object","required":["threshold_hours","stale_count","stale_sources"],"title":"StaleSourcesResponse"},"StartConversationResponse":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["conversation_id","status"],"title":"StartConversationResponse"},"StartIntakeResponse":{"properties":{"swarm_project_id":{"type":"string","title":"Swarm Project Id"},"already_running":{"type":"boolean","title":"Already Running"}},"type":"object","required":["swarm_project_id","already_running"],"title":"StartIntakeResponse"},"StartMonitoringResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","timestamp"],"title":"StartMonitoringResponse","description":"POST /deployment/monitoring/start — monitoring loop started."},"StartPostgresResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"project_id":{"type":"string","title":"Project Id"}},"type":"object","required":["status","message","project_id"],"title":"StartPostgresResponse"},"StartTestRequest":{"properties":{"test_cases":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Test Cases","description":"Custom test cases"},"providers":{"items":{"type":"string"},"type":"array","title":"Providers","description":"AI providers to test against"}},"type":"object","title":"StartTestRequest"},"StartTestResponse":{"properties":{"test_id":{"type":"string","title":"Test Id"},"message":{"type":"string","title":"Message"},"status":{"type":"string","title":"Status"},"test_cases_count":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Test Cases Count"},"providers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Providers"}},"type":"object","required":["test_id","message","status","test_cases_count","providers"],"title":"StartTestResponse","description":"Response for POST /ab-testing/tests/{test_id}/start."},"StartupCampRegistrationRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":2,"title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","minLength":8,"title":"Password"},"stripe_payment_method_id":{"type":"string","title":"Stripe Payment Method Id"},"utm_source":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Utm Source"},"utm_campaign":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Utm Campaign"}},"type":"object","required":["name","email","password","stripe_payment_method_id"],"title":"StartupCampRegistrationRequest"},"StartupCampRegistrationResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"token":{"type":"string","title":"Token"},"luma_registered":{"type":"boolean","title":"Luma Registered"},"trial_expires_at":{"type":"string","title":"Trial Expires At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["user_id","token","luma_registered","trial_expires_at","message"],"title":"StartupCampRegistrationResponse"},"StateInfoResponse":{"properties":{"status":{"type":"string","title":"Status"},"agent_id":{"type":"string","title":"Agent Id"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"max_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Size Bytes"},"usage_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Usage Percent"},"tables":{"anyOf":[{"items":{"$ref":"#/components/schemas/AgentStateTableInfo"},"type":"array"},{"type":"null"}],"title":"Tables"},"table_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Table Count"},"total_rows":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Rows"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status","agent_id"],"title":"StateInfoResponse","description":"agent_zerodb_state_service.get_state_info(), plus the handler's own\nzeroed fallback for the service's \"not_found\" branch.\n\nThe two branches carry different key sets — the fallback has no\n\"message\" — hence exclude_unset on the route."},"StateQueryRequest":{"properties":{"table_name":{"type":"string","maxLength":128,"title":"Table Name","description":"Table name within agent namespace","default":"default"},"filter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter","description":"Key-value filter (MongoDB-style)"},"limit":{"type":"integer","maximum":1000,"minimum":1,"title":"Limit","description":"Max rows to return","default":100},"offset":{"type":"integer","minimum":0,"title":"Offset","description":"Pagination offset","default":0}},"type":"object","title":"StateQueryRequest"},"StateQueryResponse":{"properties":{"status":{"type":"string","title":"Status"},"rows":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Rows"},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["status"],"title":"StateQueryResponse"},"StateRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"state_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Name"},"state_data":{"additionalProperties":true,"type":"object","title":"State Data"},"is_active":{"type":"boolean","title":"Is Active","default":true}},"type":"object","required":["agent_id","state_data"],"title":"StateRequest"},"StateTransferRequest":{"properties":{"target_agent_id":{"type":"string","title":"Target Agent Id"},"target_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Session Id"}},"type":"object","required":["target_agent_id"],"title":"StateTransferRequest"},"StatementKpi":{"properties":{"metric_name":{"type":"string","title":"Metric Name"},"metric_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Metric Value"},"metric_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Unit"},"delta_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Percent"},"delta_absolute":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Absolute"},"comparison_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comparison Type"}},"type":"object","required":["metric_name"],"title":"StatementKpi"},"StatementLineItem":{"properties":{"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"account_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount"},"metric_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Unit"},"percent_of_section":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percent Of Section"}},"type":"object","title":"StatementLineItem"},"StatementResponse":{"properties":{"statement_type":{"type":"string","title":"Statement Type"},"organization_id":{"type":"string","title":"Organization Id"},"period_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Id"},"sections":{"items":{"$ref":"#/components/schemas/StatementSection"},"type":"array","title":"Sections"},"kpis":{"items":{"$ref":"#/components/schemas/StatementKpi"},"type":"array","title":"Kpis"},"totals":{"additionalProperties":true,"type":"object","title":"Totals"}},"type":"object","required":["statement_type","organization_id","sections","kpis","totals"],"title":"StatementResponse"},"StatementSection":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"total":{"type":"number","title":"Total"},"line_items":{"items":{"$ref":"#/components/schemas/StatementLineItem"},"type":"array","title":"Line Items"}},"type":"object","required":["key","label","total","line_items"],"title":"StatementSection"},"StatsByNamespaceItem":{"properties":{"name":{"type":"string","title":"Name"},"vector_count":{"type":"integer","title":"Vector Count"},"storage_mb":{"type":"number","title":"Storage Mb"}},"type":"object","required":["name","vector_count","storage_mb"],"title":"StatsByNamespaceItem"},"StatsResponse":{"properties":{"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"vector_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vector Count"},"storage_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Storage Mb"},"dimensions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dimensions"},"index_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Index Type"},"avg_query_latency_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Query Latency Ms"},"total_vectors":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Vectors"},"total_namespaces":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Namespaces"},"total_storage_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Storage Mb"},"total_tables":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Tables"},"total_memories":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Memories"},"queries_last_24h":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Queries Last 24H"},"writes_last_24h":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Writes Last 24H"},"by_namespace":{"anyOf":[{"items":{"$ref":"#/components/schemas/StatsByNamespaceItem"},"type":"array"},{"type":"null"}],"title":"By Namespace"},"index_health":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Index Health"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"}},"type":"object","title":"StatsResponse","description":"get_stats() has 2 distinct shapes depending on whether a `namespace`\nquery param was passed, PLUS a 3rd except-swallowed fallback shape that\noverlaps the project-wide one minus project_id/project_name — hence\neverything being Optional rather than one field set always being\npresent."},"StatusOkResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"}},"type":"object","title":"StatusOkResponse","description":"Generic health/connectivity probe response."},"StatusServices":{"properties":{"api":{"type":"string","title":"Api"},"database":{"type":"string","title":"Database"},"cache":{"type":"string","title":"Cache"}},"type":"object","required":["api","database","cache"],"title":"StatusServices","description":"The three hardcoded service flags reported by GET /status."},"StepModel":{"properties":{"step":{"type":"string","title":"Step"},"ok":{"type":"boolean","title":"Ok"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["step","ok","detail"],"title":"StepModel"},"StepType":{"type":"string","enum":["information","action","validation","quiz","practice"],"title":"StepType","description":"Tutorial step types"},"StopAgentSwarmProjectAliasResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"StopAgentSwarmProjectAliasResponse"},"StopAgentSwarmProjectResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"stopped_at":{"type":"string","title":"Stopped At"},"final_progress":{"type":"integer","title":"Final Progress"}},"type":"object","required":["project_id","status","message","stopped_at","final_progress"],"title":"StopAgentSwarmProjectResponse"},"StopMonitoringResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","timestamp"],"title":"StopMonitoringResponse","description":"POST /deployment/monitoring/stop — monitoring loop stopped."},"StopPostgresResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"project_id":{"type":"string","title":"Project Id"}},"type":"object","required":["status","message","project_id"],"title":"StopPostgresResponse"},"StorageBucketsStubResponse":{"properties":{"buckets":{"items":{},"type":"array","title":"Buckets"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["buckets","total","message"],"title":"StorageBucketsStubResponse","description":"Response for GET /storage/buckets."},"StorageCapacityAnalysis":{"properties":{"total_gb":{"type":"number","title":"Total Gb"},"used_gb":{"type":"number","title":"Used Gb"},"free_gb":{"type":"number","title":"Free Gb"},"used_percent":{"type":"number","title":"Used Percent"},"backup_storage_gb":{"type":"number","title":"Backup Storage Gb"},"projected_growth_gb_per_month":{"type":"number","title":"Projected Growth Gb Per Month"}},"type":"object","required":["total_gb","used_gb","free_gb","used_percent","backup_storage_gb","projected_growth_gb_per_month"],"title":"StorageCapacityAnalysis"},"StorageHealthResponse":{"properties":{"storage":{"type":"string","title":"Storage"}},"additionalProperties":true,"type":"object","required":["storage"],"title":"StorageHealthResponse"},"StorageUsageBreakdown":{"properties":{"kv_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Kv Size Bytes"},"sqlite_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sqlite Size Bytes"},"memory_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Count"},"memory_estimated_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Estimated Bytes"},"snapshot_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Snapshot Count"},"snapshot_total_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Snapshot Total Bytes"}},"additionalProperties":true,"type":"object","title":"StorageUsageBreakdown"},"StoreCredentialRequest":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name","description":"Human-readable label"},"credential_type":{"type":"string","title":"Credential Type","description":"api_key | bearer_token | basic_auth | oauth2_client_credentials"},"credential_value":{"type":"string","maxLength":8192,"minLength":1,"title":"Credential Value","description":"Raw credential value (stored encrypted)"},"target_domain":{"anyOf":[{"type":"string","maxLength":253},{"type":"null"}],"title":"Target Domain","description":"Domain this credential is for"},"agent_ids":{"items":{"type":"string"},"type":"array","title":"Agent Ids","description":"Agent IDs allowed to use this credential"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["name","credential_type","credential_value"],"title":"StoreCredentialRequest","description":"Request body for POST /api/v1/cloud/credentials."},"StoreMemoryResponse":{"properties":{"id":{"type":"string","title":"Id"},"session_id":{"type":"string","title":"Session Id"},"content":{"type":"string","title":"Content"},"role":{"type":"string","title":"Role"},"timestamp":{"type":"string","title":"Timestamp"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","session_id","content","role","timestamp","metadata"],"title":"StoreMemoryResponse"},"StorefrontProduct":{"properties":{"product_key":{"type":"string","title":"Product Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"group":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group"},"description":{"type":"string","title":"Description","default":""},"unit_amount_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Unit Amount Cents"},"compare_at_amount_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Compare At Amount Cents"},"currency":{"type":"string","title":"Currency","default":"usd"},"billing_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Type"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval"},"requires_quote":{"type":"boolean","title":"Requires Quote","default":false},"self_serve_checkout":{"type":"boolean","title":"Self Serve Checkout","default":false},"available":{"type":"boolean","title":"Available","default":true},"owned":{"type":"boolean","title":"Owned"},"can_checkout":{"type":"boolean","title":"Can Checkout"}},"type":"object","required":["product_key","owned","can_checkout"],"title":"StorefrontProduct","description":"One catalog product annotated with this org's ownership (#7667)."},"StorefrontProductsResponse":{"properties":{"products":{"items":{"$ref":"#/components/schemas/StorefrontProduct"},"type":"array","title":"Products"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["products","organization_id"],"title":"StorefrontProductsResponse"},"StreamAnalytics":{"properties":{"stream_id":{"type":"string","format":"uuid","title":"Stream Id"},"total_views":{"type":"integer","minimum":0,"title":"Total Views","description":"Total number of viewer sessions"},"unique_viewers":{"type":"integer","minimum":0,"title":"Unique Viewers","description":"Unique viewers (users + anonymous sessions)"},"peak_viewers":{"type":"integer","minimum":0,"title":"Peak Viewers","description":"Maximum concurrent viewers"},"average_viewers":{"type":"number","minimum":0,"title":"Average Viewers","description":"Average concurrent viewers"},"total_watch_time_minutes":{"type":"integer","minimum":0,"title":"Total Watch Time Minutes","description":"Total watch time across all viewers"},"total_messages":{"type":"integer","minimum":0,"title":"Total Messages","description":"Total chat messages"},"unique_chatters":{"type":"integer","minimum":0,"title":"Unique Chatters","description":"Unique users who sent chat messages"}},"type":"object","required":["stream_id","total_views","unique_viewers","peak_viewers","average_viewers","total_watch_time_minutes","total_messages","unique_chatters"],"title":"StreamAnalytics","description":"Comprehensive stream analytics response","example":{"average_viewers":87.5,"peak_viewers":128,"stream_id":"987e6543-e21b-12d3-a456-426614174000","total_messages":1834,"total_views":523,"total_watch_time_minutes":12450,"unique_chatters":156,"unique_viewers":342}},"StreamAnalyticsSummary":{"properties":{"stream_id":{"type":"string","format":"uuid","title":"Stream Id"},"stream_title":{"type":"string","title":"Stream Title"},"stream_status":{"type":"string","title":"Stream Status"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"ended_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ended At"},"duration_minutes":{"type":"integer","minimum":0,"title":"Duration Minutes","description":"Stream duration in minutes"},"total_views":{"type":"integer","minimum":0,"title":"Total Views","description":"Total viewer sessions"},"unique_viewers":{"type":"integer","minimum":0,"title":"Unique Viewers","description":"Unique viewers"},"peak_viewers":{"type":"integer","minimum":0,"title":"Peak Viewers","description":"Peak concurrent viewers"},"average_viewers":{"type":"number","minimum":0,"title":"Average Viewers","description":"Average concurrent viewers"},"total_watch_time_minutes":{"type":"integer","minimum":0,"title":"Total Watch Time Minutes","description":"Total watch time"},"average_watch_time_minutes":{"type":"number","minimum":0,"title":"Average Watch Time Minutes","description":"Average watch time per viewer"},"total_messages":{"type":"integer","minimum":0,"title":"Total Messages","description":"Total chat messages"},"unique_chatters":{"type":"integer","minimum":0,"title":"Unique Chatters","description":"Unique chatters"},"chat_participation_rate":{"type":"number","maximum":100,"minimum":0,"title":"Chat Participation Rate","description":"Percentage of viewers who chatted"},"messages_per_minute":{"type":"number","minimum":0,"title":"Messages Per Minute","description":"Chat messages per minute"},"new_followers":{"type":"integer","minimum":0,"title":"New Followers","description":"New followers during stream"},"follow_conversion_rate":{"type":"number","maximum":100,"minimum":0,"title":"Follow Conversion Rate","description":"Follow conversion rate"},"returning_viewer_rate":{"type":"number","maximum":100,"minimum":0,"title":"Returning Viewer Rate","description":"Returning viewer rate"},"top_countries":{"items":{"$ref":"#/components/schemas/GeographicBreakdown"},"type":"array","title":"Top Countries","description":"Top 5 countries by viewer count"}},"type":"object","required":["stream_id","stream_title","stream_status","duration_minutes","total_views","unique_viewers","peak_viewers","average_viewers","total_watch_time_minutes","average_watch_time_minutes","total_messages","unique_chatters","chat_participation_rate","messages_per_minute","new_followers","follow_conversion_rate","returning_viewer_rate"],"title":"StreamAnalyticsSummary","description":"Comprehensive analytics summary combining all metrics","example":{"average_viewers":87.5,"average_watch_time_minutes":36.4,"chat_participation_rate":45.6,"duration_minutes":150,"ended_at":"2025-12-23T16:30:00Z","follow_conversion_rate":12.3,"messages_per_minute":12.3,"new_followers":42,"peak_viewers":128,"returning_viewer_rate":23.5,"started_at":"2025-12-23T14:00:00Z","stream_id":"987e6543-e21b-12d3-a456-426614174000","stream_status":"ended","stream_title":"Building a FastAPI Application","top_countries":[{"country_code":"US","country_name":"United States","percentage":36.5,"viewer_count":187}],"total_messages":1834,"total_views":523,"total_watch_time_minutes":12450,"unique_chatters":156,"unique_viewers":342}},"StreamCreate":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Stream title"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Stream description"},"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id","description":"Category ID for stream classification"},"is_vod_enabled":{"type":"boolean","title":"Is Vod Enabled","description":"Enable video-on-demand recording","default":true}},"type":"object","required":["title"],"title":"StreamCreate","description":"Schema for creating a new stream","example":{"category_id":"123e4567-e89b-12d3-a456-426614174000","description":"Join me as we build a production-ready chat application using FastAPI, WebSockets, and Redis","is_vod_enabled":true,"title":"Building a Real-time Chat App with FastAPI"}},"StreamDetailResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryResponse"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/StreamStatus"},"playback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playback Url","description":"HLS/DASH playback URL"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Stream thumbnail URL"},"viewer_count":{"type":"integer","title":"Viewer Count","default":0},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At","description":"When stream went live"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"streamer":{"$ref":"#/components/schemas/StreamerInfo"},"peak_viewers":{"type":"integer","title":"Peak Viewers","default":0},"ended_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ended At","description":"When stream ended"},"vod_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vod Url","description":"Video-on-demand URL after stream ends"},"is_vod_enabled":{"type":"boolean","title":"Is Vod Enabled","default":true}},"type":"object","required":["id","user_id","title","status","created_at","streamer"],"title":"StreamDetailResponse","description":"Extended stream response with additional analytics","example":{"ended_at":"2025-12-23T16:30:00Z","id":"987e6543-e21b-12d3-a456-426614174000","is_vod_enabled":true,"peak_viewers":523,"started_at":"2025-12-23T14:00:00Z","status":"ended","title":"Building a Real-time Chat App with FastAPI","user_id":"550e8400-e29b-41d4-a716-446655440000","viewer_count":0,"vod_url":"https://vod.ainative.studio/recordings/abc123xyz789.mp4"}},"StreamIngestInfo":{"properties":{"rtmps_url":{"type":"string","title":"Rtmps Url","description":"RTMPS ingest URL"},"rtmps_key":{"type":"string","title":"Rtmps Key","description":"RTMPS stream key (sensitive)"},"srt_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Srt Url","description":"SRT ingest URL (alternative)"},"webrtc_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webrtc Url","description":"WHIP WebRTC publish URL for browser streaming"}},"type":"object","required":["rtmps_url","rtmps_key"],"title":"StreamIngestInfo","description":"Stream ingest credentials and URLs.\n\nSECURITY: Only returned to stream owner via authenticated endpoints.\nContains sensitive streaming keys that should never be exposed publicly.","example":{"rtmps_key":"stream_abc123xyz789_secret","rtmps_url":"rtmps://live.ainative.studio:443/live","srt_url":"srt://live.ainative.studio:9999?streamid=abc123xyz789"}},"StreamListResponse":{"properties":{"streams":{"items":{"$ref":"#/components/schemas/StreamResponse"},"type":"array","title":"Streams"},"total":{"type":"integer","title":"Total","description":"Total streams matching filters"},"page":{"type":"integer","minimum":1,"title":"Page","description":"Current page number"},"per_page":{"type":"integer","maximum":100,"minimum":1,"title":"Per Page","description":"Items per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more pages exist"}},"type":"object","required":["streams","total","page","per_page","has_more"],"title":"StreamListResponse","description":"Paginated list of streams","example":{"has_more":true,"page":1,"per_page":20,"streams":[{"id":"987e6543-e21b-12d3-a456-426614174000","status":"live","title":"Building with FastAPI","viewer_count":342}],"total":1250}},"StreamResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryResponse"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/StreamStatus"},"playback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playback Url","description":"HLS/DASH playback URL"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Stream thumbnail URL"},"viewer_count":{"type":"integer","title":"Viewer Count","default":0},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At","description":"When stream went live"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"streamer":{"$ref":"#/components/schemas/StreamerInfo"}},"type":"object","required":["id","user_id","title","status","created_at","streamer"],"title":"StreamResponse","description":"Schema for stream response (public view)","example":{"category":{"id":"123e4567-e89b-12d3-a456-426614174000","is_active":true,"name":"Web Development","slug":"web-dev","stream_count":85},"created_at":"2025-12-23T13:55:00Z","description":"Join me as we build a production-ready chat application","id":"987e6543-e21b-12d3-a456-426614174000","playback_url":"https://stream.ainative.studio/hls/abc123xyz789/playlist.m3u8","started_at":"2025-12-23T14:00:00Z","status":"live","streamer":{"avatar_url":"https://storage.ainative.studio/avatars/johndoe.jpg","display_name":"John Doe","follower_count":1250,"id":"550e8400-e29b-41d4-a716-446655440000","is_verified":true,"username":"johndoe"},"thumbnail_url":"https://storage.ainative.studio/thumbnails/abc123.jpg","title":"Building a Real-time Chat App with FastAPI","user_id":"550e8400-e29b-41d4-a716-446655440000","viewer_count":342}},"StreamSearchResponse":{"properties":{"streams":{"items":{"$ref":"#/components/schemas/StreamResponse"},"type":"array","title":"Streams"},"total":{"type":"integer","title":"Total","description":"Total matching streams"},"page":{"type":"integer","minimum":1,"title":"Page","description":"Current page number"},"per_page":{"type":"integer","maximum":100,"minimum":1,"title":"Per Page","description":"Results per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results exist"},"query":{"type":"string","title":"Query","description":"Search query used"}},"type":"object","required":["streams","total","page","per_page","has_more","query"],"title":"StreamSearchResponse","description":"Paginated stream search results","example":{"has_more":true,"page":1,"per_page":20,"query":"FastAPI tutorial","streams":[{"id":"987e6543-e21b-12d3-a456-426614174000","status":"live","title":"Building with FastAPI","viewer_count":342}],"total":156}},"StreamStatus":{"type":"string","enum":["offline","live","ended"],"title":"StreamStatus","description":"Stream status enumeration"},"StreamTagsResponse":{"properties":{"stream_id":{"type":"string","format":"uuid","title":"Stream Id"},"tags":{"items":{"$ref":"#/components/schemas/TagResponse"},"type":"array","title":"Tags"}},"type":"object","required":["stream_id","tags"],"title":"StreamTagsResponse","description":"Response for stream tags","example":{"stream_id":"987e6543-e21b-12d3-a456-426614174000","tags":[{"id":"tag-1111-2222-3333-4444-555566667777","name":"FastAPI","slug":"fastapi","stream_count":42}]}},"StreamTagsUpdate":{"properties":{"tags":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Tags","description":"List of tag names (max 10)"}},"type":"object","required":["tags"],"title":"StreamTagsUpdate","description":"Schema for updating stream tags (add/replace)","example":{"tags":["FastAPI","Python","Web Development","Real-time"]}},"StreamUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Title","description":"Stream title"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Stream description"},"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id","description":"Category ID"},"is_vod_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Vod Enabled","description":"Enable/disable VOD recording"}},"type":"object","title":"StreamUpdate","description":"Schema for updating stream metadata","example":{"category_id":"123e4567-e89b-12d3-a456-426614174000","description":"Continuing our FastAPI chat application with authentication","is_vod_enabled":true,"title":"Building a Real-time Chat App - Part 2"}},"StreamWithIngestResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryResponse"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/StreamStatus"},"playback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playback Url","description":"HLS/DASH playback URL"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Stream thumbnail URL"},"viewer_count":{"type":"integer","title":"Viewer Count","default":0},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At","description":"When stream went live"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"streamer":{"$ref":"#/components/schemas/StreamerInfo"},"peak_viewers":{"type":"integer","title":"Peak Viewers","default":0},"ended_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ended At","description":"When stream ended"},"vod_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vod Url","description":"Video-on-demand URL after stream ends"},"is_vod_enabled":{"type":"boolean","title":"Is Vod Enabled","default":true},"ingest":{"$ref":"#/components/schemas/StreamIngestInfo"}},"type":"object","required":["id","user_id","title","status","created_at","streamer","ingest"],"title":"StreamWithIngestResponse","description":"Stream response with ingest credentials.\n\nSECURITY: Only returned to stream owner on authenticated endpoints.","example":{"id":"987e6543-e21b-12d3-a456-426614174000","ingest":{"rtmps_key":"stream_abc123xyz789_secret","rtmps_url":"rtmps://live.ainative.studio:443/live","srt_url":"srt://live.ainative.studio:9999?streamid=abc123xyz789"},"status":"offline","title":"My Stream"}},"StreamerInfo":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"username":{"type":"string","title":"Username"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"follower_count":{"type":"integer","title":"Follower Count","default":0},"is_verified":{"type":"boolean","title":"Is Verified","default":false}},"type":"object","required":["id","username"],"title":"StreamerInfo","description":"Embedded streamer information in stream responses","example":{"avatar_url":"https://storage.ainative.studio/avatars/johndoe.jpg","display_name":"John Doe","follower_count":1250,"id":"550e8400-e29b-41d4-a716-446655440000","is_verified":true,"username":"johndoe"}},"StreamerProfileResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"username":{"type":"string","title":"Username"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"banner_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Banner Url"},"social_links":{"anyOf":[{"$ref":"#/components/schemas/SocialLinks"},{"type":"null"}]},"is_live":{"type":"boolean","title":"Is Live","default":false},"is_verified":{"type":"boolean","title":"Is Verified","default":false},"is_partner":{"type":"boolean","title":"Is Partner","default":false},"is_affiliate":{"type":"boolean","title":"Is Affiliate","default":false},"current_stream":{"anyOf":[{"$ref":"#/components/schemas/StreamResponse"},{"type":"null"}]},"stats":{"$ref":"#/components/schemas/StreamerStats"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","username","stats","created_at"],"title":"StreamerProfileResponse","description":"Schema for streamer profile response","example":{"avatar_url":"https://storage.ainative.studio/avatars/johndoe.jpg","banner_url":"https://storage.ainative.studio/banners/johndoe.jpg","bio":"Full-stack developer and tech educator streaming web development and AI projects","created_at":"2025-01-15T10:00:00Z","current_stream":{"id":"987e6543-e21b-12d3-a456-426614174000","status":"live","title":"Building with FastAPI","viewer_count":342},"display_name":"John Doe","id":"550e8400-e29b-41d4-a716-446655440000","is_affiliate":false,"is_live":true,"is_partner":true,"is_verified":true,"social_links":{"twitter":"johndoe","youtube":"https://youtube.com/@johndoe"},"stats":{"average_viewers":45.8,"follower_count":1250,"total_stream_hours":342.5,"total_streams":87},"updated_at":"2025-12-23T14:30:00Z","username":"johndoe"}},"StreamerProfileUpdate":{"properties":{"bio":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Bio","description":"Streamer bio/description"},"stream_title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Stream Title","description":"Default stream title"},"stream_category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Stream Category Id","description":"Default stream category"},"social_links":{"anyOf":[{"$ref":"#/components/schemas/SocialLinks"},{"type":"null"}],"description":"Social media links"}},"type":"object","title":"StreamerProfileUpdate","description":"Schema for updating streamer profile","example":{"bio":"Full-stack developer and tech educator. Streaming web development, AI, and open source projects.","social_links":{"github":"johndoe","twitter":"johndoe","youtube":"https://youtube.com/@johndoe"},"stream_category_id":"123e4567-e89b-12d3-a456-426614174000","stream_title":"Building with FastAPI and React"}},"StreamerStats":{"properties":{"follower_count":{"type":"integer","minimum":0,"title":"Follower Count","description":"Total number of followers"},"total_stream_hours":{"type":"number","minimum":0,"title":"Total Stream Hours","description":"Total hours streamed"},"total_streams":{"type":"integer","minimum":0,"title":"Total Streams","description":"Total number of streams"},"average_viewers":{"type":"number","minimum":0,"title":"Average Viewers","description":"Average concurrent viewers across all streams"}},"type":"object","required":["follower_count","total_stream_hours","total_streams","average_viewers"],"title":"StreamerStats","description":"Statistics for streamer profile","example":{"average_viewers":45.8,"follower_count":1250,"total_stream_hours":342.5,"total_streams":87}},"StreamingTopicsResponse":{"properties":{"topics":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Topics"},"broker_status":{"type":"string","title":"Broker Status"},"source":{"type":"string","title":"Source"}},"type":"object","required":["topics","broker_status","source"],"title":"StreamingTopicsResponse","description":"RedPanda topic metadata with live reachability status. Refs #3410"},"StreamingTopicsStubResponse":{"properties":{"topics":{"items":{},"type":"array","title":"Topics"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["topics","total","message"],"title":"StreamingTopicsStubResponse","description":"Response for GET /streaming/topics."},"StripeCheckoutUrlData":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"sessionId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sessionid"}},"type":"object","title":"StripeCheckoutUrlData","description":"Shared by /credits/checkout and /ad-budget/checkout — both return a\nbare Stripe Checkout url + session id, nothing else."},"StripeCheckoutUrlResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/StripeCheckoutUrlData"}},"type":"object","required":["success","data"],"title":"StripeCheckoutUrlResponse","description":"POST /credits/checkout, POST /ad-budget/checkout"},"StripeConnectionResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"status":{"type":"string","title":"Status","description":"connected | expired | disconnected | error"},"needs_reconnect":{"type":"boolean","title":"Needs Reconnect","default":false},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nickname"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"initial_sync_status":{"type":"string","title":"Initial Sync Status","description":"State of the one-time full-history charge backfill kicked off by /connect: pending | complete | failed | disconnected. Poll this after connecting -- /connect returns before the history lands (Refs #7619).","default":"disconnected"},"initial_sync_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Initial Sync Error","description":"Why the initial backfill failed, if it did."},"last_synced_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Synced At"}},"type":"object","required":["org_id","status"],"title":"StripeConnectionResponse"},"StripeCustomerBackfillResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"},"dry_run":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dry Run"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success"],"title":"StripeCustomerBackfillResponse"},"StripeInvoiceDetail":{"properties":{"id":{"type":"string","title":"Id"},"amount":{"type":"number","title":"Amount"},"currency":{"type":"string","title":"Currency"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End"},"items":{"items":{"$ref":"#/components/schemas/StripeInvoiceLineItem"},"type":"array","title":"Items"}},"additionalProperties":true,"type":"object","required":["id","amount","currency","status","created_at"],"title":"StripeInvoiceDetail","description":"A single invoice as fetched live from Stripe (GET /billing/invoices/{invoice_id})."},"StripeInvoiceDetailResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/StripeInvoiceDetail"}},"type":"object","required":["success","data"],"title":"StripeInvoiceDetailResponse","description":"Response for GET /billing/invoices/{invoice_id}."},"StripeInvoiceLineItem":{"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount"},"quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quantity"}},"additionalProperties":true,"type":"object","title":"StripeInvoiceLineItem"},"StripePaymentMethod":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"card":{"anyOf":[{"$ref":"#/components/schemas/StripePaymentMethodCard"},{"type":"null"}]},"is_default":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Default"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"additionalProperties":true,"type":"object","required":["id","type"],"title":"StripePaymentMethod","description":"A payment method as returned live from Stripe (raw shape, not the masked PublicBillingInfoResponse one)."},"StripePaymentMethodCard":{"properties":{"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"last4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last4"},"exp_month":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Exp Month"},"exp_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Exp Year"}},"additionalProperties":true,"type":"object","title":"StripePaymentMethodCard"},"StripeStatusResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"plan_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Name"},"current_period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Period End"}},"type":"object","required":["connected"],"title":"StripeStatusResponse"},"SubmitAnswerResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"answers":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Answers"},"next_idx":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Idx"},"is_review":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Review"}},"type":"object","required":["ok"],"title":"SubmitAnswerResponse"},"SubmitTutorialFeedbackResponse":{"properties":{"feedback_id":{"type":"string","title":"Feedback Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"feedback":{"additionalProperties":true,"type":"object","title":"Feedback"}},"type":"object","required":["feedback_id","status","message","feedback"],"title":"SubmitTutorialFeedbackResponse","description":"Response for POST /onboarding-tutorials/feedback."},"SubscribeResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"SubscribeResponse"},"SubscriberListItem":{"properties":{"subscriber_id":{"type":"string","title":"Subscriber Id"},"subscriber_url":{"type":"string","title":"Subscriber Url"},"type":{"type":"string","title":"Type"},"domain":{"type":"string","title":"Domain"},"status":{"type":"string","title":"Status"},"created":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created"}},"type":"object","required":["subscriber_id","subscriber_url","type","domain","status"],"title":"SubscriberListItem"},"SubscriberListResponse":{"properties":{"subscribers":{"items":{"$ref":"#/components/schemas/SubscriberListItem"},"type":"array","title":"Subscribers"},"total":{"type":"integer","title":"Total"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["subscribers","total"],"title":"SubscriberListResponse"},"SubscriptionInfo":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","description":"Subscription ID","example":"sub_abc123"},"plan":{"type":"string","title":"Plan","description":"Subscription plan name","example":"professional"},"status":{"type":"string","title":"Status","description":"Subscription status","example":"active"},"current_period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Period Start","description":"Current period start date"},"current_period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Period End","description":"Current period end date"}},"type":"object","required":["plan","status"],"title":"SubscriptionInfo","description":"Detailed subscription information"},"SuccessResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Operation success status","default":true},"message":{"type":"string","title":"Message","description":"Success message"}},"type":"object","required":["message"],"title":"SuccessResponse","description":"Standard success response","example":{"message":"Operation completed successfully","success":true}},"Suggestion":{"properties":{"id":{"type":"string","title":"Id"},"analysis_id":{"type":"string","title":"Analysis Id"},"file_path":{"type":"string","title":"File Path"},"line_start":{"type":"integer","title":"Line Start"},"line_end":{"type":"integer","title":"Line End"},"suggestion_text":{"type":"string","title":"Suggestion Text"},"confidence_score":{"type":"number","title":"Confidence Score"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","analysis_id","file_path","line_start","line_end","suggestion_text","confidence_score","created_at"],"title":"Suggestion","description":"Response model for code suggestions"},"SuggestionCacheStats":{"properties":{"total_entries":{"type":"integer","title":"Total Entries"},"valid_entries":{"type":"integer","title":"Valid Entries"},"expired_entries":{"type":"integer","title":"Expired Entries"},"cache_ttl_seconds":{"type":"integer","title":"Cache Ttl Seconds"}},"type":"object","required":["total_entries","valid_entries","expired_entries","cache_ttl_seconds"],"title":"SuggestionCacheStats"},"SuggestionCacheStatsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/SuggestionCacheStats"}},"type":"object","required":["success","data"],"title":"SuggestionCacheStatsResponse","description":"Response for GET /zerodb/search/suggestions/stats."},"SuggestionFeedback":{"properties":{"feedback_type":{"type":"string","title":"Feedback Type","description":"Type of feedback (helpful, not_helpful, partially_helpful)"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment","description":"Optional comment about the suggestion"},"applied":{"type":"boolean","title":"Applied","description":"Whether the suggestion was applied","default":false}},"type":"object","required":["feedback_type"],"title":"SuggestionFeedback","description":"Request model for providing feedback on a suggestion"},"SuggestionType":{"type":"string","enum":["code_fix","logic_fix","performance_fix","security_fix","best_practice","refactoring"],"title":"SuggestionType","description":"Type of debugging suggestion"},"SupportedBanksResponse":{"properties":{"banks":{"items":{"type":"string"},"type":"array","title":"Banks","description":"All selectable bank providers, sorted (feeds a UI select)"},"live_sync":{"items":{"type":"string"},"type":"array","title":"Live Sync","description":"Providers with a real live-sync integration"}},"type":"object","required":["banks","live_sync"],"title":"SupportedBanksResponse","description":"Bank options for the Add-bank-account dialog's select (Refs #8449, #28).\n\n`banks` and `live_sync` are deliberately SEPARATE lists, not one list with\na flag: `banks` is every provider that can be recorded, while `live_sync`\nis the narrower set with a real sync integration. Both keys are\nunconditional, so no `response_model_exclude_unset` is needed."},"SupportedEnvironmentsResponse":{"properties":{"environments":{"items":{"$ref":"#/components/schemas/NamedDescriptionEntry"},"type":"array","title":"Environments"},"services":{"items":{"$ref":"#/components/schemas/NamedDescriptionEntry"},"type":"array","title":"Services"},"strategies":{"items":{"$ref":"#/components/schemas/NamedDescriptionEntry"},"type":"array","title":"Strategies"}},"type":"object","required":["environments","services","strategies"],"title":"SupportedEnvironmentsResponse","description":"Response for GET /railway-deployment/environments."},"SupportedIDE":{"properties":{"id":{"type":"string","title":"Id"},"file_path":{"type":"string","title":"File Path"},"instructions":{"type":"string","title":"Instructions"}},"type":"object","required":["id","file_path","instructions"],"title":"SupportedIDE"},"SuspendRequest":{"properties":{"suspend":{"type":"boolean","title":"Suspend","default":true}},"type":"object","title":"SuspendRequest"},"SwarmAnalyticsResponse":{"properties":{"swarm_id":{"type":"string","title":"Swarm Id"},"total_tasks":{"type":"integer","title":"Total Tasks"},"total_agents":{"type":"integer","title":"Total Agents"},"average_task_duration":{"type":"number","title":"Average Task Duration"},"agent_utilization":{"type":"number","title":"Agent Utilization"},"task_success_rate":{"type":"number","title":"Task Success Rate"},"average_response_time":{"type":"number","title":"Average Response Time"},"optimization_suggestions":{"items":{"type":"string"},"type":"array","title":"Optimization Suggestions"},"performance_trends":{"additionalProperties":{"items":{"type":"number"},"type":"array"},"type":"object","title":"Performance Trends"}},"type":"object","required":["swarm_id","total_tasks","total_agents","average_task_duration","agent_utilization","task_success_rate","average_response_time","optimization_suggestions","performance_trends"],"title":"SwarmAnalyticsResponse","description":"Swarm analytics response"},"SwarmConfigRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Swarm name"},"description":{"type":"string","title":"Description","description":"Swarm description","default":""},"max_agents":{"type":"integer","maximum":50,"minimum":1,"title":"Max Agents","description":"Maximum number of agents","default":10},"min_agents":{"type":"integer","maximum":10,"minimum":1,"title":"Min Agents","description":"Minimum number of agents","default":2},"auto_scale":{"type":"boolean","title":"Auto Scale","description":"Enable auto-scaling","default":true},"scale_threshold":{"type":"number","maximum":1,"minimum":0.1,"title":"Scale Threshold","description":"Utilization threshold for scaling","default":0.8},"timeout_minutes":{"type":"integer","maximum":1440,"minimum":5,"title":"Timeout Minutes","description":"Swarm timeout in minutes","default":60},"fault_tolerance":{"type":"boolean","title":"Fault Tolerance","description":"Enable fault tolerance","default":true},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities","description":"Required capabilities"}},"type":"object","required":["name"],"title":"SwarmConfigRequest","description":"Request to create a new swarm configuration"},"SwarmExecutionResponse":{"properties":{"execution_id":{"type":"string","title":"Execution Id"},"task_id":{"type":"string","title":"Task Id"},"swarm_id":{"type":"string","title":"Swarm Id"},"status":{"type":"string","title":"Status"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"assigned_agents":{"items":{"type":"string"},"type":"array","title":"Assigned Agents"},"coordinator_agent":{"type":"string","title":"Coordinator Agent"},"progress":{"additionalProperties":{"type":"number"},"type":"object","title":"Progress"},"overall_progress":{"type":"number","title":"Overall Progress"}},"type":"object","required":["execution_id","task_id","swarm_id","status","started_at","completed_at","assigned_agents","coordinator_agent","progress","overall_progress"],"title":"SwarmExecutionResponse","description":"Task execution response"},"SwarmQuotaResponse":{"properties":{"plan":{"type":"string","title":"Plan"},"credits_per_agent":{"type":"integer","title":"Credits Per Agent"},"concurrent_limit":{"type":"integer","title":"Concurrent Limit"},"concurrent_used":{"type":"integer","title":"Concurrent Used"},"concurrent_remaining":{"type":"integer","title":"Concurrent Remaining"},"monthly_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Monthly Limit"},"monthly_used":{"type":"integer","title":"Monthly Used"},"monthly_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Monthly Remaining"},"credit_balance":{"type":"number","title":"Credit Balance"},"next_reset_at":{"type":"string","format":"date-time","title":"Next Reset At"}},"type":"object","required":["plan","credits_per_agent","concurrent_limit","concurrent_used","concurrent_remaining","monthly_limit","monthly_used","monthly_remaining","credit_balance","next_reset_at"],"title":"SwarmQuotaResponse","description":"Current swarm quota status for the authenticated user."},"SwarmResponse":{"properties":{"swarm_id":{"type":"string","title":"Swarm Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"config":{"additionalProperties":true,"type":"object","title":"Config"},"agent_count":{"type":"integer","title":"Agent Count"},"active_tasks":{"type":"integer","title":"Active Tasks"},"completed_tasks":{"type":"integer","title":"Completed Tasks"},"performance_score":{"type":"number","title":"Performance Score"}},"type":"object","required":["swarm_id","name","description","status","created_at","updated_at","config","agent_count","active_tasks","completed_tasks","performance_score"],"title":"SwarmResponse","description":"Swarm information response"},"SwarmTaskListResponse":{"properties":{"tasks":{"items":{"$ref":"#/components/schemas/SwarmTaskResponse"},"type":"array","title":"Tasks"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["tasks","total","limit","offset"],"title":"SwarmTaskListResponse","description":"Paginated list of tasks."},"SwarmTaskRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Task name"},"description":{"type":"string","title":"Description","description":"Task description","default":""},"type":{"type":"string","title":"Type","description":"Task type","default":"independent"},"priority":{"type":"string","title":"Priority","description":"Task priority","default":"medium"},"requirements":{"additionalProperties":true,"type":"object","title":"Requirements","description":"Task requirements"},"subtasks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Subtasks","description":"Subtasks"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Task context"},"deadline_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Deadline Minutes","description":"Deadline in minutes from now"}},"type":"object","required":["name"],"title":"SwarmTaskRequest","description":"Request to create a swarm task"},"SwarmTaskResponse":{"properties":{"task_id":{"type":"string","title":"Task Id","description":"Stable UUID for the task"},"status":{"type":"string","title":"Status","description":"One of: queued, running, completed, failed, cancelled"},"description":{"type":"string","title":"Description","description":"Task description as submitted"},"agent_types":{"items":{"type":"string"},"type":"array","title":"Agent Types","description":"Agent roles involved in this task"},"registry_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registry Agent Id","description":"Registry agent ID if task was submitted via registry"},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Config as submitted"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result","description":"Task result payload; populated once status == 'completed'"},"agents_used":{"items":{"type":"string"},"type":"array","title":"Agents Used","description":"Agent IDs / labels that participated in execution"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"ISO-8601 creation timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"ISO-8601 last-updated timestamp"},"owner_id":{"type":"string","title":"Owner Id","description":"User ID that submitted the task"}},"type":"object","required":["task_id","status","description","agent_types","config","created_at","updated_at","owner_id"],"title":"SwarmTaskResponse","description":"Response returned for a single task."},"SwarmTaskSubmitRequest":{"properties":{"description":{"type":"string","maxLength":4096,"minLength":1,"title":"Description","description":"Natural-language description of the work to be done"},"agent_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Agent Types","description":"Agent roles to involve. Supported values: ['architect', 'backend', 'data', 'devops', 'docs', 'frontend', 'qa', 'security']. Optional when registry_agent_id is provided."},"registry_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registry Agent Id","description":"ID of a registered agent from the agent cloud registry. When provided, agent config is loaded from the registry and agent_types becomes optional."},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Arbitrary configuration forwarded to the swarm context"}},"type":"object","required":["description"],"title":"SwarmTaskSubmitRequest","description":"Body for POST /agent-swarm/tasks.\n\ndescription — natural-language task description; required.\nagent_types — subset of known agent roles to involve; defaults to\n [\"architect\", \"backend\", \"qa\"] when omitted.\nconfig — arbitrary caller-supplied key/value configuration that\n will be forwarded to the swarm execution context."},"SwarmTaskUpdateRequest":{"properties":{"status":{"type":"string","title":"Status","description":"New status: running, completed, failed, cancelled"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result","description":"Result payload (required when status=completed)"},"agents_used":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Agents Used","description":"Agent IDs that participated"}},"type":"object","required":["status"],"title":"SwarmTaskUpdateRequest"},"SyncConnectionListResponse":{"properties":{"connections":{"items":{"$ref":"#/components/schemas/SyncConnectionResponse"},"type":"array","title":"Connections"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["connections","total"],"title":"SyncConnectionListResponse"},"SyncConnectionResponse":{"properties":{"id":{"type":"string","title":"Id"},"provider":{"type":"string","title":"Provider"},"status":{"type":"string","title":"Status"},"last_synced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced At"},"memory_count":{"type":"integer","title":"Memory Count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","provider","status","created_at"],"title":"SyncConnectionResponse"},"SyncEnqueuedResponse":{"properties":{"message":{"type":"string","title":"Message","default":"Sync enqueued"},"connection_id":{"type":"string","title":"Connection Id"}},"type":"object","required":["connection_id"],"title":"SyncEnqueuedResponse"},"SyncResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"status":{"type":"string","title":"Status","default":"ok"},"detail":{"additionalProperties":true,"type":"object","title":"Detail"}},"type":"object","required":["org_id"],"title":"SyncResponse"},"SyncStatusResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"status":{"type":"string","title":"Status"},"last_synced_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Synced At"},"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"blocked_on_upstream":{"type":"boolean","title":"Blocked On Upstream","default":false}},"type":"object","required":["organization_id","status"],"title":"SyncStatusResponse"},"SyncTriggerResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["organization_id","status"],"title":"SyncTriggerResponse"},"SystemCreditsOverview":{"properties":{"users_with_credits":{"type":"integer","title":"Users With Credits"},"system_total_purchased":{"type":"number","title":"System Total Purchased"},"system_total_used":{"type":"number","title":"System Total Used"},"system_remaining":{"type":"number","title":"System Remaining"}},"type":"object","required":["users_with_credits","system_total_purchased","system_total_used","system_remaining"],"title":"SystemCreditsOverview"},"SystemHealthForDr":{"properties":{"disk_space":{"anyOf":[{"$ref":"#/components/schemas/DiskSpaceHealth"},{"type":"null"}]},"backup_storage":{"anyOf":[{"$ref":"#/components/schemas/BackupStorageHealth"},{"type":"null"}]},"database_health":{"anyOf":[{"$ref":"#/components/schemas/DatabaseHealthForDr"},{"type":"null"}]},"network_connectivity":{"anyOf":[{"$ref":"#/components/schemas/NetworkConnectivityHealth"},{"type":"null"}]},"service_availability":{"anyOf":[{"$ref":"#/components/schemas/CriticalServicesHealth"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","title":"SystemHealthForDr","description":"Two real shapes: happy path, and the except-fallback (just an\n`error` key) when the psutil/filesystem checks fail."},"SystemHealthOverview":{"properties":{"overall_status":{"type":"string","title":"Overall Status"},"health_score":{"type":"integer","title":"Health Score"},"issues":{"items":{"type":"string"},"type":"array","title":"Issues"},"services_up":{"type":"integer","title":"Services Up"},"services_total":{"type":"integer","title":"Services Total"},"last_incident":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Incident"},"uptime_percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Uptime Percentage"},"response_time_avg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Response Time Avg"}},"type":"object","required":["overall_status","health_score","issues","services_up","services_total"],"title":"SystemHealthOverview","description":"Two real shapes: happy path (full detail) and exception fallback."},"SystemInfo":{"properties":{"version":{"type":"string","title":"Version"},"environment":{"type":"string","title":"Environment"}},"type":"object","required":["version","environment"],"title":"SystemInfo"},"SystemMetricsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/app__schemas__dashboard_stats_public__SystemMetrics"},"admin_user":{"type":"string","title":"Admin User"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["success","data","admin_user"],"title":"SystemMetricsResponse","description":"Response for GET /database/admin/metrics."},"SystemMetricsTimeseries":{"properties":{"cpu_usage":{"$ref":"#/components/schemas/MetricTimeSeries"},"memory_usage":{"$ref":"#/components/schemas/MetricTimeSeries"},"disk_usage":{"$ref":"#/components/schemas/MetricTimeSeries"}},"type":"object","required":["cpu_usage","memory_usage","disk_usage"],"title":"SystemMetricsTimeseries"},"SystemStartResponse":{"properties":{"status":{"type":"string","title":"Status","description":"e.g. starting/already_running"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"},"started_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started By","description":"Present only on a real start (not already_running)"}},"type":"object","required":["status","message","timestamp"],"title":"SystemStartResponse","description":"Response for POST /realtime-feedback/system/start."},"SystemStatsDatabase":{"properties":{"connection_pool_size":{"type":"integer","title":"Connection Pool Size"},"active_connections":{"type":"integer","title":"Active Connections"},"slow_queries_count":{"type":"integer","title":"Slow Queries Count"},"avg_query_time_ms":{"type":"number","title":"Avg Query Time Ms"}},"type":"object","required":["connection_pool_size","active_connections","slow_queries_count","avg_query_time_ms"],"title":"SystemStatsDatabase"},"SystemStatsPerformance":{"properties":{"api_requests_per_second":{"type":"number","title":"Api Requests Per Second"},"cache_hit_rate":{"type":"number","title":"Cache Hit Rate"},"avg_response_time_ms":{"type":"number","title":"Avg Response Time Ms"}},"type":"object","required":["api_requests_per_second","cache_hit_rate","avg_response_time_ms"],"title":"SystemStatsPerformance"},"SystemStatsResponse":{"properties":{"system":{"$ref":"#/components/schemas/SystemStatsSystem"},"database":{"$ref":"#/components/schemas/SystemStatsDatabase"},"performance":{"$ref":"#/components/schemas/SystemStatsPerformance"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["system","database","performance","timestamp"],"title":"SystemStatsResponse","description":"Response for GET /system/stats."},"SystemStatsSystem":{"properties":{"total_users":{"type":"integer","title":"Total Users"},"total_projects":{"type":"integer","title":"Total Projects"},"total_vectors":{"type":"integer","title":"Total Vectors"},"total_tables":{"type":"integer","title":"Total Tables"},"total_storage_gb":{"type":"number","title":"Total Storage Gb"},"active_users_24h":{"type":"integer","title":"Active Users 24H"}},"type":"object","required":["total_users","total_projects","total_vectors","total_tables","total_storage_gb","active_users_24h"],"title":"SystemStatsSystem"},"SystemStatusItem":{"properties":{"status":{"type":"string","title":"Status"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"uptime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uptime"},"last_check":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Check"},"queue_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Queue Size"},"active_optimizations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Optimizations"},"agents_online":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Agents Online"}},"type":"object","required":["status"],"title":"SystemStatusItem"},"SystemStopResponse":{"properties":{"status":{"type":"string","title":"Status","description":"e.g. stopping/already_stopped"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"},"stopped_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stopped By","description":"Present only on a real stop (not already_stopped)"}},"type":"object","required":["status","message","timestamp"],"title":"SystemStopResponse","description":"Response for POST /realtime-feedback/system/stop."},"TTLRequest":{"properties":{"ttl_days":{"type":"integer","maximum":365,"minimum":1,"title":"Ttl Days","description":"TTL in days (1-365)"}},"type":"object","required":["ttl_days"],"title":"TTLRequest"},"TURNCredentials":{"properties":{"urls":{"items":{"type":"string"},"type":"array","title":"Urls","description":"TURN server URLs"},"username":{"type":"string","title":"Username","description":"TURN username"},"credential":{"type":"string","title":"Credential","description":"TURN password/credential"}},"type":"object","required":["urls","username","credential"],"title":"TURNCredentials","description":"TURN server credentials"},"TableInfo":{"properties":{"table_name":{"type":"string","title":"Table Name","description":"Table name"},"table_schema":{"type":"string","title":"Table Schema","description":"Schema name","default":"public"},"row_count":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Row Count","description":"Approximate row count"},"size_bytes":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Size Bytes","description":"Table size in bytes"},"columns":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Columns","description":"Column definitions","default":[]}},"type":"object","required":["table_name"],"title":"TableInfo","description":"Database table information","example":{"columns":[{"column_default":"nextval('users_id_seq'::regclass)","column_name":"id","data_type":"integer","is_nullable":false}],"row_count":1000,"size_bytes":65536,"table_name":"users","table_schema":"public"}},"TableSchemaResponse":{"properties":{"table":{"type":"string","title":"Table"},"columns":{"additionalProperties":{"type":"string"},"type":"object","title":"Columns"}},"type":"object","required":["table","columns"],"title":"TableSchemaResponse","description":"Column name -> PostgreSQL data type metadata for one allowlisted table."},"TableSizeMetrics":{"properties":{"total_tables":{"type":"integer","title":"Total Tables"},"table_sizes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Table Sizes"},"fastest_growing":{"type":"string","title":"Fastest Growing"},"recommended_partitioning":{"items":{"type":"string"},"type":"array","title":"Recommended Partitioning"},"vacuum_needed":{"items":{"type":"string"},"type":"array","title":"Vacuum Needed"},"analyze_needed":{"items":{"type":"string"},"type":"array","title":"Analyze Needed"}},"type":"object","required":["total_tables","table_sizes","fastest_growing","recommended_partitioning","vacuum_needed","analyze_needed"],"title":"TableSizeMetrics"},"TablesListResponse":{"properties":{"tables":{"items":{"$ref":"#/components/schemas/TableInfo"},"type":"array","title":"Tables","description":"List of database tables","default":[]},"total":{"type":"integer","minimum":0,"title":"Total","description":"Total number of tables"}},"type":"object","required":["total"],"title":"TablesListResponse","description":"Response model for tables list","example":{"tables":[{"columns":[],"row_count":1000,"size_bytes":65536,"table_name":"users","table_schema":"public"}],"total":5}},"TagListResponse":{"properties":{"tags":{"items":{"$ref":"#/components/schemas/TagResponse"},"type":"array","title":"Tags"},"total":{"type":"integer","title":"Total","description":"Total number of tags"}},"type":"object","required":["tags","total"],"title":"TagListResponse","description":"List of tags with stream counts","example":{"tags":[{"created_at":"2025-12-01T10:00:00Z","id":"tag-1111-2222-3333-4444-555566667777","name":"FastAPI","slug":"fastapi","stream_count":42}],"total":156}},"TagResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"stream_count":{"type":"integer","title":"Stream Count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","slug","created_at"],"title":"TagResponse","description":"Schema for tag response","example":{"created_at":"2025-12-01T10:00:00Z","description":"FastAPI web framework and API development","id":"tag-1111-2222-3333-4444-555566667777","name":"FastAPI","slug":"fastapi","stream_count":42,"updated_at":"2025-12-23T14:30:00Z"}},"TagStreamsResponse":{"properties":{"tag":{"additionalProperties":true,"type":"object","title":"Tag","description":"Tag row (raw columns from stream_tags)"},"streams":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Streams","description":"Stream rows (raw columns from live_streams + joins)"},"total":{"type":"integer","minimum":0,"title":"Total","default":0},"page":{"type":"integer","minimum":1,"title":"Page","default":1},"per_page":{"type":"integer","minimum":1,"title":"Per Page","default":20},"has_more":{"type":"boolean","title":"Has More","default":false}},"additionalProperties":true,"type":"object","required":["tag"],"title":"TagStreamsResponse","description":"Streams carrying a given tag, paginated.\n\nGET /streams/tags/by-name/{tag_name}\n\n`tag` and each `streams` entry come straight from `SELECT *` on\nstream_tags / live_streams, so both are open-ended dicts by design -\ntyping them strictly would silently drop live columns. The pagination\nenvelope is strict. Public data only, no permission filter upstream."},"TagSuggestionsResponse":{"properties":{"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id"},"category_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Name"},"suggestions":{"items":{"$ref":"#/components/schemas/TagResponse"},"type":"array","title":"Suggestions"}},"type":"object","required":["suggestions"],"title":"TagSuggestionsResponse","description":"Response for tag suggestions based on category","example":{"category_id":"123e4567-e89b-12d3-a456-426614174000","category_name":"Web Development","suggestions":[{"id":"tag-1111-2222-3333-4444-555566667777","name":"FastAPI","slug":"fastapi","stream_count":42}]}},"TaskClaimResponse":{"properties":{"task_id":{"type":"string","title":"Task Id","description":"UUID of the claimed task"},"name":{"type":"string","title":"Name","description":"Task name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Task description"},"task_type":{"type":"string","title":"Task Type","description":"Task type slug"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters","description":"Task parameters"},"priority":{"type":"integer","title":"Priority","description":"Priority (lower = higher priority)"},"status":{"type":"string","title":"Status","description":"Current status (should be RUNNING after claim)"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the task was created"}},"type":"object","required":["task_id","name","task_type","priority","status","created_at"],"title":"TaskClaimResponse","description":"Response when an agent claims the next pending task."},"TaskCompleteRequest":{"properties":{"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result","description":"JSON result payload from the agent"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Error message if the task failed"},"logs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logs","description":"Execution logs from the agent"},"success":{"type":"boolean","title":"Success","description":"Whether the task completed successfully (False = FAILED)","default":true}},"type":"object","title":"TaskCompleteRequest","description":"Body for POST /agents/tasks/{task_id}/complete."},"TaskCompleteResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"},"completed_at":{"type":"string","format":"date-time","title":"Completed At"}},"type":"object","required":["task_id","status","completed_at"],"title":"TaskCompleteResponse","description":"Response after marking a task complete."},"TaskCreateRequest":{"properties":{"name":{"type":"string","title":"Name"},"task_type":{"type":"string","title":"Task Type"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters","default":{}},"priority":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Priority","default":5},"assigned_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Agent Id"},"estimated_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Duration"}},"type":"object","required":["name","task_type"],"title":"TaskCreateRequest"},"TaskExecutionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","data","message"],"title":"TaskExecutionResponse"},"TaskLogEntry":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"level":{"type":"string","title":"Level"},"message":{"type":"string","title":"Message"},"details":{"anyOf":[{},{"type":"null"}],"title":"Details"}},"type":"object","required":["timestamp","level","message"],"title":"TaskLogEntry"},"TaskMeter":{"properties":{"claude_tasks_used":{"type":"integer","title":"Claude Tasks Used","default":0},"claude_tasks_allowance":{"type":"integer","title":"Claude Tasks Allowance","default":0},"claude_tasks_remaining":{"type":"integer","title":"Claude Tasks Remaining","default":0},"fast_tasks_used":{"type":"integer","title":"Fast Tasks Used","default":0},"fast_tasks_unlimited":{"type":"boolean","title":"Fast Tasks Unlimited","default":true},"claude_spend_usd":{"type":"number","title":"Claude Spend Usd","default":0}},"type":"object","title":"TaskMeter","description":"'Tasks, not credits' meter — folded into the summary the CLI already reads.\nRefs #4412"},"TaskMeterResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"tier":{"type":"string","title":"Tier"},"period":{"type":"string","title":"Period"},"claude_tasks_used":{"type":"integer","title":"Claude Tasks Used"},"claude_tasks_allowance":{"type":"integer","title":"Claude Tasks Allowance"},"claude_tasks_remaining":{"type":"integer","title":"Claude Tasks Remaining"},"fast_tasks_used":{"type":"integer","title":"Fast Tasks Used"},"fast_tasks_unlimited":{"type":"boolean","title":"Fast Tasks Unlimited","default":true},"claude_spend_usd":{"type":"number","title":"Claude Spend Usd"},"total_tasks":{"type":"integer","title":"Total Tasks"}},"type":"object","required":["tier","period","claude_tasks_used","claude_tasks_allowance","claude_tasks_remaining","fast_tasks_used","claude_spend_usd","total_tasks"],"title":"TaskMeterResponse","description":"The 'tasks, not credits' meter — honest, transparent usage view. Refs #4412"},"TaskOutcomeModel":{"properties":{"task_id":{"type":"string","title":"Task Id"},"category":{"type":"string","title":"Category"},"passed":{"type":"boolean","title":"Passed"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["task_id","category","passed","reason"],"title":"TaskOutcomeModel"},"TaskResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"task_type":{"type":"string","title":"Task Type"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters"},"status":{"type":"string","title":"Status"},"priority":{"type":"integer","title":"Priority"},"created_by":{"type":"string","title":"Created By"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"assigned_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Agent Id"},"progress":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Progress"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["id","name","task_type","parameters","status","priority","created_by","created_at"],"title":"TaskResponse"},"TaskTriggerRequest":{"properties":{"task":{"type":"string","title":"Task"},"kwargs":{"additionalProperties":true,"type":"object","title":"Kwargs","default":{}}},"type":"object","required":["task"],"title":"TaskTriggerRequest"},"TaskTriggerResponse":{"properties":{"task":{"type":"string","title":"Task"},"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["task","task_id","status"],"title":"TaskTriggerResponse"},"TaskUpdateRequest":{"properties":{"status":{"type":"string","title":"Status"},"progress":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Progress"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["status"],"title":"TaskUpdateRequest"},"TaxFormDownloadResponse":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"year":{"type":"integer","title":"Year"},"status":{"type":"string","title":"Status"},"download_url":{"type":"string","title":"Download Url"}},"type":"object","required":["id","type","year","status","download_url"],"title":"TaxFormDownloadResponse","description":"Download target for one of the caller's own tax forms (Refs #8826).\n\nDeliberately narrower than TaxFormItem: a download response carries no\nsubmitted_at/approved_at, so a caller who is probing form ids learns\nnothing beyond the document they already own."},"TaxFormItem":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"year":{"type":"integer","title":"Year"},"status":{"type":"string","title":"Status"},"file_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Url"},"submitted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Submitted At"},"approved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approved At"}},"type":"object","required":["id","type","year","status"],"title":"TaxFormItem"},"TeamMember":{"properties":{"name":{"type":"string","title":"Name"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"status":{"type":"string","title":"Status"}},"type":"object","required":["name","email","role","status"],"title":"TeamMember"},"TeamMemoryEntriesResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"repo":{"type":"string","title":"Repo"},"entries":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Entries"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["org_id","repo"],"title":"TeamMemoryEntriesResponse","description":"Full team memory entries for a repo."},"TeamMemoryEntry":{"properties":{"key":{"type":"string","title":"Key","description":"Memory entry key / identifier"},"content":{"type":"string","title":"Content","description":"Memory content text"},"hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hash","description":"SHA-256 checksum of content"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Optional metadata for the entry"}},"type":"object","required":["key","content"],"title":"TeamMemoryEntry","description":"A single team memory entry."},"TeamMemoryPayload":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/TeamMemoryEntry"},"type":"array","title":"Entries","description":"List of team memory entries"}},"type":"object","required":["entries"],"title":"TeamMemoryPayload","description":"Payload for uploading team memory for a repo."},"TeamMemoryResponse":{"properties":{"org_id":{"type":"string","format":"uuid","title":"Org Id"},"repo":{"type":"string","title":"Repo"},"entries":{"items":{"$ref":"#/components/schemas/TeamMemoryEntry"},"type":"array","title":"Entries"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["org_id","repo","entries"],"title":"TeamMemoryResponse","description":"Response when fetching team memory for a repo."},"TeamWorkflow":{"properties":{"id":{"type":"string","title":"Id","description":"Workflow ID"},"team_id":{"type":"string","title":"Team Id","description":"Team ID the workflow belongs to"},"project_id":{"type":"string","title":"Project Id","description":"Project ID the workflow is scoped to"},"workflow_name":{"type":"string","title":"Workflow Name","description":"Workflow name"},"workflow_definition":{"additionalProperties":true,"type":"object","title":"Workflow Definition","description":"Workflow definition payload"},"status":{"type":"string","title":"Status","description":"Workflow status, e.g. draft"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By","description":"User ID who created the workflow"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"ISO creation timestamp"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At","description":"ISO last-update timestamp"}},"type":"object","required":["id","team_id","project_id","workflow_name","workflow_definition","status"],"title":"TeamWorkflow","description":"A team workflow, as returned by create/get/update/list-by-team."},"TelemetryBatchRequest":{"properties":{"events":{"items":{"$ref":"#/components/schemas/app__schemas__cli_telemetry__TelemetryEvent"},"type":"array","maxItems":100,"minItems":1,"title":"Events","description":"Array of telemetry events (max 100 per batch)"}},"type":"object","required":["events"],"title":"TelemetryBatchRequest","description":"Batch of telemetry events submitted together."},"TelemetryBatchResponse":{"properties":{"accepted":{"type":"integer","title":"Accepted","description":"Number of events successfully accepted"},"rejected":{"type":"integer","title":"Rejected","description":"Number of events rejected"}},"type":"object","required":["accepted","rejected"],"title":"TelemetryBatchResponse","description":"Response after processing a batch of telemetry events."},"TelemetryResponse":{"properties":{"received":{"type":"boolean","title":"Received"},"event_id":{"type":"string","title":"Event Id"}},"type":"object","required":["received","event_id"],"title":"TelemetryResponse"},"TeleportEvent":{"properties":{"type":{"type":"string","title":"Type"},"timestamp":{"type":"string","title":"Timestamp"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["type","timestamp","data"],"title":"TeleportEvent","description":"A single teleport event."},"TeleportEventsListResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"events":{"items":{"$ref":"#/components/schemas/TeleportEvent"},"type":"array","title":"Events"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["session_id","events"],"title":"TeleportEventsListResponse","description":"Response for GET /sessions/{session_id}/teleport-events. Refs #3169."},"TeleportEventsRequest":{"properties":{"events":{"items":{"$ref":"#/components/schemas/TeleportEvent"},"type":"array","title":"Events"}},"type":"object","required":["events"],"title":"TeleportEventsRequest","description":"Request body for POST teleport events."},"TeleportEventsResponse":{"properties":{"accepted":{"type":"integer","title":"Accepted"}},"type":"object","required":["accepted"],"title":"TeleportEventsResponse","description":"Response for POST teleport events."},"TemplateDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"use_case":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Use Case"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}},"current_version":{"anyOf":[{},{"type":"null"}],"title":"Current Version"},"created_by":{"type":"string","title":"Created By"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"is_active":{"type":"boolean","title":"Is Active","default":true},"version_count":{"type":"integer","title":"Version Count"},"versions":{"items":{"$ref":"#/components/schemas/TemplateVersionSummary"},"type":"array","title":"Versions"}},"type":"object","required":["id","name","created_by","version_count","versions"],"title":"TemplateDetailResponse","description":"Response for GET /templates/{template_id} -- the serialized\ntemplate plus version_count and a summary versions list."},"TemplateItem":{"properties":{"template_id":{"type":"string","title":"Template Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"entity_types":{"items":{},"type":"array","title":"Entity Types"},"predicates":{"additionalProperties":true,"type":"object","title":"Predicates"},"seed_entity_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed Entity Count"}},"additionalProperties":true,"type":"object","required":["template_id"],"title":"TemplateItem","description":"One template from GET /memory/v2/graph/templates.\n\n``predicates`` is a nested ``{entity_type: {predicate: target_type}}``\nmapping, and ``entity_types`` a list of names — both come straight from\nthe static TEMPLATES table."},"TemplateListEntry":{"properties":{"template_id":{"type":"string","title":"Template Id"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"complexity":{"type":"string","title":"Complexity"},"description":{"type":"string","title":"Description"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["template_id","name","type","complexity","description","created_at"],"title":"TemplateListEntry","description":"One entry from LangflowTemplate.list_templates()."},"TemplateType":{"type":"string","enum":["basic_agent","conversational_agent","rag_agent","tool_calling_agent","multi_agent","data_processing","api_integration","custom_workflow"],"title":"TemplateType","description":"Langflow template types"},"TemplateVersionMetricEntry":{"properties":{"version_id":{"type":"string","title":"Version Id"},"version_number":{"title":"Version Number"},"status":{"title":"Status"},"overall_score":{"title":"Overall Score"},"success_rate":{"title":"Success Rate"},"last_evaluated":{"anyOf":[{},{"type":"null"}],"title":"Last Evaluated"}},"type":"object","required":["version_id","version_number","status","overall_score","success_rate"],"title":"TemplateVersionMetricEntry"},"TemplateVersionSummary":{"properties":{"id":{"type":"string","title":"Id"},"version_number":{"anyOf":[{},{"type":"null"}],"title":"Version Number"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id"],"title":"TemplateVersionSummary"},"TenantCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name","description":"Tenant name","examples":["Acme Corporation"]},"slug":{"type":"string","maxLength":100,"minLength":1,"title":"Slug","description":"Tenant slug (URL-safe)","examples":["acme-corp"]},"display_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Display Name","description":"Display name","examples":["Acme Corp"]},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description","description":"Tenant description","examples":["Leading provider of innovative solutions"]},"domain":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Domain","description":"Custom domain","examples":["acme.ainative.studio"]},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url","description":"Logo URL","examples":["https://cdn.ainative.studio/logos/acme.png"]},"banner_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Banner Url","description":"Banner URL","examples":["https://cdn.ainative.studio/banners/acme.jpg"]},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier","description":"Tenant tier (free, pro, enterprise)","examples":["pro"]},"max_members":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Members","description":"Maximum members allowed","examples":[100]},"max_storage_gb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Storage Gb","description":"Maximum storage in GB","examples":[50]}},"type":"object","required":["name","slug"],"title":"TenantCreate","description":"Schema for creating a new tenant","examples":[{"description":"Leading provider of innovative solutions","display_name":"Acme Corp","domain":"acme.ainative.studio","logo_url":"https://cdn.ainative.studio/logos/acme.png","name":"Acme Corporation","slug":"acme-corp","tier":"pro"}]},"TenantCreateResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Created tenant ID"},"slug":{"type":"string","title":"Slug","description":"Tenant slug"},"name":{"type":"string","title":"Name","description":"Tenant name"},"tier":{"type":"string","title":"Tier","description":"Tenant tier"},"status":{"type":"string","title":"Status","description":"Tenant status"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"}},"type":"object","required":["id","slug","name","tier","status","created_at"],"title":"TenantCreateResponse","description":"Schema for tenant creation response"},"TenantListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TenantSummary"},"type":"array","title":"Items","description":"List of tenants"},"total":{"type":"integer","title":"Total","description":"Total number of tenants"},"offset":{"type":"integer","title":"Offset","description":"Number of items skipped"},"limit":{"type":"integer","title":"Limit","description":"Number of items per page"}},"type":"object","required":["items","total","offset","limit"],"title":"TenantListResponse","description":"Schema for tenant list response"},"TenantResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Tenant ID"},"name":{"type":"string","title":"Name","description":"Tenant name"},"slug":{"type":"string","title":"Slug","description":"Tenant slug"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name","description":"Display name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Tenant description"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Custom domain"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url","description":"Logo URL"},"banner_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Banner Url","description":"Banner URL"},"tier":{"type":"string","title":"Tier","description":"Tenant tier"},"status":{"type":"string","title":"Status","description":"Tenant status"},"max_members":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Members","description":"Maximum members allowed"},"max_storage_gb":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Storage Gb","description":"Maximum storage in GB"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["id","name","slug","tier","status","created_at"],"title":"TenantResponse","description":"Schema for tenant response with all details"},"TenantRole":{"type":"string","enum":["OWNER","ADMIN","MEMBER","GUEST"],"title":"TenantRole","description":"Tenant member roles for RBAC"},"TenantSettingsUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name","description":"Tenant name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description","description":"Tenant description"},"status":{"anyOf":[{"$ref":"#/components/schemas/TenantStatus"},{"type":"null"}],"description":"Tenant status"}},"type":"object","title":"TenantSettingsUpdate","description":"Schema for updating tenant settings (ADMIN only)"},"TenantStatus":{"type":"string","enum":["active","suspended","deleted"],"title":"TenantStatus","description":"Tenant status"},"TenantSummary":{"properties":{"id":{"type":"string","title":"Id","description":"Tenant ID"},"name":{"type":"string","title":"Name","description":"Tenant name"},"slug":{"type":"string","title":"Slug","description":"Tenant slug"},"tier":{"type":"string","title":"Tier","description":"Tenant tier"},"status":{"type":"string","title":"Status","description":"Tenant status"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"}},"type":"object","required":["id","name","slug","tier","status","created_at"],"title":"TenantSummary","description":"Schema for tenant summary in list"},"TenantUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name","description":"Tenant name"},"display_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Display Name","description":"Display name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description","description":"Tenant description"},"domain":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Domain","description":"Custom domain"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url","description":"Logo URL"},"banner_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Banner Url","description":"Banner URL"}},"type":"object","title":"TenantUpdate","description":"Schema for updating tenant information"},"TenantUsageResponse":{"properties":{"period_start":{"type":"string","title":"Period Start"},"period_end":{"type":"string","title":"Period End"},"total_requests":{"type":"integer","title":"Total Requests"},"successful_requests":{"type":"integer","title":"Successful Requests"},"failed_requests":{"type":"integer","title":"Failed Requests"},"avg_response_time_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Response Time Ms"},"errors_4xx":{"type":"integer","title":"Errors 4Xx"},"errors_5xx":{"type":"integer","title":"Errors 5Xx"},"bytes_sent":{"type":"integer","title":"Bytes Sent"},"bytes_received":{"type":"integer","title":"Bytes Received"},"endpoint_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Endpoint Breakdown"},"method_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Method Breakdown"}},"type":"object","required":["period_start","period_end","total_requests","successful_requests","failed_requests","avg_response_time_ms","errors_4xx","errors_5xx","bytes_sent","bytes_received","endpoint_breakdown","method_breakdown"],"title":"TenantUsageResponse","description":"Tenant usage response model"},"TerminateRequest":{"properties":{"user_id":{"type":"string","title":"User Id","description":"Must match the session owner (UUID)"},"quarantine":{"type":"boolean","title":"Quarantine","description":"If true, set status to 'quarantined' instead of 'terminated'","default":false}},"type":"object","required":["user_id"],"title":"TerminateRequest"},"TermsAcceptRequest":{"properties":{"agreement_type":{"type":"string","minLength":1,"title":"Agreement Type","description":"Agreement identifier, e.g. SD-BASE"},"version":{"type":"string","minLength":1,"title":"Version","description":"Version of the agreement, e.g. 1.0"},"user_agent":{"type":"string","minLength":1,"title":"User Agent","description":"Browser or agent user-agent string"},"page_url":{"type":"string","minLength":1,"title":"Page Url","description":"URL of the page where consent was given"}},"type":"object","required":["agreement_type","version","user_agent","page_url"],"title":"TermsAcceptRequest","description":"Request body for accepting terms."},"TermsAcceptResponse":{"properties":{"accepted_at":{"type":"string","title":"Accepted At"},"confirmation_key":{"type":"string","title":"Confirmation Key"}},"type":"object","required":["accepted_at","confirmation_key"],"title":"TermsAcceptResponse","description":"Response returned after recording consent."},"TestAuthTestLoginResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"},"user":{"$ref":"#/components/schemas/TestAuthTestLoginUser"}},"type":"object","required":["access_token","token_type","user"],"title":"TestAuthTestLoginResponse"},"TestAuthTestLoginUser":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","email","name"],"title":"TestAuthTestLoginUser"},"TestCaseSuggestion":{"properties":{"test_title":{"type":"string","title":"Test Title","description":"Title of the test case"},"test_description":{"type":"string","title":"Test Description","description":"Description of what the test checks"},"test_code":{"type":"string","title":"Test Code","description":"Actual test code"},"test_type":{"$ref":"#/components/schemas/TestType","description":"Type of the test"},"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework","description":"Test framework to use"},"id":{"type":"string","title":"Id","description":"Unique ID of the test case suggestion"},"session_id":{"type":"string","title":"Session Id","description":"ID of the debugging session"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"}},"type":"object","required":["test_title","test_description","test_code","test_type","id","session_id","created_at"],"title":"TestCaseSuggestion","description":"Schema for a test case suggestion"},"TestCaseSuggestionCreate":{"properties":{"test_title":{"type":"string","title":"Test Title","description":"Title of the test case"},"test_description":{"type":"string","title":"Test Description","description":"Description of what the test checks"},"test_code":{"type":"string","title":"Test Code","description":"Actual test code"},"test_type":{"$ref":"#/components/schemas/TestType","description":"Type of the test"},"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework","description":"Test framework to use"},"session_id":{"type":"string","title":"Session Id","description":"ID of the debugging session"}},"type":"object","required":["test_title","test_description","test_code","test_type","session_id"],"title":"TestCaseSuggestionCreate","description":"Schema for creating a test case suggestion"},"TestConnectionResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"status":{"type":"string","title":"Status"},"tested_at":{"type":"string","title":"Tested At"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"scopes_verified":{"type":"boolean","title":"Scopes Verified","default":false}},"type":"object","required":["ok","status","tested_at"],"title":"TestConnectionResponse"},"TestNotificationRequest":{"properties":{"message":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Message","description":"Custom test message (optional)"},"recipient":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Recipient","description":"Test recipient (for email channels)"}},"type":"object","title":"TestNotificationRequest","description":"Request schema for testing notification channel.\n\nOptional custom message for test notifications.\nIf not provided, a default test message will be sent.","example":{"message":"Test notification from admin panel","recipient":"admin@example.com"}},"TestNotificationResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the test was successful"},"channel_id":{"type":"string","title":"Channel Id","description":"ID of the tested channel"},"channel_type":{"type":"string","title":"Channel Type","description":"Type of notification channel"},"delivery_time_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Delivery Time Ms","description":"Time taken to deliver notification in milliseconds"},"error_details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Details","description":"Error message if test failed"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Timestamp of test execution"}},"type":"object","required":["success","channel_id","channel_type"],"title":"TestNotificationResponse","description":"Response schema for test notification result.\n\nReturns:\n - success: Whether the test was successful\n - channel_id: ID of the tested channel\n - channel_type: Type of notification channel\n - delivery_time_ms: Time taken to deliver in milliseconds\n - error_details: Error message if test failed\n - timestamp: When the test was performed","example":{"channel_id":"550e8400-e29b-41d4-a716-446655440000","channel_type":"slack","delivery_time_ms":234,"success":true,"timestamp":"2025-01-07T12:00:00Z"}},"TestPingResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Status Code"},"attempts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Attempts"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"TestPingResponse"},"TestProviderRequest":{"properties":{"provider":{"type":"string","title":"Provider","description":"Provider type (smtp, sendgrid, ses, resend)"},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Provider configuration"}},"type":"object","required":["provider","config"],"title":"TestProviderRequest","description":"Request model for testing provider configuration","example":{"config":{"from_email":"noreply@example.com","smtp_host":"smtp.gmail.com","smtp_password":"password","smtp_port":587,"smtp_username":"user@example.com","use_tls":true},"provider":"smtp"}},"TestResultResponse":{"properties":{"test_id":{"type":"string","title":"Test Id"},"analysis_timestamp":{"type":"string","format":"date-time","title":"Analysis Timestamp"},"winning_variant":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Winning Variant"},"confidence_level":{"type":"number","title":"Confidence Level"},"p_value":{"type":"number","title":"P Value"},"effect_size":{"type":"number","title":"Effect Size"},"statistical_significance":{"type":"string","title":"Statistical Significance"},"sample_sizes":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sample Sizes"},"conversion_rates":{"additionalProperties":{"type":"number"},"type":"object","title":"Conversion Rates"},"performance_metrics":{"additionalProperties":{"additionalProperties":{"type":"number"},"type":"object"},"type":"object","title":"Performance Metrics"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["test_id","analysis_timestamp","winning_variant","confidence_level","p_value","effect_size","statistical_significance","sample_sizes","conversion_rates","performance_metrics","recommendations"],"title":"TestResultResponse"},"TestStatisticsResponse":{"properties":{"test_id":{"type":"string","title":"Test Id"},"statistical_power":{"type":"number","title":"Statistical Power"},"confidence_level":{"type":"number","title":"Confidence Level"},"minimum_sample_size":{"type":"integer","title":"Minimum Sample Size"},"current_sample_sizes":{"additionalProperties":{"type":"integer"},"type":"object","title":"Current Sample Sizes"},"statistical_significance":{"type":"string","title":"Statistical Significance"},"p_value":{"type":"number","title":"P Value"},"effect_size":{"type":"number","title":"Effect Size"},"confidence_interval":{"$ref":"#/components/schemas/ConfidenceInterval"},"power_analysis":{"$ref":"#/components/schemas/PowerAnalysis"},"conversion_rates":{"additionalProperties":{"type":"number"},"type":"object","title":"Conversion Rates"},"performance_comparison":{"additionalProperties":{"additionalProperties":{"type":"number"},"type":"object"},"type":"object","title":"Performance Comparison"}},"type":"object","required":["test_id","statistical_power","confidence_level","minimum_sample_size","current_sample_sizes","statistical_significance","p_value","effect_size","confidence_interval","power_analysis","conversion_rates","performance_comparison"],"title":"TestStatisticsResponse","description":"Response for GET /ab-testing/tests/{test_id}/statistics."},"TestType":{"type":"string","enum":["unit","integration","functional","regression","edge_case"],"title":"TestType","description":"Type of test case suggestion"},"TestVariantRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Variant name (e.g., 'Control', 'Variant_A')"},"prompt_version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Version Id","description":"Prompt version ID if using versioned prompts"},"prompt_content":{"type":"string","title":"Prompt Content","description":"Prompt content to test"},"traffic_allocation":{"type":"number","maximum":1,"minimum":0,"title":"Traffic Allocation","description":"Traffic allocation (0.0-1.0)","default":0.5},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional variant metadata"}},"type":"object","required":["name","prompt_content"],"title":"TestVariantRequest"},"TestVersionRequest":{"properties":{"test_cases":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Test Cases","description":"Test cases for evaluation"},"providers":{"items":{"type":"string"},"type":"array","title":"Providers","description":"AI providers to test against"},"comparison_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comparison Version","description":"Version to compare against (A/B test)"}},"type":"object","title":"TestVersionRequest"},"TestVersionResponse":{"properties":{"version_id":{"type":"string","title":"Version Id"},"message":{"type":"string","title":"Message"},"test_type":{"type":"string","title":"Test Type"},"status":{"type":"string","title":"Status"}},"type":"object","required":["version_id","message","test_type","status"],"title":"TestVersionResponse"},"TestWebsocketBroadcastResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["project_id","message","timestamp"],"title":"TestWebsocketBroadcastResponse"},"ThreadCreateRequest":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"agent_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Agent Types"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","title":"ThreadCreateRequest"},"ThreadDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"agent_types":{"items":{"type":"string"},"type":"array","title":"Agent Types"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"status":{"type":"string","title":"Status"},"message_count":{"type":"integer","title":"Message Count"},"last_message_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Message At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"messages":{"items":{"$ref":"#/components/schemas/ThreadMessageResponse"},"type":"array","title":"Messages"}},"type":"object","required":["id","title","agent_types","model","status","message_count","last_message_at","metadata","created_at","updated_at","messages"],"title":"ThreadDetailResponse"},"ThreadListResponse":{"properties":{"threads":{"items":{"$ref":"#/components/schemas/ThreadResponse"},"type":"array","title":"Threads"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["threads","total"],"title":"ThreadListResponse"},"ThreadMessageResponse":{"properties":{"id":{"type":"string","title":"Id"},"thread_id":{"type":"string","title":"Thread Id"},"role":{"type":"string","title":"Role"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"tool_calls":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tool Calls"},"tool_call_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Call Id"},"tokens_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens Used"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","thread_id","role","content","tool_calls","tool_call_id","tokens_used","model","created_at"],"title":"ThreadMessageResponse"},"ThreadResponse":{"properties":{"id":{"type":"string","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"agent_types":{"items":{"type":"string"},"type":"array","title":"Agent Types"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"status":{"type":"string","title":"Status"},"message_count":{"type":"integer","title":"Message Count"},"last_message_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Message At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","title","agent_types","model","status","message_count","last_message_at","metadata","created_at","updated_at"],"title":"ThreadResponse"},"ThreadSearchRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":1,"title":"Query"},"mode":{"type":"string","pattern":"^(fulltext|semantic)$","title":"Mode","default":"fulltext"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","default":20}},"type":"object","required":["query"],"title":"ThreadSearchRequest","description":"Search threads by title and message content - Refs #2367"},"ThreadSearchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/ThreadSearchResult"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"},"query":{"type":"string","title":"Query"},"mode":{"type":"string","title":"Mode"}},"type":"object","required":["results","total","query","mode"],"title":"ThreadSearchResponse","description":"Paginated search response - Refs #2367"},"ThreadSearchResult":{"properties":{"thread_id":{"type":"string","title":"Thread Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"},"relevance_score":{"type":"number","title":"Relevance Score"},"message_count":{"type":"integer","title":"Message Count"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["thread_id","title","snippet","relevance_score","message_count","updated_at"],"title":"ThreadSearchResult","description":"Single search result with relevance scoring - Refs #2367"},"ThreatLevel":{"type":"string","enum":["low","medium","high","critical"],"title":"ThreatLevel","description":"Security threat levels"},"ThreatStatisticsResponse":{"properties":{"overview":{"additionalProperties":true,"type":"object","title":"Overview"},"event_types":{"additionalProperties":{"type":"integer"},"type":"object","title":"Event Types"},"threat_levels":{"additionalProperties":{"type":"integer"},"type":"object","title":"Threat Levels"},"top_attacked_endpoints":{"items":{"$ref":"#/components/schemas/CountedEndpointRow"},"type":"array","title":"Top Attacked Endpoints"},"top_attack_user_agents":{"items":{"$ref":"#/components/schemas/CountedUserAgentRow"},"type":"array","title":"Top Attack User Agents"},"hourly_trend":{"items":{"$ref":"#/components/schemas/HourlyTrendRow"},"type":"array","title":"Hourly Trend"},"analysis_period":{"additionalProperties":true,"type":"object","title":"Analysis Period"}},"additionalProperties":true,"type":"object","required":["overview","event_types","threat_levels","top_attacked_endpoints","top_attack_user_agents","hourly_trend","analysis_period"],"title":"ThreatStatisticsResponse","description":"GET /threat-statistics -- all seven keys are always present."},"ThumbsFeedback":{"type":"string","enum":["up","down"],"title":"ThumbsFeedback","description":"Thumbs up/down feedback values"},"TierBreakdown":{"properties":{"tier":{"type":"string","title":"Tier"},"count":{"type":"integer","title":"Count"},"percentage":{"type":"number","title":"Percentage"}},"type":"object","required":["tier","count","percentage"],"title":"TierBreakdown"},"TierOverrideRequest":{"properties":{"tier":{"type":"string","title":"Tier","description":"Execution tier: 'isolate' or 'container'"}},"type":"object","required":["tier"],"title":"TierOverrideRequest"},"TierOverrideResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"tier":{"type":"string","title":"Tier"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["agent_id","tier","updated_at"],"title":"TierOverrideResponse"},"TierStatsResponse":{"properties":{"total_decisions":{"type":"integer","title":"Total Decisions"},"isolate_count":{"type":"integer","title":"Isolate Count"},"container_count":{"type":"integer","title":"Container Count"},"isolate_percentage":{"type":"number","title":"Isolate Percentage"},"container_percentage":{"type":"number","title":"Container Percentage"},"override_count":{"type":"integer","title":"Override Count"},"avg_cold_start_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Cold Start Ms"},"avg_warm_start_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Warm Start Ms"},"top_isolate_workloads":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Isolate Workloads"},"top_container_workloads":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Container Workloads"}},"type":"object","required":["total_decisions","isolate_count","container_count","isolate_percentage","container_percentage","override_count","top_isolate_workloads","top_container_workloads"],"title":"TierStatsResponse"},"TimeRange-Output":{"type":"string","enum":["24h","7d","30d","custom"],"title":"TimeRange","description":"Preset time ranges for filtering metrics"},"TimeRangeMetrics":{"properties":{"last_24h":{"type":"integer","title":"Last 24H","description":"Total in last 24 hours","default":0},"last_7d":{"type":"integer","title":"Last 7D","description":"Total in last 7 days","default":0},"last_30d":{"type":"integer","title":"Last 30D","description":"Total in last 30 days","default":0}},"type":"object","title":"TimeRangeMetrics","description":"Metrics for different time ranges"},"TimeSeriesChartConfig":{"properties":{"type":{"type":"string","title":"Type"},"x_axis":{"type":"string","title":"X Axis"},"y_axis":{"type":"string","title":"Y Axis"},"title":{"type":"string","title":"Title"},"show_trend_line":{"type":"boolean","title":"Show Trend Line"},"show_annotations":{"type":"boolean","title":"Show Annotations"}},"type":"object","required":["type","x_axis","y_axis","title","show_trend_line","show_annotations"],"title":"TimeSeriesChartConfig"},"TimeSeriesChartResponse":{"properties":{"metric_name":{"type":"string","title":"Metric Name"},"time_window":{"type":"string","title":"Time Window"},"data_points":{"items":{},"type":"array","title":"Data Points"},"chart_config":{"$ref":"#/components/schemas/TimeSeriesChartConfig"},"statistics":{"$ref":"#/components/schemas/TimeSeriesStatistics"}},"type":"object","required":["metric_name","time_window","data_points","chart_config","statistics"],"title":"TimeSeriesChartResponse","description":"Response for GET /charts/time-series."},"TimeSeriesDateRange":{"properties":{"start":{"anyOf":[{},{"type":"null"}],"title":"Start"},"end":{"anyOf":[{},{"type":"null"}],"title":"End"}},"type":"object","title":"TimeSeriesDateRange"},"TimeSeriesStatistics":{"properties":{"total_points":{"type":"integer","title":"Total Points"},"date_range":{"$ref":"#/components/schemas/TimeSeriesDateRange"}},"type":"object","required":["total_points","date_range"],"title":"TimeSeriesStatistics"},"TimelineBucket":{"properties":{"date":{"type":"string","title":"Date"},"queries":{"type":"integer","title":"Queries"},"credits_earned":{"type":"integer","title":"Credits Earned"}},"type":"object","required":["date","queries","credits_earned"],"title":"TimelineBucket"},"TimeseriesBucket":{"properties":{"hour":{"type":"string","title":"Hour"},"request_count":{"type":"integer","title":"Request Count"},"avg_latency_ms":{"type":"number","title":"Avg Latency Ms"},"total_tokens":{"type":"integer","title":"Total Tokens"},"total_cost_usd":{"type":"number","title":"Total Cost Usd"},"error_count":{"type":"integer","title":"Error Count"}},"type":"object","required":["hour","request_count","avg_latency_ms","total_tokens","total_cost_usd","error_count"],"title":"TimeseriesBucket"},"TimeseriesResponse":{"properties":{"period":{"type":"string","title":"Period"},"buckets":{"items":{"$ref":"#/components/schemas/TimeseriesBucket"},"type":"array","title":"Buckets"}},"type":"object","required":["period","buckets"],"title":"TimeseriesResponse"},"ToastAction":{"properties":{"message":{"type":"string","title":"Message"},"action_label":{"type":"string","title":"Action Label"},"action_route":{"type":"string","title":"Action Route"}},"type":"object","required":["message","action_label","action_route"],"title":"ToastAction"},"TodayStats":{"properties":{"viewers":{"type":"integer","minimum":0,"title":"Viewers","description":"Current live viewers"},"new_followers":{"type":"integer","minimum":0,"title":"New Followers","description":"New followers today"},"chat_messages":{"type":"integer","minimum":0,"title":"Chat Messages","description":"Chat messages today"}},"type":"object","required":["viewers","new_followers","chat_messages"],"title":"TodayStats","description":"Today's statistics for dashboard","example":{"chat_messages":234,"new_followers":5,"viewers":42}},"ToggleIPWhitelistResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["success","message","enabled"],"title":"ToggleIPWhitelistResponse","description":"Response for toggling IP whitelist enforcement"},"ToggleQuantumCompressionResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"quantum_compression_enabled":{"type":"boolean","title":"Quantum Compression Enabled"},"settings":{"$ref":"#/components/schemas/QuantumCompressionSettings"},"current_stats":{"$ref":"#/components/schemas/QuantumCompressionCurrentStats"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","quantum_compression_enabled","settings","current_stats","message"],"title":"ToggleQuantumCompressionResponse"},"TokenConnectionRequest":{"properties":{"provider":{"type":"string","title":"Provider","description":"Provider ID (e.g., 'notion')"},"access_token":{"type":"string","minLength":1,"title":"Access Token","description":"API key or personal access token"}},"type":"object","required":["provider","access_token"],"title":"TokenConnectionRequest"},"TokenCostProviderEntry":{"properties":{"provider":{"type":"string","title":"Provider"},"cost_7d":{"type":"number","title":"Cost 7D"},"tokens_7d":{"type":"integer","title":"Tokens 7D"}},"type":"object","required":["provider","cost_7d","tokens_7d"],"title":"TokenCostProviderEntry"},"TokenHistoryPoint":{"properties":{"hour":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hour"},"tokens":{"type":"integer","title":"Tokens"},"llm_requests":{"type":"integer","title":"Llm Requests"}},"type":"object","required":["tokens","llm_requests"],"title":"TokenHistoryPoint"},"TokenRefreshRequest":{"properties":{"refresh_token":{"type":"string","title":"Refresh Token"}},"type":"object","required":["refresh_token"],"title":"TokenRefreshRequest","description":"Schema for token refresh request"},"TokenVerificationResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"}},"type":"object","required":["valid","user_id","email"],"title":"TokenVerificationResponse","example":{"email":"admin@test.com","user_id":"test-user-123","valid":true}},"ToolAnalyticsEntry":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"call_count":{"type":"integer","title":"Call Count"},"success_count":{"type":"integer","title":"Success Count"},"error_count":{"type":"integer","title":"Error Count"},"success_rate":{"type":"number","title":"Success Rate"},"avg_execution_time_ms":{"type":"number","title":"Avg Execution Time Ms"},"min_execution_time_ms":{"type":"number","title":"Min Execution Time Ms"},"max_execution_time_ms":{"type":"number","title":"Max Execution Time Ms"},"p50_execution_time_ms":{"type":"number","title":"P50 Execution Time Ms"},"p95_execution_time_ms":{"type":"number","title":"P95 Execution Time Ms"},"p99_execution_time_ms":{"type":"number","title":"P99 Execution Time Ms"},"common_errors":{"items":{"$ref":"#/components/schemas/ToolCommonError"},"type":"array","title":"Common Errors"}},"type":"object","required":["tool_name","call_count","success_count","error_count","success_rate","avg_execution_time_ms","min_execution_time_ms","max_execution_time_ms","p50_execution_time_ms","p95_execution_time_ms","p99_execution_time_ms","common_errors"],"title":"ToolAnalyticsEntry","description":"Per-tool breakdown entry for /by-tool."},"ToolCallListResponse":{"properties":{"calls":{"items":{"$ref":"#/components/schemas/ToolCallRecord"},"type":"array","title":"Calls"},"total":{"type":"integer","title":"Total","description":"Total number of matching records (before pagination)"}},"type":"object","required":["calls","total"],"title":"ToolCallListResponse","description":"Paginated list of tool call audit records."},"ToolCallRecord":{"properties":{"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","description":"ISO-8601 UTC timestamp of the call"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"MCP session identifier"},"tool":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool","description":"Tool name invoked"},"input_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Input Summary","description":"Endpoint path used as input summary"},"outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome","description":"success | client_error | error"},"risk_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Score","description":"Risk score (0.0 – 1.0), null if not scored"},"approval_decision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approval Decision","description":"Approval decision, null if not reviewed"}},"type":"object","title":"ToolCallRecord","description":"A single MCP tool call audit record."},"ToolCallRequest":{"properties":{"message":{"type":"string","maxLength":10000,"minLength":1,"title":"Message"},"context_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context Id"}},"type":"object","required":["message"],"title":"ToolCallRequest"},"ToolCatalogEntry":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"endpoint":{"type":"string","title":"Endpoint"},"mcp_tool":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mcp Tool"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters"},"example":{"additionalProperties":true,"type":"object","title":"Example"}},"type":"object","required":["name","description","category","endpoint","parameters","example"],"title":"ToolCatalogEntry","description":"One tool manifest entry. `parameters` and `example` vary per tool (each\ntool has a different parameter set), so they stay untyped dicts rather than\na fabricated common schema."},"ToolCatalogResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"tools":{"items":{"$ref":"#/components/schemas/ToolCatalogEntry"},"type":"array","title":"Tools"},"total":{"type":"integer","title":"Total"},"total_all":{"type":"integer","title":"Total All"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"version":{"type":"string","title":"Version"},"mcp_install":{"type":"string","title":"Mcp Install"},"openapi_url":{"type":"string","title":"Openapi Url"},"docs_url":{"type":"string","title":"Docs Url"}},"type":"object","required":["ok","tools","total","total_all","categories","version","mcp_install","openapi_url","docs_url"],"title":"ToolCatalogResponse"},"ToolCommonError":{"properties":{"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["count"],"title":"ToolCommonError","description":"A frequent error message for a given tool."},"ToolDefinition":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"inputSchema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Inputschema"}},"type":"object","required":["name","description"],"title":"ToolDefinition"},"ToolExecutionEntry":{"properties":{"id":{"type":"string","title":"Id"},"tool_name":{"type":"string","title":"Tool Name"},"execution_time_ms":{"type":"number","title":"Execution Time Ms"},"success":{"type":"boolean","title":"Success"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["id","tool_name","execution_time_ms","success"],"title":"ToolExecutionEntry","description":"A single recent tool execution record for /recent.\n\nerror_message, user_id and session_id are only included by the handler\nwhen applicable (failed executions, admin mode, or a present session),\nso they are optional here rather than always-present."},"ToolListResponse":{"properties":{"tools":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tools"},"count":{"type":"integer","title":"Count"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"registration_errors":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Registration Errors"}},"type":"object","required":["tools","count","categories"],"title":"ToolListResponse"},"ToolSchema":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name"},"description":{"type":"string","maxLength":1024,"minLength":1,"title":"Description"},"input_schema":{"additionalProperties":true,"type":"object","title":"Input Schema","description":"JSON Schema for the tool's input"}},"type":"object","required":["name","description","input_schema"],"title":"ToolSchema","description":"Single tool definition inside a plugin manifest."},"ToolStatsResponse":{"properties":{"tool_stats":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__memory_traces__ToolStat"},"type":"array","title":"Tool Stats"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["tool_stats","count"],"title":"ToolStatsResponse"},"ToolStatus":{"properties":{"tool":{"$ref":"#/components/schemas/ScaffoldingTool"},"installed":{"type":"boolean","title":"Installed"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"available_templates":{"items":{"type":"string"},"type":"array","title":"Available Templates"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"last_checked":{"type":"string","format":"date-time","title":"Last Checked"}},"type":"object","required":["tool","installed","last_checked"],"title":"ToolStatus","description":"Status of a scaffolding tool"},"ToolTemplatesResponse":{"properties":{"tool":{"$ref":"#/components/schemas/ScaffoldingTool"},"templates":{"items":{"type":"string"},"type":"array","title":"Templates"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"}},"type":"object","required":["tool","templates","capabilities"],"title":"ToolTemplatesResponse","description":"Response for GET /scaffolding-tools/templates/{tool}."},"TopAgentItem":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"cost_usd":{"type":"number","title":"Cost Usd"}},"type":"object","required":["agent_id","cost_usd"],"title":"TopAgentItem"},"TopCachedItem":{"properties":{"key_pattern":{"type":"string","title":"Key Pattern"},"hit_count":{"type":"integer","title":"Hit Count"},"hit_ratio":{"type":"number","title":"Hit Ratio"}},"type":"object","required":["key_pattern","hit_count","hit_ratio"],"title":"TopCachedItem"},"TopEndpointEntry":{"properties":{"endpoint":{"type":"string","title":"Endpoint"},"calls":{"type":"integer","title":"Calls"},"avg_response_ms":{"type":"integer","title":"Avg Response Ms"}},"type":"object","required":["endpoint","calls","avg_response_ms"],"title":"TopEndpointEntry"},"TopEvent":{"properties":{"event_id":{"type":"string","title":"Event Id","description":"Event UUID"},"event_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Name","description":"Event name"},"organizer_id":{"type":"string","title":"Organizer Id","description":"Organizer UUID"},"total_revenue":{"type":"string","title":"Total Revenue","description":"Total revenue generated","default":"0.00"},"impressions":{"type":"integer","title":"Impressions","description":"Total impressions","default":0},"fill_rate":{"type":"number","title":"Fill Rate","description":"Ad slot fill rate","default":0}},"type":"object","required":["event_id","organizer_id"],"title":"TopEvent","description":"Top event by revenue"},"TopIssueItem":{"properties":{"issue":{"type":"string","title":"Issue"},"count":{"type":"integer","title":"Count"},"severity":{"type":"string","title":"Severity"}},"type":"object","required":["issue","count","severity"],"title":"TopIssueItem"},"TopPerformingSite":{"properties":{"name":{"type":"string","title":"Name"},"traffic":{"type":"integer","title":"Traffic"},"conversion":{"type":"number","title":"Conversion"}},"type":"object","required":["name","traffic","conversion"],"title":"TopPerformingSite"},"TopPromptCount":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["prompt_id","count"],"title":"TopPromptCount"},"TopSponsor":{"properties":{"sponsor_id":{"type":"string","title":"Sponsor Id","description":"Sponsor UUID"},"sponsor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sponsor Name","description":"Sponsor name"},"total_spend":{"type":"string","title":"Total Spend","description":"Total spend amount","default":"0.00"},"campaigns_count":{"type":"integer","title":"Campaigns Count","description":"Number of active campaigns","default":0},"impressions":{"type":"integer","title":"Impressions","description":"Total impressions","default":0}},"type":"object","required":["sponsor_id"],"title":"TopSponsor","description":"Top sponsor by spend"},"TopStream":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At","description":"When stream started (ISO 8601)"},"ended_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ended At","description":"When stream ended (ISO 8601)"},"peak_viewers":{"type":"integer","minimum":0,"title":"Peak Viewers"},"current_viewers":{"type":"integer","minimum":0,"title":"Current Viewers"},"duration_seconds":{"type":"integer","minimum":0,"title":"Duration Seconds","description":"Stream duration in seconds"},"total_views":{"type":"integer","minimum":0,"title":"Total Views","description":"Total viewer sessions"},"total_messages":{"type":"integer","minimum":0,"title":"Total Messages","description":"Total chat messages"},"category":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Category","description":"Stream category"},"metric_value":{"type":"number","minimum":0,"title":"Metric Value","description":"Value of the ranking metric"}},"type":"object","required":["id","title","status","peak_viewers","current_viewers","duration_seconds","total_views","total_messages","metric_value"],"title":"TopStream","description":"Top performing stream summary","example":{"category":{"name":"Web Development","slug":"web-dev"},"current_viewers":0,"description":"Continuing our real-time chat application","duration_seconds":12600,"ended_at":"2025-12-20T21:30:00Z","id":"987e6543-e21b-12d3-a456-426614174000","metric_value":523,"peak_viewers":523,"started_at":"2025-12-20T18:00:00Z","status":"ended","title":"Building FastAPI App - Part 3","total_messages":3421,"total_views":892}},"TopStreamsResponse":{"properties":{"streams":{"items":{"$ref":"#/components/schemas/TopStream"},"type":"array","title":"Streams"},"metric":{"type":"string","title":"Metric","description":"Metric used for ranking (peak_viewers, total_views, etc.)"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Number of streams returned"}},"type":"object","required":["streams","metric","total"],"title":"TopStreamsResponse","description":"List of top performing streams","example":{"metric":"peak_viewers","streams":[{"id":"987e6543-e21b-12d3-a456-426614174000","metric_value":523,"peak_viewers":523,"title":"Building FastAPI App"}],"total":10}},"TraceAcceptanceRequest":{"properties":{"signal":{"type":"string","enum":["thumbs_up","thumbs_down","accepted","rejected","edited"],"title":"Signal"},"source":{"type":"string","title":"Source"}},"additionalProperties":false,"type":"object","required":["signal","source"],"title":"TraceAcceptanceRequest"},"TraceAcceptanceResponse":{"properties":{"trace_id":{"type":"string","title":"Trace Id"},"signal":{"type":"string","title":"Signal"},"source":{"type":"string","title":"Source"},"rows_updated":{"type":"integer","title":"Rows Updated"}},"type":"object","required":["trace_id","signal","source","rows_updated"],"title":"TraceAcceptanceResponse"},"TraceCompleteRequest":{"properties":{"outcome":{"type":"string","title":"Outcome","description":"Summary of what was accomplished"},"success":{"type":"boolean","title":"Success","description":"Whether the task succeeded"}},"type":"object","required":["outcome","success"],"title":"TraceCompleteRequest"},"TraceCompleteResponse":{"properties":{"trace_id":{"type":"string","title":"Trace Id"},"outcome":{"type":"string","title":"Outcome"},"success":{"type":"boolean","title":"Success"}},"type":"object","required":["trace_id","outcome","success"],"title":"TraceCompleteResponse"},"TraceDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"session_id":{"type":"string","title":"Session Id"},"task":{"type":"string","title":"Task"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome"},"success":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success"},"triggered_by_memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Triggered By Memory Id"},"steps":{"items":{"$ref":"#/components/schemas/TraceStepDetail"},"type":"array","title":"Steps"}},"type":"object","required":["id","session_id","task","steps"],"title":"TraceDetailResponse"},"TraceQueryResponse":{"properties":{"traces":{"items":{"$ref":"#/components/schemas/TraceRecord"},"type":"array","title":"Traces"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["traces","total","page","page_size","has_more"],"title":"TraceQueryResponse","description":"Paginated response for the traces query endpoint."},"TraceRecord":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"trace_id":{"type":"string","title":"Trace Id"},"span_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Span Id"},"parent_span_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Span Id"},"operation_name":{"type":"string","title":"Operation Name"},"trace_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trace Type"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Time"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"status":{"type":"string","title":"Status","default":"ok"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","agent_id","trace_id","operation_name","start_time","created_at"],"title":"TraceRecord","description":"Single trace/span returned from the query endpoint."},"TraceStartRequest":{"properties":{"task":{"type":"string","title":"Task","description":"Description of the task this trace covers"},"session_id":{"type":"string","title":"Session Id","description":"Session identifier"},"triggered_by_memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Triggered By Memory Id","description":"Memory ID that triggered this reasoning trace"}},"type":"object","required":["task","session_id"],"title":"TraceStartRequest"},"TraceStartResponse":{"properties":{"trace_id":{"type":"string","title":"Trace Id"},"task":{"type":"string","title":"Task"},"session_id":{"type":"string","title":"Session Id"}},"type":"object","required":["trace_id","task","session_id"],"title":"TraceStartResponse"},"TraceStepDetail":{"properties":{"id":{"type":"string","title":"Id"},"thought":{"type":"string","title":"Thought"},"action":{"type":"string","title":"Action"},"observations":{"items":{},"type":"array","title":"Observations"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"},"tool_calls":{"items":{"$ref":"#/components/schemas/TraceToolCallDetail"},"type":"array","title":"Tool Calls"}},"type":"object","required":["id","thought","action","observations","tool_calls"],"title":"TraceStepDetail"},"TraceStepRequest":{"properties":{"thought":{"type":"string","title":"Thought","description":"Agent's reasoning at this step"},"action":{"type":"string","title":"Action","description":"Action the agent decided to take"},"observations":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Observations","description":"Observations from the environment"}},"type":"object","required":["thought","action"],"title":"TraceStepRequest"},"TraceStepResponse":{"properties":{"step_id":{"type":"string","title":"Step Id"},"trace_id":{"type":"string","title":"Trace Id"}},"type":"object","required":["step_id","trace_id"],"title":"TraceStepResponse"},"TraceToolCallDetail":{"properties":{"id":{"type":"string","title":"Id"},"tool_name":{"type":"string","title":"Tool Name"},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments"},"result":{"title":"Result"},"status":{"type":"string","title":"Status"},"duration_ms":{"type":"integer","title":"Duration Ms"},"memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Id"}},"type":"object","required":["id","tool_name","arguments","result","status","duration_ms"],"title":"TraceToolCallDetail"},"TraceToolCallRequest":{"properties":{"tool_name":{"type":"string","title":"Tool Name","description":"Name of the tool called"},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments","description":"Arguments passed to the tool"},"result":{"title":"Result","description":"Result returned by the tool"},"duration_ms":{"type":"integer","minimum":0,"title":"Duration Ms","description":"Tool call duration in milliseconds"},"status":{"type":"string","enum":["success","error","timeout"],"title":"Status","description":"Call outcome","default":"success"},"memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Id","description":"Memory ID used or created by this call"},"step_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step Id","description":"Step to attach this call to (defaults to latest)"}},"type":"object","required":["tool_name","arguments","result","duration_ms"],"title":"TraceToolCallRequest"},"TraceToolCallResponse":{"properties":{"call_id":{"type":"string","title":"Call Id"},"trace_id":{"type":"string","title":"Trace Id"},"tool_name":{"type":"string","title":"Tool Name"}},"type":"object","required":["call_id","trace_id","tool_name"],"title":"TraceToolCallResponse"},"TrackActionRequest":{"properties":{"action_type":{"$ref":"#/components/schemas/app__schemas__blog_prompt__ActionType","description":"Type of action performed"},"share_platform":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Share Platform","description":"Platform for sharing"},"download_format":{"anyOf":[{"$ref":"#/components/schemas/DownloadFormat"},{"type":"null"}]},"customized":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Customized","description":"Whether prompt was customized before action","default":false}},"type":"object","required":["action_type"],"title":"TrackActionRequest","description":"Request to track a user action on a prompt"},"TrackActionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"analytics_recorded":{"type":"boolean","title":"Analytics Recorded"}},"type":"object","required":["success","analytics_recorded"],"title":"TrackActionResponse","description":"Response from tracking action"},"TrackConversionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"event_id":{"type":"string","title":"Event Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","event_id","message"],"title":"TrackConversionResponse","description":"Response for POST /track"},"TrackDirectoryMetadataRequest":{"properties":{"directory_path":{"type":"string","title":"Directory Path","description":"Path to the directory"},"include_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Include Patterns","description":"Optional patterns to include"},"exclude_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Patterns","description":"Optional patterns to exclude"}},"type":"object","required":["directory_path"],"title":"TrackDirectoryMetadataRequest"},"TrackDirectoryMetadataResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Service status"},"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"directory_path":{"type":"string","title":"Directory Path","description":"Directory that was analyzed"},"total_files":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Files","description":"Files discovered"},"processed_files":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Processed Files","description":"Files analyzed successfully"},"failed_files":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Failed Files","description":"Files that failed analysis"},"languages":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Languages","description":"Language name -> file count"},"results":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Results","description":"Per-file results"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message when status=error"}},"additionalProperties":true,"type":"object","required":["status","project_id","directory_path"],"title":"TrackDirectoryMetadataResponse","description":"Aggregate result of analyzing metadata for every file in a directory."},"TrackFileMetadataRequest":{"properties":{"file_path":{"type":"string","title":"File Path","description":"Path to the file"},"content":{"type":"string","title":"Content","description":"Content of the file"}},"type":"object","required":["file_path","content"],"title":"TrackFileMetadataRequest"},"TrackFileMetadataResponse":{"properties":{"file_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Id"},"file_path":{"type":"string","title":"File Path"},"status":{"type":"string","title":"Status","description":"new | updated | unchanged | error"},"current_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Hash"},"metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metrics"},"total_changes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Changes"},"first_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Seen"},"last_modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified"},"authors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Authors"},"line_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Line Count"},"complexity_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Complexity Score"},"security_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Classification"},"dependencies":{"anyOf":[{"items":{"$ref":"#/components/schemas/DependencyInfo"},"type":"array"},{"type":"null"}],"title":"Dependencies"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present only when status is error"}},"type":"object","required":["file_path","status"],"title":"TrackFileMetadataResponse","description":"Response for POST /metadata/track (FileMetadataTracker.track_file_change)."},"TrackFileMetadataResultResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Service status"},"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"file_path":{"type":"string","title":"File Path","description":"File that was analyzed"},"metadata_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata Id","description":"Stored metadata row ID"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Computed file metrics (language, complexity, imports, ...)"},"cache_hit":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Cache Hit","description":"Whether metadata came from cache"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message when status=error"}},"additionalProperties":true,"type":"object","required":["status","project_id","file_path"],"title":"TrackFileMetadataResultResponse","description":"Result of analyzing and storing metadata for one file.\n\nDeliberately NOT app.schemas.code_context.TrackFileMetadataResponse: that\nsame-named schema models a different route (POST /metadata/track via\nFileMetadataTracker.track_file_change) and a different shape (file_id,\ncurrent_hash, metrics, authors, ...). Reusing it here would drop this\nservice's real metadata_id / metadata / cache_hit keys."},"TrackRequestGatewayResponse":{"properties":{"status":{"type":"string","title":"Status"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["status"],"title":"TrackRequestGatewayResponse","description":"Ack returned to the gateway's http-log plugin."},"TrackRequestResponse":{"properties":{"status":{"type":"string","title":"Status"},"instance_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instance Id"}},"type":"object","required":["status"],"title":"TrackRequestResponse","description":"Ack returned for the direct /track-request endpoint."},"TrackSearchQueryRequest":{"properties":{"query_text":{"type":"string","maxLength":500,"minLength":1,"title":"Query Text"},"search_type":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Search Type"},"results_count":{"type":"integer","minimum":0,"title":"Results Count","default":0}},"type":"object","required":["query_text"],"title":"TrackSearchQueryRequest","description":"Schema for tracking search query request"},"TrackSearchQueryResponse":{"properties":{"id":{"type":"string","title":"Id"},"query_text":{"type":"string","title":"Query Text"},"search_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search Type"},"results_count":{"type":"integer","title":"Results Count"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","query_text","search_type","results_count","created_at"],"title":"TrackSearchQueryResponse","description":"Schema for tracking search query response"},"TrackTypeEnum":{"type":"string","enum":["video","audio","screen"],"title":"TrackTypeEnum","description":"Track type enumeration"},"TrackUsageRequest":{"properties":{"tool_id":{"type":"string","title":"Tool Id"},"developer_id":{"type":"string","title":"Developer Id"},"user_id":{"type":"string","title":"User Id"},"credits_consumed":{"type":"integer","minimum":0,"title":"Credits Consumed"},"markup_pct":{"type":"number","maximum":0.4,"minimum":0,"title":"Markup Pct","default":0}},"type":"object","required":["tool_id","developer_id","user_id","credits_consumed"],"title":"TrackUsageRequest","description":"Request body for POST /browser/echo/track"},"TrackUsageResponse":{"properties":{"tool_id":{"type":"string","title":"Tool Id"},"developer_id":{"type":"string","title":"Developer Id"},"user_id":{"type":"string","title":"User Id"},"credits_consumed":{"type":"integer","title":"Credits Consumed"},"markup_pct":{"type":"number","title":"Markup Pct"},"developer_earnings":{"type":"number","title":"Developer Earnings"},"platform_fee":{"type":"number","title":"Platform Fee"}},"type":"object","required":["tool_id","developer_id","user_id","credits_consumed","markup_pct","developer_earnings","platform_fee"],"title":"TrackUsageResponse","description":"Response for usage tracking"},"TrackingHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","service","timestamp"],"title":"TrackingHealthResponse"},"TrackingStatsResponse":{"properties":{"today":{"$ref":"#/components/schemas/TrackingStatsToday"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["today","timestamp"],"title":"TrackingStatsResponse"},"TrackingStatsToday":{"properties":{"total_requests":{"type":"integer","title":"Total Requests"},"active_instances":{"type":"integer","title":"Active Instances"},"total_credits":{"type":"number","title":"Total Credits"},"avg_response_time":{"type":"number","title":"Avg Response Time"}},"type":"object","required":["total_requests","active_instances","total_credits","avg_response_time"],"title":"TrackingStatsToday"},"TrackingURLs":{"properties":{"impression_url":{"type":"string","title":"Impression Url","description":"URL to ping when ad is displayed"},"click_url":{"type":"string","title":"Click Url","description":"URL to ping when ad is clicked"},"completion_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completion Url","description":"URL to ping when video ad completes (video only)"}},"type":"object","required":["impression_url","click_url"],"title":"TrackingURLs","description":"Schema for ad tracking URLs\n\nProvides URLs for frontend to ping when events occur:\n- impression_url: Called when ad is displayed\n- click_url: Called when ad is clicked\n- completion_url: Called when video ad completes (video only)","example":{"click_url":"https://api.ainative.studio/v1/paipalooza/ads/ad_abc123/click","completion_url":"https://api.ainative.studio/v1/paipalooza/ads/ad_abc123/complete","impression_url":"https://api.ainative.studio/v1/paipalooza/ads/ad_abc123/impression"}},"TransactionListData":{"properties":{"transactions":{"items":{"$ref":"#/components/schemas/TransactionRecord"},"type":"array","title":"Transactions"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["transactions","total","skip","limit","has_more"],"title":"TransactionListData"},"TransactionRecord":{"properties":{"id":{"type":"string","title":"Id"},"wallet_id":{"type":"string","title":"Wallet Id"},"transaction_type":{"type":"string","title":"Transaction Type"},"amount_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount Usd"},"status":{"type":"string","title":"Status"},"sila_transaction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sila Transaction Id"},"sila_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sila Reference Id"},"recipient_wallet_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient Wallet Id"},"recipient_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient Handle"},"processed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Processed At"},"failed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failed At"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"notification_sent":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Notification Sent"},"notification_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notification Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","wallet_id","transaction_type","status"],"title":"TransactionRecord","description":"A single Sila transaction row, as returned by payments_orchestrator.get_transactions."},"TranscodingCancelResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always true on the 200 path"},"job_id":{"type":"string","title":"Job Id","description":"The transcoding job that was cancelled"},"video_id":{"type":"string","title":"Video Id","description":"Owning video UUID, pre-serialized"},"message":{"type":"string","title":"Message","description":"Human-readable confirmation"}},"type":"object","required":["success","job_id","video_id","message"],"title":"TranscodingCancelResponse","description":"Response for DELETE .../transcode/{job_id} (Refs #8449).\n\nAll four keys are unconditionally present on the 200 path — the handler\nreturns one flat dict literal with no branch-dependent fields, including\nwhen the given job_id is not present in the video's metadata (that case\nskips the UPDATE but returns this same envelope). `video_id` is declared\n`str`, NOT `UUID`, because the handler emits `str(video_id)` itself."},"TranscodingJobResponse":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"Unique job identifier"},"video_id":{"type":"string","title":"Video Id","description":"Video UUID"},"status":{"type":"string","title":"Status","description":"Job status: queued, processing, completed, failed"},"progress":{"type":"integer","maximum":100,"minimum":0,"title":"Progress","description":"Progress percentage (0-100)","default":0},"estimated_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Estimated Time","description":"Estimated completion time (e.g., '8m 30s')"},"qualities_requested":{"items":{"type":"string"},"type":"array","title":"Qualities Requested","description":"Requested quality levels"}},"type":"object","required":["job_id","video_id","status","qualities_requested"],"title":"TranscodingJobResponse","description":"Response schema for transcoding job submission"},"TranscodingRequest":{"properties":{"qualities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Qualities","description":"Quality levels to generate. Options: 360p, 720p, 1080p","default":["360p","720p","1080p"]},"format":{"type":"string","title":"Format","description":"Output format (currently only HLS supported)","default":"hls"},"priority":{"type":"string","title":"Priority","description":"Processing priority: normal, high","default":"normal"}},"type":"object","title":"TranscodingRequest","description":"Request schema for video transcoding"},"TranscodingRetryResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always true on the 200 path"},"video_id":{"type":"string","title":"Video Id","description":"Owning video UUID, pre-serialized"},"quality":{"type":"string","title":"Quality","description":"Quality level re-queued: 360p | 720p | 1080p"},"task_id":{"type":"string","title":"Task Id","description":"Celery task id for the queued retry"},"message":{"type":"string","title":"Message","description":"Human-readable confirmation"}},"type":"object","required":["success","video_id","quality","task_id","message"],"title":"TranscodingRetryResponse","description":"Response for POST .../transcode/retry/{quality} (Refs #8449).\n\nAll five keys are unconditionally present on the 200 path. `video_id` is\ndeclared `str`, NOT `UUID`, for the same reason as above."},"TranscodingStatusResponse":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"Job identifier"},"status":{"type":"string","title":"Status","description":"Status: queued, processing, completed, failed"},"progress":{"type":"integer","maximum":100,"minimum":0,"title":"Progress","description":"Progress percentage","default":0},"current_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Quality","description":"Currently processing quality"},"completed_qualities":{"items":{"type":"string"},"type":"array","title":"Completed Qualities","description":"Completed quality levels"},"failed_qualities":{"items":{"type":"string"},"type":"array","title":"Failed Qualities","description":"Failed quality levels"},"estimated_time_remaining":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Estimated Time Remaining","description":"Estimated time remaining"},"outputs":{"items":{"$ref":"#/components/schemas/QualityOutput"},"type":"array","title":"Outputs","description":"Completed outputs"},"master_playlist_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Master Playlist Url","description":"Master HLS playlist URL"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if failed"}},"type":"object","required":["job_id","status"],"title":"TranscodingStatusResponse","description":"Response schema for transcoding status"},"TranscriptEntry":{"properties":{"uuid":{"type":"string","title":"Uuid","description":"Unique identifier for this entry"},"type":{"type":"string","title":"Type","description":"Entry type (e.g. message, tool_call)"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO 8601 timestamp"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["uuid","type","timestamp"],"title":"TranscriptEntry","description":"A single transcript entry for PUT session ingress. Refs #3168."},"TranscriptMessage":{"properties":{"role":{"$ref":"#/components/schemas/MessageRole"},"content":{"type":"string","minLength":1,"title":"Content"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["role","content"],"title":"TranscriptMessage","description":"A single message in a session transcript."},"TranscriptionResponse":{"properties":{"text":{"type":"string","title":"Text","description":"Transcribed text"},"cost_credits":{"type":"integer","title":"Cost Credits","description":"Credits charged for transcription"},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Seconds","description":"Audio duration in seconds"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Detected language"}},"type":"object","required":["text","cost_credits"],"title":"TranscriptionResponse","description":"Response schema for Whisper transcription"},"TransferRequest":{"properties":{"recipient_user_id":{"type":"string","format":"uuid","title":"Recipient User Id","description":"User ID of the recipient"},"amount":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"string"}],"title":"Amount","description":"Amount to transfer in USD"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description","description":"Optional transaction description"}},"type":"object","required":["recipient_user_id","amount"],"title":"TransferRequest","description":"Schema for transfer to another user request"},"TraverseRequest":{"properties":{"entity":{"type":"string","title":"Entity","description":"Entity name or ID to start traversal from"},"max_hops":{"type":"integer","maximum":5,"minimum":1,"title":"Max Hops","description":"Maximum traversal depth","default":3},"predicates":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Predicates","description":"Filter by edge types"},"min_confidence":{"type":"number","maximum":1,"minimum":0,"title":"Min Confidence","description":"Minimum edge confidence","default":0},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"As Of","description":"Return edges valid at this timestamp (Refs #1546)"}},"type":"object","required":["entity"],"title":"TraverseRequest"},"TraverseResponse":{"properties":{"nodes":{"items":{"$ref":"#/components/schemas/GraphNode"},"type":"array","title":"Nodes"},"edges":{"items":{"$ref":"#/components/schemas/GraphTraverseEdge"},"type":"array","title":"Edges"},"paths":{"items":{},"type":"array","title":"Paths"}},"additionalProperties":true,"type":"object","title":"TraverseResponse","description":"Response for POST /memory/v2/graph/traverse.\n\n``paths`` is always ``[]`` today (GraphService.traverse has a documented\n\"Future: reconstruct paths from visited arrays\" placeholder), but it is a\ndeclared part of the wire contract, so it stays in the model rather than\nbeing dropped as dead weight."},"TrendAnalysisItem":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"trend_id":{"type":"string","title":"Trend Id"},"analysis_timestamp":{"type":"string","format":"date-time","title":"Analysis Timestamp"},"time_window_days":{"type":"integer","title":"Time Window Days"},"trend_direction":{"type":"string","title":"Trend Direction"},"trend_strength":{"type":"number","title":"Trend Strength"},"confidence":{"type":"string","title":"Confidence"},"statistical_significance":{"type":"number","title":"Statistical Significance"},"slope":{"type":"number","title":"Slope"},"r_squared":{"type":"number","title":"R Squared"},"data_points_count":{"type":"integer","title":"Data Points Count"},"current_score":{"type":"number","title":"Current Score"},"predicted_score_7d":{"type":"number","title":"Predicted Score 7D"},"predicted_score_30d":{"type":"number","title":"Predicted Score 30D"},"anomalies_detected":{"type":"integer","title":"Anomalies Detected"},"seasonality_detected":{"type":"boolean","title":"Seasonality Detected"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["prompt_id","trend_id","analysis_timestamp","time_window_days","trend_direction","trend_strength","confidence","statistical_significance","slope","r_squared","data_points_count","current_score","predicted_score_7d","predicted_score_30d","anomalies_detected","seasonality_detected","recommendations"],"title":"TrendAnalysisItem","description":"One prompt's trend result inside the batch-trends map -- shares\nthe same field-for-field shape as the pre-existing\n(per-prompt) TrendAnalysisResponse model, including a real\n`datetime` (not `str`) analysis_timestamp field to match it\nexactly."},"TrendAnalysisResponse":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"},"trend_id":{"type":"string","title":"Trend Id"},"analysis_timestamp":{"type":"string","format":"date-time","title":"Analysis Timestamp"},"time_window_days":{"type":"integer","title":"Time Window Days"},"trend_direction":{"type":"string","title":"Trend Direction"},"trend_strength":{"type":"number","title":"Trend Strength"},"confidence":{"type":"string","title":"Confidence"},"statistical_significance":{"type":"number","title":"Statistical Significance"},"slope":{"type":"number","title":"Slope"},"r_squared":{"type":"number","title":"R Squared"},"data_points_count":{"type":"integer","title":"Data Points Count"},"current_score":{"type":"number","title":"Current Score"},"predicted_score_7d":{"type":"number","title":"Predicted Score 7D"},"predicted_score_30d":{"type":"number","title":"Predicted Score 30D"},"anomalies_detected":{"type":"integer","title":"Anomalies Detected"},"seasonality_detected":{"type":"boolean","title":"Seasonality Detected"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["prompt_id","trend_id","analysis_timestamp","time_window_days","trend_direction","trend_strength","confidence","statistical_significance","slope","r_squared","data_points_count","current_score","predicted_score_7d","predicted_score_30d","anomalies_detected","seasonality_detected","recommendations"],"title":"TrendAnalysisResponse"},"TrendSeries":{"properties":{"metric_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Name"},"metric_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Unit"},"series_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Series Key"},"points":{"items":{"$ref":"#/components/schemas/app__api__v1__ledger__kpis__TrendPoint"},"type":"array","title":"Points"}},"type":"object","required":["points"],"title":"TrendSeries"},"TrendingGroupSchema":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"owner_id":{"type":"string","title":"Owner Id"},"privacy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Privacy"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"member_count":{"type":"integer","title":"Member Count"},"new_members":{"type":"integer","title":"New Members"},"post_count":{"type":"integer","title":"Post Count"},"activity_score":{"type":"number","title":"Activity Score"},"is_featured":{"type":"boolean","title":"Is Featured"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image Url"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"last_activity_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity At"}},"type":"object","required":["id","name","description","owner_id","privacy","category","member_count","new_members","post_count","activity_score","is_featured","cover_image_url","avatar_url","created_at","last_activity_at"],"title":"TrendingGroupSchema","description":"Schema for trending group"},"TrendingPost":{"properties":{"id":{"type":"string","title":"Id","description":"Post ID"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Post title"},"body":{"type":"string","title":"Body","description":"Post body preview"},"user_id":{"type":"string","title":"User Id","description":"Author user ID"},"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id","description":"Group ID if group post"},"post_type":{"type":"string","title":"Post Type","description":"Post type"},"loves_count":{"type":"integer","title":"Loves Count","description":"Number of loves","default":0},"comments_count":{"type":"integer","title":"Comments Count","description":"Number of comments","default":0},"shares_count":{"type":"integer","title":"Shares Count","description":"Number of shares","default":0},"views_count":{"type":"integer","title":"Views Count","description":"Number of views","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"trending_score":{"type":"number","maximum":1,"minimum":0,"title":"Trending Score","description":"Trending score"},"rank":{"type":"integer","minimum":1,"title":"Rank","description":"Trending rank"}},"type":"object","required":["id","body","user_id","post_type","created_at","trending_score","rank"],"title":"TrendingPost","description":"Trending post item","example":{"body":"Researchers have achieved a major milestone...","comments_count":234,"created_at":"2026-01-21T15:30:00Z","group_id":"g1r2o3u4-5p6i-7890-abcd-ef1234567890","id":"p1o2s3t4-5i6d-7890-abcd-ef1234567890","loves_count":892,"post_type":"text","rank":1,"shares_count":156,"title":"Breakthrough in Quantum Computing","trending_score":0.98,"user_id":"a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d","views_count":12456}},"TrendingPostSchema":{"properties":{"id":{"type":"string","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"post_type":{"type":"string","title":"Post Type"},"user_id":{"type":"string","title":"User Id"},"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id"},"loves_count":{"type":"integer","title":"Loves Count"},"comments_count":{"type":"integer","title":"Comments Count"},"shares_count":{"type":"integer","title":"Shares Count"},"views_count":{"type":"integer","title":"Views Count"},"engagement_score":{"type":"number","title":"Engagement Score"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","title","body","post_type","user_id","group_id","loves_count","comments_count","shares_count","views_count","engagement_score","published_at","created_at"],"title":"TrendingPostSchema","description":"Schema for trending post"},"TrendingPostsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total number of results"},"limit":{"type":"integer","title":"Limit","description":"Results per page"},"offset":{"type":"integer","title":"Offset","description":"Results offset"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results exist"},"posts":{"items":{"$ref":"#/components/schemas/TrendingPost"},"type":"array","title":"Posts","description":"Trending posts"},"time_window":{"type":"string","title":"Time Window","description":"Time window for trending calculation"}},"type":"object","required":["total","limit","offset","has_more","time_window"],"title":"TrendingPostsResponse","description":"Trending posts response"},"TrendingSearchSchema":{"properties":{"query":{"type":"string","title":"Query"},"search_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search Type"},"search_count":{"type":"integer","title":"Search Count"},"last_searched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Searched At"}},"type":"object","required":["query","search_type","search_count","last_searched_at"],"title":"TrendingSearchSchema","description":"Schema for trending search query"},"TrendingSearchesResponse":{"properties":{"searches":{"items":{"type":"string"},"type":"array","title":"Searches","description":"List of trending search terms"},"hours":{"type":"integer","title":"Hours","description":"Time window in hours"}},"type":"object","required":["searches","hours"],"title":"TrendingSearchesResponse","description":"Trending search terms","example":{"hours":24,"searches":["React hooks tutorial","Rust programming","Docker containers","GraphQL API","TypeScript basics"]}},"TrendingStream":{"properties":{"stream":{"$ref":"#/components/schemas/StreamResponse"},"trending_score":{"type":"number","maximum":100,"minimum":0,"title":"Trending Score","description":"Trending score (0-100)"}},"type":"object","required":["stream","trending_score"],"title":"TrendingStream","description":"Stream with trending score for discovery","example":{"stream":{"id":"987e6543-e21b-12d3-a456-426614174000","status":"live","streamer":{"display_name":"John Doe","follower_count":1250,"id":"550e8400-e29b-41d4-a716-446655440000","is_verified":true,"username":"johndoe"},"title":"Building with FastAPI","viewer_count":342},"trending_score":87.5}},"TrendingStreamsResponse":{"properties":{"streams":{"items":{"$ref":"#/components/schemas/TrendingStream"},"type":"array","title":"Streams"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Number of trending streams returned"},"limit":{"type":"integer","maximum":50,"minimum":1,"title":"Limit","description":"Maximum streams per page"},"time_window_hours":{"type":"integer","maximum":24,"minimum":1,"title":"Time Window Hours","description":"Time window for trending calculation","default":1},"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id","description":"Category filter applied (if any)"}},"type":"object","required":["streams","total","limit"],"title":"TrendingStreamsResponse","description":"List of trending streams with scores","example":{"limit":10,"streams":[{"stream":{"id":"987e6543-e21b-12d3-a456-426614174000","status":"live","title":"Building Real-time Features","viewer_count":523},"trending_score":92.3}],"time_window_hours":1,"total":15}},"TrendingSummarySchema":{"properties":{"trending_posts":{"items":{"$ref":"#/components/schemas/TrendingPostSchema"},"type":"array","title":"Trending Posts"},"trending_groups":{"items":{"$ref":"#/components/schemas/TrendingGroupSchema"},"type":"array","title":"Trending Groups"},"trending_searches":{"items":{"$ref":"#/components/schemas/TrendingSearchSchema"},"type":"array","title":"Trending Searches"},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","required":["trending_posts","trending_groups","trending_searches","generated_at"],"title":"TrendingSummarySchema","description":"Schema for comprehensive trending summary"},"TrendsResponse":{"properties":{"series":{"items":{"$ref":"#/components/schemas/TrendSeries"},"type":"array","title":"Series"},"organization_id":{"type":"string","title":"Organization Id"}},"type":"object","required":["series","organization_id"],"title":"TrendsResponse"},"TriageActionResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"item_id":{"type":"string","title":"Item Id"},"action":{"type":"string","title":"Action"},"status":{"type":"string","title":"Status"}},"type":"object","required":["ok","item_id","action","status"],"title":"TriageActionResponse"},"TriageItemOut":{"properties":{"id":{"type":"string","title":"Id"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Ref"},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"sender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"raw_excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Excerpt"},"classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Classification"},"extracted":{"anyOf":[{},{"type":"null"}],"title":"Extracted"},"github_issue_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Github Issue Urls"},"swarm_project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Swarm Project Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"spawn_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Spawn Status"},"spawn_phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Spawn Phase"},"triage_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Triage Reason"},"suggested_actions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Suggested Actions"}},"type":"object","required":["id"],"title":"TriageItemOut","description":"IntakeItemOut plus triage annotations (see intake_triage.annotate)."},"TriageListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TriageItemOut"},"type":"array","title":"Items"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["items","count"],"title":"TriageListResponse"},"TrialCheckoutRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email","description":"Email the account will be created under"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Display name (optional)"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan","description":"Selected plan the user is starting a trial on (e.g. 'Pro', 'Business', 'Hobbyist'; aliases like 'pro'/'basic' resolve). Drives the Stripe price so the trial uses the CHOSEN plan's price, not a hardcoded Hobbyist $5. Omit/unknown → Hobbyist (prior behavior). The tier is derived downstream from this price by the Stripe webhook. Refs #6618"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"OAuth provider for a redirect-flow resume: 'github'|'google'|'linkedin'. Omit for the email signup flow. Refs #6583"},"signup_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signup Source","description":"Optional signup source tag carried through Stripe metadata. Refs #6583"}},"type":"object","required":["email"],"title":"TrialCheckoutRequest","description":"Start a card-gated 3-day trial checkout for a human web signup. Refs #5761.\n\n``provider`` (Refs #6583): when the signup came through an OAuth redirect flow\n(github/google/linkedin) the post-Stripe resume must land back on the OAuth\ncallback, not the email ``/signup`` finalizer (an OAuth user has no password).\nWhen set, the checkout success_url points at ``/login/callback`` and the\nprovider/source ride along in Stripe session metadata so the callback can\nre-drive ``enforce_trial_card_gate()`` with the verified session. When unset,\nthe email flow is unchanged."},"TrialProvisionRequest":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"device_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Id"}},"type":"object","title":"TrialProvisionRequest","description":"Request body for trial account provisioning. Refs #2963"},"TrialProvisionResponse":{"properties":{"api_key":{"type":"string","title":"Api Key"},"expires_at":{"type":"string","title":"Expires At"},"plan":{"type":"string","title":"Plan"}},"type":"object","required":["api_key","expires_at","plan"],"title":"TrialProvisionResponse","description":"Response body for trial account provisioning. Refs #2963"},"TriggerRollbackResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"reason":{"type":"string","title":"Reason"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","reason","timestamp"],"title":"TriggerRollbackResponse","description":"POST /deployment/deployments/{deployment_id}/rollback — rollback initiated."},"TriggerRunResponse":{"properties":{"status":{"type":"string","title":"Status"},"trigger_id":{"type":"string","title":"Trigger Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status","trigger_id"],"title":"TriggerRunResponse","description":"Response body for a manual trigger run."},"TriggerSecurityScanResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["status","message"],"title":"TriggerSecurityScanResponse"},"TrustDistributionBucket":{"properties":{"range":{"type":"string","title":"Range"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["range","count"],"title":"TrustDistributionBucket"},"TrustDistributionResponse":{"properties":{"distribution":{"items":{"$ref":"#/components/schemas/TrustDistributionBucket"},"type":"array","title":"Distribution"}},"type":"object","required":["distribution"],"title":"TrustDistributionResponse"},"TrustGateGetResponse":{"properties":{"instance_id":{"type":"string","title":"Instance Id"},"min_trust_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Trust Score"},"has_gate":{"type":"boolean","title":"Has Gate"}},"type":"object","required":["instance_id","has_gate"],"title":"TrustGateGetResponse"},"TrustGateRequest":{"properties":{"min_trust_score":{"type":"integer","maximum":100,"minimum":0,"title":"Min Trust Score","description":"Minimum trust score (0-100) required to use this MCP instance"}},"type":"object","required":["min_trust_score"],"title":"TrustGateRequest"},"TrustGateResponse":{"properties":{"instance_id":{"type":"string","title":"Instance Id"},"min_trust_score":{"type":"integer","title":"Min Trust Score"},"status":{"type":"string","title":"Status"}},"type":"object","required":["instance_id","min_trust_score","status"],"title":"TrustGateResponse"},"TrustHistoryEntry":{"properties":{"date":{"type":"string","title":"Date"},"score":{"type":"integer","title":"Score"}},"type":"object","required":["date","score"],"title":"TrustHistoryEntry"},"TrustHistoryResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"days":{"type":"integer","title":"Days"},"history":{"items":{"$ref":"#/components/schemas/TrustHistoryEntry"},"type":"array","title":"History"}},"type":"object","required":["agent_id","days","history"],"title":"TrustHistoryResponse"},"TrustLeaderboardResponse":{"properties":{"leaderboard":{"items":{"$ref":"#/components/schemas/LeaderboardEntry"},"type":"array","title":"Leaderboard"},"total_agents":{"type":"integer","title":"Total Agents"}},"type":"object","required":["leaderboard","total_agents"],"title":"TrustLeaderboardResponse"},"TrustRecommendationsResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"recommendations":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Recommendations"}},"type":"object","required":["agent_id","recommendations"],"title":"TrustRecommendationsResponse"},"TrustScoreOut":{"properties":{"score":{"type":"integer","title":"Score"},"reliability":{"type":"number","title":"Reliability"},"responsiveness":{"type":"number","title":"Responsiveness"},"compliance":{"type":"number","title":"Compliance"},"longevity":{"type":"number","title":"Longevity"},"volume":{"type":"number","title":"Volume"},"breakdown":{"additionalProperties":{"type":"number"},"type":"object","title":"Breakdown"},"tier":{"type":"string","title":"Tier"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"has_behavioral_data":{"type":"boolean","title":"Has Behavioral Data"},"confidence":{"type":"number","title":"Confidence"}},"type":"object","required":["score","reliability","responsiveness","compliance","longevity","volume","breakdown","tier","has_behavioral_data","confidence"],"title":"TrustScoreOut","description":"See agent_trust_service.TrustScore.to_dict()."},"TutorialCreate":{"properties":{"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"tutorial_type":{"$ref":"#/components/schemas/TutorialType"},"target_role":{"$ref":"#/components/schemas/app__api__admin__onboarding_tutorials__UserRole"},"difficulty_level":{"type":"integer","title":"Difficulty Level","default":1},"estimated_duration_minutes":{"type":"integer","title":"Estimated Duration Minutes"},"prerequisites":{"items":{"type":"string"},"type":"array","title":"Prerequisites","default":[]},"learning_objectives":{"items":{"type":"string"},"type":"array","title":"Learning Objectives","default":[]},"is_active":{"type":"boolean","title":"Is Active","default":true}},"type":"object","required":["title","description","tutorial_type","target_role","estimated_duration_minutes"],"title":"TutorialCreate"},"TutorialDetailsResponse":{"properties":{"tutorial_id":{"type":"string","title":"Tutorial Id"},"title":{"type":"string","title":"Title"},"steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Steps"},"analytics":{"additionalProperties":true,"type":"object","title":"Analytics"},"user_feedback":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"User Feedback"},"completion_statistics":{"additionalProperties":true,"type":"object","title":"Completion Statistics"}},"additionalProperties":true,"type":"object","required":["tutorial_id","title","steps","analytics","user_feedback","completion_statistics"],"title":"TutorialDetailsResponse","description":"Response for GET /onboarding-tutorials/tutorials/{tutorial_id}.\n\nThis is the stored tutorial dict spread with extra keys\n(steps/analytics/user_feedback/completion_statistics) — the base\ntutorial's own fields vary, so extras are allowed."},"TutorialStep":{"properties":{"step_id":{"type":"string","title":"Step Id"},"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"step_type":{"$ref":"#/components/schemas/StepType"},"duration_minutes":{"type":"integer","title":"Duration Minutes"},"validation_criteria":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Validation Criteria"},"hints":{"items":{"type":"string"},"type":"array","title":"Hints","default":[]}},"type":"object","required":["step_id","title","content","step_type","duration_minutes"],"title":"TutorialStep"},"TutorialType":{"type":"string","enum":["interactive","video","guided_tour","hands_on","documentation","quick_start"],"title":"TutorialType","description":"Tutorial types"},"TutorialWithChaptersResponse":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Video title"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Video description"},"video_type":{"$ref":"#/components/schemas/VideoType","description":"Type of video content"},"duration":{"type":"integer","exclusiveMinimum":0,"title":"Duration","description":"Video duration in seconds"},"video_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Video Metadata","description":"Additional metadata"},"video_id":{"type":"string","format":"uuid","title":"Video Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"video_url":{"type":"string","title":"Video Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"status":{"$ref":"#/components/schemas/VideoStatus"},"view_count":{"type":"integer","title":"View Count"},"tech_stack":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tech Stack"},"project_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Url"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"chapters":{"items":{"$ref":"#/components/schemas/app__api__videos__ChapterResponse"},"type":"array","title":"Chapters","default":[]}},"type":"object","required":["title","video_type","duration","video_id","user_id","video_url","thumbnail_url","status","view_count","created_at","updated_at"],"title":"TutorialWithChaptersResponse","description":"Tutorial video with chapters"},"TwinCreate":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"voice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Id"},"style_tags":{"items":{"type":"string"},"type":"array","title":"Style Tags"},"persona_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Prompt"},"platform_defaults":{"additionalProperties":true,"type":"object","title":"Platform Defaults"}},"type":"object","required":["name"],"title":"TwinCreate"},"TwinResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"voice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Id"},"style_tags":{"items":{"type":"string"},"type":"array","title":"Style Tags"},"persona_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Prompt"},"platform_defaults":{"additionalProperties":true,"type":"object","title":"Platform Defaults"},"memory_namespace":{"type":"string","title":"Memory Namespace"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","name","avatar_url","voice_id","style_tags","persona_prompt","platform_defaults","memory_namespace","created_at"],"title":"TwinResponse"},"TwinUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"voice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Id"},"style_tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Style Tags"},"persona_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Prompt"},"platform_defaults":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Platform Defaults"}},"type":"object","title":"TwinUpdate"},"TwoFADisableRequest":{"properties":{"verification_code":{"anyOf":[{"type":"string","maxLength":6,"minLength":6},{"type":"null"}],"title":"Verification Code","description":"Current 2FA code (6 digits)"},"backup_code":{"anyOf":[{"type":"string","maxLength":10,"minLength":10},{"type":"null"}],"title":"Backup Code","description":"Backup code (10 characters)"}},"type":"object","title":"TwoFADisableRequest","description":"Request to disable 2FA","example":{"verification_code":"123456"}},"TwoFAEnableRequest":{"properties":{"phone_number":{"type":"string","maxLength":20,"minLength":10,"title":"Phone Number","description":"Phone number in E.164 format (e.g., +14155552671)"}},"type":"object","required":["phone_number"],"title":"TwoFAEnableRequest","description":"Request to enable 2FA for user","example":{"phone_number":"+14155552671"}},"TwoFAEnableResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Operation success status"},"message":{"type":"string","title":"Message","description":"Success message"},"backup_codes":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":10,"title":"Backup Codes","description":"10 backup codes (one-time display only)"}},"type":"object","required":["success","message","backup_codes"],"title":"TwoFAEnableResponse","description":"Response after enabling 2FA","example":{"backup_codes":["A1B2C3D4E5","F6G7H8I9J0","K1L2M3N4O5","P6Q7R8S9T0","U1V2W3X4Y5","Z6A7B8C9D0","E1F2G3H4I5","J6K7L8M9N0","O1P2Q3R4S5","T6U7V8W9X0"],"message":"Two-factor authentication enabled successfully","success":true}},"TwoFASendCodeResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Send success status"},"message":{"type":"string","title":"Message","description":"Result message"},"code_sent":{"type":"string","format":"date-time","title":"Code Sent","description":"Timestamp when code was sent"},"expires_at":{"type":"string","format":"date-time","title":"Expires At","description":"Code expiration timestamp"}},"type":"object","required":["success","message","code_sent","expires_at"],"title":"TwoFASendCodeResponse","description":"Response after sending 2FA code","example":{"code_sent":"2024-01-15T10:30:00Z","expires_at":"2024-01-15T10:35:00Z","message":"Verification code sent successfully","success":true}},"TwoFAStatusResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"2FA enabled status"},"phone_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number","description":"Masked phone number (last 4 digits)"},"verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Verified At","description":"When 2FA was verified"},"backup_codes_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Backup Codes Remaining","description":"Number of backup codes remaining"},"is_locked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Locked","description":"Account locked status","default":false},"lockout_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Lockout Until","description":"Lockout expiration timestamp"}},"type":"object","required":["enabled"],"title":"TwoFAStatusResponse","description":"Response with 2FA status","example":{"backup_codes_remaining":8,"enabled":true,"is_locked":false,"phone_number":"****2671","verified_at":"2024-01-15T10:00:00Z"}},"TwoFAVerifyRequest":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User UUID"},"code":{"type":"string","maxLength":6,"minLength":6,"title":"Code","description":"6-digit verification code"}},"type":"object","required":["user_id","code"],"title":"TwoFAVerifyRequest","description":"Request to verify 2FA code","example":{"code":"123456","user_id":"123e4567-e89b-12d3-a456-426614174000"}},"TwoFAVerifyResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Verification success status"},"message":{"type":"string","title":"Message","description":"Result message"},"access_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token","description":"JWT token if verification successful"},"token_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Type","description":"Token type","default":"bearer"},"locked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Locked","description":"Account locked status","default":false}},"type":"object","required":["success","message"],"title":"TwoFAVerifyResponse","description":"Response after verifying 2FA code","example":{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","locked":false,"message":"Verification code is valid","success":true,"token_type":"bearer"}},"TwoFactorStatus":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Whether 2FA is enabled"},"phone_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number","description":"Masked phone number (last 4 digits)"},"verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Verified At","description":"When 2FA was verified"},"backup_codes_remaining":{"type":"integer","title":"Backup Codes Remaining","description":"Number of unused backup codes","default":0}},"type":"object","required":["enabled"],"title":"TwoFactorStatus","description":"Schema for 2FA status within security settings","example":{"backup_codes_remaining":8,"enabled":true,"phone_number":"****1234","verified_at":"2024-01-20T10:30:00"}},"TypingAckResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"}},"type":"object","required":["ok"],"title":"TypingAckResponse"},"URLResult":{"properties":{"url":{"type":"string","title":"Url"},"success":{"type":"boolean","title":"Success"},"rows_inserted":{"type":"integer","title":"Rows Inserted"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["url","success","rows_inserted","error"],"title":"URLResult"},"UTMParams":{"properties":{"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"utm_term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Term"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"}},"type":"object","title":"UTMParams","description":"UTM parameters for campaign attribution"},"UltraReviewQuotaDetail":{"properties":{"used":{"type":"integer","title":"Used"},"limit":{"type":"integer","title":"Limit"},"remaining":{"type":"integer","title":"Remaining"}},"type":"object","required":["used","limit","remaining"],"title":"UltraReviewQuotaDetail"},"UltraReviewQuotaResponse":{"properties":{"quota":{"$ref":"#/components/schemas/UltraReviewQuotaDetail"}},"type":"object","required":["quota"],"title":"UltraReviewQuotaResponse","description":"Ultrareview usage quota."},"UnifiedSearchResponse":{"properties":{"query":{"type":"string","title":"Query","description":"Search query"},"users":{"items":{"$ref":"#/components/schemas/UserSearchResult"},"type":"array","title":"Users","description":"User results"},"posts":{"items":{"$ref":"#/components/schemas/PostSearchResult"},"type":"array","title":"Posts","description":"Post results"},"groups":{"items":{"$ref":"#/components/schemas/GroupSearchResult"},"type":"array","title":"Groups","description":"Group results"},"events":{"items":{"$ref":"#/components/schemas/EventSearchResult"},"type":"array","title":"Events","description":"Event results"},"total_users":{"type":"integer","title":"Total Users","description":"Total user results","default":0},"total_posts":{"type":"integer","title":"Total Posts","description":"Total post results","default":0},"total_groups":{"type":"integer","title":"Total Groups","description":"Total group results","default":0},"total_events":{"type":"integer","title":"Total Events","description":"Total event results","default":0},"limit":{"type":"integer","title":"Limit","description":"Results per category limit"},"offset":{"type":"integer","title":"Offset","description":"Results offset"}},"type":"object","required":["query","limit","offset"],"title":"UnifiedSearchResponse","description":"Unified search response across all content types","example":{"events":[],"groups":[],"limit":10,"offset":0,"posts":[],"query":"machine learning","total_events":5,"total_groups":12,"total_posts":234,"total_users":45,"users":[]}},"UnlinkResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"}},"type":"object","required":["connected"],"title":"UnlinkResponse"},"UnlistDomainsRequest":{"properties":{"domains":{"items":{"type":"string"},"type":"array","maxItems":200,"minItems":1,"title":"Domains","description":"Exact domains to remove from the public leaderboard (un-list, not delete -- sets include_in_leaderboard=FALSE)."}},"type":"object","required":["domains"],"title":"UnlistDomainsRequest"},"UnlistDomainsResponse":{"properties":{"unlisted":{"type":"integer","title":"Unlisted"},"domains":{"items":{"type":"string"},"type":"array","title":"Domains"}},"type":"object","required":["unlisted","domains"],"title":"UnlistDomainsResponse"},"UnlockAccountRequest":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User UUID to unlock"}},"type":"object","required":["user_id"],"title":"UnlockAccountRequest","description":"Admin request to unlock account","example":{"user_id":"123e4567-e89b-12d3-a456-426614174000"}},"UnpaidEarningsResponse":{"properties":{"developer_id":{"type":"string","title":"Developer Id"},"unpaid_cents":{"type":"integer","title":"Unpaid Cents"},"unpaid_count":{"type":"integer","title":"Unpaid Count"},"eligible_for_payout":{"type":"boolean","title":"Eligible For Payout"},"minimum_threshold_cents":{"type":"integer","title":"Minimum Threshold Cents"}},"type":"object","required":["developer_id","unpaid_cents","unpaid_count","eligible_for_payout","minimum_threshold_cents"],"title":"UnpaidEarningsResponse","description":"Unpaid x402 earnings + payout eligibility for the authenticated developer.\n\nMirrors X402EarningsService.get_unpaid_x402_earnings(). The delegate\nfilters on `developer_id = current_user.id`, so every value is already\ncaller-scoped. No `extra=\"allow\"` — this is money owed to a specific\ndeveloper and the field set is fixed and small."},"UpcomingStream":{"properties":{"schedule_id":{"type":"string","format":"uuid","title":"Schedule Id"},"date":{"type":"string","title":"Date","description":"Date in YYYY-MM-DD format"},"day_of_week":{"type":"integer","maximum":6,"minimum":0,"title":"Day Of Week"},"day_name":{"type":"string","title":"Day Name"},"start_time":{"type":"string","title":"Start Time","description":"Stream start time in HH:MM format (UTC)"},"end_time":{"type":"string","title":"End Time","description":"Stream end time in HH:MM format (UTC)"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryResponse"},{"type":"null"}]}},"type":"object","required":["schedule_id","date","day_of_week","day_name","start_time","end_time"],"title":"UpcomingStream","description":"Upcoming scheduled stream instance","example":{"category":{"id":"123e4567-e89b-12d3-a456-426614174000","name":"Programming","slug":"programming"},"date":"2025-12-30","day_name":"Tuesday","day_of_week":1,"end_time":"20:00","schedule_id":"sched-1111-2222-3333-4444-555566667777","start_time":"18:00","title":"Evening Code Stream"}},"UpcomingStreamsResponse":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"username":{"type":"string","title":"Username"},"upcoming_streams":{"items":{"$ref":"#/components/schemas/UpcomingStream"},"type":"array","title":"Upcoming Streams"},"days":{"type":"integer","title":"Days","description":"Number of days looked ahead"}},"type":"object","required":["user_id","username","upcoming_streams","days"],"title":"UpcomingStreamsResponse","description":"List of upcoming scheduled streams","example":{"days":7,"upcoming_streams":[{"date":"2025-12-30","day_name":"Tuesday","day_of_week":1,"end_time":"20:00","schedule_id":"sched-1111-2222-3333-4444-555566667777","start_time":"18:00","title":"Evening Stream"}],"user_id":"550e8400-e29b-41d4-a716-446655440000","username":"johndoe"}},"UpdateAgentTaskResponse":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"progress":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Progress"},"updated_at":{"type":"string","title":"Updated At"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","status","updated_at","message"],"title":"UpdateAgentTaskResponse"},"UpdateAlertRule":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"condition":{"anyOf":[{"$ref":"#/components/schemas/AlertCondition"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string","pattern":"^(critical|warning|info)$"},{"type":"null"}],"title":"Severity"},"actions":{"anyOf":[{"items":{"$ref":"#/components/schemas/AlertAction"},"type":"array","minItems":1},{"type":"null"}],"title":"Actions"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"cooldown_minutes":{"anyOf":[{"type":"integer","maximum":1440,"minimum":1},{"type":"null"}],"title":"Cooldown Minutes"}},"type":"object","title":"UpdateAlertRule","description":"Schema for updating an alert rule","example":{"cooldown_minutes":30,"enabled":false}},"UpdateAllowlistRequest":{"properties":{"domains":{"items":{"type":"string"},"type":"array","minItems":0,"title":"Domains","description":"Allowed domain patterns (supports wildcards like *.openai.com)"}},"type":"object","required":["domains"],"title":"UpdateAllowlistRequest","description":"Request body for PUT /api/v1/cloud/agents/{agent_id}/allowlist."},"UpdateDatabaseConfigResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"quantum_enabled":{"type":"boolean","title":"Quantum Enabled"},"vector_dimensions":{"type":"integer","title":"Vector Dimensions"},"mcp_enabled":{"type":"boolean","title":"Mcp Enabled"},"database_config":{"additionalProperties":true,"type":"object","title":"Database Config"},"updated_fields":{"items":{"type":"string"},"type":"array","title":"Updated Fields"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","quantum_enabled","vector_dimensions","mcp_enabled","database_config","updated_fields","message"],"title":"UpdateDatabaseConfigResponse"},"UpdateDocumentationResponse":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"updated_fields":{"additionalProperties":true,"type":"object","title":"Updated Fields"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["doc_id","status","message","updated_fields","timestamp"],"title":"UpdateDocumentationResponse","description":"Response for PUT /help-documentation/content/{doc_id}."},"UpdateFeedbackStatusRequest":{"properties":{"status":{"type":"string","title":"Status","description":"New feedback status"},"response":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Response","description":"Response to feedback"}},"type":"object","required":["status"],"title":"UpdateFeedbackStatusRequest"},"UpdateFeedbackStatusResponse":{"properties":{"feedback_id":{"type":"string","title":"Feedback Id"},"status":{"type":"string","title":"Status"},"reviewed_by":{"type":"string","title":"Reviewed By"},"reviewed_at":{"type":"string","title":"Reviewed At"},"response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response"},"message":{"type":"string","title":"Message"}},"type":"object","required":["feedback_id","status","reviewed_by","reviewed_at","message"],"title":"UpdateFeedbackStatusResponse","description":"PUT /user-feedback/feedback/{feedback_id}/status"},"UpdateGitConfigResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"config":{"additionalProperties":true,"type":"object","title":"Config"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","config","timestamp"],"title":"UpdateGitConfigResponse","description":"Response for PUT /git-integration/config."},"UpdateLearningTaskResponse":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","status","message"],"title":"UpdateLearningTaskResponse"},"UpdateLimitsRequest":{"properties":{"spending_limit_usd":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Spending Limit Usd"},"single_payment_limit_usd":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Single Payment Limit Usd"}},"type":"object","title":"UpdateLimitsRequest"},"UpdateOAuthClientRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name","description":"App display name"},"redirect_uris":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Redirect Uris","description":"OAuth redirect URIs"},"scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scopes","description":"Requested OAuth scopes"},"grant_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Grant Types","description":"OAuth grant types"}},"type":"object","title":"UpdateOAuthClientRequest","description":"Request to update an OAuth client (Refs #6524).\n\nAll fields optional — only supplied fields are changed. Omitting\nredirect_uris leaves the stored value intact (avoids the #6526 wipe)."},"UpdatePerformanceBaselineResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"updated_baselines":{"additionalProperties":{"type":"number"},"type":"object","title":"Updated Baselines"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","message","updated_baselines","timestamp"],"title":"UpdatePerformanceBaselineResponse","description":"PUT /deployment/performance/baseline — baselines updated."},"UpdatePolicyRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":256,"minLength":1},{"type":"null"}],"title":"Name"},"default_effect":{"anyOf":[{"type":"string","pattern":"^(allow|deny)$"},{"type":"null"}],"title":"Default Effect"},"enforcement_mode":{"anyOf":[{"type":"string","pattern":"^(enforce|audit)$"},{"type":"null"}],"title":"Enforcement Mode"},"intent_classifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent Classifier"},"rules":{"anyOf":[{"items":{"$ref":"#/components/schemas/PolicyRuleSchema"},"type":"array"},{"type":"null"}],"title":"Rules"}},"type":"object","title":"UpdatePolicyRequest"},"UpdateProfileResponse":{"properties":{"status":{"type":"string","title":"Status"},"profile_visibility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Visibility"},"show_online_status":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Show Online Status"},"allow_messages_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Allow Messages From"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"cover_photo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Photo Url"}},"additionalProperties":true,"type":"object","required":["status"],"title":"UpdateProfileResponse","description":"PUT /auth/me/profile — the caller's profile fields after a partial update."},"UpdateSessionRequest":{"properties":{"session_name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Session Name","description":"Updated session name"},"max_participants":{"anyOf":[{"type":"integer","maximum":50,"minimum":2},{"type":"null"}],"title":"Max Participants","description":"Updated max participants"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Updated metadata"}},"type":"object","title":"UpdateSessionRequest","description":"Request model for updating a video session"},"UpdateTestStatusResponse":{"properties":{"test_id":{"type":"string","title":"Test Id"},"new_status":{"type":"string","title":"New Status"},"updated_by":{"type":"string","title":"Updated By"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message"}},"type":"object","required":["test_id","new_status","updated_by","timestamp","message"],"title":"UpdateTestStatusResponse","description":"Response for PUT /ab-testing/tests/{test_id}/status."},"UpdateUserProgressResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"update_data":{"additionalProperties":true,"type":"object","title":"Update Data"}},"type":"object","required":["user_id","status","message","update_data"],"title":"UpdateUserProgressResponse","description":"Response for POST /onboarding-tutorials/user-progress/{user_id}/update."},"UpdateUserResponse":{"properties":{"message":{"type":"string","title":"Message"},"user":{"$ref":"#/components/schemas/UpdatedUserSummary"}},"type":"object","required":["message","user"],"title":"UpdateUserResponse"},"UpdateWidgetRequest":{"properties":{"brand_color":{"anyOf":[{"type":"string","maxLength":7},{"type":"null"}],"title":"Brand Color"},"title":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Title"},"subtitle":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Subtitle"},"welcome_message":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Welcome Message"},"logo_url":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Logo Url"},"position":{"anyOf":[{"type":"string","pattern":"^(bottom-right|bottom-left)$"},{"type":"null"}],"title":"Position"}},"type":"object","title":"UpdateWidgetRequest","description":"Customize the chat widget appearance."},"UpdateWidgetResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"widget_config":{"additionalProperties":true,"type":"object","title":"Widget Config"}},"type":"object","required":["ok","widget_config"],"title":"UpdateWidgetResponse"},"UpdatedUserSummary":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"username":{"type":"string","title":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"role":{"type":"string","title":"Role"},"is_active":{"type":"boolean","title":"Is Active"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","email","username","role","is_active","updated_at"],"title":"UpdatedUserSummary"},"UpgradeAlternative":{"properties":{"model_id":{"type":"string","title":"Model Id"},"label":{"type":"string","title":"Label"},"tier":{"type":"string","title":"Tier"},"tradeoff":{"type":"string","title":"Tradeoff"}},"type":"object","required":["model_id","label","tier","tradeoff"],"title":"UpgradeAlternative"},"UpgradePostgresResponse":{"properties":{"status":{"type":"string","title":"Status"},"previous_version":{"type":"string","title":"Previous Version"},"target_version":{"type":"string","title":"Target Version"},"image":{"type":"string","title":"Image"},"project_id":{"type":"string","title":"Project Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["status","previous_version","target_version","image","project_id","message"],"title":"UpgradePostgresResponse"},"UploadDocumentationResponse":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"document":{"additionalProperties":true,"type":"object","title":"Document"}},"type":"object","required":["doc_id","status","message","document"],"title":"UploadDocumentationResponse","description":"Response for POST /help-documentation/upload."},"UploadKnowledgeRequest":{"properties":{"title":{"type":"string","maxLength":255,"title":"Title"},"content":{"type":"string","maxLength":50000,"minLength":10,"title":"Content"},"category":{"type":"string","maxLength":100,"title":"Category","default":"general"}},"type":"object","required":["title","content"],"title":"UploadKnowledgeRequest","description":"Upload knowledge base content for AI auto-reply."},"UploadKnowledgeResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"message":{"type":"string","title":"Message"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"note":{"type":"string","title":"Note"}},"type":"object","required":["ok","message","note"],"title":"UploadKnowledgeResponse","description":"`category` is only present when the ZeroDB RAG write succeeded;\notherwise the article was stored locally pending the next sync cycle."},"UploadLogoResponse":{"properties":{"toast":{"type":"string","title":"Toast"},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"preview_grayscale":{"type":"boolean","title":"Preview Grayscale","default":true}},"type":"object","required":["toast"],"title":"UploadLogoResponse"},"UploadRulesFileResponse":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"content":{"type":"string","title":"Content"},"parsed_rules":{"items":{"$ref":"#/components/schemas/ParsedRuleEntry"},"type":"array","title":"Parsed Rules"},"uploaded_at":{"type":"string","title":"Uploaded At"},"status":{"type":"string","title":"Status"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["id","filename","content","parsed_rules","uploaded_at","status","user_id"],"title":"UploadRulesFileResponse"},"UploadW9Response":{"properties":{"document":{"additionalProperties":true,"type":"object","title":"Document"},"view_path":{"type":"string","title":"View Path"}},"type":"object","required":["document","view_path"],"title":"UploadW9Response"},"UpsertEntityRequest":{"properties":{"canonical_name":{"type":"string","title":"Canonical Name","description":"Entity canonical name"},"entity_type":{"type":"string","title":"Entity Type","description":"Entity type: person|org|tech|concept"},"aliases":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Aliases","description":"Known aliases"},"properties":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Properties","description":"Entity properties"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project ID. Tags the entity into this project's graph so project-scoped reads can narrow to it, and selects the ontology used for the entity_type warning. Refs core#9439, #1545"}},"type":"object","required":["canonical_name","entity_type"],"title":"UpsertEntityRequest"},"UpsertEntityResponse":{"properties":{"id":{"type":"string","title":"Id"},"canonical_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Name"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"},"memory_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Count"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning"}},"additionalProperties":true,"type":"object","required":["id"],"title":"UpsertEntityResponse","description":"Response for POST /memory/v2/graph/entity.\n\n``warning`` is added by the handler ONLY when a project ontology exists\nand the submitted entity_type is not in its allowed list — entity creation\nis deliberately not blocked (Refs #1545). The route therefore MUST use\n``response_model_exclude_unset=True`` so a conforming entity_type does not\ncome back with a bogus ``\"warning\": null``."},"UptimeCurrentUptime":{"properties":{"days":{"type":"integer","title":"Days"},"hours":{"type":"integer","title":"Hours"},"minutes":{"type":"integer","title":"Minutes"},"total_seconds":{"type":"number","title":"Total Seconds"}},"type":"object","required":["days","hours","minutes","total_seconds"],"title":"UptimeCurrentUptime"},"UptimeStatistics":{"properties":{"current_uptime":{"$ref":"#/components/schemas/UptimeCurrentUptime"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"data_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Source"}},"type":"object","required":["current_uptime"],"title":"UptimeStatistics","description":"REAL -- current process uptime (Refs #8270).\n\nHistorical availability percentages, per-service uptime and dated\ndowntime events were invented and are no longer reported."},"UsageAggregateBreakdown":{"properties":{"api_credits":{"$ref":"#/components/schemas/UsageCategoryDetail"},"llm_tokens":{"$ref":"#/components/schemas/UsageCategoryDetail"},"storage_gb":{"$ref":"#/components/schemas/UsageCategoryDetail"},"mcp_hours":{"$ref":"#/components/schemas/UsageCategoryDetail"}},"type":"object","required":["api_credits","llm_tokens","storage_gb","mcp_hours"],"title":"UsageAggregateBreakdown"},"UsageAggregatePeriodInfo":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"type":{"type":"string","title":"Type"}},"type":"object","required":["start","end","type"],"title":"UsageAggregatePeriodInfo"},"UsageAggregatePlan":{"properties":{"name":{"type":"string","title":"Name"},"tier":{"type":"string","title":"Tier"},"status":{"type":"string","title":"Status"}},"type":"object","required":["name","tier","status"],"title":"UsageAggregatePlan"},"UsageAggregateResponse":{"properties":{"total_tokens":{"type":"integer","title":"Total Tokens"},"total_requests":{"type":"integer","title":"Total Requests"},"total_cost":{"type":"number","title":"Total Cost"},"avg_response_time_ms":{"type":"integer","title":"Avg Response Time Ms"},"by_provider":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"By Provider"},"period":{"type":"string","title":"Period"},"usage":{"$ref":"#/components/schemas/UsageAggregateBreakdown"},"plan":{"$ref":"#/components/schemas/UsageAggregatePlan"},"period_info":{"$ref":"#/components/schemas/UsageAggregatePeriodInfo"}},"type":"object","required":["total_tokens","total_requests","total_cost","avg_response_time_ms","by_provider","period","usage","plan","period_info"],"title":"UsageAggregateResponse"},"UsageAnalyticsResponse":{"properties":{"period":{"type":"string","title":"Period"},"total_users":{"type":"integer","title":"Total Users"},"active_users":{"type":"integer","title":"Active Users"},"total_organizations":{"type":"integer","title":"Total Organizations"},"total_projects":{"type":"integer","title":"Total Projects"},"api_calls_total":{"type":"integer","title":"Api Calls Total"},"api_calls_today":{"type":"integer","title":"Api Calls Today"},"top_endpoints":{"items":{"$ref":"#/components/schemas/app__schemas__admin__management__EndpointUsage"},"type":"array","title":"Top Endpoints"},"user_growth":{"items":{"$ref":"#/components/schemas/UserGrowthData"},"type":"array","title":"User Growth"}},"type":"object","required":["period","total_users","active_users","total_organizations","total_projects","api_calls_total","api_calls_today","top_endpoints","user_growth"],"title":"UsageAnalyticsResponse","description":"System usage analytics"},"UsageBreakdown":{"properties":{"vector_operations":{"type":"number","title":"Vector Operations","description":"Vector search/upsert/delete credits"},"memory_operations":{"type":"number","title":"Memory Operations","description":"Agent memory operations credits"},"storage_operations":{"type":"number","title":"Storage Operations","description":"File upload/download credits"},"database_operations":{"type":"number","title":"Database Operations","description":"NoSQL table operations credits"},"postgres_queries":{"type":"number","title":"Postgres Queries","description":"Managed PostgreSQL query credits"}},"type":"object","required":["vector_operations","memory_operations","storage_operations","database_operations","postgres_queries"],"title":"UsageBreakdown","description":"Credit usage breakdown by category","example":{"database_operations":400,"memory_operations":300,"postgres_queries":100,"storage_operations":200.5,"vector_operations":500}},"UsageBreakdownResponse":{"properties":{"sponsor_id":{"type":"string","title":"Sponsor Id"},"total_credits_used":{"type":"integer","title":"Total Credits Used"},"campaigns":{"items":{"$ref":"#/components/schemas/CampaignUsage"},"type":"array","title":"Campaigns"},"time_period":{"type":"string","title":"Time Period","description":"Time period for breakdown (e.g., 'last_30_days')"}},"type":"object","required":["sponsor_id","total_credits_used","campaigns","time_period"],"title":"UsageBreakdownResponse","description":"Schema for usage breakdown response","example":{"campaigns":[{"avg_cpm":"10.00","campaign_id":"camp_1","campaign_name":"Summer Campaign","clicks":300,"credits_used":150,"ctr":2,"impressions":15000}],"sponsor_id":"sponsor_abc123","time_period":"last_30_days","total_credits_used":350}},"UsageByModelResponse":{"properties":{"models":{"items":{"$ref":"#/components/schemas/ModelUsageItem"},"type":"array","title":"Models"},"total":{"type":"integer","title":"Total"},"period":{"type":"string","title":"Period"}},"type":"object","required":["models","total","period"],"title":"UsageByModelResponse"},"UsageCategoryDetail":{"properties":{"used":{"title":"Used"},"limit":{"title":"Limit"},"remaining":{"title":"Remaining"},"percentage":{"type":"number","title":"Percentage"},"status":{"type":"string","title":"Status"},"unit":{"type":"string","title":"Unit"}},"type":"object","required":["used","limit","remaining","percentage","status","unit"],"title":"UsageCategoryDetail"},"UsageCostBreakdown":{"properties":{"base_fee":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Base Fee"},"overage_fees":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overage Fees"},"overage_breakdown":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Overage Breakdown"}},"type":"object","title":"UsageCostBreakdown"},"UsageCostsResponse":{"properties":{"total_cost":{"type":"number","title":"Total Cost"},"currency":{"type":"string","title":"Currency"},"period":{"type":"string","title":"Period"},"breakdown":{"anyOf":[{"$ref":"#/components/schemas/UsageCostBreakdown"},{"type":"null"}]},"projected_monthly":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Projected Monthly"}},"type":"object","required":["total_cost","currency","period"],"title":"UsageCostsResponse"},"UsageCounter":{"properties":{"used":{"type":"integer","title":"Used"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"}},"type":"object","required":["used"],"title":"UsageCounter"},"UsageHealthDiagnosis":{"properties":{"disable_usage_logging_env":{"type":"string","title":"Disable Usage Logging Env"},"writer_lands_row":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Writer Lands Row"},"writer_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Writer Error"},"api_usage_logs_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Api Usage Logs Total"},"mcp_request_logs_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mcp Request Logs Total"},"count_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Count Error"}},"type":"object","required":["disable_usage_logging_env"],"title":"UsageHealthDiagnosis"},"UsageHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"usage_logging":{"type":"boolean","title":"Usage Logging"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status","usage_logging"],"title":"UsageHealthResponse","description":"Both branches (DB write succeeds / fails) return 200 by design — this is a\ndiagnostic probe, not a request the caller can retry differently."},"UsageHistoryEntry":{"properties":{"date":{"type":"string","title":"Date","description":"Date (YYYY-MM-DD)"},"requests":{"type":"integer","title":"Requests","description":"Number of requests"},"credits_used":{"type":"number","title":"Credits Used","description":"Credits consumed"},"tokens":{"type":"integer","title":"Tokens","description":"Total tokens used"}},"type":"object","required":["date","requests","credits_used","tokens"],"title":"UsageHistoryEntry","description":"Single day in usage history"},"UsageHistoryResponse":{"properties":{"history":{"items":{"$ref":"#/components/schemas/UsageHistoryEntry"},"type":"array","title":"History","description":"Daily usage entries (sorted by date descending)"}},"type":"object","required":["history"],"title":"UsageHistoryResponse","description":"Historical usage data response","example":{"history":[{"credits_used":18.5,"date":"2026-01-05","requests":25,"tokens":15000},{"credits_used":22,"date":"2026-01-04","requests":30,"tokens":18000}]}},"UsageLimitsResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","title":"UsageLimitsResponse","description":"Response for usage and limits endpoint"},"UsageListResponse":{"properties":{"usage_records":{"items":{"$ref":"#/components/schemas/app__schemas__multimodal__UsageRecord"},"type":"array","title":"Usage Records"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["usage_records","total","skip","limit"],"title":"UsageListResponse","description":"Response schema for usage history"},"UsageLogItem":{"properties":{"id":{"type":"string","title":"Id"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"},"type":{"type":"string","title":"Type"},"value":{"type":"integer","title":"Value"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","type","value","metadata"],"title":"UsageLogItem"},"UsageLogsResponse":{"properties":{"logs":{"items":{"$ref":"#/components/schemas/UsageLogItem"},"type":"array","title":"Logs"},"total":{"type":"integer","title":"Total"},"period_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Period Days"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"}},"type":"object","required":["logs","total"],"title":"UsageLogsResponse"},"UsageMetrics":{"properties":{"api_calls":{"$ref":"#/components/schemas/UsageCounter"},"input_tokens":{"$ref":"#/components/schemas/UsageCounter"},"output_tokens":{"$ref":"#/components/schemas/UsageCounter"}},"type":"object","required":["api_calls","input_tokens","output_tokens"],"title":"UsageMetrics"},"UsageSummaryResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"},"plan_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Name"},"plan":{"$ref":"#/components/schemas/PlanInfo"},"period":{"$ref":"#/components/schemas/BillingPeriod"},"usage":{"$ref":"#/components/schemas/UsageMetrics"},"rate_limits":{"$ref":"#/components/schemas/RateLimits"},"tasks":{"anyOf":[{"$ref":"#/components/schemas/TaskMeter"},{"type":"null"}]}},"type":"object","required":["plan","period","usage","rate_limits"],"title":"UsageSummaryResponse"},"UsageWindow":{"properties":{"utilization":{"type":"number","maximum":1,"minimum":0,"title":"Utilization","description":"Utilization ratio from 0.0 (no usage) to 1.0 (at limit)"},"used":{"type":"integer","minimum":0,"title":"Used","description":"Number of requests used in this window"},"limit":{"type":"integer","exclusiveMinimum":0,"title":"Limit","description":"Maximum requests allowed in this window"},"remaining":{"type":"integer","minimum":0,"title":"Remaining","description":"Requests remaining in this window"}},"type":"object","required":["utilization","used","limit","remaining"],"title":"UsageWindow","description":"Usage statistics for a single time window."},"UserActivityBreakdown":{"properties":{"active_percentage":{"type":"number","title":"Active Percentage"},"verified_percentage":{"type":"number","title":"Verified Percentage"},"admin_percentage":{"type":"number","title":"Admin Percentage"}},"type":"object","required":["active_percentage","verified_percentage","admin_percentage"],"title":"UserActivityBreakdown"},"UserAuditTrailEvent":{"properties":{"id":{"type":"string","title":"Id"},"timestamp":{"type":"string","title":"Timestamp"},"action":{"type":"string","title":"Action"},"performed_by":{"type":"string","title":"Performed By"},"details":{"type":"string","title":"Details"},"ip_address":{"type":"string","title":"Ip Address"},"compliance_relevant":{"type":"boolean","title":"Compliance Relevant"}},"type":"object","required":["id","timestamp","action","performed_by","details","ip_address","compliance_relevant"],"title":"UserAuditTrailEvent"},"UserAuditTrailSummary":{"properties":{"account_created":{"type":"string","title":"Account Created"},"last_login":{"type":"string","title":"Last Login"},"total_logins":{"type":"integer","title":"Total Logins"},"admin_actions_performed":{"type":"integer","title":"Admin Actions Performed"},"data_exports":{"type":"integer","title":"Data Exports"},"role_changes":{"type":"integer","title":"Role Changes"}},"type":"object","required":["account_created","last_login","total_logins","admin_actions_performed","data_exports","role_changes"],"title":"UserAuditTrailSummary"},"UserCreate":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"preferred_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preferred Name"},"ext":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ext","description":"Ad attribution data (gclid, utm_source, utm_medium, etc.)"},"stripe_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Session Id","description":"Stripe checkout session ID for post-payment signup"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan","description":"Plan from checkout flow (pro, business, enterprise)"},"signup_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signup Source","description":"Where the signup came from: 'web' (human), 'instant_db'/'agent' (keyless growth funnel — never card-gated). Refs #5761."},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website","description":"Honeypot: a hidden form field no human fills. A non-empty value marks the signup as an automated bot and is rejected. Refs #6099."},"turnstile_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turnstile Token","description":"Cloudflare Turnstile token (the widget's cf-turnstile-response value). Required for browser signups when TURNSTILE_ENABLED is on; verified server-side before any DB/Stripe/email work. Refs #8310."}},"type":"object","required":["email","password"],"title":"UserCreate","description":"Schema for user registration\n\nThe 'name' field is optional — many users skip it during signup.\nThe frontend may send preferred_name or name; both are accepted.\nFixes #2973: required name field rejected signups with empty string.\nRefs #4712: ext carries ad attribution (gclid, utm_source, etc.).\nRefs #5053: stripe_session_id links post-payment signup to auto-provisioned account."},"UserCreateResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","email","status"],"title":"UserCreateResponse","example":{"email":"newuser@example.com","id":"user-new-456","status":"active"}},"UserGrowthData":{"properties":{"date":{"type":"string","title":"Date"},"total_users":{"type":"integer","title":"Total Users"}},"type":"object","required":["date","total_users"],"title":"UserGrowthData","description":"User growth data point"},"UserGrowthPoint":{"properties":{"date":{"type":"string","title":"Date"},"total_users":{"type":"integer","title":"Total Users"}},"type":"object","required":["date","total_users"],"title":"UserGrowthPoint"},"UserInfo":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"organization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"}},"type":"object","required":["id","email"],"title":"UserInfo","description":"User identity fields the CLI caches for session context."},"UserInteractionRequest":{"properties":{"type":{"type":"string","title":"Type","description":"Type of interaction (click, navigation, etc.)"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"User session ID"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project being worked on"},"workflow_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Stage","description":"Current workflow stage"},"agent_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Type","description":"Agent being interacted with"},"element_clicked":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Element Clicked","description":"UI element that was clicked"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url","description":"Current page URL"},"form_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Form Data","description":"Form data if applicable"},"rating_score":{"anyOf":[{"type":"integer","maximum":5,"minimum":1},{"type":"null"}],"title":"Rating Score","description":"User rating 1-5"},"feedback_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Text","description":"User's text feedback"},"error_details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error Details","description":"Error information"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent","description":"Browser user agent"},"viewport_size":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Viewport Size","description":"Browser viewport size"},"response_time_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Time Ms","description":"Response time in milliseconds"}},"type":"object","required":["type"],"title":"UserInteractionRequest","description":"Request model for user interaction data"},"UserLiveStatusResponse":{"properties":{"is_live":{"type":"boolean","title":"Is Live","description":"Whether user is currently streaming"},"stream":{"anyOf":[{"$ref":"#/components/schemas/StreamResponse"},{"type":"null"}],"description":"Current stream details if live"}},"type":"object","required":["is_live"],"title":"UserLiveStatusResponse","description":"User live status response for GET /v1/streams/users/{username}/live\nIssue #876: Add user live status endpoint\n\nReturns whether a user is currently live streaming with optional stream details.","example":{"isLive":true,"stream":{"description":"Live coding session","id":"550e8400-e29b-41d4-a716-446655440000","startedAt":"2024-01-15T14:30:00Z","status":"live","title":"Coding Stream: Building REST APIs","userId":"550e8400-e29b-41d4-a716-446655440001","viewerCount":42}}},"UserPlanLookupResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"plan":{"type":"string","title":"Plan"},"subscription_tier":{"type":"string","title":"Subscription Tier"},"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["user_id","email","plan","subscription_tier","is_active"],"title":"UserPlanLookupResponse","description":"Minimal cross-app provisioning shape. No PII beyond email/plan."},"UserProfileResponse":{"properties":{"id":{"type":"string","title":"Id","description":"User UUID"},"username":{"type":"string","title":"Username","description":"Unique username"},"display_name":{"type":"string","title":"Display Name","description":"Display name for UI"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio","description":"User bio"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"Avatar image URL"},"follower_count":{"type":"integer","minimum":0,"title":"Follower Count","description":"Number of followers","default":0},"following_count":{"type":"integer","minimum":0,"title":"Following Count","description":"Number of users followed","default":0},"is_live":{"type":"boolean","title":"Is Live","description":"Whether user is currently streaming","default":false},"current_stream":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Current Stream","description":"Current stream info if live"},"total_views":{"type":"integer","minimum":0,"title":"Total Views","description":"Total views across all streams","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Account creation timestamp"}},"type":"object","required":["id","username","display_name","created_at"],"title":"UserProfileResponse","description":"User profile response for GET /v1/streams/users/{username}/profile\nIssue #468: Missing user profile endpoint\n\nReturns comprehensive user profile with streaming stats, follower counts,\nand current live stream status.\n\nUpdated to use snake_case to match AINative API standard (93% of codebase).","example":{"avatar_url":"https://storage.ainative.studio/avatars/urbantech.jpg","bio":"Developer and streamer","created_at":"2024-01-01T00:00:00Z","display_name":"Urban Tech","follower_count":1234,"following_count":567,"id":"550e8400-e29b-41d4-a716-446655440000","is_live":false,"total_views":50000,"username":"urbantech"}},"UserProgressResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"onboarding_progress":{"additionalProperties":true,"type":"object","title":"Onboarding Progress"},"tutorial_progress":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tutorial Progress"},"achievements":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Achievements"},"recommended_next_steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recommended Next Steps"},"overall_completion_percentage":{"type":"number","title":"Overall Completion Percentage"}},"type":"object","required":["user_id","onboarding_progress","tutorial_progress","achievements","recommended_next_steps","overall_completion_percentage"],"title":"UserProgressResponse","description":"Response for GET /onboarding-tutorials/user-progress/{user_id}."},"UserRecommendationsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total number of results"},"limit":{"type":"integer","title":"Limit","description":"Results per page"},"offset":{"type":"integer","title":"Offset","description":"Results offset"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results exist"},"users":{"items":{"$ref":"#/components/schemas/app__schemas__search__RecommendedUser"},"type":"array","title":"Users","description":"Recommended users"}},"type":"object","required":["total","limit","offset","has_more"],"title":"UserRecommendationsResponse","description":"User recommendations response"},"UserResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email_verified":{"type":"boolean","title":"Email Verified"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"github_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Id"},"plan":{"type":"string","title":"Plan","default":"free"},"trial_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Trial Expires At"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"phone_verified":{"type":"boolean","title":"Phone Verified","default":false}},"type":"object","required":["id","email_verified","created_at"],"title":"UserResponse","description":"Schema for user response (without sensitive data)"},"UserSearchResult":{"properties":{"id":{"type":"string","title":"Id","description":"User ID"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username","description":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name","description":"Full name"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio","description":"User bio"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"Avatar URL"},"follower_count":{"type":"integer","title":"Follower Count","description":"Number of followers","default":0},"relevance_score":{"type":"number","maximum":1,"minimum":0,"title":"Relevance Score","description":"Search relevance score"}},"type":"object","required":["id","relevance_score"],"title":"UserSearchResult","description":"User search result item","example":{"avatar_url":"https://cdn.example.com/avatars/jane.jpg","bio":"Machine learning researcher and educator","follower_count":1523,"full_name":"Jane Doe","id":"a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d","relevance_score":0.95,"username":"ml_expert"}},"UserSettingsPayload":{"properties":{"settings":{"additionalProperties":true,"type":"object","title":"Settings","description":"Arbitrary JSON blob of user CLI settings"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","description":"Client version that produced these settings"}},"type":"object","required":["settings"],"title":"UserSettingsPayload","description":"Payload for uploading user CLI settings."},"UserSummaryResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","email","status"],"title":"UserSummaryResponse","example":{"email":"user@example.com","id":"user-123","status":"active"}},"UserUsageBilling":{"properties":{"plan":{"type":"string","title":"Plan"},"monthly_cost_usd":{"type":"number","title":"Monthly Cost Usd"}},"type":"object","required":["plan","monthly_cost_usd"],"title":"UserUsageBilling"},"UserUsageLimits":{"properties":{"max_projects":{"type":"integer","title":"Max Projects"},"max_storage_gb":{"type":"number","title":"Max Storage Gb"},"max_api_calls_per_month":{"type":"integer","title":"Max Api Calls Per Month"}},"type":"object","required":["max_projects","max_storage_gb","max_api_calls_per_month"],"title":"UserUsageLimits"},"UserUsageStatsResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"role":{"type":"string","title":"Role"},"is_active":{"type":"boolean","title":"Is Active"},"usage":{"$ref":"#/components/schemas/UserUsageUsage"},"limits":{"$ref":"#/components/schemas/UserUsageLimits"},"billing":{"$ref":"#/components/schemas/UserUsageBilling"},"period_days":{"type":"integer","title":"Period Days"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["user_id","email","role","is_active","usage","limits","billing","period_days","timestamp"],"title":"UserUsageStatsResponse","description":"Response for GET /users/{user_id}/usage."},"UserUsageUsage":{"properties":{"projects_count":{"type":"integer","title":"Projects Count"},"vectors_count":{"type":"integer","title":"Vectors Count"},"tables_count":{"type":"integer","title":"Tables Count"},"storage_used_gb":{"type":"number","title":"Storage Used Gb"},"api_calls_30d":{"type":"integer","title":"Api Calls 30D"},"last_active":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Active"}},"type":"object","required":["projects_count","vectors_count","tables_count","storage_used_gb","api_calls_30d"],"title":"UserUsageUsage"},"UserWithCreditsItem":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"credits_balance":{"type":"number","title":"Credits Balance"},"total_purchased":{"type":"number","title":"Total Purchased"},"total_used":{"type":"number","title":"Total Used"},"transaction_count":{"type":"integer","title":"Transaction Count"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","email","credits_balance","total_purchased","total_used","transaction_count"],"title":"UserWithCreditsItem"},"UsersWithCreditsData":{"properties":{"users":{"items":{"$ref":"#/components/schemas/UserWithCreditsItem"},"type":"array","title":"Users"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["users","total","skip","limit"],"title":"UsersWithCreditsData"},"UsersWithCreditsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/UsersWithCreditsData"}},"type":"object","required":["success","data"],"title":"UsersWithCreditsResponse","description":"Response for GET /admin/credits/users."},"UtilizationPercentages":{"properties":{"cpu_percent":{"type":"number","title":"Cpu Percent"},"memory_percent":{"type":"number","title":"Memory Percent"},"storage_percent":{"type":"number","title":"Storage Percent"},"network_percent":{"type":"number","title":"Network Percent"}},"type":"object","required":["cpu_percent","memory_percent","storage_percent","network_percent"],"title":"UtilizationPercentages"},"VODChapterCreate":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Chapter title"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description","description":"Chapter description"},"start_time_seconds":{"type":"integer","minimum":0,"title":"Start Time Seconds","description":"Start time in seconds from VOD start"},"end_time_seconds":{"type":"integer","exclusiveMinimum":0,"title":"End Time Seconds","description":"End time in seconds from VOD start"},"thumbnail_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Thumbnail Url","description":"Chapter thumbnail URL"}},"type":"object","required":["title","start_time_seconds","end_time_seconds"],"title":"VODChapterCreate","description":"Schema for creating a VOD chapter manually","example":{"description":"Setting up the development environment and project structure","end_time_seconds":300,"start_time_seconds":0,"thumbnail_url":"https://storage.ainative.studio/vod/chapters/intro.jpg","title":"Introduction and Setup"}},"VODChapterGenerateRequest":{"properties":{"min_chapter_duration":{"type":"integer","maximum":600,"minimum":60,"title":"Min Chapter Duration","description":"Minimum chapter duration in seconds","default":120},"max_chapters":{"type":"integer","maximum":20,"minimum":1,"title":"Max Chapters","description":"Maximum number of chapters to generate","default":10},"use_chat_data":{"type":"boolean","title":"Use Chat Data","description":"Use chat message spikes to identify chapter boundaries","default":true}},"type":"object","title":"VODChapterGenerateRequest","description":"Request to generate AI chapters for a VOD","example":{"max_chapters":8,"min_chapter_duration":180,"use_chat_data":true}},"VODChapterGenerateResponse":{"properties":{"vod_id":{"type":"string","format":"uuid","title":"Vod Id"},"chapters":{"items":{"$ref":"#/components/schemas/VODChapterResponse"},"type":"array","title":"Chapters"},"count":{"type":"integer","title":"Count","description":"Number of chapters generated"},"processing_time_seconds":{"type":"number","title":"Processing Time Seconds","description":"Time taken to generate chapters"}},"type":"object","required":["vod_id","chapters","count","processing_time_seconds"],"title":"VODChapterGenerateResponse","description":"Response from AI chapter generation","example":{"chapters":[{"confidence_score":92,"end_time_seconds":420,"id":"chapter-ai-1111-2222-3333-4444","is_ai_generated":true,"start_time_seconds":0,"title":"Introduction and Project Overview","vod_id":"vod-1111-2222-3333-4444-555566667777"}],"count":8,"processing_time_seconds":2.45,"vod_id":"vod-1111-2222-3333-4444-555566667777"}},"VODChapterListResponse":{"properties":{"vod_id":{"type":"string","format":"uuid","title":"Vod Id"},"chapters":{"items":{"$ref":"#/components/schemas/VODChapterResponse"},"type":"array","title":"Chapters"},"total":{"type":"integer","title":"Total","description":"Total number of chapters"}},"type":"object","required":["vod_id","chapters","total"],"title":"VODChapterListResponse","description":"List of chapters for a VOD","example":{"chapters":[{"end_time_seconds":300,"id":"chapter-1111-2222-3333-4444-555566667777","is_ai_generated":false,"start_time_seconds":0,"title":"Introduction","vod_id":"vod-1111-2222-3333-4444-555566667777"},{"confidence_score":85,"end_time_seconds":1200,"id":"chapter-2222-3333-4444-5555-666677778888","is_ai_generated":true,"start_time_seconds":300,"title":"Building the API","vod_id":"vod-1111-2222-3333-4444-555566667777"}],"total":2,"vod_id":"vod-1111-2222-3333-4444-555566667777"}},"VODChapterResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"vod_id":{"type":"string","format":"uuid","title":"Vod Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"start_time_seconds":{"type":"integer","title":"Start Time Seconds"},"end_time_seconds":{"type":"integer","title":"End Time Seconds"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"is_ai_generated":{"type":"boolean","title":"Is Ai Generated","default":false},"confidence_score":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"title":"Confidence Score","description":"AI confidence score (0-100)"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","vod_id","title","start_time_seconds","end_time_seconds","created_at"],"title":"VODChapterResponse","description":"Schema for VOD chapter response","example":{"created_at":"2025-12-23T16:45:00Z","description":"Setting up the development environment","end_time_seconds":300,"id":"chapter-1111-2222-3333-4444-555566667777","is_ai_generated":false,"start_time_seconds":0,"thumbnail_url":"https://storage.ainative.studio/vod/chapters/intro.jpg","title":"Introduction and Setup","updated_at":"2025-12-23T16:45:00Z","vod_id":"vod-1111-2222-3333-4444-555566667777"}},"VODChapterUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Title","description":"Chapter title"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description","description":"Chapter description"},"start_time_seconds":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Start Time Seconds","description":"Start time in seconds"},"end_time_seconds":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}],"title":"End Time Seconds","description":"End time in seconds"},"thumbnail_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Thumbnail Url","description":"Chapter thumbnail URL"}},"type":"object","title":"VODChapterUpdate","description":"Schema for updating a VOD chapter","example":{"description":"Updated description with more details","thumbnail_url":"https://storage.ainative.studio/vod/chapters/intro_v2.jpg","title":"Introduction and Project Setup"}},"VODDetailResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id"},"stream_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Stream Id"},"post_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Post Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"file_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size Bytes"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"cloudflare_video_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cloudflare Video Id"},"playback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playback Url"},"status":{"type":"string","title":"Status"},"quality_levels":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality Levels"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"post":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Post","description":"Linked community post data"}},"type":"object","required":["id","user_id","tenant_id","stream_id","post_id","title","description","duration_seconds","file_size_bytes","thumbnail_url","cloudflare_video_id","playback_url","status","quality_levels","created_at","updated_at"],"title":"VODDetailResponse","description":"Detailed VOD response including post information\n\nIssue #951: Enhanced with post relationship","example":{"cloudflare_video_id":"abc123def456","created_at":"2025-01-22T10:30:00Z","description":"Best moments from today's stream","duration_seconds":300,"file_size_bytes":52428800,"id":"987e6543-e21b-12d3-a456-426614174000","playback_url":"https://customer-xyz.cloudflarestream.com/abc123def456/manifest/video.m3u8","post":{"comments_count":15,"id":"123e4567-e89b-12d3-a456-426614174000","loves_count":42,"moderation_status":"approved","post_type":"video","views_count":1250,"visibility":"public"},"post_id":"123e4567-e89b-12d3-a456-426614174000","quality_levels":"[\"360p\", \"720p\", \"1080p\"]","status":"ready","tenant_id":"123e4567-e89b-12d3-a456-426614174000","thumbnail_url":"https://customer-xyz.cloudflarestream.com/abc123def456/thumbnails/thumbnail.jpg","title":"My Gaming Highlight Reel","updated_at":"2025-01-22T10:35:00Z","user_id":"550e8400-e29b-41d4-a716-446655440000"}},"VODDetailsResponse":{"properties":{"id":{"type":"string","title":"Id"},"stream_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stream Id"},"user_id":{"type":"string","title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id","description":"Owning organization, or null for individual streamers"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"file_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size Bytes"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"cloudflare_video_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cloudflare Video Id"},"playback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playback Url"},"status":{"type":"string","title":"Status","description":"VOD processing status"},"quality_levels":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality Levels","description":"Available quality levels as a JSON string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"ISO-8601 creation timestamp"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At","description":"ISO-8601 update timestamp"}},"type":"object","required":["id","user_id","title","status"],"title":"VODDetailsResponse","description":"Flat VOD metadata as the endpoint serialises it.\n\nGET /streams/vods/{vod_id}\n\nDeliberately NOT `VODRecordingResponse`: ids and timestamps are strings\nhere because the handler already stringified them, whereas that schema\ntypes them as `UUID`/`datetime`. (It also used to require a non-null\n`organization_id` despite the nullable column — fixed in #8829.)\n\nStrict (no `extra`): this is a public, unauthenticated read, so no column\nbeyond this enumerated set may be added by accident."},"VODEnableResponse":{"properties":{"stream_id":{"type":"string","format":"uuid","title":"Stream Id"},"is_vod_enabled":{"type":"boolean","title":"Is Vod Enabled"},"message":{"type":"string","title":"Message"}},"type":"object","required":["stream_id","is_vod_enabled","message"],"title":"VODEnableResponse","description":"Schema for VOD enable/disable response (Issue #381)","example":{"is_vod_enabled":true,"message":"VOD recording enabled successfully","stream_id":"987e6543-e21b-12d3-a456-426614174000"}},"VODListResponse":{"properties":{"vods":{"items":{"$ref":"#/components/schemas/VODResponse"},"type":"array","title":"Vods"},"total":{"type":"integer","title":"Total","description":"Total VODs matching filters"},"page":{"type":"integer","minimum":1,"title":"Page","description":"Current page number"},"per_page":{"type":"integer","maximum":100,"minimum":1,"title":"Per Page","description":"Items per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more pages exist"}},"type":"object","required":["vods","total","page","per_page","has_more"],"title":"VODListResponse","description":"Paginated list of VODs (Issue #382)","example":{"has_more":true,"page":1,"per_page":20,"total":450,"vods":[{"duration_minutes":125,"id":"987e6543-e21b-12d3-a456-426614174000","title":"Building with FastAPI","viewer_count":1250}]}},"VODMinIOUploadRequest":{"properties":{"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"ZeroDB project id owning the MinIO bucket"},"file_key":{"type":"string","minLength":1,"title":"File Key","description":"MinIO object key of the uploaded video, e.g. videos/{vod_id}/original.mp4"},"size_bytes":{"type":"integer","minimum":0,"title":"Size Bytes","description":"Authoritative video size in bytes (from confirm-upload)"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Video title"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Video description"},"duration_seconds":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Duration Seconds","description":"Video duration in seconds"},"group_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Group Id","description":"Optional group to post in"},"visibility":{"type":"string","title":"Visibility","description":"Post visibility: public, private, friends","default":"public"},"is_nsfw":{"type":"boolean","title":"Is Nsfw","description":"Mark content as NSFW","default":false},"content_warnings":{"items":{"type":"string"},"type":"array","title":"Content Warnings","description":"Content warning tags"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Video tags"}},"type":"object","required":["project_id","file_key","size_bytes","title"],"title":"VODMinIOUploadRequest","description":"Request schema for the MinIO source-of-truth video pipeline (Refs #6329).\n\nThe client has already: (1) presigned a MinIO PUT and uploaded the video bytes,\nand (2) called /files/confirm-upload which wrote the authoritative zerodb_files\nrow (so the video COUNTS toward storage usage). This request registers the\nalready-stored object with Cloudflare Stream (copy-from-URL) for CDN playback and\ncreates the vod_recordings + community post rows."},"VODPlaybackResponse":{"properties":{"id":{"type":"string","title":"Id"},"playback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playback Url","description":"HLS/DASH playback URL (signed when auth-gated)"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"quality_levels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Quality Levels","description":"Available quality levels"}},"type":"object","required":["id"],"title":"VODPlaybackResponse","description":"Playback URL and player metadata for a ready VOD.\n\nGET /streams/vods/{vod_id}/playback\n\nSTRICT ON PURPOSE - do not add `extra=\"allow\"` here. Refs #2721:\n`vod_service.get_vod_playback_info` reads `requires_auth`,\n`cloudflare_video_id` and `status` off the row to decide access and to\nmint a signed URL, and deliberately returns NONE of them. Allowing extras\nwould let those server-side fields leak back to an unauthenticated viewer."},"VODResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryResponse"},{"type":"null"}]},"vod_url":{"type":"string","title":"Vod Url","description":"Video playback URL"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Video thumbnail URL"},"viewer_count":{"type":"integer","title":"Viewer Count","description":"Total views","default":0},"peak_viewers":{"type":"integer","title":"Peak Viewers","description":"Peak concurrent viewers during live stream","default":0},"duration_minutes":{"type":"integer","title":"Duration Minutes","description":"Video duration in minutes","default":0},"started_at":{"type":"string","format":"date-time","title":"Started At","description":"When stream started"},"ended_at":{"type":"string","format":"date-time","title":"Ended At","description":"When stream ended"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"streamer":{"$ref":"#/components/schemas/StreamerInfo"}},"type":"object","required":["id","user_id","title","vod_url","started_at","ended_at","created_at","streamer"],"title":"VODResponse","description":"Schema for VOD response (Issue #382)","example":{"category":{"id":"123e4567-e89b-12d3-a456-426614174000","name":"Web Development","slug":"web-dev","stream_count":85},"created_at":"2025-12-23T13:55:00Z","description":"Complete tutorial on building production-ready chat","duration_minutes":125,"ended_at":"2025-12-23T16:05:00Z","id":"987e6543-e21b-12d3-a456-426614174000","peak_viewers":342,"started_at":"2025-12-23T14:00:00Z","streamer":{"display_name":"John Doe","follower_count":1250,"id":"550e8400-e29b-41d4-a716-446655440000","is_verified":true,"username":"johndoe"},"thumbnail_url":"https://storage.ainative.studio/thumbnails/abc123.jpg","title":"Building a Real-time Chat App with FastAPI","user_id":"550e8400-e29b-41d4-a716-446655440000","viewer_count":1250,"vod_url":"https://vod.ainative.studio/recordings/abc123.mp4"}},"VODSearchResponse":{"properties":{"vods":{"items":{"$ref":"#/components/schemas/VODResponse"},"type":"array","title":"Vods"},"total":{"type":"integer","title":"Total","description":"Total matching VODs"},"page":{"type":"integer","minimum":1,"title":"Page","description":"Current page number"},"per_page":{"type":"integer","maximum":100,"minimum":1,"title":"Per Page","description":"Results per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results exist"},"query":{"type":"string","title":"Query","description":"Search query used"}},"type":"object","required":["vods","total","page","per_page","has_more","query"],"title":"VODSearchResponse","description":"Paginated VOD search results (Issue #382)","example":{"has_more":true,"page":1,"per_page":20,"query":"FastAPI tutorial","total":87,"vods":[{"id":"987e6543-e21b-12d3-a456-426614174000","title":"Building with FastAPI","viewer_count":1250}]}},"VODUploadRequest":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Video title"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Video description"},"cloudflare_video_id":{"type":"string","title":"Cloudflare Video Id","description":"Cloudflare Stream video ID"},"playback_url":{"type":"string","title":"Playback Url","description":"Video playback URL"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Video thumbnail URL"},"duration_seconds":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Duration Seconds","description":"Video duration in seconds"},"group_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Group Id","description":"Optional group to post in"},"visibility":{"type":"string","title":"Visibility","description":"Post visibility: public, private, friends","default":"public"},"is_nsfw":{"type":"boolean","title":"Is Nsfw","description":"Mark content as NSFW","default":false},"content_warnings":{"items":{"type":"string"},"type":"array","title":"Content Warnings","description":"Content warning tags"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Video tags"}},"type":"object","required":["title","cloudflare_video_id","playback_url"],"title":"VODUploadRequest","description":"Request schema for uploading a VOD with community post creation\n\nIssue #951: Automatically creates a VIDEO post when uploading a VOD","example":{"cloudflare_video_id":"abc123def456","content_warnings":[],"description":"Best moments from today's stream","duration_seconds":300,"group_id":"550e8400-e29b-41d4-a716-446655440000","is_nsfw":false,"playback_url":"https://customer-xyz.cloudflarestream.com/abc123def456/manifest/video.m3u8","tags":["gaming","highlights","fps"],"thumbnail_url":"https://customer-xyz.cloudflarestream.com/abc123def456/thumbnails/thumbnail.jpg","title":"My Gaming Highlight Reel","visibility":"public"}},"VODUploadResponse":{"properties":{"vod_id":{"type":"string","format":"uuid","title":"Vod Id"},"vod_status":{"type":"string","title":"Vod Status"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"playback_url":{"type":"string","title":"Playback Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"post_id":{"type":"string","format":"uuid","title":"Post Id"},"post_type":{"type":"string","title":"Post Type","default":"video"},"moderation_status":{"type":"string","title":"Moderation Status"},"visibility":{"type":"string","title":"Visibility"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id"}},"type":"object","required":["vod_id","vod_status","title","description","playback_url","thumbnail_url","duration_seconds","post_id","moderation_status","visibility","published_at","created_at","user_id","tenant_id"],"title":"VODUploadResponse","description":"Response schema after VOD upload with post creation\n\nIssue #951: Returns both VOD and post information","example":{"created_at":"2025-01-22T10:30:00Z","description":"Best moments from today's stream","duration_seconds":300,"moderation_status":"approved","playback_url":"https://customer-xyz.cloudflarestream.com/abc123def456/manifest/video.m3u8","post_id":"123e4567-e89b-12d3-a456-426614174000","post_type":"video","published_at":"2025-01-22T10:30:00Z","tenant_id":"123e4567-e89b-12d3-a456-426614174000","thumbnail_url":"https://customer-xyz.cloudflarestream.com/abc123def456/thumbnails/thumbnail.jpg","title":"My Gaming Highlight Reel","user_id":"550e8400-e29b-41d4-a716-446655440000","visibility":"public","vod_id":"987e6543-e21b-12d3-a456-426614174000","vod_status":"processing"}},"VacuumDatabaseResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"operation":{"type":"string","title":"Operation"},"started_at":{"type":"string","title":"Started At"},"completed_at":{"type":"string","title":"Completed At"},"duration_seconds":{"type":"number","title":"Duration Seconds"},"total_space_freed_mb":{"type":"number","title":"Total Space Freed Mb"},"tables_processed":{"type":"integer","title":"Tables Processed"},"tables_failed":{"type":"integer","title":"Tables Failed"},"results":{"items":{"$ref":"#/components/schemas/MaintenanceTableResult"},"type":"array","title":"Results"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","operation","started_at","completed_at","duration_seconds","total_space_freed_mb","tables_processed","tables_failed","results","message"],"title":"VacuumDatabaseResponse"},"ValidateGraphResponse":{"properties":{"conforms":{"type":"boolean","title":"Conforms"},"violation_count":{"type":"integer","title":"Violation Count"},"violations":{"items":{"$ref":"#/components/schemas/ShaclViolation"},"type":"array","title":"Violations"},"project_scoping_honored":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Project Scoping Honored","description":"False when a requested project_id did NOT narrow the entity set (the result is the caller's whole cross-project set). Absent when no project_id was requested, or once scoping is real. Refs core#9432, core#9439."},"project_scoping_warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Scoping Warning","description":"Human-readable explanation, present only alongside project_scoping_honored=False."}},"additionalProperties":true,"type":"object","required":["conforms","violation_count"],"title":"ValidateGraphResponse","description":"Response for POST /memory/v2/graph/vault-ld/validate."},"ValidateTokenResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"already_activated":{"type":"boolean","title":"Already Activated","default":false}},"type":"object","required":["valid"],"title":"ValidateTokenResponse","description":"Response for token validation"},"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"},"VaultLDImportRequest":{"properties":{"files":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Files","description":"Vault-LD file map {relative_path: text}. Mutually exclusive with schema_ttl/data_ttl."},"schema_ttl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schema Ttl","description":"Turtle for the schema layer (classes/properties)"},"data_ttl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Ttl","description":"Turtle for the instance layer"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id","description":"Project to attach the ontology to"},"base_iri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Iri","description":"Data namespace @base override"}},"type":"object","title":"VaultLDImportRequest","description":"Import a Vault-LD vault or an RDF/Turtle pair into the knowledge graph."},"VectorAnalyticsResponse":{"properties":{"total_vectors":{"type":"integer","title":"Total Vectors","description":"Total number of vectors in project/namespace"},"sampled_vectors":{"type":"integer","title":"Sampled Vectors","description":"Number of vectors analyzed for metrics"},"null_vectors":{"type":"integer","title":"Null Vectors","description":"Number of vectors without embeddings"},"namespaces":{"additionalProperties":{"type":"integer"},"type":"object","title":"Namespaces","description":"Vector count per namespace"},"dimension_stats":{"additionalProperties":true,"type":"object","title":"Dimension Stats","description":"Dimension statistics (mean, std, min, max, unique)"},"storage_metrics":{"additionalProperties":true,"type":"object","title":"Storage Metrics","description":"Storage usage metrics (bytes, MB, GB, overhead)"},"similarity_metrics":{"additionalProperties":true,"type":"object","title":"Similarity Metrics","description":"Similarity analysis (avg cosine similarity, description)"},"quality_metrics":{"additionalProperties":true,"type":"object","title":"Quality Metrics","description":"Vector quality indicators (magnitude, sparsity, variance, quality score)"},"analysis_metadata":{"additionalProperties":true,"type":"object","title":"Analysis Metadata","description":"Analysis metadata (timestamp, filters, sample size)"}},"type":"object","required":["total_vectors","sampled_vectors","null_vectors","namespaces","dimension_stats","storage_metrics","similarity_metrics","quality_metrics","analysis_metadata"],"title":"VectorAnalyticsResponse","description":"Response schema for advanced vector analytics"},"VectorClusteringRequest":{"properties":{"algorithm":{"type":"string","pattern":"^(kmeans|dbscan|hierarchical)$","title":"Algorithm","description":"Clustering algorithm: kmeans, dbscan, or hierarchical","default":"kmeans"},"n_clusters":{"anyOf":[{"type":"integer","maximum":100,"minimum":2},{"type":"null"}],"title":"N Clusters","description":"Number of clusters (for kmeans and hierarchical)","default":5},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace","description":"Optional namespace filter"},"min_samples":{"anyOf":[{"type":"integer","maximum":100,"minimum":2},{"type":"null"}],"title":"Min Samples","description":"Minimum samples per cluster (for DBSCAN)","default":5},"eps":{"anyOf":[{"type":"number","maximum":2,"minimum":0.01},{"type":"null"}],"title":"Eps","description":"Epsilon parameter for DBSCAN (distance threshold)","default":0.5},"max_vectors":{"anyOf":[{"type":"integer","maximum":100000,"minimum":10},{"type":"null"}],"title":"Max Vectors","description":"Maximum vectors to cluster (performance limit)","default":10000}},"type":"object","title":"VectorClusteringRequest","description":"Request schema for vector clustering operations"},"VectorClusteringResponse":{"properties":{"algorithm":{"type":"string","title":"Algorithm","description":"Clustering algorithm used"},"total_vectors_analyzed":{"type":"integer","title":"Total Vectors Analyzed","description":"Total vectors analyzed"},"total_clusters":{"type":"integer","title":"Total Clusters","description":"Number of clusters found"},"clusters":{"items":{"$ref":"#/components/schemas/ClusterInfo"},"type":"array","title":"Clusters","description":"Cluster information"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace","description":"Namespace filter applied"},"timestamp":{"type":"string","title":"Timestamp","description":"Analysis timestamp (ISO format)"},"inertia":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Inertia","description":"Total inertia (KMeans only)"},"iterations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Iterations","description":"Number of iterations (KMeans only)"},"noise_points":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Noise Points","description":"Number of noise points (DBSCAN only)"},"eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps","description":"Epsilon parameter used (DBSCAN only)"},"min_samples":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Samples","description":"Min samples parameter used (DBSCAN only)"},"linkage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkage","description":"Linkage method (Hierarchical only)"},"metric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric","description":"Distance metric used (Hierarchical only)"}},"type":"object","required":["algorithm","total_vectors_analyzed","total_clusters","clusters","timestamp"],"title":"VectorClusteringResponse","description":"Response schema for vector clustering operations"},"VectorCollectionsStubResponse":{"properties":{"collections":{"items":{},"type":"array","title":"Collections"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["collections","total","message"],"title":"VectorCollectionsStubResponse","description":"Response for GET /vectors/collections."},"VectorCreate":{"properties":{"namespace":{"type":"string","title":"Namespace","description":"Vector namespace","default":"default"},"vector_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Vector Metadata","description":"Vector metadata"},"document":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document","description":"Source document"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Source identifier"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"Project ID (set automatically)"},"vector_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vector Id","description":"Custom vector ID (auto-generated if not provided)"},"vector_embedding":{"items":{"type":"number"},"type":"array","title":"Vector Embedding","description":"Vector embedding array"}},"type":"object","required":["vector_embedding"],"title":"VectorCreate","description":"Schema for creating vectors"},"VectorDeleteByIdResult":{"properties":{"message":{"type":"string","title":"Message"},"vector_id":{"type":"string","title":"Vector Id"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"project_id":{"type":"string","title":"Project Id"}},"type":"object","required":["message","vector_id","project_id"],"title":"VectorDeleteByIdResult","description":"DELETE /v1/vectors/{vector_id} — shape returned by\nCachedDatabaseService.delete_vector() / DatabaseService.delete_vector().\nDistinct endpoint from DELETE /v1/vectors/ above (single-vector delete by\npath param vs. bulk delete by ids/filter in the request body)."},"VectorDeleteRequest":{"properties":{"ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ids"},"filter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"delete_all":{"type":"boolean","title":"Delete All","default":false}},"type":"object","title":"VectorDeleteRequest","description":"Request model for vector deletion","example":{"ids":["vec_123","vec_456"],"namespace":"documents"}},"VectorDeleteResult":{"properties":{"success":{"type":"boolean","title":"Success"},"deleted_count":{"type":"integer","title":"Deleted Count"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["success","deleted_count"],"title":"VectorDeleteResult","description":"DELETE /v1/vectors/ — shape returned by\nPgVectorProvider.delete_embeddings()."},"VectorIndexRequest":{"properties":{"namespace":{"type":"string","title":"Namespace","description":"Namespace to index","example":"default"},"index_type":{"type":"string","title":"Index Type","description":"Type of index (ivf, hnsw, flat)","example":"hnsw"}},"type":"object","required":["namespace","index_type"],"title":"VectorIndexRequest","description":"Request schema for creating vector index"},"VectorIndexResponse":{"properties":{"index_name":{"type":"string","title":"Index Name","description":"Index name"},"index_type":{"type":"string","title":"Index Type","description":"Index type (ivf, hnsw, flat)"},"namespace":{"type":"string","title":"Namespace","description":"Vector namespace"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Index creation timestamp"},"status":{"type":"string","title":"Status","description":"Index status (created, building, ready)"}},"type":"object","required":["index_name","index_type","namespace","created_at","status"],"title":"VectorIndexResponse","description":"Vector index creation response schema"},"VectorItem":{"properties":{"id":{"type":"string","title":"Id"},"vector":{"items":{"type":"number"},"type":"array","title":"Vector"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["id","vector"],"title":"VectorItem","description":"Vector item model for compatibility","example":{"id":"vec_123","metadata":{"source":"doc1"},"vector":[0.1,0.2,0.3]}},"VectorListItem":{"properties":{"id":{"type":"string","title":"Id"},"namespace":{"type":"string","title":"Namespace"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","namespace","metadata","created_at"],"title":"VectorListItem"},"VectorNamespaceInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"vector_count":{"type":"integer","title":"Vector Count"},"memory_count":{"type":"integer","title":"Memory Count"}},"type":"object","required":["id","name","vector_count","memory_count"],"title":"VectorNamespaceInfo"},"VectorResponse":{"properties":{"namespace":{"type":"string","title":"Namespace","description":"Vector namespace","default":"default"},"vector_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Vector Metadata","description":"Vector metadata"},"document":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document","description":"Source document"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"Source identifier"},"vector_id":{"type":"string","title":"Vector Id","description":"Unique identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Unique identifier"},"vector_embedding":{"items":{"type":"number"},"type":"array","title":"Vector Embedding","description":"List of items"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"},"similarity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Similarity","description":"Cosine similarity to the query vector (search results only; absent on plain reads)"}},"type":"object","required":["vector_id","project_id","created_at"],"title":"VectorResponse","description":"Complete vector response schema"},"VectorStatsResponse":{"properties":{"total_count":{"type":"integer","title":"Total Count","description":"Total number of vectors"},"namespaces":{"additionalProperties":{"type":"integer"},"type":"object","title":"Namespaces","description":"Count per namespace"},"avg_dimensions":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Dimensions","description":"Average vector dimensions"},"total_storage_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Storage Bytes","description":"Total storage in bytes"}},"type":"object","required":["total_count","namespaces"],"title":"VectorStatsResponse","description":"Vector statistics response schema"},"VectorUpsertRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/VectorItem"},"type":"array","title":"Items","description":"List of vector items to upsert"},"namespace":{"type":"string","title":"Namespace","description":"Vector namespace","default":"default"}},"type":"object","required":["items"],"title":"VectorUpsertRequest","description":"Request model for vector upsert operations","example":{"items":[{"id":"vec_123","metadata":{"source":"document"},"vector":[0.1,0.2,0.3]}],"namespace":"documents"}},"VectorUpsertResult":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"upserted_count":{"type":"integer","title":"Upserted Count"},"failed_items":{"items":{},"type":"array","title":"Failed Items"}},"type":"object","required":["success","message","upserted_count"],"title":"VectorUpsertResult","description":"POST /v1/vectors/search returns List[VectorSearchResult] (existing\nschema, reused directly). This models the dict shape returned by\nPgVectorProvider.upsert_embeddings(), used by both POST /v1/vectors/upsert\nand PUT /v1/vectors/."},"VendorCreate":{"properties":{"name":{"type":"string","minLength":1,"title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method"},"payment_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Description"},"federal_tax_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Federal Tax Classification"},"total_paid":{"type":"number","title":"Total Paid","default":0}},"type":"object","required":["name"],"title":"VendorCreate"},"VendorCreateResponse":{"properties":{"vendor":{"$ref":"#/components/schemas/VendorResponse"},"toast_message":{"type":"string","title":"Toast Message"}},"type":"object","required":["vendor","toast_message"],"title":"VendorCreateResponse"},"VendorListResponse":{"properties":{"vendors":{"items":{"$ref":"#/components/schemas/VendorResponse"},"type":"array","title":"Vendors"},"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"}},"type":"object","required":["vendors","counts"],"title":"VendorListResponse"},"VendorResponse":{"properties":{"id":{"type":"string","title":"Id"},"organization_id":{"type":"string","title":"Organization Id"},"name":{"type":"string","title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method"},"payment_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Description"},"total_paid":{"type":"number","title":"Total Paid","default":0},"federal_tax_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Federal Tax Classification"},"status":{"type":"string","title":"Status"},"ready_to_file":{"type":"boolean","title":"Ready To File"},"w9_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"W9 Status"},"w9_document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"W9 Document Id"}},"type":"object","required":["id","organization_id","name","status","ready_to_file"],"title":"VendorResponse"},"VendorUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method"},"payment_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Description"},"federal_tax_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Federal Tax Classification"},"total_paid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Paid"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","title":"VendorUpdate"},"VerificationEmailRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email","description":"Recipient email address"},"verification_token":{"type":"string","minLength":10,"title":"Verification Token","description":"Email verification token"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"User's full name (optional)"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Callback Url","description":"Custom callback URL (optional)"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id","description":"Organization UUID for branding (optional)"}},"type":"object","required":["email","verification_token"],"title":"VerificationEmailRequest","description":"Request model for email verification","example":{"callback_url":"https://myapp.com/verify","email":"user@example.com","name":"John Doe","organization_id":"550e8400-e29b-41d4-a716-446655440000","verification_token":"verify123abc"}},"VerifyAgentTablesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"agent_tables_exist":{"type":"boolean","title":"Agent Tables Exist"},"existing_tables":{"items":{"type":"string"},"type":"array","title":"Existing Tables"},"table_counts":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"object","title":"Table Counts"},"verified_by":{"type":"string","title":"Verified By"}},"type":"object","required":["success","agent_tables_exist","existing_tables","table_counts","verified_by"],"title":"VerifyAgentTablesResponse","description":"Response for GET /admin/migrations/verify-agent-tables.\n\n``table_counts`` maps table_name -> row count (int) on success, or\ntable_name -> \"Error: \" (str) if the per-table COUNT query\nitself failed — kept as a union to preserve both real shapes."},"VerifyEmailResponse":{"properties":{"message":{"type":"string","title":"Message"},"access_token":{"type":"string","title":"Access Token"}},"additionalProperties":true,"type":"object","required":["message","access_token"],"title":"VerifyEmailResponse","description":"POST /auth/verify-email\n\nIncludes an auto-login ``access_token`` so the frontend can skip the\nlogin page after verifying (Refs #1660) — this is existing behavior the\nhandler already returns today, not a new field added by this schema."},"VerifyRequest":{"properties":{"kind":{"type":"string","title":"Kind","description":"One of: zerodb | mcp_schema | routing | handoff"},"task":{"additionalProperties":true,"type":"object","title":"Task","description":"Task context / injected checks"},"output":{"title":"Output","description":"Candidate model output to verify"}},"type":"object","required":["kind","output"],"title":"VerifyRequest"},"VerifyResponse":{"properties":{"passed":{"type":"boolean","title":"Passed"},"diagnostic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Diagnostic"},"kind":{"type":"string","title":"Kind"}},"type":"object","required":["passed","kind"],"title":"VerifyResponse"},"VerifyToolRequest":{"properties":{"server_name":{"type":"string","title":"Server Name"},"tool":{"$ref":"#/components/schemas/ToolDefinition"}},"type":"object","required":["server_name","tool"],"title":"VerifyToolRequest"},"VerifyToolResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"tool_name":{"type":"string","title":"Tool Name"},"expected_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Hash"},"actual_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actual Hash"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["valid","tool_name","reason"],"title":"VerifyToolResponse"},"VersionManagementInfo":{"properties":{"service":{"type":"string","title":"Service"},"description":{"type":"string","title":"Description"},"version":{"type":"string","title":"Version"},"endpoints":{"additionalProperties":{"type":"string"},"type":"object","title":"Endpoints"}},"type":"object","required":["service","description","version","endpoints"],"title":"VersionManagementInfo","description":"Return shape of GET /version/ (service metadata, not a real model version)."},"VersionMetricsResponse":{"properties":{"version_id":{"type":"string","title":"Version Id"},"version_number":{"type":"string","title":"Version Number"},"status":{"type":"string","title":"Status"},"test_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Test Results"},"performance_metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Performance Metrics"},"deployment_history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Deployment History"},"usage_stats":{"$ref":"#/components/schemas/VersionUsageStats"}},"type":"object","required":["version_id","version_number","status","deployment_history","usage_stats"],"title":"VersionMetricsResponse"},"VersionResponse":{"properties":{"version":{"type":"string","title":"Version"},"api_version":{"type":"string","title":"Api Version"},"service":{"type":"string","title":"Service"},"build":{"type":"string","title":"Build"},"timestamp":{"type":"string","title":"Timestamp"},"compatibility_note":{"type":"string","title":"Compatibility Note"}},"type":"object","required":["version","api_version","service","build","timestamp","compatibility_note"],"title":"VersionResponse"},"VersionUsageStats":{"properties":{"total_requests":{"type":"integer","title":"Total Requests"},"success_rate":{"type":"number","title":"Success Rate"},"average_latency":{"type":"number","title":"Average Latency"},"error_rate":{"type":"number","title":"Error Rate"}},"type":"object","required":["total_requests","success_rate","average_latency","error_rate"],"title":"VersionUsageStats"},"VideoAnalyticsEventType":{"type":"string","enum":["view","play","pause","seek","complete","like","share","comment","buffer","error"],"title":"VideoAnalyticsEventType","description":"Video analytics event types for tracking"},"VideoCategoriesResponse":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/VideoCategoryEntry"},"type":"array","title":"Categories","description":"Video content categories"},"vod":{"$ref":"#/components/schemas/VideoEndpointRef","description":"Video-on-demand upload surface"},"showcase":{"$ref":"#/components/schemas/VideoEndpointRef","description":"Showcase video gallery surface"}},"type":"object","required":["categories","vod","showcase"],"title":"VideoCategoriesResponse","description":"Root discovery document for the video content surfaces (Refs #8449).\n\nEvery field is unconditionally present — this handler returns a hardcoded\nliteral with no request-, permission- or branch-dependent keys — so no\n`response_model_exclude_unset` is needed or wanted here."},"VideoCategoryEntry":{"properties":{"type":{"type":"string","title":"Type","description":"Category identifier, e.g. 'tutorials'"},"endpoint":{"type":"string","title":"Endpoint","description":"Absolute path serving this category"},"description":{"type":"string","title":"Description","description":"Human-readable category description"}},"type":"object","required":["type","endpoint","description"],"title":"VideoCategoryEntry","description":"One entry in the root listing's `categories` array."},"VideoCreate":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Video title"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Video description"},"video_type":{"$ref":"#/components/schemas/VideoType","description":"Type of video content"},"duration":{"type":"integer","exclusiveMinimum":0,"title":"Duration","description":"Video duration in seconds"},"video_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Video Metadata","description":"Additional metadata"},"video_url":{"type":"string","title":"Video Url","description":"MinIO storage path for video"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"MinIO storage path for thumbnail"},"tech_stack":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tech Stack","description":"Technology stack for showcase videos"},"project_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Project Url","description":"Project URL"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Tags for categorization"}},"type":"object","required":["title","video_type","duration","video_url"],"title":"VideoCreate","description":"Video creation request"},"VideoCreativeResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Creative ID"},"sponsor_id":{"type":"string","title":"Sponsor Id","description":"Sponsor ID"},"type":{"$ref":"#/components/schemas/CreativeType","description":"Creative type","default":"video"},"status":{"$ref":"#/components/schemas/CreativeStatus","description":"Approval status"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"call_to_action":{"type":"string","title":"Call To Action"},"destination_url":{"type":"string","title":"Destination Url"},"original_video_url":{"type":"string","title":"Original Video Url","description":"R2 URL of original video"},"transcoded_urls":{"additionalProperties":{"type":"string"},"type":"object","title":"Transcoded Urls","description":"Transcoded video URLs by resolution"},"thumbnail_url":{"type":"string","title":"Thumbnail Url","description":"Thumbnail image URL"},"duration_seconds":{"type":"integer","title":"Duration Seconds","description":"Video duration"},"video_format":{"type":"string","title":"Video Format","description":"Video format (mp4, mov, webm)"},"video_codec":{"type":"string","title":"Video Codec","description":"Video codec"},"vast_xml_url":{"type":"string","title":"Vast Xml Url","description":"VAST XML endpoint URL"},"vast_tracking_urls":{"additionalProperties":{"type":"string"},"type":"object","title":"Vast Tracking Urls","description":"Tracking URLs for impressions/clicks"},"reviewed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed By"},"reviewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reviewed At"},"rejection_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rejection Reason"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","sponsor_id","status","title","call_to_action","destination_url","original_video_url","transcoded_urls","thumbnail_url","duration_seconds","video_format","video_codec","vast_xml_url","vast_tracking_urls","created_at"],"title":"VideoCreativeResponse","description":"Schema for video creative response","example":{"call_to_action":"Register Now","created_at":"2026-01-05T10:00:00Z","description":"Join us at PAI Palooza 2026","destination_url":"https://paipalooza.com/register","duration_seconds":30,"id":"creative_abc123","original_video_url":"https://r2.ainative.studio/ad-creatives/sponsors/sponsor_xyz789/videos/original_abc123.mp4","sponsor_id":"sponsor_xyz789","status":"pending_review","thumbnail_url":"https://r2.ainative.studio/ad-creatives/sponsors/sponsor_xyz789/videos/thumb_abc123.jpg","title":"AI Conference 2026 Promo","transcoded_urls":{"1080p":"https://r2.ainative.studio/ad-creatives/sponsors/sponsor_xyz789/videos/1080p_abc123.mp4","720p":"https://r2.ainative.studio/ad-creatives/sponsors/sponsor_xyz789/videos/720p_abc123.mp4"},"type":"video","vast_tracking_urls":{"click":"https://api.ainative.studio/v1/paipalooza/tracking/creative_abc123/click","complete":"https://api.ainative.studio/v1/paipalooza/tracking/creative_abc123/complete","impression":"https://api.ainative.studio/v1/paipalooza/tracking/creative_abc123/impression"},"vast_xml_url":"https://api.ainative.studio/v1/paipalooza/ad-creatives/creative_abc123/vast.xml","video_codec":"h264","video_format":"mp4"}},"VideoEndpointRef":{"properties":{"endpoint":{"type":"string","title":"Endpoint","description":"Absolute path of the surface"},"description":{"type":"string","title":"Description","description":"Human-readable description"}},"type":"object","required":["endpoint","description"],"title":"VideoEndpointRef","description":"An endpoint + description pair for a non-category video surface."},"VideoGenerateRequest":{"properties":{"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt","description":"Text prompt for video generation"},"model":{"type":"string","title":"Model","description":"Image-to-video (requires image_url): wan22, seedance, sora2. Standalone: cogvideox. Text-to-video (no image_url): only wan-2-6-t2v is real; 'runway' is cataloged but not currently available (no live backend, Refs core#9609) -- do not pass it for a text-only request.","default":"wan22"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","description":"Source image URL for image-to-video (i2v)"},"duration":{"anyOf":[{"type":"integer","maximum":30,"minimum":1},{"type":"null"}],"title":"Duration","description":"Duration in seconds (text-to-video)"},"num_frames":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Frames","description":"Frame count for CogVideoX (17, 33, or 49)"},"guidance_scale":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Guidance Scale","description":"Guidance scale for CogVideoX"},"num_inference_steps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Inference Steps","description":"Inference steps for CogVideoX"}},"type":"object","required":["prompt"],"title":"VideoGenerateRequest","description":"Request schema for video generation"},"VideoI2VRequest":{"properties":{"image_url":{"type":"string","title":"Image Url","description":"Source image URL (must be publicly accessible)"},"motion_prompt":{"type":"string","maxLength":1000,"minLength":1,"title":"Motion Prompt","description":"Description of desired motion"},"provider":{"type":"string","title":"Provider","description":"Provider: 'wan22' (default, recommended), 'seedance', or 'sora2'","default":"wan22"}},"type":"object","required":["image_url","motion_prompt"],"title":"VideoI2VRequest","description":"Request schema for image-to-video generation","example":{"image_url":"https://example.com/image.jpg","motion_prompt":"Camera slowly zooms in while the character turns their head","provider":"wan22"}},"VideoListResponse":{"properties":{"videos":{"items":{"$ref":"#/components/schemas/app__api__videos__VideoResponse"},"type":"array","title":"Videos"},"total":{"type":"integer","title":"Total"},"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["videos","total","offset","limit"],"title":"VideoListResponse","description":"Paginated video list response"},"VideoRecommendationResponse":{"properties":{"video_id":{"type":"string","format":"uuid","title":"Video Id"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"duration":{"type":"integer","title":"Duration"},"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"Similarity score (0-1)"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons","description":"Why this was recommended"},"difficulty_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Difficulty Level"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"}},"type":"object","required":["video_id","title","duration","score"],"title":"VideoRecommendationResponse","description":"Single video recommendation response"},"VideoSessionDeleteResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable confirmation"}},"type":"object","required":["message"],"title":"VideoSessionDeleteResponse","description":"Confirmation body for DELETE /api/v1/sessions/{session_id}.\n\nRefs #8449. Exactly one field, matching VideoService.delete_session's\ndeclared `-> Dict[str, str]` return of `{\"message\": ...}`. Deliberately\ninvents no `deleted`/`session_id` keys the route has never sent, and the\nfield is unconditional on the 200 path so no\n`response_model_exclude_unset` is needed.","example":{"message":"Session deleted successfully"}},"VideoStatsResponse":{"properties":{"video_id":{"type":"string","format":"uuid","title":"Video Id"},"date":{"type":"string","format":"date","title":"Date"},"views":{"type":"integer","title":"Views"},"unique_views":{"type":"integer","title":"Unique Views"},"unique_users":{"type":"integer","title":"Unique Users"},"total_watch_time":{"type":"number","title":"Total Watch Time"},"avg_watch_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Watch Time"},"completions":{"type":"integer","title":"Completions"},"completion_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Completion Rate"},"likes":{"type":"integer","title":"Likes"},"shares":{"type":"integer","title":"Shares"},"comments":{"type":"integer","title":"Comments"},"engagement_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Engagement Rate"},"quality_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quality Score"}},"type":"object","required":["video_id","date","views","unique_views","unique_users","total_watch_time","avg_watch_time","completions","completion_rate","likes","shares","comments","engagement_rate","quality_score"],"title":"VideoStatsResponse","description":"Video statistics response"},"VideoStatus":{"type":"string","enum":["draft","processing","ready","error"],"title":"VideoStatus","description":"Video processing status"},"VideoStatusResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Job status. RunPod: completed|failed|processing|unknown. MiniMax: the provider's own value, e.g. Success|Processing."},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id","description":"RunPod job ID (RunPod branches only)"},"output":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output","description":"RunPod verbatim job output (completed branch only)"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"RunPod failure reason (failed branch only)"},"raw_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Status","description":"Unrecognized upstream status, passed through verbatim"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id","description":"MiniMax task ID (MiniMax branches only)"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url","description":"Resolved video download URL (MiniMax Success branch only)"},"file_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Id","description":"MiniMax file ID (MiniMax Success branch only)"}},"type":"object","required":["status"],"title":"VideoStatusResponse","description":"Response schema for GET /multimodal/video/status/{task_id}.\n\nThis route is a thin dispatcher over TWO upstream services and returns each\none's dict verbatim, so the model is the UNION of six real branches. Derived\nfrom the service code, not inferred from the handler:\n\n``app/services/runpod_service.py::get_job_status`` (task_id starts \"runpod:\")\n - COMPLETED -> status, output, job_id\n - FAILED -> status, error, job_id\n - IN_QUEUE/IN_PROGRESS -> status, job_id\n - any other status -> status, raw_status, job_id\n\n``app/services/minimax_video_service.py::get_video_status`` (any other id)\n - Success (+ file_id) -> status, task_id, video_url, file_id\n - any other status -> status, task_id\n\n``status`` is the ONLY key present in all six, so it is the only required\nfield. The route MUST therefore be declared with\n``response_model_exclude_unset=True``: without it, a RunPod \"processing\"\npoll — two real keys, and the most frequently hit branch — would be padded\nout to seven keys with five invented nulls, and a MiniMax poll would grow a\nphantom ``job_id: null``. Pinned by\n``tests/api/test_multimodal_response_models_8449.py``.\n\n``output`` stays ``Dict[str, Any]`` deliberately: it is RunPod's verbatim\njob payload, the same opaque-passthrough case as the JSON-RPC/SSE bodies in\n#8776/#8814. Narrowing it would silently truncate completed jobs whenever\nthe provider adds a field."},"VideoT2VRequest":{"properties":{"prompt":{"type":"string","maxLength":1000,"minLength":1,"title":"Prompt","description":"Video generation prompt"},"duration":{"type":"integer","maximum":10,"minimum":1,"title":"Duration","description":"Video duration in seconds","default":5}},"type":"object","required":["prompt"],"title":"VideoT2VRequest","description":"Request schema for text-to-video generation","example":{"duration":5,"prompt":"A serene ocean wave crashing on a beach at golden hour"}},"VideoType":{"type":"string","enum":["tutorial","webinar","demo"],"title":"VideoType","description":"Video content types"},"ViewResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"is_default":{"type":"boolean","title":"Is Default","default":false},"layout_json":{"additionalProperties":true,"type":"object","title":"Layout Json"},"filters_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters Json"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","title":"ViewResponse","description":"Matches smb-dash's saved-view shape (issue #41)."},"ViewerGrowthResponse":{"properties":{"timeline":{"items":{"$ref":"#/components/schemas/GrowthTimelinePoint"},"type":"array","title":"Timeline","description":"Daily viewer growth data"},"period_days":{"type":"integer","minimum":1,"title":"Period Days","description":"Time period in days"},"total_views":{"type":"integer","minimum":0,"title":"Total Views","description":"Total views in period"},"total_unique_viewers":{"type":"integer","minimum":0,"title":"Total Unique Viewers","description":"Total unique viewers in period"}},"type":"object","required":["timeline","period_days","total_views","total_unique_viewers"],"title":"ViewerGrowthResponse","description":"Viewer growth over time","example":{"period_days":30,"timeline":[{"avg_peak_viewers":45.8,"date":"2025-12-01","total_views":342,"unique_viewers":187}],"total_unique_viewers":1250,"total_views":8532}},"ViewerTimelinePoint":{"properties":{"timestamp":{"type":"string","title":"Timestamp","description":"ISO 8601 timestamp"},"viewer_count":{"type":"integer","minimum":0,"title":"Viewer Count","description":"Concurrent viewers at this time"}},"type":"object","required":["timestamp","viewer_count"],"title":"ViewerTimelinePoint","description":"Single data point in viewer timeline","example":{"timestamp":"2025-12-23T14:05:00Z","viewer_count":87}},"ViewerTimelineResponse":{"properties":{"stream_id":{"type":"string","format":"uuid","title":"Stream Id"},"timeline":{"items":{"$ref":"#/components/schemas/ViewerTimelinePoint"},"type":"array","title":"Timeline"},"interval_minutes":{"type":"integer","minimum":1,"title":"Interval Minutes","description":"Sampling interval in minutes"}},"type":"object","required":["stream_id","timeline","interval_minutes"],"title":"ViewerTimelineResponse","description":"Viewer count timeline for a stream","example":{"interval_minutes":5,"stream_id":"987e6543-e21b-12d3-a456-426614174000","timeline":[{"timestamp":"2025-12-23T14:00:00Z","viewer_count":45},{"timestamp":"2025-12-23T14:05:00Z","viewer_count":87},{"timestamp":"2025-12-23T14:10:00Z","viewer_count":112}]}},"ViewerTypeBreakdown":{"properties":{"authenticated_views":{"type":"integer","minimum":0,"title":"Authenticated Views","description":"Total authenticated viewer sessions"},"anonymous_views":{"type":"integer","minimum":0,"title":"Anonymous Views","description":"Total anonymous viewer sessions"},"unique_authenticated_users":{"type":"integer","minimum":0,"title":"Unique Authenticated Users","description":"Unique authenticated users"},"unique_anonymous_sessions":{"type":"integer","minimum":0,"title":"Unique Anonymous Sessions","description":"Unique anonymous sessions"}},"type":"object","required":["authenticated_views","anonymous_views","unique_authenticated_users","unique_anonymous_sessions"],"title":"ViewerTypeBreakdown","description":"Breakdown of authenticated vs anonymous viewers","example":{"anonymous_views":3210,"authenticated_views":5432,"unique_anonymous_sessions":1543,"unique_authenticated_users":892}},"VisitorTypingRequest":{"properties":{"is_typing":{"type":"boolean","title":"Is Typing","default":true}},"type":"object","title":"VisitorTypingRequest"},"VisualizationRequest":{"properties":{"measurements":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Measurements","description":"Quantum circuit measurement results","example":[{"bitstring":[0,1,1,0]},{"bitstring":[1,0,0,1]}]}},"type":"object","required":["measurements"],"title":"VisualizationRequest","description":"Schema for quantum result visualization request.\n\nFollows SCSS V2.0 principles of clear, type-safe data modeling."},"VisualizationResponse":{"properties":{"visualizations":{"additionalProperties":{"type":"string"},"type":"object","title":"Visualizations","description":"Dictionary of visualization types and base64 encoded images"},"status":{"type":"string","title":"Status","description":"Status of visualization generation","default":"completed"}},"type":"object","required":["visualizations"],"title":"VisualizationResponse","description":"Schema for quantum result visualization response.\n\nProvides base64 encoded visualization images."},"WalletBalanceResponse":{"properties":{"wallet_id":{"type":"string","format":"uuid","title":"Wallet Id"},"balance_usd":{"type":"string","title":"Balance Usd"},"currency":{"type":"string","title":"Currency","default":"USD"},"last_updated":{"type":"string","format":"date-time","title":"Last Updated"}},"type":"object","required":["wallet_id","balance_usd","last_updated"],"title":"WalletBalanceResponse","description":"Schema for wallet balance response"},"WalletCreateRequest":{"properties":{},"type":"object","title":"WalletCreateRequest","description":"Schema for creating a Sila wallet"},"WarnUserRequest":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"UUID of user to warn"},"reason":{"type":"string","maxLength":500,"title":"Reason","description":"Reason for warning"},"severity":{"type":"string","title":"Severity","description":"Warning severity (LOW, MEDIUM, HIGH)","default":"MEDIUM"},"notify_user":{"type":"boolean","title":"Notify User","description":"Whether to send notification to user","default":true}},"type":"object","required":["user_id","reason"],"title":"WarnUserRequest","description":"Request schema for warning a user"},"WebCredentialCreateRequest":{"properties":{"domain":{"type":"string","maxLength":500,"minLength":1,"title":"Domain"},"credential_type":{"type":"string","title":"Credential Type","description":"One of password, oauth, api_key, totp"},"username":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Username"},"password":{"anyOf":[{"type":"string","maxLength":4096,"minLength":1},{"type":"null"}],"title":"Password"},"token":{"anyOf":[{"type":"string","maxLength":8192,"minLength":1},{"type":"null"}],"title":"Token"},"agent_registration_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Registration Id","description":"Optional explicit browser agent registration ID owned by the current user."}},"type":"object","required":["domain","credential_type"],"title":"WebCredentialCreateRequest","description":"Request body for storing an encrypted web credential."},"WebCredentialResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"domain":{"type":"string","title":"Domain"},"credential_type":{"type":"string","title":"Credential Type"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","domain","credential_type","created_at"],"title":"WebCredentialResponse","description":"Credential metadata returned after create operations."},"WebHistoryItemResponse":{"properties":{"url":{"type":"string","title":"Url"},"status":{"type":"string","title":"Status"},"steps_taken":{"type":"integer","title":"Steps Taken"},"credits_used":{"type":"integer","title":"Credits Used"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"screenshot_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Screenshot Url"}},"type":"object","required":["url","status","steps_taken","credits_used","created_at"],"title":"WebHistoryItemResponse","description":"Single browser history record."},"WebHistoryPageResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/WebHistoryItemResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","total","page","page_size","has_more"],"title":"WebHistoryPageResponse","description":"Paginated browser history response."},"WebSocketMetricsData":{"properties":{"active_connections":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Connections","description":"Currently open WebSocket connections"},"total_connections":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Connections","description":"Cumulative connections opened"},"messages_sent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Messages Sent","description":"Messages sent to clients"},"messages_received":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Messages Received","description":"Messages received from clients"},"bytes_sent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bytes Sent","description":"Bytes sent"},"bytes_received":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bytes Received","description":"Bytes received"},"connection_errors":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Connection Errors","description":"Connection error count"},"avg_connection_duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Connection Duration","description":"Mean connection lifetime (seconds)"},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp","description":"Collection timestamp"}},"additionalProperties":true,"type":"object","title":"WebSocketMetricsData","description":"Mirror of mcp_proxy_metrics_service.WebSocketMetrics."},"WebSocketMetricsEnvelope":{"properties":{"websocket_metrics":{"$ref":"#/components/schemas/WebSocketMetricsData","description":"WebSocket metrics"},"collection_time":{"type":"string","title":"Collection Time","description":"ISO timestamp of collection"}},"additionalProperties":true,"type":"object","required":["websocket_metrics","collection_time"],"title":"WebSocketMetricsEnvelope","description":"`data` block of the WebSocket metrics route."},"WebSocketMetricsResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always true on a 200"},"data":{"$ref":"#/components/schemas/WebSocketMetricsEnvelope","description":"WebSocket metrics payload"}},"additionalProperties":true,"type":"object","required":["success","data"],"title":"WebSocketMetricsResponse","description":"GET /api/v1/mcp/proxy/metrics/websocket"},"WebhookCreate":{"properties":{"name":{"type":"string","title":"Name"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events","default":["push"]},"is_active":{"type":"boolean","title":"Is Active","default":true},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":""}},"type":"object","required":["name","url"],"title":"WebhookCreate"},"WebhookDeletedResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"WebhookDeletedResponse","description":"Return shape of DELETE /{webhook_id} as this handler actually serves it.\n\nThis handler wins the route (it is registered before webhook_registration's\nsame-path handler), but the published OpenAPI documents the OTHER module's\n`DeleteWebhookResponse` ({webhook_id, status}) for this path, because\nOpenAPI generation keeps the last duplicate while routing keeps the first.\nThe single `message` key below is what callers really receive.\n\nThe spec-vs-runtime divergence is tracked separately in #8865; attaching a\nresponse_model here fixes the runtime contract but cannot fix the published\nspec while the duplicate mount stands. Refs #8449."},"WebhookDeliveriesResponse":{"properties":{"deliveries":{"items":{"$ref":"#/components/schemas/WebhookDeliveryRecord"},"type":"array","title":"Deliveries"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["deliveries","total"],"title":"WebhookDeliveriesResponse"},"WebhookDeliveryRecord":{"properties":{"id":{"type":"string","title":"Id"},"webhook_id":{"type":"string","title":"Webhook Id"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","title":"Status"},"http_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Http Status"},"attempt_number":{"type":"integer","title":"Attempt Number"},"delivered_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivered At"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["id","webhook_id","event_type","status","attempt_number"],"title":"WebhookDeliveryRecord"},"WebhookHandledResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable confirmation message"},"status":{"type":"string","title":"Status","description":"Processing status, e.g. 'processed'"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO timestamp the webhook was received"}},"type":"object","required":["message","status","timestamp"],"title":"WebhookHandledResponse","description":"Fixed acknowledgement returned by the generic inbound webhook handler."},"WebhookProcessedResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Id"}},"type":"object","required":["success","message"],"title":"WebhookProcessedResponse"},"WebhookTestPayload":{"properties":{"event":{"type":"string","title":"Event"},"timestamp":{"type":"string","title":"Timestamp"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["event","timestamp","data"],"title":"WebhookTestPayload","description":"The echoed sample payload nested under `test_payload`."},"WebhookTestSentResponse":{"properties":{"message":{"type":"string","title":"Message"},"webhook_id":{"type":"string","title":"Webhook Id"},"event_id":{"type":"string","title":"Event Id"},"target_url":{"type":"string","title":"Target Url"},"test_payload":{"$ref":"#/components/schemas/WebhookTestPayload"}},"type":"object","required":["message","webhook_id","event_id","target_url","test_payload"],"title":"WebhookTestSentResponse","description":"Return shape of POST /{webhook_id}/test. Same duplicate-mount caveat as\nWebhookDeletedResponse above (#8865). Refs #8449."},"WebhookUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Url"},"events":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Events"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","title":"WebhookUpdate"},"WebinarCreate":{"properties":{"scheduled_at":{"type":"string","format":"date-time","title":"Scheduled At","description":"Scheduled date/time"},"presenter_name":{"type":"string","maxLength":200,"minLength":1,"title":"Presenter Name","description":"Presenter name"},"presenter_bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Presenter Bio","description":"Presenter biography"},"max_attendees":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}],"title":"Max Attendees","description":"Max attendees (null = unlimited)"},"registration_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Registration Url"},"meeting_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Meeting Url"}},"type":"object","required":["scheduled_at","presenter_name"],"title":"WebinarCreate","description":"Webinar creation request (extends VideoCreate)"},"WebinarRegistrationResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable confirmation message"},"webinar_id":{"type":"string","title":"Webinar Id","description":"The webinar that was registered for"},"registration_count":{"type":"integer","title":"Registration Count","description":"Registration count AFTER this registration was applied"}},"type":"object","required":["message","webinar_id","registration_count"],"title":"WebinarRegistrationResponse","description":"Confirmation body for a successful webinar registration (Refs #8449).\n\n`webinar_id` is deliberately a `str`, NOT a `UUID`: the handler emits\n`str(webinar_id)` itself, and declaring `UUID` here would hand FastAPI the\njob of re-serializing it, which risks changing the emitted form for\nexisting clients. All three fields are unconditional on the 200 path."},"WebinarWithVideoResponse":{"properties":{"scheduled_at":{"type":"string","format":"date-time","title":"Scheduled At","description":"Scheduled date/time"},"presenter_name":{"type":"string","maxLength":200,"minLength":1,"title":"Presenter Name","description":"Presenter name"},"presenter_bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Presenter Bio","description":"Presenter biography"},"max_attendees":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}],"title":"Max Attendees","description":"Max attendees (null = unlimited)"},"registration_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Registration Url"},"meeting_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Meeting Url"},"webinar_id":{"type":"string","format":"uuid","title":"Webinar Id"},"video_id":{"type":"string","format":"uuid","title":"Video Id"},"registration_count":{"type":"integer","title":"Registration Count"},"is_live":{"type":"boolean","title":"Is Live"},"is_completed":{"type":"boolean","title":"Is Completed"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"video":{"$ref":"#/components/schemas/app__api__videos__VideoResponse"}},"type":"object","required":["scheduled_at","presenter_name","webinar_id","video_id","registration_count","is_live","is_completed","created_at","updated_at","video"],"title":"WebinarWithVideoResponse","description":"Webinar with full video details"},"WeeklyActivityDay":{"properties":{"day":{"type":"string","title":"Day"},"count":{"type":"integer","title":"Count","default":0}},"type":"object","required":["day"],"title":"WeeklyActivityDay","description":"One entry of GET /profile/stats's weekly_activity list"},"WeeklyBackupSchedule":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"day":{"type":"string","title":"Day"},"time":{"type":"string","title":"Time"},"last_run":{"type":"string","title":"Last Run"}},"type":"object","required":["enabled","day","time","last_run"],"title":"WeeklyBackupSchedule"},"WeeklyScheduleResponse":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"username":{"type":"string","title":"Username"},"schedule":{"items":{"$ref":"#/components/schemas/DaySchedule"},"type":"array","title":"Schedule","description":"Schedule grouped by day (Monday=0 to Sunday=6)"},"total_entries":{"type":"integer","title":"Total Entries","description":"Total number of schedule entries"}},"type":"object","required":["user_id","username","schedule","total_entries"],"title":"WeeklyScheduleResponse","description":"Full week schedule grouped by day","example":{"schedule":[{"day_name":"Tuesday","day_of_week":1,"schedules":[{"end_time":"20:00","id":"sched-1111-2222-3333-4444-555566667777","start_time":"18:00","title":"Evening Stream"}]},{"day_name":"Friday","day_of_week":4,"schedules":[{"end_time":"23:00","id":"sched-2222-3333-4444-5555-666677778888","start_time":"20:00","title":"Friday Night Stream"}]}],"total_entries":2,"user_id":"550e8400-e29b-41d4-a716-446655440000","username":"johndoe"}},"WelcomeEmailRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"dashboard_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dashboard Url"}},"type":"object","required":["email"],"title":"WelcomeEmailRequest","description":"Request model for sending welcome emails","example":{"dashboard_url":"https://myapp.com/dashboard","email":"newuser@example.com","name":"John Doe"}},"WidgetConfig":{"properties":{"inbox_token":{"type":"string","title":"Inbox Token"},"brand_color":{"type":"string","title":"Brand Color"},"title":{"type":"string","title":"Title"},"subtitle":{"type":"string","title":"Subtitle"}},"type":"object","required":["inbox_token","brand_color","title","subtitle"],"title":"WidgetConfig"},"WidgetSetupInfo":{"properties":{"config":{"$ref":"#/components/schemas/WidgetConfig"},"embed_code":{"type":"string","title":"Embed Code"},"react_component":{"type":"string","title":"React Component"}},"type":"object","required":["config","embed_code","react_component"],"title":"WidgetSetupInfo"},"WithdrawRequest":{"properties":{"bank_account_id":{"type":"string","format":"uuid","title":"Bank Account Id","description":"Bank account ID to withdraw to"},"amount":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"string"}],"title":"Amount","description":"Amount to withdraw in USD"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description","description":"Optional transaction description"}},"type":"object","required":["bank_account_id","amount"],"title":"WithdrawRequest","description":"Schema for withdraw money request"},"WithdrawResponse":{"properties":{"withdrawal_id":{"type":"string","title":"Withdrawal Id"},"user_id":{"type":"string","title":"User Id"},"amount_usd":{"type":"number","title":"Amount Usd"},"splits_settled":{"type":"integer","title":"Splits Settled"},"status":{"type":"string","title":"Status"}},"type":"object","required":["withdrawal_id","user_id","amount_usd","splits_settled","status"],"title":"WithdrawResponse"},"WithdrawalHistoryItem":{"properties":{"id":{"type":"string","title":"Id"},"amount_usd":{"type":"number","title":"Amount Usd"},"split_count":{"type":"integer","title":"Split Count"},"status":{"type":"string","title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","amount_usd","split_count","status"],"title":"WithdrawalHistoryItem"},"WordPressAnalyticsResponse":{"properties":{"timeframe":{"type":"string","title":"Timeframe"},"sites_managed":{"type":"integer","title":"Sites Managed"},"content_generated":{"type":"integer","title":"Content Generated"},"backups_created":{"type":"integer","title":"Backups Created"},"updates_performed":{"type":"integer","title":"Updates Performed"},"security_scans":{"type":"integer","title":"Security Scans"},"uptime_percentage":{"type":"number","title":"Uptime Percentage"},"performance_metrics":{"$ref":"#/components/schemas/WordPressPerformanceMetrics"},"content_breakdown":{"$ref":"#/components/schemas/WordPressContentBreakdown"},"security_summary":{"$ref":"#/components/schemas/WordPressSecuritySummary"},"top_performing_sites":{"items":{"$ref":"#/components/schemas/TopPerformingSite"},"type":"array","title":"Top Performing Sites"}},"type":"object","required":["timeframe","sites_managed","content_generated","backups_created","updates_performed","security_scans","uptime_percentage","performance_metrics","content_breakdown","security_summary","top_performing_sites"],"title":"WordPressAnalyticsResponse","description":"Response for GET /wordpress-agent/analytics and GET /wordpress-agent/metrics\n(the metrics endpoint is a documented alias that returns this same shape)."},"WordPressContentBreakdown":{"properties":{"blog_posts":{"type":"integer","title":"Blog Posts"},"product_descriptions":{"type":"integer","title":"Product Descriptions"},"landing_pages":{"type":"integer","title":"Landing Pages"},"email_templates":{"type":"integer","title":"Email Templates"},"social_posts":{"type":"integer","title":"Social Posts"}},"type":"object","required":["blog_posts","product_descriptions","landing_pages","email_templates","social_posts"],"title":"WordPressContentBreakdown"},"WordPressGenerateResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_type":{"type":"string","title":"Project Type"},"description":{"type":"string","title":"Description"},"wp_version":{"type":"string","title":"Wp Version"},"status":{"type":"string","title":"Status"},"files":{"items":{"$ref":"#/components/schemas/GeneratedFile"},"type":"array","title":"Files"},"file_count":{"type":"integer","title":"File Count"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["project_id","project_type","description","wp_version","status","files","file_count","created_at"],"title":"WordPressGenerateResponse","description":"Response for POST /wordpress-agent/generate."},"WordPressPerformanceMetrics":{"properties":{"avg_load_time":{"type":"number","title":"Avg Load Time"},"avg_page_speed":{"type":"number","title":"Avg Page Speed"},"avg_seo_score":{"type":"number","title":"Avg Seo Score"}},"type":"object","required":["avg_load_time","avg_page_speed","avg_seo_score"],"title":"WordPressPerformanceMetrics"},"WordPressSecuritySummary":{"properties":{"vulnerabilities_found":{"type":"integer","title":"Vulnerabilities Found"},"malware_detected":{"type":"integer","title":"Malware Detected"},"security_patches_applied":{"type":"integer","title":"Security Patches Applied"}},"type":"object","required":["vulnerabilities_found","malware_detected","security_patches_applied"],"title":"WordPressSecuritySummary"},"WordPressTemplatesResponse":{"properties":{"templates":{"title":"Templates"}},"type":"object","required":["templates"],"title":"WordPressTemplatesResponse","description":"Response for GET /wordpress-agent/templates.\n\n``templates`` is either the full mapping of template_type -> list of\ntemplates (no filter given) or just the list for the requested type\n(filter given) — kept as Any to preserve both actual shapes."},"WorkAckResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"status":{"$ref":"#/components/schemas/WorkItemStatusEnum"},"acknowledged_at":{"type":"string","format":"date-time","title":"Acknowledged At"}},"type":"object","required":["id","status","acknowledged_at"],"title":"WorkAckResponse"},"WorkHeartbeatResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"status":{"type":"string","title":"Status","default":"heartbeat_received"},"last_heartbeat":{"type":"string","format":"date-time","title":"Last Heartbeat"}},"type":"object","required":["id","last_heartbeat"],"title":"WorkHeartbeatResponse"},"WorkItemResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"environment_id":{"type":"string","format":"uuid","title":"Environment Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"status":{"$ref":"#/components/schemas/WorkItemStatusEnum"},"work_type":{"type":"string","title":"Work Type"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"last_heartbeat":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Heartbeat"},"acknowledged_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Acknowledged At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","environment_id","user_id","status","work_type","payload"],"title":"WorkItemResponse"},"WorkItemStatusEnum":{"type":"string","enum":["queued","dispatched","acknowledged","in_progress","completed","failed","stopped"],"title":"WorkItemStatusEnum"},"WorkPollResponse":{"properties":{"work":{"anyOf":[{"$ref":"#/components/schemas/WorkItemResponse"},{"type":"null"}]},"message":{"type":"string","title":"Message","default":"No work available"}},"type":"object","title":"WorkPollResponse","description":"Response for long-polling work endpoint."},"WorkStopResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"status":{"$ref":"#/components/schemas/WorkItemStatusEnum"},"message":{"type":"string","title":"Message","default":"Work item stopped"}},"type":"object","required":["id","status"],"title":"WorkStopResponse"},"WorkerExternalMetadata":{"properties":{"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Arbitrary key-value metadata for the worker"}},"type":"object","required":["metadata"],"title":"WorkerExternalMetadata"},"WorkerExternalMetadataResponse":{"properties":{"session_id":{"type":"string","title":"Session Id","description":"Code session identifier"},"external_metadata":{"additionalProperties":true,"type":"object","title":"External Metadata","description":"Full merged external metadata after the update"},"updated_at":{"type":"string","title":"Updated At","description":"ISO-8601 time of the merge"}},"type":"object","required":["session_id","external_metadata","updated_at"],"title":"WorkerExternalMetadataResponse","description":"Returned by PUT /{session_id}/worker/external_metadata.\n\n`external_metadata` is the FULL merged metadata dict after the update\n(the handler merges the request body into any existing metadata), so it\nis deliberately an open Dict[str, Any] -- callers sync arbitrary\ncross-system keys through it.\nRefs #8449"},"WorkerStateUpdate":{"properties":{"status":{"type":"string","title":"Status","description":"Worker execution status"},"progress":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Progress"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["status"],"title":"WorkerStateUpdate"},"WorkerStateUpdateResponse":{"properties":{"session_id":{"type":"string","title":"Session Id","description":"Code session identifier"},"worker_status":{"type":"string","title":"Worker Status","description":"Worker status that was recorded"},"updated_at":{"type":"string","title":"Updated At","description":"ISO-8601 time the state was recorded"}},"type":"object","required":["session_id","worker_status","updated_at"],"title":"WorkerStateUpdateResponse","description":"Returned by PUT /{session_id}/worker.\n\n`worker_status` echoes the request body's `status`; `updated_at` is the\nISO-8601 timestamp the handler just stored on the worker state.\nNote this is intentionally a 3-key acknowledgement, NOT the full stored\nworker_state dict (which also holds progress/message/metadata).\nRefs #8449"},"WorkflowCancelResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"WorkflowCancelResponse","description":"Response model for DELETE /workflows/{workflow_id}"},"WorkflowFeedbackRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"workflow_execution_id":{"type":"string","title":"Workflow Execution Id","description":"Workflow execution ID"},"overall_satisfaction":{"type":"integer","maximum":5,"minimum":1,"title":"Overall Satisfaction","description":"Overall satisfaction 1-5"},"stage_ratings":{"additionalProperties":{"type":"integer"},"type":"object","title":"Stage Ratings","description":"Rating for each workflow stage"},"suggestions":{"items":{"type":"string"},"type":"array","title":"Suggestions","description":"User improvement suggestions"},"completion_time_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completion Time Minutes","description":"Time to complete workflow"},"would_recommend":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Would Recommend","description":"Would user recommend this tool"}},"type":"object","required":["project_id","workflow_execution_id","overall_satisfaction","stage_ratings"],"title":"WorkflowFeedbackRequest","description":"Request model for workflow completion feedback"},"WorkflowResultsResponse":{"properties":{"requirements":{"additionalProperties":true,"type":"object","title":"Requirements"},"architecture":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Architecture"},"frontend_components":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Frontend Components"},"backend_services":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Backend Services"},"security_scan_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Security Scan Results"},"test_suites":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Test Suites"},"infrastructure":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Infrastructure"},"deployment_pipeline":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Deployment Pipeline"},"quality_metrics":{"additionalProperties":{"type":"number"},"type":"object","title":"Quality Metrics"},"execution_summary":{"additionalProperties":true,"type":"object","title":"Execution Summary"}},"type":"object","required":["requirements","architecture","frontend_components","backend_services","security_scan_results","test_suites","infrastructure","deployment_pipeline","quality_metrics","execution_summary"],"title":"WorkflowResultsResponse","description":"Response model for completed workflow results"},"WorkflowStatusResponse":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id"},"status":{"type":"string","title":"Status"},"current_stage":{"type":"string","title":"Current Stage"},"progress":{"type":"number","title":"Progress"},"stages_completed":{"items":{"type":"string"},"type":"array","title":"Stages Completed"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"quality_score":{"type":"number","title":"Quality Score"},"security_score":{"type":"number","title":"Security Score"},"test_coverage":{"type":"number","title":"Test Coverage"},"total_execution_time":{"type":"number","title":"Total Execution Time"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["workflow_id","status","current_stage","progress","stages_completed","errors","warnings","quality_score","security_score","test_coverage","total_execution_time","created_at","updated_at"],"title":"WorkflowStatusResponse","description":"Response model for workflow status","example":{"created_at":"2024-01-15T10:30:00Z","current_stage":"frontend_development","errors":[],"progress":45,"quality_score":85.5,"security_score":92,"stages_completed":["requirements_analysis","architecture_design"],"status":"in_progress","test_coverage":78,"total_execution_time":650.5,"updated_at":"2024-01-15T10:40:00Z","warnings":["Integration validation completed - manual testing recommended"],"workflow_id":"wf_12345678-1234-1234-1234-123456789012"}},"WorkflowSummary":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id"},"status":{"type":"string","title":"Status"},"current_stage":{"type":"string","title":"Current Stage"},"progress":{"type":"number","title":"Progress"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"application_name":{"type":"string","title":"Application Name"},"application_type":{"type":"string","title":"Application Type"}},"type":"object","required":["workflow_id","status","current_stage","progress","created_at","updated_at","application_name","application_type"],"title":"WorkflowSummary","description":"Summary of a single workflow, as returned by GET /workflows"},"WorkflowSwarmHealth":{"properties":{"active":{"type":"integer","title":"Active"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["active","total"],"title":"WorkflowSwarmHealth","description":"Workflow counts reported by the health check"},"WorkspaceAddMemberRequest":{"properties":{"user_id":{"type":"string","title":"User Id","description":"ID of the existing user to add"},"role":{"type":"string","pattern":"^(?i:owner|admin|member)$","title":"Role","description":"Membership role to grant: owner, admin or member","default":"member"}},"type":"object","required":["user_id"],"title":"WorkspaceAddMemberRequest"},"WorkspaceAddMemberResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"workspace_id":{"type":"string","title":"Workspace Id"},"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email","default":""},"role":{"type":"string","title":"Role","default":"MEMBER"},"already_member":{"type":"boolean","title":"Already Member","default":false},"message":{"type":"string","title":"Message","default":"Member added to workspace"}},"type":"object","required":["workspace_id","user_id"],"title":"WorkspaceAddMemberResponse"},"WorkspaceAssignProjectResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Always true on the 200 path"},"message":{"type":"string","title":"Message","description":"Human-readable confirmation"}},"type":"object","required":["ok","message"],"title":"WorkspaceAssignProjectResponse","description":"Confirmation body for assigning a project to a workspace (Refs #8449).\n\nBoth keys are unconditional on the 200 path — the handler returns one flat\ndict literal, reached only after BOTH ownership checks pass — so no\n`response_model_exclude_unset` is needed. Mirrors the shape of the\nsibling WorkspaceDeleteResponse below."},"WorkspaceAuthRecord":{"properties":{"host":{"type":"string","title":"Host"},"type":{"type":"string","title":"Type"},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value"}},"additionalProperties":true,"type":"object","required":["host","type"],"title":"WorkspaceAuthRecord","description":"One email-authentication DNS record to publish (SPF/DMARC/DKIM)."},"WorkspaceAuthRecords":{"properties":{"spf":{"anyOf":[{"$ref":"#/components/schemas/WorkspaceAuthRecord"},{"type":"null"}]},"dmarc":{"anyOf":[{"$ref":"#/components/schemas/WorkspaceAuthRecord"},{"type":"null"}]},"dkim":{"anyOf":[{"$ref":"#/components/schemas/WorkspaceAuthRecord"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"WorkspaceAuthRecords"},"WorkspaceClearConfigResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"configured":{"type":"boolean","title":"Configured"}},"additionalProperties":true,"type":"object","required":["ok","configured"],"title":"WorkspaceClearConfigResponse","description":"DELETE /workspace/config"},"WorkspaceConfigResponse":{"properties":{"configured":{"type":"boolean","title":"Configured"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"admin_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin Subject"},"auth_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auth Mode"},"verify_status":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Verify Status","description":"Async verify outcome, or null while pending/unset."}},"additionalProperties":true,"type":"object","required":["configured"],"title":"WorkspaceConfigResponse","description":"GET /workspace/config"},"WorkspaceConfigureResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"domain":{"type":"string","title":"Domain"},"admin_subject":{"type":"string","title":"Admin Subject"},"auth_mode":{"type":"string","title":"Auth Mode"}},"additionalProperties":true,"type":"object","required":["ok","domain","admin_subject","auth_mode"],"title":"WorkspaceConfigureResponse","description":"POST /workspace/config"},"WorkspaceCostBreakdown":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"total_usd":{"type":"number","title":"Total Usd","default":0},"projects":{"items":{"$ref":"#/components/schemas/ProjectCostBreakdown"},"type":"array","title":"Projects"}},"type":"object","required":["organization_id"],"title":"WorkspaceCostBreakdown"},"WorkspaceCreateAliasResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"WorkspaceCreateAliasResponse","description":"POST /workspace/aliases — the created Google Directory alias resource."},"WorkspaceCreateRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"tier":{"type":"string","pattern":"^(free|pro|team|enterprise)$","title":"Tier","default":"free"},"workspace_type":{"type":"string","pattern":"^(personal|client|team)$","title":"Workspace Type","default":"personal"},"client_metadata":{"anyOf":[{"$ref":"#/components/schemas/ClientMetadata"},{"type":"null"}]}},"type":"object","required":["name"],"title":"WorkspaceCreateRequest"},"WorkspaceCreateResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"workspace":{"$ref":"#/components/schemas/WorkspaceItem"},"message":{"type":"string","title":"Message","default":"Workspace created"}},"type":"object","required":["workspace"],"title":"WorkspaceCreateResponse"},"WorkspaceCreateUserResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"WorkspaceCreateUserResponse","description":"POST /workspace/users — the created Google Directory user resource.\n\nPassthrough Google Directory ``User`` resource, plus an optional\n``_generated_password`` key the service adds when no password was supplied\nby the caller (returned once, never stored/logged in plaintext)."},"WorkspaceDeleteResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"message":{"type":"string","title":"Message"},"projects_migrated":{"type":"integer","title":"Projects Migrated","default":0},"migrated_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Migrated To"}},"type":"object","required":["message"],"title":"WorkspaceDeleteResponse"},"WorkspaceDeleteUserResponse":{"properties":{"email":{"type":"string","title":"Email"},"deleted":{"type":"boolean","title":"Deleted"}},"additionalProperties":true,"type":"object","required":["email","deleted"],"title":"WorkspaceDeleteUserResponse","description":"DELETE /workspace/users/{email}"},"WorkspaceDetailResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"workspace":{"$ref":"#/components/schemas/WorkspaceItem"},"members":{"items":{"$ref":"#/components/schemas/WorkspaceMember"},"type":"array","title":"Members","default":[]},"projects":{"items":{"$ref":"#/components/schemas/WorkspaceProjectSummary"},"type":"array","title":"Projects","default":[]}},"type":"object","required":["workspace"],"title":"WorkspaceDetailResponse"},"WorkspaceDomainStatusResponse":{"properties":{"state":{"type":"string","title":"State"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"dns_txt_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dns Txt Record"},"registrar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registrar"},"txt_live":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Txt Live"},"mx_pointed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Mx Pointed"},"google_mx_records":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Google Mx Records"},"spf_live":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Spf Live"},"dmarc_live":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dmarc Live"},"dkim_live":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dkim Live"},"auth_records":{"anyOf":[{"$ref":"#/components/schemas/WorkspaceAuthRecords"},{"type":"null"}]}},"additionalProperties":true,"type":"object","required":["state"],"title":"WorkspaceDomainStatusResponse","description":"GET /workspace/domain/status"},"WorkspaceItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tier":{"type":"string","title":"Tier","default":"free"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"role":{"type":"string","title":"Role","default":"MEMBER"},"is_default":{"type":"boolean","title":"Is Default","default":false},"workspace_type":{"type":"string","title":"Workspace Type","default":"personal"},"client_metadata":{"anyOf":[{"$ref":"#/components/schemas/ClientMetadata"},{"type":"null"}]},"member_count":{"type":"integer","title":"Member Count","default":0},"project_count":{"type":"integer","title":"Project Count","default":0},"created_at":{"type":"string","title":"Created At","default":""}},"type":"object","required":["id","name"],"title":"WorkspaceItem"},"WorkspaceListResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"workspaces":{"items":{"$ref":"#/components/schemas/WorkspaceItem"},"type":"array","title":"Workspaces"},"total":{"type":"integer","title":"Total","default":0},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["workspaces"],"title":"WorkspaceListResponse","description":"`has_more` documented per AINative-Studio/ainative-website#2208 — this\nendpoint returns the full set of a user's workspaces in one page (no\nlimit/offset), so `has_more` is always False."},"WorkspaceMember":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"role":{"type":"string","title":"Role","default":"MEMBER"},"joined_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Joined At"}},"type":"object","required":["user_id","email"],"title":"WorkspaceMember"},"WorkspacePendingActivation":{"properties":{"org_id":{"type":"string","title":"Org Id"},"org_name":{"type":"string","title":"Org Name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"needs_dkim_action":{"type":"boolean","title":"Needs Dkim Action"},"dkim_record_set":{"type":"boolean","title":"Dkim Record Set"},"admin_console_url":{"type":"string","title":"Admin Console Url"}},"additionalProperties":true,"type":"object","required":["org_id","org_name","needs_dkim_action","dkim_record_set","admin_console_url"],"title":"WorkspacePendingActivation","description":"One row of the superadmin pending-activations queue."},"WorkspacePendingActivationsResponse":{"properties":{"pending":{"items":{"$ref":"#/components/schemas/WorkspacePendingActivation"},"type":"array","title":"Pending"},"count":{"type":"integer","title":"Count"},"needs_action_count":{"type":"integer","title":"Needs Action Count"}},"additionalProperties":true,"type":"object","required":["pending","count","needs_action_count"],"title":"WorkspacePendingActivationsResponse","description":"GET /workspace/admin/pending-activations"},"WorkspaceProjectSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status","default":"ACTIVE"},"tier":{"type":"string","title":"Tier","default":"free"},"created_at":{"type":"string","title":"Created At","default":""}},"type":"object","required":["id","name"],"title":"WorkspaceProjectSummary"},"WorkspaceRemoveDomainResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"removed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Removed","description":"The domain that was removed, or null if none was configured."}},"additionalProperties":true,"type":"object","required":["ok"],"title":"WorkspaceRemoveDomainResponse","description":"DELETE /workspace/domain"},"WorkspaceRequestDomainResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"state":{"type":"string","title":"State"},"dns_txt_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dns Txt Record"},"instructions":{"type":"string","title":"Instructions"}},"additionalProperties":true,"type":"object","required":["domain","state","instructions"],"title":"WorkspaceRequestDomainResponse","description":"POST /workspace/domain/request"},"WorkspaceResetPasswordResponse":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"}},"additionalProperties":true,"type":"object","required":["email","password"],"title":"WorkspaceResetPasswordResponse","description":"POST /workspace/users/{email}/reset-password\n\nReturns the new password ONCE; it is never logged or stored in plaintext."},"WorkspaceSeatUsageResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"used":{"type":"integer","title":"Used"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit","description":"Seat cap for the org's tier; null means unlimited."},"available":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Available","description":"limit - used; null when limit is unlimited."}},"additionalProperties":true,"type":"object","required":["domain","used"],"title":"WorkspaceSeatUsageResponse","description":"GET /workspace/seats"},"WorkspaceSetDkimRecordResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"dkim_record":{"type":"string","title":"Dkim Record"}},"additionalProperties":true,"type":"object","required":["ok","dkim_record"],"title":"WorkspaceSetDkimRecordResponse","description":"POST /workspace/admin/dkim-record"},"WorkspaceSetupInstructionsResponse":{"properties":{"auth_mode":{"type":"string","title":"Auth Mode"},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Email"},"scope":{"type":"string","title":"Scope"},"admin_console_url":{"type":"string","title":"Admin Console Url"},"steps":{"items":{"type":"string"},"type":"array","title":"Steps"}},"additionalProperties":true,"type":"object","required":["auth_mode","scope","admin_console_url","steps"],"title":"WorkspaceSetupInstructionsResponse","description":"GET /workspace/setup-instructions — DWD authorization instructions."},"WorkspaceSuspendUserResponse":{"properties":{"email":{"type":"string","title":"Email"},"suspended":{"type":"boolean","title":"Suspended"},"user":{"additionalProperties":true,"type":"object","title":"User","description":"Updated Google Directory user resource (passthrough)."}},"additionalProperties":true,"type":"object","required":["email","suspended","user"],"title":"WorkspaceSuspendUserResponse","description":"POST /workspace/users/{email}/suspend"},"WorkspaceUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"workspace_type":{"anyOf":[{"type":"string","pattern":"^(personal|client|team)$"},{"type":"null"}],"title":"Workspace Type"},"client_metadata":{"anyOf":[{"$ref":"#/components/schemas/ClientMetadata"},{"type":"null"}]}},"type":"object","title":"WorkspaceUpdateRequest"},"WorkspaceUpdateResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"workspace":{"$ref":"#/components/schemas/WorkspaceItem"},"message":{"type":"string","title":"Message","default":"Workspace updated"}},"type":"object","required":["workspace"],"title":"WorkspaceUpdateResponse"},"WorkspaceUsersListResponse":{"properties":{"users":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Users","description":"Google Directory API user resources (passthrough)."},"count":{"type":"integer","title":"Count","description":"Number of users returned."}},"additionalProperties":true,"type":"object","required":["users","count"],"title":"WorkspaceUsersListResponse","description":"GET /workspace/users — list mailboxes in the tenant's domain."},"WorkspaceVerifyConnectionResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"domain":{"type":"string","title":"Domain"},"auth_mode":{"type":"string","title":"Auth Mode"},"sample_user_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sample User Count"}},"additionalProperties":true,"type":"object","required":["ok","domain","auth_mode"],"title":"WorkspaceVerifyConnectionResponse","description":"POST /workspace/verify"},"WorkspaceVerifyDomainResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"state":{"type":"string","title":"State"},"verified":{"type":"boolean","title":"Verified"}},"additionalProperties":true,"type":"object","required":["domain","state","verified"],"title":"WorkspaceVerifyDomainResponse","description":"POST /workspace/domain/verify"},"X402PlansData":{"properties":{"plans":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Plans","description":"Every plan purchasable via x402, with its payment target"}},"type":"object","required":["plans"],"title":"X402PlansData"},"X402PlansResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/X402PlansData"}},"type":"object","required":["success","data"],"title":"X402PlansResponse"},"X402SubscribeResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["success","data"],"title":"X402SubscribeResponse","description":"The `data` shape varies by outcome (already_active vs. active), so it stays\na dict here rather than fabricating a single fixed schema across both cases."},"X402SubscriptionData":{"properties":{"subscription":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Subscription","description":"The agent's current x402-activated subscription row, or null if none"}},"type":"object","title":"X402SubscriptionData"},"X402SubscriptionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/X402SubscriptionData"}},"type":"object","required":["success","data"],"title":"X402SubscriptionResponse"},"ZeroDBCollectionCreateData":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["id","name"],"title":"ZeroDBCollectionCreateData"},"ZeroDBCollectionCreateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"data":{"$ref":"#/components/schemas/ZeroDBCollectionCreateData"}},"type":"object","required":["success","message","data"],"title":"ZeroDBCollectionCreateResponse","description":"Response for POST /collections."},"ZeroDBCollectionsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"collections":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Collections"},"total":{"type":"integer","title":"Total"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["success","collections","total"],"title":"ZeroDBCollectionsResponse","description":"Response for GET /collections.\n\n`message` is present ONLY on the except/fallback branch, same\nreasoning as ZeroDBTablesResponse above."},"ZeroDBEventsStubResponse":{"properties":{"events":{"items":{},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"},"message":{"type":"string","title":"Message"}},"type":"object","required":["events","total","message"],"title":"ZeroDBEventsStubResponse","description":"Response for GET /events."},"ZeroDBLimitsData":{"properties":{"free":{"additionalProperties":true,"type":"object","title":"Free"},"pro":{"additionalProperties":true,"type":"object","title":"Pro"},"scale":{"additionalProperties":true,"type":"object","title":"Scale"},"enterprise":{"additionalProperties":true,"type":"object","title":"Enterprise"}},"type":"object","required":["free","pro","scale","enterprise"],"title":"ZeroDBLimitsData"},"ZeroDBLimitsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ZeroDBLimitsData"}},"type":"object","required":["success","data"],"title":"ZeroDBLimitsResponse","description":"GET /pricing/zerodb-limits"},"ZeroDBLinkedApisResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"items":{},"type":"array","title":"Data"}},"type":"object","required":["success","data"],"title":"ZeroDBLinkedApisResponse","description":"Response for GET /linked-apis."},"ZeroDBMcpHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"timestamp":{"type":"string","title":"Timestamp"},"version":{"type":"string","title":"Version"},"operations_count":{"type":"integer","title":"Operations Count"}},"type":"object","required":["status","service","timestamp","version","operations_count"],"title":"ZeroDBMcpHealthResponse"},"ZeroDBMcpOperationsResponse":{"properties":{"total_operations":{"type":"integer","title":"Total Operations"},"categories":{"additionalProperties":{"type":"integer"},"type":"object","title":"Categories"},"operations":{"items":{"type":"string"},"type":"array","title":"Operations"}},"type":"object","required":["total_operations","categories","operations"],"title":"ZeroDBMcpOperationsResponse"},"ZeroDBProjectActionMessageResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"ZeroDBProjectActionMessageResponse","description":"Response for POST /projects/{project_id}/suspend and .../reactivate."},"ZeroDBProjectCreateRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"tier":{"type":"string","pattern":"^(free|pro|scale|enterprise)$","title":"Tier","default":"free"},"database_enabled":{"type":"boolean","title":"Database Enabled","default":true},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"domain":{"anyOf":[{"type":"string","maxLength":253},{"type":"null"}],"title":"Domain"}},"type":"object","required":["name"],"title":"ZeroDBProjectCreateRequest"},"ZeroDBProjectCreateResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"user_id":{"type":"string","title":"User Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","project_name","user_id","status","message"],"title":"ZeroDBProjectCreateResponse","description":"Response for POST /projects."},"ZeroDBProjectDetailResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"database_count":{"type":"integer","title":"Database Count"},"vector_count":{"type":"integer","title":"Vector Count"},"memory_usage_mb":{"type":"number","title":"Memory Usage Mb"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"last_activity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity"},"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["project_id","database_count","vector_count","memory_usage_mb","is_active"],"title":"ZeroDBProjectDetailResponse","description":"Response for GET /projects/{project_id}."},"ZeroDBProjectItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"tier":{"type":"string","title":"Tier"},"database_enabled":{"type":"boolean","title":"Database Enabled"},"vectors_count":{"type":"integer","title":"Vectors Count"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"type":"string","title":"Created At"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"ax":{"anyOf":[{"$ref":"#/components/schemas/ProjectAxSummary"},{"type":"null"}]}},"type":"object","required":["id","name","status","tier","database_enabled","vectors_count","created_at"],"title":"ZeroDBProjectItem"},"ZeroDBProjectListItem":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"database_count":{"type":"integer","title":"Database Count"},"vector_count":{"type":"integer","title":"Vector Count"},"memory_usage_mb":{"type":"number","title":"Memory Usage Mb"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"last_activity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity"},"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["project_id","database_count","vector_count","memory_usage_mb","is_active"],"title":"ZeroDBProjectListItem"},"ZeroDBProjectListResponse":{"properties":{"projects":{"items":{"$ref":"#/components/schemas/ZeroDBProjectListItem"},"type":"array","title":"Projects"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["projects","total","skip","limit"],"title":"ZeroDBProjectListResponse","description":"Response for GET /projects."},"ZeroDBProjectStatusResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"is_active":{"type":"boolean","title":"Is Active"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["project_id","project_name","is_active","status","message"],"title":"ZeroDBProjectStatusResponse","description":"Response for PATCH /projects/{project_id}/status."},"ZeroDBProjectUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Description"},"tier":{"anyOf":[{"type":"string","pattern":"^(free|pro|scale|enterprise)$"},{"type":"null"}],"title":"Tier"},"status":{"anyOf":[{"type":"string","pattern":"^(ACTIVE|SUSPENDED|DELETED)$"},{"type":"null"}],"title":"Status"},"database_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Database Enabled"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id","description":"Workspace/organization to assign this project to"},"domain":{"anyOf":[{"type":"string","maxLength":253},{"type":"null"}],"title":"Domain","description":"Site this project represents; links it to its AX-Audit scan history (core#9387)"}},"type":"object","title":"ZeroDBProjectUpdateRequest"},"ZeroDBProjectsResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"projects":{"items":{"$ref":"#/components/schemas/ZeroDBProjectItem"},"type":"array","title":"Projects"}},"type":"object","required":["projects"],"title":"ZeroDBProjectsResponse"},"ZeroDBRowCreate":{"properties":{"row_data":{"additionalProperties":true,"type":"object","title":"Row Data","description":"Structured row data as JSON"}},"type":"object","required":["row_data"],"title":"ZeroDBRowCreate","description":"Schema for creating table rows"},"ZeroDBRowResponse":{"properties":{"row_data":{"additionalProperties":true,"type":"object","title":"Row Data","description":"Structured row data as JSON"},"row_id":{"type":"string","format":"uuid","title":"Row Id","description":"Unique row identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Project identifier"},"table_id":{"type":"string","format":"uuid","title":"Table Id","description":"Table identifier"},"table_name":{"type":"string","title":"Table Name","description":"Table name"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["row_data","row_id","project_id","table_id","table_name","created_at","updated_at"],"title":"ZeroDBRowResponse","description":"Complete row response schema"},"ZeroDBRowUpdate":{"properties":{"row_data":{"additionalProperties":true,"type":"object","title":"Row Data","description":"Updated row data as JSON"}},"type":"object","required":["row_data"],"title":"ZeroDBRowUpdate","description":"Schema for updating table rows"},"ZeroDBSystemStatsData":{"properties":{"total_projects":{"type":"integer","title":"Total Projects"},"active_connections":{"type":"integer","title":"Active Connections"},"data_size_gb":{"type":"number","title":"Data Size Gb"},"vector_operations":{"type":"integer","title":"Vector Operations"},"total_vectors":{"type":"integer","title":"Total Vectors"},"total_memories":{"type":"integer","title":"Total Memories"},"projects_today":{"type":"integer","title":"Projects Today"},"status":{"type":"string","title":"Status"},"total_storage":{"type":"string","title":"Total Storage"},"available_storage":{"type":"string","title":"Available Storage"},"storage_utilization":{"type":"string","title":"Storage Utilization"},"avg_response_time":{"type":"string","title":"Avg Response Time"}},"type":"object","required":["total_projects","active_connections","data_size_gb","vector_operations","total_vectors","total_memories","projects_today","status","total_storage","available_storage","storage_utilization","avg_response_time"],"title":"ZeroDBSystemStatsData"},"ZeroDBSystemStatsEnvelope":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ZeroDBSystemStatsData"}},"type":"object","required":["success","data"],"title":"ZeroDBSystemStatsEnvelope","description":"Response for GET /stats."},"ZeroDBTableCreate":{"properties":{"table_name":{"type":"string","title":"Table Name","description":"Table name"},"schema_definition":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schema Definition","description":"Table schema definition (accepts `schema` or `schema_definition`)"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"Project ID (set automatically)"}},"type":"object","required":["table_name"],"title":"ZeroDBTableCreate","description":"Schema for creating ZeroDB tables"},"ZeroDBTableResponse":{"properties":{"table_name":{"type":"string","title":"Table Name","description":"Table name"},"schema_definition":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schema Definition","description":"Table schema definition (accepts `schema` or `schema_definition`)"},"table_id":{"type":"string","format":"uuid","title":"Table Id","description":"Unique identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Unique identifier"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Timestamp"}},"type":"object","required":["table_name","table_id","project_id","created_at","updated_at"],"title":"ZeroDBTableResponse","description":"Complete ZeroDB table response schema"},"ZeroDBTablesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"tables":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tables"},"total":{"type":"integer","title":"Total"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["success","tables","total"],"title":"ZeroDBTablesResponse","description":"Response for GET /tables.\n\n`message` is present ONLY on the except/fallback branch (e.g. the\nzerodb_tables table not existing yet) -- the success branch never\nincludes it. response_model_exclude_none=True preserves this."},"ZeroDBUsageAnalyticsResponse":{"properties":{"period_days":{"type":"integer","title":"Period Days"},"project_growth":{"items":{},"type":"array","title":"Project Growth"},"active_projects_trend":{"items":{},"type":"array","title":"Active Projects Trend"},"top_organizations":{"items":{},"type":"array","title":"Top Organizations"},"summary":{"$ref":"#/components/schemas/ZeroDBUsageAnalyticsSummary"}},"type":"object","required":["period_days","project_growth","active_projects_trend","top_organizations","summary"],"title":"ZeroDBUsageAnalyticsResponse","description":"Response for GET /usage/analytics."},"ZeroDBUsageAnalyticsSummary":{"properties":{"total_projects":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Projects"},"active_projects":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Projects"},"recent_projects":{"type":"integer","title":"Recent Projects"}},"type":"object","required":["recent_projects"],"title":"ZeroDBUsageAnalyticsSummary"},"ZeroDBUsageStatsData":{"properties":{"total_requests":{"type":"string","title":"Total Requests"},"read_operations":{"type":"string","title":"Read Operations"},"write_operations":{"type":"string","title":"Write Operations"},"delete_operations":{"type":"string","title":"Delete Operations"},"chart_data":{"items":{"type":"integer"},"type":"array","title":"Chart Data"},"status":{"type":"string","title":"Status"},"projects_count":{"type":"integer","title":"Projects Count"}},"type":"object","required":["total_requests","read_operations","write_operations","delete_operations","chart_data","status","projects_count"],"title":"ZeroDBUsageStatsData"},"ZeroDBUsageStatsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ZeroDBUsageStatsData"}},"type":"object","required":["success","data"],"title":"ZeroDBUsageStatsResponse","description":"Response for GET /usage."},"ZeroDbDatabaseInfo":{"properties":{"name":{"type":"string","title":"Name"},"record_count":{"type":"integer","title":"Record Count"},"storage_mb":{"type":"number","title":"Storage Mb"},"queries_today":{"type":"integer","title":"Queries Today"}},"type":"object","required":["name","record_count","storage_mb","queries_today"],"title":"ZeroDbDatabaseInfo"},"ZeroDbStatsData":{"properties":{"total_projects":{"type":"integer","title":"Total Projects"},"active_connections":{"type":"integer","title":"Active Connections"},"data_size_gb":{"type":"number","title":"Data Size Gb"},"query_performance_ms":{"type":"number","title":"Query Performance Ms"},"vector_operations":{"type":"integer","title":"Vector Operations"},"total_memories":{"type":"integer","title":"Total Memories"},"last_backup":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Backup"}},"type":"object","required":["total_projects","active_connections","data_size_gb","query_performance_ms","vector_operations","total_memories"],"title":"ZeroDbStatsData"},"ZeroDbStatsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ZeroDbStatsData"}},"type":"object","required":["success","data"],"title":"ZeroDbStatsResponse"},"_DkimRecordBody":{"properties":{"org_id":{"type":"string","title":"Org Id"},"dkim_record":{"type":"string","title":"Dkim Record"}},"type":"object","required":["org_id","dkim_record"],"title":"_DkimRecordBody"},"_EmbeddingsRequest":{"properties":{"input":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Input"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","required":["input"],"title":"_EmbeddingsRequest"},"app__api__admin__auth__LoginRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"LoginRequest"},"app__api__admin__billing__TimeRange":{"type":"string","enum":["last_24_hours","last_7_days","last_30_days"],"title":"TimeRange","description":"Valid time range options for billing queries"},"app__api__admin__help_documentation__SearchQuery":{"properties":{"query":{"type":"string","title":"Query"},"category":{"anyOf":[{"$ref":"#/components/schemas/HelpCategory"},{"type":"null"}]},"doc_type":{"anyOf":[{"$ref":"#/components/schemas/DocumentationType"},{"type":"null"}]},"target_role":{"anyOf":[{"$ref":"#/components/schemas/app__api__admin__help_documentation__UserRole"},{"type":"null"}]}},"type":"object","required":["query"],"title":"SearchQuery"},"app__api__admin__help_documentation__UserRole":{"type":"string","enum":["beginner","intermediate","advanced","admin","developer"],"title":"UserRole","description":"User role for documentation targeting"},"app__api__admin__onboarding_tutorials__UserRole":{"type":"string","enum":["beginner","intermediate","advanced","admin","developer"],"title":"UserRole","description":"User role for tutorial targeting"},"app__api__admin__railway_deployment__DeploymentResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"project_name":{"type":"string","title":"Project Name"},"environment":{"$ref":"#/components/schemas/DeploymentEnvironment"},"status":{"$ref":"#/components/schemas/DeploymentStatus"},"railway_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Railway Url"},"custom_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Url"},"build_logs":{"items":{"type":"string"},"type":"array","title":"Build Logs"},"deploy_logs":{"items":{"type":"string"},"type":"array","title":"Deploy Logs"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["deployment_id","project_name","environment","status","started_at"],"title":"DeploymentResponse","description":"Response model for Railway deployment"},"app__api__admin__rlhf_feedback_endpoints__AgentFeedbackRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"agent_type":{"type":"string","title":"Agent Type","description":"Agent type (architect, frontend, etc.)"},"agent_response_id":{"type":"string","title":"Agent Response Id","description":"ID of the agent response being rated"},"user_rating":{"type":"integer","maximum":5,"minimum":1,"title":"User Rating","description":"User rating 1-5"},"feedback_text":{"type":"string","title":"Feedback Text","description":"User's detailed feedback"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context","description":"Additional context"}},"type":"object","required":["project_id","agent_type","agent_response_id","user_rating","feedback_text"],"title":"AgentFeedbackRequest","description":"Request model for agent-specific feedback"},"app__api__admin__rlhf_feedback_endpoints__FeedbackResponse":{"properties":{"feedback_id":{"type":"string","title":"Feedback Id","description":"Unique feedback ID"},"status":{"type":"string","title":"Status","description":"Collection status"},"message":{"type":"string","title":"Message","description":"Response message"},"processed":{"type":"boolean","title":"Processed","description":"Whether feedback was processed for learning"}},"type":"object","required":["feedback_id","status","message","processed"],"title":"FeedbackResponse","description":"Response model for feedback collection"},"app__api__api_v1__endpoints__agent_coordination__MessageResponse":{"properties":{"id":{"type":"string","title":"Id"},"sender_agent_id":{"type":"string","title":"Sender Agent Id"},"recipient_agent_id":{"type":"string","title":"Recipient Agent Id"},"project_id":{"type":"string","title":"Project Id"},"message":{"type":"string","title":"Message"},"message_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message Type"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"created_at":{"type":"string","title":"Created At"},"read_status":{"type":"boolean","title":"Read Status","default":false}},"type":"object","required":["id","sender_agent_id","recipient_agent_id","project_id","message","created_at"],"title":"MessageResponse","example":{"created_at":"2025-01-01T00:00:00Z","id":"msg-123","message":"Task completed successfully","message_type":"task_update","metadata":{"status":"completed"},"project_id":"project-101","read_status":false,"recipient_agent_id":"agent-789","sender_agent_id":"agent-456"}},"app__api__api_v1__endpoints__agent_framework__MemoryResponse":{"properties":{"id":{"type":"string","title":"Id"},"content":{"type":"string","title":"Content"},"memory_type":{"type":"string","title":"Memory Type"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"priority":{"type":"integer","title":"Priority"},"user_id":{"type":"string","title":"User Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"},"source":{"type":"string","title":"Source"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","content","memory_type","tags","priority","user_id","agent_id","project_id","source","created_at","updated_at"],"title":"MemoryResponse"},"app__api__api_v1__endpoints__agent_framework__MemorySearchRequest":{"properties":{"query":{"type":"string","title":"Query"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit","default":10},"memory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Type"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","default":[]}},"type":"object","required":["query"],"title":"MemorySearchRequest"},"app__api__api_v1__endpoints__agent_learning__FeedbackRequest":{"properties":{"rating":{"type":"integer","title":"Rating"},"feedback_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Text"},"feedback_type":{"type":"string","title":"Feedback Type","default":"quality"}},"type":"object","required":["rating"],"title":"FeedbackRequest"},"app__api__api_v1__endpoints__agent_learning__InteractionRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"interaction_type":{"type":"string","title":"Interaction Type"},"input_data":{"additionalProperties":true,"type":"object","title":"Input Data"},"output_data":{"additionalProperties":true,"type":"object","title":"Output Data"},"success":{"type":"boolean","title":"Success"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"}},"type":"object","required":["agent_id","interaction_type","input_data","output_data","success"],"title":"InteractionRequest"},"app__api__api_v1__endpoints__agent_state__AgentStateListResponse":{"properties":{"states":{"items":{"$ref":"#/components/schemas/AgentStateSummary"},"type":"array","title":"States"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["states","total"],"title":"AgentStateListResponse"},"app__api__api_v1__endpoints__agent_state__CheckpointCreateResponse":{"properties":{"id":{"type":"string","title":"Id"},"state_id":{"type":"string","title":"State Id"},"checkpoint_name":{"type":"string","title":"Checkpoint Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"type":"string","title":"Created At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","state_id","checkpoint_name","created_at","message"],"title":"CheckpointCreateResponse"},"app__api__api_v1__endpoints__agent_state__CheckpointListResponse":{"properties":{"state_id":{"type":"string","title":"State Id"},"checkpoints":{"items":{"$ref":"#/components/schemas/CheckpointSummary"},"type":"array","title":"Checkpoints"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["state_id","checkpoints","total"],"title":"CheckpointListResponse"},"app__api__api_v1__endpoints__agent_state__CheckpointRestoreResponse":{"properties":{"checkpoint_id":{"type":"string","title":"Checkpoint Id"},"state_id":{"type":"string","title":"State Id"},"agent_id":{"type":"string","title":"Agent Id"},"version":{"type":"integer","title":"Version"},"updated_at":{"type":"string","title":"Updated At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["checkpoint_id","state_id","agent_id","version","updated_at","message"],"title":"CheckpointRestoreResponse"},"app__api__api_v1__endpoints__agent_swarms__ArtifactCreateRequest":{"properties":{"name":{"type":"string","title":"Name"},"content":{"type":"string","title":"Content"}},"type":"object","required":["name","content"],"title":"ArtifactCreateRequest","description":"Request to create an artifact"},"app__api__api_v1__endpoints__agent_swarms__ArtifactResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"size_bytes":{"type":"integer","title":"Size Bytes","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"status":{"type":"string","title":"Status","default":"available"}},"type":"object","required":["id","name","created_at"],"title":"ArtifactResponse","description":"Artifact response"},"app__api__api_v1__endpoints__application_generation__AgentStatusResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"specialization":{"type":"string","title":"Specialization"},"status":{"type":"string","title":"Status"},"current_tasks":{"type":"integer","title":"Current Tasks"},"capabilities":{"items":{"type":"string"},"type":"array","title":"Capabilities"},"performance_metrics":{"additionalProperties":true,"type":"object","title":"Performance Metrics"}},"type":"object","required":["agent_id","specialization","status","current_tasks","capabilities","performance_metrics"],"title":"AgentStatusResponse","description":"Response model for agent status","example":{"agent_id":"architect_1","capabilities":["system_design","architecture_patterns","technology_selection"],"current_tasks":1,"performance_metrics":{"average_completion_time":180.5,"success_rate":96,"tasks_completed":25},"specialization":"architect","status":"active"}},"app__api__api_v1__endpoints__audio__TTSRequest":{"properties":{"text":{"type":"string","maxLength":5000,"minLength":1,"title":"Text","description":"Text to synthesize"},"model_id":{"type":"string","title":"Model Id","description":"Audio model ID (default: minimax-tts — the servable default; facebook/mms-tts-eng and other HF/OpenAI TTS are deprecated. Refs #5680)","default":"minimax-tts"},"voice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice","description":"Voice ID or speaker parameter"}},"type":"object","required":["text"],"title":"TTSRequest","description":"Request schema for TTS generation"},"app__api__api_v1__endpoints__audio__TTSResponse":{"properties":{"audio_base64":{"type":"string","title":"Audio Base64","description":"Base64-encoded audio data"},"duration_seconds":{"type":"number","title":"Duration Seconds","description":"Duration of generated audio"},"cost_credits":{"type":"integer","title":"Cost Credits","description":"Credits charged (with 100% markup)"},"format":{"type":"string","title":"Format","description":"Audio format (wav, mp3, etc.)"}},"type":"object","required":["audio_base64","duration_seconds","cost_credits","format"],"title":"TTSResponse","description":"Response schema for TTS generation"},"app__api__api_v1__endpoints__auth__GitHubOAuthRequest":{"properties":{"code":{"type":"string","title":"Code"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"redirect_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redirect Uri"},"stripe_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Session Id"}},"type":"object","required":["code"],"title":"GitHubOAuthRequest","example":{"code":"github_authorization_code_here","redirect_uri":"https://www.ainative.studio/login/callback","state":"optional_state_parameter"}},"app__api__api_v1__endpoints__auth__GitHubUserResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"},"user":{"additionalProperties":true,"type":"object","title":"User"}},"type":"object","required":["access_token","token_type","user"],"title":"GitHubUserResponse","example":{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","token_type":"bearer","user":{"email":"user@example.com","id":"123456","login":"testuser","name":"Test User"}}},"app__api__api_v1__endpoints__auth__LinkedInOAuthRequest":{"properties":{"code":{"type":"string","title":"Code"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"redirect_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redirect Uri"},"stripe_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Session Id"}},"type":"object","required":["code"],"title":"LinkedInOAuthRequest","description":"LinkedIn OAuth callback request model","example":{"code":"linkedin_authorization_code_here","redirect_uri":"https://api.ainative.studio/v1/auth/linkedin/callback","state":"optional_csrf_state_parameter"}},"app__api__api_v1__endpoints__auth__LinkedInUserResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"},"expires_in":{"type":"integer","title":"Expires In"},"user":{"additionalProperties":true,"type":"object","title":"User"}},"type":"object","required":["access_token","token_type","expires_in","user"],"title":"LinkedInUserResponse","description":"LinkedIn OAuth callback response model","example":{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","expires_in":28800,"token_type":"bearer","user":{"email":"user@example.com","family_name":"Doe","given_name":"John","id":"abc123xyz","name":"John Doe","picture":"https://media.licdn.com/..."}}},"app__api__api_v1__endpoints__auth__MessageResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"MessageResponse","example":{"message":"Operation completed successfully"}},"app__api__api_v1__endpoints__auth__TokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"},"expires_in":{"type":"integer","title":"Expires In"}},"type":"object","required":["access_token","token_type","expires_in"],"title":"TokenResponse","example":{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","expires_in":1800,"token_type":"bearer"}},"app__api__api_v1__endpoints__auth__UserInfoResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"is_active":{"type":"boolean","title":"Is Active"},"role":{"type":"string","title":"Role"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email_verified":{"type":"boolean","title":"Email Verified","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"github_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Username"},"github_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Id"}},"type":"object","required":["id","email","is_active","role","created_at"],"title":"UserInfoResponse","example":{"avatar_url":"https://github.com/johndoe.png","created_at":"2025-01-01T00:00:00Z","email":"user@example.com","email_verified":true,"full_name":"John Doe","github_username":"johndoe","id":"550e8400-e29b-41d4-a716-446655440000","is_active":true,"role":"USER","username":"johndoe"}},"app__api__api_v1__endpoints__auth__UserRegistrationRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"turnstile_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turnstile Token"}},"type":"object","required":["email","password"],"title":"UserRegistrationRequest","example":{"email":"user@example.com","full_name":"John Doe","password":"securePassword123","username":"johndoe"}},"app__api__api_v1__endpoints__collaboration__CreateSessionRequest":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project ID"},"name":{"type":"string","title":"Name","description":"Session name"},"description":{"type":"string","title":"Description","description":"Session description","default":""},"max_users":{"type":"integer","maximum":50,"minimum":1,"title":"Max Users","description":"Maximum users","default":10},"duration_hours":{"anyOf":[{"type":"integer","maximum":168,"minimum":1},{"type":"null"}],"title":"Duration Hours","description":"Session duration in hours"}},"type":"object","required":["project_id","name"],"title":"CreateSessionRequest","description":"Request to create collaboration session"},"app__api__api_v1__endpoints__collaboration__SessionAnalyticsResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"name":{"type":"string","title":"Name"},"project_id":{"type":"string","title":"Project Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"duration_minutes":{"type":"number","title":"Duration Minutes"},"total_users":{"type":"integer","title":"Total Users"},"active_users":{"type":"integer","title":"Active Users"},"active_agents":{"type":"integer","title":"Active Agents"},"user_activity":{"additionalProperties":true,"type":"object","title":"User Activity"},"agent_summary":{"additionalProperties":true,"type":"object","title":"Agent Summary"}},"type":"object","required":["session_id","name","project_id","created_at","duration_minutes","total_users","active_users","active_agents","user_activity","agent_summary"],"title":"SessionAnalyticsResponse","description":"Session analytics response"},"app__api__api_v1__endpoints__collaboration__SessionResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"project_id":{"type":"string","title":"Project Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"created_by":{"type":"string","title":"Created By"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"max_users":{"type":"integer","title":"Max Users"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"users_count":{"type":"integer","title":"Users Count"},"active_agents_count":{"type":"integer","title":"Active Agents Count"},"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["session_id","project_id","name","description","created_by","created_at","max_users","expires_at","users_count","active_agents_count","is_active"],"title":"SessionResponse","description":"Collaboration session response"},"app__api__api_v1__endpoints__comprehensive_evaluation__EvaluationStatusResponse":{"properties":{"evaluation_id":{"type":"string","title":"Evaluation Id"},"status":{"type":"string","title":"Status"},"progress":{"type":"integer","title":"Progress"},"current_step":{"type":"string","title":"Current Step"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["evaluation_id","status","progress","current_step"],"title":"EvaluationStatusResponse","description":"Response model for evaluation status"},"app__api__api_v1__endpoints__documents__SearchQuery":{"properties":{"query":{"type":"string","title":"Query"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit","default":10},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"}},"type":"object","required":["query"],"title":"SearchQuery","description":"Vector search query schema"},"app__api__api_v1__endpoints__emails__EmailResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"email_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Id"}},"type":"object","required":["success","message"],"title":"EmailResponse","description":"Response model for email operations","example":{"email_id":"re_1234567890abcdef","message":"Welcome email sent successfully","success":true}},"app__api__api_v1__endpoints__embeddings__EmbedAndStoreRequest":{"properties":{"texts":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Texts","description":"Texts to embed and store"},"metadata_list":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Metadata List","description":"Metadata for each text"},"namespace":{"type":"string","title":"Namespace","description":"ZeroDB namespace","default":"default"},"model":{"type":"string","title":"Model","description":"Embedding model","default":"BAAI/bge-small-en-v1.5"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"ZeroDB project ID"}},"type":"object","required":["texts","project_id"],"title":"EmbedAndStoreRequest"},"app__api__api_v1__endpoints__embeddings__EmbedAndStoreResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"vectors_stored":{"type":"integer","title":"Vectors Stored"},"embeddings_generated":{"type":"integer","title":"Embeddings Generated"},"model":{"type":"string","title":"Model"},"dimensions":{"type":"integer","title":"Dimensions"},"namespace":{"type":"string","title":"Namespace"},"processing_time_ms":{"type":"number","title":"Processing Time Ms"}},"type":"object","required":["success","vectors_stored","embeddings_generated","model","dimensions","namespace","processing_time_ms"],"title":"EmbedAndStoreResponse"},"app__api__api_v1__endpoints__embeddings__EmbeddingModelInfo":{"properties":{"id":{"type":"string","title":"Id"},"dimensions":{"type":"integer","title":"Dimensions"},"description":{"type":"string","title":"Description"},"speed":{"type":"string","title":"Speed"},"loaded":{"type":"boolean","title":"Loaded"},"cost_per_1k":{"type":"number","title":"Cost Per 1K","default":0}},"type":"object","required":["id","dimensions","description","speed","loaded"],"title":"EmbeddingModelInfo"},"app__api__api_v1__endpoints__embeddings__GenerateEmbeddingsRequest":{"properties":{"texts":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Texts","description":"List of texts to embed (max 100)"},"model":{"type":"string","title":"Model","description":"Embedding model to use (default: bge-m3, 1024-dim)","default":"bge-m3"},"normalize":{"type":"boolean","title":"Normalize","description":"Normalize embeddings to unit length","default":true}},"type":"object","required":["texts"],"title":"GenerateEmbeddingsRequest"},"app__api__api_v1__endpoints__embeddings__GenerateEmbeddingsResponse":{"properties":{"embeddings":{"items":{"items":{"type":"number"},"type":"array"},"type":"array","title":"Embeddings"},"model":{"type":"string","title":"Model"},"dimensions":{"type":"integer","title":"Dimensions"},"count":{"type":"integer","title":"Count"},"processing_time_ms":{"type":"number","title":"Processing Time Ms"},"cost_usd":{"type":"number","title":"Cost Usd","default":0}},"type":"object","required":["embeddings","model","dimensions","count","processing_time_ms"],"title":"GenerateEmbeddingsResponse"},"app__api__api_v1__endpoints__embeddings__SemanticSearchRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Search query text"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"ZeroDB project ID"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Maximum results","default":10},"threshold":{"type":"number","maximum":1,"minimum":0,"title":"Threshold","description":"Similarity threshold","default":0.7},"namespace":{"type":"string","title":"Namespace","description":"ZeroDB namespace","default":"default"},"filter_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter Metadata","description":"Metadata filters"},"model":{"type":"string","title":"Model","description":"Embedding model","default":"BAAI/bge-small-en-v1.5"}},"type":"object","required":["query","project_id"],"title":"SemanticSearchRequest"},"app__api__api_v1__endpoints__embeddings__SemanticSearchResponse":{"properties":{"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results"},"query":{"type":"string","title":"Query"},"total_results":{"type":"integer","title":"Total Results"},"model":{"type":"string","title":"Model"},"processing_time_ms":{"type":"number","title":"Processing Time Ms"}},"type":"object","required":["results","query","total_results","model","processing_time_ms"],"title":"SemanticSearchResponse"},"app__api__api_v1__endpoints__enterprise_security__SecurityDashboardResponse":{"properties":{"security_overview":{"additionalProperties":true,"type":"object","title":"Security Overview"},"compliance_summary":{"additionalProperties":true,"type":"object","title":"Compliance Summary"},"recent_incidents":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recent Incidents"},"high_risk_events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"High Risk Events"},"system_health":{"additionalProperties":true,"type":"object","title":"System Health"}},"type":"object","required":["security_overview","compliance_summary","recent_incidents","high_risk_events","system_health"],"title":"SecurityDashboardResponse","description":"Security dashboard response"},"app__api__api_v1__endpoints__organizations__ChatSessionResponse":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["id","title","status","created_at","user_id"],"title":"ChatSessionResponse","example":{"created_at":"2025-01-01T00:00:00Z","id":"chat-session-123","status":"active","title":"AI Assistant Conversation","user_id":"user-456"}},"app__api__api_v1__endpoints__prompt_analytics__AlertRuleRequest":{"properties":{"rule_name":{"type":"string","title":"Rule Name","description":"Human-readable rule name"},"metric_name":{"type":"string","title":"Metric Name","description":"Metric to monitor"},"condition":{"type":"string","title":"Condition","description":"Alert condition (greater_than, less_than, equals, change_rate)"},"threshold_value":{"type":"number","title":"Threshold Value","description":"Threshold value"},"severity":{"type":"string","title":"Severity","description":"Alert severity (info, warning, critical, emergency)"},"time_window_minutes":{"type":"integer","maximum":60,"minimum":1,"title":"Time Window Minutes","description":"Evaluation window in minutes","default":5}},"type":"object","required":["rule_name","metric_name","condition","threshold_value","severity"],"title":"AlertRuleRequest"},"app__api__api_v1__endpoints__prompt_analytics__DashboardResponse":{"properties":{"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"time_window":{"type":"string","title":"Time Window"},"summary":{"additionalProperties":true,"type":"object","title":"Summary"},"aggregated_metrics":{"additionalProperties":true,"type":"object","title":"Aggregated Metrics"},"trend_analysis":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Trend Analysis"},"active_alerts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Active Alerts"},"performance_insights":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Performance Insights"},"top_performing_prompts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Performing Prompts"},"comparative_analysis":{"additionalProperties":true,"type":"object","title":"Comparative Analysis"},"charts":{"additionalProperties":true,"type":"object","title":"Charts"}},"type":"object","required":["timestamp","time_window","summary","aggregated_metrics","trend_analysis","active_alerts","performance_insights","top_performing_prompts","comparative_analysis","charts"],"title":"DashboardResponse"},"app__api__api_v1__endpoints__prompt_versioning__DeploymentResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"version_id":{"type":"string","title":"Version Id"},"strategy":{"type":"string","title":"Strategy"},"status":{"type":"string","title":"Status"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Time"},"previous_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Version"}},"type":"object","required":["deployment_id","version_id","strategy","status","start_time"],"title":"DeploymentResponse"},"app__api__api_v1__endpoints__quality_improvement__SystemHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"total_recommendations":{"type":"integer","title":"Total Recommendations"},"active_engines":{"type":"integer","title":"Active Engines"},"cache_hit_rate":{"type":"number","title":"Cache Hit Rate"},"avg_generation_time":{"type":"number","title":"Avg Generation Time"},"supported_recommendation_types":{"type":"integer","title":"Supported Recommendation Types"},"ml_models_loaded":{"type":"boolean","title":"Ml Models Loaded"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","total_recommendations","active_engines","cache_hit_rate","avg_generation_time","supported_recommendation_types","ml_models_loaded","timestamp"],"title":"SystemHealthResponse"},"app__api__api_v1__endpoints__quality_trending__SystemHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"prompts_monitored":{"type":"integer","title":"Prompts Monitored"},"total_data_points":{"type":"integer","title":"Total Data Points"},"active_alerts":{"type":"integer","title":"Active Alerts"},"alert_rules":{"type":"integer","title":"Alert Rules"},"alert_cooldowns_active":{"type":"integer","title":"Alert Cooldowns Active"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["status","prompts_monitored","total_data_points","active_alerts","alert_rules","alert_cooldowns_active","timestamp"],"title":"SystemHealthResponse"},"app__api__api_v1__endpoints__realtime_feedback__SubmitFeedbackRequest":{"properties":{"evaluation_id":{"type":"string","title":"Evaluation Id","description":"Evaluation ID"},"prompt_id":{"type":"string","title":"Prompt Id","description":"Prompt ID"},"quality_score":{"type":"number","maximum":1,"minimum":0,"title":"Quality Score","description":"Quality score (0.0-1.0)"},"performance_metrics":{"additionalProperties":{"type":"number"},"type":"object","title":"Performance Metrics","description":"Performance metrics"},"evaluation_result":{"additionalProperties":true,"type":"object","title":"Evaluation Result","description":"Evaluation result data"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"}},"type":"object","required":["evaluation_id","prompt_id","quality_score"],"title":"SubmitFeedbackRequest"},"app__api__api_v1__endpoints__realtime_feedback__SystemHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"active_connections":{"type":"integer","title":"Active Connections"},"active_subscriptions":{"type":"integer","title":"Active Subscriptions"},"recent_feedback_count":{"type":"integer","title":"Recent Feedback Count"},"queue_size":{"type":"integer","title":"Queue Size"},"processing_active":{"type":"boolean","title":"Processing Active"},"uptime":{"type":"string","title":"Uptime"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["status","active_connections","active_subscriptions","recent_feedback_count","queue_size","processing_active","uptime","timestamp"],"title":"SystemHealthResponse"},"app__api__api_v1__endpoints__sessions__SessionAnalyticsResponse":{"properties":{"total_sessions":{"type":"integer","title":"Total Sessions"},"active_sessions":{"type":"integer","title":"Active Sessions"},"expired_sessions":{"type":"integer","title":"Expired Sessions"},"total_users":{"type":"integer","title":"Total Users"},"average_session_duration":{"type":"number","title":"Average Session Duration"},"peak_concurrent_sessions":{"type":"integer","title":"Peak Concurrent Sessions"},"events_tracked":{"type":"integer","title":"Events Tracked"},"last_cleanup":{"type":"string","format":"date-time","title":"Last Cleanup"}},"type":"object","required":["total_sessions","active_sessions","expired_sessions","total_users","average_session_duration","peak_concurrent_sessions","events_tracked","last_cleanup"],"title":"SessionAnalyticsResponse","description":"Session analytics response model"},"app__api__api_v1__endpoints__sessions__SessionEventResponse":{"properties":{"event_id":{"type":"string","title":"Event Id"},"session_id":{"type":"string","title":"Session Id"},"event_type":{"type":"string","title":"Event Type"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["event_id","session_id","event_type","timestamp","data"],"title":"SessionEventResponse","description":"Session event response model"},"app__api__api_v1__endpoints__sessions__SessionResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"user_id":{"type":"string","title":"User Id"},"username":{"type":"string","title":"Username"},"email":{"type":"string","title":"Email"},"roles":{"items":{"type":"string"},"type":"array","title":"Roles"},"preferences":{"additionalProperties":true,"type":"object","title":"Preferences"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"last_activity":{"type":"string","format":"date-time","title":"Last Activity"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["session_id","user_id","username","email","roles","preferences","status","created_at","updated_at","expires_at","last_activity","metadata"],"title":"SessionResponse","description":"Session response model"},"app__api__api_v1__endpoints__user_feedback__FeedbackResponse":{"properties":{"feedback_id":{"type":"string","title":"Feedback Id"},"user_id":{"type":"string","title":"User Id"},"feedback_type":{"type":"string","title":"Feedback Type"},"content":{"type":"string","title":"Content"},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating"},"prompt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Id"},"evaluation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evaluation Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"status":{"type":"string","title":"Status"},"reviewed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed By"},"reviewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reviewed At"},"response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response"}},"type":"object","required":["feedback_id","user_id","feedback_type","content","rating","prompt_id","evaluation_id","created_at","sentiment","category","confidence_score","keywords","status","reviewed_by","reviewed_at","response"],"title":"FeedbackResponse"},"app__api__api_v1__endpoints__user_feedback__FeedbackSummaryResponse":{"properties":{"analysis_timestamp":{"type":"string","title":"Analysis Timestamp"},"time_window_days":{"type":"integer","title":"Time Window Days"},"total_feedback":{"type":"integer","title":"Total Feedback"},"feedback_by_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"Feedback By Type"},"feedback_by_sentiment":{"additionalProperties":{"type":"integer"},"type":"object","title":"Feedback By Sentiment"},"feedback_by_category":{"additionalProperties":{"type":"integer"},"type":"object","title":"Feedback By Category"},"average_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Rating"},"top_keywords":{"items":{"items":{},"type":"array"},"type":"array","title":"Top Keywords"},"recent_insights":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recent Insights"}},"type":"object","required":["analysis_timestamp","time_window_days","total_feedback","feedback_by_type","feedback_by_sentiment","feedback_by_category","average_rating","top_keywords","recent_insights"],"title":"FeedbackSummaryResponse"},"app__api__api_v1__endpoints__user_feedback__SubmitFeedbackRequest":{"properties":{"feedback_type":{"type":"string","title":"Feedback Type","description":"Type of feedback"},"content":{"type":"string","maxLength":5000,"minLength":1,"title":"Content","description":"Feedback content"},"rating":{"anyOf":[{"type":"number","maximum":5,"minimum":1},{"type":"null"}],"title":"Rating","description":"Rating (1.0-5.0)"},"prompt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Id","description":"Associated prompt ID"},"evaluation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evaluation Id","description":"Associated evaluation ID"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata"}},"type":"object","required":["feedback_type","content"],"title":"SubmitFeedbackRequest"},"app__api__api_v1__endpoints__user_feedback__SystemHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"total_feedback":{"type":"integer","title":"Total Feedback"},"recent_feedback_count":{"type":"integer","title":"Recent Feedback Count"},"pending_feedback_count":{"type":"integer","title":"Pending Feedback Count"},"total_insights":{"type":"integer","title":"Total Insights"},"feedback_types":{"type":"integer","title":"Feedback Types"},"categories_supported":{"type":"integer","title":"Categories Supported"},"ml_models_loaded":{"type":"boolean","title":"Ml Models Loaded"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","total_feedback","recent_feedback_count","pending_feedback_count","total_insights","feedback_types","categories_supported","ml_models_loaded","timestamp"],"title":"SystemHealthResponse"},"app__api__api_v1__endpoints__users__ChatSessionResponse":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["id","title","status","created_at","user_id"],"title":"ChatSessionResponse","example":{"created_at":"2025-01-01T00:00:00Z","id":"chat-session-123","status":"active","title":"AI Assistant Conversation","user_id":"user-456"}},"app__api__api_v1__endpoints__users__CurrentUserResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayname"},"avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar"},"role":{"type":"string","title":"Role","default":"USER"},"is_active":{"type":"boolean","title":"Is Active"},"is_superuser":{"type":"boolean","title":"Is Superuser"},"NUCLEAR_CHAT_SESSIONS_PROOF":{"items":{"$ref":"#/components/schemas/app__api__api_v1__endpoints__users__ChatSessionResponse"},"type":"array","title":"Nuclear Chat Sessions Proof"}},"type":"object","required":["id","email","is_active","is_superuser","NUCLEAR_CHAT_SESSIONS_PROOF"],"title":"CurrentUserResponse","example":{"NUCLEAR_CHAT_SESSIONS_PROOF":[{"created_at":"2025-01-01T00:00:00Z","id":"chat-session-1","status":"active","title":"AI Development Discussion","user_id":"user-123"}],"avatar":"https://example.com/avatar.jpg","displayName":"Admin User","email":"admin@example.com","id":"user-123","is_active":true,"is_superuser":false,"role":"USER","username":"admin"}},"app__api__api_v1__endpoints__users__UserRegistrationRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"}},"type":"object","required":["email","password"],"title":"UserRegistrationRequest"},"app__api__api_v1__endpoints__webhooks__WebhookResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"is_active":{"type":"boolean","title":"Is Active"},"secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secret"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_triggered":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Triggered"},"failure_count":{"type":"integer","title":"Failure Count","default":0},"user_id":{"type":"string","title":"User Id"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["id","name","url","events","is_active","created_at","user_id"],"title":"WebhookResponse"},"app__api__deployment_automation__AlertRuleRequest":{"properties":{"name":{"type":"string","title":"Name"},"condition":{"type":"string","title":"Condition"},"severity":{"type":"string","title":"Severity"},"action":{"type":"string","title":"Action"},"cooldown_minutes":{"type":"integer","title":"Cooldown Minutes","default":15}},"type":"object","required":["name","condition","severity","action"],"title":"AlertRuleRequest","description":"Request model for adding an alert rule"},"app__api__internal__casa_authorize__CasaAuthorizeRequest":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"task":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task"},"conversation":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Conversation"},"tool_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Params"},"tools_available":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tools Available"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"source_service":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Service"}},"type":"object","required":["tool_name"],"title":"CasaAuthorizeRequest"},"app__api__internal__lake_query__LakeQueryRequest":{"properties":{"sql":{"type":"string","maxLength":4000,"minLength":10,"title":"Sql","description":"SQL query over lake partitions"},"limit":{"type":"integer","maximum":1000,"minimum":1,"title":"Limit","default":100}},"type":"object","required":["sql"],"title":"LakeQueryRequest"},"app__api__internal__lake_query__LakeQueryResponse":{"properties":{"columns":{"items":{"type":"string"},"type":"array","title":"Columns"},"rows":{"items":{"items":{},"type":"array"},"type":"array","title":"Rows"},"row_count":{"type":"integer","title":"Row Count"},"source":{"type":"string","title":"Source"},"partition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Partition"}},"type":"object","required":["columns","rows","row_count","source"],"title":"LakeQueryResponse"},"app__api__internal__rlhf_improvement_report__ImprovementReportResponse":{"properties":{"summary":{"$ref":"#/components/schemas/ImprovementSummary"},"agents":{"items":{"$ref":"#/components/schemas/AgentImprovementRecord"},"type":"array","title":"Agents"},"source":{"type":"string","title":"Source"}},"type":"object","required":["summary","agents","source"],"title":"ImprovementReportResponse"},"app__api__monitoring__health_endpoint__HealthStatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"services":{"items":{"$ref":"#/components/schemas/ServiceHealth"},"type":"array","title":"Services"},"timestamp":{"type":"string","title":"Timestamp"},"uptime_seconds":{"type":"number","title":"Uptime Seconds"},"version":{"type":"string","title":"Version"}},"type":"object","required":["status","services","timestamp","uptime_seconds","version"],"title":"HealthStatusResponse","description":"Aggregate health status for all critical services."},"app__api__monitoring_dashboard__MonitoringDashboardResponse":{"properties":{"overview":{"additionalProperties":true,"type":"object","title":"Overview"},"current_metrics":{"additionalProperties":true,"type":"object","title":"Current Metrics"},"trends":{"additionalProperties":true,"type":"object","title":"Trends"},"alerts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Alerts"},"top_endpoints":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Endpoints"},"performance_recommendations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Performance Recommendations"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"additionalProperties":true,"type":"object","required":["overview","current_metrics","trends","alerts","top_endpoints","performance_recommendations","metadata"],"title":"MonitoringDashboardResponse","description":"Aggregated dashboard payload from PerformanceMonitoringService.\n\nShadowed-route note: at runtime GET /api/v1/monitoring/dashboard is served\nby app.api.v1.endpoints.system_monitoring.get_monitoring_dashboard, which\nregisters the same (GET, path) pair earlier and therefore wins. That\nwinning handler has no response model of its own (it lives in another file\nand is out of this change's scope), so this wrapper is typed with its OWN\nreal shape rather than left undocumented -- the published schema stays\ntruthful about what this module produces, and `extra=\"allow\"` means it does\nnot misdescribe the winner's DB-backed payload either."},"app__api__monitoring_dashboard__ResolveAlertResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"resolved_at":{"type":"string","title":"Resolved At"}},"type":"object","required":["status","message","resolved_at"],"title":"ResolveAlertResponse","description":"Result of marking a performance alert resolved."},"app__api__oauth__models__TokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"refresh_token":{"type":"string","title":"Refresh Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"expires_in":{"type":"integer","title":"Expires In","default":3600},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"}},"type":"object","required":["access_token","refresh_token"],"title":"TokenResponse","description":"Token endpoint response."},"app__api__oauth__userinfo__UserInfoResponse":{"properties":{"sub":{"type":"string","title":"Sub"},"email":{"type":"string","title":"Email"},"email_verified":{"type":"boolean","title":"Email Verified"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"given_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Given Name"},"family_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family Name"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"organizations":{"items":{"$ref":"#/components/schemas/OrganizationMembership"},"type":"array","title":"Organizations","default":[]}},"type":"object","required":["sub","email","email_verified"],"title":"UserInfoResponse","description":"OIDC UserInfo claims (standard + AINative extensions)."},"app__api__routers__analytics__DashboardSummaryResponse":{"properties":{"period_days":{"type":"integer","title":"Period Days"},"total_videos":{"type":"integer","title":"Total Videos"},"total_views":{"type":"integer","title":"Total Views"},"total_unique_views":{"type":"integer","title":"Total Unique Views"},"total_watch_time_hours":{"type":"number","title":"Total Watch Time Hours"},"avg_completion_rate":{"type":"number","title":"Avg Completion Rate"},"total_likes":{"type":"integer","title":"Total Likes"},"total_shares":{"type":"integer","title":"Total Shares"},"total_comments":{"type":"integer","title":"Total Comments"}},"type":"object","required":["period_days","total_videos","total_views","total_unique_views","total_watch_time_hours","avg_completion_rate","total_likes","total_shares","total_comments"],"title":"DashboardSummaryResponse","description":"Dashboard summary response"},"app__api__routers__compatibility__HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"version":{"type":"string","title":"Version"},"timestamp":{"type":"string","title":"Timestamp"},"compatibility_note":{"type":"string","title":"Compatibility Note"}},"type":"object","required":["status","service","version","timestamp","compatibility_note"],"title":"HealthResponse"},"app__api__routers__compatibility__StatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"services":{"$ref":"#/components/schemas/StatusServices"},"uptime":{"type":"string","title":"Uptime"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","services","uptime","timestamp"],"title":"StatusResponse","description":"GET /status returns a STATIC hardcoded dict -- these values are not\nmeasured from anything live (Refs #8449: typed as-is, not corrected;\nmaking the values real is out of scope for a typing pass)."},"app__api__routes__pr_analysis__HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","service","timestamp"],"title":"HealthResponse","description":"Response model for health check"},"app__api__routes__quantum_search__IndexRepositoryResponse":{"properties":{"repository_id":{"type":"string","format":"uuid4","title":"Repository Id","description":"Repository identifier"},"files_indexed":{"type":"integer","title":"Files Indexed","description":"Number of files indexed"},"execution_time_ms":{"type":"number","title":"Execution Time Ms","description":"Execution time in milliseconds"},"status":{"type":"string","title":"Status","description":"Operation status"}},"type":"object","required":["repository_id","files_indexed","execution_time_ms","status"],"title":"IndexRepositoryResponse","description":"Response model for repository indexing."},"app__api__routes__quantum_search__SearchRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Search query text"},"repository_ids":{"items":{"type":"string","format":"uuid4"},"type":"array","title":"Repository Ids","description":"Repositories to search within"},"use_quantum_enhancement":{"type":"boolean","title":"Use Quantum Enhancement","description":"Whether to use quantum enhancement","default":true},"max_results":{"type":"integer","title":"Max Results","description":"Maximum number of results to return","default":10}},"type":"object","required":["query","repository_ids"],"title":"SearchRequest","description":"Request model for quantum-enhanced search."},"app__api__security_monitoring__SecurityDashboardResponse":{"properties":{"overview":{"additionalProperties":true,"type":"object","title":"Overview"},"event_types":{"additionalProperties":{"type":"integer"},"type":"object","title":"Event Types"},"threat_levels":{"additionalProperties":{"type":"integer"},"type":"object","title":"Threat Levels"},"top_attackers":{"additionalProperties":{"type":"integer"},"type":"object","title":"Top Attackers"},"recent_events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recent Events"},"blocked_ips":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Blocked Ips"},"ip_reputation":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Ip Reputation"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"additionalProperties":true,"type":"object","required":["overview","event_types","threat_levels","top_attackers","recent_events","blocked_ips","ip_reputation","metadata"],"title":"SecurityDashboardResponse","description":"Aggregated payload from SecurityMonitoringService.get_security_dashboard_data()\nplus the handler-added `metadata` block.\n\nThe breakdown maps (`event_types`, `threat_levels`, `top_attackers`) are\nkeyed by live enum values and attacker IPs, so they stay free-form Dicts."},"app__api__v1__consolidated__billing__BalanceResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"balance":{"type":"number","title":"Balance","default":0},"currency":{"type":"string","title":"Currency","default":"USD"}},"additionalProperties":true,"type":"object","required":["user_id"],"title":"BalanceResponse","description":"Credit balance for a single user.\n\n`balance` is the net credit_transactions ledger balance. `-1` is the\n\"unlimited\" sentinel (enterprise tier / superuser), so this field must not\nbe constrained to a non-negative value. Refs #8831."},"app__api__v1__consolidated__billing__UsageRecord":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"resource_type":{"type":"string","title":"Resource Type"},"quantity":{"type":"number","title":"Quantity"},"cost":{"type":"number","title":"Cost"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["id","user_id","resource_type","quantity","cost","timestamp"],"title":"UsageRecord"},"app__api__v1__endpoints__a2a__AgentCardResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"capabilities":{"items":{},"type":"array","title":"Capabilities"},"input_types":{"items":{},"type":"array","title":"Input Types"},"output_types":{"items":{},"type":"array","title":"Output Types"},"auth":{"type":"string","title":"Auth"},"streaming":{"type":"boolean","title":"Streaming"},"endpoint":{"type":"string","title":"Endpoint"}},"type":"object","required":["id","name","description","capabilities","input_types","output_types","auth","streaming","endpoint"],"title":"AgentCardResponse","description":"A2A discovery document for a known agent (see a2a_service.get_agent_card)."},"app__api__v1__endpoints__a2a__AgentFeedbackRequest":{"properties":{"feedback_type":{"type":"string","title":"Feedback Type","description":"Type: 'quality', 'correction', 'request', 'confirmation'"},"content":{"type":"string","title":"Content","description":"Feedback content or message"},"source_agent":{"type":"string","title":"Source Agent","description":"ID/name of the sending agent"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context","description":"Additional context"},"score":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Score","description":"Quality score 0-1"},"reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To","description":"Task ID this is a reply to"}},"type":"object","required":["feedback_type","content","source_agent"],"title":"AgentFeedbackRequest","description":"Structured feedback from an external agent."},"app__api__v1__endpoints__active_projects__DashboardSummaryResponse":{"properties":{"active_projects":{"type":"integer","title":"Active Projects","description":"Projects pending or in progress"},"completed_projects":{"type":"integer","title":"Completed Projects","description":"Projects that completed"},"failed_projects":{"type":"integer","title":"Failed Projects","description":"Projects that failed"},"paused_projects":{"type":"integer","title":"Paused Projects","description":"Projects interrupted/paused"},"total_projects":{"type":"integer","title":"Total Projects","description":"Total projects across all statuses"},"average_progress":{"type":"number","title":"Average Progress","description":"Mean progress of active projects"},"recent_completions_24h":{"type":"integer","title":"Recent Completions 24H","description":"Completions in the last 24h"},"recent_failures_24h":{"type":"integer","title":"Recent Failures 24H","description":"Failures in the last 24h"},"status_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Status Breakdown","description":"Per-status execution counts keyed by WorkflowExecutionStatus value. Empty dict when the summary query fails."}},"additionalProperties":true,"type":"object","required":["active_projects","completed_projects","failed_projects","paused_projects","total_projects","average_progress","recent_completions_24h","recent_failures_24h","status_breakdown"],"title":"DashboardSummaryResponse","description":"Aggregate counters for the Active Projects dashboard.\n\nMirrors ActiveProjectsService.get_dashboard_summary, including its\nall-zero except-branch fallback. `average_progress` is a rounded float on\nthe success path but a plain int 0 in the fallback, hence the float type\n(ints coerce cleanly)."},"app__api__v1__endpoints__agent_approvals__ApprovalRequestItem":{"properties":{"id":{"title":"Id"},"agent_id":{"title":"Agent Id"},"action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"},"context":{"anyOf":[{},{"type":"null"}],"title":"Context"},"status":{"type":"string","title":"Status"},"approver_id":{"anyOf":[{},{"type":"null"}],"title":"Approver Id"},"decided_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Decided At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","agent_id","status"],"title":"ApprovalRequestItem","description":"Row from agent_approval_requests (see AgentHITLService.get_pending_approvals/get_approval_history)."},"app__api__v1__endpoints__agent_auth__AgentKeyCreateRequest":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name","description":"Key name/label"},"scoped_capabilities":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Scoped Capabilities","description":"Capabilities this key grants (must be subset of agent capabilities)"},"expires_in_days":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"title":"Expires In Days","description":"Key expiry in days"}},"type":"object","required":["name","scoped_capabilities"],"title":"AgentKeyCreateRequest","description":"Request body to create a capability-scoped API key for an agent."},"app__api__v1__endpoints__agent_auth__AgentKeyCreatedResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"name":{"type":"string","title":"Name"},"key_prefix":{"type":"string","title":"Key Prefix"},"scoped_capabilities":{"items":{"type":"string"},"type":"array","title":"Scoped Capabilities"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"},"is_active":{"type":"boolean","title":"Is Active"},"raw_key":{"type":"string","title":"Raw Key"}},"type":"object","required":["id","agent_id","name","key_prefix","scoped_capabilities","is_active","raw_key"],"title":"AgentKeyCreatedResponse","description":"Returned only at creation time — includes the raw key (shown once)."},"app__api__v1__endpoints__agent_auth__AgentKeyResponse":{"properties":{"id":{"type":"string","title":"Id"},"agent_id":{"type":"string","title":"Agent Id"},"name":{"type":"string","title":"Name"},"key_prefix":{"type":"string","title":"Key Prefix"},"scoped_capabilities":{"items":{"type":"string"},"type":"array","title":"Scoped Capabilities"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"},"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["id","agent_id","name","key_prefix","scoped_capabilities","is_active"],"title":"AgentKeyResponse"},"app__api__v1__endpoints__agent_auth__AgentRegisterRequest":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name","description":"Human-readable agent name"},"agent_type":{"$ref":"#/components/schemas/AgentType","description":"Agent type classification","default":"supervised"},"model":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Model","description":"LLM model identifier (e.g. claude-opus-4-20250514)"},"operator":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Operator","description":"Operator/organization running the agent"},"description":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Description","description":"Agent description"},"capabilities":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Capabilities","description":"Requested capability scopes"},"oversight_level":{"$ref":"#/components/schemas/OversightLevel","description":"Oversight level for this agent","default":"logging"},"max_delegation_depth":{"type":"integer","maximum":10,"minimum":1,"title":"Max Delegation Depth","description":"Maximum delegation chain depth","default":3},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Custom agent metadata"}},"type":"object","required":["name","capabilities"],"title":"AgentRegisterRequest","description":"Request body to register a new agent."},"app__api__v1__endpoints__agent_billing__AgentMetricsResponse":{"properties":{"period":{"type":"string","title":"Period"},"period_start":{"type":"string","format":"date-time","title":"Period Start"},"period_end":{"type":"string","format":"date-time","title":"Period End"},"agents":{"items":{"$ref":"#/components/schemas/AgentMetricsItem"},"type":"array","title":"Agents"}},"type":"object","required":["period","period_start","period_end","agents"],"title":"AgentMetricsResponse"},"app__api__v1__endpoints__agent_billing__CostEstimateResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"estimated_cost_usd":{"type":"number","title":"Estimated Cost Usd"},"estimated_credits":{"type":"integer","title":"Estimated Credits"},"remaining_budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Remaining Budget Usd"},"budget_limit_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget Limit Usd"},"budget_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Budget Period"},"would_exceed_budget":{"type":"boolean","title":"Would Exceed Budget","default":false}},"type":"object","required":["agent_id","estimated_cost_usd","estimated_credits"],"title":"CostEstimateResponse"},"app__api__v1__endpoints__agent_billing__DashboardResponse":{"properties":{"total_spend_this_month":{"type":"number","title":"Total Spend This Month"},"top_5_agents_by_cost":{"items":{"$ref":"#/components/schemas/TopAgentItem"},"type":"array","title":"Top 5 Agents By Cost"},"daily_trend_30d":{"items":{"$ref":"#/components/schemas/DailyTrendItem"},"type":"array","title":"Daily Trend 30D"},"projected_month_end":{"type":"number","title":"Projected Month End"},"credit_balance":{"type":"number","title":"Credit Balance"}},"type":"object","required":["total_spend_this_month","top_5_agents_by_cost","daily_trend_30d","projected_month_end","credit_balance"],"title":"DashboardResponse"},"app__api__v1__endpoints__agent_cloud_deployments__DeploymentListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__agent_cloud_deployments__DeploymentResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"limit":{"type":"integer","title":"Limit"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","total","page","page_size","limit","has_more"],"title":"DeploymentListResponse"},"app__api__v1__endpoints__agent_cloud_deployments__DeploymentMetricsResponse":{"properties":{"deployment_id":{"type":"string","format":"uuid","title":"Deployment Id"},"agent_id":{"type":"string","title":"Agent Id"},"period":{"type":"string","title":"Period"},"request_count":{"type":"integer","title":"Request Count"},"error_count":{"type":"integer","title":"Error Count"},"error_rate":{"type":"number","title":"Error Rate"},"avg_latency_ms":{"type":"number","title":"Avg Latency Ms"},"p95_latency_ms":{"type":"number","title":"P95 Latency Ms"},"p99_latency_ms":{"type":"number","title":"P99 Latency Ms"},"input_tokens":{"type":"integer","title":"Input Tokens"},"output_tokens":{"type":"integer","title":"Output Tokens"},"health_status":{"type":"string","title":"Health Status"},"status":{"type":"string","title":"Status"}},"type":"object","required":["deployment_id","agent_id","period","request_count","error_count","error_rate","avg_latency_ms","p95_latency_ms","p99_latency_ms","input_tokens","output_tokens","health_status","status"],"title":"DeploymentMetricsResponse","description":"Real aggregate metrics for a deployment, computed from agent_traces (Refs #6528).\n\nThese are honest observability aggregates — request volume, error rate,\nlatency percentiles, and LLM token usage — NOT fabricated CPU/memory\ntime-series. All fields are zero when the agent has no traces in the window."},"app__api__v1__endpoints__agent_cloud_deployments__DeploymentResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"agent_registration_id":{"title":"Agent Registration Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"customer_id":{"type":"string","format":"uuid","title":"Customer Id"},"namespace":{"type":"string","title":"Namespace"},"container_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container Id"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"image_uri":{"type":"string","title":"Image Uri"},"workload_type":{"type":"string","title":"Workload Type"},"resource_plan":{"type":"string","title":"Resource Plan"},"status":{"type":"string","title":"Status"},"min_instances":{"type":"integer","title":"Min Instances"},"max_instances":{"type":"integer","title":"Max Instances"},"auto_scale_enabled":{"type":"boolean","title":"Auto Scale Enabled"},"zerodb_project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Zerodb Project Id"},"health_status":{"type":"string","title":"Health Status"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"scaffold_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Scaffold Version"},"scaffold_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Scaffold Config"},"runtime_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Runtime Config"},"simulated":{"type":"boolean","title":"Simulated","default":true},"estimated_monthly_cost_usd":{"type":"number","title":"Estimated Monthly Cost Usd","default":0},"cost_is_estimate":{"type":"boolean","title":"Cost Is Estimate","default":true},"created_at":{"title":"Created At"},"updated_at":{"title":"Updated At"}},"type":"object","required":["id","agent_registration_id","customer_id","namespace","image_uri","workload_type","resource_plan","status","min_instances","max_instances","auto_scale_enabled","health_status","created_at","updated_at"],"title":"DeploymentResponse"},"app__api__v1__endpoints__agent_evaluation__EvaluateRequest":{"properties":{"response":{"type":"string","title":"Response","description":"Agent response text to evaluate"},"context":{"items":{"type":"string"},"type":"array","title":"Context","description":"Context strings available at generation time"},"memories":{"items":{"type":"string"},"type":"array","title":"Memories","description":"ZeroDB memory strings to check grounding against"},"threshold":{"type":"number","maximum":1,"minimum":0,"title":"Threshold","description":"Minimum confidence to pass (default 0.7)","default":0.7}},"type":"object","required":["response"],"title":"EvaluateRequest"},"app__api__v1__endpoints__agent_keys__AgentKeyCreateRequest":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name","description":"Human-readable label for the key (e.g. 'ci-agent-key')"},"ttl_seconds":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}],"title":"Ttl Seconds","description":"Seconds until this key expires. Omit for a non-expiring key."},"scopes":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Scopes","description":"Namespace-restricted permission scopes. Format: ':[:]'. Valid services: zerodb, inference, memory, file, agent, mcp."},"permissions":{"anyOf":[{"$ref":"#/components/schemas/PermissionsManifest"},{"type":"null"}],"description":"Optional RBAC permission manifest for fine-grained per-tool, per-namespace, and per-route access control (Issue #2891). Omit for unrestricted access."}},"type":"object","required":["name","scopes"],"title":"AgentKeyCreateRequest","description":"Request body for POST /auth/keys."},"app__api__v1__endpoints__agent_keys__AgentKeyCreatedResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"name":{"type":"string","title":"Name"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"permissions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissions"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"key":{"type":"string","title":"Key"}},"type":"object","required":["id","user_id","name","scopes","is_active","key"],"title":"AgentKeyCreatedResponse","description":"Response body returned only at creation time.\n\nIncludes the raw key — this is the only time it will ever be shown.\nStore it securely; it cannot be recovered."},"app__api__v1__endpoints__agent_keys__AgentKeyResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"name":{"type":"string","title":"Name"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"permissions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Permissions"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","user_id","name","scopes","is_active"],"title":"AgentKeyResponse","description":"Response body for list/create operations (no raw key)."},"app__api__v1__endpoints__agent_registration__AgentRegisterRequest":{"properties":{"agent_name":{"type":"string","maxLength":128,"minLength":1,"title":"Agent Name","description":"Human-readable name for the agent"},"capabilities":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Capabilities","description":"List of capability slugs claimed by the agent"},"callback_url":{"type":"string","title":"Callback Url","description":"HTTPS URL the platform will use to deliver events to this agent"}},"type":"object","required":["agent_name","capabilities","callback_url"],"title":"AgentRegisterRequest","description":"Body for POST /agents/register.\n\nagent_name — human-readable label; must be non-empty, ≤ 128 chars.\ncapabilities — list of capability slugs (e.g. \"memory\", \"search\").\ncallback_url — HTTPS endpoint the platform will POST events to."},"app__api__v1__endpoints__agent_sessions__CreateSessionRequest":{"properties":{"session_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Session Id","description":"Optional caller-supplied session ID. Auto-generated if omitted."},"user_id":{"type":"string","title":"User Id","description":"UUID of the owning user. Must be a valid UUID v4 string and must reference an existing user in the system. Example: '550e8400-e29b-41d4-a716-446655440000'"},"heartbeat_interval_seconds":{"type":"integer","maximum":3600,"minimum":5,"title":"Heartbeat Interval Seconds","description":"Expected heartbeat cadence in seconds. Sessions are stalled after this many seconds without a heartbeat.","default":30}},"type":"object","required":["user_id"],"title":"CreateSessionRequest"},"app__api__v1__endpoints__agent_sessions__SessionResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"session_id":{"type":"string","title":"Session Id"},"status":{"type":"string","title":"Status"},"heartbeat_interval_seconds":{"type":"integer","title":"Heartbeat Interval Seconds"},"last_heartbeat_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Heartbeat At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"terminated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Terminated At"}},"type":"object","required":["id","user_id","session_id","status","heartbeat_interval_seconds","last_heartbeat_at","created_at","terminated_at"],"title":"SessionResponse"},"app__api__v1__endpoints__agent_state__AgentStateListResponse":{"properties":{"status":{"type":"string","title":"Status"},"agents":{"anyOf":[{"items":{"$ref":"#/components/schemas/AgentStateListEntry"},"type":"array"},{"type":"null"}],"title":"Agents"},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"AgentStateListResponse","description":"state_expiry_service.list_all_with_state()"},"app__api__v1__endpoints__agent_state__ForkRequest":{"properties":{"new_agent_id":{"type":"string","maxLength":255,"minLength":1,"title":"New Agent Id","description":"ID for the forked agent"}},"type":"object","required":["new_agent_id"],"title":"ForkRequest"},"app__api__v1__endpoints__agent_state__SnapshotListEntry":{"properties":{"snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"compressed_size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Compressed Size Bytes"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"additionalProperties":true,"type":"object","title":"SnapshotListEntry"},"app__api__v1__endpoints__agent_state__StorageUsageResponse":{"properties":{"status":{"type":"string","title":"Status"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"total_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Bytes"},"breakdown":{"anyOf":[{"$ref":"#/components/schemas/StorageUsageBreakdown"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"additionalProperties":true,"type":"object","required":["status"],"title":"StorageUsageResponse","description":"state_expiry_service.get_storage_usage()"},"app__api__v1__endpoints__approvals__ApprovalRequestItem":{"properties":{"id":{"type":"string","title":"Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"risk_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Level"},"status":{"type":"string","title":"Status"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"decided_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decided At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","status"],"title":"ApprovalRequestItem"},"app__api__v1__endpoints__artifacts__ArtifactCreateRequest":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"content":{"type":"string","maxLength":10485760,"title":"Content"},"content_type":{"type":"string","title":"Content Type","default":"text/plain"},"language":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Language"},"visibility":{"type":"string","title":"Visibility","default":"unlisted"},"expires_in":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In","default":604800},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["content"],"title":"ArtifactCreateRequest"},"app__api__v1__endpoints__artifacts__ArtifactResponse":{"properties":{"id":{"type":"string","title":"Id"},"url":{"type":"string","title":"Url"},"short_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Url"},"created_at":{"type":"string","title":"Created At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"content_type":{"type":"string","title":"Content Type"},"size_bytes":{"type":"integer","title":"Size Bytes"}},"additionalProperties":true,"type":"object","required":["id","url","created_at","content_type","size_bytes"],"title":"ArtifactResponse","description":"POST /artifacts payload — matches create_artifact()'s return 7-for-7.\n\nRefs #8449: this class already existed but was unreferenced; it is now the\ndeclared payload of the create route rather than a near-duplicate."},"app__api__v1__endpoints__audit_logs__AuditLogEntry":{"properties":{"id":{"type":"string","title":"Id"},"action":{"type":"string","title":"Action"},"resource_type":{"type":"string","title":"Resource Type"},"resource_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"created_at":{"type":"string","title":"Created At"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["id","action","resource_type","resource_id","user_id","organization_id","ip_address","user_agent","created_at","metadata"],"title":"AuditLogEntry"},"app__api__v1__endpoints__auth__GitHubOAuthRequest":{"properties":{"code":{"type":"string","title":"Code"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"redirect_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redirect Uri"},"gclid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gclid"},"utm":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Utm"},"stripe_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Session Id"}},"type":"object","required":["code"],"title":"GitHubOAuthRequest","description":"GitHub OAuth callback request model"},"app__api__v1__endpoints__auth__GitHubUserResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"refresh_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Token"},"token_type":{"type":"string","title":"Token Type"},"user":{"additionalProperties":true,"type":"object","title":"User"}},"type":"object","required":["access_token","token_type","user"],"title":"GitHubUserResponse","description":"GitHub OAuth callback response model"},"app__api__v1__endpoints__auth__LinkedInOAuthRequest":{"properties":{"code":{"type":"string","title":"Code"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"redirect_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redirect Uri"},"stripe_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Session Id"}},"type":"object","required":["code"],"title":"LinkedInOAuthRequest","description":"LinkedIn OAuth callback request model"},"app__api__v1__endpoints__auth__LinkedInUserResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"},"expires_in":{"type":"integer","title":"Expires In"},"user":{"additionalProperties":true,"type":"object","title":"User"}},"type":"object","required":["access_token","token_type","expires_in","user"],"title":"LinkedInUserResponse","description":"LinkedIn OAuth callback response model"},"app__api__v1__endpoints__ax_audit_checkout__CheckoutRequest":{"properties":{"tier":{"type":"string","title":"Tier","description":"pro|business|agency"},"billing":{"type":"string","title":"Billing","description":"monthly|annual","default":"monthly"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"site_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Site Url","description":"Origin site for success/cancel redirects"}},"type":"object","required":["tier"],"title":"CheckoutRequest"},"app__api__v1__endpoints__ax_audit_checkout__CheckoutResponse":{"properties":{"checkout_url":{"type":"string","title":"Checkout Url"},"session_id":{"type":"string","title":"Session Id"}},"type":"object","required":["checkout_url","session_id"],"title":"CheckoutResponse"},"app__api__v1__endpoints__bank_accounts__BankAccountListResponse":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__bank_accounts__BankAccountResponse"},"type":"array","title":"Accounts"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["accounts","total"],"title":"BankAccountListResponse","description":"Schema for list of bank accounts","example":{"accounts":[],"total":0}},"app__api__v1__endpoints__bank_accounts__BankAccountResponse":{"properties":{"id":{"type":"string","title":"Id"},"account_name":{"type":"string","title":"Account Name"},"bank_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bank Name"},"account_type":{"type":"string","title":"Account Type"},"account_last4":{"type":"string","title":"Account Last4"},"verification_status":{"type":"string","title":"Verification Status"},"is_default":{"type":"boolean","title":"Is Default"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","account_name","bank_name","account_type","account_last4","verification_status","is_default","created_at","updated_at"],"title":"BankAccountResponse","description":"Schema for bank account response","example":{"account_last4":"7890","account_name":"Primary Checking","account_type":"checking","bank_name":"Chase Bank","created_at":"2025-01-22T12:00:00Z","id":"550e8400-e29b-41d4-a716-446655440000","is_default":true,"updated_at":"2025-01-22T13:00:00Z","verification_status":"verified"}},"app__api__v1__endpoints__beckn_network__BecknAckMessage":{"properties":{"ack":{"additionalProperties":{"type":"string"},"type":"object","title":"Ack"}},"type":"object","required":["ack"],"title":"BecknAckMessage"},"app__api__v1__endpoints__browser_agent_credentials__CredentialListResponse":{"properties":{"credentials":{"items":{"$ref":"#/components/schemas/CredentialListItem"},"type":"array","title":"Credentials"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["credentials","count"],"title":"CredentialListResponse","description":"List of the caller's stored web credentials (Refs #6527)."},"app__api__v1__endpoints__browser_schedules__ScheduleCreate":{"properties":{"urls":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Urls"},"cron_expr":{"type":"string","minLength":1,"title":"Cron Expr"},"memory_type":{"type":"string","title":"Memory Type","default":"semantic"},"project_id":{"type":"string","minLength":1,"title":"Project Id"},"name":{"type":"string","maxLength":256,"minLength":1,"title":"Name"}},"type":"object","required":["urls","cron_expr","project_id","name"],"title":"ScheduleCreate"},"app__api__v1__endpoints__browser_schedules__ScheduleResponse":{"properties":{"schedule_id":{"type":"string","title":"Schedule Id"},"user_id":{"type":"string","title":"User Id"},"project_id":{"type":"string","title":"Project Id"},"name":{"type":"string","title":"Name"},"urls":{"items":{"type":"string"},"type":"array","title":"Urls"},"cron_expr":{"type":"string","title":"Cron Expr"},"memory_type":{"type":"string","title":"Memory Type"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["schedule_id","user_id","project_id","name","urls","cron_expr","memory_type","is_active","created_at","updated_at"],"title":"ScheduleResponse"},"app__api__v1__endpoints__casa_authorize_public__CasaAuthorizeRequest":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"task":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task"},"conversation":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Conversation"},"tool_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Params"},"tools_available":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tools Available"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"}},"type":"object","required":["tool_name"],"title":"CasaAuthorizeRequest"},"app__api__v1__endpoints__code_sessions__CodeSessionResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["session_id","status","created_at"],"title":"CodeSessionResponse"},"app__api__v1__endpoints__cody_context__EntityItem":{"properties":{"name":{"type":"string","title":"Name"},"entity_type":{"type":"string","title":"Entity Type"}},"type":"object","required":["name","entity_type"],"title":"EntityItem"},"app__api__v1__endpoints__comments__CommentCreate":{"properties":{"content_type":{"type":"string","title":"Content Type","description":"Type of content (e.g., 'video', 'article', 'tutorial', 'event')"},"content_id":{"type":"string","title":"Content Id","description":"ID of the content being commented on (string or UUID)"},"comment":{"type":"string","maxLength":5000,"minLength":1,"title":"Comment","description":"Comment text"}},"type":"object","required":["content_type","content_id","comment"],"title":"CommentCreate","description":"Schema for creating a comment","example":{"comment":"Great tutorial! Very helpful.","content_id":"53d03f79-17db-4147-92be-836bf861d233","content_type":"event"}},"app__api__v1__endpoints__comments__CommentResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Comment UUID"},"user_id":{"type":"string","title":"User Id","description":"User UUID"},"user_name":{"type":"string","title":"User Name","description":"User display name"},"user_avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Avatar","description":"User avatar URL"},"content_type":{"type":"string","title":"Content Type","description":"Content type"},"content_id":{"type":"string","title":"Content Id","description":"Content ID (string or UUID)"},"comment":{"type":"string","title":"Comment","description":"Comment text"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["id","user_id","user_name","content_type","content_id","comment","created_at"],"title":"CommentResponse","description":"Schema for comment response","example":{"comment":"Great tutorial! Very helpful.","content_id":123,"content_type":"video","created_at":"2025-11-24T10:30:00Z","id":"550e8400-e29b-41d4-a716-446655440000","user_avatar":"https://example.com/avatar.jpg","user_id":"650e8400-e29b-41d4-a716-446655440001","user_name":"John Doe"}},"app__api__v1__endpoints__community__messages__MessageResponse":{"properties":{"id":{"type":"string","title":"Id"},"thread_id":{"type":"string","title":"Thread Id"},"sender_id":{"type":"string","title":"Sender Id"},"body":{"type":"string","title":"Body"},"created_at":{"type":"string","title":"Created At"},"attachments":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Attachments"}},"type":"object","required":["id","thread_id","sender_id","body","created_at","attachments"],"title":"MessageResponse","description":"Message information"},"app__api__v1__endpoints__community__messages__SendMessageRequest":{"properties":{"thread_id":{"type":"string","format":"uuid","title":"Thread Id","description":"UUID of the message thread"},"body":{"type":"string","maxLength":10000,"minLength":1,"title":"Body","description":"Message content"},"attachments":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Attachments","description":"Optional list of attachments"}},"type":"object","required":["thread_id","body"],"title":"SendMessageRequest","description":"Request to send a new message"},"app__api__v1__endpoints__community__messages__UnreadCountResponse":{"properties":{"thread_id":{"type":"string","title":"Thread Id"},"unread_count":{"type":"integer","title":"Unread Count"}},"type":"object","required":["thread_id","unread_count"],"title":"UnreadCountResponse","description":"Unread message count"},"app__api__v1__endpoints__content_provider_analytics__ToolStat":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"query_count":{"type":"integer","title":"Query Count"}},"type":"object","required":["tool_name","query_count"],"title":"ToolStat"},"app__api__v1__endpoints__dashboard_aggregation__DashboardOverviewResponse":{"properties":{"total_projects":{"type":"integer","title":"Total Projects"},"active_projects":{"type":"integer","title":"Active Projects"},"total_api_calls":{"type":"integer","title":"Total Api Calls"},"api_calls_today":{"type":"integer","title":"Api Calls Today"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"credits_used_this_month":{"type":"integer","title":"Credits Used This Month"},"avg_response_time":{"type":"number","title":"Avg Response Time"},"storage_used_gb":{"type":"number","title":"Storage Used Gb"},"storage_limit_gb":{"type":"number","title":"Storage Limit Gb"},"recent_activity":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__dashboard_aggregation__RecentActivityItem"},"type":"array","title":"Recent Activity"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["total_projects","active_projects","total_api_calls","api_calls_today","credits_remaining","credits_used_this_month","avg_response_time","storage_used_gb","storage_limit_gb","recent_activity","updated_at"],"title":"DashboardOverviewResponse"},"app__api__v1__endpoints__dashboard_aggregation__RecentActivityItem":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"description":{"type":"string","title":"Description"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["id","type","description","timestamp"],"title":"RecentActivityItem"},"app__api__v1__endpoints__dedicated_deployments__BillingSummaryResponse":{"properties":{"total_cost_usd":{"type":"number","title":"Total Cost Usd"},"projected_monthly_usd":{"type":"number","title":"Projected Monthly Usd"},"currency":{"type":"string","title":"Currency","default":"usd"},"daily_entries":{"items":{"$ref":"#/components/schemas/BillingDailyEntry"},"type":"array","title":"Daily Entries"}},"type":"object","required":["total_cost_usd","projected_monthly_usd","daily_entries"],"title":"BillingSummaryResponse"},"app__api__v1__endpoints__dedicated_deployments__DeploymentListResponse":{"properties":{"deployments":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__dedicated_deployments__DeploymentResponse"},"type":"array","title":"Deployments"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["deployments","total"],"title":"DeploymentListResponse"},"app__api__v1__endpoints__dedicated_deployments__DeploymentResponse":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"name":{"type":"string","title":"Name"},"model_id":{"type":"string","title":"Model Id"},"gpu_type":{"type":"string","title":"Gpu Type"},"gpu_label":{"type":"string","title":"Gpu Label"},"region":{"type":"string","title":"Region"},"region_label":{"type":"string","title":"Region Label"},"replicas":{"type":"integer","title":"Replicas"},"status":{"type":"string","title":"Status"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"hourly_cost_usd":{"type":"number","title":"Hourly Cost Usd"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["deployment_id","name","model_id","gpu_type","gpu_label","region","region_label","replicas","status","endpoint_url","hourly_cost_usd","created_at"],"title":"DeploymentResponse"},"app__api__v1__endpoints__developer_earnings__BalanceResponse":{"properties":{"available":{"type":"integer","title":"Available"},"pending":{"type":"integer","title":"Pending"},"total":{"type":"integer","title":"Total"},"currency":{"type":"string","title":"Currency","default":"USD"}},"type":"object","required":["available","pending","total"],"title":"BalanceResponse","description":"Response for payout balance"},"app__api__v1__endpoints__developer_earnings__NotificationPreferences":{"properties":{"email_on_payout_sent":{"type":"boolean","title":"Email On Payout Sent"},"email_on_payout_paid":{"type":"boolean","title":"Email On Payout Paid"},"email_on_payout_failed":{"type":"boolean","title":"Email On Payout Failed"},"sms_on_payout_paid":{"type":"boolean","title":"Sms On Payout Paid"}},"type":"object","required":["email_on_payout_sent","email_on_payout_paid","email_on_payout_failed","sms_on_payout_paid"],"title":"NotificationPreferences","description":"Notification preferences"},"app__api__v1__endpoints__domains_public__DomainCheckResponse":{"properties":{"query":{"type":"string","title":"Query"},"configured":{"type":"boolean","title":"Configured"},"suggestions":{"items":{"$ref":"#/components/schemas/DomainSuggestion"},"type":"array","title":"Suggestions"},"egress_ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Egress Ip"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["query","configured","suggestions"],"title":"DomainCheckResponse"},"app__api__v1__endpoints__email_subscribe__SubscribeRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"source":{"type":"string","title":"Source","default":"website"},"first_name":{"type":"string","title":"First Name","default":""}},"type":"object","required":["email"],"title":"SubscribeRequest"},"app__api__v1__endpoints__emails__EmailResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"email_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Id"},"dev_mode":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dev Mode"}},"type":"object","required":["success","message"],"title":"EmailResponse","description":"Response model for email operations"},"app__api__v1__endpoints__governance_audit__ExportRequest":{"properties":{"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"},"framework":{"type":"string","title":"Framework","description":"SOC2, ISO27001, GDPR, HIPAA"}},"type":"object","required":["start_time","end_time","framework"],"title":"ExportRequest"},"app__api__v1__endpoints__governance_policies__EvaluateRequest":{"properties":{"workspace_id":{"type":"string","title":"Workspace Id"},"tool":{"type":"string","title":"Tool"},"target":{"type":"string","title":"Target","default":"*"},"capability":{"type":"string","title":"Capability","default":"*"},"args":{"additionalProperties":true,"type":"object","title":"Args"}},"type":"object","required":["workspace_id","tool"],"title":"EvaluateRequest"},"app__api__v1__endpoints__growth_metrics__ModelUsage":{"properties":{"model":{"type":"string","title":"Model"},"requests":{"type":"integer","title":"Requests"},"unique_users":{"type":"integer","title":"Unique Users"}},"type":"object","required":["model","requests","unique_users"],"title":"ModelUsage"},"app__api__v1__endpoints__inference_observability__LatencyPercentiles":{"properties":{"p50":{"type":"number","title":"P50"},"p95":{"type":"number","title":"P95"},"p99":{"type":"number","title":"P99"}},"type":"object","required":["p50","p95","p99"],"title":"LatencyPercentiles"},"app__api__v1__endpoints__intent_marketplace__BecknAckMessage":{"properties":{"ack":{"$ref":"#/components/schemas/BecknAck"}},"type":"object","required":["ack"],"title":"BecknAckMessage","description":"Beckn `message` envelope carrying only an ack."},"app__api__v1__endpoints__lake_analytics__ModelUsage":{"properties":{"model":{"type":"string","title":"Model"},"requests":{"type":"integer","title":"Requests"},"cost_credits":{"type":"number","title":"Cost Credits"}},"type":"object","required":["model","requests","cost_credits"],"title":"ModelUsage"},"app__api__v1__endpoints__lake_duckdb_query__LakeQueryRequest":{"properties":{"sql":{"type":"string","title":"Sql","description":"SQL query using read_parquet() for S3 paths"},"limit":{"type":"integer","maximum":10000,"minimum":1,"title":"Limit","description":"Max rows to return","default":100}},"type":"object","required":["sql"],"title":"LakeQueryRequest"},"app__api__v1__endpoints__lake_duckdb_query__LakeQueryResponse":{"properties":{"columns":{"items":{},"type":"array","title":"Columns"},"rows":{"items":{},"type":"array","title":"Rows"},"row_count":{"type":"integer","title":"Row Count"}},"type":"object","required":["columns","rows","row_count"],"title":"LakeQueryResponse"},"app__api__v1__endpoints__live_chat__ChatMessage":{"properties":{"id":{"type":"string","title":"Id"},"conversation_id":{"type":"string","title":"Conversation Id"},"sender_type":{"type":"string","title":"Sender Type"},"sender_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender Id"},"content":{"type":"string","title":"Content"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","conversation_id","sender_type","content","created_at"],"title":"ChatMessage"},"app__api__v1__endpoints__live_chat__SendMessageRequest":{"properties":{"content":{"type":"string","title":"Content"},"sender_type":{"type":"string","title":"Sender Type","default":"visitor"}},"type":"object","required":["content"],"title":"SendMessageRequest"},"app__api__v1__endpoints__live_chat__SendMessageResponse":{"properties":{"message_id":{"type":"string","title":"Message Id"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["message_id","created_at"],"title":"SendMessageResponse"},"app__api__v1__endpoints__live_chat__StartConversationRequest":{"properties":{"visitor_name":{"type":"string","title":"Visitor Name","default":"Visitor"},"visitor_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visitor Email"},"message":{"type":"string","title":"Message"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url"},"inbox_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inbox Token"}},"type":"object","required":["message"],"title":"StartConversationRequest"},"app__api__v1__endpoints__mcp_cost__CostEstimateResponse":{"properties":{"instance_id":{"type":"string","title":"Instance Id"},"tool_name":{"type":"string","title":"Tool Name"},"price_per_query":{"type":"number","title":"Price Per Query"},"currency":{"type":"string","title":"Currency"},"user_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"User Balance"},"can_afford":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Can Afford"}},"type":"object","required":["instance_id","tool_name","price_per_query","currency"],"title":"CostEstimateResponse","description":"Response for tool cost estimate"},"app__api__v1__endpoints__memory_traces__ToolStat":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"total_calls":{"type":"integer","title":"Total Calls"},"success_count":{"type":"integer","title":"Success Count"},"error_count":{"type":"integer","title":"Error Count"},"timeout_count":{"type":"integer","title":"Timeout Count"},"success_rate":{"type":"number","title":"Success Rate"},"avg_duration_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Duration Ms"},"min_duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Duration Ms"},"max_duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Duration Ms"}},"type":"object","required":["tool_name","total_calls","success_count","error_count","timeout_count","success_rate"],"title":"ToolStat"},"app__api__v1__endpoints__openclaw_status__OpenClawStatusResponse":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether bridge is connected to gateway"},"connection_state":{"type":"string","title":"Connection State","description":"Current connection state"},"gateway_url":{"type":"string","title":"Gateway Url","description":"WebSocket URL of OpenClaw Gateway"},"whatsapp_session":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Whatsapp Session","description":"Active WhatsApp session key"},"uptime_seconds":{"type":"integer","title":"Uptime Seconds","description":"Time since connection in seconds"},"last_command":{"anyOf":[{"$ref":"#/components/schemas/OpenClawCommand"},{"type":"null"}],"description":"Last command executed"},"command_history":{"anyOf":[{"items":{"$ref":"#/components/schemas/OpenClawCommand"},"type":"array"},{"type":"null"}],"title":"Command History","description":"Last 10 commands executed (only if include_history=true)"},"agents":{"anyOf":[{"items":{"$ref":"#/components/schemas/AgentHealthEntry"},"type":"array"},{"type":"null"}],"title":"Agents","description":"Health status of all 12 agents (only if include_agents=true)"},"agent_summary":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Agent Summary","description":"Count of agents by status (e.g., {healthy: 10, unhealthy: 1, dead: 1})"}},"type":"object","required":["connected","connection_state","gateway_url","uptime_seconds"],"title":"OpenClawStatusResponse","description":"OpenClaw Gateway status response"},"app__api__v1__endpoints__orchestration__AgentStatusResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Unique agent identifier"},"issue_number":{"type":"integer","title":"Issue Number","description":"GitHub issue number"},"task_description":{"type":"string","title":"Task Description","description":"Task description"},"state":{"type":"string","title":"State","description":"Current agent lifecycle state"},"workflow_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow State","description":"Workflow orchestration state"},"spawned_at":{"type":"string","title":"Spawned At","description":"ISO timestamp when agent was spawned"},"ready_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ready At","description":"ISO timestamp when agent became ready"},"started_execution_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started Execution At","description":"ISO timestamp when execution started"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At","description":"ISO timestamp when agent completed"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if agent failed"},"retry_count":{"type":"integer","title":"Retry Count","description":"Number of retry attempts","default":0}},"type":"object","required":["agent_id","issue_number","task_description","state","spawned_at"],"title":"AgentStatusResponse","description":"Individual agent status"},"app__api__v1__endpoints__orchestration__OpenClawStatusResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Connection status: 'connected', 'disconnected', 'unknown'"},"connected":{"type":"boolean","title":"Connected","description":"Whether gateway is connected"},"last_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Seen","description":"Last time gateway was seen"},"message_count":{"type":"integer","title":"Message Count","description":"Total messages processed","default":0},"last_message_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Message At","description":"Timestamp of last message"},"error_count":{"type":"integer","title":"Error Count","description":"Number of errors in current period","default":0},"recent_errors":{"items":{"type":"string"},"type":"array","title":"Recent Errors","description":"Recent error messages"},"average_latency_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Latency Ms","description":"Average WebSocket latency"}},"type":"object","required":["status","connected"],"title":"OpenClawStatusResponse","description":"OpenClaw Gateway status"},"app__api__v1__endpoints__org_provisioning__ProvisionResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"api_key":{"type":"string","title":"Api Key"},"mcp":{"additionalProperties":true,"type":"object","title":"Mcp"},"database":{"additionalProperties":true,"type":"object","title":"Database"}},"type":"object","required":["project_id","api_key","mcp","database"],"title":"ProvisionResponse"},"app__api__v1__endpoints__project_artifacts__ArtifactResponse":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Owning project ID"},"artifact_type":{"type":"string","title":"Artifact Type","description":"One of: prd, data-model, backlog"},"content":{"additionalProperties":true,"type":"object","title":"Content","description":"Stored artifact payload"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the artifact was first stored"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"When the artifact was last overwritten"}},"type":"object","required":["project_id","artifact_type","content","created_at","updated_at"],"title":"ArtifactResponse","description":"Stored artifact returned by GET and PUT."},"app__api__v1__endpoints__security_scan__ScanSummary":{"properties":{"critical":{"type":"integer","title":"Critical","default":0},"high":{"type":"integer","title":"High","default":0},"medium":{"type":"integer","title":"Medium","default":0},"low":{"type":"integer","title":"Low","default":0}},"type":"object","title":"ScanSummary"},"app__api__v1__endpoints__serviceos_public__ChatMessage":{"properties":{"id":{"type":"string","title":"Id"},"sender_type":{"type":"string","title":"Sender Type"},"content":{"type":"string","title":"Content"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","sender_type","content"],"title":"ChatMessage"},"app__api__v1__endpoints__serviceos_public__SendMessageRequest":{"properties":{"content":{"type":"string","maxLength":5000,"minLength":1,"title":"Content"}},"type":"object","required":["content"],"title":"SendMessageRequest"},"app__api__v1__endpoints__serviceos_public__SendMessageResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"conversation_id":{"type":"string","title":"Conversation Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["ok","conversation_id","message"],"title":"SendMessageResponse"},"app__api__v1__endpoints__serviceos_public__StartConversationRequest":{"properties":{"inbox_token":{"type":"string","title":"Inbox Token","description":"Inbox token from customer's ServiceOS setup"},"visitor_name":{"type":"string","maxLength":255,"title":"Visitor Name","default":"Visitor"},"visitor_email":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Visitor Email"},"message":{"type":"string","maxLength":5000,"minLength":1,"title":"Message"},"page_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Page Url"}},"type":"object","required":["inbox_token","message"],"title":"StartConversationRequest"},"app__api__v1__endpoints__session_compatibility__MemorySearchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/app__api__v1__endpoints__session_compatibility__MemorySearchResult"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"},"query":{"type":"string","title":"Query"}},"type":"object","required":["results","total","query"],"title":"MemorySearchResponse"},"app__api__v1__endpoints__session_compatibility__MemorySearchResult":{"properties":{"id":{"type":"string","title":"Id"},"content":{"type":"string","title":"Content"},"role":{"type":"string","title":"Role"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"},"relevance_score":{"type":"number","title":"Relevance Score"}},"type":"object","required":["id","content","role","relevance_score"],"title":"MemorySearchResult"},"app__api__v1__endpoints__social_analytics__ExportRequest":{"properties":{"format":{"type":"string","pattern":"^(pdf|csv)$","title":"Format"},"from":{"type":"string","title":"From"},"to":{"type":"string","title":"To"}},"type":"object","required":["format","from","to"],"title":"ExportRequest"},"app__api__v1__endpoints__storage_usage__StorageUsageResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"days":{"type":"integer","title":"Days"},"current_total_gb":{"type":"number","title":"Current Total Gb","description":"Latest total storage in GB"},"cost_estimate_usd":{"type":"number","title":"Cost Estimate Usd","description":"Estimated monthly storage cost in USD"},"plan":{"type":"string","title":"Plan"},"included_gb":{"type":"number","title":"Included Gb"},"overage_gb":{"type":"number","title":"Overage Gb"},"daily":{"items":{"$ref":"#/components/schemas/DailyStorageEntry"},"type":"array","title":"Daily"}},"type":"object","required":["project_id","days","current_total_gb","cost_estimate_usd","plan","included_gb","overage_gb","daily"],"title":"StorageUsageResponse"},"app__api__v1__endpoints__stripe_webhooks__WebhookTestResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"webhook_secret_configured":{"type":"boolean","title":"Webhook Secret Configured"},"stripe_api_key_configured":{"type":"boolean","title":"Stripe Api Key Configured"}},"type":"object","required":["success","message","webhook_secret_configured","stripe_api_key_configured"],"title":"WebhookTestResponse"},"app__api__v1__endpoints__transactions__TransactionListResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/TransactionListData"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","data","message"],"title":"TransactionListResponse"},"app__api__v1__endpoints__vpc_inference__TelemetryEvent":{"properties":{"license_key":{"type":"string","maxLength":64,"minLength":4,"title":"License Key"},"deployment_id":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Deployment Id"},"period_start":{"type":"string","format":"date-time","title":"Period Start"},"period_end":{"type":"string","format":"date-time","title":"Period End"},"input_tokens":{"type":"integer","minimum":0,"title":"Input Tokens","default":0},"output_tokens":{"type":"integer","minimum":0,"title":"Output Tokens","default":0},"request_count":{"type":"integer","minimum":0,"title":"Request Count","default":0},"model":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Model"},"hostname":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Hostname"}},"type":"object","required":["license_key","period_start","period_end"],"title":"TelemetryEvent"},"app__api__v1__endpoints__webhook_registration__WebhookResponse":{"properties":{"webhook_id":{"type":"string","title":"Webhook Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["webhook_id","url","events","is_active","created_at"],"title":"WebhookResponse"},"app__api__v1__endpoints__webhook_registration__WebhookTestResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Status Code"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"WebhookTestResponse"},"app__api__v1__endpoints__workspace_admin__ResetPasswordRequest":{"properties":{"password":{"anyOf":[{"type":"string","maxLength":100,"minLength":8},{"type":"null"}],"title":"Password"},"change_at_next_login":{"type":"boolean","title":"Change At Next Login","default":true}},"type":"object","title":"ResetPasswordRequest"},"app__api__v1__endpoints__x402_gateway__EarningsBreakdownResponse":{"properties":{"developer_id":{"type":"string","title":"Developer Id"},"period_start":{"type":"string","title":"Period Start"},"period_end":{"type":"string","title":"Period End"},"grand_total_cents":{"type":"integer","title":"Grand Total Cents"},"breakdown":{"additionalProperties":{"$ref":"#/components/schemas/EarningsBreakdownEntry"},"type":"object","title":"Breakdown"}},"type":"object","required":["developer_id","period_start","period_end","grand_total_cents","breakdown"],"title":"EarningsBreakdownResponse","description":"Combined earnings breakdown across all revenue sources.\n\nMirrors X402EarningsService.get_combined_earnings_breakdown(), scoped to\n`developer_id = current_user.id`. `breakdown` is keyed by the DB's\n`service_type` column, so new revenue streams must flow through without a\ncode change — that is modelled as a Dict value type (open keys, closed\nleaf shape), not via `extra=\"allow\"` on the envelope."},"app__api__v1__endpoints__x402_subscriptions__SubscribeRequest":{"properties":{"plan_id":{"type":"string","title":"Plan Id","description":"hobbyist | pro | business | enterprise | cody_vcto"},"billing_mode":{"type":"string","title":"Billing Mode","description":"'prepaid' (v1) or 'recurring'","default":"prepaid"},"wallet_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wallet Address","description":"The paying agent's wallet"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"Attach to an existing account (optional)"},"payment_proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payment Proof","description":"x402 payment proof {tx_hash, amount, asset, network}. Omit to get the 402 challenge."}},"type":"object","required":["plan_id"],"title":"SubscribeRequest"},"app__api__v1__endpoints__x402_wallets__TransactionResponse":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"amount_usd":{"type":"number","title":"Amount Usd"},"balance_after_usd":{"type":"number","title":"Balance After Usd"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","type","amount_usd","balance_after_usd","status"],"title":"TransactionResponse"},"app__api__v1__endpoints__x402_wallets__WalletResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"agent_id":{"type":"string","title":"Agent Id"},"balance_usd":{"type":"number","title":"Balance Usd"},"spending_limit_usd":{"type":"number","title":"Spending Limit Usd"},"single_payment_limit_usd":{"type":"number","title":"Single Payment Limit Usd"},"period":{"type":"string","title":"Period"},"current_period_spend_usd":{"type":"number","title":"Current Period Spend Usd"},"total_funded_usd":{"type":"number","title":"Total Funded Usd"},"total_spent_usd":{"type":"number","title":"Total Spent Usd"},"status":{"type":"string","title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","user_id","agent_id","balance_usd","spending_limit_usd","single_payment_limit_usd","period","current_period_spend_usd","total_funded_usd","total_spent_usd","status"],"title":"WalletResponse"},"app__api__v1__endpoints__zerodb_compatibility__DeleteVectorResponse":{"properties":{"message":{"type":"string","title":"Message"},"vector_id":{"type":"string","title":"Vector Id"}},"type":"object","required":["message","vector_id"],"title":"DeleteVectorResponse"},"app__api__v1__endpoints__zeromemory__ProfileResponse":{"properties":{"entity_id":{"type":"string","title":"Entity Id"},"preferences":{"items":{},"type":"array","title":"Preferences"},"behaviors":{"items":{},"type":"array","title":"Behaviors"},"facts":{"items":{},"type":"array","title":"Facts"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"memory_count":{"type":"integer","title":"Memory Count"},"last_interaction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Interaction"}},"type":"object","required":["entity_id","preferences","behaviors","facts","summary","memory_count","last_interaction"],"title":"ProfileResponse"},"app__api__v1__ledger__integrations__ConnectRequest":{"properties":{"api_key":{"type":"string","minLength":1,"title":"Api Key"},"environment":{"type":"string","title":"Environment","default":"production"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"}},"type":"object","required":["api_key"],"title":"ConnectRequest"},"app__api__v1__ledger__kpis__TrendPoint":{"properties":{"period_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Id"},"period_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Label"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start"},"metric_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Metric Value"}},"type":"object","title":"TrendPoint"},"app__api__v1__ledger__mercury__UnlinkRequest":{"properties":{"confirm":{"type":"boolean","title":"Confirm","default":false}},"type":"object","title":"UnlinkRequest","description":"Mirrors QuickBooks' UnlinkRequest shape exactly (Refs #7617)."},"app__api__v1__ledger__payment_methods__AddPaymentMethodResponse":{"properties":{"payment_method":{"$ref":"#/components/schemas/PaymentMethod"}},"type":"object","required":["payment_method"],"title":"AddPaymentMethodResponse"},"app__api__v1__ledger__profile__ProfileResponse":{"properties":{"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","title":"ProfileResponse"},"app__api__v1__ledger__quickbooks__ConnectRequest":{"properties":{"provider":{"type":"string","const":"quickbooks","title":"Provider","default":"quickbooks"}},"type":"object","title":"ConnectRequest","description":"Start the OAuth flow. QBO is the functional MVP provider."},"app__api__v1__ledger__quickbooks__StatusResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"},"realm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Realm Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"last_sync":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sync"}},"type":"object","required":["connected"],"title":"StatusResponse"},"app__api__v1__ledger__quickbooks__UnlinkRequest":{"properties":{"confirm":{"type":"boolean","title":"Confirm","default":false}},"type":"object","title":"UnlinkRequest"},"app__api__v1__ledger__storefront__CheckoutRequest":{"properties":{"product_key":{"type":"string","maxLength":64,"minLength":1,"title":"Product Key","description":"Catalog product key, e.g. 'taxpass'. Never a price."}},"type":"object","required":["product_key"],"title":"CheckoutRequest","description":"Body for buying one storefront product.\n\n``product_key`` is the ONLY field, deliberately. There is no amount, no\nprice id, no Stripe customer id and no payment-method id: every one of\nthose is resolved server-side. This mirrors the contract #7637\nestablished for ``POST /ledger/payment-methods``, where accepting a\ncaller-supplied Stripe id was the vulnerability.\n\nPydantic's default ``extra`` behaviour (ignore) applies, consistent with\nevery other model in the Ledger routers — a client sending an ``amount``\nfield is not rejected, it simply cannot influence anything."},"app__api__v1__ledger__storefront__CheckoutResponse":{"properties":{"product_key":{"type":"string","title":"Product Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"billing_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Type"},"amount_charged_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Charged Cents"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"stripe_subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Subscription Id"},"stripe_payment_intent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Payment Intent Id"},"current_period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Period End"}},"type":"object","required":["product_key"],"title":"CheckoutResponse","description":"Result of a completed storefront purchase (#7667)."},"app__api__v1__ledger__stripe_revenue__UnlinkRequest":{"properties":{"confirm":{"type":"boolean","title":"Confirm","default":false}},"type":"object","title":"UnlinkRequest","description":"Mirrors QuickBooks' UnlinkRequest shape exactly (Refs #7617)."},"app__api__v1__tools__analytics__AnalyticsSummaryResponse":{"properties":{"total_calls":{"type":"integer","title":"Total Calls"},"success_rate":{"type":"number","title":"Success Rate"},"avg_execution_time_ms":{"type":"number","title":"Avg Execution Time Ms"},"total_errors":{"type":"integer","title":"Total Errors"},"period":{"anyOf":[{"$ref":"#/components/schemas/AnalyticsPeriod"},{"type":"null"}]},"filters":{"anyOf":[{"$ref":"#/components/schemas/AnalyticsFilters"},{"type":"null"}]}},"type":"object","required":["total_calls","success_rate","avg_execution_time_ms","total_errors"],"title":"AnalyticsSummaryResponse","description":"Aggregated tool-usage statistics for /summary."},"app__api__videos__ChapterCreate":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Chapter title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Chapter description"},"start_time":{"type":"integer","minimum":0,"title":"Start Time","description":"Start time in seconds"},"end_time":{"type":"integer","exclusiveMinimum":0,"title":"End Time","description":"End time in seconds"},"order":{"type":"integer","minimum":0,"title":"Order","description":"Chapter order"}},"type":"object","required":["title","start_time","end_time","order"],"title":"ChapterCreate","description":"Chapter creation request"},"app__api__videos__ChapterResponse":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Chapter title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Chapter description"},"start_time":{"type":"integer","minimum":0,"title":"Start Time","description":"Start time in seconds"},"end_time":{"type":"integer","exclusiveMinimum":0,"title":"End Time","description":"End time in seconds"},"order":{"type":"integer","minimum":0,"title":"Order","description":"Chapter order"},"chapter_id":{"type":"string","format":"uuid","title":"Chapter Id"},"video_id":{"type":"string","format":"uuid","title":"Video Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["title","start_time","end_time","order","chapter_id","video_id","created_at","updated_at"],"title":"ChapterResponse","description":"Chapter response"},"app__api__videos__ChapterUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"start_time":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Start Time"},"end_time":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}],"title":"End Time"},"order":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Order"}},"type":"object","title":"ChapterUpdate","description":"Chapter update request"},"app__api__videos__VideoResponse":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Video title"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Video description"},"video_type":{"$ref":"#/components/schemas/VideoType","description":"Type of video content"},"duration":{"type":"integer","exclusiveMinimum":0,"title":"Duration","description":"Video duration in seconds"},"video_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Video Metadata","description":"Additional metadata"},"video_id":{"type":"string","format":"uuid","title":"Video Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"video_url":{"type":"string","title":"Video Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"status":{"$ref":"#/components/schemas/VideoStatus"},"view_count":{"type":"integer","title":"View Count"},"tech_stack":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tech Stack"},"project_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Url"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["title","video_type","duration","video_id","user_id","video_url","thumbnail_url","status","view_count","created_at","updated_at"],"title":"VideoResponse","description":"Video response"},"app__models__checkpoint__CheckpointCreateResponse":{"properties":{"message":{"type":"string","title":"Message","default":"Checkpoint created successfully."},"checkpoint":{"$ref":"#/components/schemas/Checkpoint"}},"type":"object","required":["checkpoint"],"title":"CheckpointCreateResponse"},"app__models__checkpoint__CheckpointListResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"checkpoints":{"items":{"$ref":"#/components/schemas/CheckpointListItem"},"type":"array","title":"Checkpoints"}},"type":"object","required":["project_id","checkpoints"],"title":"CheckpointListResponse"},"app__models__checkpoint__CheckpointRestoreResponse":{"properties":{"message":{"type":"string","title":"Message","default":"Checkpoint restored successfully."},"restored_path":{"type":"string","title":"Restored Path"}},"type":"object","required":["restored_path"],"title":"CheckpointRestoreResponse"},"app__models__content_report__ActionType":{"type":"string","enum":["APPROVE","REMOVE_CONTENT","WARN_USER","BAN_USER","REJECT_REPORT"],"title":"ActionType","description":"Types of moderation actions"},"app__models__invoice__InvoiceListResponse":{"properties":{"invoices":{"items":{"$ref":"#/components/schemas/app__models__invoice__InvoiceResponse"},"type":"array","title":"Invoices"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["invoices","total","skip","limit"],"title":"InvoiceListResponse","description":"Schema for listing invoices","example":{"invoices":[],"limit":20,"skip":0,"total":0}},"app__models__invoice__InvoiceResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Invoice ID"},"number":{"type":"string","title":"Number","description":"Invoice number (INV-YYYY-NNNN)"},"user_id":{"type":"string","title":"User Id","description":"Customer user ID"},"subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Id","description":"Related subscription ID"},"stripe_invoice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Invoice Id","description":"Stripe invoice ID (for payments)"},"amount_total":{"type":"integer","title":"Amount Total","description":"Total amount in cents"},"amount_paid":{"type":"integer","title":"Amount Paid","description":"Amount paid in cents","default":0},"currency":{"type":"string","title":"Currency","description":"Currency code"},"status":{"$ref":"#/components/schemas/InvoiceStatus","description":"Invoice status"},"period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period Start","description":"Billing period start"},"period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period End","description":"Billing period end"},"due_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due Date","description":"Payment due date"},"paid_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Paid At","description":"Payment date"},"invoice_pdf":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Pdf","description":"PDF URL"},"hosted_invoice_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hosted Invoice Url","description":"Public invoice view URL"},"line_items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Line Items","description":"Line items"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Custom metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["id","number","user_id","amount_total","currency","status","line_items","created_at"],"title":"InvoiceResponse","description":"Schema for invoice API responses","example":{"amount_paid":0,"amount_total":9900,"created_at":"2025-11-11T10:00:00Z","currency":"USD","due_date":"2025-12-01T00:00:00Z","id":"550e8400-e29b-41d4-a716-446655440000","line_items":[{"amount":9900,"description":"Professional Plan - Monthly","quantity":1,"unit_price":9900}],"metadata":{},"number":"INV-2025-0001","status":"draft","user_id":"660e8400-e29b-41d4-a716-446655440000"}},"app__schemas__active_projects__ActivityFeedResponse":{"properties":{"activities":{"items":{"$ref":"#/components/schemas/app__schemas__active_projects__ActivityItem"},"type":"array","title":"Activities"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["activities","total"],"title":"ActivityFeedResponse","description":"Response for activity feed"},"app__schemas__active_projects__ActivityItem":{"properties":{"id":{"type":"string","title":"Id"},"project_id":{"type":"string","title":"Project Id"},"project_name":{"type":"string","title":"Project Name"},"activity_type":{"type":"string","title":"Activity Type"},"message":{"type":"string","title":"Message"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"emoji":{"type":"string","title":"Emoji","default":""}},"type":"object","required":["id","project_id","project_name","activity_type","message","timestamp"],"title":"ActivityItem","description":"Single activity item in the feed"},"app__schemas__active_projects__QuickStats":{"properties":{"issues_total":{"type":"integer","title":"Issues Total","default":0},"issues_completed":{"type":"integer","title":"Issues Completed","default":0},"prs_created":{"type":"integer","title":"Prs Created","default":0},"prs_merged":{"type":"integer","title":"Prs Merged","default":0},"sprints_total":{"type":"integer","title":"Sprints Total","default":0},"sprints_completed":{"type":"integer","title":"Sprints Completed","default":0},"test_coverage":{"type":"number","maximum":100,"minimum":0,"title":"Test Coverage","default":0},"quality_score":{"type":"number","maximum":100,"minimum":0,"title":"Quality Score","default":0}},"type":"object","title":"QuickStats","description":"Quick statistics for a project"},"app__schemas__admin__agent_swarm__ActivateRulesFileResponse":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"status":{"type":"string","title":"Status"},"is_active":{"type":"boolean","title":"Is Active"},"activated_at":{"type":"string","title":"Activated At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","filename","status","is_active","activated_at","message"],"title":"ActivateRulesFileResponse"},"app__schemas__admin__agent_swarm__DeleteRulesFileResponse":{"properties":{"message":{"type":"string","title":"Message"},"id":{"type":"string","title":"Id"},"was_active":{"type":"boolean","title":"Was Active"},"deleted_at":{"type":"string","title":"Deleted At"}},"type":"object","required":["message","id","was_active","deleted_at"],"title":"DeleteRulesFileResponse"},"app__schemas__admin__alerts__AcknowledgeAlertResponse":{"properties":{"alert_id":{"type":"string","format":"uuid","title":"Alert Id"},"status":{"type":"string","title":"Status"},"acknowledged_at":{"type":"string","format":"date-time","title":"Acknowledged At"},"acknowledged_by":{"type":"string","format":"uuid","title":"Acknowledged By"},"acknowledgment_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Acknowledgment Note"},"response_time_seconds":{"type":"integer","title":"Response Time Seconds"}},"type":"object","required":["alert_id","status","acknowledged_at","acknowledged_by","acknowledgment_note","response_time_seconds"],"title":"AcknowledgeAlertResponse","description":"Schema for acknowledge alert response","example":{"acknowledged_at":"2025-01-07T12:10:00Z","acknowledged_by":"450e8400-e29b-41d4-a716-446655440002","acknowledgment_note":"Investigating email service issues.","alert_id":"650e8400-e29b-41d4-a716-446655440001","response_time_seconds":300,"status":"acknowledged"}},"app__schemas__admin__alerts__ResolveAlertResponse":{"properties":{"alert_id":{"type":"string","format":"uuid","title":"Alert Id"},"status":{"type":"string","title":"Status"},"resolved_at":{"type":"string","format":"date-time","title":"Resolved At"},"resolved_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Resolved By"},"resolution_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Note"},"auto_resolved":{"type":"boolean","title":"Auto Resolved"}},"type":"object","required":["alert_id","status","resolved_at","auto_resolved"],"title":"ResolveAlertResponse","description":"Schema for resolve alert response (Refs #8270)","example":{"alert_id":"650e8400-e29b-41d4-a716-446655440001","auto_resolved":false,"resolution_note":"SMTP provider recovered.","resolved_at":"2025-01-07T12:40:00Z","resolved_by":"450e8400-e29b-41d4-a716-446655440002","status":"resolved"}},"app__schemas__admin__analytics_compatibility__AnalyticsUsageResponse":{"properties":{"period":{"type":"string","title":"Period"},"total_users":{"type":"integer","title":"Total Users"},"active_users":{"type":"integer","title":"Active Users"},"total_organizations":{"type":"integer","title":"Total Organizations"},"total_projects":{"type":"integer","title":"Total Projects"},"api_calls_total":{"type":"integer","title":"Api Calls Total"},"api_calls_today":{"type":"integer","title":"Api Calls Today"},"top_endpoints":{"items":{"$ref":"#/components/schemas/TopEndpointEntry"},"type":"array","title":"Top Endpoints"},"user_growth":{"items":{"$ref":"#/components/schemas/UserGrowthPoint"},"type":"array","title":"User Growth"}},"type":"object","required":["period","total_users","active_users","total_organizations","total_projects","api_calls_total","api_calls_today","top_endpoints","user_growth"],"title":"AnalyticsUsageResponse"},"app__schemas__admin__audit__AuditLogEntry":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"title":"User Id"},"username":{"type":"string","title":"Username"},"action":{"type":"string","title":"Action"},"resource_type":{"type":"string","title":"Resource Type"},"resource_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Id"},"description":{"type":"string","title":"Description"},"ip_address":{"type":"string","title":"Ip Address"},"user_agent":{"type":"string","title":"User Agent"},"timestamp":{"type":"string","title":"Timestamp"},"severity":{"type":"string","title":"Severity"},"compliance_relevant":{"type":"boolean","title":"Compliance Relevant"}},"type":"object","required":["id","user_id","username","action","resource_type","description","ip_address","user_agent","timestamp","severity","compliance_relevant"],"title":"AuditLogEntry"},"app__schemas__admin__audit__GenerateComplianceReportResponse":{"properties":{"report_id":{"type":"string","title":"Report Id"},"standard":{"type":"string","title":"Standard"},"period":{"$ref":"#/components/schemas/CompliancePeriod"},"generated_by":{"$ref":"#/components/schemas/ComplianceGeneratedBy"},"controls_assessment":{"items":{"$ref":"#/components/schemas/ComplianceControlAssessment"},"type":"array","title":"Controls Assessment"},"audit_coverage":{"$ref":"#/components/schemas/ComplianceAuditCoverage"},"security_metrics":{"$ref":"#/components/schemas/ComplianceSecurityMetrics"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"attestation":{"$ref":"#/components/schemas/ComplianceAttestation"}},"type":"object","required":["report_id","standard","period","generated_by","controls_assessment","audit_coverage","security_metrics","recommendations","attestation"],"title":"GenerateComplianceReportResponse"},"app__schemas__admin__audit__LogAuditEventResponse":{"properties":{"message":{"type":"string","title":"Message"},"audit_id":{"title":"Audit Id"}},"type":"object","required":["message","audit_id"],"title":"LogAuditEventResponse"},"app__schemas__admin__billing_simple__BillingInfoResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success"],"title":"BillingInfoResponse","description":"`data` is typed as Dict[str, Any] rather than a strict nested model:\nseveral of its fields (payment_method, default_payment_method,\nbilling_address, tax_id, next_invoice_date) are UNCONDITIONALLY\n`None` today (hardcoded, not code-branch-dependent) and must keep\nserializing as explicit `null` — nesting a strict BaseModel under\nresponse_model_exclude_none=True would incorrectly strip those\nalways-present null fields, which do not behave the same as the\ngenuinely-conditional outer `data`/`error` presence this\nexclude_none is meant to preserve."},"app__schemas__admin__caching__TrendPoint":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"value":{"type":"number","title":"Value"}},"type":"object","required":["timestamp","value"],"title":"TrendPoint"},"app__schemas__admin__comprehensive_evaluation__EvaluationHistoryItem":{"properties":{},"additionalProperties":true,"type":"object","title":"EvaluationHistoryItem","description":"One entry of GET /history -- currently always an empty list in\nthe live implementation (cache-based history is a documented\nnot-yet-implemented stub), modeled as an open passthrough for when\nit is wired to real data."},"app__schemas__admin__comprehensive_evaluation__EvaluationResultsResponse":{"properties":{"evaluation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evaluation Id"},"integrated_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Integrated Score"},"quality_grade":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality Grade"},"evaluation_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evaluation Summary"},"recommendations":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Recommendations"},"quality_components":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quality Components"},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Seconds"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"additionalProperties":true,"type":"object","title":"EvaluationResultsResponse","description":"Response for GET /results/{evaluation_id}.\n\n`include_detailed=true` returns the full underlying results dict\nfrom `evaluation_service.get_evaluation_results()` verbatim (owned\nby QualityEvaluationIntegration, not this router) -- modeled as an\nopen passthrough so those extra keys still serialize unchanged.\nThe `include_detailed=false` (default) branch has the fixed summary\nshape above; both share this same response_model since FastAPI\nvalidates one declared model per route."},"app__schemas__admin__credits__CreditTransactionItem":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"user_email":{"type":"string","title":"User Email"},"user_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Name"},"amount":{"type":"number","title":"Amount"},"transaction_type":{"type":"string","title":"Transaction Type"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","user_id","user_email","amount","transaction_type","created_at"],"title":"CreditTransactionItem"},"app__schemas__admin__credits__CreditTransactionsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/CreditTransactionsListData"}},"type":"object","required":["success","data"],"title":"CreditTransactionsResponse","description":"Response for GET /admin/credits/transactions."},"app__schemas__admin__database__DatabaseMetricsResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"performance":{"additionalProperties":true,"type":"object","title":"Performance"},"storage":{"additionalProperties":true,"type":"object","title":"Storage"},"cache":{"additionalProperties":true,"type":"object","title":"Cache"}},"type":"object","required":["timestamp","performance","storage","cache"],"title":"DatabaseMetricsResponse"},"app__schemas__admin__enterprise_security__GenerateComplianceReportResponse":{"properties":{"report_id":{"type":"string","title":"Report Id"},"generated_at":{"type":"string","title":"Generated At"},"period":{"$ref":"#/components/schemas/ComplianceReportPeriod"},"frameworks":{"additionalProperties":{"$ref":"#/components/schemas/ComplianceFrameworkReport"},"type":"object","title":"Frameworks"},"summary":{"$ref":"#/components/schemas/ComplianceReportSummary"}},"type":"object","required":["report_id","generated_at","period","frameworks","summary"],"title":"GenerateComplianceReportResponse"},"app__schemas__admin__enterprise_security__LogAuditEventResponse":{"properties":{"message":{"type":"string","title":"Message"},"event_id":{"type":"string","title":"Event Id"},"logged_at":{"type":"string","title":"Logged At"}},"type":"object","required":["message","event_id","logged_at"],"title":"LogAuditEventResponse"},"app__schemas__admin__evaluation__EvaluationHistoryItem":{"properties":{},"additionalProperties":true,"type":"object","title":"EvaluationHistoryItem","description":"One entry of GET /history -- real shape is whatever\nEvaluationPipeline.get_evaluation_history() returns per-record."},"app__schemas__admin__evaluation__EvaluationResultsResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"EvaluationResultsResponse","description":"Response for GET /code/evaluate/{evaluation_id}/results.\n\nShape varies by `format_type` (json/summary/detailed), each coming\nfrom a different pipeline method -- modeled as an open dict."},"app__schemas__admin__evaluation__EvaluationStatusResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"EvaluationStatusResponse","description":"Response for GET /code/evaluate/{evaluation_id}/status.\n\nReal shape is whatever EvaluationPipeline.get_evaluation_status()\nreturns -- an evaluation-status dict from the pipeline's own\ntracking store. Modeled loosely (Dict passthrough) since the\npipeline's internal shape is not owned by this endpoint module."},"app__schemas__admin__github_settings__GitHubConnectionStatusResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"github_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Username"},"last_validated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Validated"},"scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scopes"},"private_repos_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Private Repos Enabled"}},"type":"object","required":["connected"],"title":"GitHubConnectionStatusResponse","description":"Response for GET /connection-status.\n\nUse with response_model_exclude_none=True: the \"not connected\"\nbranches only ever set `connected` + `message`, never the\nconnected-only fields below."},"app__schemas__admin__help_documentation__SubmitFeedbackResponse":{"properties":{"feedback_id":{"type":"string","title":"Feedback Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"feedback":{"additionalProperties":true,"type":"object","title":"Feedback"}},"type":"object","required":["feedback_id","status","message","feedback"],"title":"SubmitFeedbackResponse","description":"Response for POST /help-documentation/feedback."},"app__schemas__admin__langflow_templates__ListTemplatesResponse":{"properties":{"templates":{"items":{"$ref":"#/components/schemas/TemplateListEntry"},"type":"array","title":"Templates"},"total_count":{"type":"integer","title":"Total Count"},"available_types":{"items":{"type":"string"},"type":"array","title":"Available Types"},"available_components":{"items":{"type":"string"},"type":"array","title":"Available Components"}},"type":"object","required":["templates","total_count","available_types","available_components"],"title":"ListTemplatesResponse","description":"Response for GET /langflow-templates/templates."},"app__schemas__admin__management__EndpointUsage":{"properties":{"endpoint":{"type":"string","title":"Endpoint"},"calls":{"type":"integer","title":"Calls"},"avg_response_ms":{"type":"number","title":"Avg Response Ms"}},"type":"object","required":["endpoint","calls","avg_response_ms"],"title":"EndpointUsage","description":"Usage statistics for an endpoint"},"app__schemas__admin__management__SystemHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"database":{"$ref":"#/components/schemas/DatabaseHealthInfo"},"cache":{"$ref":"#/components/schemas/CacheHealthInfo"},"api_health":{"$ref":"#/components/schemas/APIHealthInfo"},"services":{"$ref":"#/components/schemas/ServicesHealthInfo"}},"type":"object","required":["status","timestamp","database","cache","api_health","services"],"title":"SystemHealthResponse","description":"Comprehensive system health status"},"app__schemas__admin__monitoring_alerts__MonitoringDashboardResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"system_health":{"$ref":"#/components/schemas/SystemHealthOverview"},"performance_metrics":{"$ref":"#/components/schemas/CurrentPerformanceMetrics"},"active_alerts":{"items":{"$ref":"#/components/schemas/ActiveAlert"},"type":"array","title":"Active Alerts"},"recent_incidents":{"items":{"$ref":"#/components/schemas/RecentIncident"},"type":"array","title":"Recent Incidents"},"monitoring_status":{"$ref":"#/components/schemas/MonitoringServicesStatus"},"uptime_statistics":{"$ref":"#/components/schemas/UptimeStatistics"},"capacity_overview":{"$ref":"#/components/schemas/CapacityOverview"},"simulated_sections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Simulated Sections","description":"Keys in this response that are static fixtures rather than live readings. Refs #8270."}},"type":"object","required":["timestamp","system_health","performance_metrics","active_alerts","recent_incidents","monitoring_status","uptime_statistics","capacity_overview"],"title":"MonitoringDashboardResponse","description":"Response for GET /monitoring/dashboard."},"app__schemas__admin__monitoring_alerts__NetworkMetrics":{"properties":{"bytes_sent_per_sec":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bytes Sent Per Sec"},"bytes_received_per_sec":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bytes Received Per Sec"},"latency_avg":{"type":"number","title":"Latency Avg"},"packet_loss":{"type":"number","title":"Packet Loss"}},"type":"object","required":["latency_avg","packet_loss"],"title":"NetworkMetrics"},"app__schemas__admin__monitoring_alerts__PerformanceMetricsResponse":{"properties":{"time_range":{"type":"string","title":"Time Range"},"generated_at":{"type":"string","title":"Generated At"},"metrics":{"$ref":"#/components/schemas/PerformanceMetricsBreakdown"},"simulated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Simulated","description":"True -- these series are randomly generated, not real history (#8270)."}},"type":"object","required":["time_range","generated_at","metrics"],"title":"PerformanceMetricsResponse","description":"Response for GET /monitoring/metrics."},"app__schemas__admin__monitoring_alerts__SystemMetrics":{"properties":{"cpu_usage":{"type":"number","title":"Cpu Usage"},"memory_usage":{"type":"number","title":"Memory Usage"},"disk_usage":{"type":"number","title":"Disk Usage"},"load_average":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Load Average"}},"type":"object","required":["cpu_usage","memory_usage","disk_usage"],"title":"SystemMetrics"},"app__schemas__admin__performance__CapacityPlanning":{"properties":{"current_capacity":{"type":"string","title":"Current Capacity"},"projected_growth":{"type":"string","title":"Projected Growth"},"scale_up_trigger":{"type":"string","title":"Scale Up Trigger"},"scale_out_options":{"items":{"type":"string"},"type":"array","title":"Scale Out Options"}},"type":"object","required":["current_capacity","projected_growth","scale_up_trigger","scale_out_options"],"title":"CapacityPlanning"},"app__schemas__admin__performance__ScalingRecommendationsBuckets":{"properties":{"immediate_actions":{"items":{"type":"string"},"type":"array","title":"Immediate Actions"},"short_term_actions":{"items":{"type":"string"},"type":"array","title":"Short Term Actions"},"long_term_actions":{"items":{"type":"string"},"type":"array","title":"Long Term Actions"}},"type":"object","required":["immediate_actions","short_term_actions","long_term_actions"],"title":"ScalingRecommendationsBuckets"},"app__schemas__admin__prompt_analytics__AnalyticsSummaryResponse":{"properties":{"period":{"$ref":"#/components/schemas/AnalyticsSummaryPeriod"},"key_metrics":{"$ref":"#/components/schemas/AnalyticsSummaryKeyMetrics"},"performance_overview":{"$ref":"#/components/schemas/AnalyticsSummaryPerformanceOverview"},"health_status":{"$ref":"#/components/schemas/AnalyticsSummaryHealthStatus"},"insights":{"items":{},"type":"array","title":"Insights"}},"type":"object","required":["period","key_metrics","performance_overview","health_status","insights"],"title":"AnalyticsSummaryResponse","description":"Response for GET /analytics/summary."},"app__schemas__admin__prompt_management__ListTemplatesResponse":{"properties":{"templates":{"items":{"$ref":"#/components/schemas/SerializedPromptTemplate"},"type":"array","title":"Templates"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["templates","total","skip","limit"],"title":"ListTemplatesResponse","description":"Response for GET /templates."},"app__schemas__admin__prompt_management__PerformanceMetricsResponse":{"properties":{},"additionalProperties":true,"type":"object","title":"PerformanceMetricsResponse","description":"Response for GET /performance -- open passthrough, see\nCreateABTestResponse docstring."},"app__schemas__admin__quality_trending__AcknowledgeAlertResponse":{"properties":{"alert_id":{"type":"string","title":"Alert Id"},"status":{"type":"string","title":"Status"},"acknowledged_by":{"type":"string","title":"Acknowledged By"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message"}},"type":"object","required":["alert_id","status","acknowledged_by","timestamp","message"],"title":"AcknowledgeAlertResponse","description":"Response for PUT /alerts/{alert_id}/acknowledge."},"app__schemas__admin__quality_trending__ResolveAlertResponse":{"properties":{"alert_id":{"type":"string","title":"Alert Id"},"status":{"type":"string","title":"Status"},"resolved_by":{"type":"string","title":"Resolved By"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message"}},"type":"object","required":["alert_id","status","resolved_by","timestamp","message"],"title":"ResolveAlertResponse","description":"Response for PUT /alerts/{alert_id}/resolve."},"app__schemas__admin__railway_deployment__DeploymentStatistics":{"properties":{"total_deployments":{"type":"integer","title":"Total Deployments"},"successful_deployments":{"type":"integer","title":"Successful Deployments"},"failed_deployments":{"type":"integer","title":"Failed Deployments"},"success_rate":{"type":"number","title":"Success Rate"}},"type":"object","required":["total_deployments","successful_deployments","failed_deployments","success_rate"],"title":"DeploymentStatistics"},"app__schemas__admin__railway_deployment__DeploymentStatusResponse":{"properties":{"deployment":{"additionalProperties":true,"type":"object","title":"Deployment"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["deployment","timestamp"],"title":"DeploymentStatusResponse","description":"Response for GET /railway-deployment/deployment/{deployment_id}/status."},"app__schemas__admin__rlhf_feedback_endpoints__FeedbackSummaryResponse":{"properties":{"total_interactions":{"type":"integer","title":"Total Interactions"},"active_sessions":{"type":"integer","title":"Active Sessions"},"feedback_by_sentiment":{"$ref":"#/components/schemas/FeedbackBySentiment"},"feedback_by_type":{"additionalProperties":true,"type":"object","title":"Feedback By Type"},"learning_signals":{"$ref":"#/components/schemas/LearningSignalsSummary"},"top_suggestions":{"items":{},"type":"array","title":"Top Suggestions"},"collection_active":{"type":"boolean","title":"Collection Active"}},"type":"object","required":["total_interactions","active_sessions","feedback_by_sentiment","feedback_by_type","learning_signals","top_suggestions","collection_active"],"title":"FeedbackSummaryResponse","description":"Response for GET /feedback/summary.\n\nMatches RLHFUserInteractionCollector.get_feedback_summary(), which\nalways returns this exact stub shape today (feedback_by_type is\nalways an empty dict, top_suggestions always an empty list -- no\nbranch populates them yet)."},"app__schemas__admin__rlhf_feedback_endpoints__SessionInteractionsResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"total_interactions":{"type":"integer","title":"Total Interactions"},"interactions":{"items":{"$ref":"#/components/schemas/SessionInteractionDetail"},"type":"array","title":"Interactions"}},"type":"object","required":["session_id","total_interactions","interactions"],"title":"SessionInteractionsResponse","description":"Response for GET /feedback/interactions/{session_id}."},"app__schemas__admin__rlhf_simple_dashboard__DashboardOverviewResponse":{"properties":{"timestamp":{"type":"string","title":"Timestamp"},"system_status":{"$ref":"#/components/schemas/DashboardSystemStatus"},"learning_metrics":{"$ref":"#/components/schemas/DashboardLearningMetrics"},"agent_performance":{"$ref":"#/components/schemas/DashboardAgentPerformance"},"active_experiments":{"items":{"$ref":"#/components/schemas/ActiveExperimentSummary"},"type":"array","title":"Active Experiments"},"recent_deployments":{"items":{"$ref":"#/components/schemas/app__schemas__admin__rlhf_simple_dashboard__RecentDeploymentSummary"},"type":"array","title":"Recent Deployments"},"quality_insights":{"$ref":"#/components/schemas/DashboardQualityInsights"}},"type":"object","required":["timestamp","system_status","learning_metrics","agent_performance","active_experiments","recent_deployments","quality_insights"],"title":"DashboardOverviewResponse","description":"Response for GET /dashboard/overview."},"app__schemas__admin__rlhf_simple_dashboard__DeploymentStatistics":{"properties":{"total_deployments":{"type":"integer","title":"Total Deployments"},"successful_deployments":{"type":"integer","title":"Successful Deployments"},"failed_deployments":{"type":"integer","title":"Failed Deployments"},"rollbacks":{"type":"integer","title":"Rollbacks"},"average_deployment_time":{"type":"number","title":"Average Deployment Time"},"success_rate":{"type":"number","title":"Success Rate"}},"type":"object","required":["total_deployments","successful_deployments","failed_deployments","rollbacks","average_deployment_time","success_rate"],"title":"DeploymentStatistics"},"app__schemas__admin__rlhf_simple_dashboard__RecentDeploymentSummary":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"agent_type":{"type":"string","title":"Agent Type"},"version":{"type":"string","title":"Version"},"status":{"type":"string","title":"Status"},"deployed_at":{"type":"string","title":"Deployed At"}},"type":"object","required":["deployment_id","agent_type","version","status","deployed_at"],"title":"RecentDeploymentSummary"},"app__schemas__admin__scaling__CapacityPlanning":{"properties":{"current_capacity":{"$ref":"#/components/schemas/CapacityValues"},"utilization":{"$ref":"#/components/schemas/UtilizationPercentages"},"projected_growth":{"$ref":"#/components/schemas/ProjectedGrowth"},"scaling_recommendations":{"$ref":"#/components/schemas/app__schemas__admin__scaling__ScalingRecommendationsBuckets"},"cost_optimization":{"$ref":"#/components/schemas/CostOptimization"}},"type":"object","required":["current_capacity","utilization","projected_growth","scaling_recommendations","cost_optimization"],"title":"CapacityPlanning"},"app__schemas__admin__scaling__NetworkMetrics":{"properties":{"bytes_sent":{"type":"integer","title":"Bytes Sent"},"bytes_received":{"type":"integer","title":"Bytes Received"},"packets_sent":{"type":"integer","title":"Packets Sent"},"packets_received":{"type":"integer","title":"Packets Received"},"errors_in":{"type":"integer","title":"Errors In"},"errors_out":{"type":"integer","title":"Errors Out"}},"type":"object","required":["bytes_sent","bytes_received","packets_sent","packets_received","errors_in","errors_out"],"title":"NetworkMetrics"},"app__schemas__admin__scaling__ScalingRecommendationsBuckets":{"properties":{"immediate":{"items":{"type":"string"},"type":"array","title":"Immediate"},"short_term":{"items":{"type":"string"},"type":"array","title":"Short Term"},"long_term":{"items":{"type":"string"},"type":"array","title":"Long Term"}},"type":"object","required":["immediate","short_term","long_term"],"title":"ScalingRecommendationsBuckets"},"app__schemas__admin__scaling__SystemMetrics":{"properties":{"cpu":{"$ref":"#/components/schemas/CpuMetrics"},"memory":{"$ref":"#/components/schemas/MemoryMetrics"},"disk":{"$ref":"#/components/schemas/DiskMetrics"},"network":{"$ref":"#/components/schemas/app__schemas__admin__scaling__NetworkMetrics"},"processes":{"$ref":"#/components/schemas/ProcessMetrics"},"platform":{"$ref":"#/components/schemas/PlatformInfo"}},"type":"object","required":["cpu","memory","disk","network","processes","platform"],"title":"SystemMetrics"},"app__schemas__admin__security_scan__ScanSummary":{"properties":{"total_findings":{"type":"integer","title":"Total Findings"},"high":{"type":"integer","title":"High"},"medium":{"type":"integer","title":"Medium"},"low":{"type":"integer","title":"Low"},"sca_vulns":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sca Vulns"}},"type":"object","required":["total_findings","high","medium","low"],"title":"ScanSummary","description":"Aggregate severity counts for a completed scan."},"app__schemas__admin__zerodb_analytics__AnalyticsUsageResponse":{"properties":{"usage":{"$ref":"#/components/schemas/AnalyticsUsageDetail"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["usage","timestamp"],"title":"AnalyticsUsageResponse","description":"Response for GET /analytics/usage."},"app__schemas__agent_cloud__AgentCardResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_card":{"additionalProperties":true,"type":"object","title":"Agent Card"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["agent_id","agent_card","updated_at"],"title":"AgentCardResponse","description":"Response for GET/PUT agent card."},"app__schemas__agent_learning__SubmitFeedbackResponse":{"properties":{"id":{"type":"string","title":"Id"},"interaction_id":{"type":"string","title":"Interaction Id"},"rating":{"type":"integer","title":"Rating"},"feedback_type":{"type":"string","title":"Feedback Type"},"created_at":{"type":"string","title":"Created At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","interaction_id","rating","feedback_type","created_at","message"],"title":"SubmitFeedbackResponse"},"app__schemas__agent_memory__MemorySearchRequest":{"properties":{"query":{"type":"string","minLength":1,"title":"Query","description":"Search query"},"user_id":{"type":"string","format":"uuid","title":"User Id","description":"User ID"},"limit":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"title":"Limit","description":"Maximum results","default":10},"filters":{"anyOf":[{"$ref":"#/components/schemas/MemorySearchFilters"},{"type":"null"}],"description":"Optional filters"}},"type":"object","required":["query","user_id"],"title":"MemorySearchRequest","description":"Request schema for semantic memory search"},"app__schemas__agent_memory__MemorySearchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/MemoryEntry"},"type":"array","title":"Results","description":"Search results"},"count":{"type":"integer","title":"Count","description":"Total results count"},"relevance_scores":{"additionalProperties":{"type":"number"},"type":"object","title":"Relevance Scores","description":"Relevance scores by memory ID"}},"type":"object","required":["results","count","relevance_scores"],"title":"MemorySearchResponse","description":"Response schema for memory search"},"app__schemas__agent_oauth__TokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"expires_in":{"type":"integer","title":"Expires In"},"scope":{"type":"string","title":"Scope"}},"type":"object","required":["access_token","expires_in","scope"],"title":"TokenResponse","description":"OAuth 2.1 token response."},"app__schemas__agent_observability__AgentMetricsResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"period":{"type":"string","title":"Period"},"request_count":{"type":"integer","title":"Request Count","default":0},"error_count":{"type":"integer","title":"Error Count","default":0},"error_rate":{"type":"number","title":"Error Rate","default":0},"latency":{"$ref":"#/components/schemas/app__schemas__agent_observability__LatencyPercentiles"},"tool_invocations":{"type":"integer","title":"Tool Invocations","default":0},"llm_tokens":{"$ref":"#/components/schemas/LLMTokenUsage"},"memory_operations":{"$ref":"#/components/schemas/MemoryOperations"}},"type":"object","required":["agent_id","period"],"title":"AgentMetricsResponse","description":"Aggregated per-agent metrics for a given time period."},"app__schemas__agent_observability__LatencyPercentiles":{"properties":{"p50":{"type":"number","title":"P50","default":0},"p95":{"type":"number","title":"P95","default":0},"p99":{"type":"number","title":"P99","default":0}},"type":"object","title":"LatencyPercentiles","description":"Latency percentiles in milliseconds."},"app__schemas__agent_swarm_feedback__FeedbackType":{"type":"string","enum":["star_rating","thumbs","detailed"],"title":"FeedbackType","description":"Types of feedback that can be provided"},"app__schemas__agent_swarm_lifecycle__AgentStatusResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Agent instance ID"},"name":{"type":"string","title":"Name","description":"Agent name"},"status":{"$ref":"#/components/schemas/AgentSwarmStatusEnum","description":"Current agent status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Status message"}},"type":"object","required":["id","name","status"],"title":"AgentStatusResponse","description":"Simple status response schema"},"app__schemas__agent_swarms_public__ActivateRulesFileResponse":{"properties":{"message":{"type":"string","title":"Message"},"file_id":{"type":"string","title":"File Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["message","file_id","status"],"title":"ActivateRulesFileResponse"},"app__schemas__agent_swarms_public__DeleteRulesFileResponse":{"properties":{"message":{"type":"string","title":"Message"},"file_id":{"type":"string","title":"File Id"}},"type":"object","required":["message","file_id"],"title":"DeleteRulesFileResponse"},"app__schemas__auth_v1__CurrentUserResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"email_verified":{"type":"boolean","title":"Email Verified","default":false},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"github_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Github Id"},"profile_visibility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Visibility","default":"public"},"show_online_status":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Show Online Status","default":true},"allow_messages_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Allow Messages From","default":"everyone"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"cover_photo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Photo Url"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"is_superuser":{"type":"boolean","title":"Is Superuser","default":false},"plan":{"type":"string","title":"Plan","default":"free"},"trial_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trial Expires At"},"organization_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Uuid"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"organizations":{"items":{"$ref":"#/components/schemas/OrgMembership"},"type":"array","title":"Organizations"}},"additionalProperties":true,"type":"object","required":["id"],"title":"CurrentUserResponse","description":"GET /auth/me — full authenticated-user profile.\n\nAccepts either a JWT Bearer token or an X-API-Key; the handler builds this\ndict from either an asyncpg row or an ORM ``User`` object via a uniform\n``_get()`` accessor, so every field here is optional/nullable at the\nPython level even though most are always present in practice."},"app__schemas__billing_public__AddPaymentMethodResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/StripePaymentMethod"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","data","message"],"title":"AddPaymentMethodResponse","description":"Response for POST /billing/payment-methods."},"app__schemas__billing_public__BillingInfoResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/BillingInfoDetailedResponse"}},"type":"object","required":["success","data"],"title":"BillingInfoResponse","description":"Response for GET /billing/info."},"app__schemas__billing_public__InvoiceListResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/InvoiceListData"}},"type":"object","required":["success","data"],"title":"InvoiceListResponse","description":"Response for GET /billing/invoices."},"app__schemas__blog_prompt__ActionType":{"type":"string","enum":["view","copy","download","share","edit","rate"],"title":"ActionType","description":"Types of user actions on prompts"},"app__schemas__chapter__ChapterCreate":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Chapter title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Chapter description"},"start_time":{"type":"integer","minimum":0,"title":"Start Time","description":"Chapter start time in seconds"},"end_time":{"type":"integer","exclusiveMinimum":0,"title":"End Time","description":"Chapter end time in seconds"},"order":{"type":"integer","minimum":0,"title":"Order","description":"Chapter display order"},"thumbnail_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Thumbnail Url","description":"Chapter thumbnail URL"}},"type":"object","required":["title","start_time","end_time","order"],"title":"ChapterCreate","description":"Schema for creating a manual chapter","example":{"description":"Getting started with FastAPI framework","end_time":300,"order":0,"start_time":0,"thumbnail_url":"minio://thumbnails/chapter-1.jpg","title":"Introduction to FastAPI"}},"app__schemas__chapter__ChapterResponse":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Chapter title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Chapter description"},"start_time":{"type":"integer","minimum":0,"title":"Start Time","description":"Chapter start time in seconds"},"end_time":{"type":"integer","exclusiveMinimum":0,"title":"End Time","description":"Chapter end time in seconds"},"order":{"type":"integer","minimum":0,"title":"Order","description":"Chapter display order"},"id":{"type":"string","format":"uuid","title":"Id"},"video_id":{"type":"string","format":"uuid","title":"Video Id"},"source":{"type":"string","title":"Source","description":"Chapter source: 'manual' or 'ai'"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score","description":"AI confidence score (0.0-1.0)"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["title","start_time","end_time","order","id","video_id","source","created_at","updated_at"],"title":"ChapterResponse","description":"Schema for chapter response","example":{"created_at":"2025-12-20T10:00:00Z","description":"Getting started","end_time":300,"id":"123e4567-e89b-12d3-a456-426614174000","order":0,"source":"manual","start_time":0,"thumbnail_url":"minio://thumbnails/chapter-1.jpg","title":"Introduction to FastAPI","updated_at":"2025-12-20T10:00:00Z","video_id":"123e4567-e89b-12d3-a456-426614174001"}},"app__schemas__chapter__ChapterUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"start_time":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Start Time"},"end_time":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}],"title":"End Time"},"order":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Order"},"thumbnail_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Thumbnail Url"}},"type":"object","title":"ChapterUpdate","description":"Schema for updating a chapter","example":{"description":"Updated description","title":"Updated Chapter Title"}},"app__schemas__chat__ChatHistoryResponse":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/app__schemas__chat__ChatMessageResponse"},"type":"array","title":"Messages","description":"List of chat messages"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nextcursor","description":"Cursor for next page of messages (null if no more)"},"hasMore":{"type":"boolean","title":"Hasmore","description":"Whether more messages are available","default":false},"chat_session":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__chat__ChatSessionResponse"},{"type":"null"}],"description":"Chat session details (legacy field)"}},"type":"object","title":"ChatHistoryResponse","description":"Chat history response schema with cursor-based pagination\n\nIssue #880: Enhanced with cursor-based pagination for efficient chat scrolling"},"app__schemas__chat__ChatMessageResponse":{"properties":{"role":{"type":"string","pattern":"^(user|assistant|system)$","title":"Role"},"content":{"type":"string","minLength":1,"title":"Content"},"message_type":{"type":"string","pattern":"^(text|subscription|donation|announcement)$","title":"Message Type","description":"Message type: text, subscription, donation, or announcement","default":"text"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"},"id":{"type":"string","format":"uuid","title":"Id"},"session_id":{"type":"string","format":"uuid","title":"Session Id"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"sequence":{"type":"integer","title":"Sequence"},"tokens_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens Used"},"model_used":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Used"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["role","content","id","session_id","user_id","sequence","tokens_used","model_used","created_at"],"title":"ChatMessageResponse","description":"Schema for chat message API responses"},"app__schemas__chat__ChatSessionResponse":{"properties":{"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"meta_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Data"},"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["title","id","user_id","organization_id","status","created_at","updated_at"],"title":"ChatSessionResponse","description":"Schema for chat session API responses"},"app__schemas__cli_compat__MetricsEnabledResponse":{"properties":{"metrics_logging_enabled":{"type":"boolean","title":"Metrics Logging Enabled"}},"type":"object","required":["metrics_logging_enabled"],"title":"MetricsEnabledResponse","description":"CLI telemetry opt-out status."},"app__schemas__cli_compat__TeamMemoryHashesResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"repo":{"type":"string","title":"Repo"},"hashes":{"additionalProperties":{"type":"string"},"type":"object","title":"Hashes"}},"type":"object","required":["org_id","repo"],"title":"TeamMemoryHashesResponse","description":"Key -> content-hash mapping for team memory sync diffing."},"app__schemas__cli_compat__UserSettingsResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"settings":{"additionalProperties":true,"type":"object","title":"Settings"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["user_id"],"title":"UserSettingsResponse","description":"CLI per-user settings envelope, backed by CLISettingsService."},"app__schemas__cli_files__FileUploadResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique file identifier"},"filename":{"type":"string","title":"Filename","description":"Original filename"},"content_type":{"type":"string","title":"Content Type","description":"MIME content type"},"size":{"type":"integer","title":"Size","description":"File size in bytes"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Upload timestamp (UTC)"}},"type":"object","required":["id","filename","content_type","size","created_at"],"title":"FileUploadResponse","description":"Response returned after a successful file upload."},"app__schemas__cli_settings__TeamMemoryHashesResponse":{"properties":{"org_id":{"type":"string","format":"uuid","title":"Org Id"},"repo":{"type":"string","title":"Repo"},"hashes":{"additionalProperties":{"type":"string"},"type":"object","title":"Hashes","description":"Mapping of entry key -> SHA-256 hash"}},"type":"object","required":["org_id","repo","hashes"],"title":"TeamMemoryHashesResponse","description":"Response returning only entry hashes (for sync diffing)."},"app__schemas__cli_settings__UserSettingsResponse":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"settings":{"additionalProperties":true,"type":"object","title":"Settings"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["user_id","settings"],"title":"UserSettingsResponse","description":"Response when fetching user CLI settings."},"app__schemas__cli_telemetry__MetricsEnabledResponse":{"properties":{"metrics_enabled":{"type":"boolean","title":"Metrics Enabled","description":"Whether the organization has metrics/telemetry enabled"}},"type":"object","required":["metrics_enabled"],"title":"MetricsEnabledResponse","description":"Response for organization metrics opt-out check."},"app__schemas__cli_telemetry__TelemetryEvent":{"properties":{"event_type":{"type":"string","maxLength":255,"minLength":1,"title":"Event Type","description":"Type of event (e.g. 'zerotime_init', 'CodyInternalEvent')"},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp","description":"ISO 8601 timestamp when the event occurred"},"properties":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Properties","description":"Arbitrary event properties/metadata"},"session_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Session Id","description":"Client session identifier"},"event_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Event Data","description":"Structured event payload (used by OTel-based CLI exporter)"}},"type":"object","required":["event_type"],"title":"TelemetryEvent","description":"Single telemetry event from a CLI client."},"app__schemas__code_context__SearchRequest":{"properties":{"query":{"type":"string","maxLength":1000,"minLength":1,"title":"Query","description":"Natural language search query or code snippet to find similar chunks","examples":["function that validates user authentication","error handling for API requests","def process_payment"]},"project_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","title":"Project Id","description":"UUID of the project to search within","examples":["550e8400-e29b-41d4-a716-446655440000"]},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Maximum number of similar chunks to return","default":10,"examples":[10,20,50]}},"type":"object","required":["query","project_id"],"title":"SearchRequest","description":"Request to search for semantically similar code chunks using natural language.\n\nPerforms vector similarity search across all code chunks in a project\nto find relevant code segments matching the query intent.","example":{"limit":10,"project_id":"550e8400-e29b-41d4-a716-446655440000","query":"function that validates user authentication"}},"app__schemas__code_context__SnapshotListEntry":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"file_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Count"},"status":{"type":"string","title":"Status"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"type":{"type":"string","title":"Type"},"config_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Config Id"},"trigger_context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trigger Context"}},"type":"object","required":["id","name","status","type"],"title":"SnapshotListEntry"},"app__schemas__coding_session__SessionEventResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"session_id":{"type":"string","format":"uuid","title":"Session Id"},"event_type":{"$ref":"#/components/schemas/SessionEventTypeEnum"},"sequence_number":{"type":"integer","title":"Sequence Number"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"event_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Event Data"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","session_id","event_type","sequence_number","created_at"],"title":"SessionEventResponse","description":"Response for a single session event"},"app__schemas__coding_session__SessionStatusEnum":{"type":"string","enum":["active","paused","completed","archived","error"],"title":"SessionStatusEnum"},"app__schemas__communication_settings__CommunicationSettingsResponse":{"properties":{"language":{"type":"string","title":"Language","default":"en"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"email_frequency":{"type":"string","title":"Email Frequency","default":"instant"},"user_id":{"type":"string","title":"User Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["user_id","created_at","updated_at"],"title":"CommunicationSettingsResponse","description":"Schema for communication settings response","example":{"created_at":"2025-12-07T10:00:00Z","email_frequency":"instant","language":"en","timezone":"America/New_York","updated_at":"2025-12-07T10:00:00Z","user_id":"550e8400-e29b-41d4-a716-446655440000"}},"app__schemas__community__CommentCreate":{"properties":{"content":{"type":"string","maxLength":2000,"minLength":1,"title":"Content","description":"Comment text content (max 2000 chars)"},"parent_comment_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Comment Id","description":"Parent comment ID for threaded replies"}},"type":"object","required":["content"],"title":"CommentCreate","description":"Schema for creating a new comment","example":{"content":"Great post! Thanks for sharing @john"}},"app__schemas__community__CommentResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Comment unique identifier"},"post_id":{"type":"string","title":"Post Id","description":"Post ID this comment belongs to"},"author_id":{"type":"string","title":"Author Id","description":"Comment author user ID"},"parent_comment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Comment Id","description":"Parent comment ID if this is a reply"},"content":{"type":"string","title":"Content","description":"Comment text content"},"mentions":{"items":{"type":"string"},"type":"array","title":"Mentions","description":"Array of mentioned user IDs"},"loves_count":{"type":"integer","title":"Loves Count","description":"Number of loves/likes on this comment","default":0},"is_deleted":{"type":"boolean","title":"Is Deleted","description":"Soft delete flag","default":false},"created_at":{"type":"string","title":"Created At","description":"Creation timestamp (ISO format)"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp (ISO format)"}},"type":"object","required":["id","post_id","author_id","content","created_at"],"title":"CommentResponse","description":"Schema for comment responses","example":{"author_id":"123e4567-e89b-12d3-a456-426614174002","content":"This is a great post!","created_at":"2025-01-20T12:00:00","id":"123e4567-e89b-12d3-a456-426614174000","is_deleted":false,"loves_count":5,"mentions":["123e4567-e89b-12d3-a456-426614174003"],"post_id":"123e4567-e89b-12d3-a456-426614174001"}},"app__schemas__community_events__EventCreate":{"properties":{"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title","description":"Event title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Event description"},"cover_image_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Cover Image Url","description":"Cover image URL"},"event_type":{"$ref":"#/components/schemas/EventTypeEnum","description":"Event type","default":"in_person"},"location":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Location","description":"Physical location"},"virtual_link":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Virtual Link","description":"Virtual meeting link"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Event start time"},"end_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Time","description":"Event end time"},"privacy":{"$ref":"#/components/schemas/EventPrivacyEnum","description":"Event privacy","default":"public"},"max_attendees":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Max Attendees","description":"Maximum attendees"},"group_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Group Id","description":"Associated group ID"}},"type":"object","required":["title","start_time"],"title":"EventCreate","description":"Schema for creating a new event","example":{"description":"Join us for an evening of AI discussions and networking","end_time":"2026-02-15T21:00:00Z","event_type":"in_person","location":"123 Tech Street, San Francisco, CA","max_attendees":50,"privacy":"public","start_time":"2026-02-15T18:00:00Z","title":"AI Native Community Meetup"}},"app__schemas__community_events__EventListResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/app__schemas__community_events__EventResponse"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total","description":"Total count of events"},"skip":{"type":"integer","title":"Skip","description":"Number of events skipped"},"limit":{"type":"integer","title":"Limit","description":"Max events per page"}},"type":"object","required":["events","total","skip","limit"],"title":"EventListResponse","description":"Paginated event list response","example":{"events":[],"limit":20,"skip":0,"total":42}},"app__schemas__community_events__EventResponse":{"properties":{"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title","description":"Event title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Event description"},"cover_image_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Cover Image Url","description":"Cover image URL"},"event_type":{"$ref":"#/components/schemas/EventTypeEnum","description":"Event type","default":"in_person"},"location":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Location","description":"Physical location"},"virtual_link":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Virtual Link","description":"Virtual meeting link"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Event start time"},"end_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Time","description":"Event end time"},"privacy":{"$ref":"#/components/schemas/EventPrivacyEnum","description":"Event privacy","default":"public"},"max_attendees":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Max Attendees","description":"Maximum attendees"},"group_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Group Id","description":"Associated group ID"},"id":{"type":"string","format":"uuid","title":"Id","description":"Event ID"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id","description":"Tenant ID"},"creator_id":{"type":"string","format":"uuid","title":"Creator Id","description":"Creator user ID"},"status":{"$ref":"#/components/schemas/EventStatusEnum","description":"Event status"},"rsvp_count":{"type":"integer","title":"Rsvp Count","description":"Number of RSVPs","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"},"cancelled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cancelled At","description":"Cancellation timestamp"}},"type":"object","required":["title","start_time","id","tenant_id","creator_id","status","created_at"],"title":"EventResponse","description":"Schema for event response","example":{"created_at":"2026-01-15T10:00:00Z","creator_id":"789e4567-e89b-12d3-a456-426614174000","description":"Join us for an evening of AI discussions","end_time":"2026-02-15T21:00:00Z","event_type":"in_person","id":"550e8400-e29b-41d4-a716-446655440000","location":"123 Tech Street, San Francisco, CA","max_attendees":50,"privacy":"public","rsvp_count":12,"start_time":"2026-02-15T18:00:00Z","status":"scheduled","tenant_id":"123e4567-e89b-12d3-a456-426614174000","title":"AI Native Community Meetup","updated_at":"2026-01-16T14:30:00Z"}},"app__schemas__community_events__EventUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"cover_image_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Cover Image Url"},"event_type":{"anyOf":[{"$ref":"#/components/schemas/EventTypeEnum"},{"type":"null"}]},"location":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Location"},"virtual_link":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Virtual Link"},"start_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Time"},"end_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Time"},"privacy":{"anyOf":[{"$ref":"#/components/schemas/EventPrivacyEnum"},{"type":"null"}]},"max_attendees":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Max Attendees"},"status":{"anyOf":[{"$ref":"#/components/schemas/EventStatusEnum"},{"type":"null"}]}},"type":"object","title":"EventUpdate","description":"Schema for updating an existing event","example":{"max_attendees":75,"title":"Updated Event Title"}},"app__schemas__context_graph__EntityItem":{"properties":{"id":{"type":"string","title":"Id"},"canonical_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Name"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"},"memory_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Memory Count"}},"additionalProperties":true,"type":"object","required":["id"],"title":"EntityItem","description":"An entity row from GET /memory/v2/graph/entities."},"app__schemas__context_graph__ListTemplatesResponse":{"properties":{"templates":{"items":{"$ref":"#/components/schemas/TemplateItem"},"type":"array","title":"Templates"},"total":{"type":"integer","title":"Total"}},"additionalProperties":true,"type":"object","required":["total"],"title":"ListTemplatesResponse","description":"Response for GET /memory/v2/graph/templates."},"app__schemas__credential_vault__CredentialListResponse":{"properties":{"credentials":{"items":{"$ref":"#/components/schemas/CredentialResponse"},"type":"array","title":"Credentials"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["credentials","total"],"title":"CredentialListResponse"},"app__schemas__credential_vault__DomainCheckResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"allowed":{"type":"boolean","title":"Allowed"},"matched_rule":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Rule"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["domain","allowed","reason"],"title":"DomainCheckResponse"},"app__schemas__dashboard_stats_public__ActivityItem":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"resource_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Id"},"details":{"anyOf":[{},{"type":"null"}],"title":"Details"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["id"],"title":"ActivityItem"},"app__schemas__dashboard_stats_public__HealthStatusResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/HealthStatus"},"admin_user":{"type":"string","title":"Admin User"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["success","data","admin_user"],"title":"HealthStatusResponse","description":"Response for GET /database/admin/health."},"app__schemas__dashboard_stats_public__PerformanceMetricsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PerformanceMetricsData"},"admin_user":{"type":"string","title":"Admin User"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["success","data","admin_user"],"title":"PerformanceMetricsResponse","description":"Response for GET /database/admin/performance."},"app__schemas__dashboard_stats_public__ProjectStats":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Name"},"vectors_count":{"type":"integer","title":"Vectors Count"},"tables_count":{"type":"integer","title":"Tables Count"},"files_count":{"type":"integer","title":"Files Count"},"events_count":{"type":"integer","title":"Events Count"},"storage_used_mb":{"type":"number","title":"Storage Used Mb"},"storage_used_gb":{"type":"number","title":"Storage Used Gb"},"memory_usage_mb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Memory Usage Mb"},"api_calls_today":{"type":"integer","title":"Api Calls Today"},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"},"tier_limits":{"additionalProperties":true,"type":"object","title":"Tier Limits"},"usage_percentage":{"additionalProperties":{"type":"number"},"type":"object","title":"Usage Percentage"},"database_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Database Enabled"},"quantum_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Quantum Enabled"},"mcp_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Mcp Enabled"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"additionalProperties":true,"type":"object","required":["project_id","vectors_count","tables_count","files_count","events_count","storage_used_mb","storage_used_gb","api_calls_today","tier_limits","usage_percentage"],"title":"ProjectStats","description":"Per-project usage statistics, as returned by DashboardMetricsService.get_project_stats."},"app__schemas__dashboard_stats_public__SystemMetrics":{"properties":{"cpu_usage":{"type":"number","title":"Cpu Usage"},"cpu_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cpu Count"},"memory_usage":{"type":"number","title":"Memory Usage"},"memory_used_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Memory Used Gb"},"memory_total_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Memory Total Gb"},"memory_available_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Memory Available Gb"},"disk_usage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Disk Usage"},"disk_used_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Disk Used Gb"},"disk_total_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Disk Total Gb"},"disk_free_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Disk Free Gb"},"active_connections":{"type":"integer","title":"Active Connections"},"request_rate":{"type":"integer","title":"Request Rate"},"error_rate":{"type":"number","title":"Error Rate"},"network_bytes_sent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Network Bytes Sent"},"network_bytes_recv":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Network Bytes Recv"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Present only on the degraded fallback path"},"timestamp":{"type":"string","title":"Timestamp"}},"additionalProperties":true,"type":"object","required":["cpu_usage","memory_usage","active_connections","request_rate","error_rate","timestamp"],"title":"SystemMetrics","description":"Real-time system metrics.\n\nOn a collection failure, the service falls back to a smaller degraded\npayload (cpu_usage/memory_usage/active_connections/request_rate/error_rate\nplus an `error` message) — the extra fields below are therefore optional."},"app__schemas__deployment_analytics__DeploymentMetricsResponse":{"properties":{"status":{"type":"string","title":"Status"},"environment_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Environment Id"},"period_days":{"type":"integer","title":"Period Days"},"interval":{"type":"string","title":"Interval"},"time_series":{"items":{"$ref":"#/components/schemas/DeploymentMetricsTimeSeriesEntry"},"type":"array","title":"Time Series"},"duration_statistics":{"$ref":"#/components/schemas/DeploymentDurationStatistics"}},"type":"object","required":["status","period_days","interval","duration_statistics"],"title":"DeploymentMetricsResponse","description":"Response for GET /metrics."},"app__schemas__deployment_automation__DeploymentStatusResponse":{"properties":{"current_deployment":{"$ref":"#/components/schemas/CurrentDeploymentSummary"},"recent_deployments":{"items":{"$ref":"#/components/schemas/app__schemas__deployment_automation__RecentDeploymentSummary"},"type":"array","title":"Recent Deployments"},"monitoring_active":{"type":"boolean","title":"Monitoring Active"},"health_checks_configured":{"type":"integer","title":"Health Checks Configured"},"alert_rules_configured":{"type":"integer","title":"Alert Rules Configured"}},"type":"object","required":["current_deployment","recent_deployments","monitoring_active","health_checks_configured","alert_rules_configured"],"title":"DeploymentStatusResponse","description":"GET /deployment/deployments/status — current status + recent history."},"app__schemas__deployment_automation__RecentDeploymentSummary":{"properties":{"deployment_id":{"type":"string","title":"Deployment Id"},"status":{"type":"string","title":"Status"},"version":{"type":"string","title":"Version"},"environment":{"type":"string","title":"Environment"},"timestamp":{"type":"string","title":"Timestamp"},"health_checks_passed":{"type":"boolean","title":"Health Checks Passed"},"deploy_duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Deploy Duration Seconds"}},"type":"object","required":["deployment_id","status","version","environment","timestamp","health_checks_passed"],"title":"RecentDeploymentSummary","description":"One entry of the ``recent_deployments`` list within the deployment-status response."},"app__schemas__environment__CodeSessionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"environment_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Environment Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"status":{"type":"string","title":"Status"},"session_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Session Metadata"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","user_id","status"],"title":"CodeSessionResponse"},"app__schemas__environment_providers__ProvisionResponse":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"provider":{"type":"string","title":"Provider"},"region":{"type":"string","title":"Region"}},"type":"object","required":["id","status","provider","region"],"title":"ProvisionResponse","description":"Response after provisioning a cloud environment."},"app__schemas__gateway__BillingSummaryResponse":{"properties":{"total_credits_used":{"type":"number","title":"Total Credits Used","description":"System-wide credit usage"},"total_projects":{"type":"integer","title":"Total Projects","description":"Number of active projects"},"average_credits_per_project":{"type":"number","title":"Average Credits Per Project","description":"Average credits per project"},"top_projects":{"items":{"$ref":"#/components/schemas/app__schemas__gateway__ProjectUsage"},"type":"array","title":"Top Projects","description":"Top projects by credit usage"},"breakdown":{"$ref":"#/components/schemas/UsageBreakdown","description":"System-wide breakdown by category"},"time_range":{"type":"string","title":"Time Range","description":"Time range identifier"}},"type":"object","required":["total_credits_used","total_projects","average_credits_per_project","top_projects","breakdown","time_range"],"title":"BillingSummaryResponse","description":"System-wide billing summary","example":{"average_credits_per_project":1500,"breakdown":{"database_operations":12000,"memory_operations":9000,"postgres_queries":3000,"storage_operations":6000,"vector_operations":15000},"time_range":"last_30_days","top_projects":[{"credits_used":5000,"project_id":"project-123","project_name":"My Project"}],"total_credits_used":45000,"total_projects":30}},"app__schemas__gateway__EndpointUsage":{"properties":{"endpoint":{"type":"string","title":"Endpoint","description":"Endpoint path"},"credits":{"type":"number","title":"Credits","description":"Credits consumed"}},"type":"object","required":["endpoint","credits"],"title":"EndpointUsage","description":"Endpoint credit usage","example":{"credits":250,"endpoint":"/api/vectors/search"}},"app__schemas__gateway__ProjectUsage":{"properties":{"project_id":{"type":"string","title":"Project Id","description":"Project identifier"},"project_name":{"type":"string","title":"Project Name","description":"Project name"},"credits_used":{"type":"number","title":"Credits Used","description":"Credits consumed"}},"type":"object","required":["project_id","project_name","credits_used"],"title":"ProjectUsage","description":"Project usage summary","example":{"credits_used":1500.5,"project_id":"project-123","project_name":"My Project"}},"app__schemas__github__GitHubConnectionStatusResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/GitHubConnectionStatusData"}},"type":"object","required":["data"],"title":"GitHubConnectionStatusResponse","description":"Response schema for GET /api/v1/public/github/connection-status"},"app__schemas__invoice__InvoiceListResponse":{"properties":{"invoices":{"items":{"$ref":"#/components/schemas/app__schemas__invoice__InvoiceResponse"},"type":"array","title":"Invoices"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["invoices","total","skip","limit"],"title":"InvoiceListResponse","description":"Schema for listing invoices","example":{"invoices":[],"limit":20,"skip":0,"total":0}},"app__schemas__invoice__InvoiceResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Invoice ID"},"number":{"type":"string","title":"Number","description":"Invoice number (INV-YYYY-NNNN)"},"user_id":{"type":"string","title":"User Id","description":"Customer user ID"},"subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Id","description":"Related subscription ID"},"stripe_invoice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Invoice Id","description":"Stripe invoice ID (for payments)"},"amount_total":{"type":"integer","title":"Amount Total","description":"Total amount in cents"},"amount_paid":{"type":"integer","title":"Amount Paid","description":"Amount paid in cents","default":0},"currency":{"type":"string","title":"Currency","description":"Currency code"},"status":{"type":"string","title":"Status","description":"Invoice status"},"period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period Start","description":"Billing period start"},"period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period End","description":"Billing period end"},"due_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due Date","description":"Payment due date"},"paid_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Paid At","description":"Payment date"},"invoice_pdf":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Pdf","description":"PDF URL"},"hosted_invoice_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hosted Invoice Url","description":"Public invoice view URL"},"line_items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Line Items","description":"Line items"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Custom metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["id","number","user_id","amount_total","currency","status","line_items","created_at"],"title":"InvoiceResponse","description":"Schema for invoice API responses","example":{"amount_paid":0,"amount_total":9900,"created_at":"2025-11-11T10:00:00Z","currency":"USD","due_date":"2025-12-01T00:00:00Z","id":"550e8400-e29b-41d4-a716-446655440000","line_items":[{"amount":9900,"description":"Professional Plan - Monthly","quantity":1,"unit_price":9900}],"metadata":{},"number":"INV-2025-0001","status":"draft","user_id":"660e8400-e29b-41d4-a716-446655440000"}},"app__schemas__mcp_proxy__MCPServerInfo":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"methods":{"items":{"type":"string"},"type":"array","title":"Methods"},"status":{"type":"string","title":"Status","default":"active"}},"type":"object","required":["name"],"title":"MCPServerInfo","description":"Information about a registered MCP server."},"app__schemas__mcp_servers__MCPServerInfo":{"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the MCP server"},"name":{"type":"string","title":"Name","description":"Display name of the MCP server"},"url":{"type":"string","title":"Url","description":"Base URL of the MCP server"},"status":{"type":"string","title":"Status","description":"Current status (active, inactive, maintenance)"},"capabilities":{"additionalProperties":true,"type":"object","title":"Capabilities","description":"Server capabilities including tool count"}},"type":"object","required":["id","name","url","status"],"title":"MCPServerInfo","description":"Information about an MCP server."},"app__schemas__memory_api__MemoryResponse":{"properties":{"title":{"type":"string","title":"Title","description":"Title of the memory"},"content":{"type":"string","title":"Content","description":"Content of the memory"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Tags associated with the memory"},"corpus_names":{"items":{"type":"string"},"type":"array","title":"Corpus Names","description":"Corpus names this memory belongs to"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Additional metadata about the memory"},"is_pinned":{"type":"boolean","title":"Is Pinned","description":"Whether the memory is pinned","default":false},"id":{"type":"string","format":"uuid","title":"Id","description":"Unique identifier"},"user_id":{"type":"string","format":"uuid","title":"User Id","description":"Unique identifier"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Timestamp"},"last_accessed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Accessed At"}},"type":"object","required":["title","content","id","user_id","created_at","updated_at"],"title":"MemoryResponse","description":"Schema for memory responses\n\nProvides consistent output format for memory data"},"app__schemas__memory_public__MemorySearchResult":{"properties":{"id":{"type":"string","title":"Id","description":"Memory ID"},"user_id":{"type":"string","title":"User Id","description":"ID of the owning user"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Memory title"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content","description":"Memory content"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Tags attached to the memory"},"corpus_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Corpus Names","description":"Corpora the memory belongs to"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Arbitrary caller-supplied metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"ISO-8601 creation timestamp"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At","description":"ISO-8601 last-update timestamp"}},"type":"object","required":["id","user_id"],"title":"MemorySearchResult","description":"A single hit from POST /memory/search (Refs #8449).\n\nThe handler hand-builds these dicts and pre-serializes every non-primitive\nvalue: ``str(memory.id)``, ``str(memory.user_id)`` and ``.isoformat()`` on\nboth timestamps. The fields are therefore typed ``str`` rather than\nUUID/datetime so the emitted payload stays byte-for-byte identical to what\nthe untyped route already returns today."},"app__schemas__misc_endpoints__IndexRepositoryResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Human-readable status message"},"project_id":{"type":"string","title":"Project Id","description":"Project identifier"},"repository_path":{"type":"string","title":"Repository Path","description":"Path to the indexed repository"},"user_id":{"type":"string","title":"User Id","description":"ID of the requesting user"},"status":{"type":"string","title":"Status","description":"Operation status"},"note":{"type":"string","title":"Note","description":"Implementation note"}},"type":"object","required":["message","project_id","repository_path","user_id","status","note"],"title":"IndexRepositoryResponse","description":"Response for POST /indexing/repositories/{project_id}."},"app__schemas__multimodal__TTSRequest":{"properties":{"text":{"type":"string","maxLength":5000,"minLength":1,"title":"Text","description":"Text to convert to speech"},"voice":{"type":"string","title":"Voice","description":"Voice profile to use","default":"Wise_Woman"}},"type":"object","required":["text"],"title":"TTSRequest","description":"Request schema for text-to-speech generation","example":{"text":"Welcome to AINative Studio. This is a test of our text-to-speech API.","voice":"Wise_Woman"}},"app__schemas__multimodal__TTSResponse":{"properties":{"audio_base64":{"type":"string","title":"Audio Base64","description":"Base64-encoded audio file"},"format":{"type":"string","title":"Format","description":"Audio format (mp3)"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms","description":"Audio duration in milliseconds"},"usage_id":{"type":"string","title":"Usage Id","description":"Usage record ID"},"credits_used":{"type":"integer","title":"Credits Used","description":"Credits deducted"},"credits_remaining":{"type":"integer","title":"Credits Remaining","description":"User's remaining credits"}},"type":"object","required":["audio_base64","format","usage_id","credits_used","credits_remaining"],"title":"TTSResponse","description":"Response schema for text-to-speech generation"},"app__schemas__multimodal__UsageRecord":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"endpoint_type":{"type":"string","title":"Endpoint Type"},"model_used":{"type":"string","title":"Model Used"},"credits_used":{"type":"integer","title":"Credits Used"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"generation_time_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Generation Time Ms"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["id","user_id","organization_id","endpoint_type","model_used","credits_used","status","created_at","completed_at","generation_time_ms","error_message"],"title":"UsageRecord","description":"Schema for multimodal API usage record"},"app__schemas__multimodal__VideoResponse":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"'processing' (async) or 'completed'"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id","description":"Async video job id — poll for result"},"poll_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Poll Endpoint","description":"GET this to poll the video status"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"The model serving this job"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url","description":"Finished video URL (when ready)"},"video_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Base64","description":"Base64 video (legacy sync path)"},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format","description":"Video format (mp4)"},"fps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fps","description":"Frames per second"},"duration_s":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration S","description":"Video duration in seconds"},"usage_id":{"type":"string","title":"Usage Id","description":"Usage record ID"},"credits_used":{"type":"integer","title":"Credits Used","description":"Credits deducted"},"credits_remaining":{"type":"integer","title":"Credits Remaining","description":"User's remaining credits"}},"type":"object","required":["usage_id","credits_used","credits_remaining"],"title":"VideoResponse","description":"Response schema for video generation.\n\n#5622/#120: video is ASYNC (MiniMax jobs take 1-5 min). The generate endpoints\nreturn status='processing' + task_id immediately; the client polls poll_endpoint\nfor the finished video_url. video_base64 is only the legacy sync path. All result\nfields are optional so both shapes validate."},"app__schemas__notification__BulkDeleteRequest":{"properties":{"notification_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":100,"minItems":1,"title":"Notification Ids"}},"type":"object","required":["notification_ids"],"title":"BulkDeleteRequest","description":"Schema for bulk delete request - supports up to 100 notification IDs","example":{"notification_ids":["123e4567-e89b-12d3-a456-426614174000","223e4567-e89b-12d3-a456-426614174001"]}},"app__schemas__oauth_files__FileUploadResponse":{"properties":{"file_uuid":{"type":"string","title":"File Uuid","description":"Unique identifier for the uploaded file"},"filename":{"type":"string","title":"Filename","description":"Original filename"},"size":{"type":"integer","title":"Size","description":"File size in bytes"},"content_type":{"type":"string","title":"Content Type","description":"MIME type of the file"}},"type":"object","required":["file_uuid","filename","size","content_type"],"title":"FileUploadResponse","description":"Response returned after a successful file upload."},"app__schemas__paipalooza__ad_metrics__TimeRange":{"type":"string","enum":["24h","7d","30d","custom"],"title":"TimeRange","description":"Preset time ranges for filtering metrics"},"app__schemas__paipalooza__admin__RevenueBreakdown":{"properties":{"total":{"type":"string","title":"Total","description":"Total revenue","default":"0.00"},"platform_share":{"type":"string","title":"Platform Share","description":"Platform revenue share","default":"0.00"},"organizer_share":{"type":"string","title":"Organizer Share","description":"Organizer revenue share","default":"0.00"},"pending_payouts":{"type":"string","title":"Pending Payouts","description":"Pending payout balance","default":"0.00"}},"type":"object","title":"RevenueBreakdown","description":"Revenue split between platform and organizers"},"app__schemas__paipalooza__event__EventCreate":{"properties":{"title":{"type":"string","maxLength":200,"minLength":3,"title":"Title","description":"Event title"},"description":{"type":"string","maxLength":5000,"minLength":10,"title":"Description","description":"Event description"},"event_type":{"$ref":"#/components/schemas/EventType","description":"Type of event"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Event start date and time"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date","description":"Event end date and time"},"location":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Location","description":"Physical location or virtual platform"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics","description":"Event topics/tags for targeting"},"expected_attendees":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Expected Attendees","description":"Expected number of attendees"}},"type":"object","required":["title","description","event_type","start_date"],"title":"EventCreate","description":"Schema for creating a new event"},"app__schemas__paipalooza__event__EventListResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total number of events matching filters"},"limit":{"type":"integer","title":"Limit","description":"Results per page"},"offset":{"type":"integer","title":"Offset","description":"Number of results skipped"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results are available"},"events":{"items":{"$ref":"#/components/schemas/Event"},"type":"array","title":"Events","description":"List of events for current page"}},"type":"object","required":["total","limit","offset","has_more","events"],"title":"EventListResponse","description":"Paginated response for event listing"},"app__schemas__paipalooza__event__EventUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":3},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string","maxLength":5000,"minLength":10},{"type":"null"}],"title":"Description"},"event_type":{"anyOf":[{"$ref":"#/components/schemas/EventType"},{"type":"null"}]},"start_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"},"location":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Location"},"topics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topics"},"expected_attendees":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Expected Attendees"},"status":{"anyOf":[{"$ref":"#/components/schemas/EventStatus"},{"type":"null"}]}},"type":"object","title":"EventUpdate","description":"Schema for updating an existing event"},"app__schemas__paipalooza__organizer__RevenueBreakdown":{"properties":{"event_id":{"type":"string","title":"Event Id"},"event_name":{"type":"string","title":"Event Name"},"impressions":{"type":"integer","title":"Impressions"},"revenue":{"type":"string","title":"Revenue"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["event_id","event_name","impressions","revenue","start_date"],"title":"RevenueBreakdown","description":"Revenue breakdown by event"},"app__schemas__payments__BankAccountListResponse":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/app__schemas__payments__BankAccountResponse"},"type":"array","title":"Accounts"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["accounts","total"],"title":"BankAccountListResponse","description":"Schema for listing bank accounts"},"app__schemas__payments__BankAccountResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"account_name":{"type":"string","title":"Account Name"},"account_type":{"type":"string","title":"Account Type"},"account_last4":{"type":"string","title":"Account Last4"},"bank_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bank Name"},"verification_status":{"type":"string","title":"Verification Status"},"is_default":{"type":"boolean","title":"Is Default"},"is_active":{"type":"boolean","title":"Is Active"},"verification_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Verification Date"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","account_name","account_type","account_last4","verification_status","is_default","is_active","created_at"],"title":"BankAccountResponse","description":"Schema for bank account response"},"app__schemas__payments__TransactionListResponse":{"properties":{"transactions":{"items":{"$ref":"#/components/schemas/app__schemas__payments__TransactionResponse"},"type":"array","title":"Transactions"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page","default":1},"page_size":{"type":"integer","title":"Page Size","default":50},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["transactions","total","total_pages"],"title":"TransactionListResponse","description":"Schema for paginated transaction list"},"app__schemas__payments__TransactionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"wallet_id":{"type":"string","format":"uuid","title":"Wallet Id"},"transaction_type":{"type":"string","title":"Transaction Type"},"amount_usd":{"type":"string","title":"Amount Usd"},"status":{"type":"string","title":"Status"},"sila_transaction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sila Transaction Id"},"sila_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sila Reference Id"},"recipient_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient Handle"},"recipient_wallet_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Recipient Wallet Id"},"processed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Processed At"},"failed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Failed At"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"notification_sent":{"type":"boolean","title":"Notification Sent"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","wallet_id","transaction_type","amount_usd","status","notification_sent","created_at"],"title":"TransactionResponse","description":"Schema for transaction response"},"app__schemas__payments__WalletResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"sila_handle":{"type":"string","title":"Sila Handle"},"sila_wallet_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sila Wallet Id"},"kyc_status":{"type":"string","title":"Kyc Status"},"kyc_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kyc Level"},"balance_usd":{"type":"string","title":"Balance Usd"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","user_id","sila_handle","kyc_status","balance_usd","created_at"],"title":"WalletResponse","description":"Schema for wallet response"},"app__schemas__payments__WebhookResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"processed_at":{"type":"string","format":"date-time","title":"Processed At"}},"type":"object","required":["success","message","processed_at"],"title":"WebhookResponse","description":"Schema for webhook response"},"app__schemas__public_api_batch3__CreditTransactionItem":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"amount":{"type":"number","title":"Amount"},"description":{"type":"string","title":"Description"},"tokens_processed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens Processed"},"processing_time_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Processing Time Ms"},"created_at":{"type":"string","title":"Created At"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["id","type","amount","description","created_at"],"title":"CreditTransactionItem"},"app__schemas__public_api_batch3__CreditTransactionsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/CreditTransactionsData"}},"type":"object","required":["success","data"],"title":"CreditTransactionsResponse","description":"GET /credits/transactions"},"app__schemas__public_api_batch3__EarningsBreakdownResponse":{"properties":{"total_earned_cents":{"type":"integer","title":"Total Earned Cents"},"unpaid_cents":{"type":"integer","title":"Unpaid Cents"},"paid_cents":{"type":"integer","title":"Paid Cents"},"breakdown":{"items":{},"type":"array","title":"Breakdown"}},"type":"object","required":["total_earned_cents","unpaid_cents","paid_cents"],"title":"EarningsBreakdownResponse","description":"GET /developer/payouts/breakdown"},"app__schemas__public_api_batch3__FeedbackSystemConfigResponse":{"properties":{"feedback_types":{"items":{"type":"string"},"type":"array","title":"Feedback Types"},"feedback_sentiments":{"items":{"type":"string"},"type":"array","title":"Feedback Sentiments"},"feedback_categories":{"items":{"type":"string"},"type":"array","title":"Feedback Categories"},"feedback_statuses":{"items":{"type":"string"},"type":"array","title":"Feedback Statuses"},"rating_scale":{"$ref":"#/components/schemas/FeedbackRatingScale"},"content_limits":{"$ref":"#/components/schemas/FeedbackContentLimits"},"supported_features":{"items":{"type":"string"},"type":"array","title":"Supported Features"},"ml_capabilities":{"items":{"type":"string"},"type":"array","title":"Ml Capabilities"}},"type":"object","required":["feedback_types","feedback_sentiments","feedback_categories","feedback_statuses","rating_scale","content_limits","supported_features","ml_capabilities"],"title":"FeedbackSystemConfigResponse","description":"GET /user-feedback/config"},"app__schemas__public_api_batch3__NotificationPreferences":{"properties":{"email_notifications":{"type":"boolean","title":"Email Notifications"},"push_notifications":{"type":"boolean","title":"Push Notifications"},"sms_notifications":{"type":"boolean","title":"Sms Notifications"},"billing_notifications":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Billing Notifications"},"security_notifications":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Security Notifications"},"product_updates":{"type":"boolean","title":"Product Updates"},"marketing_notifications":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Marketing Notifications"},"agent_swarm_notifications":{"type":"boolean","title":"Agent Swarm Notifications"}},"additionalProperties":true,"type":"object","required":["email_notifications","push_notifications","sms_notifications","product_updates","agent_swarm_notifications"],"title":"NotificationPreferences","description":"GET /notifications/preferences, GET /dashboard/notifications/preferences.\n\nThe handler returns `dict(row)` straight from the notification_preferences\ntable on a hit (which also carries id/user_id/created_at/updated_at), or a\nfixed 8-key default dict on a miss/error. `extra=\"allow\"` keeps the DB-row\nbranch from having real columns silently dropped by a too-strict schema."},"app__schemas__public_api_batch3__SubmitFeedbackResponse":{"properties":{"feedback_id":{"type":"string","title":"Feedback Id"},"user_id":{"type":"string","title":"User Id"},"feedback_type":{"type":"string","title":"Feedback Type"},"status":{"type":"string","title":"Status"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message"}},"type":"object","required":["feedback_id","user_id","feedback_type","status","timestamp","message"],"title":"SubmitFeedbackResponse","description":"POST /user-feedback/submit"},"app__schemas__realtime_feedback_public__FeedbackSystemConfigResponse":{"properties":{"feedback_types":{"items":{"type":"string"},"type":"array","title":"Feedback Types"},"severity_levels":{"items":{"type":"string"},"type":"array","title":"Severity Levels"},"default_thresholds":{"$ref":"#/components/schemas/DefaultThresholds"},"websocket_endpoint":{"type":"string","title":"Websocket Endpoint"},"features":{"items":{"type":"string"},"type":"array","title":"Features"}},"type":"object","required":["feedback_types","severity_levels","default_thresholds","websocket_endpoint","features"],"title":"FeedbackSystemConfigResponse","description":"Response for GET /realtime-feedback/config."},"app__schemas__realtime_feedback_public__SubmitFeedbackResponse":{"properties":{"evaluation_id":{"type":"string","title":"Evaluation Id"},"prompt_id":{"type":"string","title":"Prompt Id"},"status":{"type":"string","title":"Status"},"quality_score":{"type":"number","title":"Quality Score"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message"}},"type":"object","required":["evaluation_id","prompt_id","status","quality_score","timestamp","message"],"title":"SubmitFeedbackResponse","description":"Response for POST /realtime-feedback/submit."},"app__schemas__recommendations__RecommendedGroup":{"properties":{"group_id":{"type":"string","format":"uuid","title":"Group Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"privacy":{"type":"string","title":"Privacy","default":"public"},"member_count":{"type":"integer","title":"Member Count","default":0},"post_count":{"type":"integer","title":"Post Count","default":0},"activity_score":{"type":"number","title":"Activity Score","default":0},"is_member":{"type":"boolean","title":"Is Member","default":false},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image Url"},"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"Recommendation relevance score (0-1)"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons","description":"Why this was recommended"}},"type":"object","required":["group_id","name","score"],"title":"RecommendedGroup","description":"Single group recommendation response"},"app__schemas__recommendations__RecommendedPost":{"properties":{"post_id":{"type":"string","format":"uuid","title":"Post Id"},"author_id":{"type":"string","format":"uuid","title":"Author Id"},"author_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Username"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"type":"string","title":"Content"},"post_type":{"type":"string","title":"Post Type","default":"text"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"loves_count":{"type":"integer","title":"Loves Count","default":0},"comments_count":{"type":"integer","title":"Comments Count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"Recommendation relevance score (0-1)"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons","description":"Why this was recommended"}},"type":"object","required":["post_id","author_id","content","created_at","score"],"title":"RecommendedPost","description":"Single post recommendation response"},"app__schemas__recommendations__RecommendedUser":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"username":{"type":"string","title":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"follower_count":{"type":"integer","title":"Follower Count","default":0},"post_count":{"type":"integer","title":"Post Count","default":0},"is_followed":{"type":"boolean","title":"Is Followed","default":false},"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"Recommendation relevance score (0-1)"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons","description":"Why this was recommended"}},"type":"object","required":["user_id","username","score"],"title":"RecommendedUser","description":"Single user recommendation response"},"app__schemas__rlhf__FeedbackRequest":{"properties":{"interaction_id":{"type":"string","title":"Interaction Id","description":"Interaction being rated"},"feedback_type":{"$ref":"#/components/schemas/app__schemas__rlhf__FeedbackType","description":"Type of feedback"},"rating":{"anyOf":[{"type":"integer","maximum":5,"minimum":1},{"type":"null"}],"title":"Rating","description":"Rating 1-5 (required for rating type)"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment","description":"Optional user comment"}},"type":"object","required":["interaction_id","feedback_type"],"title":"FeedbackRequest","description":"Request schema for collecting user feedback","example":{"comment":"Very helpful and accurate!","feedback_type":"rating","interaction_id":"550e8400-e29b-41d4-a716-446655440000","rating":5}},"app__schemas__rlhf__FeedbackResponse":{"properties":{"feedback_id":{"type":"string","title":"Feedback Id","description":"Unique feedback ID"},"interaction_id":{"type":"string","title":"Interaction Id","description":"Associated interaction ID"},"feedback_type":{"$ref":"#/components/schemas/app__schemas__rlhf__FeedbackType","description":"Type of feedback"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp when created"}},"type":"object","required":["feedback_id","interaction_id","feedback_type","created_at"],"title":"FeedbackResponse","description":"Response schema for collected feedback","example":{"created_at":"2025-01-15T10:35:00Z","feedback_id":"660e8400-e29b-41d4-a716-446655440000","feedback_type":"rating","interaction_id":"550e8400-e29b-41d4-a716-446655440000"}},"app__schemas__rlhf__FeedbackSummaryResponse":{"properties":{"total_interactions":{"type":"integer","title":"Total Interactions","description":"Total interactions logged"},"total_feedback":{"type":"integer","title":"Total Feedback","description":"Total feedback collected"},"positive_rate":{"type":"number","title":"Positive Rate","description":"Percentage of positive feedback"},"negative_rate":{"type":"number","title":"Negative Rate","description":"Percentage of negative feedback"},"average_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Rating","description":"Average rating (if applicable)"},"feedback_by_feature":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Feedback By Feature","description":"Feedback grouped by feature"}},"type":"object","required":["total_interactions","total_feedback","positive_rate","negative_rate"],"title":"FeedbackSummaryResponse","description":"Response schema for feedback summary","example":{"average_rating":4.2,"feedback_by_feature":{"team_suggestions":{"average_rating":4.5,"positive_rate":0.85,"total":500}},"negative_rate":0.25,"positive_rate":0.75,"total_feedback":800,"total_interactions":1000}},"app__schemas__rlhf__FeedbackType":{"type":"string","enum":["thumbs_up","thumbs_down","rating"],"title":"FeedbackType","description":"Feedback type enumeration"},"app__schemas__rlhf__ImprovementReportResponse":{"properties":{"feature":{"type":"string","title":"Feature","description":"Feature analyzed"},"recommendations":{"items":{"$ref":"#/components/schemas/RecommendationItem"},"type":"array","title":"Recommendations","description":"List of recommendations"},"priority_areas":{"items":{"type":"string"},"type":"array","title":"Priority Areas","description":"Priority improvement areas"},"sample_feedback":{"items":{"$ref":"#/components/schemas/SampleFeedback"},"type":"array","title":"Sample Feedback","description":"Sample user feedback"},"analysis_period":{"additionalProperties":{"type":"string"},"type":"object","title":"Analysis Period","description":"Date range analyzed"},"total_interactions":{"type":"integer","title":"Total Interactions","description":"Total interactions analyzed"}},"type":"object","required":["feature","recommendations","priority_areas","sample_feedback","analysis_period","total_interactions"],"title":"ImprovementReportResponse","description":"Response schema for improvement reports","example":{"analysis_period":{"end":"2025-01-31","start":"2025-01-01"},"feature":"team_suggestions","priority_areas":["Relevance","Accuracy","Speed"],"recommendations":[{"area":"Relevance","impact":"Expected to increase positive feedback by 20%","priority":"high","suggestion":"Improve skill matching algorithm"}],"sample_feedback":[{"comment":"Not relevant to my project","created_at":"2025-01-15T10:30:00Z","feedback_type":"rating","rating":2}],"total_interactions":150}},"app__schemas__rlhf__InteractionRequest":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"User prompt/input"},"response":{"type":"string","title":"Response","description":"AI agent response"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context","description":"Additional context"},"agent_id":{"type":"string","title":"Agent Id","description":"Agent identifier"},"session_id":{"type":"string","title":"Session Id","description":"Session identifier"}},"type":"object","required":["prompt","response","agent_id","session_id"],"title":"InteractionRequest","description":"Request schema for logging AI interactions","example":{"agent_id":"team_agent","context":{"feature":"team_suggestions","user_id":"550e8400-e29b-41d4-a716-446655440000"},"prompt":"Suggest team members for my project","response":"Based on your requirements, I recommend Alice and Bob...","session_id":"sess_123abc"}},"app__schemas__rlhf__SessionInteractionsResponse":{"properties":{"session_id":{"type":"string","title":"Session Id","description":"Session identifier"},"interactions":{"items":{"$ref":"#/components/schemas/InteractionDetail"},"type":"array","title":"Interactions","description":"List of interactions"},"count":{"type":"integer","title":"Count","description":"Total number of interactions"}},"type":"object","required":["session_id","interactions","count"],"title":"SessionInteractionsResponse","description":"Response schema for session interactions","example":{"count":1,"interactions":[{"agent_response":"I recommend...","created_at":"2025-01-15T10:30:00Z","feedback":{"rating":5},"interaction_id":"550e8400-e29b-41d4-a716-446655440000","interaction_type":"query","user_input":"Suggest team members"}],"session_id":"sess_123abc"}},"app__schemas__search__RecommendedGroup":{"properties":{"id":{"type":"string","title":"Id","description":"Group ID"},"name":{"type":"string","title":"Name","description":"Group name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Group description"},"privacy":{"type":"string","title":"Privacy","description":"Privacy setting"},"member_count":{"type":"integer","title":"Member Count","description":"Number of members","default":0},"post_count":{"type":"integer","title":"Post Count","description":"Number of posts","default":0},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Primary category"},"members_you_know_count":{"type":"integer","title":"Members You Know Count","description":"Number of members you know","default":0},"recommendation_score":{"type":"number","maximum":1,"minimum":0,"title":"Recommendation Score","description":"Recommendation score"},"reason":{"type":"string","title":"Reason","description":"Reason for recommendation"}},"type":"object","required":["id","name","privacy","recommendation_score","reason"],"title":"RecommendedGroup","description":"Recommended group item","example":{"category":"Technology","description":"Group for deep learning developers","id":"g1r2o3u4-5p6i-7890-abcd-ef1234567890","member_count":5432,"members_you_know_count":8,"name":"Deep Learning Practitioners","post_count":2341,"privacy":"public","reason":"8 members you know and matches your interests","recommendation_score":0.91}},"app__schemas__search__RecommendedPost":{"properties":{"id":{"type":"string","title":"Id","description":"Post ID"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Post title"},"body":{"type":"string","title":"Body","description":"Post body preview"},"user_id":{"type":"string","title":"User Id","description":"Author user ID"},"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id","description":"Group ID if group post"},"post_type":{"type":"string","title":"Post Type","description":"Post type"},"loves_count":{"type":"integer","title":"Loves Count","description":"Number of loves","default":0},"comments_count":{"type":"integer","title":"Comments Count","description":"Number of comments","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"recommendation_score":{"type":"number","maximum":1,"minimum":0,"title":"Recommendation Score","description":"Recommendation score"},"reason":{"type":"string","title":"Reason","description":"Reason for recommendation"}},"type":"object","required":["id","body","user_id","post_type","created_at","recommendation_score","reason"],"title":"RecommendedPost","description":"Recommended post item","example":{"body":"PyTorch is a powerful deep learning framework...","comments_count":42,"created_at":"2026-01-18T09:15:00Z","group_id":"g1r2o3u4-5p6i-7890-abcd-ef1234567890","id":"p1o2s3t4-5i6d-7890-abcd-ef1234567890","loves_count":156,"post_type":"text","reason":"Based on your interests in machine learning","recommendation_score":0.93,"title":"Getting Started with PyTorch","user_id":"a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d"}},"app__schemas__search__RecommendedUser":{"properties":{"id":{"type":"string","title":"Id","description":"User ID"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username","description":"Username"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name","description":"Full name"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio","description":"User bio"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"Avatar URL"},"follower_count":{"type":"integer","title":"Follower Count","description":"Number of followers","default":0},"mutual_friends_count":{"type":"integer","title":"Mutual Friends Count","description":"Number of mutual friends","default":0},"recommendation_score":{"type":"number","maximum":1,"minimum":0,"title":"Recommendation Score","description":"Recommendation score"},"reason":{"type":"string","title":"Reason","description":"Reason for recommendation"}},"type":"object","required":["id","recommendation_score","reason"],"title":"RecommendedUser","description":"Recommended user item","example":{"avatar_url":"https://cdn.example.com/avatars/sarah.jpg","bio":"AI researcher specializing in NLP","follower_count":3421,"full_name":"Dr. Sarah Chen","id":"u1s2e3r4-5i6d-7890-abcd-ef1234567890","mutual_friends_count":12,"reason":"Similar interests and 12 mutual friends","recommendation_score":0.87,"username":"ai_researcher"}},"app__schemas__search_public__SearchSuggestionsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/SearchSuggestionsData"}},"type":"object","required":["success","data"],"title":"SearchSuggestionsResponse","description":"Response for GET /search/suggestions."},"app__schemas__settings__CommunicationSettingsResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/CommunicationSettings"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["data"],"title":"CommunicationSettingsResponse","description":"Response for GET/PUT /settings/communication"},"app__schemas__settings__NotificationPreferences":{"properties":{"email_notifications":{"type":"boolean","title":"Email Notifications","default":true},"push_notifications":{"type":"boolean","title":"Push Notifications","default":true},"marketing_emails":{"type":"boolean","title":"Marketing Emails","default":false},"ai_suggestions":{"type":"boolean","title":"Ai Suggestions","default":true},"system_updates":{"type":"boolean","title":"System Updates","default":true},"security_alerts":{"type":"boolean","title":"Security Alerts","default":true}},"type":"object","title":"NotificationPreferences","description":"User notification preferences (Issue #2191 response_model coverage)"},"app__schemas__social__FollowResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Follow relationship ID"},"follower_id":{"type":"string","title":"Follower Id","description":"Follower user ID"},"followed_id":{"type":"string","title":"Followed Id","description":"Followed user ID"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the follow was created"}},"type":"object","required":["id","follower_id","followed_id","created_at"],"title":"FollowResponse","description":"Response for follow/unfollow operations"},"app__schemas__social__MessageResponse":{"properties":{"message":{"type":"string","title":"Message","description":"Response message"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"Related user ID"}},"type":"object","required":["message"],"title":"MessageResponse","description":"Simple message response"},"app__schemas__social__UserSummary":{"properties":{"id":{"type":"string","title":"Id","description":"User ID"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"User email"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name","description":"User full name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"User avatar URL"}},"type":"object","required":["id"],"title":"UserSummary","description":"Summary of a user for social graph responses"},"app__schemas__streaming__ActivityFeedResponse":{"properties":{"activities":{"items":{"$ref":"#/components/schemas/app__schemas__streaming__ActivityItem"},"type":"array","title":"Activities"},"total":{"type":"integer","minimum":0,"title":"Total","description":"Total activity count"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Items per page"},"offset":{"type":"integer","minimum":0,"title":"Offset","description":"Offset for pagination"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more activities exist"}},"type":"object","required":["activities","total","limit","offset","has_more"],"title":"ActivityFeedResponse","description":"Activity feed response with pagination","example":{"activities":[{"data":{"user_id":"550e8400-e29b-41d4-a716-446655440000","username":"newFollower"},"timestamp":"2025-12-23T14:30:00Z","type":"new_follower"}],"has_more":true,"limit":20,"offset":0,"total":42}},"app__schemas__streaming__ActivityItem":{"properties":{"type":{"type":"string","title":"Type","description":"Activity type: new_follower, stream_started, stream_ended"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO 8601 timestamp"},"data":{"additionalProperties":true,"type":"object","title":"Data","description":"Activity-specific data"}},"type":"object","required":["type","timestamp","data"],"title":"ActivityItem","description":"Single activity item in feed","example":{"data":{"display_name":"New Follower","user_id":"550e8400-e29b-41d4-a716-446655440000","username":"newFollower"},"timestamp":"2025-12-23T14:30:00Z","type":"new_follower"}},"app__schemas__streaming__ChatHistoryResponse":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/app__schemas__streaming__ChatMessageResponse"},"type":"array","title":"Messages"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more messages exist before this batch"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Cursor for fetching next batch of older messages"}},"type":"object","required":["messages","has_more"],"title":"ChatHistoryResponse","description":"Paginated chat history response with cursor-based pagination","example":{"has_more":true,"messages":[{"content":"Great tutorial!","created_at":"2025-12-23T14:35:22Z","id":"msg111-2222-3333-4444-555566667777"}],"next_cursor":"msg000-1111-2222-3333-444455556666"}},"app__schemas__streaming__ChatMessageResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"stream_id":{"type":"string","format":"uuid","title":"Stream Id"},"user":{"$ref":"#/components/schemas/app__schemas__streaming__UserSummary"},"content":{"type":"string","title":"Content"},"message_type":{"$ref":"#/components/schemas/ChatMessageType","default":"message"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","stream_id","user","content","created_at"],"title":"ChatMessageResponse","description":"Schema for chat message response","example":{"content":"Great tutorial!","created_at":"2025-12-23T14:35:22Z","id":"msg111-2222-3333-4444-555566667777","message_type":"message","stream_id":"987e6543-e21b-12d3-a456-426614174000","user":{"display_name":"Viewer User","id":"aaa00000-e11b-22d3-a456-bbbbccccdddd","username":"viewer123"}}},"app__schemas__streaming__FollowResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"follower_id":{"type":"string","format":"uuid","title":"Follower Id"},"followed_id":{"type":"string","format":"uuid","title":"Followed Id"},"notifications_enabled":{"type":"boolean","title":"Notifications Enabled"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","follower_id","followed_id","notifications_enabled","created_at"],"title":"FollowResponse","description":"Schema for follow relationship response","example":{"created_at":"2025-12-20T10:00:00Z","followed_id":"550e8400-e29b-41d4-a716-446655440000","follower_id":"aaa00000-e11b-22d3-a456-bbbbccccdddd","id":"111e2222-e33b-44d5-a666-777788889999","notifications_enabled":true}},"app__schemas__streaming__QuickStats":{"properties":{"current_viewers":{"type":"integer","minimum":0,"title":"Current Viewers","description":"Current live viewers"},"new_followers_today":{"type":"integer","minimum":0,"title":"New Followers Today","description":"New followers today"},"chat_messages_today":{"type":"integer","minimum":0,"title":"Chat Messages Today","description":"Chat messages today"},"recent_peak_viewers":{"type":"integer","minimum":0,"title":"Recent Peak Viewers","description":"Peak viewers in last 7 days"},"is_live":{"type":"boolean","title":"Is Live","description":"Whether currently streaming"}},"type":"object","required":["current_viewers","new_followers_today","chat_messages_today","recent_peak_viewers","is_live"],"title":"QuickStats","description":"Quick statistics widget","example":{"chat_messages_today":234,"current_viewers":42,"is_live":true,"new_followers_today":5,"recent_peak_viewers":87}},"app__schemas__streaming__ScheduleCreate":{"properties":{"day_of_week":{"type":"integer","maximum":6,"minimum":0,"title":"Day Of Week","description":"Day of week: 0=Monday, 6=Sunday"},"start_time":{"type":"string","title":"Start Time","description":"Stream start time in HH:MM format (UTC)"},"end_time":{"type":"string","title":"End Time","description":"Stream end time in HH:MM format (UTC)"},"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Title","description":"Scheduled stream title"},"category_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Category Id","description":"Category ID for the scheduled stream"},"is_recurring":{"type":"boolean","title":"Is Recurring","description":"Whether this is a recurring weekly schedule","default":true}},"type":"object","required":["day_of_week","start_time","end_time"],"title":"ScheduleCreate","description":"Schema for creating a stream schedule entry","example":{"category_id":"123e4567-e89b-12d3-a456-426614174000","day_of_week":1,"end_time":"20:00","is_recurring":true,"start_time":"18:00","title":"Tuesday Evening Code Stream"}},"app__schemas__streaming__ScheduleResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"day_of_week":{"type":"integer","maximum":6,"minimum":0,"title":"Day Of Week","description":"Day of week: 0=Monday, 6=Sunday"},"start_time":{"type":"string","title":"Start Time","description":"Stream start time in HH:MM format (UTC)"},"end_time":{"type":"string","title":"End Time","description":"Stream end time in HH:MM format (UTC)"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryResponse"},{"type":"null"}]},"is_recurring":{"type":"boolean","title":"Is Recurring","default":true},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","user_id","day_of_week","start_time","end_time","created_at"],"title":"ScheduleResponse","description":"Schema for schedule entry response","example":{"category":{"id":"123e4567-e89b-12d3-a456-426614174000","name":"Programming","slug":"programming"},"created_at":"2025-12-20T10:00:00Z","day_of_week":1,"end_time":"20:00","id":"sched-1111-2222-3333-4444-555566667777","is_recurring":true,"start_time":"18:00","title":"Tuesday Evening Code Stream","updated_at":"2025-12-20T10:00:00Z","user_id":"550e8400-e29b-41d4-a716-446655440000"}},"app__schemas__streaming__SearchSuggestionsResponse":{"properties":{"suggestions":{"items":{"type":"string"},"type":"array","title":"Suggestions","description":"List of suggested search terms"},"query":{"type":"string","title":"Query","description":"Original query"}},"type":"object","required":["suggestions","query"],"title":"SearchSuggestionsResponse","description":"Search autocomplete suggestions","example":{"query":"FastAPI","suggestions":["FastAPI tutorial","FastAPI authentication","FastAPI websockets","FastAPI streaming","FastAPI deployment"]}},"app__schemas__streaming__UnreadCountResponse":{"properties":{"unread_count":{"type":"integer","minimum":0,"title":"Unread Count","description":"Count of unread notifications"}},"type":"object","required":["unread_count"],"title":"UnreadCountResponse","description":"Response for unread notification count","example":{"unread_count":15}},"app__schemas__streaming__UserSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"username":{"type":"string","title":"Username"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"}},"type":"object","required":["id","username"],"title":"UserSummary","description":"Minimal user information for lists and references","example":{"avatar_url":"https://storage.ainative.studio/avatars/viewer123.jpg","display_name":"Viewer User","id":"550e8400-e29b-41d4-a716-446655440000","username":"viewer123"}},"app__schemas__threads__ForkRequest":{"properties":{"message_id":{"type":"string","title":"Message Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"}},"type":"object","required":["message_id"],"title":"ForkRequest"},"app__schemas__vector_db__VectorSearchRequest":{"properties":{"vector":{"items":{"type":"number"},"type":"array","title":"Vector","description":"Query vector for similarity search"},"top_k":{"type":"integer","maximum":100,"minimum":1,"title":"Top K","default":10},"namespace":{"type":"string","title":"Namespace","default":"default"},"filter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter"},"include_metadata":{"type":"boolean","title":"Include Metadata","default":true},"include_vectors":{"type":"boolean","title":"Include Vectors","default":false}},"type":"object","required":["vector"],"title":"VectorSearchRequest","description":"Request model for vector search operations","example":{"filter":{"type":"text"},"include_metadata":true,"include_vectors":false,"namespace":"documents","top_k":5,"vector":[0.1,0.2,0.3]}},"app__schemas__vector_db__VectorSearchResult":{"properties":{"id":{"type":"string","title":"Id"},"score":{"type":"number","title":"Score"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"vector":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Vector"}},"type":"object","required":["id","score"],"title":"VectorSearchResult","description":"Individual search result model","example":{"id":"vec_123","metadata":{"source":"doc1"},"score":0.95,"vector":[0.1,0.2,0.3]}},"app__schemas__video_session__CreateSessionRequest":{"properties":{"session_name":{"type":"string","maxLength":200,"minLength":1,"title":"Session Name","description":"Session name/title"},"max_participants":{"type":"integer","maximum":50,"minimum":2,"title":"Max Participants","description":"Maximum number of participants","default":10},"duration_minutes":{"type":"integer","maximum":480,"minimum":15,"title":"Duration Minutes","description":"Session duration in minutes (15-480)","default":60},"recording_enabled":{"type":"boolean","title":"Recording Enabled","description":"Enable session recording","default":false},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Additional session metadata"}},"type":"object","required":["session_name"],"title":"CreateSessionRequest","description":"Request model for creating a video session","example":{"duration_minutes":60,"max_participants":10,"metadata":{"department":"engineering"},"recording_enabled":false,"session_name":"Team Standup"}},"app__schemas__video_session__SessionResponse":{"properties":{"session_id":{"type":"string","format":"uuid","title":"Session Id","description":"Unique session identifier"},"session_name":{"type":"string","title":"Session Name","description":"Session name"},"created_by":{"type":"string","format":"uuid","title":"Created By","description":"User ID of session creator"},"status":{"$ref":"#/components/schemas/app__schemas__video_session__SessionStatusEnum","description":"Session status"},"max_participants":{"type":"integer","title":"Max Participants","description":"Maximum participants allowed"},"current_participants":{"type":"integer","title":"Current Participants","description":"Current number of participants","default":0},"recording_enabled":{"type":"boolean","title":"Recording Enabled","description":"Whether recording is enabled"},"turn_credentials":{"anyOf":[{"$ref":"#/components/schemas/TURNCredentials"},{"type":"null"}],"description":"TURN server credentials"},"cloudflare_session_id":{"type":"string","title":"Cloudflare Session Id","description":"Cloudflare Calls session ID"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Session metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Session creation timestamp"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At","description":"Session start timestamp"},"ended_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ended At","description":"Session end timestamp"}},"type":"object","required":["session_id","session_name","created_by","status","max_participants","recording_enabled","cloudflare_session_id","created_at"],"title":"SessionResponse","description":"Response model for video session","example":{"cloudflare_session_id":"cf_session_abc123","created_at":"2026-01-18T10:00:00Z","created_by":"550e8400-e29b-41d4-a716-446655440001","current_participants":3,"max_participants":10,"recording_enabled":false,"session_id":"550e8400-e29b-41d4-a716-446655440000","session_name":"Team Standup","status":"active"}},"app__schemas__video_session__SessionStatusEnum":{"type":"string","enum":["active","ended","expired","terminated"],"title":"SessionStatusEnum","description":"Session status enumeration.\n\nMUST stay in lockstep with app.models.video_session.SessionStatus. #797\nremoved SCHEDULED/CANCELLED from the model and added EXPIRED/TERMINATED,\nbut this schema was never updated -- so a correctly-stored EXPIRED or\nTERMINATED session still failed response validation even once the service\nwas writing valid statuses. Refs #8488."},"app__schemas__video_session__TokenResponse":{"properties":{"token":{"type":"string","title":"Token","description":"JWT token for session access"},"expires_at":{"type":"string","format":"date-time","title":"Expires At","description":"Token expiration timestamp"},"turn_urls":{"items":{"type":"string"},"type":"array","title":"Turn Urls","description":"TURN server URLs"},"turn_username":{"type":"string","title":"Turn Username","description":"TURN username"},"turn_credential":{"type":"string","title":"Turn Credential","description":"TURN credential"}},"type":"object","required":["token","expires_at","turn_urls","turn_username","turn_credential"],"title":"TokenResponse","description":"Response model for session token","example":{"expires_at":"2026-01-18T11:00:00Z","token":"eyJhbGciOiJIUzI1NiIs...","turn_credential":"secret456","turn_urls":["turn:turn.ainative.studio:3478"],"turn_username":"user123"}},"app__zerodb__api__embeddings__EmbedAndStoreRequest":{"properties":{"texts":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Texts","description":"Texts to embed and store"},"metadata_list":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Metadata List","description":"Metadata for each text"},"namespace":{"type":"string","title":"Namespace","description":"ZeroDB namespace","default":"default"},"model":{"type":"string","title":"Model","description":"Embedding model (default: bge-m3, 1024-dim)","default":"bge-m3"}},"type":"object","required":["texts"],"title":"EmbedAndStoreRequest","description":"Embed texts and store in ZeroDB vector database"},"app__zerodb__api__embeddings__EmbedAndStoreResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"vectors_stored":{"type":"integer","title":"Vectors Stored"},"embeddings_generated":{"type":"integer","title":"Embeddings Generated"},"model":{"type":"string","title":"Model"},"dimensions":{"type":"integer","title":"Dimensions"},"target_column":{"type":"string","title":"Target Column","description":"Database column where vectors are stored"},"namespace":{"type":"string","title":"Namespace"},"project_id":{"type":"string","format":"uuid","title":"Project Id"},"processing_time_ms":{"type":"number","title":"Processing Time Ms"}},"type":"object","required":["success","vectors_stored","embeddings_generated","model","dimensions","target_column","namespace","project_id","processing_time_ms"],"title":"EmbedAndStoreResponse","description":"Response confirming storage in ZeroDB with dimension routing (Issue #309)"},"app__zerodb__api__embeddings__EmbeddingModelInfo":{"properties":{"name":{"type":"string","title":"Name","description":"Model identifier"},"dimensions":{"type":"integer","title":"Dimensions","description":"Vector dimensions"},"description":{"type":"string","title":"Description","description":"Model description and use case"},"speed":{"type":"string","title":"Speed","description":"Relative speed rating"},"cost":{"type":"string","title":"Cost","description":"Cost tier","default":"FREE"}},"type":"object","required":["name","dimensions","description","speed"],"title":"EmbeddingModelInfo","description":"Information about an available embedding model"},"app__zerodb__api__embeddings__GenerateEmbeddingsRequest":{"properties":{"texts":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Texts","description":"List of texts to embed (max 100)"},"model":{"type":"string","title":"Model","description":"Embedding model (default: bge-m3, 1024-dim via DO inference)","default":"bge-m3"},"normalize":{"type":"boolean","title":"Normalize","description":"Normalize embeddings to unit length","default":true}},"type":"object","required":["texts"],"title":"GenerateEmbeddingsRequest","description":"Generate embeddings for texts within a ZeroDB project context"},"app__zerodb__api__embeddings__GenerateEmbeddingsResponse":{"properties":{"embeddings":{"items":{"items":{"type":"number"},"type":"array"},"type":"array","title":"Embeddings"},"model":{"type":"string","title":"Model"},"dimensions":{"type":"integer","title":"Dimensions"},"count":{"type":"integer","title":"Count"},"processing_time_ms":{"type":"number","title":"Processing Time Ms"},"project_id":{"type":"string","format":"uuid","title":"Project Id"}},"type":"object","required":["embeddings","model","dimensions","count","processing_time_ms","project_id"],"title":"GenerateEmbeddingsResponse","description":"Response with generated embeddings"},"app__zerodb__api__embeddings__SemanticSearchRequest":{"properties":{"query":{"type":"string","title":"Query","description":"Search query text"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Maximum results","default":10},"threshold":{"type":"number","maximum":1,"minimum":0,"title":"Threshold","description":"Similarity threshold (0=match everything, 1=exact match only)","default":0.3},"namespace":{"type":"string","title":"Namespace","description":"ZeroDB namespace","default":"default"},"filter_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter Metadata","description":"Metadata filters"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Embedding model. If omitted, the model is AUTO-DETECTED from the namespace's stored vector dimension so the query matches the data (Refs WWMAA#685). Set explicitly to override."},"include_vectors":{"type":"boolean","title":"Include Vectors","description":"Include raw embedding vectors in results (default: false, saves ~82KB per response)","default":false}},"type":"object","required":["query"],"title":"SemanticSearchRequest","description":"Semantic search within a ZeroDB project"},"app__zerodb__api__embeddings__SemanticSearchResponse":{"properties":{"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results"},"query":{"type":"string","title":"Query"},"total_results":{"type":"integer","title":"Total Results"},"model":{"type":"string","title":"Model"},"project_id":{"type":"string","format":"uuid","title":"Project Id"},"processing_time_ms":{"type":"number","title":"Processing Time Ms"}},"type":"object","required":["results","query","total_results","model","project_id","processing_time_ms"],"title":"SemanticSearchResponse","description":"Semantic search results from ZeroDB"},"app__zerodb__api__project_router__ProjectStats":{"properties":{"project_id":{"type":"string","title":"Project Id"},"table_count":{"type":"integer","title":"Table Count","default":0},"row_count":{"type":"integer","title":"Row Count","default":0},"vector_count":{"type":"integer","title":"Vector Count","default":0},"memory_count":{"type":"integer","title":"Memory Count","default":0},"event_count":{"type":"integer","title":"Event Count","default":0},"storage_used_bytes":{"type":"integer","title":"Storage Used Bytes","default":0}},"type":"object","required":["project_id"],"title":"ProjectStats","description":"Stats for a single project in bulk response"},"app__zerodb__api__project_router__ProjectUsage":{"properties":{"vectors":{"type":"integer","title":"Vectors","default":0},"tables":{"type":"integer","title":"Tables","default":0},"events":{"type":"integer","title":"Events","default":0},"memory":{"type":"integer","title":"Memory","default":0},"storage":{"type":"integer","title":"Storage","default":0},"tier_limits":{"additionalProperties":{"type":"integer"},"type":"object","title":"Tier Limits"}},"type":"object","title":"ProjectUsage","description":"Usage metrics for a project"},"app__zerodb__schemas__auth__LoginRequest":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"password":{"type":"string","title":"Password"}},"type":"object","required":["password"],"title":"LoginRequest","description":"Schema for login request\n\nAccepts both 'email' and 'username' fields for maximum flexibility.\nEither field can be used to provide the user's email address.\n\nExamples:\n {\"email\": \"user@example.com\", \"password\": \"...\"}\n {\"username\": \"user@example.com\", \"password\": \"...\"}\n\nIssue: #993","example":{"email":"user@example.com","password":"securepassword123"}},"app__zerodb__schemas__auth__ResetPasswordRequest":{"properties":{"token":{"type":"string","title":"Token"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["token","new_password"],"title":"ResetPasswordRequest","description":"Schema for reset password request"},"app__zerodb__schemas__auth__TokenResponse":{"properties":{"access_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"},"refresh_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"user":{"$ref":"#/components/schemas/UserResponse"},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"api_key_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key Preview"},"email_verification_required":{"type":"boolean","title":"Email Verification Required","default":false},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["user"],"title":"TokenResponse","description":"Schema for token response"},"app__zerodb__schemas__database__BulkDeleteRequest":{"properties":{"filter":{"additionalProperties":true,"type":"object","title":"Filter","description":"MongoDB-style filter to match rows for deletion"},"confirm_large_operation":{"type":"boolean","title":"Confirm Large Operation","description":"Confirmation flag required for operations affecting >100 rows","default":false}},"type":"object","required":["filter"],"title":"BulkDeleteRequest","description":"Request schema for bulk row deletions"},"app__zerodb__schemas__database__DatabaseMetricsResponse":{"properties":{"connections":{"type":"integer","title":"Connections","description":"Active database connections"},"queries_per_sec":{"type":"number","title":"Queries Per Sec","description":"Queries per second"},"cache_hit_rate":{"type":"number","title":"Cache Hit Rate","description":"Cache hit rate (0.0 - 1.0)"},"latency_ms":{"type":"number","title":"Latency Ms","description":"Average query latency in milliseconds"}},"type":"object","required":["connections","queries_per_sec","cache_hit_rate","latency_ms"],"title":"DatabaseMetricsResponse","description":"Response schema for database performance metrics"},"app__zerodb__schemas__database__EventCreate":{"properties":{"topic":{"type":"string","title":"Topic","description":"Event topic"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Event payload"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"Project ID (set automatically)"}},"type":"object","required":["topic","event_payload"],"title":"EventCreate","description":"Schema for creating events"},"app__zerodb__schemas__database__EventResponse":{"properties":{"topic":{"type":"string","title":"Topic","description":"Event topic"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Event payload"},"event_id":{"type":"string","format":"uuid","title":"Event Id","description":"Unique identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Unique identifier"},"published_at":{"type":"string","format":"date-time","title":"Published At","description":"Timestamp"}},"type":"object","required":["topic","event_payload","event_id","project_id","published_at"],"title":"EventResponse","description":"Complete event response schema"},"app__zerodb__schemas__database__MemorySearchResult":{"properties":{"memories":{"items":{"$ref":"#/components/schemas/MemoryRecordResponse"},"type":"array","title":"Memories","description":"Matching memory records"},"total_count":{"type":"integer","title":"Total Count","description":"Total matching memories"},"search_time_ms":{"type":"number","title":"Search Time Ms","description":"Search time in milliseconds"}},"type":"object","required":["memories","total_count","search_time_ms"],"title":"MemorySearchResult","description":"MemorySearchResult schema"},"app__zerodb__schemas__database__RLHFInteractionResponse__1":{"properties":{"interaction_id":{"type":"string","title":"Interaction Id","description":"Unique interaction identifier"},"project_id":{"type":"string","title":"Project Id","description":"Project the interaction belongs to"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","description":"User who logged the interaction"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id","description":"RLHF session this interaction belongs to"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id","description":"Agent that produced the response"},"prompt":{"type":"string","title":"Prompt","description":"User prompt/input"},"response":{"type":"string","title":"Response","description":"Agent/model response"},"feedback":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback","description":"Feedback category: positive, negative, or mixed"},"reward":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward","description":"Numeric reward signal derived from feedback"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Model that generated the response"},"human_feedback":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Feedback","description":"Free-text human feedback"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Tags associated with the interaction"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Additional context supplied with the interaction"},"expected_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Response","description":"Expected/ideal response, if provided"},"improvement_suggestions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Improvement Suggestions","description":"Suggestions for improving the response"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Arbitrary interaction metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"ISO 8601 creation timestamp"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At","description":"ISO 8601 last-update timestamp"}},"type":"object","required":["interaction_id","project_id","prompt","response"],"title":"RLHFInteractionResponse","description":"Full RLHF interaction record, as returned by RLHFInteraction.to_dict()"},"app__zerodb__schemas__database__RLHFInteractionResponse__2":{"properties":{"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id","description":"Session identifier"},"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id","description":"Agent identifier"},"user_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Message","description":"User message content"},"agent_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Response","description":"Agent response content"},"feedback_rating":{"anyOf":[{"type":"integer","maximum":5,"minimum":1},{"type":"null"}],"title":"Feedback Rating","description":"Feedback rating (1-5)"},"feedback_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Comment","description":"Feedback comment"},"feedback_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Type","description":"Feedback type (positive, negative, neutral)"},"interaction_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Interaction Metadata","description":"Interaction metadata"},"interaction_id":{"type":"string","format":"uuid","title":"Interaction Id","description":"Unique interaction identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Project identifier"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["interaction_id","project_id","created_at","updated_at"],"title":"RLHFInteractionResponse","description":"Complete RLHF interaction response schema"},"app__zerodb__schemas__database__RLHFSessionResponse__1":{"properties":{"id":{"type":"string","title":"Id","description":"Session identifier (alias of session_id)"},"session_id":{"type":"string","title":"Session Id","description":"Unique session identifier"},"project_id":{"type":"string","title":"Project Id","description":"Project the session belongs to"},"status":{"type":"string","title":"Status","description":"Session status: active, stopped, or completed"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At","description":"ISO 8601 timestamp the session started"},"stopped_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stopped At","description":"ISO 8601 timestamp the session stopped"},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Session configuration"},"total_interactions":{"type":"integer","title":"Total Interactions","description":"Total interactions logged in this session"},"total_feedback_count":{"type":"integer","title":"Total Feedback Count","description":"Total interactions with non-mixed feedback"},"interaction_count":{"type":"integer","title":"Interaction Count","description":"Alias of total_interactions, kept for frontend compatibility"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","description":"ISO 8601 creation timestamp"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At","description":"ISO 8601 last-update timestamp"}},"type":"object","required":["id","session_id","project_id","status","total_interactions","total_feedback_count","interaction_count"],"title":"RLHFSessionResponse","description":"Full RLHF session record"},"app__zerodb__schemas__database__RLHFSessionResponse__2":{"properties":{"status":{"type":"string","title":"Status","description":"Session status (active, stopped, completed)","default":"active"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config","description":"Session configuration"},"session_id":{"type":"string","format":"uuid","title":"Session Id","description":"Unique session identifier"},"project_id":{"type":"string","format":"uuid","title":"Project Id","description":"Project identifier"},"started_at":{"type":"string","format":"date-time","title":"Started At","description":"Session start timestamp"},"stopped_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Stopped At","description":"Session stop timestamp"},"total_interactions":{"type":"integer","title":"Total Interactions","description":"Total interactions in session","default":0},"total_feedback_count":{"type":"integer","title":"Total Feedback Count","description":"Total feedback count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Last update timestamp"}},"type":"object","required":["session_id","project_id","started_at","created_at","updated_at"],"title":"RLHFSessionResponse","description":"Complete RLHF session response schema"},"app__zerodb__schemas__database__VectorSearchRequest":{"properties":{"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id","description":"Project ID (set automatically)"},"query_vector":{"items":{"type":"number"},"type":"array","title":"Query Vector","description":"Query vector embedding"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace","description":"Vector namespace","default":"default"},"limit":{"type":"integer","title":"Limit","description":"Number of results to return","default":10},"threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Threshold","description":"Similarity threshold"},"metadata_filter":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata Filter","description":"Metadata filters"}},"type":"object","required":["query_vector"],"title":"VectorSearchRequest","description":"VectorSearchRequest schema"},"app__zerodb__schemas__database__VectorSearchResult":{"properties":{"vectors":{"items":{"$ref":"#/components/schemas/VectorResponse"},"type":"array","title":"Vectors","description":"Matching vectors"},"total_count":{"type":"integer","title":"Total Count","description":"Total matching vectors"},"search_time_ms":{"type":"number","title":"Search Time Ms","description":"Search time in milliseconds"}},"type":"object","required":["vectors","total_count","search_time_ms"],"title":"VectorSearchResult","description":"VectorSearchResult schema"},"app__zerodb__schemas__database_public_responses__DeleteFileResponse":{"properties":{"message":{"type":"string","title":"Message"},"file_name":{"type":"string","title":"File Name"}},"type":"object","required":["message","file_name"],"title":"DeleteFileResponse","description":"delete_file returns db_service.delete_file's result verbatim, which is\n{\"message\": ..., \"file_name\": ...} per DatabaseService.delete_file."},"app__zerodb__schemas__database_public_responses__DeleteVectorResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"DeleteVectorResponse","description":"delete_vector returns db_service.delete_vector's result verbatim\n(typically {\"message\": ...})."},"app__zerodb__schemas__database_public_responses__DownloadFileResponse":{"properties":{"download_url":{"type":"string","title":"Download Url"},"file_name":{"type":"string","title":"File Name"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["download_url","file_name","expires_at"],"title":"DownloadFileResponse","description":"download_file returns db_service.download_file's result verbatim, per\nDatabaseService.download_file."},"app__zerodb__schemas__database_public_responses__GetFileStatsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"total_files":{"type":"integer","title":"Total Files"},"total_size_bytes":{"type":"integer","title":"Total Size Bytes"},"files_by_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"Files By Type"},"storage_usage_mb":{"type":"integer","title":"Storage Usage Mb"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["project_id","total_files","total_size_bytes","files_by_type","storage_usage_mb","timestamp"],"title":"GetFileStatsResponse"},"app__zerodb__schemas__database_public_responses__RecentActivityItem":{"properties":{"log_id":{"type":"string","title":"Log Id"},"timestamp":{"type":"string","title":"Timestamp"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"log_level":{"type":"string","title":"Log Level"},"message":{"type":"string","title":"Message"},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"}},"type":"object","required":["log_id","timestamp","log_level","message"],"title":"RecentActivityItem"},"app__zerodb__schemas__database_public_responses__UploadFileBinaryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"file_id":{"type":"string","title":"File Id"},"file_key":{"type":"string","title":"File Key"},"size_bytes":{"type":"integer","title":"Size Bytes"},"minio_result":{"additionalProperties":true,"type":"object","title":"Minio Result"},"message":{"type":"string","title":"Message"},"sha256_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256 Hash"}},"type":"object","required":["success","file_id","file_key","size_bytes","minio_result","message"],"title":"UploadFileBinaryResponse"},"app__zerodb__schemas__file_storage_responses__DeleteFileResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"file_id":{"type":"string","title":"File Id"},"deleted_from_storage":{"type":"boolean","title":"Deleted From Storage"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","file_id","deleted_from_storage","message"],"title":"DeleteFileResponse"},"app__zerodb__schemas__file_storage_responses__DownloadFileResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"file_id":{"type":"string","title":"File Id"},"file_name":{"type":"string","title":"File Name"},"file_key":{"type":"string","title":"File Key"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"download_url":{"type":"string","title":"Download Url"},"expires_in_seconds":{"type":"integer","title":"Expires In Seconds"}},"type":"object","required":["success","file_id","file_name","file_key","download_url","expires_in_seconds"],"title":"DownloadFileResponse"},"app__zerodb__schemas__file_storage_responses__GetFileStatsResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"total_files":{"type":"integer","title":"Total Files"},"total_size_bytes":{"type":"integer","title":"Total Size Bytes"},"average_file_size_bytes":{"type":"integer","title":"Average File Size Bytes"},"largest_file_bytes":{"type":"integer","title":"Largest File Bytes"},"files_by_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"Files By Type"},"by_content_type":{"items":{"$ref":"#/components/schemas/FileStatsContentTypeBreakdown"},"type":"array","title":"By Content Type"},"storage_usage_mb":{"type":"number","title":"Storage Usage Mb"},"timestamp":{"type":"string","title":"Timestamp"},"video_count":{"type":"integer","title":"Video Count"},"video_size_bytes":{"type":"integer","title":"Video Size Bytes"},"total_size_mb":{"type":"number","title":"Total Size Mb"}},"type":"object","required":["project_id","total_files","total_size_bytes","average_file_size_bytes","largest_file_bytes","files_by_type","by_content_type","storage_usage_mb","timestamp","video_count","video_size_bytes","total_size_mb"],"title":"GetFileStatsResponse"},"app__zerodb__schemas__file_storage_responses__UploadFileBinaryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"file_id":{"type":"string","title":"File Id"},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name"},"file_key":{"type":"string","title":"File Key"},"size_bytes":{"type":"integer","title":"Size Bytes"},"size_mb":{"type":"number","title":"Size Mb"},"content_type":{"type":"string","title":"Content Type"},"bucket":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bucket"},"storage_usage_mb":{"type":"number","title":"Storage Usage Mb"},"minio_result":{"additionalProperties":true,"type":"object","title":"Minio Result"},"message":{"type":"string","title":"Message"},"sha256_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256 Hash"}},"type":"object","required":["success","file_id","file_key","size_bytes","size_mb","content_type","storage_usage_mb","minio_result","message"],"title":"UploadFileBinaryResponse"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"},"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}}},"servers":[{"url":"https://api.ainative.studio","description":"Production"}]}