{"openapi":"3.1.0","info":{"title":"Uely-3000 API","description":"FastAPI backend for Uely-3000 - Agricultural AI Management System","version":"0.1.0"},"paths":{"/chat/messages/{message_id}/read":{"post":{"tags":["api","chat"],"summary":"Mark Message Read","description":"Mark a chat message as read for the user's namespace.","operationId":"mark_message_read_chat_messages__message_id__read_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","title":"Message Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/messages/{message_id}/cancel":{"post":{"tags":["api","chat"],"summary":"Cancel Message","description":"Cancel an in-progress chat message.","operationId":"cancel_message_chat_messages__message_id__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","title":"Message Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/imagery/urls":{"post":{"tags":["api","chat"],"summary":"Sign Imagery Urls","description":"Mint fresh signed URLs for durable imagery paths owned by the caller's namespace.","operationId":"sign_imagery_urls_chat_imagery_urls_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageryUrlsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageryUrlsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/chat/agui":{"post":{"tags":["api","chat"],"summary":"Chat Agui","description":"Stream AI chat via AG-UI RunAgentInput (assistant-ui HttpAgent).","operationId":"chat_agui_chat_agui_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunAgentInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/training":{"post":{"tags":["api","Training"],"summary":"Submit Training","description":"Submit training document for processing.\n\nUploads the original to S3 (sources/) and queues background ingestion.","operationId":"submit_training_training_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_submit_training_training_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrainingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/training/memory-stats":{"get":{"tags":["api","Training"],"summary":"Get Memory Stats","description":"Real Cognee graph size (nodes + edges) of the caller's personal namespace.\n\nRead preset (billing, 30/min) instead of the 5/min upload backstop — this\nmounts with the Training page. Fail-soft: 0 when the graph is unavailable.","operationId":"get_memory_stats_training_memory_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryStatsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/training/previews":{"post":{"tags":["api","Training"],"summary":"Get Training Document Previews","description":"Return first-page preview URLs for accessible uploaded sources.","operationId":"get_training_document_previews_training_previews_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourcePreviewsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourcePreviewsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/training/{document_id}/url":{"get":{"tags":["api","Training"],"summary":"Get Training Document Url","description":"Return a short-lived S3 presigned URL for a source original.","operationId":"get_training_document_url_training__document_id__url_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceUrlResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/training/{document_id}":{"delete":{"tags":["api","Training"],"summary":"Delete Training Document","description":"Cascade-delete any accessible source (S3 + Cognee + row).","operationId":"delete_training_document_training__document_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transcription":{"post":{"tags":["api","Transcription"],"summary":"Create Transcription","description":"Transcribe a short voice clip for chat dictation.\n\nRecord-then-transcribe path: client records with MediaRecorder, uploads the\nblob here, and inserts the returned text into the composer.","operationId":"create_transcription_transcription_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_transcription_transcription_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/browser/sessions":{"post":{"tags":["api","Browser"],"summary":"Create Browser Session","operationId":"create_browser_session_browser_sessions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBrowserSessionRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBrowserSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/browser/sessions/{session_id}/confirm":{"post":{"tags":["api","Browser"],"summary":"Confirm Browser Session","operationId":"confirm_browser_session_browser_sessions__session_id__confirm_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmBrowserSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/browser/jobs":{"get":{"tags":["api","Browser"],"summary":"List Browser Jobs","operationId":"list_browser_jobs_browser_jobs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrowserJobListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/browser/jobs/{job_id}":{"get":{"tags":["api","Browser"],"summary":"Get Browser Job","operationId":"get_browser_job_browser_jobs__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrowserJobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/browser/jobs/{job_id}/answer":{"post":{"tags":["api","Browser"],"summary":"Answer Browser Job","operationId":"answer_browser_job_browser_jobs__job_id__answer_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerBrowserJobRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerBrowserJobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/browser/jobs/{job_id}/screenshots":{"get":{"tags":["api","Browser"],"summary":"Get Browser Job Screenshots","operationId":"get_browser_job_screenshots_browser_jobs__job_id__screenshots_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrowserJobScreenshotsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/browser/jobs/{job_id}/recording":{"get":{"tags":["api","Browser"],"summary":"Get Browser Job Recording","operationId":"get_browser_job_recording_browser_jobs__job_id__recording_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrowserJobRecordingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weather/report":{"get":{"tags":["api","Weather"],"summary":"Get Weather Report","description":"Get a cached Bauernregel for the user's home location.\n\n- No home location → available=false with a location helper message.\n- With location → available=true and a one-line Bauernregel.","operationId":"get_weather_report_weather_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeatherReportResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/profile":{"patch":{"tags":["api","Profile"],"summary":"Patch Profile","description":"Update non-location profile fields for the authenticated user.","operationId":"patch_profile_profile_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/profile/location":{"patch":{"tags":["api","Profile"],"summary":"Patch Profile Location","description":"Write profile home coordinates.\n\nCoordinates only — the typed address lives on PATCH /profile and is never\nderived from the pin.","operationId":"patch_profile_location_profile_location_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileLocationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileLocationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/media/upload-urls":{"post":{"tags":["api","Media"],"summary":"Create Media Upload Urls","operationId":"create_media_upload_urls_media_upload_urls_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaUploadUrlsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaUploadUrlsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/media/sign-urls":{"post":{"tags":["api","Media"],"summary":"Sign Media Urls","operationId":"sign_media_urls_media_sign_urls_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaSignUrlsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaSignUrlsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/media/delete":{"post":{"tags":["api","Media"],"summary":"Delete Media Objects","operationId":"delete_media_objects_media_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaDeleteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/namespace/{namespace_id}/cleanup":{"post":{"tags":["api","Namespace"],"summary":"Cleanup Namespace","description":"Clean up external services for namespace reset (Cognee-only).\n\nCalled by backend services during hard-delete namespace cleanup.\nRemoves Cognee user dataset for this namespace.","operationId":"cleanup_namespace_namespace__namespace_id__cleanup_post","parameters":[{"name":"namespace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Namespace Id"}},{"name":"X-Service-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Service-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Cleanup Namespace Namespace  Namespace Id  Cleanup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/namespace/reset":{"post":{"tags":["api","Namespace"],"summary":"Reset Namespace","description":"Reset user's personal namespace.\n\nThis endpoint replaces the `reset-namespace` edge function. It completely\nresets a user's personal namespace by:\n- Cancelling pending transactions\n- Cleaning external services\n- Deleting storage files\n- Creating a new empty namespace\n- Hard-deleting the old namespace (cascade delete of scoped data)\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user: Authenticated user\n    service: Namespace service\n\nReturns:\n    ResetNamespaceResponse with new namespace ID\n\nRaises:\n    HTTPException: 404 if user not found or has no namespace, 500 on server error","operationId":"reset_namespace_namespace_reset_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetNamespaceResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/notifications/welcome":{"post":{"tags":["api","notifications"],"summary":"Send Welcome Notification","description":"Send welcome email to a new user.\n\nThis endpoint is called from the create-user-profile edge function\nafter a new user profile is created.\n\nProtected by X-Service-Key. Validates that user_id exists and that\nthe supplied email matches the stored profile before sending.","operationId":"send_welcome_notification_notifications_welcome_post","parameters":[{"name":"X-Service-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Service-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WelcomeNotificationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/team-invitation":{"post":{"tags":["api","notifications"],"summary":"Send Team Invitation Notification","description":"Send team invitation notification.\n\nCalled when a user invites another user to a team.\nThe caller must be authenticated (they are the one sending the invite).","operationId":"send_team_invitation_notification_notifications_team_invitation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamInvitationNotificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/notifications/job-invitation":{"post":{"tags":["api","notifications"],"summary":"Send Job Invitation Notification","description":"Send job invitation notification.\n\nCalled when a user invites another user to a job.\nThe caller must be authenticated.","operationId":"send_job_invitation_notification_notifications_job_invitation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobInvitationNotificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/notifications":{"get":{"tags":["api","notifications"],"summary":"List Notifications","description":"List in-app notifications for current user.","operationId":"list_notifications_notifications_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppNotificationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/{notification_id}/read":{"post":{"tags":["api","notifications"],"summary":"Mark Notification Read","description":"Mark one user notification as read.","operationId":"mark_notification_read_notifications__notification_id__read_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Notification Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppNotification"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/unread-counts":{"get":{"tags":["api","notifications"],"summary":"Get Unread Counts","description":"Return unread in-app notification counts for current user.","operationId":"get_unread_counts_notifications_unread_counts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppNotificationUnreadCountsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/preferences":{"get":{"tags":["api","notifications"],"summary":"Get Notification Preferences","description":"Get notification preferences for current user.","operationId":"get_notification_preferences_notifications_preferences_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPreferencesResponse"}}}}},"security":[{"HTTPBearer":[]}]},"patch":{"tags":["api","notifications"],"summary":"Update Notification Preferences","description":"Update notification preferences for current user.","operationId":"update_notification_preferences_notifications_preferences_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPreferencesUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPreferencesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/notifications/devices":{"post":{"tags":["api","notifications"],"summary":"Register Notification Device","description":"Register or refresh a push device token (Capacitor / future APNs-FCM).","operationId":"register_notification_device_notifications_devices_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationDeviceRegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationDeviceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/notifications/devices/{token}":{"delete":{"tags":["api","notifications"],"summary":"Unregister Notification Device","description":"Remove a push device token for the current user.","operationId":"unregister_notification_device_notifications_devices__token__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/onboarding/seed-example-data":{"post":{"tags":["api","Onboarding"],"summary":"Seed Example Data","description":"Seed example documents, drafts, teams, and the Flo support thread once per user.\n\nIdempotent via ``users.example_data_seeded_at``. Rate-limited to throttle\nrepeats; the check-then-seed is not DB-atomic (accepted low-risk).","operationId":"seed_example_data_onboarding_seed_example_data_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeedExampleDataResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/users/validate-username":{"post":{"tags":["api","users"],"summary":"Validate Username Endpoint","description":"Validate a username against all rules.\n\nThis endpoint validates usernames for:\n- Length (3-20 characters)\n- Character set (lowercase letters, numbers, underscores, hyphens)\n- Separator placement (no leading, trailing, or repeated separators)\n- Minimum letter requirement (at least 2 letters)\n- Reserved names (system, brand, official)\n- Offensive content\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    payload: Username validation request\n\nReturns:\n    UsernameValidationResponse with valid flag and optional error details","operationId":"validate_username_endpoint_users_validate_username_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsernameValidationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsernameValidationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/users/account":{"delete":{"tags":["api","users"],"summary":"Delete Account","description":"Delete user account permanently.\n\nThis operation:\n- Cancels Stripe subscriptions (best-effort)\n- Cleans external services (best-effort)\n- Deletes auth user (cascade)\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user: Authenticated user\n    service: User service\n\nReturns:\n    DeleteAccountResponse with success message\n\nRaises:\n    HTTPException: 404 if user not found, 500 on server error","operationId":"delete_account_users_account_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/check-subscription":{"post":{"tags":["api","billing"],"summary":"Check Subscription","description":"Check user's Stripe subscription and sync with database.","operationId":"check_subscription_billing_check_subscription_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckSubscriptionResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/checkout":{"post":{"tags":["api","billing"],"summary":"Create Checkout","description":"Create a Stripe checkout session with duplicate subscription protection.","operationId":"create_checkout_billing_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/portal":{"post":{"tags":["api","billing"],"summary":"Create Portal","description":"Create a Stripe customer portal session.","operationId":"create_portal_billing_portal_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/verify-checkout":{"post":{"tags":["api","billing"],"summary":"Verify Checkout","description":"Converge a completed checkout session after the redirect back.\n\nThe webhook remains the source of truth; this endpoint lets the client\nsettle the common case immediately instead of polling for the webhook.\nCredit grants are idempotent on the session id, so whichever path runs\nfirst wins and the other is a no-op.","operationId":"verify_checkout_billing_verify_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyCheckoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/usage-history":{"get":{"tags":["api","billing"],"summary":"Get Usage History","description":"Get AI usage history for the current user.","operationId":"get_usage_history_billing_usage_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/billing/invoices":{"get":{"tags":["api","billing"],"summary":"List Billing Invoices","description":"List platform Stripe invoices for the Rechnungen tab.","operationId":"list_billing_invoices_billing_invoices_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingInvoicesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/connect/account":{"get":{"tags":["api","connect"],"summary":"Get Connect Account","description":"Return the current user's connected-account onboarding status.","operationId":"get_connect_account_connect_account_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectAccountStatus"}}}}},"security":[{"HTTPBearer":[]}]}},"/connect/onboarding":{"post":{"tags":["api","connect"],"summary":"Create Connect Onboarding","description":"Ensure the user has a connected account (for embedded onboarding).","operationId":"create_connect_onboarding_connect_onboarding_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnboardingResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/connect/account-session":{"post":{"tags":["api","connect"],"summary":"Create Connect Account Session","description":"Create an Account Session client secret for embedded Connect components.","operationId":"create_connect_account_session_connect_account_session_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSessionResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/connect/login-link":{"post":{"tags":["api","connect"],"summary":"Create Connect Login Link","description":"Create a single-use Express Dashboard login link for the current user.","operationId":"create_connect_login_link_connect_login_link_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginLinkResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/marketplace/feed":{"get":{"tags":["api","Marketplace"],"summary":"Marketplace Feed","description":"In-app marketplace feed: ranked by default, semantic when ``q`` is set.","operationId":"marketplace_feed_marketplace_feed_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"enum":["product","job"],"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"}},{"name":"lng","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lng"}},{"name":"radius_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Radius Km"}},{"name":"audience","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Audience"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Category"}},{"name":"sort","in":"query","required":false,"schema":{"enum":["recommended","nearest","newest"],"type":"string","default":"recommended","title":"Sort"}},{"name":"farm","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Farm"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":24,"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/MarketplaceFeedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/invoices":{"post":{"tags":["api","invoices"],"summary":"Create Invoice","description":"Create and finalize a payment request; returns the hosted payment link.","operationId":"create_invoice_invoices_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInvoiceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["api","invoices"],"summary":"List Invoices","description":"List invoices for the Gestellt (in) or Erhalten (out) tab.","operationId":"list_invoices_invoices_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"direction","in":"query","required":false,"schema":{"type":"string","description":"in (Gestellt) or out (Erhalten)","default":"in","title":"Direction"},"description":"in (Gestellt) or out (Erhalten)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/invoices/by-job/{job_id}":{"get":{"tags":["api","invoices"],"summary":"Get Invoice For Job","description":"Return the invoice linked to a job, if any.","operationId":"get_invoice_for_job_invoices_by_job__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InvoiceResponse"},{"type":"null"}],"title":"Response Get Invoice For Job Invoices By Job  Job Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/invoices/{invoice_id}":{"get":{"tags":["api","invoices"],"summary":"Get Invoice","description":"Return a single invoice the caller is party to (issuer or payer).","operationId":"get_invoice_invoices__invoice_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/invoices/{invoice_id}/send":{"post":{"tags":["api","invoices"],"summary":"Send Invoice","description":"Email the branded hosted invoice link via Stripe (external recipient).","operationId":"send_invoice_invoices__invoice_id__send_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/invoices/{invoice_id}/void":{"post":{"tags":["api","invoices"],"summary":"Void Invoice","description":"Void a finalized invoice (issuer only).","operationId":"void_invoice_invoices__invoice_id__void_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/teams":{"post":{"tags":["api","teams"],"summary":"Create Team","description":"Create a new team with namespace and admin membership.","operationId":"create_team_teams_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTeamRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/teams/{team_id}":{"patch":{"tags":["api","teams"],"summary":"Update Team","description":"Update team settings (admin only).","operationId":"update_team_teams__team_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTeamRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","teams"],"summary":"Delete Team","description":"Hard delete a team and clean up external services.","operationId":"delete_team_teams__team_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/teams/{team_id}/invitations":{"post":{"tags":["api","teams"],"summary":"Invite Member","description":"Invite a user to a team.","operationId":"invite_member_teams__team_id__invitations_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamInvitationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamMembershipResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/teams/invitations/{membership_id}/accept":{"post":{"tags":["api","teams"],"summary":"Accept Invitation","description":"Accept a pending team invitation.","operationId":"accept_invitation_teams_invitations__membership_id__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"membership_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Membership Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembershipActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/teams/invitations/{membership_id}/decline":{"post":{"tags":["api","teams"],"summary":"Decline Invitation","description":"Decline a pending team invitation.","operationId":"decline_invitation_teams_invitations__membership_id__decline_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"membership_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Membership Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembershipActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/teams/{team_id}/messages":{"post":{"tags":["api","teams"],"summary":"Send Team Message","description":"Send a message to team chat.","operationId":"send_team_message_teams__team_id__messages_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamMessageRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamMessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/teams/{team_id}/join":{"post":{"tags":["api","teams"],"summary":"Join Public Team","description":"Join a public team.","operationId":"join_public_team_teams__team_id__join_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembershipActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/teams/{team_id}/leave":{"post":{"tags":["api","teams"],"summary":"Leave Team","description":"Leave a team.","operationId":"leave_team_teams__team_id__leave_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembershipActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/teams/{team_id}/members/{member_user_id}":{"delete":{"tags":["api","teams"],"summary":"Remove Member","description":"Remove a member from a team (admin only).","operationId":"remove_member_teams__team_id__members__member_user_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"member_user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Member User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembershipActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/connections":{"get":{"tags":["api","connections"],"summary":"List Connections","description":"List the caller's connections (accepted + pending both directions).","operationId":"list_connections_connections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionListResponse"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["api","connections"],"summary":"Create Connection","description":"Request a connection by username (\"kollegisieren\").","operationId":"create_connection_connections_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConnectionRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/connections/pending-count":{"get":{"tags":["api","connections"],"summary":"Pending Connection Count","description":"Incoming pending request count (sidebar badge).","operationId":"pending_connection_count_connections_pending_count_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingConnectionCountResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/connections/{connection_id}/accept":{"post":{"tags":["api","connections"],"summary":"Accept Connection","description":"Accept an incoming pending request (addressee only).","operationId":"accept_connection_connections__connection_id__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Connection Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/connections/{connection_id}/decline":{"post":{"tags":["api","connections"],"summary":"Decline Connection","description":"Decline an incoming pending request (addressee only).","operationId":"decline_connection_connections__connection_id__decline_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Connection Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/connections/{connection_id}":{"delete":{"tags":["api","connections"],"summary":"Delete Connection","description":"Remove a connection or withdraw an own pending request (either participant).","operationId":"delete_connection_connections__connection_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Connection Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/invites":{"post":{"tags":["api","connections"],"summary":"Create Invite","description":"Create a single-use external invite link (connection/team/job).","operationId":"create_invite_invites_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInviteRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteLinkResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/invites/{token}":{"get":{"tags":["api","connections"],"summary":"Preview Invite","description":"Public anon-safe invite preview. 404 unknown, 410 claimed/expired.","operationId":"preview_invite_invites__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/InvitePreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/invites/{token}/claim":{"post":{"tags":["api","connections"],"summary":"Claim Invite","description":"Claim an invite link: connection auto-accepts, team joins active, job applies.","operationId":"claim_invite_invites__token__claim_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimInviteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/parties":{"get":{"tags":["api","Parties"],"summary":"List Parties","operationId":"list_parties_parties_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api","Parties"],"summary":"Create Party","operationId":"create_party_parties_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/parties/{party_id}":{"get":{"tags":["api","Parties"],"summary":"Get Party","operationId":"get_party_parties__party_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"party_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Party Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["api","Parties"],"summary":"Update Party","operationId":"update_party_parties__party_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"party_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Party Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","Parties"],"summary":"Delete Party","operationId":"delete_party_parties__party_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"party_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Party Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/parties/{party_id}/merge":{"post":{"tags":["api","Parties"],"summary":"Merge Party","operationId":"merge_party_parties__party_id__merge_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"party_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Party Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyMergeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/places":{"get":{"tags":["api","Places"],"summary":"List Places","operationId":"list_places_places_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"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":"include_geometry","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Geometry"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api","Places"],"summary":"Create Place","operationId":"create_place_places_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/places/{place_id}":{"get":{"tags":["api","Places"],"summary":"Get Place","operationId":"get_place_places__place_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Place Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["api","Places"],"summary":"Update Place","operationId":"update_place_places__place_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Place Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","Places"],"summary":"Delete Place","operationId":"delete_place_places__place_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Place Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/places/{place_id}/related":{"get":{"tags":["api","Places"],"summary":"List Place Related","operationId":"list_place_related_places__place_id__related_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Place Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceRelatedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/places/{place_id}/merge":{"post":{"tags":["api","Places"],"summary":"Merge Place","operationId":"merge_place_places__place_id__merge_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Place Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceMergeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/places/{place_id}/refresh":{"post":{"tags":["api","Places"],"summary":"Refresh Place Insight","operationId":"refresh_place_insight_places__place_id__refresh_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Place Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/search":{"get":{"tags":["api","Assets"],"summary":"Search Assets","description":"Semantic / nearby / popularity search over public assets (anonymous OK).","operationId":"search_assets_assets_search_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"}},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"}},{"name":"lng","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lng"}},{"name":"radius_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Radius Km"}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"nearest","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"audience","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Audience"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssetSearchResult"},"title":"Response Search Assets Assets Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/checkout/verify":{"post":{"tags":["api","Assets"],"summary":"Verify Asset Checkout","description":"Converge a Connect checkout session after the buyer redirect.\n\nThe webhook remains the source of truth; this endpoint lets the client\ntoast success only when Stripe reports ``payment_status=paid``.","operationId":"verify_asset_checkout_assets_checkout_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetCheckoutVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetCheckoutVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/assets/checkout/cancel":{"post":{"tags":["api","Assets"],"summary":"Cancel Asset Checkout","description":"Expire an open Connect checkout and release the Angeboten hold.","operationId":"cancel_asset_checkout_assets_checkout_cancel_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetCheckoutVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetCheckoutVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/assets":{"get":{"tags":["api","Assets"],"summary":"List Assets","operationId":"list_assets_assets_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"visibility","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visibility"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Status"}},{"name":"availability","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Availability"}},{"name":"order","in":"query","required":false,"schema":{"anyOf":[{"enum":["created_at","title","price_gross","quantity","expiry_date","available_from"],"type":"string"},{"type":"null"}],"title":"Order"}},{"name":"order_dir","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order Dir"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api","Assets"],"summary":"Create Asset","operationId":"create_asset_assets_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{asset_id}":{"get":{"tags":["api","Assets"],"summary":"Get Asset","operationId":"get_asset_assets__asset_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["api","Assets"],"summary":"Update Asset","operationId":"update_asset_assets__asset_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","Assets"],"summary":"Delete Asset","operationId":"delete_asset_assets__asset_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{asset_id}/dismiss":{"post":{"tags":["api","Assets"],"summary":"Dismiss Asset","description":"Archive an AI/derived product draft and stamp attributes.derived.dismissed_at.","operationId":"dismiss_asset_assets__asset_id__dismiss_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{asset_id}/enrich":{"post":{"tags":["api","Assets"],"summary":"Enrich Asset For Publish","description":"Advisory listing enrichment — does not mutate the asset row.","operationId":"enrich_asset_for_publish_assets__asset_id__enrich_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichListingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{asset_id}/checkout":{"post":{"tags":["api","Assets"],"summary":"Checkout Asset","description":"Start Stripe Connect checkout for a paid asset purchase.","operationId":"checkout_asset_assets__asset_id__checkout_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetCheckoutRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetCheckoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{asset_id}/purchase":{"post":{"tags":["api","Assets"],"summary":"Purchase Asset Cash","description":"Create a cash-at-handover purchase (server-computed price + immediate fulfillment).","operationId":"purchase_asset_cash_assets__asset_id__purchase_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPurchaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPurchaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{asset_id}/images":{"post":{"tags":["api","Assets"],"summary":"Attach Asset Image","operationId":"attach_asset_image_assets__asset_id__images_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Attach Asset Image Assets  Asset Id  Images Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{asset_id}/images/{media_id}":{"delete":{"tags":["api","Assets"],"summary":"Delete Asset Image","operationId":"delete_asset_image_assets__asset_id__images__media_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}},{"name":"media_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Media Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Asset Image Assets  Asset Id  Images  Media Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{asset_id}/images/order":{"put":{"tags":["api","Assets"],"summary":"Reorder Asset Images","operationId":"reorder_asset_images_assets__asset_id__images_order_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reorder Asset Images Assets  Asset Id  Images Order Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/animals/import-icar":{"post":{"tags":["api","Animals"],"summary":"Import Icar","description":"Import an ICAR ADE payload as proposed animals/events (accept via manage).","operationId":"import_icar_animals_import_icar_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"description":"ICAR ADE resource, list, or envelope","title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IcarImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/animals/import-dsch":{"post":{"tags":["api","Animals"],"summary":"Import Dsch","description":"Import a DS-CH ``.txt`` export as proposed animals/events/measurements.","operationId":"import_dsch_animals_import_dsch_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_import_dsch_animals_import_dsch_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DschImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/animals/export-icar":{"get":{"tags":["api","Animals"],"summary":"Export Icar","description":"Export the namespace herd as ICAR ADE animal + event resources.","operationId":"export_icar_animals_export_icar_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IcarExportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/animals/{animal_id}":{"get":{"tags":["api","Animals"],"summary":"Get Animal","description":"Get one animal with linked events and recent measurements.","operationId":"get_animal_animals__animal_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"animal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Animal Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnimalDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/finance/import-camt":{"post":{"tags":["api","Finance"],"summary":"Import Camt","description":"Import an ISO 20022 CAMT.053 statement as proposed transactions.","operationId":"import_camt_finance_import_camt_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_import_camt_finance_import_camt_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CamtImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/finance/import-journal":{"post":{"tags":["api","Finance"],"summary":"Import Journal","description":"Import a Bexio/AgroOffice journal CSV or Abacus XML as proposed transactions.","operationId":"import_journal_finance_import_journal_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_import_journal_finance_import_journal_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JournalImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/finance/accounts":{"get":{"tags":["api","Finance"],"summary":"Get Accounts","description":"Kontenrahmen KMU Landwirtschaft catalog (Klassen + Gruppen).","operationId":"get_accounts_finance_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCatalogResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/finance/accounts/classify":{"get":{"tags":["api","Finance"],"summary":"Classify Account Endpoint","description":"Classify one account number against Kontenrahmen KMU Landwirtschaft.","operationId":"classify_account_endpoint_finance_accounts_classify_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"account","in":"query","required":true,"schema":{"type":"string","description":"Account number to classify","title":"Account"},"description":"Account number to classify"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountClassifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/location/geocode":{"get":{"tags":["api","Location"],"summary":"Geocode","description":"Resolve a typed Swiss place to coordinates + label (anonymous OK).","operationId":"geocode_location_geocode_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"Typed place (PLZ or Ort)","title":"Q"},"description":"Typed place (PLZ or Ort)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/GeocodeResult"},{"type":"null"}],"title":"Response Geocode Location Geocode Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/favicons/{domain}":{"get":{"tags":["api","Favicons"],"summary":"Get Favicon","description":"Proxy a site favicon. Anonymous, Redis-cached, SSRF-guarded.","operationId":"getFavicon","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}}],"responses":{"200":{"description":"Favicon bytes","content":{"application/json":{"schema":{}},"image/png":{},"image/x-icon":{},"image/vnd.microsoft.icon":{},"image/svg+xml":{},"image/jpeg":{},"image/webp":{},"image/gif":{}}},"404":{"description":"No favicon found"},"422":{"description":"Invalid domain"}}}},"/activity/events":{"post":{"tags":["api","Activity"],"summary":"Record Open Events","operationId":"record_open_events_activity_events_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityOpenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityOpenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/activities/search":{"get":{"tags":["api","Activities"],"summary":"Search Activities","description":"Semantic / nearby / popularity search over public activities (anonymous OK).","operationId":"search_activities_activities_search_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"}},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"}},{"name":"lng","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lng"}},{"name":"radius_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Radius Km"}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"nearest","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Search Activities Activities Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities":{"get":{"tags":["api","Activities"],"summary":"List Activities","operationId":"list_activities_activities_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"visibility","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visibility"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Status"}},{"name":"due_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due From"}},{"name":"due_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due To"}},{"name":"assignee","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assignee"}},{"name":"order","in":"query","required":false,"schema":{"anyOf":[{"enum":["due_at","created_at"],"type":"string"},{"type":"null"}],"title":"Order"}},{"name":"order_dir","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order Dir"}},{"name":"include_assignments","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Assignments"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api","Activities"],"summary":"Create Activity","operationId":"create_activity_activities_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/applications":{"get":{"tags":["api","Activities"],"summary":"List My Applications","operationId":"list_my_applications_activities_applications_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"}},{"name":"has_about","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has About"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/applications/pending-counts":{"get":{"tags":["api","Activities"],"summary":"Get Pending Application Counts","operationId":"get_pending_application_counts_activities_applications_pending_counts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingApplicationCountsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/applications/{application_id}/accept":{"post":{"tags":["api","Activities"],"summary":"Accept Application","operationId":"accept_application_activities_applications__application_id__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"application_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Application Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/applications/{application_id}/decline":{"post":{"tags":["api","Activities"],"summary":"Decline Application","operationId":"decline_application_activities_applications__application_id__decline_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"application_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Application Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/applications/{application_id}":{"delete":{"tags":["api","Activities"],"summary":"Withdraw Application","operationId":"withdraw_application_activities_applications__application_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"application_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Application Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}":{"get":{"tags":["api","Activities"],"summary":"Get Activity","operationId":"get_activity_activities__activity_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["api","Activities"],"summary":"Update Activity","operationId":"update_activity_activities__activity_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","Activities"],"summary":"Delete Activity","operationId":"delete_activity_activities__activity_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}/dismiss":{"post":{"tags":["api","Activities"],"summary":"Dismiss Activity","description":"Archive an AI/derived job draft and stamp attributes.derived.dismissed_at.","operationId":"dismiss_activity_activities__activity_id__dismiss_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}/apply":{"post":{"tags":["api","Activities"],"summary":"Apply To Activity","operationId":"apply_to_activity_activities__activity_id__apply_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}/invite":{"post":{"tags":["api","Activities"],"summary":"Invite To Activity","operationId":"invite_to_activity_activities__activity_id__invite_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteApplicationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}/applications":{"get":{"tags":["api","Activities"],"summary":"List Activity Applications","operationId":"list_activity_applications_activities__activity_id__applications_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}/taskdata":{"get":{"tags":["api","Activities"],"summary":"Export Activity Taskdata","description":"Export a field-bound activity as ISO-XML TASKDATA.zip (signed download URL).","operationId":"export_activity_taskdata_activities__activity_id__taskdata_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskdataExportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}/enrich":{"post":{"tags":["api","Activities"],"summary":"Enrich Activity For Publish","operationId":"enrich_activity_for_publish_activities__activity_id__enrich_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichListingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}/delegability":{"post":{"tags":["api","Activities"],"summary":"Check Activity Delegability","description":"MICRO classifier: whether this job is a plausible public contract.","operationId":"check_activity_delegability_activities__activity_id__delegability_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegabilityResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}/images":{"post":{"tags":["api","Activities"],"summary":"Attach Activity Image","operationId":"attach_activity_image_activities__activity_id__images_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Attach Activity Image Activities  Activity Id  Images Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/activities/{activity_id}/images/{media_id}":{"delete":{"tags":["api","Activities"],"summary":"Delete Activity Image","operationId":"delete_activity_image_activities__activity_id__images__media_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Activity Id"}},{"name":"media_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Media Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Activity Image Activities  Activity Id  Images  Media Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/messages/posts/nearby":{"get":{"tags":["api","Messages"],"summary":"Search Nearby Posts","description":"Search public posts (articles) near a location via search_nearby_articles RPC.","operationId":"search_nearby_posts_messages_posts_nearby_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","description":"User latitude for distance calculation","title":"Lat"},"description":"User latitude for distance calculation"},{"name":"lng","in":"query","required":true,"schema":{"type":"number","description":"User longitude for distance calculation","title":"Lng"},"description":"User longitude for distance calculation"},{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","maximum":100,"minimum":0,"description":"Maximum distance in km","default":15,"title":"Radius Km"},"description":"Maximum distance in km"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum results to return","default":50,"title":"Limit"},"description":"Maximum results to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PostSearchResult"},"title":"Response Search Nearby Posts Messages Posts Nearby Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/messages/unread-letter-count":{"get":{"tags":["api","Messages"],"summary":"Get Unread Letter Count","operationId":"get_unread_letter_count_messages_unread_letter_count_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnreadLetterCountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/messages":{"get":{"tags":["api","Messages"],"summary":"List Messages","operationId":"list_messages_messages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"}},{"name":"thread_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Thread Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api","Messages"],"summary":"Create Message","operationId":"create_message_messages_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/messages/{message_id}":{"get":{"tags":["api","Messages"],"summary":"Get Message","operationId":"get_message_messages__message_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["api","Messages"],"summary":"Update Message","operationId":"update_message_messages__message_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","Messages"],"summary":"Delete Message","operationId":"delete_message_messages__message_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/messages/{message_id}/dismiss":{"post":{"tags":["api","Messages"],"summary":"Dismiss Message","description":"Archive an AI letter draft and stamp dismissed_at so upkeep never redrafts it.","operationId":"dismiss_message_messages__message_id__dismiss_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/messages/{message_id}/send":{"post":{"tags":["api","Messages"],"summary":"Send Message","operationId":"send_message_messages__message_id__send_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/messages/{message_id}/mark-read":{"post":{"tags":["api","Messages"],"summary":"Mark Message Read","operationId":"mark_message_read_messages__message_id__mark_read_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/postal/quote":{"post":{"tags":["api","Postal"],"summary":"Quote Postage","description":"Render the letter, count pages, and return the live postage price.","operationId":"quote_postage_postal_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalQuoteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalQuoteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/postal/checkout":{"post":{"tags":["api","Postal"],"summary":"Checkout Postage","description":"Persist a draft letter and open a one-off Stripe checkout for postage.","operationId":"checkout_postage_postal_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalCheckoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/postal/verify-session":{"post":{"tags":["api","Postal"],"summary":"Verify Postal Session","description":"Recovery path after the Stripe redirect: dispatch if paid but the webhook\nhas not landed yet, and report the letter's delivery status.","operationId":"verify_postal_session_postal_verify_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalVerifySessionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalVerifySessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/records":{"get":{"tags":["api","Records"],"summary":"List Records","operationId":"list_records_records_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api","Records"],"summary":"Create Record","operationId":"create_record_records_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/records/{record_id}":{"get":{"tags":["api","Records"],"summary":"Get Record","operationId":"get_record_records__record_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Record Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["api","Records"],"summary":"Update Record","operationId":"update_record_records__record_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Record Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","Records"],"summary":"Delete Record","operationId":"delete_record_records__record_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Record Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transactions":{"get":{"tags":["api","Transactions"],"summary":"List Transactions","operationId":"list_transactions_transactions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api","Transactions"],"summary":"Create Transaction","operationId":"create_transaction_transactions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transactions/{transaction_id}":{"get":{"tags":["api","Transactions"],"summary":"Get Transaction","operationId":"get_transaction_transactions__transaction_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Transaction Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["api","Transactions"],"summary":"Update Transaction","operationId":"update_transaction_transactions__transaction_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Transaction Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","Transactions"],"summary":"Delete Transaction","operationId":"delete_transaction_transactions__transaction_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Transaction Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/social/{plane}/{entity_id}/reactions":{"get":{"tags":["api","Social"],"summary":"Get Reactions","operationId":"get_reactions_social__plane___entity_id__reactions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"plane","in":"path","required":true,"schema":{"enum":["party","place","asset","activity","message","record","transaction","media"],"type":"string","title":"Plane"}},{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Entity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReactionStateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api","Social"],"summary":"Add Reaction","operationId":"add_reaction_social__plane___entity_id__reactions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"plane","in":"path","required":true,"schema":{"enum":["party","place","asset","activity","message","record","transaction","media"],"type":"string","title":"Plane"}},{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Entity Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReactionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReactionToggleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","Social"],"summary":"Clear Reaction","operationId":"clear_reaction_social__plane___entity_id__reactions_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"plane","in":"path","required":true,"schema":{"enum":["party","place","asset","activity","message","record","transaction","media"],"type":"string","title":"Plane"}},{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Entity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReactionToggleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/social/{plane}/{entity_id}/comments":{"get":{"tags":["api","Social"],"summary":"List Comments","operationId":"list_comments_social__plane___entity_id__comments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"plane","in":"path","required":true,"schema":{"enum":["party","place","asset","activity","message","record","transaction","media"],"type":"string","title":"Plane"}},{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Entity Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api","Social"],"summary":"Create Comment","operationId":"create_comment_social__plane___entity_id__comments_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"plane","in":"path","required":true,"schema":{"enum":["party","place","asset","activity","message","record","transaction","media"],"type":"string","title":"Plane"}},{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Entity Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/social/{plane}/{entity_id}/comments/{comment_id}":{"delete":{"tags":["api","Social"],"summary":"Delete Comment","operationId":"delete_comment_social__plane___entity_id__comments__comment_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"plane","in":"path","required":true,"schema":{"enum":["party","place","asset","activity","message","record","transaction","media"],"type":"string","title":"Plane"}},{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Entity Id"}},{"name":"comment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Comment Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhooks/resend":{"post":{"tags":["api","Webhooks"],"summary":"Receive Resend Webhook","description":"Handle Resend webhook events.","operationId":"receive_resend_webhook_webhooks_resend_post","parameters":[{"name":"svix-id","in":"header","required":true,"schema":{"type":"string","title":"Svix-Id"}},{"name":"svix-timestamp","in":"header","required":true,"schema":{"type":"string","title":"Svix-Timestamp"}},{"name":"svix-signature","in":"header","required":true,"schema":{"type":"string","title":"Svix-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendWebhookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhooks/stripe":{"post":{"tags":["api","Webhooks"],"summary":"Receive Stripe Webhook","description":"Handle Stripe webhook events with idempotency protection.","operationId":"receive_stripe_webhook_webhooks_stripe_post","parameters":[{"name":"stripe-signature","in":"header","required":true,"schema":{"type":"string","title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeWebhookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhooks/stripe-connect":{"post":{"tags":["api","Webhooks"],"summary":"Receive Stripe Connect Webhook","description":"Handle Stripe Connect webhook events with idempotency protection.","operationId":"receive_stripe_connect_webhook_webhooks_stripe_connect_post","parameters":[{"name":"stripe-signature","in":"header","required":true,"schema":{"type":"string","title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeWebhookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhooks/pingen":{"post":{"tags":["api","Webhooks"],"summary":"Receive Pingen Webhook","description":"Update message delivery state from a Pingen event.","operationId":"receive_pingen_webhook_webhooks_pingen_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"Signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PingenWebhookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users":{"get":{"tags":["api","admin","admin-users"],"summary":"List Users","description":"List users with optional filters.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    search: Search term for email/username\n    subscription_tier: Filter by subscription tier\n    is_banned: Filter by ban status\n    page: Page number\n    page_size: Page size\n    service: Admin user service\n\nReturns:\n    List of users with pagination","operationId":"list_users_admin_users_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"subscription_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Tier"}},{"name":"is_banned","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Banned"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminUserListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}":{"get":{"tags":["api","admin","admin-users"],"summary":"Get User","description":"Get user details.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user_id: User ID\n    service: Admin user service\n\nReturns:\n    User data","operationId":"get_user_admin_users__user_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Get User Admin Users  User Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/credits":{"patch":{"tags":["api","admin","admin-users"],"summary":"Update Credits","description":"Update user credits.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user_id: User ID\n    payload: Update request\n    service: Admin user service\n\nReturns:\n    Success status","operationId":"update_credits_admin_users__user_id__credits_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCreditsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/subscription":{"patch":{"tags":["api","admin","admin-users"],"summary":"Update Subscription","description":"Update user subscription tier.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user_id: User ID\n    payload: Update request\n    service: Admin user service\n\nReturns:\n    Success status","operationId":"update_subscription_admin_users__user_id__subscription_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSubscriptionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/ban":{"post":{"tags":["api","admin","admin-users"],"summary":"Ban User","description":"Ban a user.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user_id: User ID\n    payload: Ban request\n    service: Admin user service\n\nReturns:\n    Success status","operationId":"ban_user_admin_users__user_id__ban_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BanUserRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api","admin","admin-users"],"summary":"Unban User","description":"Unban a user.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user_id: User ID\n    service: Admin user service\n\nReturns:\n    Success status","operationId":"unban_user_admin_users__user_id__ban_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/toggle-admin":{"post":{"tags":["api","admin","admin-users"],"summary":"Toggle Admin","description":"Toggle admin status for a user.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user_id: User ID\n    service: Admin user service\n\nReturns:\n    Success status","operationId":"toggle_admin_admin_users__user_id__toggle_admin_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/roles":{"post":{"tags":["api","admin","admin-users"],"summary":"Grant Role","description":"Grant a role to a user.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user_id: User ID\n    payload: Grant role request\n    service: Admin user service\n\nReturns:\n    Success status","operationId":"grant_role_admin_users__user_id__roles_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantRoleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/roles/{role}":{"delete":{"tags":["api","admin","admin-users"],"summary":"Revoke Role","description":"Revoke a role from a user.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    user_id: User ID\n    role: Role to revoke\n    service: Admin user service\n\nReturns:\n    Success status","operationId":"revoke_role_admin_users__user_id__roles__role__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"role","in":"path","required":true,"schema":{"type":"string","title":"Role"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/settings":{"get":{"tags":["api","admin","admin-settings"],"summary":"List Settings","description":"List all system settings.\n\nSensitive values are sanitized (masked) for display.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    service: Settings service\n\nReturns:\n    List of system settings with sanitized values","operationId":"list_settings_admin_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SystemSetting"},"type":"array","title":"Response List Settings Admin Settings Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/settings/{key}":{"get":{"tags":["api","admin","admin-settings"],"summary":"Get Setting","description":"Get a single setting by key.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    key: Setting key\n    service: Settings service\n\nReturns:\n    System setting\n\nRaises:\n    HTTPException: If setting not found","operationId":"get_setting_admin_settings__key__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemSetting"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["api","admin","admin-settings"],"summary":"Update Setting","description":"Update a system setting.\n\nArgs:\n    request: FastAPI request object (for rate limiting)\n    key: Setting key\n    payload: Update request with new value\n    service: Settings service\n\nReturns:\n    Success status\n\nRaises:\n    HTTPException: If setting not found or update fails","operationId":"update_setting_admin_settings__key__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSettingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/observability/health":{"get":{"tags":["api","admin","admin-observability"],"summary":"Get System Health","description":"Get system health status.","operationId":"get_system_health_admin_observability_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemHealth"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/observability/usage":{"get":{"tags":["api","admin","admin-observability"],"summary":"Get Usage Stats","description":"Get usage statistics.","operationId":"get_usage_stats_admin_observability_usage_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"time_range","in":"query","required":false,"schema":{"enum":["24h","7d","30d"],"type":"string","default":"24h","title":"Time Range"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageStats"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/audit-logs":{"get":{"tags":["api","admin","admin-audit"],"summary":"Get Audit Logs","description":"Get audit logs with optional filters.\n\nArgs:\n    admin_id: Filter by admin ID\n    action: Filter by action type\n    target_user_id: Filter by target user ID\n    start_date: Filter by start date\n    end_date: Filter by end date\n    page: Page number\n    page_size: Page size\n    admin: Authenticated admin user\n    service: Audit service\n\nReturns:\n    Audit logs with pagination","operationId":"get_audit_logs_admin_audit_logs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"admin_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin Id"}},{"name":"action","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"}},{"name":"target_user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target User Id"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditLogListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/kb/status":{"get":{"tags":["api","admin","admin-kb"],"summary":"Get Kb Status","operationId":"get_kb_status_admin_kb_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/kb/documents":{"get":{"tags":["api","admin","admin-kb"],"summary":"Get Kb Documents","operationId":"get_kb_documents_admin_kb_documents_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Page Size"}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sort"}},{"name":"order","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBDocumentsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/kb/reconcile":{"post":{"tags":["api","admin","admin-kb"],"summary":"Reconcile Kb","description":"Enqueue an on-demand reconcile with S3 (the 'Sync' action).","operationId":"reconcile_kb_admin_kb_reconcile_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBOperationResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/kb/retry":{"post":{"tags":["api","admin","admin-kb"],"summary":"Retry Kb Documents","operationId":"retry_kb_documents_admin_kb_retry_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBRetryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBOperationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/kb/ingest/pause":{"post":{"tags":["api","admin","admin-kb"],"summary":"Pause Kb Ingest","operationId":"pause_kb_ingest_admin_kb_ingest_pause_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBOperationResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/kb/ingest/resume":{"post":{"tags":["api","admin","admin-kb"],"summary":"Resume Kb Ingest","operationId":"resume_kb_ingest_admin_kb_ingest_resume_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBOperationResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/kb/context-index/rebuild":{"post":{"tags":["api","admin","admin-kb"],"summary":"Rebuild Kb Context Index","operationId":"rebuild_kb_context_index_admin_kb_context_index_rebuild_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBOperationResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/kb/rebuild":{"post":{"tags":["api","admin","admin-kb"],"summary":"Rebuild Kb","description":"Enqueue a full memory reset + re-ingest on the worker (not the API process).","operationId":"rebuild_kb_admin_kb_rebuild_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBOperationResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/kb/reset":{"post":{"tags":["api","admin","admin-kb"],"summary":"Reset Kb","operationId":"reset_kb_admin_kb_reset_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nuclear","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Nuclear"}},{"name":"scope","in":"query","required":false,"schema":{"enum":["knowledge","all"],"type":"string","default":"all","title":"Scope"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBOperationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/kb/s3-objects/preview":{"get":{"tags":["api","admin","admin-kb"],"summary":"Preview Kb S3 Object","operationId":"preview_kb_s3_object_admin_kb_s3_objects_preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key","in":"query","required":true,"schema":{"type":"string","title":"Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/kb/s3-objects/upload-urls":{"post":{"tags":["api","admin","admin-kb"],"summary":"Create Kb Upload Urls","operationId":"create_kb_upload_urls_admin_kb_s3_objects_upload_urls_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBS3UploadUrlsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBS3UploadUrlsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/kb/s3-objects":{"delete":{"tags":["api","admin","admin-kb"],"summary":"Delete Kb S3 Objects","operationId":"delete_kb_s3_objects_admin_kb_s3_objects_delete","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBS3DeleteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KBS3DeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/reports":{"get":{"tags":["api","admin","admin-reports"],"summary":"List Agent Reports","description":"Read-only fallback list of raw agent reports.","operationId":"list_agent_reports_admin_reports_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["new","summarized","resolved","dismissed"],"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"report_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Type"}},{"name":"severity","in":"query","required":false,"schema":{"anyOf":[{"enum":["info","warning","critical"],"type":"string"},{"type":"null"}],"title":"Severity"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentReport"},"title":"Response List Agent Reports Admin Reports Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/reports/summaries":{"get":{"tags":["api","admin","admin-reports"],"summary":"List Agent Report Summaries","description":"Read-only fallback list of clustered themes (with Linear links when escalated).","operationId":"list_agent_report_summaries_admin_reports_summaries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentReportSummary"},"title":"Response List Agent Report Summaries Admin Reports Summaries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/reports/summarize":{"post":{"tags":["api","admin","admin-reports"],"summary":"Enqueue Agent Report Summarize","description":"Queue a summarizer pass (runs even when AGENT_REPORT_SUMMARIZER_ENABLED is false).","operationId":"enqueue_agent_report_summarize_admin_reports_summarize_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/news-digest/latest":{"get":{"tags":["api","admin","admin-news"],"summary":"Get Latest News Digest","description":"Raw latest curated digest markdown (no agent policy header).","operationId":"get_latest_news_digest_admin_news_digest_latest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminNewsDigestLatest"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/gardener/run":{"post":{"tags":["api","admin","admin-gardener"],"summary":"Run Gardener Reevaluate","description":"Enqueue a production reevaluate for the admin's personal namespace.","operationId":"run_gardener_reevaluate_admin_gardener_run_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminGardenerTask"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/gardener/tasks":{"get":{"tags":["api","admin","admin-gardener"],"summary":"List Gardener Tasks","description":"Recent agent_tasks for the admin's personal namespace.","operationId":"list_gardener_tasks_admin_gardener_tasks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminGardenerTasksResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/admin/vector-sync":{"post":{"tags":["api","admin","admin-vector-sync"],"summary":"Sync Entity To Vector","description":"No-op: entity ProjectionService + outbox replace manual vector sync.","operationId":"sync_entity_to_vector_admin_vector_sync_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorSyncRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/health":{"get":{"tags":["health"],"summary":"Health Check","description":"Liveness: process is up (always 200).","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Check Health Get"}}}}}}},"/ready":{"get":{"tags":["health"],"summary":"Readiness Check","description":"Readiness: live probes; 503 when required API deps are down.","operationId":"readiness_check_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/live":{"get":{"tags":["health"],"summary":"Health Check Live","description":"Alias for ``/ready`` (compat).","operationId":"health_check_live_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Root","description":"Root endpoint.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Root  Get"}}}}}}},"/sentry-debug":{"get":{"summary":"Sentry Debug","description":"Verify Sentry wiring in local/staging debug mode only.","operationId":"sentry_debug_sentry_debug_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Sentry Debug Sentry Debug Get"}}}}}}}},"components":{"schemas":{"AccountCatalogResponse":{"properties":{"kontenklassen":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Kontenklassen"},"kontengruppen":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Kontengruppen"}},"type":"object","title":"AccountCatalogResponse","description":"Kontenklassen + Kontengruppen catalog for agent / UI lookup."},"AccountClassifyResponse":{"properties":{"account":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account"},"kontenklasse":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kontenklasse"},"kontenklasse_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kontenklasse Label"},"kontengruppe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kontengruppe"},"kontengruppe_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kontengruppe Label"},"direction_hint":{"anyOf":[{"type":"string","enum":["in","out","unknown"]},{"type":"null"}],"title":"Direction Hint"}},"type":"object","title":"AccountClassifyResponse","description":"Lightweight Kontenrahmen KMU Landwirtschaft classification."},"AccountSessionResponse":{"properties":{"client_secret":{"type":"string","title":"Client Secret","description":"Stripe AccountSession client secret"}},"type":"object","required":["client_secret"],"title":"AccountSessionResponse","description":"Client secret for mounting embedded Connect components."},"ActivityCreateRequest":{"properties":{"kind":{"type":"string","title":"Kind","default":"job"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"lifecycle":{"type":"string","enum":["proposed","draft","active","archived"],"title":"Lifecycle","default":"active"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","enum":["private","public"],"title":"Visibility","default":"private"},"origin":{"type":"string","enum":["user","ai","system","imported"],"title":"Origin","default":"user"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"estimated_cost":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Cost"},"payment_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Unit"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"all_day":{"type":"boolean","title":"All Day","default":false},"valid_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid Until"},"ai_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ai Description"},"estimated_hours":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Hours"},"actual_hours":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Actual Hours"},"hours_source":{"anyOf":[{"type":"string","enum":["user","estimate"]},{"type":"null"}],"title":"Hours Source"},"source_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Entity Id"}},"type":"object","title":"ActivityCreateRequest"},"ActivityDetailPayload":{"properties":{"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"estimated_cost":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Cost"},"payment_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Unit"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"all_day":{"type":"boolean","title":"All Day","default":false},"valid_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid Until"},"ai_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ai Description"},"estimated_hours":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Hours"},"actual_hours":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Actual Hours"},"hours_source":{"anyOf":[{"type":"string","enum":["user","estimate"]},{"type":"null"}],"title":"Hours Source"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"}},"type":"object","title":"ActivityDetailPayload"},"ActivityListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ActivityResponse"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["limit","offset","total"],"title":"ActivityListResponse"},"ActivityMessage":{"properties":{"id":{"type":"string","title":"Id"},"role":{"type":"string","const":"activity","title":"Role","default":"activity"},"activityType":{"type":"string","title":"Activitytype"},"content":{"additionalProperties":true,"type":"object","title":"Content"}},"additionalProperties":true,"type":"object","required":["id","activityType","content"],"title":"ActivityMessage","description":"An activity progress message emitted between chat messages."},"ActivityOpenItem":{"properties":{"kind":{"type":"string","enum":["document.opened","product.opened","job.opened","file.opened"],"title":"Kind"},"ref":{"type":"string","maxLength":120,"minLength":3,"title":"Ref"},"title":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Title"}},"type":"object","required":["kind","ref"],"title":"ActivityOpenItem"},"ActivityOpenRequest":{"properties":{"events":{"items":{"$ref":"#/components/schemas/ActivityOpenItem"},"type":"array","maxItems":20,"minItems":1,"title":"Events"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},"type":"object","required":["events"],"title":"ActivityOpenRequest"},"ActivityOpenResponse":{"properties":{"accepted":{"type":"integer","title":"Accepted"},"skipped":{"type":"integer","title":"Skipped"}},"type":"object","required":["accepted","skipped"],"title":"ActivityOpenResponse"},"ActivityResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"namespace_id":{"type":"string","format":"uuid","title":"Namespace Id"},"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"lifecycle":{"type":"string","title":"Lifecycle","default":"active"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","title":"Visibility","default":"private"},"origin":{"type":"string","title":"Origin","default":"user"},"is_external":{"type":"boolean","title":"Is External","default":false},"direction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"reaction_score":{"type":"integer","title":"Reaction Score","default":0},"comment_count":{"type":"integer","title":"Comment Count","default":0},"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"},"detail":{"anyOf":[{"$ref":"#/components/schemas/ActivityDetailPayload"},{"type":"null"}]},"assignments":{"items":{"$ref":"#/components/schemas/ApplicationResponse"},"type":"array","title":"Assignments"}},"type":"object","required":["id","namespace_id","kind"],"title":"ActivityResponse"},"ActivityUpdateRequest":{"properties":{"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes"},"lifecycle":{"anyOf":[{"type":"string","enum":["proposed","draft","active","archived"]},{"type":"null"}],"title":"Lifecycle"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"anyOf":[{"type":"string","enum":["private","public"]},{"type":"null"}],"title":"Visibility"},"origin":{"anyOf":[{"type":"string","enum":["user","ai","system","imported"]},{"type":"null"}],"title":"Origin"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"estimated_cost":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Cost"},"payment_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Unit"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"all_day":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"All Day"},"valid_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid Until"},"ai_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ai Description"},"estimated_hours":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Hours"},"actual_hours":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Actual Hours"},"hours_source":{"anyOf":[{"type":"string","enum":["user","estimate"]},{"type":"null"}],"title":"Hours Source"}},"type":"object","title":"ActivityUpdateRequest"},"AdminGardenerTask":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"kind":{"type":"string","enum":["reevaluate","upkeep","integrate"],"title":"Kind"},"status":{"type":"string","enum":["pending","running","completed","failed","skipped","cancelled"],"title":"Status"},"instruction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instruction"},"result_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Summary"},"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","kind","status"],"title":"AdminGardenerTask","description":"One agent_tasks row scoped to the admin's personal namespace."},"AdminGardenerTasksResponse":{"properties":{"tasks":{"items":{"$ref":"#/components/schemas/AdminGardenerTask"},"type":"array","title":"Tasks"},"automation_enabled":{"type":"boolean","title":"Automation Enabled"},"credits_ok":{"type":"boolean","title":"Credits Ok"}},"type":"object","required":["tasks","automation_enabled","credits_ok"],"title":"AdminGardenerTasksResponse","description":"Recent Gardener tasks plus gates for the trigger button."},"AdminNewsDigestLatest":{"properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Id"},"built_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Built At"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"item_count":{"type":"integer","title":"Item Count","default":0}},"type":"object","title":"AdminNewsDigestLatest","description":"Raw latest digest for the admin System page (no policy header)."},"AdminUserListResponse":{"properties":{"users":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Users"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["users","total","page","page_size"],"title":"AdminUserListResponse","description":"Admin user list response with pagination."},"AgentReport":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"report_type":{"type":"string","enum":["unresolved_question","knowledge_gap","skill_gap","tooling_limit","feature_request","customer_service","dissatisfaction","other"],"title":"Report Type"},"severity":{"type":"string","enum":["info","warning","critical"],"title":"Severity"},"message":{"type":"string","title":"Message"},"context":{"additionalProperties":true,"type":"object","title":"Context"},"namespace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Namespace Id"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"session_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Session Id"},"session_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Key"},"source":{"type":"string","enum":["chat","gardener","headless"],"title":"Source"},"status":{"type":"string","enum":["new","summarized","resolved","dismissed"],"title":"Status"},"message_fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message Fingerprint"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","report_type","severity","message","source","status","created_at","updated_at"],"title":"AgentReport"},"AgentReportSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"dedupe_key":{"type":"string","title":"Dedupe Key"},"theme_title":{"type":"string","title":"Theme Title"},"category":{"type":"string","title":"Category"},"severity":{"type":"string","enum":["info","warning","critical"],"title":"Severity"},"report_count":{"type":"integer","title":"Report Count"},"distinct_user_count":{"type":"integer","title":"Distinct User Count"},"sample_report_ids":{"items":{"type":"string"},"type":"array","title":"Sample Report Ids"},"seen_user_ids":{"items":{"type":"string"},"type":"array","title":"Seen User Ids"},"counted_report_ids":{"items":{"type":"string"},"type":"array","title":"Counted Report Ids"},"suggested_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Action"},"linear_issue_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linear Issue Id"},"linear_issue_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linear Issue Url"},"first_seen_at":{"type":"string","format":"date-time","title":"First Seen At"},"last_seen_at":{"type":"string","format":"date-time","title":"Last Seen At"},"status":{"type":"string","enum":["open","escalated","resolved"],"title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","dedupe_key","theme_title","category","severity","report_count","distinct_user_count","first_seen_at","last_seen_at","status","created_at","updated_at"],"title":"AgentReportSummary"},"AnimalDetailResponse":{"properties":{"animal":{"additionalProperties":true,"type":"object","title":"Animal"},"events":{"items":{"$ref":"#/components/schemas/AnimalObservation"},"type":"array","title":"Events"},"measurements":{"items":{"$ref":"#/components/schemas/AnimalObservation"},"type":"array","title":"Measurements"}},"type":"object","required":["animal"],"title":"AnimalDetailResponse","description":"One animal plus its linked events and recent measurements."},"AnimalObservation":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"},"metric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"}},"type":"object","required":["id","kind"],"title":"AnimalObservation","description":"Linked event or measurement summary on an animal detail response."},"AnswerBrowserJobRequest":{"properties":{"kind":{"type":"string","enum":["clarify","submit"],"title":"Kind","default":"clarify"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer"},"approved":{"type":"boolean","title":"Approved","default":true}},"type":"object","title":"AnswerBrowserJobRequest"},"AnswerBrowserJobResponse":{"properties":{"job_id":{"type":"string","format":"uuid","title":"Job Id"},"status":{"type":"string","enum":["created","awaiting_login","running","awaiting_user","succeeded","failed"],"title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["job_id","status","message"],"title":"AnswerBrowserJobResponse"},"AppNotification":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"notification_type":{"type":"string","title":"Notification Type"},"category":{"type":"string","title":"Category","default":"agent"},"tier":{"type":"string","title":"Tier","default":"ambient"},"title":{"type":"string","title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"metadata_json":{"additionalProperties":true,"type":"object","title":"Metadata Json"},"read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Read At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","user_id","notification_type","title","created_at"],"title":"AppNotification","description":"One in-app notification entry."},"AppNotificationListResponse":{"properties":{"notifications":{"items":{"$ref":"#/components/schemas/AppNotification"},"type":"array","title":"Notifications"},"limit":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Limit","default":50},"offset":{"type":"integer","minimum":0.0,"title":"Offset","default":0}},"type":"object","title":"AppNotificationListResponse","description":"Paginated list of in-app notifications."},"AppNotificationUnreadCountsResponse":{"properties":{"agent":{"type":"integer","title":"Agent","default":0},"social":{"type":"integer","title":"Social","default":0},"account":{"type":"integer","title":"Account","default":0},"total":{"type":"integer","title":"Total","default":0}},"type":"object","title":"AppNotificationUnreadCountsResponse","description":"Unread notification counters by provenance."},"ApplicationListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ApplicationResponse"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["limit","offset","total"],"title":"ApplicationListResponse"},"ApplicationResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"namespace_id":{"type":"string","format":"uuid","title":"Namespace Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"counterparty_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counterparty Title"},"has_about":{"type":"boolean","title":"Has About","default":false},"job_ref":{"anyOf":[{"$ref":"#/components/schemas/JobRef"},{"type":"null"}]},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref"},"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","namespace_id"],"title":"ApplicationResponse"},"AssetCheckoutRequest":{"properties":{"quantity":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Quantity"},"postal_address":{"anyOf":[{"$ref":"#/components/schemas/PostalAddress"},{"type":"null"}]}},"type":"object","title":"AssetCheckoutRequest"},"AssetCheckoutResponse":{"properties":{"checkout_url":{"type":"string","title":"Checkout Url"},"payment_id":{"type":"string","format":"uuid","title":"Payment Id"},"stripe_checkout_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Checkout Session Id"}},"type":"object","required":["checkout_url","payment_id"],"title":"AssetCheckoutResponse"},"AssetCheckoutVerifyRequest":{"properties":{"payment_id":{"type":"string","format":"uuid","title":"Payment Id"}},"type":"object","required":["payment_id"],"title":"AssetCheckoutVerifyRequest"},"AssetCheckoutVerifyResponse":{"properties":{"status":{"type":"string","enum":["paid","pending","open","refunded","canceled"],"title":"Status"}},"type":"object","required":["status"],"title":"AssetCheckoutVerifyResponse"},"AssetCreateRequest":{"properties":{"kind":{"type":"string","title":"Kind","default":"good"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"lifecycle":{"type":"string","enum":["proposed","draft","active","archived"],"title":"Lifecycle","default":"active"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","enum":["private","public"],"title":"Visibility","default":"private"},"origin":{"type":"string","enum":["user","ai","system","imported"],"title":"Origin","default":"user"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"price_gross":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Gross"},"currency":{"type":"string","title":"Currency","default":"chf"},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantity"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Condition"},"audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"expiry_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Expiry Date"},"ai_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ai Description"},"availability":{"type":"string","enum":["available","expected"],"title":"Availability","default":"available"},"available_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Available From"},"mwst_rate":{"type":"number","title":"Mwst Rate","default":0},"offered_quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Offered Quantity"},"source_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Entity Id"}},"type":"object","title":"AssetCreateRequest"},"AssetDetailPayload":{"properties":{"price_gross":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Gross"},"currency":{"type":"string","title":"Currency","default":"chf"},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantity"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Condition"},"audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"expiry_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Expiry Date"},"ai_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ai Description"},"availability":{"type":"string","enum":["available","expected"],"title":"Availability","default":"available"},"available_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Available From"},"mwst_rate":{"type":"number","title":"Mwst Rate","default":0},"offered_quantity":{"type":"number","title":"Offered Quantity","default":0},"reserved_quantity":{"type":"number","title":"Reserved Quantity","default":0}},"type":"object","title":"AssetDetailPayload"},"AssetListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AssetResponse"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["limit","offset","total"],"title":"AssetListResponse"},"AssetPurchaseRequest":{"properties":{"quantity":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Quantity"},"postal_address":{"anyOf":[{"$ref":"#/components/schemas/PostalAddress"},{"type":"null"}]}},"type":"object","title":"AssetPurchaseRequest"},"AssetPurchaseResponse":{"properties":{"payment_id":{"type":"string","format":"uuid","title":"Payment Id"},"seller_transaction_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Seller Transaction Id"},"buyer_transaction_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Buyer Transaction Id"},"delivery_activity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Delivery Activity Id"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref"}},"type":"object","required":["payment_id"],"title":"AssetPurchaseResponse"},"AssetResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"namespace_id":{"type":"string","format":"uuid","title":"Namespace Id"},"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"lifecycle":{"type":"string","title":"Lifecycle","default":"active"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","title":"Visibility","default":"private"},"origin":{"type":"string","title":"Origin","default":"user"},"is_external":{"type":"boolean","title":"Is External","default":false},"direction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"reaction_score":{"type":"integer","title":"Reaction Score","default":0},"comment_count":{"type":"integer","title":"Comment Count","default":0},"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"},"source_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Entity Id"},"detail":{"anyOf":[{"$ref":"#/components/schemas/AssetDetailPayload"},{"type":"null"}]}},"type":"object","required":["id","namespace_id","kind"],"title":"AssetResponse"},"AssetSearchResult":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"distance_km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distance Km"},"reaction_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reaction Score"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method"},"delivery_responsibility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivery Responsibility"},"seller_online_payment":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Seller Online Payment"}},"type":"object","required":["id"],"title":"AssetSearchResult"},"AssetUpdateRequest":{"properties":{"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes"},"lifecycle":{"anyOf":[{"type":"string","enum":["proposed","draft","active","archived"]},{"type":"null"}],"title":"Lifecycle"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"anyOf":[{"type":"string","enum":["private","public"]},{"type":"null"}],"title":"Visibility"},"origin":{"anyOf":[{"type":"string","enum":["user","ai","system","imported"]},{"type":"null"}],"title":"Origin"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"price_gross":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Gross"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantity"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Condition"},"audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"expiry_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Expiry Date"},"ai_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ai Description"},"availability":{"anyOf":[{"type":"string","enum":["available","expected"]},{"type":"null"}],"title":"Availability"},"available_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Available From"},"mwst_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mwst Rate"},"offered_quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Offered Quantity"}},"type":"object","title":"AssetUpdateRequest"},"AssistantMessage":{"properties":{"id":{"type":"string","title":"Id"},"role":{"type":"string","const":"assistant","title":"Role","default":"assistant"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"encryptedValue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encryptedvalue"},"toolCalls":{"anyOf":[{"items":{"$ref":"#/components/schemas/ToolCall"},"type":"array"},{"type":"null"}],"title":"Toolcalls"}},"additionalProperties":true,"type":"object","required":["id"],"title":"AssistantMessage","description":"An assistant message."},"AudioInputContent":{"properties":{"type":{"type":"string","const":"audio","title":"Type","default":"audio"},"source":{"oneOf":[{"$ref":"#/components/schemas/InputContentDataSource"},{"$ref":"#/components/schemas/InputContentUrlSource"}],"title":"Source","discriminator":{"propertyName":"type","mapping":{"data":"#/components/schemas/InputContentDataSource","url":"#/components/schemas/InputContentUrlSource"}}},"metadata":{"anyOf":[{},{"type":"null"}],"title":"Metadata"}},"additionalProperties":true,"type":"object","required":["source"],"title":"AudioInputContent","description":"An audio input content fragment."},"AuditLogEntry":{"properties":{"id":{"type":"string","title":"Id"},"admin_id":{"type":"string","title":"Admin Id"},"action":{"type":"string","title":"Action"},"target_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target User Id"},"details":{"additionalProperties":true,"type":"object","title":"Details"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","admin_id","action","created_at"],"title":"AuditLogEntry","description":"Audit log entry."},"AuditLogListResponse":{"properties":{"logs":{"items":{"$ref":"#/components/schemas/AuditLogEntry"},"type":"array","title":"Logs"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["logs","total","page","page_size"],"title":"AuditLogListResponse","description":"Audit log list response with pagination."},"BanUserRequest":{"properties":{"reason":{"type":"string","maxLength":500,"minLength":1,"title":"Reason"}},"type":"object","required":["reason"],"title":"BanUserRequest","description":"Request to ban a user."},"BillingInvoice":{"properties":{"id":{"type":"string","title":"Id"},"number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Number"},"status":{"type":"string","title":"Status"},"amount_due_chf":{"type":"number","title":"Amount Due Chf"},"amount_paid_chf":{"type":"number","title":"Amount Paid Chf"},"currency":{"type":"string","title":"Currency"},"created_at":{"type":"string","title":"Created At"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"hosted_invoice_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hosted Invoice Url"},"invoice_pdf":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Pdf"}},"type":"object","required":["id","status","amount_due_chf","amount_paid_chf","currency","created_at"],"title":"BillingInvoice","description":"One Stripe platform invoice for the Rechnungen tab."},"BillingInvoicesResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BillingInvoice"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"BillingInvoicesResponse","description":"List of Stripe invoices for the current user."},"BinaryInputContent":{"properties":{"type":{"type":"string","const":"binary","title":"Type","default":"binary"},"mimeType":{"type":"string","title":"Mimetype"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"}},"additionalProperties":true,"type":"object","required":["mimeType"],"title":"BinaryInputContent","description":"A deprecated binary payload reference in a multimodal user message."},"Body_create_transcription_transcription_post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"Short audio clip (webm/ogg/wav/mp3/m4a)"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"ISO-639-1 language hint (e.g. de). Auto-detected if omitted."}},"type":"object","required":["file"],"title":"Body_create_transcription_transcription_post"},"Body_import_camt_finance_import_camt_post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"CAMT.053 XML or ZIP-of-XML"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}},"type":"object","required":["file"],"title":"Body_import_camt_finance_import_camt_post"},"Body_import_dsch_animals_import_dsch_post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"DS-CH fixed-column .txt export"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}},"type":"object","required":["file"],"title":"Body_import_dsch_animals_import_dsch_post"},"Body_import_journal_finance_import_journal_post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"Journal CSV or Abacus XML"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}},"type":"object","required":["file"],"title":"Body_import_journal_finance_import_journal_post"},"Body_submit_training_training_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}},"type":"object","required":["file"],"title":"Body_submit_training_training_post"},"BrowserJobListResponse":{"properties":{"jobs":{"items":{"$ref":"#/components/schemas/BrowserJobResponse"},"type":"array","title":"Jobs"}},"type":"object","title":"BrowserJobListResponse"},"BrowserJobRecordingResponse":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"BrowserJobRecordingResponse"},"BrowserJobResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"namespace_id":{"type":"string","format":"uuid","title":"Namespace Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"job_type":{"type":"string","title":"Job Type"},"status":{"type":"string","enum":["created","awaiting_login","running","awaiting_user","succeeded","failed"],"title":"Status"},"portal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Portal"},"instruction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instruction"},"cloud_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cloud Session Id"},"cloud_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cloud Profile Id"},"live_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Live Url"},"result_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result Json"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"cloud_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cloud Cost Usd"},"browse_agent_tokens":{"type":"integer","title":"Browse Agent Tokens","default":0},"document_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Document Id"},"recording_s3_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording S3 Uri"},"screenshot_s3_uris":{"items":{"type":"string"},"type":"array","title":"Screenshot S3 Uris"},"pending_question":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pending Question"},"step_count":{"type":"integer","title":"Step Count","default":0},"usage_tracked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Usage Tracked 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":["id","namespace_id","user_id","job_type","status"],"title":"BrowserJobResponse"},"BrowserJobScreenshotsResponse":{"properties":{"urls":{"items":{"type":"string"},"type":"array","title":"Urls"}},"type":"object","title":"BrowserJobScreenshotsResponse"},"CamtImportResponse":{"properties":{"extraction_run_id":{"type":"string","title":"Extraction Run Id"},"bookings":{"type":"integer","title":"Bookings"},"proposal_ids":{"items":{"type":"string"},"type":"array","title":"Proposal Ids"},"skipped":{"type":"integer","title":"Skipped","default":0}},"type":"object","required":["extraction_run_id","bookings"],"title":"CamtImportResponse","description":"Result of a CAMT.053 import: proposals awaiting HITL accept."},"CheckSubscriptionResponse":{"properties":{"subscribed":{"type":"boolean","title":"Subscribed","description":"Whether user has active subscription"},"subscription_tier":{"type":"string","title":"Subscription Tier","description":"Subscription tier name"},"subscription_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription End","description":"Subscription end date (ISO format)"},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id","description":"Stripe product ID"},"synced":{"type":"boolean","title":"Synced","description":"Whether database was successfully updated"}},"type":"object","required":["subscribed","subscription_tier","synced"],"title":"CheckSubscriptionResponse","description":"Response after checking subscription."},"CheckoutRequest":{"properties":{"price_id":{"type":"string","title":"Price Id","description":"Stripe price ID"},"mode":{"type":"string","enum":["subscription","payment"],"title":"Mode","description":"Checkout mode: subscription or payment","default":"subscription"},"quantity":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Quantity","description":"Line-item quantity. Required for AKh top-up (1 unit = 1 AKh); omit for subscriptions."}},"type":"object","required":["price_id"],"title":"CheckoutRequest","description":"Request to create a checkout session."},"CheckoutResponse":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"Checkout URL to redirect to"},"success":{"type":"boolean","title":"Success","description":"Whether operation was successful"},"upgraded":{"type":"boolean","title":"Upgraded","description":"Whether subscription was upgraded in-place","default":false},"subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Id","description":"Subscription ID if upgraded"}},"type":"object","required":["success"],"title":"CheckoutResponse","description":"Response from checkout creation."},"ClaimInviteResponse":{"properties":{"kind":{"$ref":"#/components/schemas/InviteKind"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"},"activity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Activity Id"},"other_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Other User Id"},"other_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Other Username"}},"type":"object","required":["kind"],"title":"ClaimInviteResponse","description":"Result of claiming an invite link (idempotent on replay)."},"CommentCreateRequest":{"properties":{"body":{"type":"string","maxLength":2000,"minLength":1,"title":"Body"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"}},"type":"object","required":["body"],"title":"CommentCreateRequest"},"CommentListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CommentResponse"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset","default":0},"total":{"type":"integer","title":"Total"}},"type":"object","required":["limit","total"],"title":"CommentListResponse"},"CommentResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"entity_id":{"type":"string","format":"uuid","title":"Entity Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"body":{"type":"string","title":"Body"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"author_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Username"},"author_avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Avatar Url"}},"type":"object","required":["id","entity_id","user_id","body"],"title":"CommentResponse"},"ConfirmBrowserSessionResponse":{"properties":{"job_id":{"type":"string","format":"uuid","title":"Job Id"},"status":{"type":"string","enum":["created","awaiting_login","running","awaiting_user","succeeded","failed"],"title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["job_id","status","message"],"title":"ConfirmBrowserSessionResponse"},"ConnectAccountStatus":{"properties":{"has_account":{"type":"boolean","title":"Has Account","description":"Whether the user has a Stripe Connect account yet"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id","description":"Stripe connected account ID"},"charges_enabled":{"type":"boolean","title":"Charges Enabled","description":"Account can accept charges (fully onboarded to receive)","default":false},"payouts_enabled":{"type":"boolean","title":"Payouts Enabled","description":"Account can receive payouts","default":false},"details_submitted":{"type":"boolean","title":"Details Submitted","description":"Onboarding details have been submitted","default":false}},"type":"object","required":["has_account"],"title":"ConnectAccountStatus","description":"Connected-account onboarding and capability status for a user."},"ConnectionActionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"status":{"anyOf":[{"$ref":"#/components/schemas/ConnectionStatus"},{"type":"null"}]}},"type":"object","required":["success"],"title":"ConnectionActionResponse","description":"Result of accept/decline/remove."},"ConnectionDirection":{"type":"string","enum":["out","in"],"title":"ConnectionDirection","description":"Direction relative to the viewing user."},"ConnectionEntry":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"status":{"$ref":"#/components/schemas/ConnectionStatus"},"direction":{"$ref":"#/components/schemas/ConnectionDirection"},"profile":{"$ref":"#/components/schemas/ConnectionProfile"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"responded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Responded At"}},"type":"object","required":["id","status","direction","profile","created_at"],"title":"ConnectionEntry","description":"One connection row viewed by one participant."},"ConnectionListResponse":{"properties":{"connections":{"items":{"$ref":"#/components/schemas/ConnectionEntry"},"type":"array","title":"Connections"},"pending_incoming_count":{"type":"integer","title":"Pending Incoming Count","default":0}},"type":"object","title":"ConnectionListResponse","description":"All connections of the caller (accepted + pending both directions + declined own)."},"ConnectionProfile":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"username":{"type":"string","title":"Username"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"canton":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canton"}},"type":"object","required":["id","username"],"title":"ConnectionProfile","description":"Public profile fields of the counterparty."},"ConnectionResponse":{"properties":{"connection":{"$ref":"#/components/schemas/ConnectionEntry"}},"type":"object","required":["connection"],"title":"ConnectionResponse","description":"Single connection payload."},"ConnectionStatus":{"type":"string","enum":["pending","accepted","declined"],"title":"ConnectionStatus","description":"Lifecycle of a user connection."},"Context":{"properties":{"description":{"type":"string","title":"Description"},"value":{"type":"string","title":"Value"}},"additionalProperties":true,"type":"object","required":["description","value"],"title":"Context","description":"Additional context for the agent."},"CreateBrowserSessionRequest":{"properties":{"portal":{"type":"string","title":"Portal","default":"smartherd"},"instruction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instruction"},"job_type":{"type":"string","title":"Job Type","default":"smartherd_read"}},"type":"object","title":"CreateBrowserSessionRequest"},"CreateBrowserSessionResponse":{"properties":{"job_id":{"type":"string","format":"uuid","title":"Job Id"},"session_id":{"type":"string","title":"Session Id"},"live_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Live Url"},"portal":{"type":"string","title":"Portal"},"status":{"type":"string","enum":["created","awaiting_login","running","awaiting_user","succeeded","failed"],"title":"Status"}},"type":"object","required":["job_id","session_id","portal","status"],"title":"CreateBrowserSessionResponse"},"CreateConnectionRequest":{"properties":{"username":{"type":"string","maxLength":20,"minLength":3,"title":"Username"}},"type":"object","required":["username"],"title":"CreateConnectionRequest","description":"Request to kollegisieren a user by username."},"CreateInviteRequest":{"properties":{"kind":{"$ref":"#/components/schemas/InviteKind"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"},"activity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Activity Id"}},"type":"object","required":["kind"],"title":"CreateInviteRequest","description":"Create a single-use external invite link."},"CreateInvoiceRequest":{"properties":{"recipient_name":{"type":"string","maxLength":200,"minLength":1,"title":"Recipient Name"},"recipient_email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Recipient Email"},"recipient_address":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Recipient Address"},"line_items":{"items":{"$ref":"#/components/schemas/InvoiceLineItem"},"type":"array","minItems":1,"title":"Line Items"},"mwst_rate":{"type":"number","title":"Mwst Rate","description":"MWST percent: 0, 2.6, 3.8, or 8.1","default":0.0},"due_days":{"anyOf":[{"type":"integer","maximum":365.0,"minimum":0.0},{"type":"null"}],"title":"Due Days","default":30},"notes":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Notes"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id","description":"Optional team context"},"job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Job Id","description":"Optional linked job for Geld einziehen"}},"type":"object","required":["recipient_name","line_items"],"title":"CreateInvoiceRequest","description":"Payload to create and finalize a payment request."},"CreateTeamRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":3,"title":"Name","description":"Team name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Optional team description"},"is_public":{"type":"boolean","title":"Is Public","description":"Whether team is public","default":false}},"type":"object","required":["name"],"title":"CreateTeamRequest","description":"Request to create a new team."},"CreateTeamResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"team":{"$ref":"#/components/schemas/TeamResponse"}},"type":"object","required":["success","team"],"title":"CreateTeamResponse","description":"Response after creating a team."},"DelegabilityResult":{"properties":{"value":{"type":"boolean","title":"Value"},"reason":{"type":"string","title":"Reason"},"checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checked At"}},"type":"object","required":["value","reason"],"title":"DelegabilityResult","description":"Cached job public-delegability blob (attributes.delegable)."},"DeleteAccountResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"DeleteAccountResponse","description":"Response after deleting an account."},"DeleteTeamResponse":{"properties":{"success":{"type":"boolean","title":"Success"}},"type":"object","required":["success"],"title":"DeleteTeamResponse","description":"Response after deleting a team."},"DeveloperMessage":{"properties":{"id":{"type":"string","title":"Id"},"role":{"type":"string","const":"developer","title":"Role","default":"developer"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"encryptedValue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encryptedvalue"}},"additionalProperties":true,"type":"object","required":["id","content"],"title":"DeveloperMessage","description":"A developer message."},"DiscrepancyWarning":{"properties":{"field":{"type":"string","title":"Field"},"seller_claim":{"type":"string","title":"Seller Claim"},"reference":{"type":"string","title":"Reference"},"source":{"$ref":"#/components/schemas/EnrichmentSource"}},"type":"object","required":["field","seller_claim","reference","source"],"title":"DiscrepancyWarning","description":"Private seller-facing discrepancy (never a public block)."},"DocumentInputContent":{"properties":{"type":{"type":"string","const":"document","title":"Type","default":"document"},"source":{"oneOf":[{"$ref":"#/components/schemas/InputContentDataSource"},{"$ref":"#/components/schemas/InputContentUrlSource"}],"title":"Source","discriminator":{"propertyName":"type","mapping":{"data":"#/components/schemas/InputContentDataSource","url":"#/components/schemas/InputContentUrlSource"}}},"metadata":{"anyOf":[{},{"type":"null"}],"title":"Metadata"}},"additionalProperties":true,"type":"object","required":["source"],"title":"DocumentInputContent","description":"A document input content fragment."},"DschImportResponse":{"properties":{"extraction_run_id":{"type":"string","title":"Extraction Run Id"},"animals":{"type":"integer","title":"Animals"},"events":{"type":"integer","title":"Events"},"measurements":{"type":"integer","title":"Measurements","default":0},"proposal_ids":{"items":{"type":"string"},"type":"array","title":"Proposal Ids"}},"type":"object","required":["extraction_run_id","animals","events"],"title":"DschImportResponse","description":"Result of a DS-CH import: proposals awaiting HITL accept."},"EnrichListingResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"proposal":{"anyOf":[{"$ref":"#/components/schemas/EnrichmentProposal"},{"type":"null"}]}},"type":"object","title":"EnrichListingResponse","description":"HTTP response for advisory listing enrichment (no row mutation)."},"EnrichmentBlock":{"properties":{"kind":{"type":"string","title":"Kind"},"heading":{"type":"string","title":"Heading"},"body_md":{"type":"string","title":"Body Md"},"sources":{"items":{"$ref":"#/components/schemas/EnrichmentSource"},"type":"array","minItems":1,"title":"Sources"},"computed":{"anyOf":[{"$ref":"#/components/schemas/EnrichmentComputed"},{"type":"null"}]}},"type":"object","required":["kind","heading","body_md","sources"],"title":"EnrichmentBlock","description":"One public enrichment section with required citations."},"EnrichmentComputed":{"properties":{"expression":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expression"},"inputs":{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]},"type":"object","title":"Inputs"},"result":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Result"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"}},"type":"object","required":["result"],"title":"EnrichmentComputed","description":"Sandbox-derived claim metadata."},"EnrichmentProposal":{"properties":{"domain":{"type":"string","title":"Domain"},"mode":{"type":"string","title":"Mode"},"ai_description":{"type":"string","title":"Ai Description"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"audience":{"anyOf":[{"type":"string","enum":["consumer","wholesale","both"]},{"type":"null"}],"title":"Audience"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"buyer_or_applicant_questions":{"items":{"type":"string"},"type":"array","title":"Buyer Or Applicant Questions"},"selected_modules":{"items":{"type":"string"},"type":"array","title":"Selected Modules"},"omitted_modules":{"items":{"$ref":"#/components/schemas/OmittedModule"},"type":"array","title":"Omitted Modules"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"blocks":{"items":{"$ref":"#/components/schemas/EnrichmentBlock"},"type":"array","title":"Blocks"},"warnings":{"items":{"$ref":"#/components/schemas/DiscrepancyWarning"},"type":"array","title":"Warnings"},"suppress_public":{"type":"boolean","title":"Suppress Public","default":false}},"type":"object","required":["domain","mode","ai_description","confidence"],"title":"EnrichmentProposal","description":"Agent output and stored public enrichment shape (minus private warnings)."},"EnrichmentSource":{"properties":{"type":{"type":"string","enum":["user_text","kb","connector","market","compute","user_data"],"title":"Type"},"ref":{"type":"string","title":"Ref"},"title":{"type":"string","title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["type","ref","title"],"title":"EnrichmentSource","description":"Cited source for an enrichment block."},"FeedItemOut":{"properties":{"listing":{"anyOf":[{"$ref":"#/components/schemas/ProductListingOut"},{"$ref":"#/components/schemas/JobListingOut"}],"title":"Listing"},"rank":{"$ref":"#/components/schemas/RankOut"}},"type":"object","required":["listing","rank"],"title":"FeedItemOut"},"FunctionCall":{"properties":{"name":{"type":"string","title":"Name"},"arguments":{"type":"string","title":"Arguments"}},"additionalProperties":true,"type":"object","required":["name","arguments"],"title":"FunctionCall","description":"Name and arguments of a function call."},"GeocodeResult":{"properties":{"lat":{"type":"number","title":"Lat"},"lng":{"type":"number","title":"Lng"},"label":{"type":"string","title":"Label"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"}},"type":"object","required":["lat","lng","label"],"title":"GeocodeResult","description":"One forward-geocode hit (a place's coordinates and label)."},"GrantRoleRequest":{"properties":{"role":{"type":"string","const":"admin","title":"Role"},"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","required":["role"],"title":"GrantRoleRequest","description":"Request to grant a role to a user.\n\nOnly ``admin`` is grantable. Postgres ``app_role`` still includes\n``moderator`` / ``user`` as reserved enum values (not safely droppable)."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IcarExportResponse":{"properties":{"animals":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Animals"},"events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Events"},"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"}},"type":"object","title":"IcarExportResponse","description":"ICAR ADE resources for the namespace herd."},"IcarImportResponse":{"properties":{"extraction_run_id":{"type":"string","title":"Extraction Run Id"},"animals":{"type":"integer","title":"Animals"},"events":{"type":"integer","title":"Events"},"proposal_ids":{"items":{"type":"string"},"type":"array","title":"Proposal Ids"}},"type":"object","required":["extraction_run_id","animals","events"],"title":"IcarImportResponse","description":"Result of an ICAR import: proposals awaiting HITL accept."},"ImageInputContent":{"properties":{"type":{"type":"string","const":"image","title":"Type","default":"image"},"source":{"oneOf":[{"$ref":"#/components/schemas/InputContentDataSource"},{"$ref":"#/components/schemas/InputContentUrlSource"}],"title":"Source","discriminator":{"propertyName":"type","mapping":{"data":"#/components/schemas/InputContentDataSource","url":"#/components/schemas/InputContentUrlSource"}}},"metadata":{"anyOf":[{},{"type":"null"}],"title":"Metadata"}},"additionalProperties":true,"type":"object","required":["source"],"title":"ImageInputContent","description":"An image input content fragment."},"ImageryUrlsRequest":{"properties":{"paths":{"items":{"type":"string"},"type":"array","title":"Paths"}},"type":"object","title":"ImageryUrlsRequest"},"ImageryUrlsResponse":{"properties":{"urls":{"additionalProperties":{"type":"string"},"type":"object","title":"Urls"}},"type":"object","title":"ImageryUrlsResponse"},"InputContentDataSource":{"properties":{"type":{"type":"string","const":"data","title":"Type","default":"data"},"value":{"type":"string","title":"Value"},"mimeType":{"type":"string","title":"Mimetype"}},"additionalProperties":true,"type":"object","required":["value","mimeType"],"title":"InputContentDataSource","description":"Inline base64-encoded source."},"InputContentUrlSource":{"properties":{"type":{"type":"string","const":"url","title":"Type","default":"url"},"value":{"type":"string","title":"Value"},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mimetype"}},"additionalProperties":true,"type":"object","required":["value"],"title":"InputContentUrlSource","description":"URL-referenced source."},"InviteApplicationRequest":{"properties":{"username":{"type":"string","title":"Username"}},"type":"object","required":["username"],"title":"InviteApplicationRequest"},"InviteKind":{"type":"string","enum":["connection","team","job"],"title":"InviteKind","description":"What an external invite link grants on claim."},"InviteLinkResponse":{"properties":{"token":{"type":"string","title":"Token"},"url":{"type":"string","title":"Url"},"kind":{"$ref":"#/components/schemas/InviteKind"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["token","url","kind","expires_at"],"title":"InviteLinkResponse","description":"Created invite link."},"InvitePreviewResponse":{"properties":{"kind":{"$ref":"#/components/schemas/InviteKind"},"inviter_username":{"type":"string","title":"Inviter Username"},"inviter_avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inviter Avatar Url"},"inviter_company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inviter Company Name"},"team_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Name"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["kind","inviter_username","expires_at"],"title":"InvitePreviewResponse","description":"Anon-safe preview of an unclaimed invite link."},"InvoiceLineItem":{"properties":{"description":{"type":"string","maxLength":500,"minLength":1,"title":"Description"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity","description":"Quantity (may be fractional)","default":1},"unit_price_cents":{"type":"integer","minimum":0.0,"title":"Unit Price Cents","description":"Unit price in Rappen (net, excl. MWST)"}},"type":"object","required":["description","unit_price_cents"],"title":"InvoiceLineItem","description":"One billable line on an invoice (amounts in Rappen)."},"InvoiceListResponse":{"properties":{"invoices":{"items":{"$ref":"#/components/schemas/InvoiceResponse"},"type":"array","title":"Invoices"}},"type":"object","title":"InvoiceListResponse","description":"List of invoices for the Gestellt/Erhalten tabs."},"InvoiceResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"issuer_user_id":{"type":"string","format":"uuid","title":"Issuer User Id"},"payer_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Payer User Id"},"direction":{"type":"string","title":"Direction","description":"Book direction for the viewer: in=Gestellt (issuer), out=Erhalten (payer)"},"recipient_name":{"type":"string","title":"Recipient Name"},"recipient_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient Email"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"line_items":{"items":{"$ref":"#/components/schemas/InvoiceLineItem"},"type":"array","title":"Line Items"},"mwst_rate":{"type":"number","title":"Mwst Rate","default":0.0},"amount_total_cents":{"type":"integer","title":"Amount Total Cents","default":0},"application_fee_cents":{"type":"integer","title":"Application Fee Cents","default":0},"currency":{"type":"string","title":"Currency","default":"chf"},"status":{"type":"string","title":"Status","default":"draft"},"hosted_invoice_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hosted Invoice Url"},"invoice_pdf":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Pdf"},"due_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Due Date"},"job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Job Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","issuer_user_id","direction","recipient_name","created_at"],"title":"InvoiceResponse","description":"A marketplace invoice as returned to clients."},"JobInvitationNotificationRequest":{"properties":{"user_id":{"type":"string","title":"User Id","description":"Invited user's ID"},"job_id":{"type":"string","title":"Job Id","description":"Job ID"},"job_title":{"type":"string","title":"Job Title","description":"Job title"},"inviter_username":{"type":"string","title":"Inviter Username","description":"Username of person who invited"}},"type":"object","required":["user_id","job_id","job_title","inviter_username"],"title":"JobInvitationNotificationRequest","description":"Request to send a job invitation notification."},"JobListingOut":{"properties":{"kind":{"type":"string","const":"job","title":"Kind","default":"job"},"id":{"type":"string","title":"Id"},"href":{"type":"string","title":"Href"},"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Imageurl"},"sellerName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sellername"},"sellerHref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sellerhref"},"sellerLocation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sellerlocation"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"distanceKm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distancekm"},"reactionScore":{"type":"integer","title":"Reactionscore","default":0},"commentCount":{"type":"integer","title":"Commentcount","default":0},"compensationChf":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Compensationchf"},"paymentUnit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paymentunit"},"beginTime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Begintime"},"allDay":{"type":"boolean","title":"Allday","default":false},"validUntil":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validuntil"}},"type":"object","required":["id","href","title"],"title":"JobListingOut"},"JobRef":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"}},"type":"object","required":["id"],"title":"JobRef"},"JournalImportResponse":{"properties":{"extraction_run_id":{"type":"string","title":"Extraction Run Id"},"bookings":{"type":"integer","title":"Bookings"},"proposal_ids":{"items":{"type":"string"},"type":"array","title":"Proposal Ids"},"skipped":{"type":"integer","title":"Skipped","default":0}},"type":"object","required":["extraction_run_id","bookings"],"title":"JournalImportResponse","description":"Result of a journal (CSV / Abacus XML) import: proposals awaiting HITL accept."},"KBDocument":{"properties":{"s3_key":{"type":"string","title":"S3 Key"},"state":{"type":"string","title":"State"},"attempts":{"type":"integer","title":"Attempts"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size"},"last_modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified"},"next_attempt_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Attempt At"},"ingested_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ingested At"},"page_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Count"},"cognee_data_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cognee Data Id"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url"}},"type":"object","required":["s3_key","state","attempts"],"title":"KBDocument","description":"One kb_document row as the admin list renders it."},"KBDocumentsResponse":{"properties":{"status":{"type":"string","title":"Status"},"documents":{"items":{"$ref":"#/components/schemas/KBDocument"},"type":"array","title":"Documents"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"}},"type":"object","required":["status","documents","total","page","page_size","counts"],"title":"KBDocumentsResponse"},"KBOperationResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"errors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Errors"}},"type":"object","required":["status"],"title":"KBOperationResponse"},"KBPreviewResponse":{"properties":{"key":{"type":"string","title":"Key"},"content_type":{"type":"string","title":"Content Type"},"size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size"},"preview_kind":{"type":"string","title":"Preview Kind"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"page_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Count"},"page_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Page Urls"},"cognee_data_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cognee Data Id"},"pipeline_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pipeline Status"}},"type":"object","required":["key","content_type","preview_kind"],"title":"KBPreviewResponse"},"KBRetryRequest":{"properties":{"keys":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keys"}},"type":"object","title":"KBRetryRequest"},"KBS3DeleteRequest":{"properties":{"keys":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keys"},"folder_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Folder Prefix"}},"type":"object","title":"KBS3DeleteRequest"},"KBS3DeleteResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"s3_prefix":{"type":"string","title":"S3 Prefix"},"enqueued_keys":{"items":{"type":"string"},"type":"array","title":"Enqueued Keys"},"cancelled_inflight":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cancelled Inflight"}},"type":"object","required":["status","s3_prefix","enqueued_keys"],"title":"KBS3DeleteResponse"},"KBS3UploadItem":{"properties":{"relative_key":{"type":"string","title":"Relative Key"},"content_type":{"type":"string","title":"Content Type","default":"application/octet-stream"}},"type":"object","required":["relative_key"],"title":"KBS3UploadItem"},"KBS3UploadUrl":{"properties":{"relative_key":{"type":"string","title":"Relative Key"},"s3_uri":{"type":"string","title":"S3 Uri"},"upload_url":{"type":"string","title":"Upload Url"},"content_type":{"type":"string","title":"Content Type"}},"type":"object","required":["relative_key","s3_uri","upload_url","content_type"],"title":"KBS3UploadUrl"},"KBS3UploadUrlsRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/KBS3UploadItem"},"type":"array","minItems":1,"title":"Items"}},"type":"object","required":["items"],"title":"KBS3UploadUrlsRequest"},"KBS3UploadUrlsResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"uploads":{"items":{"$ref":"#/components/schemas/KBS3UploadUrl"},"type":"array","title":"Uploads"}},"type":"object","required":["status","uploads"],"title":"KBS3UploadUrlsResponse"},"KBStatusResponse":{"properties":{"dataset_name":{"type":"string","title":"Dataset Name"},"dataset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Id"},"processing_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Processing Status"},"s3_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"S3 Prefix"},"raw_status":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Raw Status"},"document_counts":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Document Counts"},"ingest_paused":{"type":"boolean","title":"Ingest Paused","default":false},"context_index":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context Index"},"last_batch_error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Last Batch Error"},"schema_degraded":{"type":"boolean","title":"Schema Degraded","default":false}},"type":"object","required":["dataset_name"],"title":"KBStatusResponse"},"LoginLinkResponse":{"properties":{"url":{"type":"string","title":"Url","description":"Stripe Express Dashboard login URL"}},"type":"object","required":["url"],"title":"LoginLinkResponse","description":"Single-use Express Dashboard login URL."},"MarketplaceFeedResponse":{"properties":{"mode":{"type":"string","enum":["ranked","semantic"],"title":"Mode"},"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/FeedItemOut"},"type":"array","title":"Items"}},"type":"object","required":["mode","total","items"],"title":"MarketplaceFeedResponse"},"MeasurementDetailPayload":{"properties":{"namespace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Namespace Id"},"subject_id":{"type":"string","format":"uuid","title":"Subject Id"},"metric":{"type":"string","title":"Metric"},"value":{"type":"number","title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"source":{"type":"string","title":"Source"}},"type":"object","required":["subject_id","metric","value","observed_at","source"],"title":"MeasurementDetailPayload"},"MediaDeleteRequest":{"properties":{"paths":{"items":{"type":"string"},"type":"array","maxItems":50,"minItems":1,"title":"Paths"}},"type":"object","required":["paths"],"title":"MediaDeleteRequest"},"MediaDeleteResponse":{"properties":{"deleted":{"type":"integer","title":"Deleted"}},"type":"object","required":["deleted"],"title":"MediaDeleteResponse"},"MediaKind":{"type":"string","enum":["product","job","product_pending","job_pending","avatar","farm","article","letter_attachment"],"title":"MediaKind"},"MediaSignUrlsRequest":{"properties":{"paths":{"items":{"type":"string"},"type":"array","maxItems":50,"minItems":1,"title":"Paths"}},"type":"object","required":["paths"],"title":"MediaSignUrlsRequest"},"MediaSignUrlsResponse":{"properties":{"urls":{"items":{"$ref":"#/components/schemas/MediaSignedUrl"},"type":"array","title":"Urls"}},"type":"object","required":["urls"],"title":"MediaSignUrlsResponse"},"MediaSignedUrl":{"properties":{"storage_path":{"type":"string","title":"Storage Path"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["storage_path"],"title":"MediaSignedUrl"},"MediaUploadItem":{"properties":{"kind":{"$ref":"#/components/schemas/MediaKind"},"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename"},"content_type":{"type":"string","maxLength":128,"title":"Content Type","default":"application/octet-stream"},"size_bytes":{"type":"integer","maximum":20971520.0,"minimum":1.0,"title":"Size Bytes","description":"Exact byte size of the file to upload — signed into the PUT URL"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id","description":"Required for product/job permanent uploads"}},"type":"object","required":["kind","filename","size_bytes"],"title":"MediaUploadItem"},"MediaUploadUrl":{"properties":{"kind":{"$ref":"#/components/schemas/MediaKind"},"storage_path":{"type":"string","title":"Storage Path"},"upload_url":{"type":"string","title":"Upload Url"},"content_type":{"type":"string","title":"Content Type"},"cache_control":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cache Control"},"public_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Url"}},"type":"object","required":["kind","storage_path","upload_url","content_type"],"title":"MediaUploadUrl"},"MediaUploadUrlsRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MediaUploadItem"},"type":"array","maxItems":20,"minItems":1,"title":"Items"}},"type":"object","required":["items"],"title":"MediaUploadUrlsRequest"},"MediaUploadUrlsResponse":{"properties":{"uploads":{"items":{"$ref":"#/components/schemas/MediaUploadUrl"},"type":"array","title":"Uploads"}},"type":"object","required":["uploads"],"title":"MediaUploadUrlsResponse"},"MembershipActionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"status":{"anyOf":[{"type":"string","enum":["pending","active","declined","left"]},{"type":"null"}],"title":"Status"}},"type":"object","required":["success"],"title":"MembershipActionResponse","description":"Generic membership mutation response."},"MemoryStatsResponse":{"properties":{"memories":{"type":"integer","title":"Memories","description":"Nodes + edges in the namespace's Cognee graph"},"goal":{"type":"integer","title":"Goal","description":"Arbitrary orientation goal for the memories count"}},"type":"object","required":["memories","goal"],"title":"MemoryStatsResponse","description":"Real Cognee graph size of the caller's personal namespace.\n\n``goal`` is an arbitrary orientation constant for UI progress framing,\nnot a measure of answer quality."},"MessageCreateRequest":{"properties":{"kind":{"type":"string","maxLength":200,"title":"Kind","default":"letter"},"title":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string","maxLength":100000},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"visibility":{"type":"string","enum":["private","public"],"title":"Visibility","default":"private"},"direction":{"type":"string","enum":["in","out"],"title":"Direction","default":"out"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"channel":{"anyOf":[{"type":"string","enum":["in_app","email","postal","other"]},{"type":"null"}],"title":"Channel"},"origin":{"type":"string","enum":["user","ai","system","imported"],"title":"Origin","default":"user"},"source_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Entity Id"}},"type":"object","title":"MessageCreateRequest"},"MessageDetailPayload":{"properties":{"namespace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Namespace Id"},"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel"},"thread_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Thread Id"},"is_read":{"type":"boolean","title":"Is Read","default":false},"external_system":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External System"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref"}},"type":"object","title":"MessageDetailPayload"},"MessageListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MessageResponse"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["limit","offset","total"],"title":"MessageListResponse"},"MessageResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"namespace_id":{"type":"string","format":"uuid","title":"Namespace Id"},"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"lifecycle":{"type":"string","title":"Lifecycle","default":"active"},"visibility":{"type":"string","title":"Visibility","default":"private"},"origin":{"type":"string","title":"Origin","default":"user"},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"reaction_score":{"type":"integer","title":"Reaction Score","default":0},"comment_count":{"type":"integer","title":"Comment Count","default":0},"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"},"detail":{"anyOf":[{"$ref":"#/components/schemas/MessageDetailPayload"},{"type":"null"}]}},"type":"object","required":["id","namespace_id","kind"],"title":"MessageResponse"},"MessageUpdateRequest":{"properties":{"kind":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Kind"},"title":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string","maxLength":100000},{"type":"null"}],"title":"Body"},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes"},"lifecycle":{"anyOf":[{"type":"string","enum":["proposed","draft","active","archived"]},{"type":"null"}],"title":"Lifecycle"},"visibility":{"anyOf":[{"type":"string","enum":["private","public"]},{"type":"null"}],"title":"Visibility"},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"channel":{"anyOf":[{"type":"string","enum":["in_app","email","postal","other"]},{"type":"null"}],"title":"Channel"},"is_read":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Read"}},"type":"object","title":"MessageUpdateRequest"},"NotificationDevicePlatform":{"type":"string","enum":["ios","android","web"],"title":"NotificationDevicePlatform","description":"Device platforms for push delivery."},"NotificationDeviceRegisterRequest":{"properties":{"platform":{"$ref":"#/components/schemas/NotificationDevicePlatform"},"token":{"type":"string","maxLength":512,"minLength":8,"title":"Token"}},"type":"object","required":["platform","token"],"title":"NotificationDeviceRegisterRequest","description":"Register or refresh a push device token."},"NotificationDeviceResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"platform":{"type":"string","title":"Platform"},"token":{"type":"string","title":"Token"},"last_seen":{"type":"string","format":"date-time","title":"Last Seen"}},"type":"object","required":["id","platform","token","last_seen"],"title":"NotificationDeviceResponse","description":"Registered push device."},"NotificationPreferencesResponse":{"properties":{"automation_enabled":{"type":"boolean","title":"Automation Enabled","default":true},"agent_push_enabled":{"type":"boolean","title":"Agent Push Enabled","default":true},"agent_email_enabled":{"type":"boolean","title":"Agent Email Enabled","default":true},"social_push_enabled":{"type":"boolean","title":"Social Push Enabled","default":true},"social_email_enabled":{"type":"boolean","title":"Social Email Enabled","default":true},"account_push_enabled":{"type":"boolean","title":"Account Push Enabled","default":true},"account_email_enabled":{"type":"boolean","title":"Account Email Enabled","default":true}},"type":"object","title":"NotificationPreferencesResponse","description":"User notification preferences (per-provenance channel matrix)."},"NotificationPreferencesUpdateRequest":{"properties":{"automation_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Automation Enabled"},"agent_push_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Agent Push Enabled"},"agent_email_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Agent Email Enabled"},"social_push_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Social Push Enabled"},"social_email_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Social Email Enabled"},"account_push_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Account Push Enabled"}},"type":"object","title":"NotificationPreferencesUpdateRequest","description":"Partial update payload for notification preferences."},"NotificationResult":{"properties":{"sent":{"type":"boolean","title":"Sent","description":"Whether the notification was sent"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Reason if not sent"},"resend_email_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resend Email Id","description":"Resend email ID if sent"},"notification_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Notification Id","description":"In-app notification ID if created"}},"type":"object","required":["sent"],"title":"NotificationResult","description":"Result of sending a notification."},"OmittedModule":{"properties":{"module":{"type":"string","title":"Module"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["module","reason"],"title":"OmittedModule","description":"Module the agent considered but skipped."},"OnboardingResponse":{"properties":{"account_id":{"type":"string","title":"Account Id","description":"Stripe connected account ID"},"status":{"$ref":"#/components/schemas/ConnectAccountStatus","description":"Current account status"}},"type":"object","required":["account_id","status"],"title":"OnboardingResponse","description":"Result of ensuring a connected account exists (embedded onboarding)."},"PartyCreateRequest":{"properties":{"kind":{"type":"string","enum":["contact","org","farm","team"],"title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"visibility":{"type":"string","enum":["private","public"],"title":"Visibility","default":"private"},"origin":{"type":"string","enum":["user","ai","system","imported"],"title":"Origin","default":"user"},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"}},"type":"object","required":["kind"],"title":"PartyCreateRequest"},"PartyListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PartyResponse"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["limit","offset","total"],"title":"PartyListResponse"},"PartyMergeRequest":{"properties":{"other_ids":{"items":{"type":"string","format":"uuid"},"type":"array","minItems":1,"title":"Other Ids"}},"type":"object","required":["other_ids"],"title":"PartyMergeRequest","description":"Merge the listed parties into the path party (the survivor)."},"PartyResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"namespace_id":{"type":"string","format":"uuid","title":"Namespace Id"},"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"lifecycle":{"type":"string","title":"Lifecycle","default":"active"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","title":"Visibility","default":"private"},"origin":{"type":"string","title":"Origin","default":"user"},"is_external":{"type":"boolean","title":"Is External","default":false},"direction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"reaction_score":{"type":"integer","title":"Reaction Score","default":0},"comment_count":{"type":"integer","title":"Comment Count","default":0},"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"},"available_channels":{"items":{"type":"string"},"type":"array","title":"Available Channels"}},"type":"object","required":["id","namespace_id","kind"],"title":"PartyResponse"},"PartyUpdateRequest":{"properties":{"kind":{"anyOf":[{"type":"string","enum":["contact","org","farm","team"]},{"type":"null"}],"title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes"},"lifecycle":{"anyOf":[{"type":"string","enum":["proposed","draft","active","archived"]},{"type":"null"}],"title":"Lifecycle"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"anyOf":[{"type":"string","enum":["private","public"]},{"type":"null"}],"title":"Visibility"},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"}},"type":"object","title":"PartyUpdateRequest"},"PendingApplicationCountsResponse":{"properties":{"invitations":{"type":"integer","title":"Invitations","default":0},"applications_on_my_jobs":{"type":"integer","title":"Applications On My Jobs","default":0},"my_applications":{"type":"integer","title":"My Applications","default":0},"total":{"type":"integer","title":"Total","default":0}},"type":"object","title":"PendingApplicationCountsResponse","description":"Pending application/invitation badge counts for the personal namespace."},"PendingConnectionCountResponse":{"properties":{"count":{"type":"integer","title":"Count"}},"type":"object","required":["count"],"title":"PendingConnectionCountResponse","description":"Incoming pending request count (sidebar badge)."},"PingenWebhookResponse":{"properties":{"updated":{"type":"integer","title":"Updated"}},"type":"object","required":["updated"],"title":"PingenWebhookResponse"},"PlaceCreateRequest":{"properties":{"kind":{"type":"string","enum":["field","building","parcel","point","region"],"title":"Kind","default":"point"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"visibility":{"type":"string","enum":["private","public"],"title":"Visibility","default":"private"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"geometry":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Geometry"},"egrid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Egrid"},"area_ha":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Area Ha"}},"type":"object","title":"PlaceCreateRequest"},"PlaceDetailPayload":{"properties":{"geometry":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Geometry"},"egrid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Egrid"},"area_ha":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Area Ha"}},"type":"object","title":"PlaceDetailPayload"},"PlaceListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PlaceResponse"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["limit","offset","total"],"title":"PlaceListResponse"},"PlaceMergeRequest":{"properties":{"other_ids":{"items":{"type":"string","format":"uuid"},"type":"array","minItems":1,"title":"Other Ids"}},"type":"object","required":["other_ids"],"title":"PlaceMergeRequest"},"PlaceMergeSuggestion":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"kind":{"type":"string","title":"Kind"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"reason":{"type":"string","enum":["contained","nearby"],"title":"Reason"},"distance_m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distance M"}},"type":"object","required":["id","kind","reason"],"title":"PlaceMergeSuggestion"},"PlaceRelatedGroup":{"properties":{"count":{"type":"integer","title":"Count","default":0},"items":{"items":{"$ref":"#/components/schemas/PlaceRelatedItem"},"type":"array","title":"Items"}},"type":"object","title":"PlaceRelatedGroup"},"PlaceRelatedItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"plane":{"type":"string","title":"Plane"},"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url"}},"type":"object","required":["id","plane","kind"],"title":"PlaceRelatedItem"},"PlaceRelatedResponse":{"properties":{"activities":{"$ref":"#/components/schemas/PlaceRelatedGroup"},"assets":{"$ref":"#/components/schemas/PlaceRelatedGroup"},"records":{"$ref":"#/components/schemas/PlaceRelatedGroup"},"parties":{"$ref":"#/components/schemas/PlaceRelatedGroup"},"media":{"$ref":"#/components/schemas/PlaceRelatedGroup"}},"type":"object","title":"PlaceRelatedResponse"},"PlaceResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"namespace_id":{"type":"string","format":"uuid","title":"Namespace Id"},"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"lifecycle":{"type":"string","title":"Lifecycle","default":"active"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","title":"Visibility","default":"private"},"origin":{"type":"string","title":"Origin","default":"user"},"is_external":{"type":"boolean","title":"Is External","default":false},"direction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"reaction_score":{"type":"integer","title":"Reaction Score","default":0},"comment_count":{"type":"integer","title":"Comment Count","default":0},"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"},"detail":{"anyOf":[{"$ref":"#/components/schemas/PlaceDetailPayload"},{"type":"null"}]},"absorbed":{"type":"boolean","title":"Absorbed","default":false},"suggested_merges":{"items":{"$ref":"#/components/schemas/PlaceMergeSuggestion"},"type":"array","title":"Suggested Merges"}},"type":"object","required":["id","namespace_id","kind"],"title":"PlaceResponse"},"PlaceUpdateRequest":{"properties":{"kind":{"anyOf":[{"type":"string","enum":["field","building","parcel","point","region","home"]},{"type":"null"}],"title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes"},"lifecycle":{"anyOf":[{"type":"string","enum":["proposed","draft","active","archived"]},{"type":"null"}],"title":"Lifecycle"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"anyOf":[{"type":"string","enum":["private","public"]},{"type":"null"}],"title":"Visibility"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"place_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Label"},"geometry":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Geometry"},"egrid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Egrid"},"area_ha":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Area Ha"}},"type":"object","title":"PlaceUpdateRequest"},"PortalResponse":{"properties":{"url":{"type":"string","title":"Url","description":"Portal URL to redirect to"}},"type":"object","required":["url"],"title":"PortalResponse","description":"Response from customer portal creation."},"PostSearchResult":{"properties":{"id":{"type":"string","title":"Id"},"distance_km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distance Km"}},"type":"object","required":["id"],"title":"PostSearchResult","description":"Nearby public post (article) search hit — id-first for FE ranking."},"PostalAddress":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"company":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Company"},"street":{"type":"string","maxLength":160,"minLength":1,"title":"Street"},"postal_code":{"type":"string","maxLength":16,"minLength":1,"title":"Postal Code"},"city":{"type":"string","maxLength":120,"minLength":1,"title":"City"},"country":{"type":"string","maxLength":2,"minLength":2,"title":"Country","default":"CH"}},"type":"object","required":["name","street","postal_code","city"],"title":"PostalAddress","description":"Structured recipient address for the Pingen address window."},"PostalCheckoutRequest":{"properties":{"source_kind":{"type":"string","enum":["letter","document"],"title":"Source Kind"},"source_id":{"type":"string","format":"uuid","title":"Source Id"},"recipient":{"$ref":"#/components/schemas/PostalRecipientRequest"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"},"quoted_final_price_chf":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quoted Final Price Chf"}},"type":"object","required":["source_kind","source_id","recipient"],"title":"PostalCheckoutRequest"},"PostalCheckoutResponse":{"properties":{"url":{"type":"string","title":"Url"},"letter_id":{"type":"string","format":"uuid","title":"Letter Id"},"final_price_chf":{"type":"number","title":"Final Price Chf"},"currency":{"type":"string","title":"Currency","default":"CHF"}},"type":"object","required":["url","letter_id","final_price_chf"],"title":"PostalCheckoutResponse"},"PostalQuoteRequest":{"properties":{"source_kind":{"type":"string","enum":["letter","document"],"title":"Source Kind"},"source_id":{"type":"string","format":"uuid","title":"Source Id"},"recipient":{"$ref":"#/components/schemas/PostalRecipientRequest"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"}},"type":"object","required":["source_kind","source_id","recipient"],"title":"PostalQuoteRequest"},"PostalQuoteResponse":{"properties":{"pages":{"type":"integer","title":"Pages"},"pingen_price_chf":{"type":"number","title":"Pingen Price Chf"},"final_price_chf":{"type":"number","title":"Final Price Chf"},"currency":{"type":"string","title":"Currency","default":"CHF"},"recipient":{"$ref":"#/components/schemas/PostalAddress"}},"type":"object","required":["pages","pingen_price_chf","final_price_chf","recipient"],"title":"PostalQuoteResponse"},"PostalRecipientRequest":{"properties":{"contact_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Contact Id"},"address":{"anyOf":[{"$ref":"#/components/schemas/PostalAddress"},{"type":"null"}]}},"type":"object","title":"PostalRecipientRequest","description":"Recipient selection: an existing contact or a one-off / self address."},"PostalVerifySessionRequest":{"properties":{"session_id":{"type":"string","maxLength":200,"minLength":3,"title":"Session Id"}},"type":"object","required":["session_id"],"title":"PostalVerifySessionRequest"},"PostalVerifySessionResponse":{"properties":{"letter_id":{"type":"string","format":"uuid","title":"Letter Id"},"paid":{"type":"boolean","title":"Paid"},"delivery_status":{"type":"string","title":"Delivery Status"}},"type":"object","required":["letter_id","paid","delivery_status"],"title":"PostalVerifySessionResponse"},"ProductListingOut":{"properties":{"kind":{"type":"string","const":"product","title":"Kind","default":"product"},"id":{"type":"string","title":"Id"},"href":{"type":"string","title":"Href"},"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Imageurl"},"sellerName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sellername"},"sellerHref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sellerhref"},"sellerLocation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sellerlocation"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"distanceKm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distancekm"},"reactionScore":{"type":"integer","title":"Reactionscore","default":0},"commentCount":{"type":"integer","title":"Commentcount","default":0},"priceChf":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pricechf"},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantity"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"audience":{"anyOf":[{"type":"string","enum":["consumer","wholesale","both"]},{"type":"null"}],"title":"Audience"},"deliveryResponsibility":{"anyOf":[{"type":"string","enum":["seller","buyer"]},{"type":"null"}],"title":"Deliveryresponsibility"}},"type":"object","required":["id","href","title"],"title":"ProductListingOut"},"ProfileLocationRequest":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"}},"type":"object","required":["latitude","longitude"],"title":"ProfileLocationRequest","description":"Authoritative home-location write from client coordinates."},"ProfileLocationResponse":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"}},"type":"object","required":["latitude","longitude"],"title":"ProfileLocationResponse","description":"Saved home coordinates, echoed back after the write."},"ProfileUpdateRequest":{"properties":{"first_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Last Name"},"street_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Street Name"},"street_number":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Street Number"},"postal_code":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Postal Code"},"city":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"City"},"canton":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Canton"},"company_description":{"anyOf":[{"type":"string","maxLength":3000},{"type":"null"}],"title":"Company Description"},"company_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Company Name"},"country":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Country"},"avatar_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Avatar Url"},"farm_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Farm Images"},"farm_slug":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Farm Slug"},"public_page":{"anyOf":[{"$ref":"#/components/schemas/PublicPageContent"},{"type":"null"}]},"preferred_language":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Preferred Language"},"iban":{"anyOf":[{"type":"string","maxLength":34},{"type":"null"}],"title":"Iban"},"qr_iban":{"anyOf":[{"type":"string","maxLength":34},{"type":"null"}],"title":"Qr Iban"},"mwst_nummer":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Mwst Nummer"},"uid":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Uid","description":"eCH-0261 legalUnit UID (CHE-xxx.xxx.xxx), distinct from VAT"},"bur_number":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Bur Number","description":"eCH-0261 localUnit BUR-Nummer"},"farm_type":{"anyOf":[{"type":"string","maxLength":2,"pattern":"^[0-9]{2}$"},{"type":"null"}],"title":"Farm Type","description":"eCH-0261 farmType (01 Ganzjahresbetrieb, 02 Produktionsstätte, …)"},"agricultural_zone":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Agricultural Zone","description":"LBV / GeoIV 149 LZ_Code (31 Talzone … 61 Sömmerungsgebiet)"},"parent_bur":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Parent Bur"},"parent_uid":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Parent Uid"},"betriebsnummer":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Betriebsnummer","description":"Cantonal Betriebsnummer display id (not BUR)"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"}},"type":"object","title":"ProfileUpdateRequest","description":"Non-location profile fields (update-only; signup insert stays on edge function)."},"ProfileUpdateResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true}},"type":"object","title":"ProfileUpdateResponse","description":"Acknowledgement after a profile field write."},"PublicPageContent":{"properties":{"tagline":{"anyOf":[{"type":"string","maxLength":140},{"type":"null"}],"title":"Tagline"},"notice":{"anyOf":[{"$ref":"#/components/schemas/PublicPageNotice"},{"type":"null"}]},"story":{"anyOf":[{"type":"string","maxLength":3000},{"type":"null"}],"title":"Story"},"highlights":{"items":{"$ref":"#/components/schemas/PublicPageHighlight"},"type":"array","maxItems":4,"title":"Highlights"},"hero_image":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Hero Image"},"gallery":{"items":{"$ref":"#/components/schemas/PublicPageImage"},"type":"array","maxItems":8,"title":"Gallery"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"}},"type":"object","title":"PublicPageContent","description":"Structured public-page content for uely.ch/{farm_slug}."},"PublicPageHighlight":{"properties":{"title":{"type":"string","maxLength":80,"minLength":1,"title":"Title"},"body":{"type":"string","maxLength":800,"minLength":1,"title":"Body"}},"type":"object","required":["title","body"],"title":"PublicPageHighlight","description":"One highlight section on the public page."},"PublicPageImage":{"properties":{"url":{"type":"string","maxLength":512,"minLength":1,"title":"Url"},"caption":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Caption"}},"type":"object","required":["url"],"title":"PublicPageImage","description":"One curated gallery image on the public page."},"PublicPageNotice":{"properties":{"text":{"type":"string","maxLength":200,"minLength":1,"title":"Text"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["text","updated_at"],"title":"PublicPageNotice","description":"Homepage-only short notice shown as «Aktuell»."},"RankComponentsOut":{"properties":{"proximity":{"type":"number","title":"Proximity"},"recency":{"type":"number","title":"Recency"},"completeness":{"type":"number","title":"Completeness"},"popularity":{"type":"number","title":"Popularity"},"audience_affinity":{"type":"number","title":"Audience Affinity"}},"type":"object","required":["proximity","recency","completeness","popularity","audience_affinity"],"title":"RankComponentsOut"},"RankOut":{"properties":{"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"distance_km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distance Km"},"components":{"anyOf":[{"$ref":"#/components/schemas/RankComponentsOut"},{"type":"null"}]}},"type":"object","title":"RankOut"},"ReactionRequest":{"properties":{"reaction":{"type":"string","enum":["like","upvote","downvote"],"title":"Reaction","default":"like"}},"type":"object","title":"ReactionRequest"},"ReactionStateResponse":{"properties":{"entity_id":{"type":"string","format":"uuid","title":"Entity Id"},"plane":{"type":"string","enum":["party","place","asset","activity","message","record","transaction","media"],"title":"Plane"},"reaction_score":{"type":"integer","title":"Reaction Score","default":0},"viewer_reactions":{"items":{"type":"string","enum":["like","upvote","downvote"]},"type":"array","title":"Viewer Reactions"}},"type":"object","required":["entity_id","plane"],"title":"ReactionStateResponse"},"ReactionToggleResponse":{"properties":{"reacted":{"type":"boolean","title":"Reacted"},"reaction":{"anyOf":[{"type":"string","enum":["like","upvote","downvote"]},{"type":"null"}],"title":"Reaction"},"reaction_score":{"type":"integer","title":"Reaction Score"},"viewer_reactions":{"items":{"type":"string","enum":["like","upvote","downvote"]},"type":"array","title":"Viewer Reactions"}},"type":"object","required":["reacted","reaction_score"],"title":"ReactionToggleResponse"},"ReasoningMessage":{"properties":{"id":{"type":"string","title":"Id"},"role":{"type":"string","const":"reasoning","title":"Role","default":"reasoning"},"content":{"type":"string","title":"Content"},"encryptedValue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encryptedvalue"}},"additionalProperties":true,"type":"object","required":["id","content"],"title":"ReasoningMessage","description":"A reasoning message containing the agent's internal reasoning process."},"RecordCreateRequest":{"properties":{"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","enum":["private","public"],"title":"Visibility","default":"private"},"origin":{"type":"string","enum":["user","ai","system","imported"],"title":"Origin","default":"user"},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"source_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Entity Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"subject_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Subject Id"},"metric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["kind"],"title":"RecordCreateRequest"},"RecordListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/RecordResponse"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["limit","offset","total"],"title":"RecordListResponse"},"RecordResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"namespace_id":{"type":"string","format":"uuid","title":"Namespace Id"},"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"lifecycle":{"type":"string","title":"Lifecycle","default":"active"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","title":"Visibility","default":"private"},"origin":{"type":"string","title":"Origin","default":"user"},"direction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"reaction_score":{"type":"integer","title":"Reaction Score","default":0},"comment_count":{"type":"integer","title":"Comment Count","default":0},"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"},"measurement":{"anyOf":[{"$ref":"#/components/schemas/MeasurementDetailPayload"},{"type":"null"}]}},"type":"object","required":["id","namespace_id","kind"],"title":"RecordResponse"},"RecordUpdateRequest":{"properties":{"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes"},"lifecycle":{"anyOf":[{"type":"string","enum":["proposed","draft","active","archived"]},{"type":"null"}],"title":"Lifecycle"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"anyOf":[{"type":"string","enum":["private","public"]},{"type":"null"}],"title":"Visibility"},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"subject_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Subject Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"metric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"instruction":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Instruction"}},"type":"object","title":"RecordUpdateRequest"},"ResendWebhookResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"letter_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Letter Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"skipped":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skipped"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success"],"title":"ResendWebhookResponse","description":"Response for Resend webhook endpoints."},"ResetNamespaceResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"new_namespace_id":{"type":"string","title":"New Namespace Id"}},"type":"object","required":["success","new_namespace_id"],"title":"ResetNamespaceResponse","description":"Response after resetting namespace."},"ResumeEntry":{"properties":{"interruptId":{"type":"string","title":"Interruptid"},"status":{"type":"string","enum":["resolved","cancelled"],"title":"Status"},"payload":{"anyOf":[{},{"type":"null"}],"title":"Payload"}},"additionalProperties":true,"type":"object","required":["interruptId","status"],"title":"ResumeEntry","description":"A per-interrupt response in the resume array of a RunAgentInput."},"RunAgentInput":{"properties":{"threadId":{"type":"string","title":"Threadid"},"runId":{"type":"string","title":"Runid"},"parentRunId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parentrunid"},"state":{"title":"State"},"messages":{"items":{"oneOf":[{"$ref":"#/components/schemas/DeveloperMessage"},{"$ref":"#/components/schemas/SystemMessage"},{"$ref":"#/components/schemas/AssistantMessage"},{"$ref":"#/components/schemas/UserMessage"},{"$ref":"#/components/schemas/ToolMessage"},{"$ref":"#/components/schemas/ActivityMessage"},{"$ref":"#/components/schemas/ReasoningMessage"}],"discriminator":{"propertyName":"role","mapping":{"activity":"#/components/schemas/ActivityMessage","assistant":"#/components/schemas/AssistantMessage","developer":"#/components/schemas/DeveloperMessage","reasoning":"#/components/schemas/ReasoningMessage","system":"#/components/schemas/SystemMessage","tool":"#/components/schemas/ToolMessage","user":"#/components/schemas/UserMessage"}}},"type":"array","title":"Messages"},"tools":{"items":{"$ref":"#/components/schemas/Tool"},"type":"array","title":"Tools"},"context":{"items":{"$ref":"#/components/schemas/Context"},"type":"array","title":"Context"},"forwardedProps":{"title":"Forwardedprops"},"resume":{"anyOf":[{"items":{"$ref":"#/components/schemas/ResumeEntry"},"type":"array"},{"type":"null"}],"title":"Resume"}},"additionalProperties":true,"type":"object","required":["threadId","runId","state","messages","tools","context","forwardedProps"],"title":"RunAgentInput","description":"Input for running an agent."},"SeedExampleDataResponse":{"properties":{"seeded":{"type":"boolean","title":"Seeded","description":"True when this call created example data"},"already_seeded":{"type":"boolean","title":"Already Seeded","description":"True when example_data_seeded_at was already set"},"created":{"additionalProperties":{"type":"integer"},"type":"object","title":"Created","description":"Counts of created items by kind (documents, products, jobs, teams, letters)"}},"type":"object","required":["seeded","already_seeded"],"title":"SeedExampleDataResponse","description":"Result of a seed attempt (idempotent)."},"SendMessageRequest":{"properties":{"channel":{"anyOf":[{"type":"string","enum":["in_app","email","postal","other"]},{"type":"null"}],"title":"Channel","description":"Optional channel override; otherwise chosen from counterparty keys"}},"type":"object","title":"SendMessageRequest"},"SendMessageResponse":{"properties":{"message":{"$ref":"#/components/schemas/MessageResponse"},"channel":{"type":"string","enum":["in_app","email","postal","other"],"title":"Channel"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref"},"recipient_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Recipient Entity Id"}},"type":"object","required":["message","channel"],"title":"SendMessageResponse"},"SourcePreviewItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url"},"page_count":{"type":"integer","title":"Page Count","default":0}},"type":"object","required":["id"],"title":"SourcePreviewItem","description":"First-page preview for one uploaded source."},"SourcePreviewsRequest":{"properties":{"ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":50,"minItems":1,"title":"Ids"}},"type":"object","required":["ids"],"title":"SourcePreviewsRequest","description":"Batch request for first-page preview URLs."},"SourcePreviewsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SourcePreviewItem"},"type":"array","title":"Items"}},"type":"object","title":"SourcePreviewsResponse","description":"Batch first-page previews for uploaded sources."},"SourceUrlResponse":{"properties":{"url":{"type":"string","title":"Url"},"expires_in":{"type":"integer","title":"Expires In","description":"URL lifetime in seconds","default":900},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url"},"page_urls":{"items":{"type":"string"},"type":"array","title":"Page Urls"},"page_count":{"type":"integer","title":"Page Count","default":0}},"type":"object","required":["url"],"title":"SourceUrlResponse","description":"Short-lived presigned URL for a source original and optional page previews."},"StripeWebhookResponse":{"properties":{"received":{"type":"boolean","title":"Received"},"skipped":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skipped"}},"type":"object","required":["received"],"title":"StripeWebhookResponse","description":"Response for Stripe webhook handling."},"SuccessResponse":{"properties":{"success":{"type":"boolean","title":"Success"}},"type":"object","required":["success"],"title":"SuccessResponse","description":"Simple success response."},"SystemHealth":{"properties":{"database":{"type":"string","enum":["healthy","degraded","down"],"title":"Database"},"redis":{"type":"string","enum":["healthy","degraded","down"],"title":"Redis"},"cognee":{"type":"string","enum":["healthy","degraded","down"],"title":"Cognee"},"celery":{"type":"string","enum":["healthy","degraded","down"],"title":"Celery"},"overall":{"type":"string","enum":["healthy","degraded","down"],"title":"Overall"}},"type":"object","required":["database","redis","cognee","celery","overall"],"title":"SystemHealth","description":"System health status (core services: database, redis, cognee SDK, celery)."},"SystemMessage":{"properties":{"id":{"type":"string","title":"Id"},"role":{"type":"string","const":"system","title":"Role","default":"system"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"encryptedValue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encryptedvalue"}},"additionalProperties":true,"type":"object","required":["id","content"],"title":"SystemMessage","description":"A system message."},"SystemSetting":{"properties":{"key":{"type":"string","title":"Key"},"value":{"title":"Value"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"sensitivity":{"type":"string","enum":["public","sensitive","critical"],"title":"Sensitivity","default":"public"},"category":{"type":"string","enum":["general","pricing","features","other"],"title":"Category","default":"general"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"value_type":{"type":"string","enum":["boolean","number","string","json"],"title":"Value Type","default":"string"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["key","value"],"title":"SystemSetting","description":"System setting entry."},"TaskdataExportResponse":{"properties":{"url":{"type":"string","title":"Url"},"expires_in":{"type":"integer","title":"Expires In"},"filename":{"type":"string","title":"Filename","default":"TASKDATA.zip"}},"type":"object","required":["url","expires_in"],"title":"TaskdataExportResponse","description":"Signed-URL handoff for an ISO-XML TASKDATA.zip."},"TeamInvitationNotificationRequest":{"properties":{"user_id":{"type":"string","title":"User Id","description":"Invited user's ID"},"team_id":{"type":"string","title":"Team Id","description":"Team ID"},"team_name":{"type":"string","title":"Team Name","description":"Team name"},"inviter_username":{"type":"string","title":"Inviter Username","description":"Username of person who invited"}},"type":"object","required":["user_id","team_id","team_name","inviter_username"],"title":"TeamInvitationNotificationRequest","description":"Request to send a team invitation notification."},"TeamInvitationRequest":{"properties":{"user_id":{"type":"string","title":"User Id"},"role":{"type":"string","enum":["admin","member"],"title":"Role","default":"member"}},"type":"object","required":["user_id"],"title":"TeamInvitationRequest","description":"Invite a user to a team."},"TeamMembershipResponse":{"properties":{"id":{"type":"string","title":"Id"},"team_id":{"type":"string","title":"Team Id"},"user_id":{"type":"string","title":"User Id"},"role":{"type":"string","title":"Role"},"status":{"type":"string","enum":["pending","active","declined","left"],"title":"Status"}},"type":"object","required":["id","team_id","user_id","role","status"],"title":"TeamMembershipResponse","description":"Membership / invitation row."},"TeamMessageRequest":{"properties":{"content":{"type":"string","maxLength":5000,"minLength":1,"title":"Content","description":"Message content"}},"type":"object","required":["content"],"title":"TeamMessageRequest","description":"Request to send a team chat message."},"TeamMessageResponse":{"properties":{"id":{"type":"string","title":"Id"},"namespace_id":{"type":"string","title":"Namespace Id"},"user_id":{"type":"string","title":"User Id"},"content":{"type":"string","title":"Content"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","namespace_id","user_id","content","created_at"],"title":"TeamMessageResponse","description":"Team chat message response."},"TeamResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"namespace_id":{"type":"string","title":"Namespace Id"},"admin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin Id"},"is_public":{"type":"boolean","title":"Is Public"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","name","description","namespace_id","is_public","created_at","updated_at"],"title":"TeamResponse","description":"Team response."},"TextInputContent":{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"},"text":{"type":"string","title":"Text"}},"additionalProperties":true,"type":"object","required":["text"],"title":"TextInputContent","description":"A text fragment in a multimodal user message."},"Tool":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"parameters":{"anyOf":[{},{"type":"null"}],"title":"Parameters"}},"additionalProperties":true,"type":"object","required":["name","description"],"title":"Tool","description":"A tool definition."},"ToolCall":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","const":"function","title":"Type","default":"function"},"function":{"$ref":"#/components/schemas/FunctionCall"},"encryptedValue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encryptedvalue"}},"additionalProperties":true,"type":"object","required":["id","function"],"title":"ToolCall","description":"A tool call, modelled after OpenAI tool calls."},"ToolMessage":{"properties":{"id":{"type":"string","title":"Id"},"role":{"type":"string","const":"tool","title":"Role","default":"tool"},"content":{"type":"string","title":"Content"},"toolCallId":{"type":"string","title":"Toolcallid"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"encryptedValue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encryptedvalue"}},"additionalProperties":true,"type":"object","required":["id","content","toolCallId"],"title":"ToolMessage","description":"A tool result message."},"TrainingResponse":{"properties":{"upload_id":{"type":"string","format":"uuid","title":"Upload Id"},"status":{"type":"string","title":"Status","description":"Status: processing, completed, failed","default":"processing"}},"type":"object","required":["upload_id"],"title":"TrainingResponse","description":"Response from training submission."},"TransactionCreateRequest":{"properties":{"kind":{"type":"string","title":"Kind","default":"expense"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","enum":["private","public"],"title":"Visibility","default":"private"},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"amount_gross":{"type":"integer","title":"Amount Gross"},"amount_net":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Net"},"vat_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vat Amount"},"vat_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vat Rate"},"currency":{"type":"string","title":"Currency","default":"chf"},"booking_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Booking Date"},"value_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Value Date"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"account":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account"},"external_system":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External System"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref"}},"type":"object","required":["amount_gross"],"title":"TransactionCreateRequest"},"TransactionDetailPayload":{"properties":{"amount_gross":{"type":"integer","title":"Amount Gross"},"amount_net":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Net"},"vat_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vat Amount"},"vat_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vat Rate"},"currency":{"type":"string","title":"Currency","default":"chf"},"booking_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Booking Date"},"value_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Value Date"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"account":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account"},"external_system":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External System"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref"}},"type":"object","required":["amount_gross"],"title":"TransactionDetailPayload"},"TransactionListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TransactionResponse"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["limit","offset","total"],"title":"TransactionListResponse"},"TransactionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"namespace_id":{"type":"string","format":"uuid","title":"Namespace Id"},"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"lifecycle":{"type":"string","title":"Lifecycle","default":"active"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"type":"string","title":"Visibility","default":"private"},"origin":{"type":"string","title":"Origin","default":"user"},"is_external":{"type":"boolean","title":"Is External","default":false},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"owner_party_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner Party Id"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"reaction_score":{"type":"integer","title":"Reaction Score","default":0},"comment_count":{"type":"integer","title":"Comment Count","default":0},"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"},"detail":{"anyOf":[{"$ref":"#/components/schemas/TransactionDetailPayload"},{"type":"null"}]}},"type":"object","required":["id","namespace_id","kind"],"title":"TransactionResponse"},"TransactionUpdateRequest":{"properties":{"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes"},"lifecycle":{"anyOf":[{"type":"string","enum":["proposed","draft","active","archived"]},{"type":"null"}],"title":"Lifecycle"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"visibility":{"anyOf":[{"type":"string","enum":["private","public"]},{"type":"null"}],"title":"Visibility"},"direction":{"anyOf":[{"type":"string","enum":["in","out"]},{"type":"null"}],"title":"Direction"},"counterparty_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counterparty Id"},"amount_gross":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Gross"},"amount_net":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Net"},"vat_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vat Amount"},"vat_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vat Rate"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"booking_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Booking Date"},"value_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Value Date"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"account":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account"},"external_system":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External System"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref"}},"type":"object","title":"TransactionUpdateRequest"},"TranscriptionResponse":{"properties":{"text":{"type":"string","title":"Text","description":"Transcribed text (Standard German for Swiss dialect)"}},"type":"object","required":["text"],"title":"TranscriptionResponse","description":"Transcribed text returned to the client."},"UnreadLetterCountResponse":{"properties":{"count":{"type":"integer","title":"Count","default":0}},"type":"object","title":"UnreadLetterCountResponse","description":"Unread inbound letters in the personal namespace."},"UpdateCreditsRequest":{"properties":{"amount_millicredits":{"type":"integer","title":"Amount Millicredits","description":"Amount of millicredits to add (can be negative, 1000 millicredits = 1 AKh)"},"reason":{"type":"string","maxLength":500,"minLength":1,"title":"Reason"}},"type":"object","required":["amount_millicredits","reason"],"title":"UpdateCreditsRequest","description":"Request to update user credits."},"UpdateSettingRequest":{"properties":{"value":{"title":"Value"}},"type":"object","required":["value"],"title":"UpdateSettingRequest","description":"Request to update a system setting."},"UpdateSubscriptionRequest":{"properties":{"tier":{"type":"string","enum":["test","lehrling","buezer","meister","enterprise"],"title":"Tier"}},"type":"object","required":["tier"],"title":"UpdateSubscriptionRequest","description":"Request to update user subscription."},"UpdateTeamRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":100,"minLength":3},{"type":"null"}],"title":"Name","description":"Team name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description","description":"Optional team description"},"is_public":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Public","description":"Whether team is public"}},"type":"object","title":"UpdateTeamRequest","description":"Request to update team settings."},"UpdateTeamResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"team":{"$ref":"#/components/schemas/TeamResponse"}},"type":"object","required":["success","team"],"title":"UpdateTeamResponse","description":"Response after updating a team."},"UsageHistoryItem":{"properties":{"id":{"type":"string","title":"Id"},"created_at":{"type":"string","title":"Created At"},"display_name":{"type":"string","title":"Display Name"},"akh_used":{"type":"number","title":"Akh Used"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["id","created_at","display_name","akh_used"],"title":"UsageHistoryItem","description":"Usage history item — AKh only, no token numbers exposed to users."},"UsageHistoryResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/UsageHistoryItem"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More"},"total_akh_last_30d":{"type":"number","title":"Total Akh Last 30D","default":0.0}},"type":"object","required":["items","total","has_more"],"title":"UsageHistoryResponse","description":"Paginated usage history."},"UsageStats":{"properties":{"total_tokens":{"type":"integer","title":"Total Tokens"},"total_credits_used":{"type":"number","title":"Total Credits Used"},"active_users":{"type":"integer","title":"Active Users"},"time_range":{"type":"string","title":"Time Range"}},"type":"object","required":["total_tokens","total_credits_used","active_users","time_range"],"title":"UsageStats","description":"Usage statistics."},"UserMessage":{"properties":{"id":{"type":"string","title":"Id"},"role":{"type":"string","const":"user","title":"Role","default":"user"},"content":{"anyOf":[{"type":"string"},{"items":{"oneOf":[{"$ref":"#/components/schemas/TextInputContent"},{"$ref":"#/components/schemas/ImageInputContent"},{"$ref":"#/components/schemas/AudioInputContent"},{"$ref":"#/components/schemas/VideoInputContent"},{"$ref":"#/components/schemas/DocumentInputContent"},{"$ref":"#/components/schemas/BinaryInputContent"}],"discriminator":{"propertyName":"type","mapping":{"audio":"#/components/schemas/AudioInputContent","binary":"#/components/schemas/BinaryInputContent","document":"#/components/schemas/DocumentInputContent","image":"#/components/schemas/ImageInputContent","text":"#/components/schemas/TextInputContent","video":"#/components/schemas/VideoInputContent"}}},"type":"array"}],"title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"encryptedValue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encryptedvalue"}},"additionalProperties":true,"type":"object","required":["id","content"],"title":"UserMessage","description":"A user message supporting text or multimodal content."},"UsernameValidationRequest":{"properties":{"username":{"type":"string","maxLength":30,"minLength":1,"title":"Username","description":"Username to validate; app rules allow 3-20 chars with internal '_' or '-' separators."}},"type":"object","required":["username"],"title":"UsernameValidationRequest","description":"Request body for username validation."},"UsernameValidationResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["valid"],"title":"UsernameValidationResponse","description":"Response for username 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"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VectorSyncRequest":{"properties":{"entity_type":{"type":"string","title":"Entity Type","description":"Ignored — projection owns ingest"},"entity_id":{"type":"string","title":"Entity Id","description":"Ignored — projection owns ingest"},"action":{"type":"string","title":"Action","description":"Ignored — projection owns ingest","default":"upsert"}},"type":"object","required":["entity_type","entity_id"],"title":"VectorSyncRequest","description":"Retained request shape for ops clients; no longer enqueues work."},"VerifyCheckoutRequest":{"properties":{"session_id":{"type":"string","minLength":3,"title":"Session Id","description":"Stripe checkout session ID"}},"type":"object","required":["session_id"],"title":"VerifyCheckoutRequest","description":"Request to verify a completed checkout session after redirect."},"VerifyCheckoutResponse":{"properties":{"mode":{"type":"string","title":"Mode","description":"Checkout mode: subscription or payment"},"credited":{"type":"boolean","title":"Credited","description":"Whether credits are granted for this session"},"balance":{"type":"integer","title":"Balance","description":"Combined millicredit balance after verification"}},"type":"object","required":["mode","credited","balance"],"title":"VerifyCheckoutResponse","description":"Result of verifying a completed checkout session."},"VideoInputContent":{"properties":{"type":{"type":"string","const":"video","title":"Type","default":"video"},"source":{"oneOf":[{"$ref":"#/components/schemas/InputContentDataSource"},{"$ref":"#/components/schemas/InputContentUrlSource"}],"title":"Source","discriminator":{"propertyName":"type","mapping":{"data":"#/components/schemas/InputContentDataSource","url":"#/components/schemas/InputContentUrlSource"}}},"metadata":{"anyOf":[{},{"type":"null"}],"title":"Metadata"}},"additionalProperties":true,"type":"object","required":["source"],"title":"VideoInputContent","description":"A video input content fragment."},"WeatherReport":{"properties":{"text":{"type":"string","title":"Text"},"built_at":{"type":"string","format":"date-time","title":"Built At"},"source":{"anyOf":[{"type":"string","enum":["meteoswiss","open_meteo"]},{"type":"null"}],"title":"Source"}},"type":"object","required":["text","built_at"],"title":"WeatherReport","description":"One Bauernregel line for Zeitung."},"WeatherReportResponse":{"properties":{"available":{"type":"boolean","title":"Available"},"needs_location":{"type":"boolean","title":"Needs Location","default":false},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"report":{"anyOf":[{"$ref":"#/components/schemas/WeatherReport"},{"type":"null"}]}},"type":"object","required":["available"],"title":"WeatherReportResponse","description":"GET /weather/report payload."},"WelcomeNotificationRequest":{"properties":{"user_id":{"type":"string","title":"User Id","description":"User ID"},"username":{"type":"string","title":"Username","description":"Username (without @)"},"email":{"type":"string","title":"Email","description":"User's email address"}},"type":"object","required":["user_id","username","email"],"title":"WelcomeNotificationRequest","description":"Request to send a welcome email."}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}