{"openapi":"3.1.0","info":{"title":"tracevero Automation API","version":"2026-09-08.1","description":"Task planning from documented API operations. Optional private monitoring uses project bearer keys; see /v2/monitoring/openapi.json. Provider operations run locally. /v1 remains supported."},"servers":[{"url":"https://api.tracevero.com/v2"}],"paths":{"/capabilities":{"get":{"operationId":"find_capabilities","summary":"find capabilities","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"capabilities":{"type":"array","items":{}},"total":{"type":"number"},"offset":{"type":"number"},"next_offset":{"type":["number","null"]},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["capabilities","total","offset","next_offset","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":500,"default":""}},{"name":"capabilities","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["email.search","email.read","attachment.download","email.draft.create","email.send","file.search","file.read","file.upload","file.update","file.delete","calendar.event.search","calendar.event.read","calendar.event.create","calendar.event.update","calendar.availability.read","spreadsheet.create","spreadsheet.rows.read","spreadsheet.rows.append","spreadsheet.rows.update","spreadsheet.rows.clear","issue.search","issue.read","issue.create","release.search","repository.read","document.classify","document.amount.extract","datetime.extract","meeting.tasks.extract","task.assignee.resolve","task.create","order.read","customer.resolve","product.match","erp.record.create","source.search","source.fetch","evidence.link"]},"maxItems":40,"default":[]},"style":"form","explode":false},{"name":"apps","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["gmail","google-drive","google-calendar","google-sheets","outlook","onedrive","microsoft-calendar","excel","dropbox","github"]},"maxItems":10,"default":[]},"style":"form","explode":false},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}}]}},"/workflows/plan":{"post":{"operationId":"plan_workflow","summary":"plan workflow","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"task":{"anyOf":[{},{"type":"null"}]},"steps":{"type":"array","items":{}},"coverage":{"type":"object","properties":{"documented":{"type":"number"},"required":{"type":"number"},"practically_tested":{"type":"number"}},"required":["documented","required","practically_tested"],"additionalProperties":false},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["status","steps","coverage","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","enum":["file-invoices","invoice-amounts","email-calendar","meeting-tasks","orders-erp","save-research","gmail-attachments-drive","outlook-attachments-onedrive","gmail-attachments-dropbox","outlook-attachments-drive","gmail-find","outlook-find","gmail-read","outlook-read","gmail-draft","outlook-draft","gmail-send","outlook-send","drive-search","onedrive-search","dropbox-search","drive-upload","onedrive-upload","dropbox-upload","drive-to-onedrive","dropbox-to-drive","drive-to-dropbox","onedrive-to-dropbox","google-events","microsoft-events","google-event-create","microsoft-event-create","google-availability","microsoft-availability","google-event-update","microsoft-event-update","sheets-append","excel-append","sheets-read","excel-read","sheets-update","excel-update","sheets-to-excel","excel-to-sheets","sheets-create","github-issues","github-issue-read","github-issue-create","github-releases","github-issues-sheet"]},"query":{"type":"string","maxLength":500,"default":""},"apps":{"type":"array","items":{"type":"string","enum":["gmail","google-drive","google-calendar","google-sheets","outlook","onedrive","microsoft-calendar","excel","dropbox","github"]},"maxItems":10,"default":[]},"read_only":{"type":"boolean","default":false},"runtime":{"type":"string","enum":["any","local","remote"],"default":"any"},"granted_scopes":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":50,"default":[]},"evidence":{"type":"boolean","default":false}},"additionalProperties":false}}}}}},"/connections/{type}/{slug}":{"get":{"operationId":"get_connection_options","summary":"get connection options","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"connections":{"type":"array","items":{}},"connection_rule_version":{"type":"string"},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["id","connections","connection_rule_version","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["de","en"],"default":"en"}},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["mcp","agenten"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}}]}},"/verifications/{type}/{slug}":{"get":{"operationId":"get_verification","summary":"get verification","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"connections":{"type":"array","items":{}},"levels":{"type":"array","items":{"type":"string"}},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["id","connections","levels","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["de","en"],"default":"en"}},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["mcp","agenten"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"}}]}},"/compatibility/check":{"post":{"operationId":"check_compatibility","summary":"check compatibility","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"client":{"type":"string"},"status":{"type":"string"},"execution_tested":{"type":"boolean"},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["id","client","status","execution_tested","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","maxLength":240,"pattern":"^(mcp|agenten)\\/[a-z0-9][a-z0-9-]*$"},"client":{"type":"string","maxLength":40},"connection":{"type":"string","maxLength":40,"default":"auto"},"locale":{"type":"string","enum":["de","en"],"default":"en"}},"required":["id","client"],"additionalProperties":false}}}}}},"/permissions/explain":{"post":{"operationId":"explain_permissions","summary":"explain permissions","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"task":{"anyOf":[{},{"type":"null"}]},"status":{"type":"string"},"steps":{"type":"array","items":{}},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["status","steps","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","enum":["file-invoices","invoice-amounts","email-calendar","meeting-tasks","orders-erp","save-research","gmail-attachments-drive","outlook-attachments-onedrive","gmail-attachments-dropbox","outlook-attachments-drive","gmail-find","outlook-find","gmail-read","outlook-read","gmail-draft","outlook-draft","gmail-send","outlook-send","drive-search","onedrive-search","dropbox-search","drive-upload","onedrive-upload","dropbox-upload","drive-to-onedrive","dropbox-to-drive","drive-to-dropbox","onedrive-to-dropbox","google-events","microsoft-events","google-event-create","microsoft-event-create","google-availability","microsoft-availability","google-event-update","microsoft-event-update","sheets-append","excel-append","sheets-read","excel-read","sheets-update","excel-update","sheets-to-excel","excel-to-sheets","sheets-create","github-issues","github-issue-read","github-issue-create","github-releases","github-issues-sheet"]},"query":{"type":"string","maxLength":500,"default":""},"apps":{"type":"array","items":{"type":"string","enum":["gmail","google-drive","google-calendar","google-sheets","outlook","onedrive","microsoft-calendar","excel","dropbox","github"]},"maxItems":10,"default":[]},"read_only":{"type":"boolean","default":false},"runtime":{"type":"string","enum":["any","local","remote"],"default":"any"},"granted_scopes":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":50,"default":[]},"evidence":{"type":"boolean","default":false}},"additionalProperties":false}}}}}},"/config/validate":{"post":{"operationId":"validate_config","summary":"validate config","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"path":{"type":"string"},"message":{"type":"string"}},"required":["code","path","message"],"additionalProperties":false}},"corrected_config":{"anyOf":[{},{"type":"null"}]},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["status","issues","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"config":{"anyOf":[{"type":"string","maxLength":24000},{"type":"object","additionalProperties":{}}]},"client":{"type":"string","maxLength":40}},"required":["config","client"],"additionalProperties":false}}}}}},"/configure":{"post":{"operationId":"configure","summary":"configure","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"connection":{"anyOf":[{},{"type":"null"}]},"template":{"anyOf":[{},{"type":"null"}]},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["status","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","maxLength":240,"pattern":"^(mcp|agenten)\\/[a-z0-9][a-z0-9-]*$"},"client":{"type":"string","maxLength":40},"connection":{"type":"string","maxLength":40,"default":"auto"},"locale":{"type":"string","enum":["de","en"],"default":"en"}},"required":["id","client"],"additionalProperties":false}}}}}},"/capability-gaps":{"get":{"operationId":"get_capability_gaps","summary":"get capability gaps","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"app":{"type":"string"},"capabilities":{"type":"array","items":{}},"connector_inventory":{},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["app","capabilities","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"parameters":[{"name":"app","in":"query","required":true,"schema":{"type":"string","enum":["gmail","google-drive","google-calendar","google-sheets","outlook","onedrive","microsoft-calendar","excel","dropbox","github"]}},{"name":"capabilities","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["email.search","email.read","attachment.download","email.draft.create","email.send","file.search","file.read","file.upload","file.update","file.delete","calendar.event.search","calendar.event.read","calendar.event.create","calendar.event.update","calendar.availability.read","spreadsheet.create","spreadsheet.rows.read","spreadsheet.rows.append","spreadsheet.rows.update","spreadsheet.rows.clear","issue.search","issue.read","issue.create","release.search","repository.read","document.classify","document.amount.extract","datetime.extract","meeting.tasks.extract","task.assignee.resolve","task.create","order.read","customer.resolve","product.match","erp.record.create","source.search","source.fetch","evidence.link"]},"maxItems":40,"default":[]},"style":"form","explode":false}]}},"/changes/impact":{"post":{"operationId":"get_change_impact","summary":"get change impact","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"changes":{"type":"array","items":{}},"checked_operations":{"type":"number"},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["status","changes","checked_operations","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"snapshot":{"type":"object","properties":{"format":{"type":"string","const":"tracevero-workflow/1"},"read_only":{"type":"boolean"},"runtime":{"type":"string","enum":["any","local","remote"]},"catalog_version":{"type":"string","maxLength":80},"rule_version":{"type":"string","maxLength":80},"task_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}]},"apps":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":10},"operations":{"type":"array","items":{"type":"object","properties":{"app":{"type":"string","maxLength":80},"operation":{"type":"string","maxLength":200},"capability":{"type":"string","maxLength":100},"scope_alternatives":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":200},"maxItems":50},{"type":"null"}]},"source_revision":{"type":"string","maxLength":100},"source_hash":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]}},"required":["app","operation","capability","scope_alternatives","source_hash"],"additionalProperties":false},"maxItems":200}},"required":["format","catalog_version","rule_version","task_id","apps","operations"],"additionalProperties":false}},"required":["snapshot"],"additionalProperties":false}}}}}},"/replacements":{"get":{"operationId":"find_replacement","summary":"find replacement","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"required":{"type":"array","items":{"type":"string"}},"alternatives":{"type":"array","items":{}},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["source","required","alternatives","dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"parameters":[{"name":"app","in":"query","required":true,"schema":{"type":"string","enum":["gmail","google-drive","google-calendar","google-sheets","outlook","onedrive","microsoft-calendar","excel","dropbox","github"]}},{"name":"capabilities","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["email.search","email.read","attachment.download","email.draft.create","email.send","file.search","file.read","file.upload","file.update","file.delete","calendar.event.search","calendar.event.read","calendar.event.create","calendar.event.update","calendar.availability.read","spreadsheet.create","spreadsheet.rows.read","spreadsheet.rows.append","spreadsheet.rows.update","spreadsheet.rows.clear","issue.search","issue.read","issue.create","release.search","repository.read","document.classify","document.amount.extract","datetime.extract","meeting.tasks.extract","task.assignee.resolve","task.create","order.read","customer.resolve","product.match","erp.record.create","source.search","source.fetch","evidence.link"]},"maxItems":40,"default":[]},"style":"form","explode":false},{"name":"read_only","in":"query","required":false,"schema":{"type":"boolean","default":false}}]}},"/workflows/snapshot":{"post":{"operationId":"snapshot","summary":"snapshot","responses":{"200":{"description":"Evidence-backed result. Unknown and untested states are explicit.","content":{"application/json":{"schema":{"type":"object","properties":{"snapshot":{},"dataset_version":{"type":"string"},"catalog_version":{"type":"string"},"rule_version":{"type":"string"}},"required":["dataset_version","catalog_version","rule_version"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"invalid_request or invalid_json"},"404":{"description":"entry_not_found"},"413":{"description":"request_too_large"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","enum":["file-invoices","invoice-amounts","email-calendar","meeting-tasks","orders-erp","save-research","gmail-attachments-drive","outlook-attachments-onedrive","gmail-attachments-dropbox","outlook-attachments-drive","gmail-find","outlook-find","gmail-read","outlook-read","gmail-draft","outlook-draft","gmail-send","outlook-send","drive-search","onedrive-search","dropbox-search","drive-upload","onedrive-upload","dropbox-upload","drive-to-onedrive","dropbox-to-drive","drive-to-dropbox","onedrive-to-dropbox","google-events","microsoft-events","google-event-create","microsoft-event-create","google-availability","microsoft-availability","google-event-update","microsoft-event-update","sheets-append","excel-append","sheets-read","excel-read","sheets-update","excel-update","sheets-to-excel","excel-to-sheets","sheets-create","github-issues","github-issue-read","github-issue-create","github-releases","github-issues-sheet"]},"query":{"type":"string","maxLength":500,"default":""},"apps":{"type":"array","items":{"type":"string","enum":["gmail","google-drive","google-calendar","google-sheets","outlook","onedrive","microsoft-calendar","excel","dropbox","github"]},"maxItems":10,"default":[]},"read_only":{"type":"boolean","default":false},"runtime":{"type":"string","enum":["any","local","remote"],"default":"any"},"granted_scopes":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":50,"default":[]},"evidence":{"type":"boolean","default":false}},"additionalProperties":false}}}}}},"/verification-reports/{id}":{"get":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dated test report with environment, assertions, limitations and observed tool input schemas."},"404":{"description":"report_not_found"}}}},"/":{"get":{"responses":{"200":{"description":"Versioned public catalog"}}}},"/tasks":{"get":{"responses":{"200":{"description":"Versioned public catalog"}}}},"/apps":{"get":{"responses":{"200":{"description":"Versioned public catalog"}}}},"/guides":{"get":{"responses":{"200":{"description":"Versioned public catalog"}}}}}}