{"openapi":"3.1.0","info":{"title":"ChatterBeam Agent API","version":"2026-09-03","description":"Versioned social-listening capabilities shared with the MCP catalog."},"servers":[{"url":"https://chatterbeam.com/api/v1"}],"security":[{"bearerAuth":[]}],"paths":{"/projects":{"get":{"operationId":"list_projects","summary":"list projects","parameters":[],"security":[{"bearerAuth":["projects:read"]}],"x-capability":"list_projects","x-required-scope":"projects:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"post":{"operationId":"create_project","summary":"create project","parameters":[],"security":[{"bearerAuth":["projects:write"]}],"x-capability":"create_project","x-required-scope":"projects:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/projects/archived":{"get":{"operationId":"list_archived_projects","summary":"list archived projects","parameters":[],"security":[{"bearerAuth":["projects:read"]}],"x-capability":"list_archived_projects","x-required-scope":"projects:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/projects/{projectId}":{"get":{"operationId":"get_project","summary":"get project","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:read"]}],"x-capability":"get_project","x-required-scope":"projects:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"patch":{"operationId":"update_project","summary":"update project","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:write"]}],"x-capability":"update_project","x-required-scope":"projects:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"archive_project","summary":"archive project","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:write"]}],"x-capability":"archive_project","x-required-scope":"projects:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/projects/{projectId}/public-dashboard":{"get":{"operationId":"get_public_dashboard","summary":"get public dashboard","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:read"]}],"x-capability":"get_public_dashboard","x-required-scope":"projects:read","x-rate-class":"read","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"patch":{"operationId":"set_public_dashboard","summary":"set public dashboard","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:write"]}],"x-capability":"set_public_dashboard","x-required-scope":"projects:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/projects/{projectId}/restore":{"post":{"operationId":"restore_project","summary":"restore project","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:write"]}],"x-capability":"restore_project","x-required-scope":"projects:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/projects/{projectId}/members":{"get":{"operationId":"list_project_members","summary":"list project members","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:read"]}],"x-capability":"list_project_members","x-required-scope":"projects:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"post":{"operationId":"invite_project_member","summary":"invite project member","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:write"]}],"x-capability":"invite_project_member","x-required-scope":"projects:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/projects/{projectId}/members/{memberId}":{"patch":{"operationId":"update_project_member","summary":"update project member","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:write"]}],"x-capability":"update_project_member","x-required-scope":"projects:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"remove_project_member","summary":"remove project member","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["projects:write"]}],"x-capability":"remove_project_member","x-required-scope":"projects:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/keyword-groups":{"get":{"operationId":"list_keyword_groups","summary":"list keyword groups","parameters":[],"security":[{"bearerAuth":["keywords:read"]}],"x-capability":"list_keyword_groups","x-required-scope":"keywords:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"post":{"operationId":"create_keyword_group","summary":"create keyword group","parameters":[],"security":[{"bearerAuth":["keywords:write"]}],"x-capability":"create_keyword_group","x-required-scope":"keywords:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/keyword-groups/{groupId}":{"patch":{"operationId":"update_keyword_group","summary":"update keyword group","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["keywords:write"]}],"x-capability":"update_keyword_group","x-required-scope":"keywords:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"delete_keyword_group","summary":"delete keyword group","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["keywords:write"]}],"x-capability":"delete_keyword_group","x-required-scope":"keywords:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/keywords":{"get":{"operationId":"list_keywords","summary":"list keywords","parameters":[],"security":[{"bearerAuth":["keywords:read"]}],"x-capability":"list_keywords","x-required-scope":"keywords:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"post":{"operationId":"create_keyword","summary":"create keyword","parameters":[],"security":[{"bearerAuth":["keywords:write"]}],"x-capability":"create_keyword","x-required-scope":"keywords:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/keywords/{keywordId}":{"patch":{"operationId":"update_keyword","summary":"update keyword","parameters":[{"name":"keywordId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["keywords:write"]}],"x-capability":"update_keyword","x-required-scope":"keywords:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"delete_keyword","summary":"delete keyword","parameters":[{"name":"keywordId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["keywords:write"]}],"x-capability":"delete_keyword","x-required-scope":"keywords:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/scans":{"get":{"operationId":"list_scan_runs","summary":"list scan runs","parameters":[],"security":[{"bearerAuth":["keywords:read"]}],"x-capability":"list_scan_runs","x-required-scope":"keywords:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"post":{"operationId":"scan_project","summary":"scan project","parameters":[],"security":[{"bearerAuth":["keywords:write"]}],"x-capability":"scan_project","x-required-scope":"keywords:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/mention-authors":{"get":{"operationId":"search_mention_authors","summary":"search mention authors","parameters":[{"name":"projectId","in":"query","required":true,"description":"Accessible project identifier","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Case-insensitive author name or handle search","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum suggestions, from 1 to 100","schema":{"type":"integer"}}],"security":[{"bearerAuth":["mentions:read"]}],"x-capability":"search_mention_authors","x-required-scope":"mentions:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/mentions":{"get":{"operationId":"list_mentions","summary":"list mentions","parameters":[{"name":"projectId","in":"query","required":true,"description":"Accessible project identifier","schema":{"type":"string"}},{"name":"source","in":"query","required":false,"description":"Legacy single-source filter","schema":{"type":"string"}},{"name":"sources","in":"query","required":false,"description":"Comma-separated source identifiers","schema":{"type":"string"}},{"name":"engagementRules","in":"query","required":false,"description":"Comma-separated source:metric:minimum rules","schema":{"type":"string"}},{"name":"fromSource","in":"query","required":false,"schema":{"type":"string"}},{"name":"fromHandle","in":"query","required":false,"schema":{"type":"string"}},{"name":"fromName","in":"query","required":false,"schema":{"type":"string"}},{"name":"fromProfileUrl","in":"query","required":false,"schema":{"type":"string"}},{"name":"keywordId","in":"query","required":false,"schema":{"type":"string"}},{"name":"keywordIds","in":"query","required":false,"description":"Comma-separated keyword identifiers","schema":{"type":"string"}},{"name":"keywordGroupIds","in":"query","required":false,"description":"Comma-separated keyword-group identifiers","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"sentiment","in":"query","required":false,"schema":{"type":"string"}},{"name":"categoryId","in":"query","required":false,"schema":{"type":"string"}},{"name":"urgencyMin","in":"query","required":false,"schema":{"type":"integer"}},{"name":"urgencyMax","in":"query","required":false,"schema":{"type":"integer"}},{"name":"engagement","in":"query","required":false,"description":"Legacy total-engagement threshold","schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"dateFrom","in":"query","required":false,"description":"Inclusive ISO-8601 lower bound","schema":{"type":"string"}},{"name":"dateTo","in":"query","required":false,"description":"Inclusive ISO-8601 upper bound","schema":{"type":"string"}},{"name":"datePreset","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"security":[{"bearerAuth":["mentions:read"]}],"x-capability":"list_mentions","x-required-scope":"mentions:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/mentions/{mentionId}":{"get":{"operationId":"get_mention","summary":"get mention","parameters":[{"name":"mentionId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["mentions:read"]}],"x-capability":"get_mention","x-required-scope":"mentions:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"patch":{"operationId":"update_mention_status","summary":"update mention status","parameters":[{"name":"mentionId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["mentions:write"]}],"x-capability":"update_mention_status","x-required-scope":"mentions:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/mentions/{mentionId}/irrelevant":{"post":{"operationId":"mark_mention_irrelevant","summary":"mark mention irrelevant","parameters":[{"name":"mentionId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["mentions:write"]}],"x-capability":"mark_mention_irrelevant","x-required-scope":"mentions:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/analytics/mentions":{"get":{"operationId":"get_mention_analytics","summary":"get mention analytics","parameters":[{"name":"projectId","in":"query","required":true,"description":"Accessible project identifier","schema":{"type":"string"}},{"name":"source","in":"query","required":false,"description":"Legacy single-source filter","schema":{"type":"string"}},{"name":"sources","in":"query","required":false,"description":"Comma-separated source identifiers","schema":{"type":"string"}},{"name":"engagementRules","in":"query","required":false,"description":"Comma-separated source:metric:minimum rules","schema":{"type":"string"}},{"name":"fromSource","in":"query","required":false,"schema":{"type":"string"}},{"name":"fromHandle","in":"query","required":false,"schema":{"type":"string"}},{"name":"fromName","in":"query","required":false,"schema":{"type":"string"}},{"name":"fromProfileUrl","in":"query","required":false,"schema":{"type":"string"}},{"name":"keywordId","in":"query","required":false,"schema":{"type":"string"}},{"name":"keywordIds","in":"query","required":false,"description":"Comma-separated keyword identifiers","schema":{"type":"string"}},{"name":"keywordGroupIds","in":"query","required":false,"description":"Comma-separated keyword-group identifiers","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"sentiment","in":"query","required":false,"schema":{"type":"string"}},{"name":"categoryId","in":"query","required":false,"schema":{"type":"string"}},{"name":"urgencyMin","in":"query","required":false,"schema":{"type":"integer"}},{"name":"urgencyMax","in":"query","required":false,"schema":{"type":"integer"}},{"name":"engagement","in":"query","required":false,"description":"Legacy total-engagement threshold","schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"dateFrom","in":"query","required":false,"description":"Inclusive ISO-8601 lower bound","schema":{"type":"string"}},{"name":"dateTo","in":"query","required":false,"description":"Inclusive ISO-8601 upper bound","schema":{"type":"string"}},{"name":"datePreset","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"security":[{"bearerAuth":["mentions:read"]}],"x-capability":"get_mention_analytics","x-required-scope":"mentions:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/categories":{"get":{"operationId":"list_categories","summary":"list categories","parameters":[],"security":[{"bearerAuth":["mentions:read"]}],"x-capability":"list_categories","x-required-scope":"mentions:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"post":{"operationId":"create_category","summary":"create category","parameters":[],"security":[{"bearerAuth":["mentions:write"]}],"x-capability":"create_category","x-required-scope":"mentions:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/categories/{categoryId}":{"patch":{"operationId":"update_category","summary":"update category","parameters":[{"name":"categoryId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["mentions:write"]}],"x-capability":"update_category","x-required-scope":"mentions:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"delete_category","summary":"delete category","parameters":[{"name":"categoryId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["mentions:write"]}],"x-capability":"delete_category","x-required-scope":"mentions:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/mention-views":{"get":{"operationId":"list_mention_views","summary":"list mention views","parameters":[],"security":[{"bearerAuth":["mentions:read"]}],"x-capability":"list_mention_views","x-required-scope":"mentions:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"post":{"operationId":"create_mention_view","summary":"create mention view","parameters":[],"security":[{"bearerAuth":["mentions:write"]}],"x-capability":"create_mention_view","x-required-scope":"mentions:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/mention-views/{viewId}":{"patch":{"operationId":"update_mention_view","summary":"update mention view","parameters":[{"name":"viewId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["mentions:write"]}],"x-capability":"update_mention_view","x-required-scope":"mentions:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"delete_mention_view","summary":"delete mention view","parameters":[{"name":"viewId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["mentions:write"]}],"x-capability":"delete_mention_view","x-required-scope":"mentions:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/alerts":{"get":{"operationId":"list_alerts","summary":"list alerts","parameters":[],"security":[{"bearerAuth":["alerts:read"]}],"x-capability":"list_alerts","x-required-scope":"alerts:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"post":{"operationId":"create_alert","summary":"create alert","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"filters":{"type":"object","additionalProperties":true,"description":"YouTube mentions use exact source data; derived category, sentiment and urgency constraints apply only to other platforms. Source, author, keyword and engagement constraints still apply to YouTube.","properties":{"engagementBySource":{"type":"object","additionalProperties":false,"description":"Independent platform thresholds. Unspecified platforms have no engagement restriction. Legacy engagementMin remains an additional shared constraint.","properties":{"x":{"type":"object","additionalProperties":false,"properties":{"likes":{"type":"integer","minimum":0,"maximum":9007199254740991},"replies":{"type":"integer","minimum":0,"maximum":9007199254740991},"reposts":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"reddit":{"type":"object","additionalProperties":false,"properties":{"likes":{"type":"integer","minimum":0,"maximum":9007199254740991},"replies":{"type":"integer","minimum":0,"maximum":9007199254740991},"reposts":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"youtube":{"type":"object","additionalProperties":false,"properties":{"likes":{"type":"integer","minimum":0,"maximum":9007199254740991},"replies":{"type":"integer","minimum":0,"maximum":9007199254740991},"reposts":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"linkedin":{"type":"object","additionalProperties":false,"properties":{"likes":{"type":"integer","minimum":0,"maximum":9007199254740991},"replies":{"type":"integer","minimum":0,"maximum":9007199254740991},"reposts":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}}}}}}}}},"parameters":[],"security":[{"bearerAuth":["alerts:write"]}],"x-capability":"create_alert","x-required-scope":"alerts:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/alerts/{alertId}":{"patch":{"operationId":"update_alert","summary":"update alert","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"filters":{"type":"object","additionalProperties":true,"description":"YouTube mentions use exact source data; derived category, sentiment and urgency constraints apply only to other platforms. Source, author, keyword and engagement constraints still apply to YouTube.","properties":{"engagementBySource":{"type":"object","additionalProperties":false,"description":"Independent platform thresholds. Unspecified platforms have no engagement restriction. Legacy engagementMin remains an additional shared constraint.","properties":{"x":{"type":"object","additionalProperties":false,"properties":{"likes":{"type":"integer","minimum":0,"maximum":9007199254740991},"replies":{"type":"integer","minimum":0,"maximum":9007199254740991},"reposts":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"reddit":{"type":"object","additionalProperties":false,"properties":{"likes":{"type":"integer","minimum":0,"maximum":9007199254740991},"replies":{"type":"integer","minimum":0,"maximum":9007199254740991},"reposts":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"youtube":{"type":"object","additionalProperties":false,"properties":{"likes":{"type":"integer","minimum":0,"maximum":9007199254740991},"replies":{"type":"integer","minimum":0,"maximum":9007199254740991},"reposts":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"linkedin":{"type":"object","additionalProperties":false,"properties":{"likes":{"type":"integer","minimum":0,"maximum":9007199254740991},"replies":{"type":"integer","minimum":0,"maximum":9007199254740991},"reposts":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"type":"integer","minimum":0,"maximum":9007199254740991}}}}}}}}}}}},"parameters":[{"name":"alertId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["alerts:write"]}],"x-capability":"update_alert","x-required-scope":"alerts:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"delete_alert","summary":"delete alert","parameters":[{"name":"alertId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["alerts:write"]}],"x-capability":"delete_alert","x-required-scope":"alerts:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/alerts/{alertId}/test":{"post":{"operationId":"test_alert","summary":"test alert","parameters":[{"name":"alertId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["alerts:write"]}],"x-capability":"test_alert","x-required-scope":"alerts:write","x-rate-class":"write","x-minimum-role":"editor","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/integrations/providers":{"get":{"operationId":"list_provider_integrations","summary":"list provider integrations","parameters":[],"security":[{"bearerAuth":["integrations:read"]}],"x-capability":"list_provider_integrations","x-required-scope":"integrations:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/integrations/providers/{providerId}":{"put":{"operationId":"save_provider_integration","summary":"save provider integration","parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["integrations:write"]}],"x-capability":"save_provider_integration","x-required-scope":"integrations:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"delete_provider_integration","summary":"delete provider integration","parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["integrations:write"]}],"x-capability":"delete_provider_integration","x-required-scope":"integrations:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/integrations/providers/{providerId}/test":{"post":{"operationId":"test_provider_integration","summary":"test provider integration","parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["integrations:write"]}],"x-capability":"test_provider_integration","x-required-scope":"integrations:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/integrations/linkedin":{"get":{"operationId":"get_linkedin_integration","summary":"get linkedin integration","parameters":[],"security":[{"bearerAuth":["integrations:read"]}],"x-capability":"get_linkedin_integration","x-required-scope":"integrations:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"patch":{"operationId":"select_linkedin_page","summary":"select linkedin page","parameters":[],"security":[{"bearerAuth":["integrations:write"]}],"x-capability":"select_linkedin_page","x-required-scope":"integrations:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"disconnect_linkedin","summary":"disconnect linkedin","parameters":[],"security":[{"bearerAuth":["integrations:write"]}],"x-capability":"disconnect_linkedin","x-required-scope":"integrations:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/integrations/linkedin/connect-url":{"post":{"operationId":"get_linkedin_connect_url","summary":"get linkedin connect url","parameters":[],"security":[{"bearerAuth":["integrations:write"]}],"x-capability":"get_linkedin_connect_url","x-required-scope":"integrations:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/integrations/linkedin/sync":{"post":{"operationId":"sync_linkedin","summary":"sync linkedin","parameters":[],"security":[{"bearerAuth":["integrations:write"]}],"x-capability":"sync_linkedin","x-required-scope":"integrations:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/account":{"get":{"operationId":"get_account","summary":"get account","parameters":[],"security":[{"bearerAuth":["account:read"]}],"x-capability":"get_account","x-required-scope":"account:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"patch":{"operationId":"update_account","summary":"update account","parameters":[],"security":[{"bearerAuth":["account:write"]}],"x-capability":"update_account","x-required-scope":"account:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"delete_account","summary":"delete account","parameters":[],"security":[{"bearerAuth":["account:write"]}],"x-capability":"delete_account","x-required-scope":"account:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/usage":{"get":{"operationId":"get_usage","summary":"get usage","parameters":[],"security":[{"bearerAuth":["usage:read"]}],"x-capability":"get_usage","x-required-scope":"usage:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/webhooks":{"get":{"operationId":"list_webhooks","summary":"list webhooks","parameters":[],"security":[{"bearerAuth":["webhooks:read"]}],"x-capability":"list_webhooks","x-required-scope":"webhooks:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"post":{"operationId":"create_webhook","summary":"create webhook","parameters":[],"security":[{"bearerAuth":["webhooks:write"]}],"x-capability":"create_webhook","x-required-scope":"webhooks:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/webhooks/{endpointId}":{"patch":{"operationId":"update_webhook","summary":"update webhook","parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["webhooks:write"]}],"x-capability":"update_webhook","x-required-scope":"webhooks:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"delete":{"operationId":"delete_webhook","summary":"delete webhook","parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["webhooks:write"]}],"x-capability":"delete_webhook","x-required-scope":"webhooks:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/webhooks/{endpointId}/test":{"post":{"operationId":"test_webhook","summary":"test webhook","parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["webhooks:write"]}],"x-capability":"test_webhook","x-required-scope":"webhooks:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/webhooks/{endpointId}/deliveries":{"get":{"operationId":"list_webhook_deliveries","summary":"list webhook deliveries","parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["webhooks:read"]}],"x-capability":"list_webhook_deliveries","x-required-scope":"webhooks:read","x-rate-class":"read","x-minimum-role":"viewer","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/webhooks/{endpointId}/deliveries/{deliveryId}/replay":{"post":{"operationId":"replay_webhook_delivery","summary":"replay webhook delivery","parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string"}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["webhooks:write"]}],"x-capability":"replay_webhook_delivery","x-required-scope":"webhooks:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/billing":{"get":{"operationId":"get_billing","summary":"get billing","parameters":[],"security":[{"bearerAuth":["account:read"]}],"x-capability":"get_billing","x-required-scope":"account:read","x-rate-class":"read","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/billing/checkout":{"post":{"operationId":"create_subscription_checkout","summary":"create subscription checkout","parameters":[],"security":[{"bearerAuth":["account:write"]}],"x-capability":"create_subscription_checkout","x-required-scope":"account:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/billing/portal":{"post":{"operationId":"create_billing_portal","summary":"create billing portal","parameters":[],"security":[{"bearerAuth":["account:write"]}],"x-capability":"create_billing_portal","x-required-scope":"account:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/retention/run":{"post":{"operationId":"enforce_retention","summary":"enforce retention","parameters":[],"security":[{"bearerAuth":["account:write"]}],"x-capability":"enforce_retention","x-required-scope":"account:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/developer/keys":{"post":{"operationId":"create_api_key","summary":"create api key","parameters":[],"security":[{"bearerAuth":["account:write"]}],"x-capability":"create_api_key","x-required-scope":"account:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}},"get":{"operationId":"list_api_keys","summary":"list api keys","parameters":[],"security":[{"bearerAuth":["account:read"]}],"x-capability":"list_api_keys","x-required-scope":"account:read","x-rate-class":"read","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/developer/keys/{keyId}":{"delete":{"operationId":"revoke_api_key","summary":"revoke api key","parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["account:write"]}],"x-capability":"revoke_api_key","x-required-scope":"account:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/oauth-connections":{"get":{"operationId":"list_oauth_connections","summary":"list oauth connections","parameters":[],"security":[{"bearerAuth":["account:read"]}],"x-capability":"list_oauth_connections","x-required-scope":"account:read","x-rate-class":"read","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/oauth-connections/{connectionId}":{"delete":{"operationId":"revoke_oauth_connection","summary":"revoke oauth connection","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearerAuth":["account:write"]}],"x-capability":"revoke_oauth_connection","x-required-scope":"account:write","x-rate-class":"write","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}},"/audit-logs":{"get":{"operationId":"list_audit_logs","summary":"list audit logs","parameters":[],"security":[{"bearerAuth":["account:read"]}],"x-capability":"list_audit_logs","x-required-scope":"account:read","x-rate-class":"read","x-minimum-role":"owner","responses":{"200":{"description":"Successful capability response"},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"403":{"description":"Scope or role denied"},"404":{"description":"Resource not found or inaccessible"},"409":{"description":"Conflict or idempotency mismatch"},"429":{"description":"Rate or resource limit exceeded"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"ChatterBeam API key or OAuth access token"}}}}