{"openapi":"3.1.0","info":{"title":"JubJub API","description":"JubJub Video Content Management API","version":"2.0.0"},"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/gpt-actions-schema":{"get":{"tags":["v2 - OpenAPI"],"summary":"Gpt Actions Schema","description":"Serve the GPT Actions OpenAPI schema (no auth required).\n\nReturns JSON by default (for ChatGPT \"Import from URL\").\nAdd ?format=yaml to get the raw YAML instead.","operationId":"gpt_actions_schema_v2_gpt_actions_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/profiles":{"post":{"tags":["Profile"],"summary":"Create Profile","operationId":"create_profile_profiles_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/profiles/current":{"get":{"tags":["Profile"],"summary":"Get Profile","operationId":"get_profile_profiles_current_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileAccountInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/complete-registration":{"post":{"tags":["Profile"],"summary":"Complete User Profile After Firebase Registration","description":"Completes user profile after Firebase registration and migrates temporary session data.\n\n **Flow**:\n 1. User registers via Firebase Auth (createUserWithEmailAndPassword)\n 2. Frontend calls this endpoint with Firebase token + additional data\n 3. System creates enriched profile in Firestore\n 4. Migrates temporary session data (if exists)\n 5. Records tracking events\n\n **Required Headers**:\n - Authorization: Bearer {firebase_jwt_token}\n\n **Data Collected**:\n - How they found the platform (try_now, google_search, referral, etc.)\n - Professional information (company, role)\n - Marketing consents\n - Referral code (if applicable)","operationId":"complete_registration_complete_registration_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","description":"Firebase JWT token (Bearer token)","title":"Authorization"},"description":"Firebase JWT token (Bearer token)"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileCompletionRequest"}}}},"responses":{"200":{"description":"Profile completed and session migrated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileCompletionResponse"},"example":{"success":true,"profile_id":"prof_550e8400-e29b-41d4-a716-446655440000","migration_result":{"containers_created":1,"projects_created":3,"media_migrated":2},"message":"Profile completed successfully! Your 3 projects have been saved."}}}},"401":{"description":"Invalid Firebase token"},"403":{"description":"Invalid temporary session"},"409":{"description":"Profile already exists for this user"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications":{"get":{"tags":["Notifications","notifications"],"summary":"List Notifications","description":"List notifications for the authenticated user.\n\n**Query Parameters:**\n- `type`: Filter by notification type (e.g., \"team_invite\", \"launch_success\")\n- `read`: Filter by read status (true/false)\n- `limit`: Maximum number of notifications to return (1-100, default 50)\n- `offset`: Number of notifications to skip for pagination (default 0)\n\n**Returns:**\n- List of notifications with pagination info\n- Total count of matching notifications\n- Unread count","operationId":"list_notifications_notifications_get","parameters":[{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by notification type","title":"Type"},"description":"Filter by notification type"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by taxonomy category (invites/teams/publishing/social/alerts/system)","title":"Category"},"description":"Filter by taxonomy category (invites/teams/publishing/social/alerts/system)"},{"name":"read","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by read status","title":"Read"},"description":"Filter by read status"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum notifications to return","default":50,"title":"Limit"},"description":"Maximum notifications to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of notifications to skip","default":0,"title":"Offset"},"description":"Number of notifications to skip"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/unread-count":{"get":{"tags":["Notifications","notifications"],"summary":"Get Unread Notifications Count","description":"Get the count of unread notifications for the authenticated user.\n\n**Returns:**\n- `unread_count`: Number of unread notifications","operationId":"get_unread_notifications_count_notifications_unread_count_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnreadCountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/team-unread-counts":{"get":{"tags":["Notifications","notifications"],"summary":"Get Team Unread Counts Endpoint","description":"Unread notification counts bucketed by team for the authenticated user.\n\n**Returns:**\n- `counts`: map of team_id -> unread count. Teams with no unread\n notifications are omitted (treat a missing key as 0).","operationId":"get_team_unread_counts_endpoint_notifications_team_unread_counts_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamUnreadCountsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/stats":{"get":{"tags":["Notifications","notifications"],"summary":"Get Notification Stats Endpoint","description":"Get notification counts for the surface's filter tabs.\n\n**Returns:**\n- `total`: total notifications\n- `unread`: unread count\n- `by_category`: per-category counts (invites, teams, publishing, social,\n alerts, system). Unfiltered, so the pills show global totals.","operationId":"get_notification_stats_endpoint_notifications_stats_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/{notification_id}/read":{"patch":{"tags":["Notifications","notifications"],"summary":"Mark Notification Read","description":"Mark a specific notification as read.\n\n**Path Parameters:**\n- `notification_id`: The notification ID\n\n**Returns:**\n- Success status with notification ID","operationId":"mark_notification_read_notifications__notification_id__read_patch","parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","title":"Notification Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationMarkReadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/mark-all-read":{"patch":{"tags":["Notifications","notifications"],"summary":"Mark All Notifications Read","description":"Mark all notifications as read for the authenticated user.\n\n**Returns:**\n- Number of notifications marked as read","operationId":"mark_all_notifications_read_notifications_mark_all_read_patch","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationMarkAllReadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/{notification_id}":{"delete":{"tags":["Notifications","notifications"],"summary":"Delete Notification Endpoint","description":"Delete a specific notification.\n\n**Path Parameters:**\n- `notification_id`: The notification ID\n\n**Returns:**\n- Success status","operationId":"delete_notification_endpoint_notifications__notification_id__delete","parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","title":"Notification Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ws/stats":{"get":{"tags":["WebSocket","websockets"],"summary":"Websocket Stats","description":"Get WebSocket connection statistics (for monitoring/debugging).\n\n**Returns:**\n- Total active connections\n- Number of connected users\n- List of connected user profile IDs","operationId":"websocket_stats_ws_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/agents":{"post":{"tags":["v2 - Agents"],"summary":"Create Agent","description":"Create a new agent key.\n\nReturns the raw secret once — caller must store it securely.\nPublish scopes are off by default and require a paid plan.\nThe splits permission may be set by the signed-in owner, never by an agent key.","operationId":"create_agent_v2_agents_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - Agents"],"summary":"List Agents","description":"List all agents owned by the current user.","operationId":"list_agents_v2_agents_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/agents/{agent_id}":{"patch":{"tags":["v2 - Agents"],"summary":"Update Agent","description":"Update an agent's scopes, name, or status.\n\nOnly the owner can update their agents, signed in as themselves: an agent\nkey is refused, and asking to turn the splits permission on says why.","operationId":"update_agent_v2_agents__agent_id__patch","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAgentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - Agents"],"summary":"Revoke Agent","description":"Revoke an agent (soft-delete), or permanently remove with ?permanent=true.","operationId":"revoke_agent_v2_agents__agent_id__delete","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"permanent","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Permanent"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces":{"post":{"tags":["v2 - Workspaces"],"summary":"Create Workspace","description":"Create a new workspace.\n\nThe authenticated user becomes the owner of the workspace.","operationId":"create_workspace_v2_workspaces_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWorkspaceRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - Workspaces"],"summary":"List Workspaces","description":"List workspaces with optional filtering.\n\n**Filters:**\n- role: \"owner\" (created by), \"member\" (invited to), or omit for all\n- folder_id: Filter by folder\n- include_progress: Include progress calculation (default: true)\n\n**Legacy filters:**\n- owner_id: Filter by owner (deprecated, use role=owner instead)\n\nReturns lightweight card data for efficient list rendering.\nStats (total_contents, etc.) are calculated dynamically from the database.\n\n**Examples:**\n- No params → All workspaces the authenticated user has access to\n- `?role=owner` → Workspaces created by the authenticated user\n- `?role=member` → Workspaces the authenticated user was invited to\n- `?include_progress=false` → Skip progress calculation for performance","operationId":"list_workspaces_v2_workspaces_get","parameters":[{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"}},{"name":"owner_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Id"}},{"name":"folder_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Folder Id"}},{"name":"include_progress","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Progress"}},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Archived"}},{"name":"include_archived","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Archived"}},{"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"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}":{"get":{"tags":["v2 - Workspaces"],"summary":"Get Workspace","description":"Get full details of a workspace.\n\nAccess: Owner, direct member, or team member with WORKSPACE_VIEW permission.\nStats are calculated dynamically from the database.","operationId":"get_workspace_v2_workspaces__workspace_id__get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["v2 - Workspaces"],"summary":"Update Workspace","description":"Update a workspace's details.\n\nOnly provided fields will be updated.\nAccess: Owner, direct member with edit rights, or team member with WORKSPACE_EDIT permission.","operationId":"update_workspace_v2_workspaces__workspace_id__patch","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWorkspaceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - Workspaces"],"summary":"Delete Workspace","description":"Delete a workspace.\n\nThis will also delete all contents and media within the workspace.\nAccess: Owner, direct member with admin rights, or team member with WORKSPACE_DELETE permission.","operationId":"delete_workspace_v2_workspaces__workspace_id__delete","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/my-permissions":{"get":{"tags":["v2 - Workspaces"],"summary":"Get My Workspace Permissions","description":"The caller's permissions in THIS workspace — the workspace twin of\nGET /v2/teams/{team_id}/my-permissions, and the one place that reports\n`publish:approve` (the release). The team route never lists it: the\nrelease is a workspace owner's grant, not a team right.\n\nAccess: anyone who can view the workspace.","operationId":"get_my_workspace_permissions_v2_workspaces__workspace_id__my_permissions_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceMyPermissionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/approvers":{"put":{"tags":["v2 - Workspaces"],"summary":"Set Workspace Approvers","description":"Replace who, besides the owner, may release a launch of this workspace's\ncontent (Permission.PUBLISH_APPROVE). A grant names a person already in\nthe workspace (direct or team member), or the linked team as a whole so\nthe operator's crew is trusted in one action.\n\nAccess: workspace owner only. No role, workspace or team, can grant\nthis; that is the point of it.","operationId":"set_workspace_approvers_v2_workspaces__workspace_id__approvers_put","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetApproversRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/transfer":{"post":{"tags":["v2 - Workspaces"],"summary":"Transfer Workspace","description":"Hand this workspace to another member. The new owner is the client from\nnow on: they hold the release and decide who else does. The old owner\nstays as a direct admin so nothing they were doing stops.\n\nAccess: workspace owner only. The new owner must already be a direct\nmember or a member of the linked team.","operationId":"transfer_workspace_v2_workspaces__workspace_id__transfer_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferWorkspaceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/team":{"put":{"tags":["v2 - Workspaces"],"summary":"Set Workspace Team","description":"Atomically set (or clear) a workspace's team in one request.\n\nReplaces the client-side unlink-then-link pattern, which could leave a\nworkspace orphaned from every team if the second call failed. Validates the\ntarget team up front, then unlinks from the old team and links to the new\none, saving the workspace once. team_id=None unlinks only.\n\nAccess: workspace owner only (matches the link endpoint).","operationId":"set_workspace_team_v2_workspaces__workspace_id__team_put","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetWorkspaceTeamRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/archive":{"post":{"tags":["v2 - Workspaces"],"summary":"Archive Workspace","description":"Archive a workspace: hide it from listings without deleting anything.\n\nReversible via POST /{workspace_id}/unarchive. The workspace remains\nfetchable by id — the archive view needs to read it — and nothing inside it\nis modified.\n\nAccess: same as DELETE (owner, admin member, or team member with\nWORKSPACE_DELETE).","operationId":"archive_workspace_v2_workspaces__workspace_id__archive_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/unarchive":{"post":{"tags":["v2 - Workspaces"],"summary":"Unarchive Workspace","description":"Restore an archived workspace to normal visibility.\n\nClears the archive fields entirely — see Workspace.unarchive() for why the\ntimestamp is not kept as history.\n\nAccess: same as DELETE.","operationId":"unarchive_workspace_v2_workspaces__workspace_id__unarchive_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/batch/delete":{"post":{"tags":["v2 - Workspaces"],"summary":"Delete Workspaces Batch","description":"Delete multiple workspaces at once.\n\nReturns which workspaces were deleted and which were not found.\nMaximum 100 workspaces per request.\nAccess: Must have WORKSPACE_DELETE permission for each workspace.","operationId":"delete_workspaces_batch_v2_workspaces_batch_delete_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchDeleteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/members/by-email":{"post":{"tags":["v2 - Workspaces"],"summary":"Add Member By Email","description":"Invite an email to this workspace. They join when they accept.\n\nAccess: MEMBERS_INVITE on the workspace. Rate-limited per principal\n(30/min, 200/day). The response is identical for every address.","operationId":"add_member_by_email_v2_workspaces__workspace_id__members_by_email_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddMemberByEmailRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/members/{member_profile_id}":{"patch":{"tags":["v2 - Workspaces"],"summary":"Update Member","description":"Update a workspace member's role or expiration.\n\nCannot update the owner.\nAccess: Owner, direct member with admin rights, or team member with MEMBERS_EDIT_ROLE permission.","operationId":"update_member_v2_workspaces__workspace_id__members__member_profile_id__patch","parameters":[{"name":"member_profile_id","in":"path","required":true,"schema":{"type":"string","title":"Member Profile Id"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMemberRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - Workspaces"],"summary":"Remove Member","description":"Remove a member from a workspace.\n\nCannot remove the owner.\nAccess: Owner, direct member with admin rights, or team member with MEMBERS_REMOVE permission.","operationId":"remove_member_v2_workspaces__workspace_id__members__member_profile_id__delete","parameters":[{"name":"member_profile_id","in":"path","required":true,"schema":{"type":"string","title":"Member Profile Id"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/members":{"get":{"tags":["v2 - Workspaces"],"summary":"List Members","description":"List all mentionable members of a workspace.\n\nReturns a deduplicated list of members from:\n1. The workspace owner\n2. Direct workspace members\n3. Team members (if workspace is linked to a team)\n\nUsed by the frontend for @mention autocomplete.\nAccess: Owner, direct member, or team member with WORKSPACE_VIEW permission.","operationId":"list_members_v2_workspaces__workspace_id__members_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WorkspaceMentionableMemberResponse"},"title":"Response List Members V2 Workspaces Workspace Id Members Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/activity":{"get":{"tags":["v2 - Workspaces"],"summary":"Get Workspace Activity","description":"Activity for a single workspace, drawn from its team's audit trail.\n\n⚠️ A SEPARATE ENDPOINT, NOT A `workspace_id` PARAMETER ON\n`GET /v2/teams/{team_id}/activity`. Three reasons, and the first is the one\nthat matters:\n\n 1. THE TEAM ENDPOINT 403s A NON-TEAM-MEMBER (team_routes.py, its\n `team.is_member` guard). A workspace OWNER need not be in the team —\n and is exactly who opens a workspace page. Reusing that route would\n 403 the owner on their own workspace. This route is guarded by\n `require_workspace_context(WORKSPACE_VIEW)`, which resolves all four\n access paths (owner / direct / team / dual) and lets the owner in.\n 2. The caller has a workspace id and may not know the team id — or there\n may not be a team at all.\n 3. The resource being described is the workspace.\n\n⚠️ FILTERED IN MEMORY, NOT IN THE QUERY. Deliberate, with a known ceiling:\n * `TeamAuditEvent.team_id` is required and every repository query filters\n on it; there is no query path by workspace, so a query-side filter\n needs a new composite index AND a field that most existing rows lack.\n * `list_by_team` ALREADY streams the whole team's events and paginates in\n memory (firestore_team_audit_repository.py `list_by_team`), so filtering\n here adds no new read pattern — it reuses the one that exists.\n * The 90-day TTL bounds how large a team's trail can get.\n * It also catches legacy rows that predate `workspace_id`, which a query\n on that field could not.\nThe trade is real: we fetch the team's events to keep a subset. If a team\never accumulates thousands of events in 90 days, this should become a\n`list_by_workspace` query with an index on (workspace_id, created_at).\n\nAccess: anyone who can view the workspace.","operationId":"get_workspace_activity_v2_workspaces__workspace_id__activity_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"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"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/health/storage":{"get":{"tags":["v2 - Workspaces","v2 - Workspaces","Health"],"summary":"Check Storage Health","description":"Check if workspace storage is properly configured.","operationId":"check_storage_health_v2_workspaces_health_storage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/workspaces/{workspace_id}/progress":{"get":{"tags":["v2 - Workspaces","v2 - Workspaces"],"summary":"Get Workspace Progress","description":"Get detailed progress information for a workspace.\n\nAccess: Owner, direct member, or team member with WORKSPACE_VIEW permission.\n\nReturns:\n- percentage: Overall progress (0-100)\n- total_contents: Number of contents in workspace\n- breakdown: Detailed breakdown by state (published, scheduled, ready, in_progress, pending)\n- summary: Simple 3-category summary (published, in_progress, pending)\n- contents: Per-content progress details\n\nProgress states and their weights:\n- EMPTY (0%): Content created but no media\n- DRAFT (20%): Has media but no platform config\n- INCOMPLETE (35%): Has config but missing required fields\n- READY (50%): Config complete, ready to publish\n- SCHEDULED (75%): Has a pending launch with scheduled_for\n- PUBLISHING (85%): Currently being published\n- PARTIAL_SUCCESS (90%): Some platforms published successfully\n- PUBLISHED (100%): All target platforms published\n- FAILED (40%): Last publish attempt failed","operationId":"get_workspace_progress_v2_workspaces__workspace_id__progress_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/ownership/opt-out":{"post":{"tags":["v2 - Workspaces"],"summary":"Ownership Opt Out","description":"Opt out of revenue splits for this workspace.\n\nAdds caller's profile_id to workspace.member_opt_outs.\nIdempotent: already opted out returns 200 OK.\nCaller must be a member of the workspace's team.","operationId":"ownership_opt_out_v2_workspaces__workspace_id__ownership_opt_out_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/ownership/opt-in":{"post":{"tags":["v2 - Workspaces"],"summary":"Ownership Opt In","description":"Opt back into revenue splits for this workspace.\n\nRemoves caller's profile_id from workspace.member_opt_outs.","operationId":"ownership_opt_in_v2_workspaces__workspace_id__ownership_opt_in_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspaces/{workspace_id}/invite-links":{"post":{"tags":["v2 - Workspace Shares"],"summary":"Create Invite Link","description":"Create an invite link for a workspace.\n\nAccess: Owner or admin (requires MEMBERS_INVITE permission).\nLink expires in 7 days.","operationId":"create_invite_link_v2_workspaces__workspace_id__invite_links_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInviteLinkRequest"}}}},"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"}}}}}}},"/v2/workspaces/{workspace_id}/invite-links/{token}":{"delete":{"tags":["v2 - Workspace Shares"],"summary":"Revoke Invite Link","description":"Revoke an invite link.\n\nAccess: Owner or admin (requires MEMBERS_INVITE permission).","operationId":"revoke_invite_link_v2_workspaces__workspace_id__invite_links__token__delete","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspace-shares/{token}":{"get":{"tags":["v2 - Workspace Shares (Public)"],"summary":"Get Workspace Share Preview","description":"Get a public preview of a workspace via invite link.\n\nNO authentication required.\nReturns workspace name, content titles/thumbnails, and member names.\nDoes NOT return private content URLs, download links, or sensitive data.","operationId":"get_workspace_share_preview_v2_workspace_shares__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/WorkspaceSharePreview"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspace-shares/{token}/join":{"post":{"tags":["v2 - Workspace Shares (Public)"],"summary":"Join Via Invite Link","description":"Join a workspace via invite link.\n\nRequires authentication.\nIf auto_accept=true: user is added immediately as viewer.\nIf auto_accept=false: user is added to pending_requests for owner approval.","operationId":"join_via_invite_link_v2_workspace_shares__token__join_post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/workspace-shares/{token}/approve/{profile_id}":{"post":{"tags":["v2 - Workspace Shares (Public)"],"summary":"Approve Join Request","description":"Approve a pending join request.\n\nAccess: Workspace owner or admin.","operationId":"approve_join_request_v2_workspace_shares__token__approve__profile_id__post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media/upload/request":{"post":{"tags":["v2 - Media"],"summary":"Request a signed URL for upload","description":"Start the upload process by requesting a signed URL.\n\n The frontend should:\n 1. Call this endpoint with filename and optional content_type\n 2. Use the returned signed_url to PUT the file directly to GCS\n 3. Call /v2/media/{media_id}/upload/complete when done\n\n The signed URL is valid for 10 minutes.","operationId":"request_upload_v2_media_upload_request_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaUploadRequestDTO"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaUploadResponseDTO"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media/{media_id}/upload/complete":{"post":{"tags":["v2 - Media"],"summary":"Confirm upload completion","description":"Call this after successfully uploading the file to GCS.\n\n This will:\n 1. Validate the Media exists and is in 'uploading' status\n 2. Make the file publicly accessible\n 3. Extract video metadata (width, height, fps, codec, etc.) for Smart Tags\n 4. Update Media status to 'ready'\n 5. Return the complete Media with public URL and video_metadata","operationId":"complete_upload_v2_media__media_id__upload_complete_post","parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","title":"Media Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaUploadCompleteDTO"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaResponseDTO"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media/ingest-url":{"post":{"tags":["v2 - Media"],"summary":"Ingest media from a public URL","description":"Download a file from a public URL and ingest it into JubJub.\n\n The backend downloads the file server-side and uploads it to GCS.\n Useful for GPT Actions and MCP clients that cannot send binary data.\n\n The URL must be publicly accessible, on http or https, and must not\n redirect. Private and internal addresses are refused. Max download\n timeout is 120 seconds; files over MEDIA_INGEST_MAX_BYTES (256 MB by\n default) are refused with 413.","operationId":"ingest_url_v2_media_ingest_url_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaIngestUrlRequestDTO"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaResponseDTO"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media/search":{"get":{"tags":["v2 - Media"],"summary":"Search media by extracted metadata","description":"Structured search over AI-extracted media metadata (media_search_index_v1).\n\ninclude_unanalysed (discoverable scope only): also return minted pieces\nindexed with no extracted metadata, registered imports. A viewer surface\ncan send people to the platform; an agent buying metadata cannot use them,\nso the default leaves them out.\nFree for human users — pure indexed filters, no inference.\n\nscope:\n - \"mine\" (default): your own catalogue, scoped to created_by.\n - \"discoverable\": cross-corpus, only content whose owner opted in.\n\ncursor: opaque bookmark from a previous discoverable response's\nnext_cursor — pass it back verbatim to continue. Ignored for scope=mine\n(owner corpora fit one page).\n\nReturns content cards (content_id, title, thumbnail_id, thumbnail_url,\nfacets) matching ALL supplied filters. Topic matches if it appears in the\ncontent's topics.","operationId":"search_media_metadata_v2_media_search_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"mine","title":"Scope"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"sub_domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sub Domain"}},{"name":"content_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"}},{"name":"pacing","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pacing"}},{"name":"movement_intensity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Movement Intensity"}},{"name":"thumbnail_dominant_colour","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Dominant Colour"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic"}},{"name":"face_present","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Face Present"}},{"name":"on_screen_text","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Screen Text"}},{"name":"music_present","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Music Present"}},{"name":"speech_present","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Speech Present"}},{"name":"thumbnail_face_visible","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Thumbnail Face Visible"}},{"name":"thumbnail_text_overlay","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Thumbnail Text Overlay"}},{"name":"thumbnail_action_shot","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Thumbnail Action Shot"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"include_unanalysed","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Unanalysed"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media/discoverability":{"patch":{"tags":["v2 - Media"],"summary":"Opt a content in/out of cross-corpus search","description":"Set whether a content you own is discoverable in the (free) cross-corpus\nmetadata search. Default is ON (opt-out — see\nbackfill_discoverable_default.py); this endpoint is how an owner opts a\npiece out, or back in. Owner only.","operationId":"set_media_discoverability_v2_media_discoverability_patch","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetDiscoverabilityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media/{media_id}":{"get":{"tags":["v2 - Media"],"summary":"Get media details","description":"Get details of a specific media file.\n\nAccess: Must have CONTENT_VIEW permission on the media's workspace.","operationId":"get_media_v2_media__media_id__get","parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","title":"Media Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaResponseDTO"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["v2 - Media"],"summary":"Rename a media file","description":"Rename a media file by updating its filename.\n\n This only updates the display name (filename) in the database.\n The actual file in GCS is not renamed (it uses media_id as identifier).","operationId":"rename_media_v2_media__media_id__patch","parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","title":"Media Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaRenameRequestDTO"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaResponseDTO"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - Media"],"summary":"Delete a media file","description":"Delete a media file and its record.\n\n This will also delete the file from GCS.","operationId":"delete_media_v2_media__media_id__delete","parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","title":"Media Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media":{"get":{"tags":["v2 - Media"],"summary":"List media in a workspace","description":"List all media in a workspace.\n\nSupports filtering by type and status.\n\nAccess: Must have CONTENT_VIEW permission on the workspace.","operationId":"list_media_v2_media_get","parameters":[{"name":"workspace_id","in":"query","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"media_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Type"}},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaListResponseDTO"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media/bulk/rename":{"patch":{"tags":["v2 - Media"],"summary":"Rename multiple media files","description":"Rename multiple media files in a single request.\n\n Each item in the request specifies a media_id and the new filename.\n The operation processes all items and returns individual results.\n Partial success is possible - some items may succeed while others fail.","operationId":"bulk_rename_media_v2_media_bulk_rename_patch","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaBulkRenameRequestDTO"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaBulkRenameResponseDTO"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media/{media_id}/reprocess-metadata":{"post":{"tags":["v2 - Media"],"summary":"Reprocess video metadata","description":"Re-extract video metadata (width, height, fps, codec, etc.) for an existing media.\n\n Useful for:\n - Videos uploaded before metadata extraction was implemented\n - Videos where metadata extraction failed during upload\n - Forcing a refresh of metadata\n\n This downloads the video from GCS, extracts metadata via FFprobe, and updates the record.","operationId":"reprocess_metadata_v2_media__media_id__reprocess_metadata_post","parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","title":"Media Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaResponseDTO"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/media/health/storage":{"get":{"tags":["v2 - Media","v2 - Media","Health"],"summary":"Check storage connection status","description":"Check if GCS storage and Firestore are properly configured and connected.","operationId":"check_storage_health_v2_media_health_storage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/media/health/signed-url":{"get":{"tags":["v2 - Media","v2 - Media","Health"],"summary":"Test signed URL generation","description":"Test that GCS can generate a valid signed URL.\n\nGenerates a test signed URL for a dummy path to verify\nthat credentials and bucket access are working correctly.","operationId":"check_signed_url_health_v2_media_health_signed_url_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/catalogue/manifest":{"get":{"tags":["v2 - Catalogue"],"summary":"Public summary of the JubJub media library","description":"Public, unauthenticated summary of the discoverable metadata library.\n\nAggregates media_search_index_v1 (discoverable == true) in Python — no new\nindexes. Cached in catalogue_manifest_v1/current with a 1-hour TTL.\nBest-effort: an empty index returns zeroes, never 404.","operationId":"catalogue_manifest_v2_catalogue_manifest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/contents":{"post":{"tags":["v2 - Contents"],"summary":"Create Content","description":"Create a new content.\n\nThe content will be in 'draft' status initially.\nAfter configuring platforms, it can be marked as 'ready' for publishing.\n\nAccess: Must have CONTENT_CREATE permission on the workspace.","operationId":"create_content_v2_contents_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateContentRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - Contents"],"summary":"List Contents","description":"List contents in a workspace.\n\n- workspace_id: Required - the workspace to list contents from\n- status: Optional filter by content status\n- folder_id: Optional filter by folder\n\nAccess: Must have CONTENT_VIEW permission on the workspace.","operationId":"list_contents_v2_contents_get","parameters":[{"name":"workspace_id","in":"query","required":true,"schema":{"type":"string","description":"Workspace ID (required)","title":"Workspace Id"},"description":"Workspace ID (required)"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status: draft, ready, published","title":"Status"},"description":"Filter by status: draft, ready, published"},{"name":"folder_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Folder Id"}},{"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"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/visible":{"get":{"tags":["v2 - Contents"],"summary":"List Visible Contents","description":"Everything this profile MAY SEE, across every workspace it can reach.\n\n🔑 THE VAULT ASKS THE WRONG QUESTION TODAY. It answers \"what did I put\nhere\" — the dashboard queries `onchain_publish_events` by\n`contributors_jubjub_profile_ids array-contains me`, so a teammate's piece\nin a workspace I fully share is invisible to me even though I can open it\nand play it through the workspace door. This endpoint answers \"what may I\nsee\" instead, which is the question a shared workspace implies.\n\n⚠️ THE ACCESS RULE IS NOT REIMPLEMENTED HERE. Every candidate workspace is\nput through `check_workspace_access` — the SAME function\n`require_workspace_context` and `verify_workspace_permission` use, and\ntherefore the same one that already governs playback. A second copy of an\naccess rule is how a leak happens: the copies drift, one of them forgets\na case, and the forgetful one is the one serving media. There is exactly\none rule and this calls it.\n\nCandidates are gathered widely and then FILTERED by that rule, never\ntrusted from the gathering step:\n * workspaces owned by, or directly listing, this profile\n (`list_by_profile` — which covers owner + direct member only)\n * workspaces linked to any team this profile belongs to, which\n `list_by_profile` does NOT return: that omission is precisely the gap\n being closed.\n\nMembership is checked per workspace even for team-linked candidates,\nbecause team membership is necessary but not sufficient — the permission\nstill has to hold.","operationId":"list_visible_contents_v2_contents_visible_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}":{"get":{"tags":["v2 - Contents"],"summary":"Get Content","description":"Get full details of a content.\n\nAccess: CONTENT_VIEW on the parent workspace, or the row's creator.\nThe creator branch is for workspace-less rows (channel imports, Farcaster\ncasts): `require_content_access` finds an orphan workspace and refused\nthe creator their own imported post (fixed 2026-10-07). Everyone else is\nchecked exactly as before.\nMetadata-commerce tiers: the owner sees full gated fields; everyone else\nsees free preview fields only (purchase to unlock).","operationId":"get_content_v2_contents__content_id__get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["v2 - Contents"],"summary":"Update Content","description":"Update a content's details.\n\nOnly provided fields will be updated.\n\nAccess: Must have CONTENT_EDIT permission on the parent workspace.","operationId":"update_content_v2_contents__content_id__patch","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateContentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - Contents"],"summary":"Delete Content","description":"Delete a content and all associated resources (cascade).\n\nDeletes: Content + PlatformConfigs + Media (GCS + DB) + cancels active Launches.\n\nIf the content has pending/scheduled launches:\n- Without `?force=true`: returns 409 Conflict\n- With `?force=true`: cancels all active launches (including Cloud Tasks) and proceeds\n\nAccess: the row's creator, or CONTENT_DELETE permission on the parent\nworkspace. The creator clause exists for workspace-less rows (imports,\nFarcaster casts), which have no parent workspace to hold a permission on.","operationId":"delete_content_v2_contents__content_id__delete","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"force","in":"query","required":false,"schema":{"type":"boolean","description":"Force delete even if there are scheduled launches","default":false,"title":"Force"},"description":"Force delete even if there are scheduled launches"},{"name":"confirm_asset_break","in":"query","required":false,"schema":{"type":"boolean","description":"Acknowledge that deleting a tokenised piece breaks the underlying asset an x402 buyer paid for. INDEPENDENT of `force`: that one cancels scheduled launches, this one accepts the asset break. Neither implies the other and both may be required.","default":false,"title":"Confirm Asset Break"},"description":"Acknowledge that deleting a tokenised piece breaks the underlying asset an x402 buyer paid for. INDEPENDENT of `force`: that one cancels scheduled launches, this one accepts the asset break. Neither implies the other and both may be required."},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/thumbnail":{"post":{"tags":["v2 - Contents"],"summary":"Set Content Thumbnail From Frame","description":"Set this piece's thumbnail to a frame at the given timestamp.\n\nA NEW media_v2 image is created every time and thumbnail_id is repointed\nat it. The previous image is left exactly where it is, still public, still\nat its URL. That is not tidiness — one of them is already embedded in a\npublished Farcaster cast, and cast previews resolve the image at render\ntime, so overwriting the object would change what a historical post shows.\nOrphaned images are the cheaper problem.\n\nNO `if not content.thumbnail_id` GUARD. That guard belongs to\ncreate_content, where a supplied thumbnail must not be overwritten. Here\nthe piece always has one already — that is what re-picking means — so the\nguard would make this endpoint a permanent no-op.\n\nON FAILURE THIS RETURNS AN ERROR, NOT A SILENT 200. create_content\nswallows extraction failures and continues, which is right at ingest: the\nupload should not fail because ffmpeg timed out. Here the thumbnail IS the\nrequest, so a 200 with the old image still attached would be\nindistinguishable from success — the same invisible failure that let a\nFarcaster cast publish under a camera filename with nothing to explain it.\n\nAccess: CONTENT_EDIT on the parent workspace.","operationId":"set_content_thumbnail_from_frame_v2_contents__content_id__thumbnail_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetThumbnailFromFrameRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetThumbnailFromFrameResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/register":{"post":{"tags":["v2 - Contents"],"summary":"Register imported content for on-chain revenue","description":"Promote an OAuth-imported (`source=\"historical_import\"`) content\nrow from `historical` to `minting`, kicking off the on-chain\nownership deployment state machine.\n\nGuards:\n - 404 if content not found.\n - 400 if not a historical import or already past historical state.\n - 403 if the original platform credential is no longer ACTIVE\n or no longer belongs to current_user.","operationId":"register_content_for_revenue_v2_contents__content_id__register_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Register Content For Revenue V2 Contents Content Id Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/playback-source":{"post":{"tags":["v2 - Contents"],"summary":"Name the host a piece plays from so JubJub meters it without serving it","description":"Write `source_video_url` (and optionally the price) on a piece the\ncaller created.\n\nFor an import this turns \"watched elsewhere\" into a sellable piece:\n`is_watched_elsewhere` (media_search_service) reads the field and the\nstreaming rail's refusal keys on it. For an upload it moves delivery off\nJubJub: the tier decision (playback_url_signer.is_gated_playback, leg 2)\nprefers a fetchable source over the GCS object, so the SDK leaves the\npage's own src alone and the bucket serves nothing. In both cases the\npublic playback route emits it as a Tier 1 source. It is a money gate,\nso the URL is validated with the same predicate the tier decision uses;\na watch page, a URL the page cannot play, or JubJub's own bucket is\nrefused, never stored.\n\nWas import-only until 2026-09-09. The reason given (\"a piece published\nthrough JubJub already has its file\") was backwards: JubJub having the\nfile is why JubJub pays to serve it.\n\nGuards:\n - 404 if content not found.\n - 400 if the URL is not a playable file on another host, or the price\n is above the settlement ceiling.\n - 403 if the caller is not the creator.","operationId":"set_playback_source_v2_contents__content_id__playback_source_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaybackSourceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Playback Source V2 Contents Content Id Playback Source Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/targets":{"post":{"tags":["v2 - Contents"],"summary":"Add Targets","description":"Add platform targets (destinations) to a content.\n\nThis creates PlatformConfig entries for each credential.\nThe user can then configure platform-specific settings for each target.\n\n- credential_ids: List of credential IDs to add as targets\n\nAccess: Must have CONTENT_EDIT permission on the parent workspace, AND\neach credential must be the caller's own or actively shared with the\nworkspace's team. A credential that exists and is neither is reported\nas `not_accessible` with nothing about it — until 2026-09-03 this route\nreturned any credential's account name and username for any id, and\npersisted the config so a launch published through its tokens.","operationId":"add_targets_v2_contents__content_id__targets_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddTargetsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddTargetsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - Contents"],"summary":"List Targets","description":"List all platform targets for a content.\n\nReturns the PlatformConfigs with credential info.\n\nAccess: Must have CONTENT_VIEW permission on the parent workspace.","operationId":"list_targets_v2_contents__content_id__targets_get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TargetInfo"},"title":"Response List Targets V2 Contents Content Id Targets Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/targets/{credential_id}":{"delete":{"tags":["v2 - Contents"],"summary":"Remove Target","description":"Remove a platform target from a content.\n\nThis deletes the PlatformConfig for the specified credential.\n\nAccess: Must have CONTENT_EDIT permission on the parent workspace.","operationId":"remove_target_v2_contents__content_id__targets__credential_id__delete","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/facebook-post-type":{"get":{"tags":["v2 - Contents"],"summary":"Preview Facebook Post Type","description":"The post type a Facebook publish of this piece will use, decided by the\nSAME rule the publish applies (facebook_adapter.explain_post_type), from\nthe piece's video. The publish screens show it beside \"Automatic\" so the\ncreator knows before sending whether it goes as a Reel or a video.","operationId":"preview_facebook_post_type_v2_contents__content_id__facebook_post_type_get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"post_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The selected setting: 'auto' (or omitted), 'reel' or 'video'","title":"Post Type"},"description":"The selected setting: 'auto' (or omitted), 'reel' or 'video'"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacebookPostTypePreview"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/full":{"get":{"tags":["v2 - Contents"],"summary":"Get Content With Configs","description":"Get content with all platform configurations.\n\nThis is useful for the publish/edit screen where you need\nboth content details and all platform configs.\n\n**Query params:**\n- `expand=media`: Include video and thumbnail details with video_metadata\n\nAccess: Must have CONTENT_VIEW permission on the parent workspace.","operationId":"get_content_with_configs_v2_contents__content_id__full_get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"expand","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated fields to expand. Options: media","title":"Expand"},"description":"Comma-separated fields to expand. Options: media"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentWithConfigsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/validate-configs":{"post":{"tags":["v2 - Contents"],"summary":"Validate Configs","description":"Validate all platform configurations for a content.\n\nChecks each config against platform-specific requirements.\nReturns validation results for each config.\n\nUse this before allowing user to proceed to publish step.\n\nAccess: Must have CONTENT_VIEW permission on the parent workspace.","operationId":"validate_configs_v2_contents__content_id__validate_configs_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ValidateConfigsRequest"},{"type":"null"}],"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateConfigsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/apply-general-settings":{"post":{"tags":["v2 - Contents"],"summary":"Apply General Settings","description":"Apply content's general settings to platform configurations.\n\nCopies specified fields from Content to PlatformConfig.settings.\nUseful for \"Apply to All\" button in the UI.\n\nField mapping:\n- title → title (YouTube, TikTok, Facebook, LinkedIn, Vimeo)\n- description → description, caption (Instagram)\n- tags → tags (YouTube, Vimeo)\n\nAccess: Must have CONTENT_EDIT permission on the parent workspace.","operationId":"apply_general_settings_v2_contents__content_id__apply_general_settings_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyGeneralSettingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyGeneralSettingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/playback":{"get":{"tags":["v2 - Contents","v2 - Contents","Streaming"],"summary":"Get Content Playback","description":"Resolve Mux playback metadata for a content item.\n\nPublic endpoint — no auth required. Used by /watch and /embed routes\non the dashboard to load the player before the viewer authenticates.\n\nReturns mux_playback_id, playback URL, price, and ownership info.\n\nTier-2 gating: for gated content the durable Mux URL and playback_id are\nwithheld (null) and `gated=true` is returned, so the client runs the paid\nstreaming-session flow instead of playing the durable URL. `gated` is\nDERIVED here (is_gated_playback), never read from the document.","operationId":"get_content_playback_v2_contents__content_id__playback_get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/health/storage":{"get":{"tags":["v2 - Contents","v2 - Contents","Health"],"summary":"Check Storage Health","description":"Check if content storage is properly configured.","operationId":"check_storage_health_v2_contents_health_storage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/contents/{content_id}/versions":{"get":{"tags":["v2 - Contents","Versions"],"summary":"List Versions","description":"Every version of the piece, newest first, each with a signed URL to\nplay it and its sign-offs. A piece never versioned lists one version.\n\nAccess: CONTENT_VIEW on the piece's workspace.","operationId":"list_versions_v2_contents__content_id__versions_get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["v2 - Contents","Versions"],"summary":"Add Version","description":"Make an uploaded video the new current version of this piece.\n\nUpload the file first (POST /v2/media/upload/request, PUT, then\nPOST /v2/media/{media_id}/upload/complete), then send its media_id here.\nEarlier versions stay listed and playable. Refused with 409\n(`reason: piece_is_final`) once the piece has been published. Any launch\nwaiting for, or holding, an owner approval is sent back for approval.\n\nAccess: CONTENT_EDIT on the piece's workspace (whoever can edit the piece).","operationId":"add_version_v2_contents__content_id__versions_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddVersionRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/versions/{number}/make-current":{"post":{"tags":["v2 - Contents","Versions"],"summary":"Make Version Current","description":"Make an earlier version the current one again. Its number is kept;\nnothing is renumbered. Refused with 409 once the piece has been published.\n\nAccess: CONTENT_EDIT on the piece's workspace.","operationId":"make_version_current_v2_contents__content_id__versions__number__make_current_post","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"integer","title":"Number"}},{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/contents/{content_id}/versions/{number}/signoffs":{"post":{"tags":["v2 - Contents","Versions"],"summary":"Sign Off Version","description":"Record that you signed off this version (who, which version, when,\nand in what capacity). A record, not a gate: it does not approve or block\na launch. Signing the same version again replaces your earlier sign-off.\nA new version starts with none. Allowed on a published piece: it changes\nno file.\n\nAccess: CONTENT_VIEW on the piece's workspace (anyone who can review it).","operationId":"sign_off_version_v2_contents__content_id__versions__number__signoffs_post","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"integer","title":"Number"}},{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignOffRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches":{"post":{"tags":["v2 - Launches"],"summary":"Create Launch","description":"Create a new multi-platform launch.\n\nThis endpoint allows publishing content to multiple platforms at once.\nIf `scheduled_for` is provided, the launch will be scheduled for that time.\nOtherwise, it will execute immediately.\n\n**Request body:**\n- `content_id`: ID of the content to publish\n- `platform_config_ids`: List of PlatformConfig IDs to publish to\n- `scheduled_for`: (optional) When to publish\n- `timezone`: (optional) Timezone for scheduled_for\n\nAccess: Must have PUBLISH_EXECUTE permission on the content's workspace.\nAgents: Require ``publish:execute`` scope.","operationId":"create_launch_v2_launches_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLaunchRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LaunchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - Launches"],"summary":"List Launches","description":"List launches with optional filters.\n\nFilter by workspace, content, or status.\n\nAccess: Must have CONTENT_VIEW permission on the workspace/content.","operationId":"list_launches_v2_launches_get","parameters":[{"name":"workspace_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by workspace","title":"Workspace Id"},"description":"Filter by workspace"},{"name":"content_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by content","title":"Content Id"},"description":"Filter by content"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status"},"description":"Filter by status"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LaunchListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches/validate":{"post":{"tags":["v2 - Launches"],"summary":"Validate Launch","description":"Validate a launch before execution.\n\nThis endpoint checks if all platforms can accept the content\nwithout actually publishing anything.\n\nAccess: Must have CONTENT_VIEW permission on the content's workspace.","operationId":"validate_launch_v2_launches_validate_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateLaunchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateLaunchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches/{launch_id}":{"get":{"tags":["v2 - Launches"],"summary":"Get Launch","description":"Get details of a specific launch including history.\n\nAccess: Must have CONTENT_VIEW permission on the launch's workspace.","operationId":"get_launch_v2_launches__launch_id__get","parameters":[{"name":"launch_id","in":"path","required":true,"schema":{"type":"string","title":"Launch Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LaunchDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches/{launch_id}/summary":{"get":{"tags":["v2 - Launches"],"summary":"Get Launch Summary","description":"Get a summary of launch results.\n\nUseful for displaying in UI after launch completes.\n\nAccess: Must have CONTENT_VIEW permission on the launch's workspace.","operationId":"get_launch_summary_v2_launches__launch_id__summary_get","parameters":[{"name":"launch_id","in":"path","required":true,"schema":{"type":"string","title":"Launch Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches/{launch_id}/cancel":{"post":{"tags":["v2 - Launches"],"summary":"Cancel Launch","description":"Cancel a pending or scheduled launch.\n\nOnly works for launches that haven't started yet.\n\nAccess: Must have PUBLISH_CANCEL permission on the launch's workspace.\nAgents: Require ``publish:schedule`` scope.","operationId":"cancel_launch_v2_launches__launch_id__cancel_post","parameters":[{"name":"launch_id","in":"path","required":true,"schema":{"type":"string","title":"Launch Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches/{launch_id}/platforms/{platform_config_id}":{"delete":{"tags":["v2 - Launches"],"summary":"Cancel Platform","description":"Cancel a single platform within a launch.\n\nOnly works for platforms that are still PENDING or IN_PROGRESS.\nIf all platforms become terminal after this, the launch status updates accordingly.\n\nAccess: Must have PUBLISH_CANCEL permission on the launch's workspace.\nAgents: Require ``publish:schedule`` scope.","operationId":"cancel_platform_v2_launches__launch_id__platforms__platform_config_id__delete","parameters":[{"name":"launch_id","in":"path","required":true,"schema":{"type":"string","title":"Launch Id"}},{"name":"platform_config_id","in":"path","required":true,"schema":{"type":"string","title":"Platform Config Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches/{launch_id}/retry":{"post":{"tags":["v2 - Launches"],"summary":"Retry Failed Platforms","description":"Retry publishing to failed platforms.\n\nOnly works for launches with status 'partial_failure'.\n\nAccess: Must have PUBLISH_EXECUTE permission on the launch's workspace.","operationId":"retry_failed_platforms_v2_launches__launch_id__retry_post","parameters":[{"name":"launch_id","in":"path","required":true,"schema":{"type":"string","title":"Launch Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/RetryLaunchRequest"},{"type":"null"}],"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LaunchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches/{launch_id}/reschedule":{"patch":{"tags":["v2 - Launches"],"summary":"Reschedule Launch","description":"Move a launch that has not started to a new time.\n\nWorks for pending, scheduled and awaiting_approval launches. The queued\nCloud Task(s) for the old time are cancelled first (until 2026-09-30 this\nroute only rewrote the field, so the old task still fired). A launch that\ncarried the workspace owner's approval is re-parked for a fresh one — the\ntime is part of what was approved; one waiting for approval keeps waiting\nwith the new time recorded. Anything else is re-queued for the new time.\n\nAccess: Must have PUBLISH_SCHEDULE permission on the launch's workspace.\nAgents: Require ``publish:schedule`` scope.","operationId":"reschedule_launch_v2_launches__launch_id__reschedule_patch","parameters":[{"name":"launch_id","in":"path","required":true,"schema":{"type":"string","title":"Launch Id"}},{"name":"scheduled_for","in":"query","required":true,"schema":{"type":"string","format":"date-time","title":"Scheduled For"}},{"name":"timezone","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LaunchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches/internal/execute/{launch_id}":{"post":{"tags":["v2 - Launches"],"summary":"Internal Execute Launch","description":"Execute a launch asynchronously. Called by Cloud Tasks, not by users.\n\nThis endpoint receives a callback from Google Cloud Tasks after\n``create_launch`` dispatches the work. It loads the launch from\nFirestore and runs the orchestrator, which may take several minutes\n(e.g. Instagram video processing).\n\n**Authentication:** verified Google OIDC only (``require_cron_oidc``,\nSEC-07) — the same guard as ``process_scheduled_launches`` below, and\nthe same one ``purchase_sweep_dispatcher`` targets.\n\nThis docstring previously claimed the Cloud Tasks header\n``X-CloudTasks-QueueName`` was checked \"to prevent direct invocation from\nexternal clients\". No such check existed anywhere in the function: the\nroute executed a launch — publishing to creators' connected social\naccounts — for anything that could reach the URL. A header would not have\nbeen worth much either, since any caller can send one; that is why SEC-07\nreplaced presence-of-header authorisation across the cron routes.\n\nWhen ``platform_config_id`` is provided, only that single platform\nexecutes (per-platform schedules, Phase 4 Option B). The parent\nlaunch finalises only once every platform has reached a terminal\nstate, so multiple per-platform tasks can fire independently.","operationId":"internal_execute_launch_v2_launches_internal_execute__launch_id__post","parameters":[{"name":"launch_id","in":"path","required":true,"schema":{"type":"string","title":"Launch Id"}},{"name":"platform_config_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"When set, run only this single platform within the launch (Phase 4 Option B per-platform schedules). When omitted, run all pending platforms.","title":"Platform Config Id"},"description":"When set, run only this single platform within the launch (Phase 4 Option B per-platform schedules). When omitted, run all pending platforms."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/launches/process-scheduled":{"post":{"tags":["v2 - Launches"],"summary":"Process Scheduled Launches","description":"Process all scheduled launches that are due for execution.\n\nThis endpoint is designed to be called by Cloud Scheduler periodically\n(e.g., every 5 minutes). It finds all launches with:\n- status IN ['pending', 'scheduled']\n- scheduled_for <= now\n\nAnd executes them via the LaunchOrchestrator.\n\n**Authentication:**\nThis endpoint should be protected by Cloud Scheduler's OIDC authentication\nat the infrastructure level, not by user authentication.\n\n**Returns:**\n- processed: number of launches executed\n- results: list of {launch_id, status, error?}","operationId":"process_scheduled_launches_v2_launches_process_scheduled_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/launches/recover-stuck":{"post":{"tags":["v2 - Launches"],"summary":"Recover Stuck Launches","description":"Reset launches stuck in in_progress for more than 10 minutes, and\nimmediate launches that never started (pending, no scheduled_for) for more\nthan NEVER_STARTED_AFTER_MINUTES.\n\nDesigned to be called alongside process-scheduled by Cloud Scheduler.\nCatches launches that were abandoned due to Cloud Run timeout or\nunhandled exceptions in the orchestrator.","operationId":"recover_stuck_launches_v2_launches_recover_stuck_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/launches/health/storage":{"get":{"tags":["v2 - Launches"],"summary":"Check Storage Health","description":"Check if launch storage is working correctly.","operationId":"check_storage_health_v2_launches_health_storage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/handover/{content_id}":{"get":{"tags":["V2 Handover"],"summary":"Get Handover Options","description":"Where this piece can be handed over, for anyone who may publish it.\n\n`handover_url` is the mobile page the desktop QR code points at. It holds\nthe content id only; the page requires a signed-in publisher. `tiktok`\nlists the accounts publishing would use for this piece.","operationId":"get_handover_options_v2_handover__content_id__get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/handover/{content_id}/video":{"get":{"tags":["V2 Handover"],"summary":"Get Handover Video Url","description":"A short-lived signed GET URL for the piece's video file. Only for\nsomeone who may publish the piece; never cached, never stored: each call\nsigns a fresh one that dies after HANDOVER_URL_TTL_MINUTES.","operationId":"get_handover_video_url_v2_handover__content_id__video_get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/handover/{content_id}/instagram":{"post":{"tags":["V2 Handover"],"summary":"Record Instagram Handover","description":"Record that the caller's share sheet handed the video to Instagram.\n\nThe dashboard calls this only after `navigator.share()` resolved. A\ncancelled share (AbortError) never calls it, so nothing is recorded.","operationId":"record_instagram_handover_v2_handover__content_id__instagram_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/handover/{content_id}/tiktok":{"post":{"tags":["V2 Handover"],"summary":"Send To Tiktok Drafts","description":"Send the video to a TikTok drafts inbox (video.upload), in the background.\n\nEverything that can be refused is refused here, before anything starts:\nwho may hand over, which account, the account's drafts access, a token\nthat refreshes, a video file. Then an upload row is written `queued` and\nplatform-upload-job sends it (tiktok_draft_upload.run_upload): the file is\nread from GCS one chunk at a time and PUT to TikTok, and no link to it is\nhanded to anyone. Answers 202 `sending` with an `upload_id` to follow at\nGET /v2/handover/tiktok-uploads/{upload_id}. 409\n`tiktok_reconnect_for_drafts` when the token lacks video.upload; TikTok\npublishing is unaffected by that.","operationId":"send_to_tiktok_drafts_v2_handover__content_id__tiktok_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokHandoverRequest","default":{}}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/handover/tiktok-uploads/{upload_id}":{"get":{"tags":["V2 Handover"],"summary":"Get Tiktok Upload Status","description":"Follow a TikTok drafts upload: `sending`, `processing`, `handed_over`\nor `failed`. Records the handover the first time TikTok reports\nSEND_TO_USER_INBOX. Anyone who may publish the piece may ask.","operationId":"get_tiktok_upload_status_v2_handover_tiktok_uploads__upload_id__get","parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{platform}/auth-url":{"get":{"tags":["Credentials v2"],"summary":"Initiate Oauth","description":"Initiate OAuth flow for a platform.\n\nReturns an auth URL to redirect the user for authorization.\n\nOptional query params for post-callback navigation:\n return_context_flow: Flow identifier (e.g. \"try_now_onboarding\")\n return_context_workspace_id: Workspace ID for try-now flows","operationId":"initiate_oauth_v2_credentials__platform__auth_url_get","parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","title":"Platform"}},{"name":"return_context_flow","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Context Flow"}},{"name":"return_context_workspace_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Context Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthInitiateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{platform}/callback":{"post":{"tags":["Credentials v2"],"summary":"Oauth Callback","description":"Handle OAuth callback and store credentials.\n\nThis endpoint is called by the frontend after the user authorizes.","operationId":"oauth_callback_v2_credentials__platform__callback_post","parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","title":"Platform"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthCallbackRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthCallbackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{platform}/connect-token":{"post":{"tags":["Credentials v2"],"summary":"Connect Token","description":"Connect a token-based platform (Mux, Vimeo OTT).\n\nFor Mux: token_id = Mux Token ID, token_secret = Mux Token Secret\nFor Vimeo OTT: token_id = API key, token_secret = API secret\n\nprofile_id comes from auth cookie only — never from request body.","operationId":"connect_token_v2_credentials__platform__connect_token_post","parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","title":"Platform"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenConnectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthCallbackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials":{"get":{"tags":["Credentials v2"],"summary":"List Credentials","description":"List all credentials for the authenticated user.\n\nPass check_tokens=true to include live token_valid checks (adds latency).","operationId":"list_credentials_v2_credentials_get","parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by platform","title":"Platform"},"description":"Filter by platform"},{"name":"include_inactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include inactive credentials","default":false,"title":"Include Inactive"},"description":"Include inactive credentials"},{"name":"check_tokens","in":"query","required":false,"schema":{"type":"boolean","description":"Validate tokens against platform APIs","default":false,"title":"Check Tokens"},"description":"Validate tokens against platform APIs"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/by-platform":{"get":{"tags":["Credentials v2"],"summary":"List Credentials By Platform","description":"List all credentials grouped by platform.\n\nUseful for the frontend to display credentials organized by platform.\nPass check_tokens=true to include live token_valid checks (adds latency).","operationId":"list_credentials_by_platform_v2_credentials_by_platform_get","parameters":[{"name":"include_inactive","in":"query","required":false,"schema":{"type":"boolean","description":"Include inactive credentials","default":false,"title":"Include Inactive"},"description":"Include inactive credentials"},{"name":"check_tokens","in":"query","required":false,"schema":{"type":"boolean","description":"Validate tokens against platform APIs","default":false,"title":"Check Tokens"},"description":"Validate tokens against platform APIs"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialsByPlatformResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{credential_id}":{"get":{"tags":["Credentials v2"],"summary":"Get Credential","description":"Get details of a specific credential.","operationId":"get_credential_v2_credentials__credential_id__get","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Credentials v2"],"summary":"Update Credential","description":"Update a credential (currently only nickname can be updated).","operationId":"update_credential_v2_credentials__credential_id__patch","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCredentialRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Credentials v2"],"summary":"Delete Credential","description":"Delete a credential.\n\nBy default, performs a soft delete (marks as inactive).\nUse hard_delete=true to permanently remove.","operationId":"delete_credential_v2_credentials__credential_id__delete","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"hard_delete","in":"query","required":false,"schema":{"type":"boolean","description":"Permanently delete (default: soft delete)","default":false,"title":"Hard Delete"},"description":"Permanently delete (default: soft delete)"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteCredentialResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{credential_id}/tokenise-destination":{"patch":{"tags":["Credentials v2"],"summary":"Set Tokenise Destination","description":"Set where a connected channel's imported history tokenises.\n\nImported channel history has no workspace — nothing is downloaded, so there\nis no container — and registration refuses until a destination exists\n(content_routes.register_content_for_revenue, 409\n`tokenise_destination_unset`). This is the only thing that clears that\nrefusal, and the last gate before a permanent on-chain allocation, so every\nfact is checked HERE rather than assumed from the client having rendered a\nfiltered list of teams.\n\nChanging a destination applies FORWARD ONLY. Content already registered\ncarries its own copy of the destination it was minted under\n(`contents_v2.tokenise_destination_mode` / `tokenise_team_id`), and\n`resolve_registration_destination` reads that copy in preference to the\ncredential. Nothing here touches contents_v2 — that copy is the record, and\nthe split derived from it is already on-chain.","operationId":"set_tokenise_destination_v2_credentials__credential_id__tokenise_destination_patch","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetTokeniseDestinationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{credential_id}/revalidate":{"post":{"tags":["Credentials v2"],"summary":"Revalidate Credential Endpoint","description":"Ask the platform whether the STORED credential still works, whatever\n`status` says, and act on the answer. This is what the Reconnect button\ncalls.\n\nTHREE OUTCOMES:\n alive the platform accepted the stored credential. Status is\n `active` again, the auth notification is cleared. No form.\n dead the platform answered 401. Status is `needs_reauth`;\n `needs_input` says what the creator must now supply (for\n Mux only the secret — the Token ID is `account_id`).\n undetermined the platform could not be asked (timeout, 5xx, 429, no\n probe). NOTHING changed except the evidence stamp; the\n caller may simply try again.\n\nWhy this exists: the health endpoint below refused non-active rows, the\nlist endpoint's `token_valid` returned False before decrypting, and the\nsweep skipped flagged rows — so a `needs_reauth` written by a refresher\nthat never contacted the platform could never be disproved. Loading the\ncredential regardless of status is the whole point.","operationId":"revalidate_credential_endpoint_v2_credentials__credential_id__revalidate_post","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevalidateCredentialResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{credential_id}/health":{"get":{"tags":["Credentials v2"],"summary":"Check Credential Health","description":"Check if a credential's access token is still valid by making\na lightweight API call to the platform. Refreshes first where the\nplatform has a refresher and the stored token is stale.\n\nSame check as POST /{id}/revalidate, kept for the callers of this shape.\nIt no longer marks a credential dead because a platform had no probe,\nand no longer refuses a credential that is already flagged.\n\nReturns:\n status: \"healthy\" | \"refreshed\" | \"needs_reauth\" | \"unknown\"\n platform, account_name, detail\n\n\"unknown\" is the third outcome: the platform could not be asked and\nnothing was changed.","operationId":"check_credential_health_v2_credentials__credential_id__health_get","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{credential_id}/facebook-pages":{"get":{"tags":["Credentials v2"],"summary":"List Facebook Pages","description":"List Facebook Pages the user manages for a given credential.\n\nReturns page_id, name, and category for each Page.\nThe page_id is needed when creating a PlatformConfig for Facebook.\n\nSupports shared credentials: if the caller is not the owner, they can\npass ?team_id=xxx to check access via SharedCredential.","operationId":"list_facebook_pages_v2_credentials__credential_id__facebook_pages_get","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Team ID to check shared credential access","title":"Team Id"},"description":"Team ID to check shared credential access"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacebookPagesListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{credential_id}/facebook-page":{"patch":{"tags":["Credentials v2"],"summary":"Set Facebook Page","description":"Choose the Page this Facebook connection publishes to.\n\nThe Graph API publishes to a Page, never to the account, and an account\nmay manage several. Until this route existed the callback kept whichever\nPage Meta listed first and nothing could change it. The choice is checked\nagainst Meta live: `page_id` must be a Page the account manages NOW, not\none the client remembered.\n\nOWNER ONLY. A team member publishing through a shared credential can read\nthe list (GET facebook-pages, with ?team_id) but not move the owner's\nconnection to another Page.\n\nApplies forward to every config created from now on\n(platform_config_routes._seed_connection_settings), and fills the Page\ninto this credential's existing Facebook configs that carry none, which\nis what an INCOMPLETE Facebook destination needed to become READY.\nConfigs that already name a Page are left alone: that was a choice.","operationId":"set_facebook_page_v2_credentials__credential_id__facebook_page_patch","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetFacebookPageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/{credential_id}/location-search":{"get":{"tags":["Credentials v2"],"summary":"Search Locations","description":"Search for locations via Meta Pages Search API.\n\nReturns locations that can be used as `location_id` in Instagram PlatformConfig.\nWorks with both Facebook and Instagram credentials (both use Meta Graph API).\n\nThe frontend should call this with a debounced search input and display\nresults in an autocomplete dropdown.","operationId":"search_locations_v2_credentials__credential_id__location_search_get","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"Search query (e.g. 'New York')","title":"Q"},"description":"Search query (e.g. 'New York')"},{"name":"team_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Team ID to check shared credential access","title":"Team Id"},"description":"Team ID to check shared credential access"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/credentials/cron/health-sweep":{"post":{"tags":["Credentials v2"],"summary":"Cron Credential Health Sweep","description":"Probe every active credential and mark the ones the platform says are dead.\n\nSame auth as every other scheduled job in this service: Cloud Scheduler\nOIDC, verified by require_cron_oidc against CRON_OIDC_AUDIENCE and the\nCRON_SERVICE_ACCOUNTS allowlist (cron_auth.py:145-156). Nothing else can\ncall it.\n\nNIGHTLY, not hourly. These tokens die on a scale of months — the oldest\ndead one here expired in April — so an hourly sweep is 26 API calls an hour\nto learn nothing, against third-party rate limits, to shorten a detection\nwindow nobody is watching by 23 hours. Nightly also means a marked\ncredential is excluded from the NEXT import cron run rather than the\ncurrent one.\n\n`dry_run=true` classifies and reports without writing, so the first sweep\ncan be read before it marks anything.\n\nMarks ONLY on a definite platform answer. A timeout, a 429 or a 5xx is\nrecorded as undetermined and changes nothing — see\ncredential_health_policy for why that distinction is the point of this job.","operationId":"cron_credential_health_sweep_v2_credentials_cron_health_sweep_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/platform-configs":{"post":{"tags":["v2 - PlatformConfig"],"summary":"Create Platform Config","description":"Create a new platform configuration for a content.\n\nEach config represents how to publish to a specific platform/account.\nA content can have multiple configs for the same platform with different credentials.\n\nAccess: Must have CONTENT_EDIT permission on the content's workspace.","operationId":"create_platform_config_v2_platform_configs_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePlatformConfigRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - PlatformConfig"],"summary":"List Platform Configs","description":"List all platform configurations for a content.\n\nOptionally filter by platform type.\nPass check_tokens=true to include live token_valid checks (adds latency).\nWhen a token is invalid, a notification is written to the user's feed.\n\nAccess: Must have CONTENT_VIEW permission on the content's workspace.","operationId":"list_platform_configs_v2_platform_configs_get","parameters":[{"name":"content_id","in":"query","required":true,"schema":{"type":"string","description":"Content ID to list configs for","title":"Content Id"},"description":"Content ID to list configs for"},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by platform type","title":"Platform"},"description":"Filter by platform type"},{"name":"check_tokens","in":"query","required":false,"schema":{"type":"boolean","description":"Validate tokens against platform APIs","default":false,"title":"Check Tokens"},"description":"Validate tokens against platform APIs"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformConfigListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/platform-configs/bulk":{"post":{"tags":["v2 - PlatformConfig"],"summary":"Bulk Create Platform Configs","description":"Create multiple platform configurations for a content at once.\n\nUseful when the user selects multiple platforms/accounts in a single step.\nEach item is processed independently — partial success is possible.\n\nAccess: Must have CONTENT_EDIT permission on the content's workspace.","operationId":"bulk_create_platform_configs_v2_platform_configs_bulk_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCreatePlatformConfigsRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCreatePlatformConfigsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["v2 - PlatformConfig"],"summary":"Bulk Update Platform Configs","description":"Update multiple platform configurations at once.\n\nUseful when the user configures settings for multiple platforms\nand clicks \"Save All\". Each config in the request will be updated\nindependently - failures on one config won't affect others.\n\nAccess: Must have CONTENT_EDIT permission on each config's content's workspace.","operationId":"bulk_update_platform_configs_v2_platform_configs_bulk_put","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdatePlatformConfigsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdatePlatformConfigsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/platform-configs/schemas":{"get":{"tags":["v2 - PlatformConfig"],"summary":"Get All Platform Schemas","description":"Get the settings schema for all platforms.\n\nReturns JSON schemas and field definitions for each platform,\nwhich the frontend can use to dynamically generate forms.","operationId":"get_all_platform_schemas_v2_platform_configs_schemas_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllPlatformSchemasResponse"}}}}}}},"/v2/platform-configs/schemas/{platform}":{"get":{"tags":["v2 - PlatformConfig"],"summary":"Get Platform Schema","description":"Get the settings schema for a specific platform.\n\nReturns JSON schema and field definitions for the platform,\nwhich the frontend can use to dynamically generate the settings form.","operationId":"get_platform_schema_v2_platform_configs_schemas__platform__get","parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","title":"Platform"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformSettingsSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/platform-configs/schemas/{platform}/requirements":{"get":{"tags":["v2 - PlatformConfig"],"summary":"Get Platform Requirements","description":"Get validation requirements for a specific platform.\n\nReturns:\n- required_fields: Fields that must be filled\n- limits: Character/count limits for fields\n- inherits_from_content: Fields that can use Content values as fallback\n- notes: Platform-specific tips\n\nUsed by frontend for:\n- Real-time validation as user types\n- Showing required field indicators\n- Character counters","operationId":"get_platform_requirements_v2_platform_configs_schemas__platform__requirements_get","parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","title":"Platform"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformRequirementsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/platform-configs/{config_id}":{"get":{"tags":["v2 - PlatformConfig"],"summary":"Get Platform Config","description":"Get full details of a platform configuration.\n\nAccess: Must have CONTENT_VIEW permission on the content's workspace.","operationId":"get_platform_config_v2_platform_configs__config_id__get","parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"string","title":"Config Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["v2 - PlatformConfig"],"summary":"Update Platform Config","description":"Update a platform configuration.\n\nOnly provided fields will be updated.\n\nAccess: Must have CONTENT_EDIT permission on the content's workspace.","operationId":"update_platform_config_v2_platform_configs__config_id__patch","parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"string","title":"Config Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePlatformConfigRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - PlatformConfig"],"summary":"Delete Platform Config","description":"Delete a platform configuration.\n\nAccess: Must have CONTENT_EDIT permission on the content's workspace.","operationId":"delete_platform_config_v2_platform_configs__config_id__delete","parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"string","title":"Config Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/platform-configs/{config_id}/ready":{"post":{"tags":["v2 - PlatformConfig"],"summary":"Mark Config Ready","description":"Mark a platform configuration as ready for publishing.\n\nValidates that required settings are present for the platform.\n\nAccess: Must have CONTENT_EDIT permission on the content's workspace.","operationId":"mark_config_ready_v2_platform_configs__config_id__ready_post","parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"string","title":"Config Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/platform-configs/health/storage":{"get":{"tags":["v2 - PlatformConfig","v2 - PlatformConfig","Health"],"summary":"Check Storage Health","description":"Check if platform config storage is properly configured.","operationId":"check_storage_health_v2_platform_configs_health_storage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/platform-defaults/{credential_id}":{"get":{"tags":["v2 - PlatformDefaults"],"summary":"Get Platform Default","description":"Get saved default settings for a credential.\n\nReturns empty settings object if no defaults have been saved yet.","operationId":"get_platform_default_v2_platform_defaults__credential_id__get","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformDefaultResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["v2 - PlatformDefaults"],"summary":"Save Platform Default","description":"Save (create or update) default settings for a credential.\n\nOnly the credential owner can save defaults.\nThe settings dict is partial — include only the fields you want as defaults.","operationId":"save_platform_default_v2_platform_defaults__credential_id__put","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavePlatformDefaultRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformDefaultResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - PlatformDefaults"],"summary":"Delete Platform Default","description":"Remove saved defaults for a credential.\n\nOnly the credential owner can delete defaults.","operationId":"delete_platform_default_v2_platform_defaults__credential_id__delete","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams":{"post":{"tags":["v2 - Teams"],"summary":"Create Team","description":"Create a new team.\n\nThe authenticated user becomes the owner of the team.","operationId":"create_team_v2_teams_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTeamRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - Teams"],"summary":"List Teams","description":"List all teams the user is a member of.\n\nReturns lightweight card data for efficient list rendering.\n\n**Query params:**\n- `include=workspaces` - Include workspaces inline (avoids N+1 requests)","operationId":"list_teams_v2_teams_get","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"}},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Include related data. Use 'workspaces' to include workspaces inline.","title":"Include"},"description":"Include related data. Use 'workspaces' to include workspaces inline."},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/TeamListResponse"},{"$ref":"#/components/schemas/TeamListWithWorkspacesResponse"}],"title":"Response List Teams V2 Teams Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/search":{"get":{"tags":["v2 - Teams"],"summary":"Search Teams","description":"Search teams by name.\n\nOnly searches teams the user is a member of.\nReturns matching teams with highlights.","operationId":"search_teams_v2_teams_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}":{"get":{"tags":["v2 - Teams"],"summary":"Get Team","description":"Get full details of a team.\n\nUser must be a member of the team.","operationId":"get_team_v2_teams__team_id__get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["v2 - Teams"],"summary":"Update Team","description":"Update a team's details.\n\nRequires TEAM_EDIT permission. The split fields also need FINANCIALS_EDIT,\nand from an agent key they pass agent_split_guard (give, never take, unless\nthe key carries the splits permission).","operationId":"update_team_v2_teams__team_id__patch","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTeamRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - Teams"],"summary":"Delete Team","description":"Delete a team.\n\nOnly the owner can delete a team.\nThis does NOT delete associated workspaces.","operationId":"delete_team_v2_teams__team_id__delete","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/stats":{"get":{"tags":["v2 - Teams"],"summary":"Get Team Stats","description":"Get aggregated statistics for a team.\n\nCalculates total_contents, total_launches, etc. by summing from all team workspaces.\nThis provides real-time stats without requiring denormalized counters.\n\nUser must be a member of the team.","operationId":"get_team_stats_v2_teams__team_id__stats_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamAggregatedStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/transfer":{"post":{"tags":["v2 - Teams"],"summary":"Transfer Ownership","description":"Transfer team ownership to another admin.\n\nOnly the current owner can transfer ownership.\nThe new owner must be an Admin of the team.","operationId":"transfer_ownership_v2_teams__team_id__transfer_post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferOwnershipRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/members":{"get":{"tags":["v2 - Teams"],"summary":"List Members","description":"List all members of a team.\n\nUser must be a member of the team.","operationId":"list_members_v2_teams__team_id__members_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/members/{member_profile_id}":{"patch":{"tags":["v2 - Teams"],"summary":"Update Member Role","description":"Update a member's role.\n\nRequires MEMBERS_MANAGE permission.\nCannot change the owner's role (use transfer ownership instead).","operationId":"update_member_role_v2_teams__team_id__members__member_profile_id__patch","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"member_profile_id","in":"path","required":true,"schema":{"type":"string","title":"Member Profile Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMemberRoleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - Teams"],"summary":"Remove Member","description":"Remove a member from the team.\n\nRequires MEMBERS_MANAGE permission.\nCannot remove the owner (use delete team instead).","operationId":"remove_member_v2_teams__team_id__members__member_profile_id__delete","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"member_profile_id","in":"path","required":true,"schema":{"type":"string","title":"Member Profile Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/leave":{"post":{"tags":["v2 - Teams"],"summary":"Leave Team","description":"Leave a team.\n\nThe owner cannot leave (must transfer ownership first).","operationId":"leave_team_v2_teams__team_id__leave_post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/my-permissions":{"get":{"tags":["v2 - Teams"],"summary":"Get My Permissions","description":"Get the current user's permissions in a team.\n\nUseful for UI to determine what actions to show.","operationId":"get_my_permissions_v2_teams__team_id__my_permissions_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/workspaces":{"get":{"tags":["v2 - Teams"],"summary":"List Team Workspaces","description":"List all workspaces linked to this team.\n\nUser must be a member of the team.\n\nResponse includes progress information for each workspace:\n- progress: Overall percentage (0-100)\n- progress_summary: Breakdown by category (published, in_progress, pending)","operationId":"list_team_workspaces_v2_teams__team_id__workspaces_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"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"}},{"name":"include_progress","in":"query","required":false,"schema":{"type":"boolean","description":"Include progress calculation","default":true,"title":"Include Progress"},"description":"Include progress calculation"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/workspaces/{workspace_id}":{"post":{"tags":["v2 - Teams"],"summary":"Link Workspace To Team","description":"Link a workspace to a team.\n\nRequirements:\n- User must have WORKSPACE_CREATE permission in the team\n- User must be the workspace owner\n\nNote: Linking a workspace to a team gives all team members access.","operationId":"link_workspace_to_team_v2_teams__team_id__workspaces__workspace_id__post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v2 - Teams"],"summary":"Unlink Workspace From Team","description":"Unlink a workspace from a team.\n\nRequirements:\n- User must have WORKSPACE_CREATE permission in the team OR be workspace owner\n\nNote: Unlinking removes team access but doesn't delete the workspace.","operationId":"unlink_workspace_from_team_v2_teams__team_id__workspaces__workspace_id__delete","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/activity":{"get":{"tags":["v2 - Teams"],"summary":"Get Team Activity","description":"Get the team activity timeline.\n\nReturns audit events ordered by most recent first.\nCan filter by action type (e.g., member_joined, credential_shared).\n\nUser must be a member of the team.","operationId":"get_team_activity_v2_teams__team_id__activity_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"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"}},{"name":"action","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/invites":{"post":{"tags":["v2 - Team Invites"],"summary":"Create Invite","description":"Create an invitation to join the team.\n\nRequires MEMBERS_INVITE permission.\nCannot invite someone who is already a member.\nA repeat invite to the same address replaces the pending one (no 409).","operationId":"create_invite_v2_teams__team_id__invites_post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInviteRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - Team Invites"],"summary":"List Team Invites","description":"List all invites for a team.\n\nRequires MEMBERS_VIEW permission.\nCan filter by status: pending, accepted, rejected, expired, cancelled.\n\nThe filter is accepted under two names. The dashboard sends\n`status_filter`; the MCP tool `teams_invites_list` sends `status`, and\nuntil 2026-10-09 FastAPI silently dropped that unknown query key, so an\nagent asking for `pending` got every invite the team ever sent. An\nunknown value matches nothing, as it always did.","operationId":"list_team_invites_v2_teams__team_id__invites_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: pending, accepted, rejected, expired, cancelled.","title":"Status Filter"},"description":"Filter: pending, accepted, rejected, expired, cancelled."},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Same filter under the name the MCP tool and its schema use.","title":"Status"},"description":"Same filter under the name the MCP tool and its schema use."},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/invites/{invite_id}":{"delete":{"tags":["v2 - Team Invites"],"summary":"Cancel Invite","description":"Cancel a pending invitation.\n\nRequires MEMBERS_INVITE permission.\nCan only cancel pending invites.","operationId":"cancel_invite_v2_teams__team_id__invites__invite_id__delete","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/invites/pending":{"get":{"tags":["v2 - Team Invites"],"summary":"List My Pending Invites","description":"List all pending invites for the current user.\n\nUsed to show a notification badge or list of pending team invitations.","operationId":"list_my_pending_invites_v2_invites_pending_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/invites/{invite_id}/preview":{"get":{"tags":["v2 - Team Invites"],"summary":"Preview Invite","description":"Public, UNAUTHENTICATED preview of an invite.\n\nNO auth dependency, deliberately: the invitee opens this link before they\nhave an account or a session, so any `get_current_user` here would break\nthe whole email flow. The invite_id itself is the credential.\n\nReturns an explicit allowlist (InvitePreviewResponse) — see that model for\nwhat is withheld and why.\n\nA dead or consumed invite answers 200 with `actionable: false` and NO team\nor inviter detail, so the page can say \"this invite has expired\" instead of\na generic error, while a guessed or reused id reveals nothing. Only an\nunknown id is a 404.","operationId":"preview_invite_v2_invites__invite_id__preview_get","parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}}],"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"}}}}}}},"/v2/invites/{invite_id}/accept":{"post":{"tags":["v2 - Team Invites"],"summary":"Accept Invite","description":"Accept a team invitation.\n\nAdds the user as a member of the team with the invited role.","operationId":"accept_invite_v2_invites__invite_id__accept_post","parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/invites/{invite_id}/reject":{"post":{"tags":["v2 - Team Invites"],"summary":"Reject Invite","description":"Reject a team invitation.","operationId":"reject_invite_v2_invites__invite_id__reject_post","parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/credentials":{"post":{"tags":["v2 - Shared Credentials"],"summary":"Share Credential","description":"Share one of your credentials with the team.\n\nIMPORTANT: Only the credential owner can share it.\nRequires CREDENTIALS_SHARE permission.\nCannot share the same credential twice with the same team.\n\nEvery check is _share_one's, unchanged. After a share (new or\nreactivated) the team owner is emailed (2026-10-05).","operationId":"share_credential_v2_teams__team_id__credentials_post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareCredentialRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedCredentialResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - Shared Credentials"],"summary":"List Shared Credentials","description":"List all credentials shared with the team.\n\nRequires CREDENTIALS_VIEW permission.\nBy default, only shows active credentials.","operationId":"list_shared_credentials_v2_teams__team_id__credentials_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"include_inactive","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Inactive"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedCredentialListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/credentials/batch":{"post":{"tags":["v2 - Shared Credentials"],"summary":"Share Credentials Batch","description":"Share several of your credentials with the team in one tap (the share\npop-up, 2026-10-05). Each one goes through _share_one, exactly as the\nsingle route does: same permission, same owner-only rule, same 409 for\none already shared. One credential failing does not stop the rest; each\ngets its own outcome. The team owner gets ONE email naming every\nplatform that was shared.","operationId":"share_credentials_batch_v2_teams__team_id__credentials_batch_post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareCredentialsBatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/credentials/available":{"get":{"tags":["v2 - Shared Credentials"],"summary":"List Available Credentials","description":"List all credentials available to the user in team context.\n\nReturns both:\n- Personal credentials owned by the user\n- Shared credentials from other team members\n\nUseful for credential selection dropdown when creating a PlatformConfig.","operationId":"list_available_credentials_v2_teams__team_id__credentials_available_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailableCredentialsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/credentials/{shared_credential_id}":{"delete":{"tags":["v2 - Shared Credentials"],"summary":"Revoke Shared Credential","description":"Revoke a shared credential.\n\nOnly the owner of the credential or team admin can revoke it.","operationId":"revoke_shared_credential_v2_teams__team_id__credentials__shared_credential_id__delete","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"shared_credential_id","in":"path","required":true,"schema":{"type":"string","title":"Shared Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["v2 - Shared Credentials"],"summary":"Update Shared Credential","description":"Update a shared credential's nickname.\n\nOnly the owner can update the nickname.","operationId":"update_shared_credential_v2_teams__team_id__credentials__shared_credential_id__patch","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"shared_credential_id","in":"path","required":true,"schema":{"type":"string","title":"Shared Credential Id"}},{"name":"nickname","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nickname"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/credentials/{shared_credential_id}/insights":{"patch":{"tags":["v2 - Shared Credentials"],"summary":"Update Shared Credential Insights","description":"Switch team insights on or off for one shared channel (Tom, 2026-10-07).\n\n- history_and_stats: the team's owner and admins may import this\n channel's history and read its public posts, stats and audience.\n- recent_videos: they may also take caption text, and file links where\n enabled, for up to 10 recent public posts. Needs history_and_stats.\n\nOnly the credential's owner may change these, and only while the share is\nactive. Switching ON needs the owner signed in as themselves; an agent or\nkey may only switch OFF. Both start off and both clear on revoke.","operationId":"update_shared_credential_insights_v2_teams__team_id__credentials__shared_credential_id__insights_patch","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"shared_credential_id","in":"path","required":true,"schema":{"type":"string","title":"Shared Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareInsightsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/credentials/mine":{"get":{"tags":["v2 - Shared Credentials"],"summary":"List My Shared Credentials","description":"List credentials I have shared with this team.\n\nUseful for \"My Contributions\" view.","operationId":"list_my_shared_credentials_v2_teams__team_id__credentials_mine_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/requested-platforms":{"get":{"tags":["v2 - Team connect onboarding"],"summary":"Get Requested Platforms","description":"The platforms this team asks its members to connect. [] means pick any.","operationId":"get_requested_platforms_v2_teams__team_id__requested_platforms_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["v2 - Team connect onboarding"],"summary":"Set Requested Platforms","description":"Set the list. Owner, admin or manager. Unknown platform ids are refused, not dropped.","operationId":"set_requested_platforms_v2_teams__team_id__requested_platforms_put","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestedPlatformsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/connect-status":{"get":{"tags":["v2 - Team connect onboarding"],"summary":"Get Connect Status","description":"Per member: role, whether the role can share, which platforms are\nconnected, which are shared with this team, and the follow-up state.\nOwner, admin or manager. Public names and member_refs, never emails or\nprofile IDs.","operationId":"get_connect_status_v2_teams__team_id__connect_status_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/connect-email":{"post":{"tags":["v2 - Team connect onboarding"],"summary":"Send Connect Email","description":"The follow-up email, on demand: to one member, or to every member who\nhas not shared anything with the team yet, the owner included and the\nsender never. Same content as the 2-hour follow-up. dry_run=true lists\nexactly who would be emailed and sends nothing. Owner, admin or manager.","operationId":"send_connect_email_v2_teams__team_id__connect_email_post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectEmailRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/insights/channels":{"get":{"tags":["v2 - Team insights"],"summary":"List Insight Channels","description":"Every account shared with this team, with what its owner switched on.","operationId":"list_insight_channels_v2_teams__team_id__insights_channels_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/insights/channels/{shared_credential_id}/import":{"post":{"tags":["v2 - Team insights"],"summary":"Import Insight Channel","description":"Import this channel's history now, as its owner, with this credential.\n\nExactly the creator's own import: same rows, same owner, same 24-hour\nwindow (shared with the creator's own button), same job document.","operationId":"import_insight_channel_v2_teams__team_id__insights_channels__shared_credential_id__import_post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"shared_credential_id","in":"path","required":true,"schema":{"type":"string","title":"Shared Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/insights/channels/{shared_credential_id}/import-status":{"get":{"tags":["v2 - Team insights"],"summary":"Insight Channel Import Status","operationId":"insight_channel_import_status_v2_teams__team_id__insights_channels__shared_credential_id__import_status_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"shared_credential_id","in":"path","required":true,"schema":{"type":"string","title":"Shared Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/insights/channels/{shared_credential_id}/items":{"get":{"tags":["v2 - Team insights"],"summary":"List Insight Items","description":"The channel's imported public posts, newest first, with latest stats.","operationId":"list_insight_items_v2_teams__team_id__insights_channels__shared_credential_id__items_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"shared_credential_id","in":"path","required":true,"schema":{"type":"string","title":"Shared Credential Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/insights/channels/{shared_credential_id}/items/{content_id}/analytics":{"get":{"tags":["v2 - Team insights"],"summary":"Insight Item Analytics","operationId":"insight_item_analytics_v2_teams__team_id__insights_channels__shared_credential_id__items__content_id__analytics_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"shared_credential_id","in":"path","required":true,"schema":{"type":"string","title":"Shared Credential Id"}},{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Days"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/insights/channels/{shared_credential_id}/audience":{"get":{"tags":["v2 - Team insights"],"summary":"Insight Channel Audience","description":"Who watches: read live from the platform, held in this process for\nup to 6 hours, never written anywhere. YouTube only today.","operationId":"insight_channel_audience_v2_teams__team_id__insights_channels__shared_credential_id__audience_get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"shared_credential_id","in":"path","required":true,"schema":{"type":"string","title":"Shared Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/teams/{team_id}/insights/channels/{shared_credential_id}/recent-videos":{"post":{"tags":["v2 - Team insights"],"summary":"Insight Recent Videos","description":"Material from the channel's most recent PUBLIC posts, for learning the\ncreator's voice and style. JubJub stores none of it and runs no AI on it.\n\n- YouTube: caption text (VTT) for up to 5 videos, from the creator's own\n caption tracks via captions.download.\n- Instagram / Facebook: platform file links that expire on their own,\n ONLY while TEAM_INSIGHTS_META_VIDEO_LINKS is on (off until Tom confirms\n Meta's approved use case covers it).\n- TikTok, LinkedIn, everything else: no files.\n\nOnce per 7 days per team and channel, counted only when something came back.","operationId":"insight_recent_videos_v2_teams__team_id__insights_channels__shared_credential_id__recent_videos_post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"shared_credential_id","in":"path","required":true,"schema":{"type":"string","title":"Shared Credential Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecentVideosRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/team-connect/cron/followups":{"post":{"tags":["v2 - Team connect onboarding"],"summary":"Cron Connect Followups","description":"Every 15 minutes: one follow-up email per team-invite acceptance that is\nover 2 hours old and not yet handled. At most one, ever, per acceptance.","operationId":"cron_connect_followups_v2_team_connect_cron_followups_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles":{"get":{"tags":["v2 - Profiles"],"summary":"Get Profiles Batch","description":"Batch lookup profiles by IDs.\n\nReturns profile summaries for the given IDs, IN REQUEST ORDER (ids that\nwere not found are left out and listed in `not_found`).\n\nPRIVACY (2026-09-25): another person's row is their public profile only:\nno `profile_id`, no `email` (those are on your own row, `is_you`, and for\na platform admin). Match rows to the ids you asked for by position.\n\n**Usage:**\n```\nGET /v2/profiles?ids=prof_abc,prof_xyz,prof_123\n```\n\n**Note:** Maximum 50 IDs per request to prevent abuse.","operationId":"get_profiles_batch_v2_profiles_get","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of profile IDs","title":"Ids"},"description":"Comma-separated list of profile IDs","example":"prof_abc123,prof_xyz789"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles/wallet-rails":{"post":{"tags":["v2 - Profiles"],"summary":"Register Wallet Rails","description":"Register wallet rails (Privy wallet) for the authenticated user.\n\nWrites wallet_rails structured metadata and appends the address to\nwallet_addresses for fast array-contains lookups. Both fields are\nwritten in a single Firestore update.\n\nIdempotent: returns 200 if already registered with the same privy_user_id.\nReturns 409 if wallet_rails.evm exists with a different privy_user_id.","operationId":"register_wallet_rails_v2_profiles_wallet_rails_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterWalletRailsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletRailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - Profiles"],"summary":"Get Wallet Rails","description":"Get wallet rails for the authenticated user.\n\nReturns the wallet_rails object if registered, null otherwise.","operationId":"get_wallet_rails_v2_profiles_wallet_rails_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletRailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles/me":{"patch":{"tags":["v2 - Profiles"],"summary":"Update My Profile","description":"Update the authenticated user's own profile.\n\nPATCH semantics: only fields explicitly provided are written.\nMutable fields: display_name, avatar_url, bio.\nEmail is SET-ONCE: written only when the profile has no email yet (lets a\nwallet-only viewer add an email to publish & get paid); ignored if an email\nalready exists. No verification / Privy / Firebase user is involved.\n\nReturns the updated profile.","operationId":"update_my_profile_v2_profiles_me_patch","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMyProfileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles/me/handle":{"patch":{"tags":["v2 - Profiles"],"summary":"Update My Handle","description":"Set or change the authenticated user's @handle.\n\nValidation rules (src/utils/handle.py):\n- 3 to 30 chars\n- Lowercase letters, numbers, underscores only\n- Must start with a letter\n- Cannot be on the reserved list\n\nUniqueness: case-insensitive. Returns 409 if another profile holds the\nhandle (the current user holding it is a no-op success).","operationId":"update_my_handle_v2_profiles_me_handle_patch","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMyHandleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles/mentionable":{"get":{"tags":["v2 - Profiles"],"summary":"List Mentionable Profiles","description":"Return profiles matching `prefix` for @mention autocomplete.\n\nRanking:\n 1. `workspace_member` — the workspace's people: owner, direct members,\n the members of the team the workspace is linked to (`team_id`), and\n the caller. The same union as GET /v2/workspaces/{id}/members; a\n team member has access to the workspace, so they are a person in\n it (2026-09-09: a confirmed team member could not be tagged from a\n workspace their team owns). Matched on handle, display name OR\n email, so a member with no handle is found by name and a member\n with no name yet is found by email. With an empty prefix this is\n the whole list, which is what a bare \"@\" shows. Sorted by\n handle/name.\n 2. `recent_collaborator` — profiles whose handle starts with `prefix`\n and who share a workspace with the caller where activity occurred\n within the last 90 days. Sorted by `last_collaborated_at` desc,\n then alphabetical by handle. Skipped for an empty prefix.\n\nThe caller is included. A solo workspace has exactly one person in it,\nand that person could not tag themself (2026-09-05: \"No matching\nprofiles\" on the owner's own workspace).\n\nRecency gate (\"90-day window\"): if no shared workspace has any activity\n(content, launch, or workspace-scope comment) within the last 90 days,\nthe candidate is dropped. v0 simplification documented in\n`_latest_workspace_activity`.","operationId":"list_mentionable_profiles_v2_profiles_mentionable_get","parameters":[{"name":"prefix","in":"query","required":false,"schema":{"type":"string","maxLength":30,"description":"Handle or name prefix, case-insensitive. Empty lists the workspace's people.","default":"","title":"Prefix"},"description":"Handle or name prefix, case-insensitive. Empty lists the workspace's people."},{"name":"workspace_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional workspace_id to boost direct members","title":"Workspace Id"},"description":"Optional workspace_id to boost direct members"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"description":"Maximum results (capped at 25)","default":10,"title":"Limit"},"description":"Maximum results (capped at 25)"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MentionableListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles/{profile_id}":{"get":{"tags":["v2 - Profiles"],"summary":"Get Profile","description":"Get a single profile by ID.\n\nYour own profile in full; anyone else's public profile only (no\nprofile_id, no email) unless you are a platform admin.","operationId":"get_profile_v2_profiles__profile_id__get","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles/{profile_id}/wallets":{"post":{"tags":["v2 - Profiles"],"summary":"Add Wallet","description":"Add a wallet address to a profile.\n\nValidates EVM format (0x + 40 hex chars). Appends if not already present.\nOnly the profile owner can modify their wallets.","operationId":"add_wallet_v2_profiles__profile_id__wallets_post","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddWalletRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles/{profile_id}/wallets/{wallet_address}":{"delete":{"tags":["v2 - Profiles"],"summary":"Remove Wallet","description":"Remove a wallet address from a profile.\n\nOnly the profile owner can modify their wallets.","operationId":"remove_wallet_v2_profiles__profile_id__wallets__wallet_address__delete","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"wallet_address","in":"path","required":true,"schema":{"type":"string","title":"Wallet Address"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles/wallets/claim-agent":{"post":{"tags":["v2 - Profiles"],"summary":"Claim Agent Wallet","description":"Bind a wallet-only agent profile to the signed-in person.\n\nProof is SIWE over the agent's wallet: whoever holds that key made the\nagent, and signing from it says so. Refused for a wallet that is not on\nan `agent_viewer` profile (a person's own wallet is docked through\nwallet-rails, not claimed), and for an agent already owned by someone\nelse. Idempotent for the same owner. Only humans may own agents: an\nagent-key session cannot claim one.","operationId":"claim_agent_wallet_v2_profiles_wallets_claim_agent_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimAgentWalletRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimAgentWalletResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/profiles/me/payouts/release":{"post":{"tags":["v2 - Profiles"],"summary":"Release My Payouts","description":"Re-check the caller's payout identity and release any held tokens.\n\nSafe to call at any time: the on-chain registration is idempotent and\nthe identity check is a read. Returns the reason either way, so a\nsurface can say \"held: verify your email\" rather than nothing.","operationId":"release_my_payouts_v2_profiles_me_payouts_release_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutReleaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/communication/":{"post":{"tags":["v2 - Communication"],"summary":"Create Message","operationId":"create_message_v2_communication__post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMessageRequest"}}}},"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"}}}}}},"get":{"tags":["v2 - Communication"],"summary":"List Messages","operationId":"list_messages_v2_communication__get","parameters":[{"name":"scope_type","in":"query","required":true,"schema":{"type":"string","description":"Scope type","title":"Scope Type"},"description":"Scope type"},{"name":"scope_id","in":"query","required":true,"schema":{"type":"string","description":"Scope ID","title":"Scope Id"},"description":"Scope ID"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pagination cursor","title":"Cursor"},"description":"Pagination cursor"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"thread_root_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to thread","title":"Thread Root Id"},"description":"Filter to thread"},{"name":"collection_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Collection context for media-scope auth fallback","title":"Collection Id"},"description":"Collection context for media-scope auth fallback"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"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"}}}}}}},"/v2/communication/inbox":{"get":{"tags":["v2 - Communication"],"summary":"List Inbox","description":"Messages relevant to the authenticated user: those that mention them, or\nthose in a workspace they can reach. Server-side scope (no client N+1).\nSorted newest-first, soft-deleted excluded, offset-paginated.\n\nOPEN ONLY, BY DEFAULT. The inbox is the list of things still to deal\nwith; a message marked handled (PATCH /{id}/resolve) leaves it. Without\nthis the list was append-only and a 193-day-old test comment sat at the\ntop of the home page with no way off.","operationId":"list_inbox_v2_communication_inbox_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"include_resolved","in":"query","required":false,"schema":{"type":"boolean","description":"Also return messages already marked handled. Default: open only.","default":false,"title":"Include Resolved"},"description":"Also return messages already marked handled. Default: open only."},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"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"}}}}}}},"/v2/communication/{message_id}":{"get":{"tags":["v2 - Communication"],"summary":"Get Message","operationId":"get_message_v2_communication__message_id__get","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","title":"Message Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"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":["v2 - Communication"],"summary":"Edit Message","operationId":"edit_message_v2_communication__message_id__patch","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","title":"Message Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditMessageRequest"}}}},"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":["v2 - Communication"],"summary":"Delete Message","operationId":"delete_message_v2_communication__message_id__delete","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","title":"Message Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/communication/{message_id}/resolve":{"patch":{"tags":["v2 - Communication"],"summary":"Resolve Decision","description":"Mark a message handled.\n\nA DECISION resolves with a decision_status, as before. A COMMENT resolves\nwith an empty body: it is stamped resolved_at/resolved_by and leaves the\ninbox. Resolved is not read — a comment someone has seen but not acted\non stays open; this is the \"handled\" action, on the message itself.\nAnyone who can write the message's scope may resolve it.","operationId":"resolve_decision_v2_communication__message_id__resolve_patch","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","title":"Message Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ResolveDecisionRequest"},{"type":"null"}],"title":"Request"}}}},"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"}}}}}}},"/v2/communication/legacy-media-comments":{"get":{"tags":["v2 - Communication"],"summary":"List Legacy Media Comments","description":"Read legacy Firestore comments from /media/{mediaId}/comments and\nreturn them in the v2 MessageListResponse shape.\n\nReturned messages have ``origin='legacy'`` and ``event_version=0``\nso the dashboard can render them identically to v2 messages without\nneeding to know the source.","operationId":"list_legacy_media_comments_v2_communication_legacy_media_comments_get","parameters":[{"name":"media_id","in":"query","required":true,"schema":{"type":"string","description":"Media document ID","title":"Media Id"},"description":"Media document ID"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"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"}}}}}}},"/v2/notifications/socket-token":{"post":{"tags":["v2 - Notifications"],"summary":"Mint Notifications Socket Token","description":"A five-minute token for the notifications WebSocket, bound to the\ncaller's profile and to that socket's audience (2026-09-28).\n\nThe socket used to take the Firebase session cookie on its URL, which\nmeant the dashboard returned that five-day, every-route credential to\npage script. This token is what page script gets instead: the socket\nverifies its signature, audience and expiry\n(notification_socket_token.verify_socket_token) and maps it to the\nprofile; the API's bearer chain does not accept it at all. The caller\nproves who they are with their ordinary credential to reach this route.","operationId":"mint_notifications_socket_token_v2_notifications_socket_token_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocketTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/notifications/":{"get":{"tags":["v2 - Notifications"],"summary":"List Notifications","operationId":"list_notifications_v2_notifications__get","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pagination cursor","title":"Cursor"},"description":"Pagination cursor"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"unread_only","in":"query","required":false,"schema":{"type":"boolean","description":"Only return unread","default":false,"title":"Unread Only"},"description":"Only return unread"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationV2ListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/notifications/unread-count":{"get":{"tags":["v2 - Notifications"],"summary":"Get Unread Count","operationId":"get_unread_count_v2_notifications_unread_count_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/notifications/{notification_id}/read":{"patch":{"tags":["v2 - Notifications"],"summary":"Mark Notification Read","operationId":"mark_notification_read_v2_notifications__notification_id__read_patch","parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","title":"Notification Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/notifications/mark-all-read":{"patch":{"tags":["v2 - Notifications"],"summary":"Mark All Notifications Read","operationId":"mark_all_notifications_read_v2_notifications_mark_all_read_patch","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/notifications/{notification_id}":{"delete":{"tags":["v2 - Notifications"],"summary":"Delete Notification","operationId":"delete_notification_v2_notifications__notification_id__delete","parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","title":"Notification Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/uploads/link":{"post":{"tags":["v2 - Upload Sessions"],"summary":"Create an upload session link","description":"Agent-authenticated. Creates an upload link for a user. The link accepts new files for 24 hours from creation (expires_at); a file that started inside the window always finishes.","operationId":"create_upload_link_v2_uploads_link_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUploadLinkRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUploadLinkResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/uploads/sessions/{upload_session_id}":{"get":{"tags":["v2 - Upload Sessions"],"summary":"Get upload session status","description":"Session-token authenticated. Returns full session state for agent polling.","operationId":"get_upload_session_v2_uploads_sessions__upload_session_id__get","parameters":[{"name":"upload_session_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Session Id"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSessionStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/uploads/sessions/{upload_session_id}/request-upload":{"post":{"tags":["v2 - Upload Sessions"],"summary":"Request a signed upload URL for a file","description":"Session-token authenticated. Creates a media_v2 record and returns a signed PUT URL.","operationId":"session_request_upload_v2_uploads_sessions__upload_session_id__request_upload_post","parameters":[{"name":"upload_session_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Session Id"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionRequestUploadDTO"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/uploads/sessions/{upload_session_id}/complete":{"post":{"tags":["v2 - Upload Sessions"],"summary":"Mark a file upload as complete","description":"Session-token authenticated. Makes file public, extracts metadata, marks asset ready.","operationId":"session_complete_asset_v2_uploads_sessions__upload_session_id__complete_post","parameters":[{"name":"upload_session_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Session Id"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionCompleteAssetDTO"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSessionStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/uploads/sessions/{upload_session_id}/fail":{"post":{"tags":["v2 - Upload Sessions"],"summary":"Record that a file's upload failed in the browser","description":"Session-token authenticated. The browser could not deliver the bytes (the PUT to storage failed after retries). Marks the asset and its media record failed so the session can still finish. A file already marked ready is left alone.","operationId":"session_fail_asset_v2_uploads_sessions__upload_session_id__fail_post","parameters":[{"name":"upload_session_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Session Id"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionFailAssetDTO"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSessionStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/uploads/sessions/{upload_session_id}/infer-groupings":{"post":{"tags":["v2 - Upload Sessions"],"summary":"Auto-infer video-thumbnail groupings","description":"Session-token authenticated. Runs heuristic pairing on uploaded assets.","operationId":"infer_groupings_v2_uploads_sessions__upload_session_id__infer_groupings_post","parameters":[{"name":"upload_session_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Session Id"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferGroupingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/uploads/sessions/{upload_session_id}/confirm-groupings":{"post":{"tags":["v2 - Upload Sessions"],"summary":"Confirm video-thumbnail groupings","description":"Session-token authenticated. Stores confirmed groupings. Does NOT create contents.","operationId":"confirm_groupings_v2_uploads_sessions__upload_session_id__confirm_groupings_post","parameters":[{"name":"upload_session_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Session Id"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmGroupingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmGroupingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/uploads/sessions/{upload_session_id}/close":{"post":{"tags":["v2 - Upload Sessions"],"summary":"Close an upload session","description":"Session-token authenticated. Marks the session CLOSED once every file in it has finished (ready or failed). Answers 409 while any file is still uploading. expires_at is not changed. Idempotent: calling on an already-closed session returns 200.","operationId":"close_session_v2_uploads_sessions__upload_session_id__close_post","parameters":[{"name":"upload_session_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Session Id"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},{"name":"x-upload-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Upload-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSessionStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/upload/{upload_session_id}":{"get":{"tags":["v2 - Upload Sessions"],"summary":"Upload page (no login required)","description":"Returns a self-contained HTML upload page. Validate via ?token= query parameter.","operationId":"upload_page_upload__upload_session_id__get","parameters":[{"name":"upload_session_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Session Id"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/mcp":{"post":{"tags":["v2 - MCP"],"summary":"Mcp Post","description":"MCP Streamable HTTP endpoint.\n\nAccepts a JSON-RPC 2.0 message and returns a JSON-RPC response.\nSupports agent key auth and OAuth 2.1 Bearer token auth.","operationId":"mcp_post_v2_mcp_post","parameters":[{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 - MCP"],"summary":"Mcp Get","description":"SSE streaming not supported.","operationId":"mcp_get_v2_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"delete":{"tags":["v2 - MCP"],"summary":"Mcp Delete","description":"Session termination not supported.","operationId":"mcp_delete_v2_mcp_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/approvals/{approval_id}/decide":{"post":{"tags":["v2 - Approvals"],"summary":"Decide Approval","description":"Approve or reject an approval request.\n\nA channel approval: only its credential owner. A workspace_owner\napproval: the workspace owner, or anyone the owner has granted approval\nrights to (read live). Agents need the ``approvals:decide`` scope, off by\ndefault — the owner's own configuration of their own agent.\n\nApproving the last pending approval sends the launch (as scheduled, or\nnow if its time has passed: `sent_now`). Rejecting cancels the launch.\n\n**Path parameters:**\n- `approval_id`: The approval request to decide on\n\n**Request body:**\n- `decision`: \"approved\" or \"rejected\"\n- `reason`: Optional reason (recommended for rejections)\n\n**Responses:**\n- 200: Decision recorded successfully\n- 400: Invalid decision\n- 403: Not the designated approver\n- 404: Approval request not found\n- 410: Approval request has expired\n- 503: Approval service unavailable","operationId":"decide_approval_v2_approvals__approval_id__decide_post","parameters":[{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","title":"Approval Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDecisionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/approvals/pending":{"get":{"tags":["v2 - Approvals"],"summary":"Get Pending Approvals","description":"Get all pending approval requests for the current user.\n\nReturns approval requests where the current user is the designated\napprover and the status is still \"pending\".\n\n**Responses:**\n- 200: List of pending approvals\n- 503: Approval service unavailable","operationId":"get_pending_approvals_v2_approvals_pending_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingApprovalsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/approvals/launch/{launch_id}":{"get":{"tags":["v2 - Approvals"],"summary":"Get Approvals For Launch","description":"Get all approval requests for a specific launch.\n\nReturns all approval requests (any status) associated with the given\nlaunch ID. Useful for checking whether all approvals have been resolved.\n\n**Responses:**\n- 200: List of approvals for this launch\n- 503: Approval service unavailable","operationId":"get_approvals_for_launch_v2_approvals_launch__launch_id__get","parameters":[{"name":"launch_id","in":"path","required":true,"schema":{"type":"string","title":"Launch Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingApprovalsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/internal/cleanup-expired-workspaces":{"post":{"tags":["v2 - Internal"],"summary":"Cleanup Expired Workspaces","description":"Delete EXPIRED ANONYMOUS TRIAL workspaces. Never a creator's.\n\n🔴 THIS CRON MAY NOT DELETE OWNED WORKSPACES, AND CANNOT.\nCreator media is inventory: it is what x402 agents buy through\nmedia_search / purchase_metadata / purchase_content. A timer that deletes\nit destroys saleable stock and a creator's archive at once. Owned\nworkspaces are permanent (decision 2026-09-01, workspace_routes.py:521);\nonly anonymous \"Try Now\" sandboxes expire.\n\nTwo independent things keep that true, and only the second is load-bearing:\n\n 1. the query below filters `owner_id == None`, so an owned workspace is\n not even considered. This is an efficiency and a statement of intent.\n 2. `_delete_trial_workspace_cascade` RE-READS each document and RAISES\n on anything owned. This is the guarantee. Widening the query cannot\n widen what gets deleted.\n\nA refusal is logged and counted, never swallowed: if this cron ever selects\nan owned workspace, that is a bug in the selection and the evidence must\nsurvive the run.\n\nScheduled daily; trials live TrialConfig.SESSION_DURATION_HOURS (72h), so a\ndaily tick removes them within a day of expiry. Processes up to batch_size\nper invocation.","operationId":"cleanup_expired_workspaces_v2_internal_cleanup_expired_workspaces_post","parameters":[{"name":"batch_size","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Batch Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/internal/cleanup-orphaned-media":{"post":{"tags":["v2 - Internal"],"summary":"Cleanup Orphaned Media","description":"Delete media records stuck in 'uploading' status for longer than threshold.\n\nThese are uploads that were started but never completed (user cancelled,\nbrowser closed, network error, etc). The frontend only clears local state,\nleaving orphaned records in Firestore and partial files in GCS.\n\nCalled by Cloud Scheduler (e.g. every hour) or manually.","operationId":"cleanup_orphaned_media_v2_internal_cleanup_orphaned_media_post","parameters":[{"name":"threshold_hours","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Threshold Hours"}},{"name":"batch_size","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Batch Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/internal/cleanup-expired-members":{"post":{"tags":["v2 - Internal"],"summary":"Cleanup Expired Members","description":"Remove workspace members whose expires_at has passed.\n\nIterates over all workspaces, filters out expired members, and saves\nthe updated member list. Called by Cloud Scheduler or manually.","operationId":"cleanup_expired_members_v2_internal_cleanup_expired_members_post","parameters":[{"name":"batch_size","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Batch Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/internal/cleanup-expired-try-now":{"post":{"tags":["v2 - Internal"],"summary":"Cleanup Expired Try Now","description":"Delete old try-now session documents.\n\n- Expired/abandoned sessions: deleted after retention_days (default 30)\n- Claimed sessions: deleted after claimed_retention_days (default 7)\n since data is already in profiles/{profileId}.try_now_metadata\n\nWorkspace + media are already cleaned by cleanup-expired-workspaces.\nCalled by Cloud Scheduler weekly (e.g., Sunday 4 AM AEST).","operationId":"cleanup_expired_try_now_v2_internal_cleanup_expired_try_now_post","parameters":[{"name":"retention_days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Retention Days"}},{"name":"claimed_retention_days","in":"query","required":false,"schema":{"type":"integer","default":7,"title":"Claimed Retention Days"}},{"name":"batch_size","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Batch Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/internal/qa/run":{"post":{"tags":["v2 - Internal"],"summary":"Internal Run Qa","description":"Run the proactive QA test suite. Called by Cloud Scheduler at 2am AEST.","operationId":"internal_run_qa_v2_internal_qa_run_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/webhooks/farcaster":{"get":{"tags":["v2 - Webhooks"],"summary":"Farcaster Webhook Health","description":"Health check endpoint for Neynar webhook probe.","operationId":"farcaster_webhook_health_v2_webhooks_farcaster_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["v2 - Webhooks"],"summary":"Farcaster Webhook","description":"Handle Neynar cast events for JubJub-connected Farcaster creators.\n\nSignature verification fails closed and propagates 403 on mismatch.\nProcessing failures are swallowed and return 200 so Neynar does not\nretry on our internal errors; genuine 400/403 responses still propagate.","operationId":"farcaster_webhook_v2_webhooks_farcaster_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/try-now/start":{"post":{"tags":["v2 - Try Now"],"summary":"Start Try Now","description":"Start a new try-now session.\n\nCreates a real V2 workspace (owner_id=None, is_trial=True) and a\nTryNowSession for analytics tracking. Returns a trial_token that\nthe frontend must include as X-Trial-Token in all subsequent calls.","operationId":"start_try_now_v2_try_now_start_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartTryNowRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartTryNowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/try-now/{workspace_id}":{"get":{"tags":["v2 - Try Now"],"summary":"Get Trial Workspace","description":"Get trial workspace data, plus everything a client needs to RESUME.\n\n`resume` is what the website's `?tn_resume=` handler (and a reload on\nthe same device) rebuilds its local state from: the uploaded media with\na signed playback URL and its probed metadata, the content id, the\nthumbnail, the captured email and chosen platforms. Without it a resume\nlink from another device would land on an empty drop zone.","operationId":"get_trial_workspace_v2_try_now__workspace_id__get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"X-Trial-Token","in":"header","required":true,"schema":{"type":"string","title":"X-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/try-now/{workspace_id}/contents":{"post":{"tags":["v2 - Try Now"],"summary":"Create Trial Content","description":"Create content in trial workspace. Enforces MAX_CONTENTS limit.","operationId":"create_trial_content_v2_try_now__workspace_id__contents_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"X-Trial-Token","in":"header","required":true,"schema":{"type":"string","title":"X-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TryNowCreateContentRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/try-now/{workspace_id}/media/upload-url":{"post":{"tags":["v2 - Try Now"],"summary":"Request Trial Upload","description":"Request a signed URL for media upload in trial workspace.","operationId":"request_trial_upload_v2_try_now__workspace_id__media_upload_url_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"X-Trial-Token","in":"header","required":true,"schema":{"type":"string","title":"X-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TryNowUploadRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/try-now/{workspace_id}/media/{media_id}/confirm":{"post":{"tags":["v2 - Try Now"],"summary":"Confirm Trial Upload","description":"Confirm upload completion for trial media.","operationId":"confirm_trial_upload_v2_try_now__workspace_id__media__media_id__confirm_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"media_id","in":"path","required":true,"schema":{"type":"string","title":"Media Id"}},{"name":"X-Trial-Token","in":"header","required":true,"schema":{"type":"string","title":"X-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TryNowUploadCompleteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/try-now/{workspace_id}/contents/{content_id}/platform-configs":{"post":{"tags":["v2 - Try Now"],"summary":"Set Trial Platform Configs","description":"Set platform configs for trial content.\ncredential_id is None — credentials are bound after claim.\nEnforces MAX_PLATFORMS limit.","operationId":"set_trial_platform_configs_v2_try_now__workspace_id__contents__content_id__platform_configs_post","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"X-Trial-Token","in":"header","required":true,"schema":{"type":"string","title":"X-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TryNowBulkPlatformConfigRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/try-now/{workspace_id}/pre-profile":{"patch":{"tags":["v2 - Try Now"],"summary":"Update Pre Profile","description":"Update pre-profile data (micro-survey, behavioral timing, email capture).\nOnly non-null fields are applied.","operationId":"update_pre_profile_v2_try_now__workspace_id__pre_profile_patch","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"X-Trial-Token","in":"header","required":true,"schema":{"type":"string","title":"X-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePreProfileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/try-now/{workspace_id}/progress":{"get":{"tags":["v2 - Try Now"],"summary":"Get Trial Progress","description":"Get trial progress and funnel data.","operationId":"get_trial_progress_v2_try_now__workspace_id__progress_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"X-Trial-Token","in":"header","required":true,"schema":{"type":"string","title":"X-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TryNowProgressResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/try-now/claim":{"post":{"tags":["v2 - Try Now"],"summary":"Claim Try Now","description":"Claim a trial workspace after Firebase signup.\n\nRequires:\n- X-Trial-Token header (trial authentication)\n- Authorization: Bearer (Firebase authentication)","operationId":"claim_try_now_v2_try_now_claim_post","parameters":[{"name":"X-Trial-Token","in":"header","required":true,"schema":{"type":"string","title":"X-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimTryNowRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimTryNowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/public/try-now/copy":{"get":{"tags":["v2 - Try Now"],"summary":"Get Try Now Copy","description":"The drop zone's headline/subline/CTA overrides, editable in Firestore\n(`website_config/try_now_copy`, shape `{pages: {...}, variants: {...}}`)\nso messaging can change without a website deploy. An absent doc is an\nempty override, not an error — the site's built-in copy applies.","operationId":"get_try_now_copy_v2_public_try_now_copy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/admin/try-now/metrics/overview":{"get":{"tags":["v2 - Try Now Analytics"],"summary":"Metrics Overview","description":"High-level totals: total sessions, conversion rate, status breakdown.","operationId":"metrics_overview_v2_admin_try_now_metrics_overview_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/try-now/metrics/funnel":{"get":{"tags":["v2 - Try Now Analytics"],"summary":"Metrics Funnel","description":"Step-by-step drop-off: how many sessions reached each step.","operationId":"metrics_funnel_v2_admin_try_now_metrics_funnel_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/try-now/metrics/by-source":{"get":{"tags":["v2 - Try Now Analytics"],"summary":"Metrics By Source","description":"Breakdown per source (landing page / UTM source).","operationId":"metrics_by_source_v2_admin_try_now_metrics_by_source_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/try-now/metrics/by-feature":{"get":{"tags":["v2 - Try Now Analytics"],"summary":"Metrics By Feature","description":"Breakdown per feature_interest.","operationId":"metrics_by_feature_v2_admin_try_now_metrics_by_feature_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/try-now/metrics/by-geo":{"get":{"tags":["v2 - Try Now Analytics"],"summary":"Metrics By Geo","description":"Breakdown per country.","operationId":"metrics_by_geo_v2_admin_try_now_metrics_by_geo_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/try-now/metrics/by-device":{"get":{"tags":["v2 - Try Now Analytics"],"summary":"Metrics By Device","description":"Breakdown per device_type (desktop, mobile, tablet).","operationId":"metrics_by_device_v2_admin_try_now_metrics_by_device_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/try-now/metrics/timeline":{"get":{"tags":["v2 - Try Now Analytics"],"summary":"Metrics Timeline","description":"Time series of sessions created and claimed.","operationId":"metrics_timeline_v2_admin_try_now_metrics_timeline_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Days to look back","default":30,"title":"Period"},"description":"Days to look back"},{"name":"granularity","in":"query","required":false,"schema":{"type":"string","description":"day | week","default":"day","title":"Granularity"},"description":"day | week"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/try-now/metrics/enrichment":{"get":{"tags":["v2 - Try Now Analytics"],"summary":"Metrics Enrichment","description":"PreProfile fill rates: what percentage of sessions filled each field.","operationId":"metrics_enrichment_v2_admin_try_now_metrics_enrichment_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/streaming/sessions":{"post":{"tags":["v2 - Streaming"],"summary":"Create Streaming Session","description":"Create a streaming session for watching content.\n\nRequires the viewer to have a registered wallet for USDC payments.\n\nRate-limited per profile AND per IP. This is DoS-critical, not merely\nabuse control: `create_session` issues a ~300k-gas OPERATOR transaction,\nand operator txs serialise on the operator nonce — so flooding this\nendpoint stalls minting, catalogue deploys and settlement platform-wide,\nnot just streaming. The check must therefore sit BEFORE create_session.","operationId":"create_streaming_session_v2_streaming_sessions_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSessionRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/streaming/sessions/{session_id}/segment":{"post":{"tags":["v2 - Streaming"],"summary":"Record Streaming Segment","description":"Record a viewed segment (heartbeat from player every 6 seconds).\nAuto-settles when 1 minute of unsettled segments accumulates.","operationId":"record_streaming_segment_v2_streaming_sessions__session_id__segment_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SegmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/streaming/sessions/{session_id}/playback-url":{"post":{"tags":["v2 - Streaming"],"summary":"Get Session Playback Url","description":"Tier-2 gated playback: issue a short-lived, session-scoped signed URL.\n\nTHIS is the paywall. Before issuing anything we require, in order:\n (a) the session exists,\n (b) it belongs to THIS viewer (verified via the streaming-session token),\n (c) the session is live and paid (status == \"active\").\nOnly then do we mint a signed, expiring URL via the per-host signer. If no\nsigner can sign the content's host, we 422 — we never return a non-expiring\ndurable URL. There is no public / pre-payment path to this endpoint.","operationId":"get_session_playback_url_v2_streaming_sessions__session_id__playback_url_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaybackUrlResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/streaming/sessions/{session_id}/close":{"post":{"tags":["v2 - Streaming"],"summary":"Close Streaming Session","description":"Close a streaming session and settle any remaining balance.\n\nOptional body: {\"playback_seconds\": } — if provided, the final\nsettlement uses precise playback seconds instead of segment rounding.","operationId":"close_streaming_session_v2_streaming_sessions__session_id__close_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CloseSessionRequest"},{"type":"null"}],"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/streaming/sessions/{session_id}/beacon-close":{"post":{"tags":["v2 - Streaming"],"summary":"Beacon Close Session","description":"Unauthenticated close endpoint for navigator.sendBeacon on tab close.\n\nsendBeacon cannot carry custom headers, so we verify ownership by\nmatching the viewer_wallet in the request body against the session's\nstored viewer_wallet. The session_id is a UUID (hard to guess) and\nthe close operation is non-destructive (settles money TO the creator).\n\nTHE BODY IS PARSED BY HAND, AND THAT IS THE POINT. This route used to bind\n`request: BeaconCloseRequest`, which makes FastAPI require\n`Content-Type: application/json` — and a JSON Blob is not CORS-simple, so\n`sendBeacon` had to preflight it and the POST was dropped during unload.\nClients now send `text/plain` to avoid the preflight, which a Pydantic body\nmodel answers with 422. `parse_beacon_body` accepts both shapes (and\nform-encoding) so the mini-app's vendored SDK snapshot keeps working\nunchanged while the new bundle rolls out.\n\nAn unreadable DURATION never blocks the close — it is telemetry, and\n`settle_session` bills from segment_count alone. An unreadable WALLET does,\nbecause on an unauthenticated endpoint it is the only authorisation there\nis; that is a 400, never a 500.","operationId":"beacon_close_session_v2_streaming_sessions__session_id__beacon_close_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/streaming/sessions/{session_id}":{"get":{"tags":["v2 - Streaming"],"summary":"Get Streaming Session","description":"Get the current state of a streaming session.","operationId":"get_streaming_session_v2_streaming_sessions__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/streaming/cron/settle-idle":{"post":{"tags":["v2 - Streaming"],"summary":"Settle Idle Streaming Sessions","description":"Settle all active sessions that haven't had a segment in 60+ seconds.\n\nDesigned to be called by Cloud Scheduler every 60 seconds.","operationId":"settle_idle_streaming_sessions_v2_streaming_cron_settle_idle_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/pool/cron/settle-crossings":{"post":{"tags":["v2 - Creator Pool"],"summary":"Cron Settle Crossings","description":"Compose at most one new crossing and submit everything pending.\n\nSafe to over-schedule: the ledger lease single-flights concurrent runs\nand the on-chain replay guard makes a double submission a gas-only no-op.","operationId":"cron_settle_crossings_v2_pool_cron_settle_crossings_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/pool/cron/reconcile":{"post":{"tags":["v2 - Creator Pool"],"summary":"Cron Reconcile","description":"Books-vs-chain verification + alerts M-a..M-f. Reads only.","operationId":"cron_reconcile_v2_pool_cron_reconcile_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/pool/accrual/{pot_address}":{"get":{"tags":["v2 - Creator Pool"],"summary":"Accrual Detail","description":"Ledger-side money states for one catalogue pot.\n\nAUTH: authenticated users only (this shipped without a dependency —\ncaught in audit; it was the only unauthenticated money read in the\ncodebase). The full authorisation rule this surface ultimately needs is\nholder-or-owner-scoped and id-keyed: dashboard and MCP speak\ncontent/team ids, pots are catalogue addresses, so the user-facing\nreads belong on an id-keyed sibling endpoint that resolves the pot via\nthe entity doc and checks membership the way catalogue_get does. This\naddress-keyed read stays as the low-level tool: authenticated, and\nexposing only aggregate, non-PII ledger positions.\n\nStates 1-3 of the five-state display (\"earning now\" is per-viewer and\nsummed here; \"held for your catalogue\" is pending_at_hub). Everything\nhere is NON-spendable by definition — states 4-5 (ready to claim / in\nwallet) come from the catalogue contract via the existing claim surfaces\nand are deliberately not blended in.","operationId":"accrual_detail_v2_pool_accrual__pot_address__get","parameters":[{"name":"pot_address","in":"path","required":true,"schema":{"type":"string","title":"Pot Address"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/analytics/content/{content_id}":{"get":{"tags":["v2 - Analytics"],"summary":"Get Content Analytics","description":"Get analytics for a specific content item over a date range.","operationId":"get_content_analytics_v2_analytics_content__content_id__get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","description":"7d, 30d, 90d, all_time","default":"30d","title":"Period"},"description":"7d, 30d, 90d, all_time"},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD","title":"Date From"},"description":"YYYY-MM-DD"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD","title":"Date To"},"description":"YYYY-MM-DD"},{"name":"platforms","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated platform filter","title":"Platforms"},"description":"Comma-separated platform filter"},{"name":"granularity","in":"query","required":false,"schema":{"type":"string","description":"total or daily","default":"total","title":"Granularity"},"description":"total or daily"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsRangeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/analytics/portfolio":{"get":{"tags":["v2 - Analytics"],"summary":"Get Portfolio Analytics","description":"Get analytics across all content owned by the authenticated user.","operationId":"get_portfolio_analytics_v2_analytics_portfolio_get","parameters":[{"name":"workspace_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workspace Id"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"30d","title":"Period"}},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To"}},{"name":"platforms","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platforms"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","default":"total_views","title":"Sort By"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"extra_periods","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated periods (7d, 30d, 90d) inside the requested range whose totals are also returned, under period_aggregates, from the same snapshot reads.","title":"Extra Periods"},"description":"Comma-separated periods (7d, 30d, 90d) inside the requested range whose totals are also returned, under period_aggregates, from the same snapshot reads."},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioAnalyticsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/analytics/content/{content_id}/snapshot":{"get":{"tags":["v2 - Analytics"],"summary":"Get Content Snapshot","description":"Get a single day's analytics snapshot for a content item.","operationId":"get_content_snapshot_v2_analytics_content__content_id__snapshot_get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD, defaults to today","title":"Date"},"description":"YYYY-MM-DD, defaults to today"},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/analytics/content/{content_id}/totals":{"get":{"tags":["v2 - Analytics"],"summary":"Get Content Totals","description":"Get all-time totals for a content item.","operationId":"get_content_totals_v2_analytics_content__content_id__totals_get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/analytics/content/{content_id}/fetch":{"post":{"tags":["v2 - Analytics"],"summary":"Fetch Content Analytics Now","description":"Force fetch analytics for a content item right now.","operationId":"fetch_content_analytics_now_v2_analytics_content__content_id__fetch_post","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FetchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/analytics/cron/daily-fetch":{"post":{"tags":["v2 - Analytics"],"summary":"Cron Daily Analytics Fetch","description":"Daily analytics fetch for all published content.\n\nDesigned to be called by Cloud Scheduler once per day. Works inside a\nwall-clock budget and queues a continuation of itself when rows remain.","operationId":"cron_daily_analytics_fetch_v2_analytics_cron_daily_fetch_post","parameters":[{"name":"hop","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Continuation hop. 0 is the scheduled run; each hop the run queues for itself carries one more.","default":0,"title":"Hop"},"description":"Continuation hop. 0 is the scheduled run; each hop the run queues for itself carries one more."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/quota/cron/watch":{"post":{"tags":["v2 - Quota"],"summary":"Cron Quota Watch","description":"Assess platform API consumption against each ceiling and emit the\n[QUOTA-APPROACH] alert line for anything worth acting on.\n\nDesigned for a daily Cloud Scheduler job, AFTER the daily analytics\nfetch (so last_ok_at reflects today's run, not yesterday's).","operationId":"cron_quota_watch_v2_quota_cron_watch_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/quota/cron/paid-routes-live-check":{"post":{"tags":["v2 - Quota"],"summary":"Cron Paid Routes Live Check","description":"Hourly: both paid x402 routes answer 402 at their public URLs, including\nto the example input they advertise. Emails Tom once when that starts\nfailing and once when it recovers (paid_route_live_check). dry_run checks\nand reports without recording state or sending.","operationId":"cron_paid_routes_live_check_v2_quota_cron_paid_routes_live_check_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/quota/cron/trial-watch":{"post":{"tags":["v2 - Quota"],"summary":"Cron Trial Watch","description":"Emit the [TRIAL-FUNNEL-RISK] line when the try-now funnel is heading\nfor a 429 (an IP nearing the per-IP session cap) or when a trial cleanup\ncron has stopped succeeding (which is what lets sessions pile up against\nthat cap).\n\nLives beside the platform-quota watcher for the same reason the\nAI-credential watcher does: same detector shape (approach-a-ceiling and\nabsence-of-expected-outcome), same alert-token contract, same 20-hour\ndedupe, same dry_run-as-status. Different subject, so a separate route\non a separate schedule.","operationId":"cron_trial_watch_v2_quota_cron_trial_watch_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/quota/cron/trial-recovery-emails":{"post":{"tags":["v2 - Quota"],"summary":"Cron Trial Recovery Emails","description":"Hourly: send \"your video is waiting\" (~2h after an abandoned email\ncapture) and \"expires soon\" (final window) to ACTIVE, idle trial sessions\nwith a captured email — never to a claimed one. Both latched once. See\ntrial_watch_worker.sweep_recovery_emails for why hourly.","operationId":"cron_trial_recovery_emails_v2_quota_cron_trial_recovery_emails_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/quota/cron/ai-credential-watch":{"post":{"tags":["v2 - Quota"],"summary":"Cron Ai Credential Watch","description":"Emit the [AI-CREDENTIAL-STALE] line for any connected AI credential\nthat has not succeeded in AI_CREDENTIAL_STALE_DAYS while something has\ntried and failed.\n\nLives beside the platform-quota watcher because it is the same detector —\nabsence of an expected outcome — and shares its alert-token contract, its\n20-hour dedupe and its dry_run-as-status behaviour. It is a different\nsubject (creator AI keys, not platform API ceilings), so it is a separate\nroute on a separate schedule rather than another `kind` in that sweep.","operationId":"cron_ai_credential_watch_v2_quota_cron_ai_credential_watch_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/platforms":{"get":{"tags":["v2 - Platforms"],"summary":"List Platforms","description":"List all supported platforms grouped by category with connection type info.\n\nUsed by frontend platform connect page and MCP.","operationId":"list_platforms_v2_platforms_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/ownership/release-pending-payouts":{"post":{"tags":["v2 - Ownership"],"summary":"Release Pending Payouts Cron","description":"Backstop for the payout identity gate (payout_identity.py).\n\nIdentity can attach where no backend call sees it — an email verified\nthrough the dashboard's Firebase reset link flips `email_verified` on\nthe Auth user only. This sweep re-checks every profile whose brand\ntokens are held for identity and releases the ones that now qualify.\nIdempotent; a profile still lacking identity is left held and counted.\nCloud Scheduler hourly is plenty: nothing is lost while held.","operationId":"release_pending_payouts_cron_v2_ownership_release_pending_payouts_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/ownership/recover-stuck-minting":{"post":{"tags":["v2 - Ownership"],"summary":"Recover Stuck Minting","description":"Resume content stuck in ownership_status=\"minting\" for more than 10 minutes.\n\nDesigned to be called by Cloud Scheduler every 10 minutes.\nUses the state machine's ownership_step field to resume from the\nlast completed checkpoint. Idempotent: checks on-chain state before\nretrying each step.","operationId":"recover_stuck_minting_v2_ownership_recover_stuck_minting_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/ownership/recover-stuck-spine":{"post":{"tags":["v2 - Ownership"],"summary":"Recover Stuck Spine","description":"Retry onchain_publish_events stuck in status=\"staged\" for 10+ minutes.\n\nThese events were staged (Firestore doc written) but the on-chain\nJubJubPublishLedger.recordLaunch() tx was never submitted — typically\nbecause the Cloud Run container was terminated mid-task.\n\nDesigned to be called by Cloud Scheduler every 10 minutes (same\ncadence as recover-stuck-minting).","operationId":"recover_stuck_spine_v2_ownership_recover_stuck_spine_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/catalogue/{catalogue_id}/proposals/accept":{"post":{"tags":["v2 - Catalogue"],"summary":"Accept Proposal","description":"Accept a brand token proposal — transfers tokens to caller's wallet.","operationId":"accept_proposal_v2_catalogue__catalogue_id__proposals_accept_post","parameters":[{"name":"catalogue_id","in":"path","required":true,"schema":{"type":"string","title":"Catalogue Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/catalogue/{catalogue_id}/proposals/reject":{"post":{"tags":["v2 - Catalogue"],"summary":"Reject Proposal","description":"Reject a brand token proposal — redistributes bp to remaining members.","operationId":"reject_proposal_v2_catalogue__catalogue_id__proposals_reject_post","parameters":[{"name":"catalogue_id","in":"path","required":true,"schema":{"type":"string","title":"Catalogue Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/catalogue/{catalogue_id}/proposals":{"get":{"tags":["v2 - Catalogue"],"summary":"Get Proposals","description":"Get full allocation state with per-member status. Team members only.","operationId":"get_proposals_v2_catalogue__catalogue_id__proposals_get","parameters":[{"name":"catalogue_id","in":"path","required":true,"schema":{"type":"string","title":"Catalogue Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/catalogue/{catalogue_id}/proposals/repropose":{"post":{"tags":["v2 - Catalogue"],"summary":"Repropose","description":"Modify splits and re-notify — creates a new version.","operationId":"repropose_v2_catalogue__catalogue_id__proposals_repropose_post","parameters":[{"name":"catalogue_id","in":"path","required":true,"schema":{"type":"string","title":"Catalogue Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReproposeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/catalogue/{team_id}/harvest/{content_contract_address}":{"get":{"tags":["v2 - Catalogue"],"summary":"Harvest Status","description":"Read-only status for a content contract's harvest path.\n\nReturns whether auto-forward is enabled (content.catalogueAddress is\nset) and how much USDC is currently pending to be swept to the\ncatalogue on the next router.settle(). This endpoint does NOT write\nto chain — harvest via claimFor() would orphan funds because the\ncatalogue's notifyDistribution is onlyRegisteredContent.\n\nAuth: team owner only.","operationId":"harvest_status_v2_catalogue__team_id__harvest__content_contract_address__get","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"content_contract_address","in":"path","required":true,"schema":{"type":"string","title":"Content Contract Address"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/catalogue/{catalogue_id}/holdings":{"get":{"tags":["v2 - Catalogue"],"summary":"Get Holdings","description":"Get content contracts held, revenue, and brand token distribution.\nTeam members only.","operationId":"get_holdings_v2_catalogue__catalogue_id__holdings_get","parameters":[{"name":"catalogue_id","in":"path","required":true,"schema":{"type":"string","title":"Catalogue Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoldingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/catalogue/cron/ensure-holders-minted":{"post":{"tags":["v2 - Catalogue"],"summary":"Cron Ensure Holders Minted","description":"Mint any brand-token holder that is still missing, across every\ncatalogue we know about.\n\nTHE BACKSTOP, not the primary mechanism. Minting is ensured at catalogue\ndeploy, on the already-deployed path, and immediately before\nregisterContent — all three inside the window where no revenue can yet have\narrived. This pass exists because that used to be a single fire-and-forget\nside effect of deploy whose one transient failure was permanent and\ninvisible: eight of nine mainnet catalogues had never minted a holder, two\nof them while actively earning.\n\nCheap and safe to run often: a fully-minted catalogue costs one hasMinted\nview call per split and sends no transaction. Catalogues with no code on the\nactive chain are reported, never minted into.\n\nDeploy as a Cloud Scheduler job (suggested: hourly) once verified.","operationId":"cron_ensure_holders_minted_v2_catalogue_cron_ensure_holders_minted_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v2/wallet/unified-balance":{"get":{"tags":["v2 - Wallet"],"summary":"Get Unified Balance","description":"Aggregate the user's spendable USDC: smart wallet balance + every\ncatalogue's claimable amount. Used by the frontend to render a single\nbalance number and to drive silent auto-claim before a spend.","operationId":"get_unified_balance_v2_wallet_unified_balance_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnifiedBalanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/wallet/streaming-earnings":{"get":{"tags":["v2 - Wallet"],"summary":"Get Streaming Earnings","description":"Net-to-creator STREAMING earnings for today and the last 30 days.\n\nStreaming-only approximation: aggregates streaming_sessions_v2 gross\nsettled USDC, attributes the creator's ownership share, and subtracts\nthe 3% platform fee. Excludes catalogue/licensing/x402 revenue.\n\nNever raises on the no-data path — a creator with no streaming\nsessions gets zeros, and any unexpected read failure degrades to\nzeros (logged) so the wallet hero never breaks on a non-critical stat.","operationId":"get_streaming_earnings_v2_wallet_streaming_earnings_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}},{"name":"X-JubJub-Service-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Service-Key"}},{"name":"X-JubJub-Agent-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Agent-Key"}},{"name":"X-JubJub-Platform-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Platform-Key"}},{"name":"Origin","in":"header","required":false,"schema":{"type":"string","title":"Origin"}},{"name":"Referer","in":"header","required":false,"schema":{"type":"string","title":"Referer"}},{"name":"X-JubJub-Trial-Token","in":"header","required":false,"schema":{"type":"string","title":"X-Jubjub-Trial-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StreamingEarningsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/platform/register-content":{"post":{"tags":["v2 - SDK"],"summary":"Register Content","description":"Register content via platform API key.\n\nFull orchestration: resolve/create profile -> resolve/create workspace\n-> fingerprint the file at media_url (streamed, never stored) -> create\ncontent doc with the developer's URL as its playback source (triggers\nownership deployment in background) -> optional spine entry.\n\nJubJub holds no bytes for the piece. The page's own