{"openapi":"3.1.0","info":{"title":"Farside Research Public API","summary":"Supported Fathom research automation API","description":"Create, organize, inspect, and deliver cited research artifacts.","version":"1.0.0"},"servers":[{"url":"https://api.farsideresearch.com"}],"paths":{"/v1/runs":{"post":{"tags":["runs"],"summary":"Start Run","operationId":"start_run_v1_runs_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Start Run V1 Runs Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"},"get":{"tags":["runs"],"summary":"List Runs","operationId":"list_runs_v1_runs_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"active","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Active"}},{"name":"attention","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Attention"}},{"name":"include_total","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Total"}},{"name":"depth","in":"query","required":false,"schema":{"anyOf":[{"enum":["standard","deep"],"type":"string"},{"type":"null"}],"title":"Depth"}},{"name":"research_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Research Type"}},{"name":"namespace_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Namespace Id"}},{"name":"review_status","in":"query","required":false,"schema":{"anyOf":[{"enum":["unreviewed","in_review","changes_requested","approved"],"type":"string"},{"type":"null"}],"title":"Review Status"}},{"name":"monitor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Monitor Id"}},{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Q"}},{"name":"created_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created After"}},{"name":"created_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created Before"}},{"name":"deleted","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Deleted"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Runs V1 Runs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}":{"get":{"tags":["runs"],"summary":"Get Run","operationId":"get_run_v1_runs__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"const":"sources","type":"string"},{"type":"null"}],"title":"Include"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Run V1 Runs  Run Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"delete":{"tags":["runs"],"summary":"Delete Run","operationId":"delete_run_v1_runs__run_id__delete","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/cancel":{"post":{"tags":["runs"],"summary":"Cancel Run","operationId":"cancel_run_v1_runs__run_id__cancel_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cancel Run V1 Runs  Run Id  Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/deletion-impact":{"get":{"tags":["runs"],"summary":"Get Deletion Impact","operationId":"get_deletion_impact_v1_runs__run_id__deletion_impact_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletionImpactResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/recover":{"post":{"tags":["runs"],"summary":"Recover Run","operationId":"recover_run_v1_runs__run_id__recover_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Recover Run V1 Runs  Run Id  Recover Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/clarify":{"get":{"tags":["runs"],"summary":"Get Clarifying","operationId":"get_clarifying_v1_runs__run_id__clarify_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Clarifying V1 Runs  Run Id  Clarify Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"post":{"tags":["runs"],"summary":"Answer Clarifying","operationId":"answer_clarifying_v1_runs__run_id__clarify_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClarifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Answer Clarifying V1 Runs  Run Id  Clarify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/estimate":{"post":{"tags":["runs"],"summary":"Estimate","operationId":"estimate_v1_estimate_post","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/clarify":{"post":{"tags":["runs"],"summary":"Preview Clarifying Questions","description":"Return the deterministic clarification form without creating or charging for a run.","operationId":"preview_clarifying_questions_v1_clarify_post","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Preview Clarifying Questions V1 Clarify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/events":{"get":{"tags":["runs"],"summary":"Run Events","operationId":"run_events_v1_runs__run_id__events_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"Last-Event-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last-Event-Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/sources":{"get":{"tags":["sources"],"summary":"List Sources","operationId":"list_sources_v1_runs__run_id__sources_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"min_quality","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"title":"Min Quality"}},{"name":"max_quality","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"title":"Max Quality"}},{"name":"min_relevance","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Min Relevance"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"cited","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Cited"}},{"name":"dropped","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dropped"}},{"name":"round","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Round"}},{"name":"rabbit_hole_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Rabbit Hole Id"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Q"}},{"name":"sort","in":"query","required":false,"schema":{"enum":["quality","relevance","discovered"],"type":"string","default":"quality","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Sources V1 Runs  Run Id  Sources Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/sources/{source_id}":{"get":{"tags":["sources"],"summary":"Get Source","operationId":"get_source_v1_runs__run_id__sources__source_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Source V1 Runs  Run Id  Sources  Source Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/ask":{"post":{"tags":["asks"],"summary":"Ask Run","operationId":"ask_run_v1_runs__run_id__ask_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"},"get":{"tags":["asks"],"summary":"List Asks","operationId":"list_asks_v1_runs__run_id__ask_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Asks V1 Runs  Run Id  Ask Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/namespaces":{"get":{"tags":["namespaces"],"summary":"List Namespaces","operationId":"list_namespaces_v1_namespaces_get","parameters":[{"name":"deleted","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Deleted"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamespaceListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"post":{"tags":["namespaces"],"summary":"Create Namespace","operationId":"create_namespace_v1_namespaces_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamespaceCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamespaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/namespaces/{namespace_id}":{"get":{"tags":["namespaces"],"summary":"Get Namespace","operationId":"get_namespace_v1_namespaces__namespace_id__get","parameters":[{"name":"namespace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Namespace Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamespaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"patch":{"tags":["namespaces"],"summary":"Patch Namespace","operationId":"patch_namespace_v1_namespaces__namespace_id__patch","parameters":[{"name":"namespace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Namespace Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamespacePatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamespaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"},"delete":{"tags":["namespaces"],"summary":"Delete Namespace","operationId":"delete_namespace_v1_namespaces__namespace_id__delete","parameters":[{"name":"namespace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Namespace Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/namespaces/{namespace_id}/recover":{"post":{"tags":["namespaces"],"summary":"Recover Namespace","operationId":"recover_namespace_v1_namespaces__namespace_id__recover_post","parameters":[{"name":"namespace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Namespace Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamespaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/tags":{"get":{"tags":["tags"],"summary":"List Tags","operationId":"list_tags_v1_tags_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Tags V1 Tags Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"post":{"tags":["tags"],"summary":"Create Tag","operationId":"create_tag_v1_tags_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Tag V1 Tags Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/tags/{tag_id}":{"patch":{"tags":["tags"],"summary":"Patch Tag","operationId":"patch_tag_v1_tags__tag_id__patch","parameters":[{"name":"tag_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Tag Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Patch Tag V1 Tags  Tag Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"},"delete":{"tags":["tags"],"summary":"Delete Tag","operationId":"delete_tag_v1_tags__tag_id__delete","parameters":[{"name":"tag_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Tag Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/tags/{tag_id}/merge":{"post":{"tags":["tags"],"summary":"Merge Tag","operationId":"merge_tag_v1_tags__tag_id__merge_post","parameters":[{"name":"tag_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Tag Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagMerge"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Merge Tag V1 Tags  Tag Id  Merge Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/tags/{tag_id}":{"post":{"tags":["tags"],"summary":"Add Run Tag","operationId":"add_run_tag_v1_runs__run_id__tags__tag_id__post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"tag_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Tag Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"},"delete":{"tags":["tags"],"summary":"Remove Run Tag","operationId":"remove_run_tag_v1_runs__run_id__tags__tag_id__delete","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"tag_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Tag Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/tags":{"get":{"tags":["tags"],"summary":"List Run Tags","operationId":"list_run_tags_v1_runs__run_id__tags_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunTagListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/share":{"post":{"tags":["shares"],"summary":"Create Share","operationId":"create_share_v1_runs__run_id__share_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Share V1 Runs  Run Id  Share Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"},"delete":{"tags":["shares"],"summary":"Revoke Shares","operationId":"revoke_shares_v1_runs__run_id__share_delete","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/webhooks":{"get":{"tags":["webhooks"],"summary":"List Webhooks","operationId":"list_webhooks_v1_webhooks_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Webhooks V1 Webhooks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"},"post":{"tags":["webhooks"],"summary":"Create Webhook","operationId":"create_webhook_v1_webhooks_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Webhook V1 Webhooks Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/webhooks/{webhook_id}":{"patch":{"tags":["webhooks"],"summary":"Patch Webhook","operationId":"patch_webhook_v1_webhooks__webhook_id__patch","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Patch Webhook V1 Webhooks  Webhook Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"},"delete":{"tags":["webhooks"],"summary":"Delete Webhook","operationId":"delete_webhook_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/webhooks/{webhook_id}/test":{"post":{"tags":["webhooks"],"summary":"Test Webhook","operationId":"test_webhook_v1_webhooks__webhook_id__test_post","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Test Webhook V1 Webhooks  Webhook Id  Test Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/webhooks/{webhook_id}/deliveries":{"get":{"tags":["webhooks"],"summary":"List Webhook Deliveries","operationId":"list_webhook_deliveries_v1_webhooks__webhook_id__deliveries_get","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Webhook Deliveries V1 Webhooks  Webhook Id  Deliveries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/replay":{"post":{"tags":["webhooks"],"summary":"Replay Webhook","operationId":"replay_webhook_v1_webhooks__webhook_id__deliveries__delivery_id__replay_post","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}},{"name":"delivery_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Delivery Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Replay Webhook V1 Webhooks  Webhook Id  Deliveries  Delivery Id  Replay Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/runs/{run_id}/export/{format_name}":{"get":{"tags":["exports"],"summary":"Export Run","operationId":"export_run_v1_runs__run_id__export__format_name__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"format_name","in":"path","required":true,"schema":{"type":"string","title":"Format Name"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/exports/{export_id}":{"get":{"tags":["exports"],"summary":"Get Export","operationId":"get_export_v1_exports__export_id__get","parameters":[{"name":"export_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Export Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Export V1 Exports  Export Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/attachments":{"post":{"tags":["attachments"],"summary":"Upload Attachment","operationId":"upload_attachment_v1_attachments_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_attachment_v1_attachments_post"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Attachment V1 Attachments Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/attachments/{attachment_id}":{"get":{"tags":["attachments"],"summary":"Get Attachment","operationId":"get_attachment_v1_attachments__attachment_id__get","parameters":[{"name":"attachment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Attachment Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Attachment V1 Attachments  Attachment Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"delete":{"tags":["attachments"],"summary":"Delete Attachment","operationId":"delete_attachment_v1_attachments__attachment_id__delete","parameters":[{"name":"attachment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Attachment Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/actions":{"get":{"tags":["actions"],"summary":"List Run Actions","operationId":"list_run_actions_v1_runs__run_id__actions_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"status_group","in":"query","required":false,"schema":{"anyOf":[{"enum":["active","terminal"],"type":"string"},{"type":"null"}],"title":"Status Group"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchActionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/actions/{action_id}":{"get":{"tags":["actions"],"summary":"Get Run Action","operationId":"get_run_action_v1_runs__run_id__actions__action_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Action Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/rabbit-holes":{"post":{"tags":["rabbit holes"],"summary":"Create Rabbit Hole","operationId":"create_rabbit_hole_v1_rabbit_holes_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RabbitHoleCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Rabbit Hole V1 Rabbit Holes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/rabbit-holes":{"get":{"tags":["rabbit holes"],"summary":"List Rabbit Holes","operationId":"list_rabbit_holes_v1_runs__run_id__rabbit_holes_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Rabbit Holes V1 Runs  Run Id  Rabbit Holes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/rabbit-holes/{rabbit_id}":{"get":{"tags":["rabbit holes"],"summary":"Get Rabbit Hole","operationId":"get_rabbit_hole_v1_rabbit_holes__rabbit_id__get","parameters":[{"name":"rabbit_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Rabbit Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Rabbit Hole V1 Rabbit Holes  Rabbit Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"delete":{"tags":["rabbit holes"],"summary":"Delete Rabbit Hole","operationId":"delete_rabbit_hole_v1_rabbit_holes__rabbit_id__delete","parameters":[{"name":"rabbit_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Rabbit Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/deliverables":{"get":{"tags":["dossiers"],"summary":"List Deliverables","operationId":"list_deliverables_v1_runs__run_id__deliverables_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Deliverables V1 Runs  Run Id  Deliverables Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/deliverable-options":{"get":{"tags":["dossiers"],"summary":"List Deliverable Options","operationId":"list_deliverable_options_v1_runs__run_id__deliverable_options_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Deliverable Options V1 Runs  Run Id  Deliverable Options Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/deliverables/{deliverable_id}":{"get":{"tags":["dossiers"],"summary":"Get Deliverable","operationId":"get_deliverable_v1_runs__run_id__deliverables__deliverable_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"deliverable_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deliverable Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Deliverable V1 Runs  Run Id  Deliverables  Deliverable Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/runs/{run_id}/extend":{"post":{"tags":["actions"],"summary":"Extend Run","operationId":"extend_run_v1_runs__run_id__extend_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtendCreate"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/regenerate-synthesis":{"post":{"tags":["actions"],"summary":"Regenerate Run Synthesis","operationId":"regenerate_run_synthesis_v1_runs__run_id__regenerate_synthesis_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/dossier":{"post":{"tags":["dossiers"],"summary":"Create Dossier","operationId":"create_dossier_v1_runs__run_id__dossier_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierCreate"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/deliverables/{deliverable_id}/regenerate":{"post":{"tags":["dossiers"],"summary":"Regenerate Deliverable","operationId":"regenerate_deliverable_v1_runs__run_id__deliverables__deliverable_id__regenerate_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"deliverable_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deliverable Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/workflow-preview":{"get":{"tags":["research intelligence"],"summary":"Preview Run Workflow","operationId":"preview_run_workflow_v1_runs__run_id__workflow_preview_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"source_report_version_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Source Report Version Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Preview Run Workflow V1 Runs  Run Id  Workflow Preview Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/workflow":{"post":{"tags":["research intelligence"],"summary":"Save Run Workflow","operationId":"save_run_workflow_v1_runs__run_id__workflow_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunWorkflowCloneWrite"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Run Workflow V1 Runs  Run Id  Workflow Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/research/plan":{"post":{"tags":["research intelligence"],"summary":"Preview Research Plan","operationId":"preview_research_plan_v1_research_plan_post","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchPlanRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Preview Research Plan V1 Research Plan Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/brief-templates":{"get":{"tags":["brief templates"],"summary":"List Templates","operationId":"list_templates_v1_brief_templates_get","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Templates V1 Brief Templates Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"post":{"tags":["brief templates"],"summary":"Create Template","operationId":"create_template_v1_brief_templates_post","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateWrite"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Template V1 Brief Templates Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/brief-templates/{template_id}":{"patch":{"tags":["brief templates"],"summary":"Patch Template","operationId":"patch_template_v1_brief_templates__template_id__patch","parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Template Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplatePatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Patch Template V1 Brief Templates  Template Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"},"delete":{"tags":["brief templates"],"summary":"Delete Template","operationId":"delete_template_v1_brief_templates__template_id__delete","parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Template Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/monitors":{"get":{"tags":["research monitors"],"summary":"List Monitors","operationId":"list_monitors_v1_monitors_get","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Monitors V1 Monitors Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"post":{"tags":["research monitors"],"summary":"Create Monitor","operationId":"create_monitor_v1_monitors_post","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorWrite"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Monitor V1 Monitors Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/monitors/{monitor_id}":{"patch":{"tags":["research monitors"],"summary":"Patch Monitor","operationId":"patch_monitor_v1_monitors__monitor_id__patch","parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Monitor Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Patch Monitor V1 Monitors  Monitor Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"},"delete":{"tags":["research monitors"],"summary":"Delete Monitor","operationId":"delete_monitor_v1_monitors__monitor_id__delete","parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Monitor Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/monitors/{monitor_id}/run":{"post":{"tags":["research monitors"],"summary":"Run Monitor Now","operationId":"run_monitor_now_v1_monitors__monitor_id__run_post","parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Monitor Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Run Monitor Now V1 Monitors  Monitor Id  Run Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/runs/{run_id}/intelligence":{"get":{"tags":["research intelligence"],"summary":"Run Intelligence","operationId":"run_intelligence_v1_runs__run_id__intelligence_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Version"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Run Intelligence V1 Runs  Run Id  Intelligence Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/output-profiles":{"get":{"tags":["structured output"],"summary":"List Output Profiles","operationId":"list_output_profiles_v1_output_profiles_get","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Output Profiles V1 Output Profiles Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"post":{"tags":["structured output"],"summary":"Create Output Profile","operationId":"create_output_profile_v1_output_profiles_post","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutputProfileWrite"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Output Profile V1 Output Profiles Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/output-profiles/{profile_id}":{"patch":{"tags":["structured output"],"summary":"Patch Output Profile","operationId":"patch_output_profile_v1_output_profiles__profile_id__patch","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutputProfilePatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Patch Output Profile V1 Output Profiles  Profile Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"},"delete":{"tags":["structured output"],"summary":"Delete Output Profile","operationId":"delete_output_profile_v1_output_profiles__profile_id__delete","parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"admin"}},"/v1/workflow-catalog":{"get":{"tags":["research pipelines"],"summary":"Workflow Catalog","operationId":"workflow_catalog_v1_workflow_catalog_get","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Catalog V1 Workflow Catalog Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/workflows/validate":{"post":{"tags":["research pipelines"],"summary":"Validate Workflow","operationId":"validate_workflow_v1_workflows_validate_post","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowValidate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Validate Workflow V1 Workflows Validate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/workflows":{"get":{"tags":["research pipelines"],"summary":"List Workflows","operationId":"list_workflows_v1_workflows_get","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Workflows V1 Workflows Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"post":{"tags":["research pipelines"],"summary":"Create Workflow","operationId":"create_workflow_v1_workflows_post","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowWrite"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Workflow V1 Workflows Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/workflows/{workflow_id}":{"get":{"tags":["research pipelines"],"summary":"Get Workflow","operationId":"get_workflow_v1_workflows__workflow_id__get","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Workflow V1 Workflows  Workflow Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"},"patch":{"tags":["research pipelines"],"summary":"Patch Workflow","operationId":"patch_workflow_v1_workflows__workflow_id__patch","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Patch Workflow V1 Workflows  Workflow Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"},"delete":{"tags":["research pipelines"],"summary":"Delete Workflow","operationId":"delete_workflow_v1_workflows__workflow_id__delete","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/workflows/{workflow_id}/executions":{"post":{"tags":["research pipelines"],"summary":"Start Workflow","operationId":"start_workflow_v1_workflows__workflow_id__executions_post","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Start Workflow V1 Workflows  Workflow Id  Executions Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"},"get":{"tags":["research pipelines"],"summary":"List Executions","operationId":"list_executions_v1_workflows__workflow_id__executions_get","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Executions V1 Workflows  Workflow Id  Executions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/workflow-executions/{execution_id}":{"get":{"tags":["research pipelines"],"summary":"Get Execution","operationId":"get_execution_v1_workflow_executions__execution_id__get","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Execution Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Execution V1 Workflow Executions  Execution Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}},"/v1/workflow-executions/{execution_id}/cancel":{"post":{"tags":["research pipelines"],"summary":"Cancel Workflow Execution","operationId":"cancel_workflow_execution_v1_workflow_executions__execution_id__cancel_post","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Execution Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cancel Workflow Execution V1 Workflow Executions  Execution Id  Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/workflow-executions/{execution_id}/steps/{step_id}/decision":{"post":{"tags":["research pipelines"],"summary":"Decide Workflow Step","operationId":"decide_workflow_step_v1_workflow_executions__execution_id__steps__step_id__decision_post","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Execution Id"}},{"name":"step_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Step Id"}},{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDecision"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Decide Workflow Step V1 Workflow Executions  Execution Id  Steps  Step Id  Decision Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"run"}},"/v1/workflow-approvals":{"get":{"tags":["research pipelines"],"summary":"List Pending Approvals","operationId":"list_pending_approvals_v1_workflow_approvals_get","parameters":[{"name":"X-Organization-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Pending Approvals V1 Workflow Approvals Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerCredential":[]},{"ApiKeyHeader":[]}],"x-fathom-required-scope":"read"}}},"components":{"schemas":{"ApprovalDecision":{"properties":{"decision":{"type":"string","enum":["approve","reject"],"title":"Decision"},"note":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Note"}},"additionalProperties":false,"type":"object","required":["decision"],"title":"ApprovalDecision"},"AskRequest":{"properties":{"question":{"type":"string","maxLength":1500,"minLength":1,"title":"Question"},"allow_search":{"type":"boolean","title":"Allow Search","default":false},"stream":{"type":"boolean","title":"Stream","default":false}},"additionalProperties":false,"type":"object","required":["question"],"title":"AskRequest"},"Body_upload_attachment_v1_attachments_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_attachment_v1_attachments_post"},"ClarifyRequest":{"properties":{"answers":{"additionalProperties":{"type":"string"},"type":"object","title":"Answers"}},"additionalProperties":false,"type":"object","required":["answers"],"title":"ClarifyRequest"},"DeletionImpactResponse":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id"},"recoverable_until":{"type":"string","format":"date-time","title":"Recoverable Until"},"retained_monitor_references":{"type":"integer","minimum":0.0,"title":"Retained Monitor References"},"child_run_count":{"type":"integer","minimum":0.0,"title":"Child Run Count"},"active_child_run_count":{"type":"integer","minimum":0.0,"title":"Active Child Run Count"},"active_action_count":{"type":"integer","minimum":0.0,"title":"Active Action Count"},"active_rabbit_hole_count":{"type":"integer","minimum":0.0,"title":"Active Rabbit Hole Count"},"active_ask_count":{"type":"integer","minimum":0.0,"title":"Active Ask Count"},"active_export_count":{"type":"integer","minimum":0.0,"title":"Active Export Count"},"brief_reference_count":{"type":"integer","minimum":0.0,"title":"Brief Reference Count"},"workflow_receipt_count":{"type":"integer","minimum":0.0,"title":"Workflow Receipt Count"},"active_share_count":{"type":"integer","minimum":0.0,"title":"Active Share Count"},"export_count":{"type":"integer","minimum":0.0,"title":"Export Count"},"review_count":{"type":"integer","minimum":0.0,"title":"Review Count"},"report_version_count":{"type":"integer","minimum":0.0,"title":"Report Version Count"},"cost_history_retained":{"type":"boolean","title":"Cost History Retained"},"can_delete":{"type":"boolean","title":"Can Delete"},"blocking_reasons":{"items":{"type":"string","enum":["run_active","monitor_baseline_in_use","active_child_run","active_action","active_rabbit_hole","active_ask","active_export"]},"type":"array","title":"Blocking Reasons"}},"additionalProperties":false,"type":"object","required":["run_id","recoverable_until","retained_monitor_references","child_run_count","active_child_run_count","active_action_count","active_rabbit_hole_count","active_ask_count","active_export_count","brief_reference_count","workflow_receipt_count","active_share_count","export_count","review_count","report_version_count","cost_history_retained","can_delete"],"title":"DeletionImpactResponse"},"DossierCreate":{"properties":{"target_document_count":{"type":"integer","maximum":12.0,"minimum":3.0,"title":"Target Document Count","default":8},"include":{"items":{"type":"string"},"type":"array","maxItems":12,"title":"Include"},"exclude":{"items":{"type":"string"},"type":"array","maxItems":45,"title":"Exclude"}},"additionalProperties":false,"type":"object","title":"DossierCreate"},"EstimateResponse":{"properties":{"credits":{"type":"integer","title":"Credits"},"est_sources_min":{"type":"integer","title":"Est Sources Min"},"est_sources_max":{"type":"integer","title":"Est Sources Max"},"est_documents":{"type":"integer","title":"Est Documents"},"est_minutes_min":{"type":"integer","title":"Est Minutes Min"},"est_minutes_max":{"type":"integer","title":"Est Minutes Max"},"planned_deliverables":{"items":{"type":"string"},"type":"array","title":"Planned Deliverables"},"balance_after":{"type":"integer","title":"Balance After"},"funding_status":{"type":"string","enum":["ready","insufficient_credits","credit_cap_exceeded","billing_suspended","organization_banned","organization_unavailable"],"title":"Funding Status"},"funding_shortfall":{"type":"integer","minimum":0.0,"title":"Funding Shortfall"}},"type":"object","required":["credits","est_sources_min","est_sources_max","est_documents","est_minutes_min","est_minutes_max","planned_deliverables","balance_after","funding_status","funding_shortfall"],"title":"EstimateResponse"},"ExtendCreate":{"properties":{"additional_rounds":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Additional Rounds","default":2},"question_addendum":{"type":"string","maxLength":1000,"title":"Question Addendum","default":""}},"additionalProperties":false,"type":"object","title":"ExtendCreate"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MonitorPatch":{"properties":{"template_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Template Id"},"name":{"anyOf":[{"type":"string","maxLength":160,"minLength":1},{"type":"null"}],"title":"Name"},"cadence":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Cadence"},"timezone":{"anyOf":[{"type":"string","maxLength":80,"minLength":1},{"type":"null"}],"title":"Timezone"},"status":{"anyOf":[{"type":"string","enum":["active","paused"]},{"type":"null"}],"title":"Status"},"notify_on_change":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Notify On Change"},"material_change_threshold":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Material Change Threshold"},"next_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Run At"}},"additionalProperties":false,"type":"object","title":"MonitorPatch"},"MonitorWrite":{"properties":{"template_id":{"type":"string","format":"uuid","title":"Template Id"},"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"},"cadence":{"type":"string","enum":["daily","weekly","monthly"],"title":"Cadence"},"timezone":{"type":"string","maxLength":80,"minLength":1,"title":"Timezone","default":"UTC"},"status":{"type":"string","enum":["active","paused"],"title":"Status","default":"active"},"notify_on_change":{"type":"boolean","title":"Notify On Change","default":true},"material_change_threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Material Change Threshold","default":0.15},"next_run_at":{"type":"string","format":"date-time","title":"Next Run At"}},"additionalProperties":false,"type":"object","required":["template_id","name","cadence","next_run_at"],"title":"MonitorWrite"},"NamespaceCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"slug":{"type":"string","maxLength":120,"minLength":1,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Slug"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","title":"Color","default":"#3b82f6"},"icon":{"type":"string","maxLength":50,"minLength":1,"title":"Icon","default":"folder"}},"additionalProperties":false,"type":"object","required":["name","slug"],"title":"NamespaceCreate"},"NamespaceListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/NamespaceResponse"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"additionalProperties":false,"type":"object","required":["data","has_more","next_cursor"],"title":"NamespaceListResponse"},"NamespacePatch":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"slug":{"anyOf":[{"type":"string","maxLength":120,"minLength":1,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},{"type":"null"}],"title":"Slug"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}],"title":"Color"},"icon":{"anyOf":[{"type":"string","maxLength":50,"minLength":1},{"type":"null"}],"title":"Icon"}},"additionalProperties":false,"type":"object","title":"NamespacePatch"},"NamespaceResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"color":{"type":"string","title":"Color"},"icon":{"type":"string","title":"Icon"},"run_count":{"type":"integer","minimum":0.0,"title":"Run Count"},"source_count":{"type":"integer","minimum":0.0,"title":"Source Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"is_deleted":{"type":"boolean","title":"Is Deleted"},"deleted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deleted At"},"recoverable_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Recoverable Until"}},"additionalProperties":false,"type":"object","required":["id","name","slug","description","color","icon","run_count","source_count","created_at","updated_at","is_deleted","deleted_at","recoverable_until"],"title":"NamespaceResponse"},"OutputProfilePatch":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schema"},"is_default":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Default"}},"additionalProperties":false,"type":"object","title":"OutputProfilePatch"},"OutputProfileWrite":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"schema":{"additionalProperties":true,"type":"object","title":"Schema"},"is_default":{"type":"boolean","title":"Is Default","default":false}},"additionalProperties":false,"type":"object","required":["name","schema"],"title":"OutputProfileWrite"},"RabbitHoleCreate":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id"},"direction":{"type":"string","maxLength":500,"minLength":1,"title":"Direction"}},"additionalProperties":false,"type":"object","required":["run_id","direction"],"title":"RabbitHoleCreate"},"ResearchActionListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ResearchActionResponse"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"additionalProperties":false,"type":"object","required":["data","has_more","next_cursor"],"title":"ResearchActionListResponse"},"ResearchActionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"run_id":{"type":"string","format":"uuid","title":"Run Id"},"kind":{"type":"string","enum":["extend","regenerate_synthesis","dossier","regenerate_deliverable","export"],"title":"Kind"},"status":{"type":"string","enum":["pending","running","completed","failed","cancelled"],"title":"Status"},"credits_reserved":{"type":"integer","minimum":0.0,"title":"Credits Reserved"},"credits_settled":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Credits Settled"},"credits_refunded":{"type":"integer","minimum":0.0,"title":"Credits Refunded"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"replayed":{"type":"boolean","title":"Replayed"},"failure_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Code"},"failure_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Message"},"deliverable_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Deliverable Count"}},"additionalProperties":false,"type":"object","required":["id","run_id","kind","status","credits_reserved","credits_refunded","created_at","completed_at","replayed","failure_code","failure_message"],"title":"ResearchActionResponse"},"ResearchPlanRequest":{"properties":{"question":{"type":"string","maxLength":2000,"minLength":1,"title":"Question"},"research_type":{"type":"string","title":"Research Type","default":"general"},"depth":{"type":"string","enum":["standard","deep"],"title":"Depth","default":"standard"},"decision_context":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Decision Context"},"intended_audience":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Intended Audience"},"preferred_domains":{"items":{"type":"string"},"type":"array","maxItems":30,"title":"Preferred Domains"},"exclude_domains":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Exclude Domains"}},"additionalProperties":false,"type":"object","required":["question"],"title":"ResearchPlanRequest"},"RunCreate":{"properties":{"question":{"type":"string","maxLength":2000,"minLength":1,"title":"Question"},"depth":{"type":"string","enum":["standard","deep"],"title":"Depth","default":"standard"},"research_type":{"type":"string","enum":["competitive_intel","market_research","market_sizing","technical","content_strategy","social_strategy","academic","investigative","strategic","general"],"title":"Research Type","default":"general"},"namespace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Namespace Id"},"tags":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Tags"},"skip_clarifying":{"type":"boolean","title":"Skip Clarifying","default":true},"clarifying_answers":{"additionalProperties":{"type":"string"},"type":"object","title":"Clarifying Answers"},"exclude_domains":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Exclude Domains"},"time_range":{"anyOf":[{"type":"string","enum":["day","week","month","year"]},{"type":"null"}],"title":"Time Range"},"attachment_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":20,"title":"Attachment Ids"},"preferred_domains":{"items":{"type":"string"},"type":"array","maxItems":30,"title":"Preferred Domains"},"decision_context":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Decision Context"},"intended_audience":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Intended Audience"},"deliverable_intent":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Deliverable Intent"},"template_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Template Id"},"output_profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Output Profile Id"},"refreshed_from_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Refreshed From Run Id"},"refreshed_from_report_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Refreshed From Report Version Id"},"monitor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Monitor Id","description":"Response-only legacy linkage. New monitor runs must use POST /v1/monitors/{monitor_id}/run."},"webhook_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Webhook Url"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"additionalProperties":false,"type":"object","required":["question"],"title":"RunCreate"},"RunMonitorCloneWrite":{"properties":{"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"},"cadence":{"type":"string","enum":["daily","weekly","monthly"],"title":"Cadence"},"timezone":{"type":"string","maxLength":80,"minLength":1,"title":"Timezone","default":"UTC"},"next_run_at":{"type":"string","format":"date-time","title":"Next Run At"},"notify_on_change":{"type":"boolean","title":"Notify On Change","default":true},"material_change_threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Material Change Threshold","default":0.15},"acknowledged_credit_cost":{"type":"integer","minimum":0.0,"title":"Acknowledged Credit Cost"}},"additionalProperties":false,"type":"object","required":["name","cadence","next_run_at","acknowledged_credit_cost"],"title":"RunMonitorCloneWrite"},"RunTagListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/RunTagResponse"},"type":"array","title":"Data"}},"additionalProperties":false,"type":"object","required":["data"],"title":"RunTagListResponse"},"RunTagResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"color":{"type":"string","title":"Color"}},"additionalProperties":false,"type":"object","required":["id","name","color"],"title":"RunTagResponse"},"RunWorkflowCloneWrite":{"properties":{"source_report_version_id":{"type":"string","format":"uuid","title":"Source Report Version Id"},"source_scope_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Source Scope Digest"},"brief_name":{"type":"string","maxLength":160,"minLength":1,"title":"Brief Name"},"brief_description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Brief Description"},"monitor":{"anyOf":[{"$ref":"#/components/schemas/RunMonitorCloneWrite"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["source_report_version_id","source_scope_digest","brief_name"],"title":"RunWorkflowCloneWrite"},"ShareCreate":{"properties":{"expires_in_days":{"anyOf":[{"type":"integer","maximum":365.0,"minimum":1.0},{"type":"null"}],"title":"Expires In Days","default":7},"include_sources":{"type":"boolean","title":"Include Sources","default":true},"include_asks":{"type":"boolean","title":"Include Asks","default":false},"allow_pdf":{"type":"boolean","title":"Allow Pdf","default":true},"allow_index":{"type":"boolean","title":"Allow Index","default":false}},"additionalProperties":false,"type":"object","title":"ShareCreate"},"TagCreate":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","title":"Color","default":"#64748b"}},"additionalProperties":false,"type":"object","required":["name"],"title":"TagCreate"},"TagMerge":{"properties":{"target_tag_id":{"type":"string","format":"uuid","title":"Target Tag Id"}},"additionalProperties":false,"type":"object","required":["target_tag_id"],"title":"TagMerge"},"TagPatch":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Name"},"color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}],"title":"Color"}},"additionalProperties":false,"type":"object","title":"TagPatch"},"TemplatePatch":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":160,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"question":{"anyOf":[{"type":"string","maxLength":2000,"minLength":1},{"type":"null"}],"title":"Question"},"decision_context":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Decision Context"},"intended_audience":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Intended Audience"},"deliverable_intent":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Deliverable Intent"},"depth":{"anyOf":[{"type":"string","enum":["standard","deep"]},{"type":"null"}],"title":"Depth"},"research_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Research Type"},"namespace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Namespace Id"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Tags"},"run_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Run Config"}},"additionalProperties":false,"type":"object","title":"TemplatePatch"},"TemplateWrite":{"properties":{"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"question":{"type":"string","maxLength":2000,"minLength":1,"title":"Question"},"decision_context":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Decision Context"},"intended_audience":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Intended Audience"},"deliverable_intent":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Deliverable Intent"},"depth":{"type":"string","enum":["standard","deep"],"title":"Depth","default":"standard"},"research_type":{"type":"string","title":"Research Type","default":"general"},"namespace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Namespace Id"},"tags":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Tags"},"run_config":{"additionalProperties":true,"type":"object","title":"Run Config"}},"additionalProperties":false,"type":"object","required":["name","question"],"title":"TemplateWrite"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WebhookCreate":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"events":{"items":{"type":"string","enum":["run.started","run.completed","run.failed","run.cancelled","rabbit_hole.completed","dossier.completed","deliverable.failed","credits.low","credits.exhausted","workflow.completed","workflow.failed","workflow.approval_requested"]},"type":"array","maxItems":12,"minItems":1,"title":"Events"}},"additionalProperties":false,"type":"object","required":["url","events"],"title":"WebhookCreate"},"WebhookPatch":{"properties":{"url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Url"},"events":{"anyOf":[{"items":{"type":"string","enum":["run.started","run.completed","run.failed","run.cancelled","rabbit_hole.completed","dossier.completed","deliverable.failed","credits.low","credits.exhausted","workflow.completed","workflow.failed","workflow.approval_requested"]},"type":"array","maxItems":12,"minItems":1},{"type":"null"}],"title":"Events"},"status":{"anyOf":[{"type":"string","enum":["active","disabled"]},{"type":"null"}],"title":"Status"}},"additionalProperties":false,"type":"object","title":"WebhookPatch"},"WorkflowPatch":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":160,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"status":{"anyOf":[{"type":"string","enum":["active","paused"]},{"type":"null"}],"title":"Status"},"graph":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Graph"}},"additionalProperties":false,"type":"object","title":"WorkflowPatch"},"WorkflowValidate":{"properties":{"graph":{"additionalProperties":true,"type":"object","title":"Graph"}},"additionalProperties":false,"type":"object","required":["graph"],"title":"WorkflowValidate"},"WorkflowWrite":{"properties":{"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"status":{"type":"string","enum":["active","paused"],"title":"Status","default":"active"},"graph":{"additionalProperties":true,"type":"object","title":"Graph"}},"additionalProperties":false,"type":"object","required":["name","graph"],"title":"WorkflowWrite"}},"securitySchemes":{"BearerCredential":{"type":"http","scheme":"bearer"},"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}