{"openapi":"3.1.0","info":{"title":"Corvio Developer API","description":"Agent-first API for Corvio questions, conversations, Workspace search, documents, comments, Agent mailboxes, sharing, files, local Markdown sync, and administrator test runs.","version":"1.0.0","x-agent-guidance":{"discovery":"GET /v1 before choosing an operation.","safe_mutations":"Use Idempotency-Key for creates and expected_content_revision for document replacement.","question_results":"Follow links in question resources; sources and artifacts contain stable Corvio resource IDs.","agent_events":"Claim with a bounded lease; acknowledge only after durable Query and comment receipts exist.","official_skill":"https://corvio.ai/developers/skills/corvio-operate-workspace/SKILL.md","official_skill_manifest":"https://corvio.ai/developers/skills/corvio-operate-workspace/manifest.json"}},"paths":{"/v1/auth/device-authorizations":{"post":{"tags":["Public API v1"],"summary":"Create Cli Device Authorization","operationId":"create_cli_device_authorization_auth_device_authorizations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCliDeviceAuthorizationRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCliDeviceAuthorizationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/device-token":{"post":{"tags":["Public API v1"],"summary":"Exchange Cli Device Authorization","operationId":"exchange_cli_device_authorization_auth_device_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCliDeviceTokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCliDeviceTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/credentials/current:revoke":{"post":{"tags":["Public API v1"],"summary":"Revoke Current Cli Credential","operationId":"revoke_current_cli_credential_auth_credentials_current_revoke_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCliCredentialRevokeResponse"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/admin/tests/catalog":{"get":{"tags":["Public API v1"],"summary":"Get Admin Test Catalog","operationId":"get_admin_test_catalog_admin_tests_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Admin Test Catalog Admin Tests Catalog Get"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/admin/tests/cases":{"get":{"tags":["Public API v1"],"summary":"List Admin Test Cases","operationId":"list_admin_test_cases_admin_tests_cases_get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Query"}},{"name":"capability","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Capability"}},{"name":"owner","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Owner"}},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Role"}},{"name":"cost_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Cost Class"}},{"name":"suite_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Suite 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","maxLength":500},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDeveloperTestCaseListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/tests/cases/{case_id}":{"get":{"tags":["Public API v1"],"summary":"Get Admin Test Case","operationId":"get_admin_test_case_admin_tests_cases__case_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","title":"Case Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Admin Test Case Admin Tests Cases  Case Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/tests/suites":{"get":{"tags":["Public API v1"],"summary":"List Admin Test Suites","operationId":"list_admin_test_suites_admin_tests_suites_get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Query"}},{"name":"runnable","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Runnable"}},{"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","maxLength":500},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDeveloperTestSuiteListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/tests/suites/{suite_id}":{"get":{"tags":["Public API v1"],"summary":"Get Admin Test Suite","operationId":"get_admin_test_suite_admin_tests_suites__suite_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"suite_id","in":"path","required":true,"schema":{"type":"string","title":"Suite Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Admin Test Suite Admin Tests Suites  Suite Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/tests/runs":{"get":{"tags":["Public API v1"],"summary":"List Admin Test Runs","operationId":"list_admin_test_runs_admin_tests_runs_get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Status"}},{"name":"selection_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(cases|suite)$"},{"type":"null"}],"title":"Selection Kind"}},{"name":"case_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Case Id"}},{"name":"suite_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Suite 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","maxLength":500},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDeveloperTestRunListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Public API v1"],"summary":"Launch Admin Test Run","operationId":"launch_admin_test_run_admin_tests_runs_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDeveloperTestLaunchRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDeveloperTestRunResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/tests/runs/{run_id}":{"get":{"tags":["Public API v1"],"summary":"Get Admin Test Run","operationId":"get_admin_test_run_admin_tests_runs__run_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDeveloperTestRunResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me":{"get":{"tags":["Public API v1"],"summary":"Get Identity","operationId":"get_identity_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicIdentityResponse"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/workspaces":{"get":{"tags":["Public API v1"],"summary":"List User Workspaces","operationId":"list_user_workspaces_workspaces_get","security":[{"CorvioApiKey":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List User Workspaces Workspaces Get"}}}}}},"post":{"tags":["Public API v1"],"summary":"Create User Workspace","operationId":"create_user_workspace_workspaces_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicWorkspaceCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create User Workspace Workspaces Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/projects":{"post":{"tags":["Public API v1"],"summary":"Create Project","operationId":"create_project_projects_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProjectCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Project Projects Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nodes/{node_id}:move":{"post":{"tags":["Public API v1"],"summary":"Move Tree Node","operationId":"move_tree_node_nodes__node_id__move_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"node_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Node Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicNodeMoveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Move Tree Node Nodes  Node Id  Move Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/questions":{"get":{"tags":["Public API v1"],"summary":"List Questions","operationId":"list_questions_questions_get","security":[{"CorvioApiKey":[]}],"parameters":[{"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":"conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQuestionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Public API v1"],"summary":"Ask Question","operationId":"ask_question_questions_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQuestionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQuestionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/questions/{question_id}":{"get":{"tags":["Public API v1"],"summary":"Get Question","operationId":"get_question_questions__question_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"question_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Question Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQuestionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations":{"get":{"tags":["Public API v1"],"summary":"List Conversations","operationId":"list_conversations_conversations_get","security":[{"CorvioApiKey":[]}],"parameters":[{"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"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicConversationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}":{"get":{"tags":["Public API v1"],"summary":"Get Conversation","operationId":"get_conversation_conversations__conversation_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicConversationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search":{"post":{"tags":["Public API v1"],"summary":"Search Documents","operationId":"search_documents_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/documents":{"get":{"tags":["Public API v1"],"summary":"List Documents","operationId":"list_documents_documents_get","security":[{"CorvioApiKey":[]}],"parameters":[{"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"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocumentListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Public API v1"],"summary":"Create Document","operationId":"create_document_documents_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocumentCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocumentItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/documents/{document_id}":{"get":{"tags":["Public API v1"],"summary":"Get Document","operationId":"get_document_documents__document_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocumentItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Public API v1"],"summary":"Update Document","operationId":"update_document_documents__document_id__put","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocumentUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocumentItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Public API v1"],"summary":"Delete Document","operationId":"delete_document_documents__document_id__delete","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocumentDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/documents/{document_id}/shares":{"post":{"tags":["Public API v1"],"summary":"Share Document","operationId":"share_document_documents__document_id__shares_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocumentShareRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocumentShareResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/uploads":{"post":{"tags":["Public API v1 - Files"],"summary":"Init File Upload","operationId":"init_file_upload_files_uploads_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAssetUploadInitRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAssetUploadInitResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/files/uploads:finalize":{"post":{"tags":["Public API v1 - Files"],"summary":"Finalize File Upload","operationId":"finalize_file_upload_files_uploads_finalize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAssetUploadFinalizeRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAssetItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/files":{"get":{"tags":["Public API v1 - Files"],"summary":"List Files","operationId":"list_files_files_get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAssetListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{asset_id}":{"get":{"tags":["Public API v1 - Files"],"summary":"Get File","operationId":"get_file_files__asset_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAssetItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{asset_id}/content":{"get":{"tags":["Public API v1 - Files"],"summary":"Download File","operationId":"download_file_files__asset_id__content_get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{asset_id}:organize":{"post":{"tags":["Public API v1 - Files"],"summary":"Organize File","operationId":"organize_file_files__asset_id__organize_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Asset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAssetOrganizeRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAssetOrganizationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/file-operations/{operation_id}":{"get":{"tags":["Public API v1 - Files"],"summary":"Get File Operation","operationId":"get_file_operation_file_operations__operation_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"operation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Operation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAssetOrganizationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sync/sources":{"post":{"tags":["Public API v1 - Local Markdown Sync"],"summary":"Init Sync Source","operationId":"init_sync_source_sync_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncInitRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncSource"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/sync/sources/{source_id}":{"get":{"tags":["Public API v1 - Local Markdown Sync"],"summary":"Get Sync Status","operationId":"get_sync_status_sync_sources__source_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sync/sources/{source_id}/pull":{"get":{"tags":["Public API v1 - Local Markdown Sync"],"summary":"Pull Sync Source","operationId":"pull_sync_source_sync_sources__source_id__pull_get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncPullResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sync/plan":{"post":{"tags":["Public API v1 - Local Markdown Sync"],"summary":"Plan Sync","operationId":"plan_sync_sync_plan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncPlanRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/sync/commit":{"post":{"tags":["Public API v1 - Local Markdown Sync"],"summary":"Commit Sync","operationId":"commit_sync_sync_commit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncCommitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncCommitResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/sync/push":{"post":{"tags":["Public API v1 - Local Markdown Sync"],"summary":"Push Sync File","operationId":"push_sync_file_sync_push_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncPushRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncPushResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/sync/conflicts/{conflict_id}":{"get":{"tags":["Public API v1 - Local Markdown Sync"],"summary":"Get Sync Conflict","operationId":"get_sync_conflict_sync_conflicts__conflict_id__get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"conflict_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conflict Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncConflictResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sync/conflicts/{conflict_id}:resolve":{"post":{"tags":["Public API v1 - Local Markdown Sync"],"summary":"Resolve Sync Conflict","operationId":"resolve_sync_conflict_sync_conflicts__conflict_id__resolve_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"conflict_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conflict Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncResolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSyncConflictResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents":{"get":{"tags":["Agent collaboration"],"summary":"List Agents","operationId":"list_agents_agents_get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"include_revoked","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Revoked"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Agent collaboration"],"summary":"Create Agent","operationId":"create_agent_agents_post","security":[{"CorvioApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}":{"patch":{"tags":["Agent collaboration"],"summary":"Update Agent","operationId":"update_agent_agents__agent_id__patch","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}/credentials:rotate":{"post":{"tags":["Agent collaboration"],"summary":"Rotate Agent Credential","operationId":"rotate_agent_credential_agents__agent_id__credentials_rotate_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentCredentialResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-events:claim":{"post":{"tags":["Agent collaboration"],"summary":"Claim Agent Event","operationId":"claim_agent_event_agent_events_claim_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentEventClaimRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentEventClaimResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"CorvioApiKey":[]}]}},"/v1/agent-events/{event_id}:renew":{"post":{"tags":["Agent collaboration"],"summary":"Renew Agent Event","operationId":"renew_agent_event_agent_events__event_id__renew_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentEventRenewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Renew Agent Event Agent Events  Event Id  Renew Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-events/{event_id}:complete":{"post":{"tags":["Agent collaboration"],"summary":"Complete Agent Event","operationId":"complete_agent_event_agent_events__event_id__complete_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentEventCompleteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Complete Agent Event Agent Events  Event Id  Complete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-events/{event_id}:fail":{"post":{"tags":["Agent collaboration"],"summary":"Fail Agent Event","operationId":"fail_agent_event_agent_events__event_id__fail_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentEventFailRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Fail Agent Event Agent Events  Event Id  Fail Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/documents/{document_id}/comments":{"get":{"tags":["Agent collaboration"],"summary":"List Document Comments","operationId":"list_document_comments_documents__document_id__comments_get","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageCommentsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Agent collaboration"],"summary":"Create Document Comment","operationId":"create_document_comment_documents__document_id__comments_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentCommentThreadCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageCommentThreadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/documents/{document_id}/comments/{thread_id}/replies":{"post":{"tags":["Agent collaboration"],"summary":"Reply Document Comment","operationId":"reply_document_comment_documents__document_id__comments__thread_id__replies_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}},{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Thread Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentCommentReplyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageCommentThreadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/documents/{document_id}/comments/{thread_id}/status":{"post":{"tags":["Agent collaboration"],"summary":"Update Document Comment Status","operationId":"update_document_comment_status_documents__document_id__comments__thread_id__status_post","security":[{"CorvioApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}},{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Thread Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageCommentThreadStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageCommentThreadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PageCommentAnchorResponse":{"properties":{"target_scope":{"type":"string","title":"Target Scope","default":"body"},"section_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Section Id"},"source_block_ids":{"items":{"type":"string"},"type":"array","title":"Source Block Ids"},"anchor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Anchor"},"heading_path":{"items":{"type":"string"},"type":"array","title":"Heading Path"},"quote_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Hash"},"selection_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selection Preview"},"selection_range_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Selection Range Json"},"table_selection_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Table Selection Json"},"surface_selection_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Surface Selection Json"},"source_page_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Source Page Revision"},"resolved_block_ids":{"items":{"type":"string"},"type":"array","title":"Resolved Block Ids"},"resolved_via":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved Via"},"needs_reanchor":{"type":"boolean","title":"Needs Reanchor","default":false}},"type":"object","title":"PageCommentAnchorResponse"},"PageCommentEntryResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"thread_id":{"type":"string","format":"uuid","title":"Thread Id"},"author_kind":{"type":"string","title":"Author Kind"},"author_agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Author Agent Id"},"actor_identity":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Actor Identity"},"body":{"type":"string","title":"Body"},"mentions":{"items":{"type":"string"},"type":"array","title":"Mentions"},"agent_mentions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Agent Mentions"},"entry_point":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Point"},"request_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Request Id"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"},"conversation_thread_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Thread Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","thread_id","author_kind","body","created_at","updated_at"],"title":"PageCommentEntryResponse"},"PageCommentThreadResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"page_id":{"type":"string","format":"uuid","title":"Page Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"status":{"type":"string","title":"Status"},"created_by_kind":{"type":"string","title":"Created By Kind"},"created_by_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Created By User Id"},"created_by_agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Created By Agent Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_activity_at":{"type":"string","format":"date-time","title":"Last Activity At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"anchor":{"$ref":"#/components/schemas/PageCommentAnchorResponse"},"entries":{"items":{"$ref":"#/components/schemas/PageCommentEntryResponse"},"type":"array","title":"Entries"}},"type":"object","required":["id","page_id","workspace_id","status","created_by_kind","created_at","last_activity_at","updated_at","anchor"],"title":"PageCommentThreadResponse"},"PageCommentThreadStatusRequest":{"properties":{"status":{"type":"string","enum":["open","resolved","needs_reanchor"],"title":"Status"},"entry_point":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Entry Point"}},"type":"object","required":["status"],"title":"PageCommentThreadStatusRequest"},"PageCommentsResponse":{"properties":{"page_id":{"type":"string","format":"uuid","title":"Page Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"threads":{"items":{"$ref":"#/components/schemas/PageCommentThreadResponse"},"type":"array","title":"Threads"},"open_count":{"type":"integer","title":"Open Count","default":0},"resolved_count":{"type":"integer","title":"Resolved Count","default":0},"needs_reanchor_count":{"type":"integer","title":"Needs Reanchor Count","default":0},"thread_count":{"type":"integer","title":"Thread Count","default":0},"latest_activity_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Activity At"},"watermark":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Watermark"}},"type":"object","required":["page_id","workspace_id"],"title":"PageCommentsResponse"},"PublicAgentCommentReplyRequest":{"properties":{"body":{"type":"string","maxLength":12000,"minLength":1,"title":"Body"},"entry_point":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Entry Point"},"source_event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Event Id"},"source_event_lease_token":{"anyOf":[{"type":"string","maxLength":200,"minLength":20},{"type":"null"}],"title":"Source Event Lease Token"},"start_new_chain":{"type":"boolean","title":"Start New Chain","default":false}},"type":"object","required":["body"],"title":"PublicAgentCommentReplyRequest"},"PublicAgentCommentThreadCreateRequest":{"properties":{"body":{"type":"string","maxLength":12000,"minLength":1,"title":"Body"},"selection":{"additionalProperties":true,"type":"object","title":"Selection"},"entry_point":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Entry Point"},"start_new_chain":{"type":"boolean","title":"Start New Chain","default":false}},"type":"object","required":["body"],"title":"PublicAgentCommentThreadCreateRequest"},"PublicAgentCreateRequest":{"properties":{"handle":{"type":"string","maxLength":64,"minLength":1,"title":"Handle"},"display_name":{"type":"string","maxLength":100,"minLength":1,"title":"Display Name"},"avatar_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Avatar Url"},"provider":{"type":"string","enum":["codex","claude_code","custom"],"title":"Provider","default":"custom"},"permissions":{"items":{"type":"string","enum":["read","comment","edit"]},"type":"array","maxItems":3,"minItems":1,"title":"Permissions"}},"type":"object","required":["handle","display_name"],"title":"PublicAgentCreateRequest"},"PublicAgentCreateResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"object":{"type":"string","const":"agent","title":"Object","default":"agent"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"owner_user_id":{"type":"string","format":"uuid","title":"Owner User Id"},"handle":{"type":"string","title":"Handle"},"display_name":{"type":"string","title":"Display Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"provider":{"type":"string","title":"Provider"},"status":{"type":"string","title":"Status"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"credential":{"additionalProperties":true,"type":"object","title":"Credential"}},"type":"object","required":["id","workspace_id","owner_user_id","handle","display_name","avatar_url","provider","status","permissions","last_seen_at","created_at","updated_at","credential"],"title":"PublicAgentCreateResponse"},"PublicAgentCredentialResponse":{"properties":{"agent_id":{"type":"string","format":"uuid","title":"Agent Id"},"secret":{"type":"string","title":"Secret"},"display_prefix":{"type":"string","title":"Display Prefix"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["agent_id","secret","display_prefix","scopes","created_at"],"title":"PublicAgentCredentialResponse"},"PublicAgentEventClaimRequest":{"properties":{"worker_id":{"type":"string","maxLength":120,"minLength":1,"title":"Worker Id"},"lease_seconds":{"type":"integer","maximum":900.0,"minimum":30.0,"title":"Lease Seconds","default":300},"wait_seconds":{"type":"integer","maximum":30.0,"minimum":0.0,"title":"Wait Seconds","default":0}},"type":"object","required":["worker_id"],"title":"PublicAgentEventClaimRequest"},"PublicAgentEventClaimResponse":{"properties":{"event":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Event"},"retry_after_seconds":{"type":"integer","title":"Retry After Seconds","default":5}},"type":"object","required":["event"],"title":"PublicAgentEventClaimResponse"},"PublicAgentEventCompleteRequest":{"properties":{"lease_token":{"type":"string","maxLength":200,"minLength":20,"title":"Lease Token"},"result":{"additionalProperties":true,"type":"object","title":"Result"}},"type":"object","required":["lease_token","result"],"title":"PublicAgentEventCompleteRequest"},"PublicAgentEventFailRequest":{"properties":{"lease_token":{"type":"string","maxLength":200,"minLength":20,"title":"Lease Token"},"error":{"type":"string","maxLength":4000,"minLength":1,"title":"Error"},"retryable":{"type":"boolean","title":"Retryable","default":true}},"type":"object","required":["lease_token","error"],"title":"PublicAgentEventFailRequest"},"PublicAgentEventRenewRequest":{"properties":{"lease_token":{"type":"string","maxLength":200,"minLength":20,"title":"Lease Token"},"lease_seconds":{"type":"integer","maximum":900.0,"minimum":30.0,"title":"Lease Seconds","default":300}},"type":"object","required":["lease_token"],"title":"PublicAgentEventRenewRequest"},"PublicAgentListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicAgentResponse"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"PublicAgentListResponse"},"PublicAgentResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"object":{"type":"string","const":"agent","title":"Object","default":"agent"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"owner_user_id":{"type":"string","format":"uuid","title":"Owner User Id"},"handle":{"type":"string","title":"Handle"},"display_name":{"type":"string","title":"Display Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"provider":{"type":"string","title":"Provider"},"status":{"type":"string","title":"Status"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","workspace_id","owner_user_id","handle","display_name","avatar_url","provider","status","permissions","last_seen_at","created_at","updated_at"],"title":"PublicAgentResponse"},"PublicAgentUpdateRequest":{"properties":{"display_name":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Display Name"},"avatar_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Avatar Url"},"status":{"anyOf":[{"type":"string","enum":["active","paused","revoked"]},{"type":"null"}],"title":"Status"},"permissions":{"anyOf":[{"items":{"type":"string","enum":["read","comment","edit"]},"type":"array","maxItems":3,"minItems":1},{"type":"null"}],"title":"Permissions"}},"type":"object","title":"PublicAgentUpdateRequest"},"PublicAssetItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"object":{"type":"string","const":"workspace_asset","title":"Object","default":"workspace_asset"},"node_id":{"type":"string","format":"uuid","title":"Node Id"},"title":{"type":"string","title":"Title"},"parent_node_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Node Id"},"original_file_name":{"type":"string","title":"Original File Name"},"mime_type":{"type":"string","title":"Mime Type"},"size_bytes":{"type":"integer","title":"Size Bytes"},"content_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Sha256"},"status":{"type":"string","title":"Status"},"sensitivity_status":{"type":"string","title":"Sensitivity Status"},"sensitivity_reasons":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sensitivity Reasons"},"ai_read_policy":{"type":"string","title":"Ai Read Policy"},"processing_status":{"type":"string","title":"Processing Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links"}},"type":"object","required":["id","node_id","title","original_file_name","mime_type","size_bytes","status","sensitivity_status","ai_read_policy","processing_status","created_at","links"],"title":"PublicAssetItem"},"PublicAssetListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicAssetItem"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"PublicAssetListResponse"},"PublicAssetOrganizationResponse":{"properties":{"operation_id":{"type":"string","format":"uuid","title":"Operation Id"},"asset_id":{"type":"string","format":"uuid","title":"Asset Id"},"status":{"type":"string","title":"Status"},"phase":{"type":"string","title":"Phase"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links"}},"type":"object","required":["operation_id","asset_id","status","phase","created_at","updated_at","links"],"title":"PublicAssetOrganizationResponse"},"PublicAssetOrganizeRequest":{"properties":{"instruction":{"type":"string","maxLength":8000,"minLength":1,"title":"Instruction"},"target_root_node_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target Root Node Id"}},"type":"object","required":["instruction"],"title":"PublicAssetOrganizeRequest"},"PublicAssetUploadFinalizeRequest":{"properties":{"upload_id":{"type":"string","format":"uuid","title":"Upload Id"},"blob_name":{"type":"string","maxLength":1024,"minLength":1,"title":"Blob Name"},"file_name":{"type":"string","maxLength":255,"minLength":1,"title":"File Name"},"mime_type":{"type":"string","maxLength":255,"minLength":1,"title":"Mime Type","default":"application/octet-stream"},"size_bytes":{"type":"integer","maximum":104857600.0,"minimum":1.0,"title":"Size Bytes"}},"type":"object","required":["upload_id","blob_name","file_name","size_bytes"],"title":"PublicAssetUploadFinalizeRequest"},"PublicAssetUploadInitRequest":{"properties":{"file_name":{"type":"string","maxLength":255,"minLength":1,"title":"File Name"},"mime_type":{"type":"string","maxLength":255,"minLength":1,"title":"Mime Type","default":"application/octet-stream"},"size_bytes":{"type":"integer","maximum":104857600.0,"minimum":1.0,"title":"Size Bytes"}},"type":"object","required":["file_name","size_bytes"],"title":"PublicAssetUploadInitRequest"},"PublicAssetUploadInitResponse":{"properties":{"upload_id":{"type":"string","format":"uuid","title":"Upload Id"},"blob_name":{"type":"string","title":"Blob Name"},"upload_url":{"type":"string","title":"Upload Url"},"upload_method":{"type":"string","const":"PUT","title":"Upload Method","default":"PUT"},"upload_headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Upload Headers"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["upload_id","blob_name","upload_url","upload_headers","expires_at"],"title":"PublicAssetUploadInitResponse"},"PublicCliCredentialRevokeResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"key_id":{"type":"string","format":"uuid","title":"Key Id"},"revoked_at":{"type":"string","format":"date-time","title":"Revoked At"}},"type":"object","required":["key_id","revoked_at"],"title":"PublicCliCredentialRevokeResponse"},"PublicCliDeviceAuthorizationRequest":{"properties":{"client_name":{"type":"string","maxLength":100,"minLength":1,"title":"Client Name"},"cli_version":{"type":"string","maxLength":40,"minLength":1,"title":"Cli Version"},"scopes":{"items":{"type":"string","enum":["questions:read","questions:write","search:read","documents:read","documents:write","documents:share","assets:read","assets:write","sync:read","sync:write","workspaces:write","tests:read","tests:run","admin_data:read","admin_support:read","admin_costs:read","admin_content:read","comments:read","comments:write","agent_events:read","agent_events:write"]},"type":"array","maxItems":12,"minItems":1,"title":"Scopes"}},"type":"object","required":["client_name","cli_version","scopes"],"title":"PublicCliDeviceAuthorizationRequest"},"PublicCliDeviceAuthorizationResponse":{"properties":{"authorization_id":{"type":"string","format":"uuid","title":"Authorization Id"},"device_code":{"type":"string","title":"Device Code"},"user_code":{"type":"string","title":"User Code"},"verification_uri":{"type":"string","title":"Verification Uri"},"verification_uri_complete":{"type":"string","title":"Verification Uri Complete"},"expires_in":{"type":"integer","title":"Expires In"},"interval":{"type":"integer","title":"Interval"}},"type":"object","required":["authorization_id","device_code","user_code","verification_uri","verification_uri_complete","expires_in","interval"],"title":"PublicCliDeviceAuthorizationResponse"},"PublicCliDeviceTokenRequest":{"properties":{"device_code":{"type":"string","maxLength":200,"minLength":32,"title":"Device Code"}},"type":"object","required":["device_code"],"title":"PublicCliDeviceTokenRequest"},"PublicCliDeviceTokenResponse":{"properties":{"secret":{"type":"string","title":"Secret"},"key_id":{"type":"string","format":"uuid","title":"Key Id"},"audience":{"type":"string","enum":["user","workspace","platform_admin"],"title":"Audience"},"workspace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Workspace Id"},"workspace_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workspace Name"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["secret","key_id","audience","scopes","expires_at","created_at"],"title":"PublicCliDeviceTokenResponse"},"PublicConversationListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicConversationResponse"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["data"],"title":"PublicConversationListResponse"},"PublicConversationResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"object":{"type":"string","const":"conversation","title":"Object","default":"conversation"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"thread_id":{"type":"string","format":"uuid","title":"Thread Id"},"question_count":{"type":"integer","title":"Question Count"},"last_question_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Question At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links"}},"type":"object","required":["id","title","status","thread_id","question_count","created_at","updated_at","links"],"title":"PublicConversationResponse"},"PublicDeveloperTestCaseListResponse":{"properties":{"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"total":{"type":"integer","title":"Total"},"catalog_revision":{"type":"string","title":"Catalog Revision"},"facets":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Facets"}},"type":"object","required":["data","total","catalog_revision","facets"],"title":"PublicDeveloperTestCaseListResponse"},"PublicDeveloperTestLaunchRequest":{"properties":{"selection_kind":{"type":"string","enum":["cases","suite"],"title":"Selection Kind"},"case_ids":{"items":{"type":"string"},"type":"array","maxItems":12,"title":"Case Ids"},"suite_id":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Suite Id"},"reason":{"type":"string","enum":["product_changed","fixture_topology_changed","final_acceptance"],"title":"Reason"},"max_concurrency":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Max Concurrency","default":1}},"type":"object","required":["selection_kind","reason"],"title":"PublicDeveloperTestLaunchRequest"},"PublicDeveloperTestRunListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicDeveloperTestRunResponse"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["data","total"],"title":"PublicDeveloperTestRunListResponse"},"PublicDeveloperTestRunResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"object":{"type":"string","const":"test_run","title":"Object","default":"test_run"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"status":{"type":"string","title":"Status"},"selection_kind":{"type":"string","title":"Selection Kind"},"selection":{"additionalProperties":true,"type":"object","title":"Selection"},"assets":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Assets"},"environment":{"type":"string","title":"Environment"},"reason":{"type":"string","title":"Reason"},"max_concurrency":{"type":"integer","title":"Max Concurrency"},"summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Summary"},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"},"requested_at":{"type":"string","format":"date-time","title":"Requested At"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"finished_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links"}},"type":"object","required":["id","workspace_id","status","selection_kind","selection","assets","environment","reason","max_concurrency","summary","error","requested_at","started_at","finished_at","created_at","updated_at","links"],"title":"PublicDeveloperTestRunResponse"},"PublicDeveloperTestSuiteListResponse":{"properties":{"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"total":{"type":"integer","title":"Total"},"catalog_revision":{"type":"string","title":"Catalog Revision"}},"type":"object","required":["data","total","catalog_revision"],"title":"PublicDeveloperTestSuiteListResponse"},"PublicDocumentCreateRequest":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"markdown":{"type":"string","maxLength":120000,"title":"Markdown","default":""},"parent_node_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Node Id"},"doc_type":{"type":"string","const":"page","title":"Doc Type","default":"page"}},"type":"object","required":["title"],"title":"PublicDocumentCreateRequest"},"PublicDocumentDeleteResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"node_id":{"type":"string","format":"uuid","title":"Node Id"},"archived":{"type":"boolean","title":"Archived"}},"type":"object","required":["id","node_id","archived"],"title":"PublicDocumentDeleteResponse"},"PublicDocumentItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"node_id":{"type":"string","format":"uuid","title":"Node Id"},"parent_node_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Node Id"},"title":{"type":"string","title":"Title"},"doc_type":{"type":"string","title":"Doc Type"},"content_revision":{"type":"integer","title":"Content Revision"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"content_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Content Updated At"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"}},"type":"object","required":["id","node_id","title","doc_type","content_revision","created_at","updated_at"],"title":"PublicDocumentItem"},"PublicDocumentListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicDocumentItem"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["data"],"title":"PublicDocumentListResponse"},"PublicDocumentShareRequest":{"properties":{"public_display_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Public Display Name"}},"type":"object","title":"PublicDocumentShareRequest"},"PublicDocumentShareResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"document_id":{"type":"string","format":"uuid","title":"Document Id"},"node_id":{"type":"string","format":"uuid","title":"Node Id"},"mode":{"type":"string","title":"Mode"},"public_url":{"type":"string","title":"Public Url"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","document_id","node_id","mode","public_url","created_at"],"title":"PublicDocumentShareResponse"},"PublicDocumentUpdateRequest":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Title"},"markdown":{"anyOf":[{"type":"string","maxLength":120000},{"type":"null"}],"title":"Markdown"},"expected_content_revision":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expected Content Revision"}},"type":"object","title":"PublicDocumentUpdateRequest"},"PublicIdentityResponse":{"properties":{"user":{"additionalProperties":true,"type":"object","title":"User"},"workspace":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Workspace"},"workspaces":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Workspaces"},"api_key":{"additionalProperties":true,"type":"object","title":"Api Key"},"capabilities":{"additionalProperties":true,"type":"object","title":"Capabilities"},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links"}},"type":"object","required":["user","workspace","api_key","capabilities"],"title":"PublicIdentityResponse"},"PublicNodeMoveRequest":{"properties":{"parent_node_id":{"type":"string","format":"uuid","title":"Parent Node Id"},"before_node_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Before Node Id"},"after_node_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"After Node Id"}},"type":"object","required":["parent_node_id"],"title":"PublicNodeMoveRequest"},"PublicProjectCreateRequest":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"}},"type":"object","required":["title"],"title":"PublicProjectCreateRequest"},"PublicQuestionArtifact":{"properties":{"kind":{"type":"string","title":"Kind"},"document_id":{"type":"string","format":"uuid","title":"Document Id"},"node_id":{"type":"string","format":"uuid","title":"Node Id"},"title":{"type":"string","title":"Title"},"content_revision":{"type":"integer","title":"Content Revision"}},"type":"object","required":["kind","document_id","node_id","title","content_revision"],"title":"PublicQuestionArtifact"},"PublicQuestionListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicQuestionResponse"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["data"],"title":"PublicQuestionListResponse"},"PublicQuestionOperation":{"properties":{"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"}},"type":"object","required":["name","status"],"title":"PublicQuestionOperation"},"PublicQuestionRequest":{"properties":{"prompt":{"type":"string","maxLength":20000,"minLength":1,"title":"Prompt"},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"},"mode":{"type":"string","enum":["answer_only","allow_actions"],"title":"Mode","default":"answer_only"},"sources":{"items":{"type":"string","enum":["workspace","web","memory"]},"type":"array","maxItems":3,"title":"Sources"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context"}},"type":"object","required":["prompt"],"title":"PublicQuestionRequest"},"PublicQuestionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"object":{"type":"string","const":"question","title":"Object","default":"question"},"status":{"type":"string","enum":["in_progress","completed","failed","cancelled"],"title":"Status"},"prompt":{"type":"string","title":"Prompt"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"thread_id":{"type":"string","format":"uuid","title":"Thread Id"},"trace_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trace Id"},"sources":{"items":{"$ref":"#/components/schemas/PublicQuestionSource"},"type":"array","title":"Sources"},"source_document_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Source Document Ids"},"artifacts":{"items":{"$ref":"#/components/schemas/PublicQuestionArtifact"},"type":"array","title":"Artifacts"},"operations":{"items":{"$ref":"#/components/schemas/PublicQuestionOperation"},"type":"array","title":"Operations"},"answer_blocks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Answer Blocks"},"usage":{"additionalProperties":true,"type":"object","title":"Usage"},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links"}},"type":"object","required":["id","status","prompt","conversation_id","thread_id","created_at","updated_at","links"],"title":"PublicQuestionResponse"},"PublicQuestionSource":{"properties":{"kind":{"type":"string","title":"Kind"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"document_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Document Id"},"node_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Node Id"},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"},"question_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Question Id"},"page_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Revision"},"heading_path":{"items":{"type":"string"},"type":"array","title":"Heading Path"},"quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote"},"locator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locator"}},"type":"object","required":["kind"],"title":"PublicQuestionSource"},"PublicSearchHit":{"properties":{"chunk_id":{"type":"string","title":"Chunk Id"},"page_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Page Id"},"node_id":{"type":"string","format":"uuid","title":"Node Id"},"page_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Title"},"heading_path":{"items":{"type":"string"},"type":"array","title":"Heading Path"},"quote":{"type":"string","title":"Quote"},"score":{"type":"number","title":"Score"},"page_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Revision"}},"type":"object","required":["chunk_id","node_id","quote","score"],"title":"PublicSearchHit"},"PublicSearchRequest":{"properties":{"query":{"type":"string","maxLength":2000,"minLength":1,"title":"Query"},"limit":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Limit","default":10},"page_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Page Id"},"node_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Node Id"}},"type":"object","required":["query"],"title":"PublicSearchRequest"},"PublicSearchResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicSearchHit"},"type":"array","title":"Data"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["data","meta"],"title":"PublicSearchResponse"},"PublicSyncCommitItem":{"properties":{"page_id":{"type":"string","format":"uuid","title":"Page Id"},"node_id":{"type":"string","format":"uuid","title":"Node Id"},"relative_path":{"type":"string","maxLength":1024,"minLength":1,"title":"Relative Path"},"content_sha256":{"type":"string","maxLength":64,"minLength":64,"title":"Content Sha256"},"mtime_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mtime Ms"}},"type":"object","required":["page_id","node_id","relative_path","content_sha256"],"title":"PublicSyncCommitItem"},"PublicSyncCommitRequest":{"properties":{"source_id":{"type":"string","format":"uuid","title":"Source Id"},"items":{"items":{"$ref":"#/components/schemas/PublicSyncCommitItem"},"type":"array","maxItems":2000,"title":"Items"}},"type":"object","required":["source_id"],"title":"PublicSyncCommitRequest"},"PublicSyncCommitResponse":{"properties":{"source_id":{"type":"string","format":"uuid","title":"Source Id"},"updated":{"type":"integer","title":"Updated"}},"type":"object","required":["source_id","updated"],"title":"PublicSyncCommitResponse"},"PublicSyncConflictResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"source_id":{"type":"string","format":"uuid","title":"Source Id"},"relative_path":{"type":"string","title":"Relative Path"},"conflict_type":{"type":"string","title":"Conflict Type"},"status":{"type":"string","title":"Status"},"detail":{"additionalProperties":true,"type":"object","title":"Detail"},"remote":{"anyOf":[{"$ref":"#/components/schemas/PublicSyncRemoteItem"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","source_id","relative_path","conflict_type","status","created_at","updated_at"],"title":"PublicSyncConflictResponse"},"PublicSyncInitRequest":{"properties":{"root_node_id":{"type":"string","format":"uuid","title":"Root Node Id"},"folder_name":{"type":"string","maxLength":260,"minLength":1,"title":"Folder Name"},"client_id":{"type":"string","maxLength":120,"minLength":1,"title":"Client Id"}},"type":"object","required":["root_node_id","folder_name","client_id"],"title":"PublicSyncInitRequest"},"PublicSyncManifestItem":{"properties":{"relative_path":{"type":"string","maxLength":1024,"minLength":1,"title":"Relative Path"},"content_sha256":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Content Sha256"},"size_bytes":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Size Bytes"},"mtime_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mtime Ms"},"page_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Page Id"}},"type":"object","required":["relative_path"],"title":"PublicSyncManifestItem"},"PublicSyncPlanAction":{"properties":{"action":{"type":"string","enum":["pull","push","unchanged","conflict","local_missing"],"title":"Action"},"relative_path":{"type":"string","title":"Relative Path"},"page_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Page Id"},"conflict_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conflict Id"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"remote":{"anyOf":[{"$ref":"#/components/schemas/PublicSyncRemoteItem"},{"type":"null"}]}},"type":"object","required":["action","relative_path"],"title":"PublicSyncPlanAction"},"PublicSyncPlanRequest":{"properties":{"source_id":{"type":"string","format":"uuid","title":"Source Id"},"local":{"items":{"$ref":"#/components/schemas/PublicSyncManifestItem"},"type":"array","maxItems":2000,"title":"Local"}},"type":"object","required":["source_id"],"title":"PublicSyncPlanRequest"},"PublicSyncPlanResponse":{"properties":{"source":{"$ref":"#/components/schemas/PublicSyncSource"},"actions":{"items":{"$ref":"#/components/schemas/PublicSyncPlanAction"},"type":"array","title":"Actions"},"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"}},"type":"object","required":["source","actions","counts"],"title":"PublicSyncPlanResponse"},"PublicSyncPullResponse":{"properties":{"source":{"$ref":"#/components/schemas/PublicSyncSource"},"items":{"items":{"$ref":"#/components/schemas/PublicSyncRemoteItem"},"type":"array","title":"Items"}},"type":"object","required":["source","items"],"title":"PublicSyncPullResponse"},"PublicSyncPushRequest":{"properties":{"source_id":{"type":"string","format":"uuid","title":"Source Id"},"relative_path":{"type":"string","maxLength":1024,"minLength":1,"title":"Relative Path"},"markdown":{"type":"string","maxLength":120000,"title":"Markdown"},"content_sha256":{"type":"string","maxLength":64,"minLength":64,"title":"Content Sha256"},"mtime_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mtime Ms"},"page_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Page Id"},"expected_content_revision":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expected Content Revision"},"conflict_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conflict Id"}},"type":"object","required":["source_id","relative_path","markdown","content_sha256"],"title":"PublicSyncPushRequest"},"PublicSyncPushResponse":{"properties":{"source_id":{"type":"string","format":"uuid","title":"Source Id"},"item":{"$ref":"#/components/schemas/PublicSyncRemoteItem"},"resolved_conflict_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Resolved Conflict Id"}},"type":"object","required":["source_id","item"],"title":"PublicSyncPushResponse"},"PublicSyncRemoteItem":{"properties":{"page_id":{"type":"string","format":"uuid","title":"Page Id"},"node_id":{"type":"string","format":"uuid","title":"Node Id"},"title":{"type":"string","title":"Title"},"relative_path":{"type":"string","title":"Relative Path"},"markdown":{"type":"string","title":"Markdown"},"content_sha256":{"type":"string","title":"Content Sha256"},"content_revision":{"type":"integer","title":"Content Revision"}},"type":"object","required":["page_id","node_id","title","relative_path","markdown","content_sha256","content_revision"],"title":"PublicSyncRemoteItem"},"PublicSyncResolveRequest":{"properties":{"strategy":{"type":"string","const":"use_remote","title":"Strategy"}},"type":"object","required":["strategy"],"title":"PublicSyncResolveRequest"},"PublicSyncSource":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"root_node_id":{"type":"string","format":"uuid","title":"Root Node Id"},"folder_name":{"type":"string","title":"Folder Name"},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"mirror_root_dir":{"type":"string","title":"Mirror Root Dir","default":"corvio_docs"},"status":{"type":"string","title":"Status"},"last_pull_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Pull At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","root_node_id","folder_name","status","created_at","updated_at"],"title":"PublicSyncSource"},"PublicSyncStatusResponse":{"properties":{"source":{"$ref":"#/components/schemas/PublicSyncSource"},"tracked_count":{"type":"integer","title":"Tracked Count"},"open_conflict_count":{"type":"integer","title":"Open Conflict Count"}},"type":"object","required":["source","tracked_count","open_conflict_count"],"title":"PublicSyncStatusResponse"},"PublicWorkspaceCreateRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"kind":{"type":"string","enum":["personal","team"],"title":"Kind","default":"personal"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description"}},"type":"object","required":["name"],"title":"PublicWorkspaceCreateRequest"},"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"}},"securitySchemes":{"CorvioApiKey":{"type":"http","scheme":"bearer"}}},"servers":[{"url":"https://api.corvio.ai","description":"Production"},{"url":"https://api.corvio.io","description":"Staging"}]}