DatabookAI REST API

{"openapi":"3.1.0","info":{"title":"DatabookAI REST API","summary":"Integrate DatabookAI's intelligence into your applications with a simple, reliable, and secure REST API.","description":"\n## Introduction\nThe DatabookAI REST API lets you integrate DatabookAI's intelligence directly into your own applications and workflows. Browse the available operations, grouped by resource, in the **Endpoints** section below.\n\nThe API uses standard HTTP methods, predictable resource-oriented URLs, and JSON-encoded request and response bodies. Every response, including errors, returns JSON.\n\n## Getting started\n1. Obtain API access. Access is provisioned by Databook support, who issue the credentials your application uses to authenticate.\n2. Send your first request. Include your access token in the `Authorization` header (see **Authentication**) and the required identity headers on every call.\n3. Handle the response. Successful calls return a `2xx` status with a JSON body; failures return a JSON error object with a consistent shape (see **Errors**).\n\n### Prerequisites\n- An active Databook account.\n- API access provisioned by Databook support.\n\n## Authentication\nAll requests must be authenticated with a bearer token issued by Databook support. Pass the token in the `Authorization` header:\n\n```\nAuthorization: Bearer <YOUR_ACCESS_TOKEN>\n```\n\nRequests must also include the following identity headers so the API can resolve the calling user and tenant:\n\n| Header | Description |\n| --- | --- |\n| `databook-user-id` | Identifier of the user the request is made on behalf of. |\n| `databook-tenant-id` | Identifier of the tenant (organization) the request belongs to. |\n\nRequests that are missing or presenting an invalid token receive a `401 Invalid authentication` response. Tokens that lack the required permissions receive a `401` as well. Keep your token secret. Do not embed it in client-side code or commit it to source control.\n\n## Requests and responses\n- All request and response bodies are JSON, except file uploads (for example, the batch job endpoint), which use `multipart/form-data`.\n- Send `Content-Type: application/json` for endpoints that accept a JSON body.\n- Timestamps are UTC and IDs are strings unless otherwise noted in the schema.\n\n## Errors\nThe API uses conventional HTTP status codes to indicate the outcome of a request. Codes in the `2xx` range indicate success, `4xx` codes indicate a problem with the request (for example, a missing parameter or invalid token), and `5xx` codes indicate an error on Databook's side.\n\nEvery error response shares the same shape: an `error` object containing a machine-readable `type` and a human-readable `message`. Some responses also include a `reference_id` you can share with Databook support to help investigate the issue.\n\n```json\n{\n  \"error\": {\n    \"type\": \"invalid_request\",\n    \"message\": \"Invalid request\"\n  },\n  \"reference_id\": \"b1f2c3d4-...\"\n}\n```\n\n| Status | Error type | Meaning |\n| --- | --- | --- |\n| `400` | `invalid_request` | The request was malformed or failed validation. |\n| `401` | `invalid_authentication_error` | The access token is missing, invalid, or lacks the required permissions. |\n| `404` | `resource_not_found_error` | The requested resource does not exist. |\n| `429` | `rate_limit_error` | Too many requests. Slow down and retry after a short delay. |\n| `500` | `internal_server_error` | An unexpected error occurred on Databook's side. |\n| `503` | `server_side_overload_error` | The service is temporarily overloaded or the request exceeded the time limit. Retry later. |\n\n## Rate limits\nThe API enforces rate limits to keep the service reliable for everyone. When you exceed a limit, requests return `429 rate_limit_error`. Build retries with exponential backoff into your integration to handle these responses gracefully.\n\n## Timeouts\nThe maximum duration for any single API call is 180 seconds. Requests that exceed this limit return a `503 server_side_overload_error`. For long-running workloads, prefer the batch endpoints, which process work asynchronously.\n\n## Legal\n<a href=\"https://databook.com/privacy/\" target=\"_blank\" rel=\"noopener noreferrer\">Privacy Policy</a><br />\n<a href=\"https://databook.com/terms/\" target=\"_blank\" rel=\"noopener noreferrer\">Terms and Conditions</a><br />\n<a href=\"https://databook.com/product-specific-terms#api\" target=\"_blank\" rel=\"noopener noreferrer\">API Terms</a><br />\n<a href=\"https://trust.databook.com/\" target=\"_blank\" rel=\"noopener noreferrer\">Security Trust Center</a><br />\n<a href=\"https://databook.com/\" target=\"_blank\" rel=\"noopener noreferrer\">Databook</a><br />\n\n## Endpoints\n","version":"0.6.0"},"servers":[{"url":"https://api.databook.com"}],"paths":{"/v1/batch/job":{"post":{"tags":["batch - create"],"summary":"Create job","operationId":"create_job_v1_batch_job_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_job_v1_batch_job_post","type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"],"title":"Body_create_job_v1_batch_job_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetJobByIdResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}},"get":{"tags":["batch - query"],"summary":"List jobs","operationId":"list_job_v1_batch_job_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListJobResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/batch/job/input-csv-template":{"get":{"tags":["batch - create"],"summary":"Get input CSV template","operationId":"get_job_input_csv_template_v1_batch_job_input_csv_template_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetJobInputCsvTemplateResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/batch/job/{job_id}":{"get":{"tags":["batch - query"],"summary":"Get job by id","operationId":"get_job_by_id_v1_batch_job__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetJobByIdResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/batch/job/{job_id}/result":{"get":{"tags":["batch - query"],"summary":"Get job result by id","operationId":"get_job_result_by_id_v1_batch_job__job_id__result_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetJobResultByIdResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/chat":{"post":{"tags":["chat"],"summary":"Create a chat","description":"Send a input messages with text, and the model will generate the next message in the conversation.","operationId":"chat_v1_chat_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/insights":{"get":{"tags":["batch - create"],"summary":"List insights","operationId":"list_insights_v1_insights_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListInsightResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/asset/library":{"get":{"tags":["asset_studio"],"summary":"List library availalbe to the authenticated user","description":"Lists all the assets available to generate","operationId":"list_services_v1_asset_library_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sory by field","default":"sortOrder","title":"Sort"},"description":"Sory by field"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Max number of items to return.","default":99,"title":"Limit"},"description":"Max number of items to return."},{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LibraryListItem"},"title":"Response List Services V1 Asset Library Get"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/asset/generated":{"get":{"tags":["asset_studio"],"summary":"List generated assets","description":"Lists asset requests for the authenticated user.","operationId":"list_requests_v1_asset_generated_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number of results.","default":1,"title":"Page"},"description":"Page number of results."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Max number of requests to return.","default":10,"title":"Limit"},"description":"Max number of requests to return."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"Sort as JSON, e.g. {\"createdAt\":\"desc\"}.","default":"{\"createdAt\":\"desc\"}","title":"Sort"},"description":"Sort as JSON, e.g. {\"createdAt\":\"desc\"}."},{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GeneratedAssetItem"},"title":"Response List Requests V1 Asset Generated Get"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/asset/generated/{asset_generation_id}":{"get":{"tags":["asset_studio"],"summary":"Get generated asset by it's generation id","description":"Get a generated asset by it's generation id","operationId":"get_generated_asset_v1_asset_generated__asset_generation_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"asset_generation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The ID of the generated asset","title":"Asset Generation Id"},"description":"The ID of the generated asset"},{"name":"get_download_url","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to get the download url for the generated asset. Default is false.","default":false,"title":"Get Download Url"},"description":"Whether to get the download url for the generated asset. Default is false."},{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneratedAssetItem"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/asset/generate":{"post":{"tags":["asset_studio"],"summary":"Generate asset","description":"Creates an asset generation request for the authenticated user.","operationId":"generate_asset_v1_asset_generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"library_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Library Id"}},{"name":"company_id","in":"query","required":true,"schema":{"type":"string","description":"MongoDB ObjectId (24-character hex).","examples":["000000000000000000000000"],"format":"ObjectId","title":"Company Id"}},{"name":"professional_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","description":"MongoDB ObjectId (24-character hex).","examples":["000000000000000000000000"],"format":"ObjectId"},{"type":"null"}],"title":"Professional Id"}},{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewAssetCreationResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/asset/companies/{company_id}/professionals":{"get":{"tags":["asset_studio"],"summary":"List professionals by company","description":"Lists active, non-archived professionals for a company, including role information.","operationId":"list_professionals_v1_asset_companies__company_id__professionals_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Max number of professionals to return.","default":9999,"title":"Limit"},"description":"Max number of professionals to return."},{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProfessionalListItem"},"title":"Response List Professionals V1 Asset Companies  Company Id  Professionals Get"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/asset/companies":{"get":{"tags":["asset_studio"],"summary":"Search companies by name","description":"Searches companies available for asset generation. Returns company id, name, logo, and nickname.","operationId":"search_companies_v1_asset_companies_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"Search query.","examples":["acme"],"title":"Q"},"description":"Search query."},{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TypesenseSearchResult"},"title":"Response Search Companies V1 Asset Companies Get"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}},"/v1/reasoning":{"post":{"tags":["reasoning"],"summary":"Run deep reasoning","description":"Run deep reasoning with the given agent and parameters.","operationId":"run_reasoning_v1_reasoning_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"citations","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ReasoningCitationsMode","description":"Which citations to include in the response. `all` returns every citation gathered while running the agent. `mentioned` returns only the citations referenced by the agent's final output. `none` returns no citations.","default":"mentioned"},"description":"Which citations to include in the response. `all` returns every citation gathered while running the agent. `mentioned` returns only the citations referenced by the agent's final output. `none` returns no citations."},{"name":"databook-user-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-User-Id"}},{"name":"databook-tenant-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Databook-Tenant-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostReasoningRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostReasoningResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidRequest"}}}},"401":{"description":"Invalid authentication","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInvalidAuthentication"}}}},"404":{"description":"Requested resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRequestedResourceNotFound"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyRateLimitReached"}}}},"500":{"description":"Unexpected error on server side","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyInternalServer"}}}},"503":{"description":"Server side overload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseBodyServerSideOverload"}}}}}}}},"components":{"schemas":{"AssetGenerationStatus":{"type":"string","enum":["pending","limit exceeded","in-progress","completed","cancelled","error"],"title":"AssetGenerationStatus"},"Body_create_job_v1_batch_job_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_create_job_v1_batch_job_post"},"ChatRequest":{"properties":{"query":{"type":"string","maxLength":20000,"title":"Query","examples":["what was domo's revenue in 2019?"]},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id","examples":[null]}},"type":"object","required":["query"],"title":"ChatRequest"},"ChatResponse":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},

# --- truncated at 32 KB (50 KB total) ---
# Full source: https://artifacts.apis.io/trydatabook-com/openapi/trydatabook-com-openapi.json