Skip to content

Instantly share code, notes, and snippets.

@nicholaschiang

nicholaschiang/openapi.json

Created December 14, 2024 01:01
Show Gist options
  • Save nicholaschiang/cfbb2c267b2b015a12db58d2c21213d5 to your computer and use it in GitHub Desktop.
Save nicholaschiang/cfbb2c267b2b015a12db58d2c21213d5 to your computer and use it in GitHub Desktop.
Download ZIP
Raw
openapi.json
This file has been truncated, but you can view the full file.
{
"openapi": "3.1.0",
"info": { "title": "Numbers Station API", "version": "170.5.1" },
"paths": {
"/api/v1/healthz": {
"get": {
"tags": ["v1", "healthz"],
"summary": "Health Check",
"description": "Return an HTTP OK.",
"operationId": "health_check",
"responses": {
"200": {
"description": "Successful Response",
"content": { "application/json": { "schema": {} } }
}
}
}
},
"/api/v1/version": {
"get": {
"tags": ["v1", "healthz"],
"summary": "Version",
"description": "Return the version of the mlcore web server.",
"operationId": "version",
"responses": {
"200": {
"description": "Successful Response",
"content": { "application/json": { "schema": {} } }
}
}
}
},
"/api/v1/login/access-token": {
"post": {
"tags": ["v1", "login"],
"summary": "Login Access Token",
"description": "OAuth2-compatible token login, get an access token for future requests.\n\nArgs:\n m2m_token: The machine-to-machine token to store in the cache.",
"operationId": "login_access_token",
"parameters": [
{
"name": "m2m_token",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "M2M Token"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/Body_login_access_token_api_v1_login_access_token_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Token" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/login/test-session": {
"get": {
"tags": ["v1", "login"],
"summary": "Temp Check Cookie",
"description": "Return an HTTP OK.",
"operationId": "temp_check_cookie",
"parameters": [
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/AppSession" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/password-recovery/": {
"post": {
"tags": ["v1", "login"],
"summary": "Recover Password",
"description": "Send a password recovery email to a user.",
"operationId": "recover_password",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_recover_password_api_v1_password_recovery__post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Msg" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/reset-password/": {
"post": {
"tags": ["v1", "login"],
"summary": "Reset Password",
"description": "Reset a user's password.",
"operationId": "reset_password",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_reset_password_api_v1_reset_password__post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Msg" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/login/session": {
"post": {
"tags": ["v1", "login", "public"],
"summary": "Login Session",
"description": "Login and get a session-based cookie.\n\nThe response headers will contain the cookie. Note that you must use the cookie for all\nother requests to the API.",
"operationId": "login_session",
"parameters": [
{
"name": "third_party",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"description": "Whether to set a third-party cookie for cross-origin iframes.",
"default": false,
"title": "Third Party"
},
"description": "Whether to set a third-party cookie for cross-origin iframes."
},
{
"name": "slack_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "base64" },
{ "type": "null" }
],
"description": "An optional base64-encoded Slack {team_id}:{user_id} to link to (for use by the NS Slack App).",
"title": "Slack Id"
},
"description": "An optional base64-encoded Slack {team_id}:{user_id} to link to (for use by the NS Slack App)."
},
{
"name": "account_name",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"description": "The name of the account to validate that the user is authorized to access. If the user does not have access to this account, the endpoint will return a 403 even if the user is successfully authenticated. This is useful for third party applications which want users to be restricted to a particular account.",
"title": "Account Name"
},
"description": "The name of the account to validate that the user is authorized to access. If the user does not have access to this account, the endpoint will return a 403 even if the user is successfully authenticated. This is useful for third party applications which want users to be restricted to a particular account."
}
],
"requestBody": {
"required": true,
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/Body_login_session_api_v1_login_session_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Login Session Api V1 Login Session Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/logout/session": {
"post": {
"tags": ["v1", "login", "public"],
"summary": "Logout Session",
"description": "Logout and unset session-based cookie value.",
"operationId": "logout_session",
"parameters": [
{
"name": "third_party",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"description": "Whether to set a third-party cookie for cross-origin iframes.",
"default": false,
"title": "Third Party"
},
"description": "Whether to set a third-party cookie for cross-origin iframes."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Logout Session Api V1 Logout Session Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/login/session/oauth": {
"get": {
"tags": ["v1", "login", "public"],
"summary": "Login Session Oauth",
"description": "Login via OAuth2.0 authorization code flow with PKCE.\n\nThe currently supported OAuth2.0 providers are:\n- Okta\n- Google",
"operationId": "login_session_oauth",
"parameters": [
{
"name": "provider",
"in": "query",
"required": true,
"schema": {
"allOf": [{ "$ref": "#/components/schemas/Provider" }],
"description": "The OAuth provider. At the moment this defaults to 'okta' but this default will be removed in the future. Please specify the provider explicitly to avoid issues.",
"title": "Provider"
},
"description": "The OAuth provider. At the moment this defaults to 'okta' but this default will be removed in the future. Please specify the provider explicitly to avoid issues."
},
{
"name": "account_name",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"description": "The name of the account to validate that the user is authorized to access. If the user does not have access to this account, the endpoint will return a 403 even if the user is successfully authenticated. This is useful for third party applications which want users to be restricted to a particular account.",
"title": "Account Name"
},
"description": "The name of the account to validate that the user is authorized to access. If the user does not have access to this account, the endpoint will return a 403 even if the user is successfully authenticated. This is useful for third party applications which want users to be restricted to a particular account."
},
{
"name": "redirect_header",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"description": "Whether to redirect at the HTTP level or not. Browsers set origin=null if a cross-origin resource redirects to yet another origin. This can be problematic for an embedded iframe. Instead, setting redirect to False puts the redirect information in the response body. Then it is up to the client to handle the redirect themselves.",
"default": false,
"title": "Redirect Header"
},
"description": "Whether to redirect at the HTTP level or not. Browsers set origin=null if a cross-origin resource redirects to yet another origin. This can be problematic for an embedded iframe. Instead, setting redirect to False puts the redirect information in the response body. Then it is up to the client to handle the redirect themselves."
},
{
"name": "redirect_uri",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"description": "The URI to redirect to after the login is complete. This is needed for clients to redirect back to the original page. When OAuth is complete, the user will be redirected to this URI. If the login is successful, a session cookie will be set. If the login is unsuccessful, an error parameter will be set in the redirect_uri query params. If this value is set to None then the redirect_uri will default to https://app.numbersstation.ai/login.",
"title": "Redirect Uri"
},
"description": "The URI to redirect to after the login is complete. This is needed for clients to redirect back to the original page. When OAuth is complete, the user will be redirected to this URI. If the login is successful, a session cookie will be set. If the login is unsuccessful, an error parameter will be set in the redirect_uri query params. If this value is set to None then the redirect_uri will default to https://app.numbersstation.ai/login."
},
{
"name": "third_party",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"description": "Whether to set a third-party cookie for cross-origin iframes.",
"default": false,
"title": "Third Party"
},
"description": "Whether to set a third-party cookie for cross-origin iframes."
},
{
"name": "slack_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "base64" },
{ "type": "null" }
],
"description": "An optional base64-encoded Slack {team_id}:{user_id} to link to (for use by the NS Slack App).",
"title": "Slack Id"
},
"description": "An optional base64-encoded Slack {team_id}:{user_id} to link to (for use by the NS Slack App)."
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Login Session Oauth Api V1 Login Session Oauth Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/auth/oauth": {
"get": {
"tags": ["v1", "login"],
"summary": "Callback",
"description": "Callback handler.\n\nDo not call this endpoint directly. It is used by the OAuth2.0 authorization code flow with PKCE.\nThis will redirect the user to the redirect_uri specified in the original request. If the auth\nis successful, then a session cookie will be set. If the auth is unsuccessful, then an error\nparameter will be set in the redirect_uri query params.\ne.g. app.numbersstation.ai/login?error=An%20error%20occurred",
"operationId": "callback",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "title": "Response Callback Api V1 Auth Oauth Get" }
}
}
}
}
}
},
"/api/v1/login/session/firebase": {
"post": {
"tags": ["v1", "login"],
"summary": "Login Session Firebase",
"description": "Login via Firebase.",
"operationId": "login_session_firebase",
"parameters": [
{
"name": "id_token",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Id Token" }
},
{
"name": "account_name",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Login Session Firebase Api V1 Login Session Firebase Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/api_key": {
"post": {
"tags": ["v1", "api_key"],
"summary": "Create Api Key",
"description": "Create a new API key.",
"operationId": "create_api_key",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/APIKeyAPICreate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIKeyCreateResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "api_key"],
"summary": "Delete Api Key",
"description": "Delete the account's API Key.",
"operationId": "delete_api_key",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Read Accounts",
"description": "Retrieve accounts.\n\nIf name is provided, case-insensitive substring matching is performed.",
"operationId": "read_accounts",
"parameters": [
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "name",
"in": "query",
"required": false,
"schema": { "type": "string", "default": "", "title": "Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Account" },
"title": "Response Read Accounts Api V1 Accounts Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "accounts"],
"summary": "Create Account",
"description": "Create new account.",
"operationId": "create_account",
"parameters": [
{
"name": "preload_demo_dataset",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Preload Demo Dataset"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/AccountCreate" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Account" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Read Account By Name",
"description": "Get a specific account by name.",
"operationId": "read_account_by_name",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Account" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "accounts"],
"summary": "Update Account",
"description": "Update a account.",
"operationId": "update_account",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/AccountUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Account" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/domains": {
"post": {
"tags": ["v1", "accounts"],
"summary": "Add Account Allowed Domain",
"description": "Add an allowed email domain to an account.",
"operationId": "add_account_allowed_domain",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "type": "string", "title": "Name" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Domain" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/domains/{domain_id}": {
"delete": {
"tags": ["v1", "accounts"],
"summary": "Remove Account Allowed Domain",
"description": "Remove an allowed email domain to an account.",
"operationId": "remove_account_allowed_domain",
"parameters": [
{
"name": "domain_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Domain Id"
}
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/tags": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Read Account Tags",
"description": "Get all the tags for an account.",
"operationId": "read_account_tags",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "filter_str",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Filter Str"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Tag" },
"title": "Response Read Account Tags Api V1 Accounts Account Name Tags Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "accounts"],
"summary": "Create Account Tag",
"description": "Create a tag for an account.",
"operationId": "create_account_tag",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TagAPICreate" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Tag" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/tags/{tag_id}": {
"delete": {
"tags": ["v1", "accounts"],
"summary": "Delete Account Tag",
"description": "Delete a tag for an account.",
"operationId": "delete_account_tag",
"parameters": [
{
"name": "tag_id",
"in": "path",
"required": true,
"schema": { "type": "string", "format": "uuid4", "title": "Tag Id" }
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/settings": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Read Account Settings",
"description": "Get all client visible settings for an account.",
"operationId": "read_account_settings",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ClientSafeAccountSettings"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"patch": {
"tags": ["v1", "accounts"],
"summary": "Update Account Settings",
"description": "Update settings for an account.",
"operationId": "update_account_settings",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "type": "object", "title": "Settings In" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ClientSafeAccountSettings"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/all_settings": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Read Account Settings All",
"description": "Get all settings for an account.",
"operationId": "read_account_settings_all",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/AccountSettings" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/settings/reset": {
"put": {
"tags": ["v1", "accounts"],
"summary": "Reset Account Settings",
"description": "Reset settings for an account.\n\nResets the specified settings to their default values.",
"operationId": "reset_account_settings",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Settings In"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ClientSafeAccountSettings"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/superuser-settings": {
"patch": {
"tags": ["v1", "accounts"],
"summary": "Update Account Superuser Settings",
"description": "Update superuser settings for an account.\n\nSuperuser settings take precedence over regular account settings.",
"operationId": "update_account_superuser_settings",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "type": "object", "title": "Settings In" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ClientSafeAccountSettings"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/superuser-settings/reset": {
"put": {
"tags": ["v1", "accounts"],
"summary": "Reset Account Superuser Settings",
"description": "Reset superuser settings for an account.\n\nResets the specified settings to their default values. Note that\nsuperuser settings take precedence over regular account settings.",
"operationId": "reset_account_superuser_settings",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Settings In"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ClientSafeAccountSettings"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/users": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Get Account Users",
"description": "Get all users in the account.",
"operationId": "get_account_users",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/User" },
"title": "Response Get Account Users Api V1 Accounts Account Name Users Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "accounts"],
"summary": "Add Account Users",
"description": "Add users to the account.\n\nReturns a list of the IDs which were invalid.",
"operationId": "add_account_users",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "User Ids"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "Response Add Account Users Api V1 Accounts Account Name Users Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "accounts"],
"summary": "Rm Account Users",
"description": "Remove users to the account.\n\nReturns a list of the IDs which were invalid.",
"operationId": "rm_account_users",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "User Ids"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "Response Rm Account Users Api V1 Accounts Account Name Users Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/preregistrations": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Get Account Preregistrations",
"description": "Get all preregistrations in the account.",
"operationId": "get_account_preregistrations",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Preregistration" },
"title": "Response Get Account Preregistrations Api V1 Accounts Account Name Preregistrations Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/preregistrations/{preregistration_id}": {
"delete": {
"tags": ["v1", "accounts"],
"summary": "Delete Preregistration",
"description": "Delete a preregistration.",
"operationId": "delete_preregistration",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "preregistration_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Preregistration Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/users_by_emails": {
"put": {
"tags": ["v1", "accounts"],
"summary": "Add Account Users By Emails",
"description": "Add users to the account by their email.\n\nReturns a list of the emails which were invalid.",
"operationId": "add_account_users_by_emails",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "User Emails"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Add Account Users By Emails Api V1 Accounts Account Name Users By Emails Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/admins": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Get Account Admins",
"description": "Get account admins.",
"operationId": "get_account_admins",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/User" },
"title": "Response Get Account Admins Api V1 Accounts Account Name Admins Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "accounts"],
"summary": "Add Account Admins",
"description": "Add admin users to the account.\n\nThis will add users to the account if they are not already included.",
"operationId": "add_account_admins",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "User Ids"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "Response Add Account Admins Api V1 Accounts Account Name Admins Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "accounts"],
"summary": "Rm Account Admins",
"description": "Remove admin privileges from users of the account.\n\nNote that this does NOT remove the user themselves from the account.",
"operationId": "rm_account_admins",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "User Ids"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "Response Rm Account Admins Api V1 Accounts Account Name Admins Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/eval_maintainers": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Get Account Eval Maintainers",
"description": "Get account eval maintainers.",
"operationId": "get_account_eval_maintainers",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/User" },
"title": "Response Get Account Eval Maintainers Api V1 Accounts Account Name Eval Maintainers Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "accounts"],
"summary": "Add Account Eval Maintainers",
"description": "Add eval maintainers to the account.\n\nThis will add users to the account if they are not already included.",
"operationId": "add_account_eval_maintainers",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "User Ids"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "Response Add Account Eval Maintainers Api V1 Accounts Account Name Eval Maintainers Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "accounts"],
"summary": "Rm Account Eval Maintainers",
"description": "Remove eval maintainer privileges from users of the account.\n\nNote that this does NOT remove the user themselves from the account.",
"operationId": "rm_account_eval_maintainers",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "User Ids"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "Response Rm Account Eval Maintainers Api V1 Accounts Account Name Eval Maintainers Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/engines": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Get Account Engines",
"description": "Get manifest engines of the account.",
"operationId": "get_account_engines",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Get Account Engines Api V1 Accounts Account Name Engines Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/upload_conversations": {
"post": {
"tags": ["v1", "accounts"],
"summary": "Bulk Create Conversations",
"description": "Upload conversations to an account.\n\nAttempts to create with the same user, but will default to the admin\nif the user doesn't belong to the account.",
"operationId": "bulk_create_conversations",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/ConversationBasic" },
"title": "Conversations"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/ConversationBasic" },
"title": "Response Bulk Create Conversations Api V1 Accounts Account Name Upload Conversations Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/register_user": {
"post": {
"tags": ["v1", "accounts"],
"summary": "Register User",
"description": "Register a user to an account.\n\nIf it is an SSO environment, the user will be created if it doesn't\nalready exist, then it will be added to the account.\n\nIf it is not an SSO environment and the user already exists on a different account,\nthe user will be added to the new account, and they will be sent an account invite email\n\nIf it is not an SSO environment and the user does NOT exist,\nthe user will be preregistered, and they will be sent a preregistration email",
"operationId": "register_user",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/UserAddToAccount" }
}
}
},
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/pending_assistance_count": {
"get": {
"tags": ["v1", "accounts"],
"summary": "Get Pending Assistance Count",
"description": "Get the count of all pending assistance requests for an account, grouped by ssds_id.\n\nPending assistance requests, previously known as Bad responses, are cells\nthat users have requested a data admin inspect and verify.\n\nThis endpoint is used in the application to show the admin how many\ncells are pending assistance.",
"operationId": "get_pending_assistance_count",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Skip"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Limit"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": { "type": "integer" },
"title": "Response Get Pending Assistance Count Api V1 Accounts Account Name Pending Assistance Count Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/sync_knowledge_sql": {
"post": {
"tags": ["v1", "accounts"],
"summary": "Sync Knowledge Sql",
"description": "Sync knowledge sql for an account.",
"operationId": "sync_knowledge_sql",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Ssds Ids"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/enterprises/": {
"get": {
"tags": ["v1", "enterprises"],
"summary": "Read Enterprises",
"description": "Retrieve enterprises.",
"operationId": "read_enterprises",
"parameters": [
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Enterprise" },
"title": "Response Read Enterprises Api V1 Enterprises Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "enterprises"],
"summary": "Create Enterprise",
"description": "Create new enterprise.",
"operationId": "create_enterprise",
"parameters": [
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/EnterpriseCreate" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Enterprise" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/enterprises/{enterprise_name}": {
"get": {
"tags": ["v1", "enterprises"],
"summary": "Read Enterprise By Name",
"description": "Get a specific enterprise by name.",
"operationId": "read_enterprise_by_name",
"parameters": [
{
"name": "enterprise_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Enterprise Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Enterprise" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "enterprises"],
"summary": "Update Enterprise",
"description": "Update a enterprise.",
"operationId": "update_enterprise",
"parameters": [
{
"name": "enterprise_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Enterprise Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/EnterpriseUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Enterprise" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/enterprises/{enterprise_name}/users": {
"get": {
"tags": ["v1", "enterprises"],
"summary": "Get Enterprise Users",
"description": "Get all users in the enterprise.",
"operationId": "get_enterprise_users",
"parameters": [
{
"name": "enterprise_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Enterprise Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/User" },
"title": "Response Get Enterprise Users Api V1 Enterprises Enterprise Name Users Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/enterprises/{enterprise_name}/accounts": {
"get": {
"tags": ["v1", "enterprises"],
"summary": "Get Enterprise Accounts",
"description": "Get all accounts in the enterprise.",
"operationId": "get_enterprise_accounts",
"parameters": [
{
"name": "enterprise_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Enterprise Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Account" },
"title": "Response Get Enterprise Accounts Api V1 Enterprises Enterprise Name Accounts Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "enterprises"],
"summary": "Add New Account To Enterprise",
"description": "Create a new account in the enterprise.",
"operationId": "add_new_account_to_enterprise",
"parameters": [
{
"name": "enterprise_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Enterprise Name" }
},
{
"name": "preload_demo_dataset",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Preload Demo Dataset"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/AccountCreate" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Account" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "enterprises"],
"summary": "Add Accounts To Enterprise",
"description": "Add existing accounts to the enterprise.\n\nThis is intended to be only used by the superuser.\n\nReturns: A list of account names that were not able to be added.",
"operationId": "add_accounts_to_enterprise",
"parameters": [
{
"name": "enterprise_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Enterprise Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Account Names"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Add Accounts To Enterprise Api V1 Enterprises Enterprise Name Accounts Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "enterprises"],
"summary": "Rm Accounts From Enterprise",
"description": "Remove accounts from the enterprise.\n\nThis is intended to be only used by the superuser.\n\nReturns: A list of account names that were not able to be removed.",
"operationId": "rm_accounts_from_enterprise",
"parameters": [
{
"name": "enterprise_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Enterprise Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Account Names"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Rm Accounts From Enterprise Api V1 Enterprises Enterprise Name Accounts Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/enterprises/{enterprise_name}/admins": {
"put": {
"tags": ["v1", "enterprises"],
"summary": "Add Enterprise Admins",
"description": "Add admin users to the enterprise.\n\nThis propogates by adding the user as both a user and admin to all accounts in the enterprise.\n\nReturns: A list of UUIDs of users that were not able to be added.",
"operationId": "add_enterprise_admins",
"parameters": [
{
"name": "enterprise_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Enterprise Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "User Ids"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "Response Add Enterprise Admins Api V1 Enterprises Enterprise Name Admins Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "enterprises"],
"summary": "Rm Enterprise Admins",
"description": "Remove admin privileges from the specified users.\n\nThis does not propogate. That is, users remain in the accounts in the enterprise.\n\nReturns: a list of the IDs which were invalid.",
"operationId": "rm_enterprise_admins",
"parameters": [
{
"name": "enterprise_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Enterprise Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "User Ids"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "Response Rm Enterprise Admins Api V1 Enterprises Enterprise Name Admins Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/tasks/ids": {
"get": {
"tags": ["v1", "tasks"],
"summary": "Read Tasks By Ids",
"description": "Get specific task(s) by id(s).",
"operationId": "read_tasks_by_ids",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "task_id",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"description": "A list of task ids to retrieve.",
"default": [],
"title": "Task Id"
},
"description": "A list of task ids to retrieve."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Task" },
"title": "Response Read Tasks By Ids Api V1 Accounts Account Name Tasks Ids Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/tasks/{task_id}": {
"get": {
"tags": ["v1", "tasks"],
"summary": "Read Task By Id",
"description": "Get a specific task by id.",
"operationId": "read_task_by_id",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "task_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Task Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/tasks": {
"get": {
"tags": ["v1", "tasks"],
"summary": "Read Tasks By Account",
"description": "Read tasks by account.",
"operationId": "read_tasks_by_account",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "name",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/TaskName" },
{ "type": "null" }
],
"title": "Name"
}
},
{
"name": "status",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/TaskStatus" },
{ "type": "null" }
],
"title": "Status"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TaskPage" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/": {
"get": {
"tags": ["v1", "users"],
"summary": "Read Users",
"description": "Retrieve users.",
"operationId": "read_users",
"parameters": [
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "email",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Email"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/User" },
"title": "Response Read Users Api V1 Users Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "users"],
"summary": "Create User",
"description": "Create new user.",
"operationId": "create_user",
"parameters": [
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/UserCreate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/User" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/me": {
"put": {
"tags": ["v1", "users"],
"summary": "Update User Me",
"description": "Update own user.",
"operationId": "update_user_me",
"parameters": [
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/Body_update_user_me_api_v1_users_me_put"
}
],
"title": "Body"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/User" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v1", "users"],
"summary": "Read User Me",
"description": "Get current user.",
"operationId": "read_user_me",
"parameters": [
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/User" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/jwt_token": {
"get": {
"tags": ["v1", "users"],
"summary": "Read User Jwt Token",
"description": "Get current user's jwt token.",
"operationId": "read_user_jwt_token",
"parameters": [
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/JWTToken" },
{ "type": "null" }
],
"title": "Response Read User Jwt Token Api V1 Users Jwt Token Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/accounts": {
"get": {
"tags": ["v1", "users"],
"summary": "Read Accounts By Current User",
"description": "Get accounts by user.",
"operationId": "read_accounts_by_current_user",
"parameters": [
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Account" },
"title": "Response Read Accounts By Current User Api V1 Users Accounts Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/username_exists": {
"get": {
"tags": ["v1", "users"],
"summary": "Check Username Exists",
"description": "Check if username exists.",
"operationId": "check_username_exists",
"parameters": [
{
"name": "username",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Username" }
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "boolean",
"title": "Response Check Username Exists Api V1 Users Username Exists Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/open": {
"post": {
"tags": ["v1", "users"],
"summary": "Create User Open",
"description": "Create new user without the need to be logged in.",
"operationId": "create_user_open",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_create_user_open_api_v1_users_open_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/User" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/{user_id}": {
"get": {
"tags": ["v1", "users"],
"summary": "Read User By Id",
"description": "Get a specific user by id.",
"operationId": "read_user_by_id",
"parameters": [
{
"name": "user_id",
"in": "path",
"required": true,
"schema": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "User Id"
}
},
{
"name": "user_email",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "email" },
{ "type": "null" }
],
"title": "User Email"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/User" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "users"],
"summary": "Update User",
"description": "Update a user.",
"operationId": "update_user",
"parameters": [
{
"name": "user_id",
"in": "path",
"required": true,
"schema": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "User Id"
}
},
{
"name": "user_email",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "email" },
{ "type": "null" }
],
"title": "User Email"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/UserUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/User" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/preregistration": {
"post": {
"tags": ["v1", "users"],
"summary": "Preregister User",
"description": "Create a preregistration.",
"operationId": "preregister_user",
"parameters": [
{
"name": "account_name",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/PreregistrationCreate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Preregistration" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/preregistration/{preregistration_id}/resend-invite": {
"post": {
"tags": ["v1", "users"],
"summary": "Resend Email",
"description": "Re-send a preregistration welcome email.",
"operationId": "resend_email",
"parameters": [
{
"name": "preregistration_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Preregistration Id"
}
},
{
"name": "account_name",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/users/preregistration/{preregistration_id}": {
"post": {
"tags": ["v1", "users"],
"summary": "Compelete Preregistration",
"description": "Register a user.",
"operationId": "compelete_preregistration",
"parameters": [
{
"name": "preregistration_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Preregistration Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/UserCreate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/User" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/utils/test-celery/": {
"post": {
"tags": ["v1", "utils"],
"summary": "Test Celery Response",
"description": "Test Celery worker.",
"operationId": "test_celery_response",
"parameters": [
{
"name": "account_name",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Msg" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/semantic_query/{semantic_query_id}": {
"get": {
"tags": ["v1", "semantic_query"],
"summary": "Get Semantic Query",
"description": "Get a semantic query.",
"operationId": "get_semantic_query",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "semantic_query_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Semantic Query Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Get Semantic Query Api V1 Accounts Account Name Semantic Query Semantic Query Id Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/clone": {
"post": {
"tags": ["v1", "conversations"],
"summary": "Clone Conversation",
"description": "Clone a conversation with the new user as the creator.",
"operationId": "clone_conversation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "is_eval_conversation",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Is Eval Conversation"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConversationBasic" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}": {
"get": {
"tags": ["v1", "conversations"],
"summary": "Get Conversation",
"description": "Get a full conversation.",
"operationId": "get_conversation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConversationFull" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "conversations"],
"summary": "Delete Conversation",
"description": "Delete a conversation.",
"operationId": "delete_conversation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "conversations"],
"summary": "Update Conversation",
"description": "Update a conversation.",
"operationId": "update_conversation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConversationAPIUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConversationBasic" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/basic": {
"get": {
"tags": ["v1", "conversations"],
"summary": "Get Conversation Basic",
"description": "Get a basic conversation.",
"operationId": "get_conversation_basic",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConversationBasic" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/": {
"post": {
"tags": ["v1", "conversations"],
"summary": "Create Conversation",
"description": "Create new bumblebee conversation.",
"operationId": "create_conversation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConversationAPICreate" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConversationFull" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v1", "conversations"],
"summary": "Get Conversations",
"description": "Get all conversations for the bumblebee dashboard.\n\nIf show_moonlight is True, show only moonlight conversations\nIf show_moonlight is False, show only non-moonlight conversations\nIf show_moonlight is None, show everything.",
"operationId": "get_conversations",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "sort_ascending",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Sort Ascending"
}
},
{
"name": "sort_by",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/ConversationsSort" },
{ "type": "null" }
],
"title": "Sort By"
}
},
{
"name": "filter_by",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/ConversationsFilter" },
{ "type": "null" }
],
"title": "Filter By"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Limit"
}
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "show_moonlight",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Show Moonlight"
}
},
{
"name": "show_eval",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Show Eval"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/ConversationBasic" },
"title": "Response Get Conversations Api V1 Accounts Account Name Conversations Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/pins": {
"post": {
"tags": ["v1", "conversations"],
"summary": "Pin Conversation",
"description": "Pin a bumblebee conversation to the account home page.",
"operationId": "pin_conversation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConversationAPIUpdate" }
}
}
},
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "conversations"],
"summary": "Unpin Conversation",
"description": "Unpin a bumblebee conversation to the account home page.",
"operationId": "unpin_conversation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/stars": {
"post": {
"tags": ["v1", "conversations"],
"summary": "Star Conversation",
"description": "Star a bumblebee conversation.",
"operationId": "star_conversation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "conversations"],
"summary": "Unstar Conversation",
"description": "Unstar a bumblebee conversation.",
"operationId": "unstar_conversation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cell/{cell_id}/run_bumblebee_cell": {
"post": {
"tags": ["v1", "conversations"],
"summary": "Run Bumblebee Cell",
"description": "Run bumblebee for an already created cell.",
"operationId": "run_bumblebee_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/MoonlightRunParams" },
{ "type": "null" }
],
"title": "Moonlight Run Params"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/RunBBCellResponse" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/run_moonlight": {
"post": {
"tags": ["v1", "conversations"],
"summary": "Run Moonlight",
"description": "Run Moonlight.",
"operationId": "run_moonlight",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MoonlightRunInputAPI" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "string",
"title": "Response Run Moonlight Api V1 Accounts Account Name Conversations Conversation Id Run Moonlight Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cell/{cell_id}/run_moonlight_cell": {
"post": {
"tags": ["v1", "conversations"],
"summary": "Run Moonlight Cell",
"description": "Run moonlight for an already created cell.",
"operationId": "run_moonlight_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MoonlightRunInputAPI" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "string",
"title": "Response Run Moonlight Cell Api V1 Accounts Account Name Conversations Conversation Id Cell Cell Id Run Moonlight Cell Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/eval_cell": {
"post": {
"tags": ["v1", "conversations"],
"summary": "Create Eval Cell",
"description": "Create a new Evaluation Bumblebee Cell in an Evaluation Conversation.\n\nArgs:\n eval_bb_cell_in: Eval cell creation API. Only required if cell_id is None.\n source_cell_id: source id to create eval cell from.\n conversation_id: Optional, to append cell to an existing eval conversation.",
"operationId": "create_eval_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "source_cell_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Source Cell Id"
}
},
{
"name": "conversation_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/EvalBumblebeeCellAPICreate" },
{ "type": "null" }
],
"title": "Eval Bb Cell In"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/": {
"get": {
"tags": ["v1", "cells"],
"summary": "Read Cells",
"description": "Read Bumblebee Cells for a conversation.",
"operationId": "read_cells",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "with_feedback",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "With Feedback"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/BumblebeeCell" },
"title": "Response Read Cells Api V1 Accounts Account Name Conversations Conversation Id Cells Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "cells"],
"summary": "Create Cell",
"description": "Create a new Bumblebee Cell.",
"operationId": "create_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BumblebeeCellAPICreate"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/basic": {
"get": {
"tags": ["v1", "cells"],
"summary": "Read Cells Basic",
"description": "Read Bumblebee Cells for a conversation.",
"operationId": "read_cells_basic",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BumblebeeCellBasic"
},
"title": "Response Read Cells Basic Api V1 Accounts Account Name Conversations Conversation Id Cells Basic Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}": {
"get": {
"tags": ["v1", "cells"],
"summary": "Read Cell",
"description": "Get Bumblebee Cell.",
"operationId": "read_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "cells"],
"summary": "Update Cell",
"description": "Update a Bumblebee Cell.",
"operationId": "update_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BumblebeeCellAPIUpdate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "cells"],
"summary": "Delete Cell",
"description": "Delete a Bumblebee Cell.",
"operationId": "delete_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete Cell Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/metric_options": {
"get": {
"tags": ["v1", "cells"],
"summary": "Get Cell Metric Options",
"description": "Get cell metric options.\n\nDEPRECATED. Use get_ssds_metrics instead.\n\nThis represents the available metrics for the cell that could be manually added.",
"operationId": "get_cell_metric_options",
"deprecated": true,
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/MetricView" },
"title": "Response Get Cell Metric Options Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Metric Options Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/filter_options": {
"get": {
"tags": ["v1", "cells"],
"summary": "Get Cell Filter Options",
"description": "Get cell filter options.",
"operationId": "get_cell_filter_options",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BumblebeeCellFilterOptionWithGroup"
},
"title": "Response Get Cell Filter Options Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Filter Options Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/admin_only": {
"put": {
"tags": ["v1", "cells"],
"summary": "Update Cell Admin Only",
"description": "Update a Bumblebee Cell's question only.\n\nThis is an admin endpoint. One use case is question-only update of sensitive cells.",
"operationId": "update_cell_admin_only",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCellUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/refresh": {
"put": {
"tags": ["v1", "cells"],
"summary": "Refresh Bumblebee Cell",
"description": "Refresh the bumblebee cell's data.",
"operationId": "refresh_bumblebee_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/semanticlayerview": {
"put": {
"tags": ["v1", "cells"],
"summary": "Update Cell Semanticlayerview",
"description": "Update the semantic layer view of a cell.\n\nThe `name` field of each Dimension or Metric in the `order` parameter should be prefixed\n with '-' if the sort order is descending.\n\nArgs:\n skip_cell_refresh: instead of issuing a cell refresh, delete the underlying cell table and don't issue a new SQL query.\n remove_feedback: remove any existing cell feedback when we update the cell. This defaults to false, but should be set to true for user edits.\nRaises:\n NSRuntimeError if the semantic layer view is invalid.\n NSUnauthorizedError if the cell is verified and the user is not an admin.",
"operationId": "update_cell_semanticlayerview",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "skip_cell_refresh",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Skip Cell Refresh"
}
},
{
"name": "remove_feedback",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Remove Feedback"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SemanticLayerView" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpdateSemanticLayerViewResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/tags": {
"post": {
"tags": ["v1", "cells"],
"summary": "Add Tag",
"description": "Add a tag to a bumblebee cell. Creates it if it does not exist.",
"operationId": "add_tag",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TagAPICreate" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/tags/{tag_id}": {
"delete": {
"tags": ["v1", "cells"],
"summary": "Remove Tag",
"description": "Remove a tag from a bumblebee cell.",
"operationId": "remove_tag",
"parameters": [
{
"name": "tag_id",
"in": "path",
"required": true,
"schema": { "type": "string", "format": "uuid4", "title": "Tag Id" }
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/bad_response": {
"post": {
"tags": ["v1", "cells"],
"summary": "Add Bad Response",
"description": "Add bad repsonse to a bumblebee cell.",
"operationId": "add_bad_response",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BadResponseAPICreate" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "cells"],
"summary": "Remove Bad Response",
"description": "Remove bad responses from a bumblebee cell.",
"operationId": "remove_bad_response",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/verified": {
"post": {
"tags": ["v1", "cells"],
"summary": "Verify Cell",
"description": "Add positive feedback to a bumblebee cell.",
"operationId": "verify_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "allow_conflicting_feedback",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Allow Conflicting Feedback"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "cells"],
"summary": "Unverify Cell",
"description": "Add feedback to a bumblebee cell.",
"operationId": "unverify_cell",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/prompt_knowledge_sql": {
"get": {
"tags": ["v1", "cells"],
"summary": "Get Prompt Knowledge Sql",
"description": "Get the prompt knowledge sql from the semantic query.\n\nThis is the knowledge sql that is used as demonstration for the prompt.",
"operationId": "get_prompt_knowledge_sql",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "string",
"title": "Response Get Prompt Knowledge Sql Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Prompt Knowledge Sql Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/knowledge_sql": {
"get": {
"tags": ["v1", "cells"],
"summary": "Get Knowledge Sql",
"description": "Get the knowledge sql for the cell.\n\nWhen knowledge sql doesn't exist, create it from the bumblebee cell.",
"operationId": "get_knowledge_sql",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeSQL" },
{ "type": "null" }
],
"title": "Response Get Knowledge Sql Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Knowledge Sql Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/is_user_sensitive": {
"post": {
"tags": ["v1", "cells"],
"summary": "Mark Cell Sensitive",
"description": "Add positive feedback to a bumblebee cell.",
"operationId": "mark_cell_sensitive",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "cells"],
"summary": "Unmark Cell Sensitive",
"description": "Unmark cell sensitive.\n\nIf the cell uses DMs that are sensitive, it cannot be unmarked.",
"operationId": "unmark_cell_sensitive",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/verified_conflicts": {
"put": {
"tags": ["v1", "cells"],
"summary": "Get Verified Conflicts",
"description": "Get list of cells with conflicting feedback.\n\nIf there are any conflicting cells, the user should be notified before verifying the cell.",
"operationId": "get_verified_conflicts",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BumblebeeCellBasic"
},
"title": "Response Get Verified Conflicts Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Verified Conflicts Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/suggested": {
"put": {
"tags": ["v1", "cells"],
"summary": "Update Is Suggested",
"description": "Mark cell as Suggestion",
"operationId": "update_is_suggested",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "is_suggested",
"in": "query",
"required": true,
"schema": { "type": "boolean", "title": "Is Suggested" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeCell" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/filters/{filter_id}": {
"get": {
"tags": ["v1", "cells"],
"summary": "Read Cell Filter",
"description": "Read the specified filter.",
"operationId": "read_cell_filter",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "filter_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Filter Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/DimensionFilter" },
{ "$ref": "#/components/schemas/MetricFilter" }
],
"title": "Response Read Cell Filter Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Filters Filter Id Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/filters": {
"get": {
"tags": ["v1", "cells"],
"summary": "Read Cell Filters",
"description": "Get the filters for a cell.",
"operationId": "read_cell_filters",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"anyOf": [
{ "$ref": "#/components/schemas/DimensionFilter" },
{ "$ref": "#/components/schemas/MetricFilter" }
]
},
"title": "Response Read Cell Filters Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Filters Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/profile": {
"post": {
"tags": ["v1", "cells"],
"summary": "Profile Cell Data",
"description": "Profile the bumblebee cell table columns.\n\nRaises:\nNSCannotReadNodeDataError: If the bumblebee cell table does not exist.",
"operationId": "profile_cell_data",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100000, "title": "Limit" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"type": "array",
"items": { "$ref": "#/components/schemas/TableFilter" }
},
{ "type": "null" }
],
"title": "Filters"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/UnionStatistic"
},
"title": "Response Profile Cell Data Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Profile Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/data": {
"post": {
"tags": ["v1", "cells"],
"summary": "Read Cell Data",
"description": "Get Bumblebee Cell Data.",
"operationId": "read_cell_data",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/Body_read_cell_data_api_v1_accounts__account_name__conversations__conversation_id__cells__cell_id__data_post"
}
],
"title": "Body"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/NodeDataPage" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/data/csv": {
"get": {
"tags": ["v1", "cells"],
"summary": "Read Cell Data As Csv",
"description": "Read Cell data as a CSV.",
"operationId": "read_cell_data_as_csv",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Read Cell Data As Csv Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Data Csv Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/chart/{chart_config_id}": {
"put": {
"tags": ["v1", "cells"],
"summary": "Update Cell Chart Config",
"description": "Update Bumblebee Cell Chart Config.",
"operationId": "update_cell_chart_config",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "chart_config_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Chart Config Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChartConfigAPIUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChartConfig" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v1", "cells"],
"summary": "Read Cell Chart",
"description": "Get Bumblebee Cell Chart Data.",
"operationId": "read_cell_chart",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "chart_config_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Chart Config Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Chart" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/chart": {
"post": {
"tags": ["v1", "cells"],
"summary": "Create Cell Chart Config",
"description": "Create a Bumblebee Cell Chart Config.\n\nCreating will infer the best chart configuration based on the semantic query.",
"operationId": "create_cell_chart_config",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChartConfig" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/tasks": {
"get": {
"tags": ["v1", "cells"],
"summary": "Get Cell Tasks",
"description": "Get all tasks for a cell.",
"operationId": "get_cell_tasks",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Get Cell Tasks Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Tasks Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/sql": {
"get": {
"tags": ["v1", "cells"],
"summary": "Get Bb Cell Sql",
"description": "Get SQL from a bumblebee cell.",
"operationId": "get_bb_cell_sql",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "string",
"title": "Response Get Bb Cell Sql Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Sql Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/validate-filter": {
"post": {
"tags": ["v1", "cells"],
"summary": "Validate Cell Filter",
"description": "Check that the filter is valid.\n\nRaises:\n NSInvalidFilterSQLError if the filter leads to an error in the data warehouse.",
"operationId": "validate_cell_filter",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"oneOf": [
{ "$ref": "#/components/schemas/DimensionFilter" },
{ "$ref": "#/components/schemas/MetricFilter" }
],
"discriminator": {
"propertyName": "field_type",
"mapping": {
"dimension": "#/components/schemas/DimensionFilter",
"metric": "#/components/schemas/MetricFilter"
}
},
"title": "Filter"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Validate Cell Filter Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Validate Filter Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/search_similar": {
"get": {
"tags": ["v1", "cells"],
"summary": "Search Similar Verified Cells",
"description": "Search for similar verified cells.\n\nNOTE: These are not the same cells used during retrieval when the cell was created.\nThis uses the same function to retrieve similar cells, but because this endpoint is\nused each time the cell is loaded, it is possible to retrieve cells that are newly verified\nand similar to the current cell (which the cell did not use when it was run.)\n\nIdeally we can make the BBRetrievedMetadata.retrieved_examples stateful and persisted\nin the cell objects which would allow us to retrieve the same examples each time the cell is loaded.",
"operationId": "search_similar_verified_cells",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 5, "title": "Limit" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BumblebeeCellBasic"
},
"title": "Response Search Similar Verified Cells Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Search Similar Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/conversations/{conversation_id}/cells/{cell_id}/promptlog": {
"get": {
"tags": ["v1", "cells"],
"summary": "Get Cell Promptlog",
"description": "Admin endpoint to the promptlog history of a bumblebee cell.\n\nComponent can be query to filter to that component.\nComponent of ALL will return unified promptlogs for an entire run\n(this is not backwards compatible)\nComponent of None will return any component ordered by time and not unified.\n\nReturns:\n This returns a JSON list of PromptLogs for a cell in reverse chronological order, by\n default only the most recent. The component filters to return logs for everything or query.",
"operationId": "get_cell_promptlog",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "component",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/PromptLogComponent" },
{ "type": "null" }
],
"title": "Component"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 1, "title": "Limit" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/PromptLog" },
"title": "Response Get Cell Promptlog Api V1 Accounts Account Name Conversations Conversation Id Cells Cell Id Promptlog Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/cell_run_events/cell/{cell_id}": {
"get": {
"tags": ["v1", "cell_run_event"],
"summary": "Read Cell Run Events By Cell",
"description": "Read all cell run events by cell id.",
"operationId": "read_cell_run_events_by_cell",
"parameters": [
{
"name": "cell_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
}
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/CellRunEvent" },
"title": "Response Read Cell Run Events By Cell Api V1 Accounts Account Name Cell Run Events Cell Cell Id Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/cell_run_events/run/{run_id}": {
"get": {
"tags": ["v1", "cell_run_event"],
"summary": "Read Cell Run Event By Run Id",
"description": "Read cell run event by run id.",
"operationId": "read_cell_run_event_by_run_id",
"parameters": [
{
"name": "run_id",
"in": "path",
"required": true,
"schema": { "type": "string", "format": "uuid4", "title": "Run Id" }
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/CellRunEvent" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/": {
"get": {
"tags": ["v1", "connections"],
"summary": "Read Connections",
"description": "Read all connections, independent of type.",
"operationId": "read_connections",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConnectionPage" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/{connection_id}/data": {
"get": {
"tags": ["v1", "connections"],
"summary": "Read Connection Data",
"description": "Read data from a data warehouse table without creating a node.",
"operationId": "read_connection_data",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "database",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Database" }
},
{
"name": "schema",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Schema" }
},
{
"name": "table",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Table" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/Body_read_connection_data_api_v1_accounts__account_name__connections__connection_id__data_get"
}
],
"title": "Body"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/NodeDataPage" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/{connection_id}": {
"get": {
"tags": ["v1", "connections"],
"summary": "Read Connection",
"description": "Read Connection, independent of type.",
"operationId": "read_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/BigQueryConnection" },
{ "$ref": "#/components/schemas/PostgresConnection" },
{ "$ref": "#/components/schemas/RedshiftConnection" },
{ "$ref": "#/components/schemas/SnowflakeConnection" },
{ "$ref": "#/components/schemas/DatabricksConnection" },
{ "$ref": "#/components/schemas/TeradataConnection" },
{ "$ref": "#/components/schemas/Connection" }
],
"title": "Response Read Connection Api V1 Accounts Account Name Connections Connection Id Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/csv/": {
"post": {
"tags": ["v1", "connections"],
"summary": "Write Csv To Connection",
"description": "Upload CSV to the warehouse creating a table.\n\nIf no connection_id is provided, a demo connection will be used/created.\n\nWe use File and Form data together since we cannot declare Body fields we want to\naccept as JSON to do the HTTP protocol specification.\n\nRef: https://fastapi.tiangolo.com/tutorial/request-forms-and-files/",
"operationId": "write_csv_to_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_write_csv_to_connection_api_v1_accounts__account_name__connections_csv__post"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TableLocation" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/{connection_id}/tables/metadata": {
"post": {
"tags": ["v1", "connections"],
"summary": "List Tables Metadata",
"description": "List tables metadata.\n\nTables: list of table names in the format database.schema.table (or project.dataset.table for BigQuery)",
"operationId": "list_tables_metadata",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Tables"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response List Tables Metadata Api V1 Accounts Account Name Connections Connection Id Tables Metadata Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/bigquery": {
"post": {
"tags": ["v1", "bigquery"],
"summary": "Create Bigquery Connection",
"description": "Create a new BigQuery connection.",
"operationId": "create_bigquery_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "validate",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Validate"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BigQueryConnectionAPICreate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BigQueryConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/bigquery/{connection_id}/validate": {
"post": {
"tags": ["v1", "bigquery"],
"summary": "Validate Bigquery Connection",
"description": "Validate a BigQuery connection.",
"operationId": "validate_bigquery_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BigQueryConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/bigquery/{connection_id}": {
"get": {
"tags": ["v1", "bigquery"],
"summary": "Read Bigquery Connection",
"description": "Read a BigQuery connection.",
"operationId": "read_bigquery_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BigQueryConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "bigquery"],
"summary": "Update Bigquery Connection",
"description": "Update a BigQuery connection.\n\nNote that all fields for a valid BigQuery connection are required.",
"operationId": "update_bigquery_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "validate",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Validate"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BigQueryConnectionAPIUpdate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BigQueryConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "bigquery"],
"summary": "Delete Bigquery Connection",
"description": "Delete a BigQuery connection.",
"operationId": "delete_bigquery_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BigQueryConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/bigquery/{connection_id}/datasets": {
"get": {
"tags": ["v1", "bigquery"],
"summary": "List Bigquery Datasets",
"description": "List BigQuery datasets.",
"operationId": "list_bigquery_datasets",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response List Bigquery Datasets Api V1 Accounts Account Name Connections Bigquery Connection Id Datasets Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/bigquery/{connection_id}/tables": {
"get": {
"tags": ["v1", "bigquery"],
"summary": "List Bigquery Tables",
"description": "List BigQuery tables.",
"operationId": "list_bigquery_tables",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "dataset",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Dataset"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
}
},
"title": "Response List Bigquery Tables Api V1 Accounts Account Name Connections Bigquery Connection Id Tables Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/bigquery/{connection_id}/columns": {
"get": {
"tags": ["v1", "bigquery"],
"summary": "List Bigquery Columns",
"description": "List BigQuery columns.",
"operationId": "list_bigquery_columns",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "dataset",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Dataset" }
},
{
"name": "table",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Table" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/TableColumn" },
"title": "Response List Bigquery Columns Api V1 Accounts Account Name Connections Bigquery Connection Id Columns Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/databricks/": {
"post": {
"tags": ["v1", "databricks"],
"summary": "Create Databricks Connection",
"description": "Create new Databricks connection.",
"operationId": "create_databricks_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "validate",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Validate"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DatabricksConnectionCreate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DatabricksConnection"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/databricks/{databricks_connection_id}/validate": {
"post": {
"tags": ["v1", "databricks"],
"summary": "Validate Databricks Connection",
"description": "Validate Databricks connection.",
"operationId": "validate_databricks_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "databricks_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Databricks Connection Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DatabricksConnection"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/databricks/{databricks_connection_id}": {
"get": {
"tags": ["v1", "databricks"],
"summary": "Read Databricks Connection",
"description": "Read Databricks connection.",
"operationId": "read_databricks_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "databricks_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Databricks Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DatabricksConnection"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "databricks"],
"summary": "Update Databricks Connection",
"description": "Update Databricks connection.",
"operationId": "update_databricks_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "databricks_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Databricks Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DatabricksConnectionUpdate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DatabricksConnection"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "databricks"],
"summary": "Delete Databricks Connection",
"description": "Delete Databricks connection.",
"operationId": "delete_databricks_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "databricks_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Databricks Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DatabricksConnection"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/databricks/{databricks_connection_id}/databases": {
"get": {
"tags": ["v1", "databricks"],
"summary": "Read Databricks Connection Databases",
"description": "Read Databricks databases.",
"operationId": "read_databricks_connection_databases",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "databricks_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Databricks Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Read Databricks Connection Databases Api V1 Accounts Account Name Connections Databricks Databricks Connection Id Databases Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/databricks/{databricks_connection_id}/schemas": {
"get": {
"tags": ["v1", "databricks"],
"summary": "Read Databricks Connection Schemas",
"description": "Read Databricks schemas.",
"operationId": "read_databricks_connection_schemas",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "databricks_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Databricks Connection Id"
}
},
{
"name": "database",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Database" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
},
"title": "Response Read Databricks Connection Schemas Api V1 Accounts Account Name Connections Databricks Databricks Connection Id Schemas Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/databricks/{databricks_connection_id}/tables": {
"get": {
"tags": ["v1", "databricks"],
"summary": "Read Databricks Connection Tables",
"description": "Read Databricks tables.",
"operationId": "read_databricks_connection_tables",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "databricks_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Databricks Connection Id"
}
},
{
"name": "database",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Database" }
},
{
"name": "schema",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Schema"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
}
},
"title": "Response Read Databricks Connection Tables Api V1 Accounts Account Name Connections Databricks Databricks Connection Id Tables Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/databricks/{databricks_connection_id}/columns": {
"get": {
"tags": ["v1", "databricks"],
"summary": "Read Databricks Connection Columns",
"description": "Read Databricks table columns.",
"operationId": "read_databricks_connection_columns",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "databricks_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Databricks Connection Id"
}
},
{
"name": "schema",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Schema" }
},
{
"name": "table",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Table" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/TableColumn" },
"title": "Response Read Databricks Connection Columns Api V1 Accounts Account Name Connections Databricks Databricks Connection Id Columns Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/redshift/": {
"post": {
"tags": ["v1", "redshift"],
"summary": "Create Redshift Connection",
"description": "Create new Redshift connection.",
"operationId": "create_redshift_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RedshiftConnectionCreate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/RedshiftConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/redshift/{connection_id}": {
"get": {
"tags": ["v1", "redshift"],
"summary": "Read Redshift Connection",
"description": "Read a Redshift connection.",
"operationId": "read_redshift_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/RedshiftConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "redshift"],
"summary": "Update Redshift Connection",
"description": "Update Resfhit connection.\n\nNote that all fields for a valid Redshift connection are required.",
"operationId": "update_redshift_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RedshiftConnectionUpdate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/RedshiftConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "redshift"],
"summary": "Delete Redshift Connection",
"description": "Delete a Redshift connection.",
"operationId": "delete_redshift_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/RedshiftConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/redshift/{connection_id}/schemas": {
"get": {
"tags": ["v1", "redshift"],
"summary": "List Redshift Schemas",
"description": "List Redshift schemas.",
"operationId": "list_redshift_schemas",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
},
"title": "Response List Redshift Schemas Api V1 Accounts Account Name Connections Redshift Connection Id Schemas Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/redshift/{connection_id}/tables": {
"get": {
"tags": ["v1", "redshift"],
"summary": "List Redshift Tables",
"description": "Read Redshift tables.",
"operationId": "list_redshift_tables",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "database",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Database"
}
},
{
"name": "schema",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Schema"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
}
},
"title": "Response List Redshift Tables Api V1 Accounts Account Name Connections Redshift Connection Id Tables Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/redshift/{connection_id}/columns": {
"get": {
"tags": ["v1", "redshift"],
"summary": "List Redshift Columns",
"description": "List Redshift columns.",
"operationId": "list_redshift_columns",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "database",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Database"
}
},
{
"name": "schema",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Schema" }
},
{
"name": "table",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Table" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/TableColumn" },
"title": "Response List Redshift Columns Api V1 Accounts Account Name Connections Redshift Connection Id Columns Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/": {
"post": {
"tags": ["v1", "snowflake"],
"summary": "Create Snowflake Connection",
"description": "Create new Snowflake connection.",
"operationId": "create_snowflake_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "validate",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Validate"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SnowflakeConnectionAPICreate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SnowflakeConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Snowflake Connections",
"description": "Read Snowflake connections.\n\nThis endpoint is deprecated. Use the /connections endpoint to get all connections instead.\nThis endpoint will be removed in a coming version.",
"operationId": "read_snowflake_connections",
"deprecated": true,
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SnowflakeConnectionPage"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/validate": {
"post": {
"tags": ["v1", "snowflake"],
"summary": "Validate Snowflake Connection",
"description": "Validate Snowflake connection.",
"operationId": "validate_snowflake_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SnowflakeConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Snowflake Connection",
"description": "Read Snowflake connection.",
"operationId": "read_snowflake_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SnowflakeConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "snowflake"],
"summary": "Update Snowflake Connection",
"description": "Update Snowflake connection.\n\nNote that all fields for a valid Snowflake connection are required.",
"operationId": "update_snowflake_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SnowflakeConnectionUpdate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SnowflakeConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "snowflake"],
"summary": "Delete Snowflake Connection",
"description": "Delete Snowflake connection.",
"operationId": "delete_snowflake_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SnowflakeConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/full_connection_info": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Full Snowflake Connection",
"description": "Read Snowflake connection with secrets.",
"operationId": "read_full_snowflake_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SnowflakeConnectionWithSecrets"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/warehouses": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Snowflake Connection Warehouses",
"description": "Read Snowflake warehouses.",
"operationId": "read_snowflake_connection_warehouses",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Read Snowflake Connection Warehouses Api V1 Accounts Account Name Connections Snowflake Snowflake Connection Id Warehouses Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/roles": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Snowflake Connection Roles",
"description": "Read Snowflake roles.",
"operationId": "read_snowflake_connection_roles",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Read Snowflake Connection Roles Api V1 Accounts Account Name Connections Snowflake Snowflake Connection Id Roles Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/region": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Snowflake Connection Region",
"description": "Read Snowflake regions.",
"operationId": "read_snowflake_connection_region",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "string",
"title": "Response Read Snowflake Connection Region Api V1 Accounts Account Name Connections Snowflake Snowflake Connection Id Region Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/databases": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Snowflake Connection Databases",
"description": "Read Snowflake databases.",
"operationId": "read_snowflake_connection_databases",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Read Snowflake Connection Databases Api V1 Accounts Account Name Connections Snowflake Snowflake Connection Id Databases Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/schemas": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Snowflake Connection Schemas",
"description": "Read Snowflake schemas.",
"operationId": "read_snowflake_connection_schemas",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "database",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Database"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
},
"title": "Response Read Snowflake Connection Schemas Api V1 Accounts Account Name Connections Snowflake Snowflake Connection Id Schemas Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/tables": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Snowflake Connection Tables",
"description": "Read Snowflake tables.",
"operationId": "read_snowflake_connection_tables",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "database",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Database" }
},
{
"name": "schema",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Schema"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
}
},
"title": "Response Read Snowflake Connection Tables Api V1 Accounts Account Name Connections Snowflake Snowflake Connection Id Tables Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/columns": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Read Snowflake Connection Columns",
"description": "Read Snowflake table columns.",
"operationId": "read_snowflake_connection_columns",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "database",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Database" }
},
{
"name": "schema",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Schema" }
},
{
"name": "table",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Table" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/TableColumn" },
"title": "Response Read Snowflake Connection Columns Api V1 Accounts Account Name Connections Snowflake Snowflake Connection Id Columns Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/{snowflake_connection_id}/test": {
"get": {
"tags": ["v1", "snowflake"],
"summary": "Test Snowflake Connection",
"description": "Test Snowflake connection.\n\nThrows an HTTP error if the connection is broken.",
"operationId": "test_snowflake_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "snowflake_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Snowflake Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "boolean",
"title": "Response Test Snowflake Connection Api V1 Accounts Account Name Connections Snowflake Snowflake Connection Id Test Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/snowflake/refresh": {
"post": {
"tags": ["v1", "snowflake"],
"summary": "Refresh Snowflake Connection",
"description": "Create external functions for all snowflake connections.",
"operationId": "refresh_snowflake_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "Response Refresh Snowflake Connection Api V1 Accounts Account Name Connections Snowflake Refresh Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/teradata/": {
"post": {
"tags": ["v1", "teradata"],
"summary": "Create Teradata Connection",
"description": "Create new teradata connection.",
"operationId": "create_teradata_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TeradataConnectionCreate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TeradataConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/teradata/{teradata_connection_id}": {
"get": {
"tags": ["v1", "teradata"],
"summary": "Read Teradata Connection",
"description": "Read teradata connection.",
"operationId": "read_teradata_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "teradata_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Teradata Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TeradataConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "teradata"],
"summary": "Update Teradata Connection",
"description": "Update teradata connection.",
"operationId": "update_teradata_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "teradata_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Teradata Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TeradataConnectionUpdate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TeradataConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "teradata"],
"summary": "Delete Teradata Connection",
"description": "Delete teradata connection.",
"operationId": "delete_teradata_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "teradata_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Teradata Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TeradataConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/teradata/{teradata_connection_id}/databases": {
"get": {
"tags": ["v1", "teradata"],
"summary": "Read Teradata Connection Databases",
"description": "Read Teradata databases.\n\nNote: Because Teradata has only a single level of qualification for tables,\nwe return a hard-coded list here for consistency with the other connectors.",
"operationId": "read_teradata_connection_databases",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "teradata_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Teradata Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Read Teradata Connection Databases Api V1 Accounts Account Name Connections Teradata Teradata Connection Id Databases Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/teradata/{teradata_connection_id}/schemas": {
"get": {
"tags": ["v1", "teradata"],
"summary": "Read Teradata Connection Schemas",
"description": "Read teradata schemas.",
"operationId": "read_teradata_connection_schemas",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "teradata_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Teradata Connection Id"
}
},
{
"name": "database",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Database" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
},
"title": "Response Read Teradata Connection Schemas Api V1 Accounts Account Name Connections Teradata Teradata Connection Id Schemas Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/teradata/{teradata_connection_id}/tables": {
"get": {
"tags": ["v1", "teradata"],
"summary": "Read Teradata Connection Tables",
"description": "Read teradata tables.",
"operationId": "read_teradata_connection_tables",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "teradata_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Teradata Connection Id"
}
},
{
"name": "database",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Database" }
},
{
"name": "schema",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Schema"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
}
},
"title": "Response Read Teradata Connection Tables Api V1 Accounts Account Name Connections Teradata Teradata Connection Id Tables Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/postgres/": {
"post": {
"tags": ["v1", "postgres"],
"summary": "Create Postgres Connection",
"description": "Create new Postgres connection.",
"operationId": "create_postgres_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PostgresConnectionCreate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/PostgresConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/{postgres_connection_id}": {
"get": {
"tags": ["v1", "postgres"],
"summary": "Read Postgres Connection",
"description": "Read a Postgres connection.",
"operationId": "read_postgres_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "postgres_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Postgres Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/PostgresConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "postgres"],
"summary": "Update Postgres Connection",
"description": "Update Postgres connection.",
"operationId": "update_postgres_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "postgres_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Postgres Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PostgresConnectionUpdate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/PostgresConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "postgres"],
"summary": "Delete Postgres Connection",
"description": "Delete Postgres connection.",
"operationId": "delete_postgres_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "postgres_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Postgres Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/PostgresConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/{postgres_connection_id}/schemas": {
"get": {
"tags": ["v1", "postgres"],
"summary": "Read Postgres Connection Schemas",
"description": "Read Postgres schemas.",
"operationId": "read_postgres_connection_schemas",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "postgres_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Postgres Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
},
"title": "Response Read Postgres Connection Schemas Api V1 Accounts Account Name Connections Postgres Connection Id Schemas Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/{postgres_connection_id}/tables": {
"get": {
"tags": ["v1", "postgres"],
"summary": "Read Postgres Connection Tables",
"description": "Read Postgres tables.\n\nThis endpoint returns a dictionary of tables for each schema in the database.\n\nArgs:\n db: SQLAlchemy session.\n current_user: The current user.\n account: The current account.\n connection: The Postgres connection.\n schema: Optional schema to filter tables by.",
"operationId": "read_postgres_connection_tables",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "postgres_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Postgres Connection Id"
}
},
{
"name": "schema",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Schema"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "type": "string" }
}
},
"title": "Response Read Postgres Connection Tables Api V1 Accounts Account Name Connections Postgres Connection Id Tables Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/{postgres_connection_id}/columns": {
"get": {
"tags": ["v1", "postgres"],
"summary": "Read Postgres Connection Columns",
"description": "Read Postgres columns.",
"operationId": "read_postgres_connection_columns",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "postgres_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Postgres Connection Id"
}
},
{
"name": "schema",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Schema" }
},
{
"name": "table",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "title": "Table" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/TableColumn" },
"title": "Response Read Postgres Connection Columns Api V1 Accounts Account Name Connections Postgres Connection Id Columns Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/reports/": {
"get": {
"tags": ["v1", "reports"],
"summary": "Read Report Connections",
"description": "List existing report connections.",
"operationId": "read_report_connections",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"anyOf": [
{ "$ref": "#/components/schemas/TableauConnection" },
{ "$ref": "#/components/schemas/ModeConnection" }
]
},
"title": "Response Read Report Connections Api V1 Accounts Account Name Connections Reports Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/reports/{connection_type}/{connection_id}/folders": {
"get": {
"tags": ["v1", "reports"],
"summary": "Read Report Folders",
"description": "Read the report folders.\n\nThese are high-level collections that contain reports (e.g. Tableau projects or Mode collections).",
"operationId": "read_report_folders",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_type",
"in": "path",
"required": true,
"schema": { "$ref": "#/components/schemas/ReportType" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/ReportFolder" },
"title": "Response Read Report Folders Api V1 Accounts Account Name Connections Reports Connection Type Connection Id Folders Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/reports/{connection_type}/{connection_id}/folders/reports": {
"post": {
"tags": ["v1", "reports"],
"summary": "Read Reports From Folder",
"description": "Read the reports in the given folder.",
"operationId": "read_reports_from_folder",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "connection_type",
"in": "path",
"required": true,
"schema": { "$ref": "#/components/schemas/ReportType" }
},
{
"name": "connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ReportFolder" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Report" },
"title": "Response Read Reports From Folder Api V1 Accounts Account Name Connections Reports Connection Type Connection Id Folders Reports Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/tableau/": {
"post": {
"tags": ["v1", "tableau"],
"summary": "Create Tableau Connection",
"description": "Create new tableau connection.",
"operationId": "create_tableau_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TableauConnectionCreate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TableauConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v1", "tableau"],
"summary": "Read Tableau Connections",
"description": "List existing tableau connections.",
"operationId": "read_tableau_connections",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/TableauConnection" },
"title": "Response Read Tableau Connections Api V1 Accounts Account Name Connections Tableau Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/tableau/{tableau_connection_id}": {
"delete": {
"tags": ["v1", "tableau"],
"summary": "Delete Tableau Connection",
"description": "Delete Tableau connection.\n\nNote: This will delete the connection only if it is not used by any report.",
"operationId": "delete_tableau_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "tableau_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Tableau Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/TableauConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/tableau/{tableau_connection_id}/projects": {
"get": {
"tags": ["v1", "tableau"],
"summary": "Read Tableau Connection Projects",
"description": "Read Tableau projects.",
"operationId": "read_tableau_connection_projects",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "tableau_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Tableau Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/TableauProject" },
"title": "Response Read Tableau Connection Projects Api V1 Accounts Account Name Connections Tableau Tableau Connection Id Projects Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/tableau/{tableau_connection_id}/workbooks": {
"get": {
"tags": ["v1", "tableau"],
"summary": "Read Tableau Connection Workbooks",
"description": "Read Tableau workbooks.\n\nIf project is provided, only workbooks in that project are returned. Otherwise, all workbooks\nare returned.",
"operationId": "read_tableau_connection_workbooks",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "tableau_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Tableau Connection Id"
}
},
{
"name": "project_name",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Project Name"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Report" },
"title": "Response Read Tableau Connection Workbooks Api V1 Accounts Account Name Connections Tableau Tableau Connection Id Workbooks Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/mode/": {
"post": {
"tags": ["v1", "mode"],
"summary": "Create Mode Connection",
"description": "Create new mode connection.",
"operationId": "create_mode_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ModeConnectionCreate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ModeConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v1", "mode"],
"summary": "Read Mode Connections",
"description": "List existing mode connections.",
"operationId": "read_mode_connections",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/ModeConnection" },
"title": "Response Read Mode Connections Api V1 Accounts Account Name Connections Mode Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/mode/{mode_connection_id}": {
"delete": {
"tags": ["v1", "mode"],
"summary": "Delete Mode Connection",
"description": "Delete Mode connection.\n\nNote: This will delete the connection only if it is not used by any report.",
"operationId": "delete_mode_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "mode_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Mode Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ModeConnection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/mode/{mode_connection_id}/collections": {
"get": {
"tags": ["v1", "mode"],
"summary": "Read Mode Collections",
"description": "Read the mode collections.",
"operationId": "read_mode_collections",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "mode_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Mode Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/ModeCollection" },
"title": "Response Read Mode Collections Api V1 Accounts Account Name Connections Mode Mode Connection Id Collections Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/mode/{mode_connection_id}/collections/{collection_token}/reports": {
"get": {
"tags": ["v1", "mode"],
"summary": "Read Mode Reports From Collection",
"description": "Read the mode reports in the given collection.",
"operationId": "read_mode_reports_from_collection",
"parameters": [
{
"name": "collection_token",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Collection Token" }
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "mode_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Mode Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Report" },
"title": "Response Read Mode Reports From Collection Api V1 Accounts Account Name Connections Mode Mode Connection Id Collections Collection Token Reports Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/connections/mode/{mode_connection_id}/reports": {
"get": {
"tags": ["v1", "mode"],
"summary": "Read Mode Reports",
"description": "Read the specified mode reports.",
"operationId": "read_mode_reports",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "mode_connection_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Mode Connection Id"
}
},
{
"name": "report_tokens",
"in": "query",
"required": true,
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Report Tokens"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Report" },
"title": "Response Read Mode Reports Api V1 Accounts Account Name Connections Mode Mode Connection Id Reports Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/admin/default-settings/{setting_name}": {
"get": {
"tags": ["v1", "admin"],
"summary": "Get Default Settings",
"description": "Admin endpoint to get a default setting.",
"operationId": "get_default_settings",
"parameters": [
{
"name": "setting_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Setting Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DefaultSetting" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "admin"],
"summary": "Update Default Setting",
"description": "Admin endpoint to update a default setting.",
"operationId": "update_default_setting",
"parameters": [
{
"name": "setting_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Setting Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DefaultSettingUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DefaultSetting" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/admin/star_schema_data_source/{account_name}": {
"delete": {
"tags": ["v1", "admin"],
"summary": "Delete Star Schema Data Sources",
"description": "Delete all SSDSs in an account.",
"operationId": "delete_star_schema_data_sources",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"title": "Response Delete Star Schema Data Sources Api V1 Admin Star Schema Data Source Account Name Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/admin/promptlog/modelcalls": {
"get": {
"tags": ["v1", "admin"],
"summary": "Get Question Modelcalls",
"description": "Admin endpoint to get model call history for a question.\nAdmin endpoints require a superuser token. It's intended that an NS admin could log in, then\npass in any bumblebee cell id.\nReturns:\n This returns a JSON list of model calls in reverse chronological order, by\n default only the most recent.",
"operationId": "get_question_modelcalls",
"parameters": [
{
"name": "question",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Question" }
},
{
"name": "component",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/PromptLogComponent" },
{ "type": "null" }
],
"title": "Component"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 5, "title": "Limit" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {},
"title": "Response Get Question Modelcalls Api V1 Admin Promptlog Modelcalls Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/admin/backing-services": {
"get": {
"tags": ["v1", "admin"],
"summary": "Get Backing Services",
"description": "Admin endpoint to get all backing services.",
"operationId": "get_backing_services",
"parameters": [
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Get Backing Services Api V1 Admin Backing Services Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/admin/search/zen_dimension_value": {
"get": {
"tags": ["v1", "admin"],
"summary": "Search Zen Dimension Value",
"description": "Admin endpoint to search for a Zen Dimension Value.",
"operationId": "search_zen_dimension_value",
"parameters": [
{
"name": "value",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Value" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 10, "title": "Limit" }
},
{
"name": "explain_analyze",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Explain Analyze"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Search Zen Dimension Value Api V1 Admin Search Zen Dimension Value Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/connection": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Connection",
"description": "Get Connection for Star Schema Data Source.",
"operationId": "get_ssds_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Connection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/update_connection": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Ssds Connection",
"description": "Get Connection for Star Schema Data Source.",
"operationId": "update_ssds_connection",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "new_connection_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "New Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Connection" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/reports/{report_id}/visibility": {
"put": {
"tags": ["v1", "report"],
"summary": "Update Report Visibility",
"description": "Update Report visibility.",
"operationId": "update_report_visibility",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "report_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Report Id"
}
},
{
"name": "visibility",
"in": "query",
"required": true,
"schema": { "$ref": "#/components/schemas/DataAssetVisibility" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Report" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/extract_sqls_from_csv": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Extract Sqls From Csv",
"description": "Extract SQLs from uploaded csv file for users to review.\n\nWe expect the csv at least to have the following column:\nsql\n\nWe currently only use sql column.",
"operationId": "extract_sqls_from_csv",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_extract_sqls_from_csv_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__extract_sqls_from_csv_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/SqlWithValidation" },
"title": "Response Extract Sqls From Csv Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Extract Sqls From Csv Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/validate_sql": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Validate Sql",
"description": "Validate the SQL.",
"operationId": "validate_sql",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SqlWithValidation" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SqlWithValidation" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/learn_dms_from_sqls": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Learn Dms From Sqls",
"description": "Learn DMs from list of SQLs.\n\nThis endpoint will first remove all temporarily extracted DMs from SQLs from previous run in the SSDS.",
"operationId": "learn_dms_from_sqls",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SqlValidationAPICreate"
},
"title": "Sql Validations In"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/sql_validation/{sql_validation_id}": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Sql Validation",
"description": "Recreates the SQL validation, effectively updating it.",
"operationId": "update_sql_validation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "sql_validation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Sql Validation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SqlValidationAPIUpdate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SqlValidation" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Remove Sql Validation",
"description": "Delete one SqlValidation.",
"operationId": "remove_sql_validation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "sql_validation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Sql Validation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/dimension_metric_validation/{dm_validation_id}": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Dimension Metric Validation",
"description": "Updates the DimensionMetricValidation.",
"operationId": "update_dimension_metric_validation",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "dm_validation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dm Validation Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DimensionMetricValidationAPIUpdate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DimensionMetricValidation"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/sql_validation": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Read Sql Validations",
"description": "Get the learn DMs from list of SQLs for an SSDS.",
"operationId": "read_sql_validations",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/SqlValidation" },
"title": "Response Read Sql Validations Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Sql Validation Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Remove Sql Validations For Ssds",
"description": "Delete the learned DMs an SSDS. This effectively resets the drafted learned DMs.",
"operationId": "remove_sql_validations_for_ssds",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/inject_new_dimensions_and_metrics": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Inject New Dimensions And Metrics",
"description": "Inject new dimensions and metrics from the current SqlValidation objects in the SSDS.",
"operationId": "inject_new_dimensions_and_metrics",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "update_existing_dimensions_metrics",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Existing Dimensions Metrics"
}
},
{
"name": "update_existing_state",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Existing State"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/StarSchemaDataSourceEnrichment"
},
{ "type": "null" }
],
"title": "Enrich Params"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/remap_ssds": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Create Remapped Ssds",
"description": "Upload SSDS created with remapping from SQL CSV.",
"operationId": "create_remapped_ssds",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "default_database",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Default Database" }
},
{
"name": "default_schema",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Default Schema" }
},
{
"name": "dialect",
"in": "query",
"required": true,
"schema": { "$ref": "#/components/schemas/Dialect" }
},
{
"name": "slim_ssds",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Slim Ssds"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_create_remapped_ssds_api_v1_accounts__account_name__star_schema_data_source_remap_ssds_post"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSourceBase"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/candidate_demonstration_cells_count": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Candidate Demonstration Cells Count",
"description": "Count candidate demonstration cells for Star Schema Data Source.",
"operationId": "get_candidate_demonstration_cells_count",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/FeedbackFilter" },
{ "type": "null" }
],
"title": "Feedback Filter In"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "integer",
"title": "Response Get Candidate Demonstration Cells Count Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Candidate Demonstration Cells Count Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/candidate_demonstration_cells": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Candidate Demonstration Cells",
"description": "Get candidate demonstration cells for Star Schema Data Source.\n\nNOTE: The returned cells do not contain retrieved dimensions or metrics.",
"operationId": "get_candidate_demonstration_cells",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"default": 100,
"title": "Limit"
}
},
{
"name": "order_by",
"in": "query",
"required": false,
"schema": {
"allOf": [{ "$ref": "#/components/schemas/CellOrderBy" }],
"default": "created_at",
"title": "Order By"
}
},
{
"name": "descending",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Descending"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/FeedbackFilter" },
{ "type": "null" }
],
"title": "Feedback Filter In"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BumblebeeCellBasic"
},
"title": "Response Get Candidate Demonstration Cells Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Candidate Demonstration Cells Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/feedback": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Account Ssds Feedback",
"description": "Get feedback for the given account and ssds.",
"operationId": "get_account_ssds_feedback",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Feedback" },
"title": "Response Get Account Ssds Feedback Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Feedback Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Search Verified Questions",
"description": "Get similar ai-reference questions for an SSDS.",
"operationId": "search_verified_questions",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "question",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Question" }
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 10, "title": "Limit" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Search Verified Questions Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Feedback Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/similar_feedback": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Similar Ssds Feedback",
"description": "Get conflicting feedback for the given account and ssds.\n\nConflicting feedback are entries that have the same or similar questions\nwhich map to different semantic queries.\n\nIf cosine_similarity_threshold is provided, then we use cosine_similarity of the\nembeddings to group feedback, not just textual similarity.",
"operationId": "get_similar_ssds_feedback",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "max_cosine_distance",
"in": "query",
"required": false,
"schema": {
"type": "number",
"default": 0.01,
"title": "Max Cosine Distance"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BumblebeeCellBasic"
}
},
"title": "Response Get Similar Ssds Feedback Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Similar Feedback Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/expr_type": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Dimension Expr Type",
"description": "Get the expr_type of a dimension, then check if already exists.\n\nReturns:\n A 409 if the sql/data_source_id combo already exists\n The expr_type of the expr if a dimension with the given sql doesn't exist",
"operationId": "get_dimension_expr_type",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "sql",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Sql" }
},
{
"name": "data_source_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Get Dimension Expr Type Api V1 Accounts Account Name Star Schema Data Source Dimensions Expr Type Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/dimensions/": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Create Dimension",
"description": "Create a dimension.",
"operationId": "create_dimension",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_create_dimension_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__dimensions__post"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/DimensionDetail" },
{ "type": "null" }
],
"title": "Response Create Dimension Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Dimensions Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/{dimension_id}": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Read Dimension",
"description": "Read a dimension.",
"operationId": "read_dimension",
"parameters": [
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DimensionDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Dimension",
"description": "Update a dimension.",
"operationId": "update_dimension",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DimensionUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DimensionDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete Dimension",
"description": "Remove dimension from database.\n\nNote: This endpoint is for simple deletion of a dimension. It will not check for dimension usage and\nhandle the full flow for dimension deletion (invalidating examples and derived dms that use this dimension).\nUse with caution, delete only when you are sure the dimension is not needed.",
"operationId": "delete_dimension",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete Dimension Api V1 Accounts Account Name Star Schema Data Source Dimensions Dimension Id Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/{dimension_id}/is_sensitive": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Dimension Is Sensitive",
"description": "Update a dimension for is_sensitive.",
"operationId": "update_dimension_is_sensitive",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "is_sensitive",
"in": "query",
"required": true,
"schema": { "type": "boolean", "title": "Is Sensitive" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DimensionDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/{dimension_id}/is_sensitive_impact": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Dimension Is Sensitive Impact",
"description": "Compute the impact of updating a dimension for is_sensitive.",
"operationId": "update_dimension_is_sensitive_impact",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "is_sensitive",
"in": "query",
"required": true,
"schema": { "type": "boolean", "title": "Is Sensitive" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DMSensitiveKnowledgeImpact"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Dimensions",
"description": "Bulk update multiple dimensions at once.",
"operationId": "update_dimensions",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DimensionUpdateWithId"
},
"title": "Dimension Updates"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/DimensionDetail" },
"title": "Response Update Dimensions Api V1 Accounts Account Name Star Schema Data Source Dimensions Patch"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete Dimensions",
"description": "Remove dimensions from database.\n\nNote: This endpoint is for simple deletion of a dimension. It will not check for dimension usage and\nhandle the full flow for dimension deletion (invalidating examples and derived dms that use this dimension).\nUse with caution, delete only when you are sure the dimension is not needed.",
"operationId": "delete_dimensions",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/DeleteRequest" },
"title": "Delete Requests"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete Dimensions Api V1 Accounts Account Name Star Schema Data Source Dimensions Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/{dimension_id}/name": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Dimension Name",
"description": "Update a dimension's name.",
"operationId": "update_dimension_name",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "name",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DimensionDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/{dimension_id}/state": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Dimension State",
"description": "Update a dimension's state.",
"operationId": "update_dimension_state",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "validate_transition",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Validate Transition"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/StateUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DimensionDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimension_states": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Dimensions State",
"description": "Bulk update multiple dimension's state.",
"operationId": "update_dimensions_state",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "validate_transition",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Validate Transition"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/StateUpdateWithId" },
"title": "State Updates"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/DimensionDetail" },
"title": "Response Update Dimensions State Api V1 Accounts Account Name Star Schema Data Source Dimension States Patch"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/{dimension_id}/display": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Set Dimension Display Type",
"description": "Set a dimension's display_type",
"operationId": "set_dimension_display_type",
"parameters": [
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DisplayFieldsUpdateAPI"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DimensionDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/dimensions_count": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Dimensions Count",
"description": "Get count of Dimensions for Star Schema Data Source.\n\nIf DataSourceIds are specified, then only dimensions that reference\nthe specified Data Sources are counted.",
"operationId": "get_ssds_dimensions_count",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "search",
"in": "query",
"required": false,
"schema": { "type": "string", "default": "", "title": "Search" }
},
{
"name": "state",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeStateFilter" },
{ "type": "null" }
],
"default": "valid",
"title": "State"
}
},
{
"name": "origin",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeOriginFilter" },
{ "type": "null" }
],
"default": "all",
"title": "Origin"
}
},
{
"name": "data_source_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Data Source Ids"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "integer",
"title": "Response Get Ssds Dimensions Count Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Dimensions Count Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/dimensions": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Dimensions",
"description": "Get Dimensions for Star Schema Data Source.\n\nIf DataSourceIds are specified, then only dimensions that reference\nthe specified Data Sources are returned.",
"operationId": "get_ssds_dimensions",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"default": 200,
"title": "Limit"
}
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "search",
"in": "query",
"required": false,
"schema": { "type": "string", "default": "", "title": "Search" }
},
{
"name": "state",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeStateFilter" },
{ "type": "null" }
],
"default": "valid",
"title": "State"
}
},
{
"name": "origin",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeOriginFilter" },
{ "type": "null" }
],
"default": "all",
"title": "Origin"
}
},
{
"name": "data_source_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Data Source Ids"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/DimensionView" },
"title": "Response Get Ssds Dimensions Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Dimensions Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/{dimension_id}/merge": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Merge Dimensions",
"description": "Merge multiple dimensions into one dimension.\n\nThis endpoint lets users merge multiple (similar) dimensions (ids_to_merge) into one dimension\n(dimension) to maintain SSDS better. Users can also update the dimension using dimension_update.",
"operationId": "merge_dimensions",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_merge_dimensions_api_v1_accounts__account_name__star_schema_data_source_dimensions__dimension_id__merge_patch"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DimensionDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/{dimension_id}/relevant_conversations_cells": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Relevant Conversations Cells By Dimension",
"description": "Get conversations and cells that use the given dimension.",
"operationId": "get_relevant_conversations_cells_by_dimension",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 200, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ConversationCellTuple"
},
"title": "Response Get Relevant Conversations Cells By Dimension Api V1 Accounts Account Name Star Schema Data Source Dimensions Dimension Id Relevant Conversations Cells Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/dimensions/{dimension_id}/sample_values": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Dimension Sample Values",
"description": "Get dimension sample values.",
"operationId": "get_dimension_sample_values",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "dimension_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dimension Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {},
"title": "Response Get Dimension Sample Values Api V1 Accounts Account Name Star Schema Data Source Dimensions Dimension Id Sample Values Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/grouped_dimensions_count": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Grouped Dimensions Count",
"description": "Get the count of Dimensions for Star Schema Data Source.\n\nIf DataSourceIds are specified, then only dimensions that reference\nthe specified Data Sources are counted.",
"operationId": "get_ssds_grouped_dimensions_count",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "search",
"in": "query",
"required": false,
"schema": { "type": "string", "default": "", "title": "Search" }
},
{
"name": "state",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeStateFilter" },
{ "type": "null" }
],
"default": "valid",
"title": "State"
}
},
{
"name": "origin",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeOriginFilter" },
{ "type": "null" }
],
"default": "all",
"title": "Origin"
}
},
{
"name": "data_source_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Data Source Ids"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "integer",
"title": "Response Get Ssds Grouped Dimensions Count Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Grouped Dimensions Count Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/grouped_dimensions": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Grouped Dimensions",
"description": "Get Dimensions for Star Schema Data Source.\n\nIf DataSourceIds are specified, then only dimensions that reference\nthe specified Data Sources are returned.\n\nEach DimensionViewWithGroup will have a dimension which is the displayed dim used in the UI.\nIf cell_id is specified, then the displayed dim is chosen to be relevant\nfor that specific cell, otherwise the first dimension in the group is chosen.",
"operationId": "get_ssds_grouped_dimensions",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"default": 200,
"title": "Limit"
}
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "search",
"in": "query",
"required": false,
"schema": { "type": "string", "default": "", "title": "Search" }
},
{
"name": "state",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeStateFilter" },
{ "type": "null" }
],
"default": "valid",
"title": "State"
}
},
{
"name": "origin",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeOriginFilter" },
{ "type": "null" }
],
"default": "all",
"title": "Origin"
}
},
{
"name": "data_source_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Data Source Ids"
}
},
{
"name": "cell_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Cell Id"
}
},
{
"name": "sort_ascending",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Sort Ascending"
}
},
{
"name": "sort_by",
"in": "query",
"required": false,
"schema": {
"allOf": [{ "$ref": "#/components/schemas/KnowledgeSort" }],
"default": "display_name",
"title": "Sort By"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DimensionViewWithGroup"
},
"title": "Response Get Ssds Grouped Dimensions Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Grouped Dimensions Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics/expr_type": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Metric Expr Type",
"description": "Get the expr_type of a metric, then check if already exists.\n\nReturns:\n A 409 if the sql/type/data_source_id combo already exists\n The expr_type of the expr if a metric with the given sql doesn't exist",
"operationId": "get_metric_expr_type",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "sql",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Sql" }
},
{
"name": "data_source_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Get Metric Expr Type Api V1 Accounts Account Name Star Schema Data Source Metrics Expr Type Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/metrics/": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Create Metric",
"description": "Create a metric.",
"operationId": "create_metric",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_create_metric_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__metrics__post"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/MetricDetail" },
{ "type": "null" }
],
"title": "Response Create Metric Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Metrics Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics/{metric_id}": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Read Metric",
"description": "Read a metric.",
"operationId": "read_metric",
"parameters": [
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MetricDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Metric",
"description": "Update a metric.",
"operationId": "update_metric",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MetricUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MetricDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete Metric",
"description": "Remove metric from database.\n\nNote: This endpoint is for simple deletion of a metric. It will not check for metric usage and\nhandle the full flow for metric deletion (invalidating examples and derived dms that use this metric).\nUse with caution, delete only when you are sure the metric is not needed.",
"operationId": "delete_metric",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete Metric Api V1 Accounts Account Name Star Schema Data Source Metrics Metric Id Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics/{metric_id}/is_sensitive": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Metric Is Sensitive",
"description": "Update a metric for is_sensitive.",
"operationId": "update_metric_is_sensitive",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "is_sensitive",
"in": "query",
"required": true,
"schema": { "type": "boolean", "title": "Is Sensitive" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MetricDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics/{metric_id}/is_sensitive_impact": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Metric Is Sensitive Impact",
"description": "Compute the impact of updating a metric for is_sensitive.",
"operationId": "update_metric_is_sensitive_impact",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "is_sensitive",
"in": "query",
"required": true,
"schema": { "type": "boolean", "title": "Is Sensitive" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DMSensitiveKnowledgeImpact"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Metrics",
"description": "Bulk update multiple metrics at once.",
"operationId": "update_metrics",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/MetricUpdateWithId" },
"title": "Metric Updates"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/MetricDetail" },
"title": "Response Update Metrics Api V1 Accounts Account Name Star Schema Data Source Metrics Patch"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete Metrics",
"description": "Remove metrics from database.\n\nNote: This endpoint is for simple deletion of a metric. It will not check for metric usage and\nhandle the full flow for metric deletion (invalidating examples and derived dms that use this metric).\nUse with caution, delete only when you are sure the metric is not needed.",
"operationId": "delete_metrics",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/DeleteRequest" },
"title": "Delete Requests"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete Metrics Api V1 Accounts Account Name Star Schema Data Source Metrics Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics/{metric_id}/name": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Metric Name",
"description": "Update a metric's name.",
"operationId": "update_metric_name",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "name",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MetricDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics/{metric_id}/state": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Metric State",
"description": "Update a metric's state.",
"operationId": "update_metric_state",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "validate_transition",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Validate Transition"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/StateUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MetricDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metric_states": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Metrics State",
"description": "Bulk update multiple metric's state.",
"operationId": "update_metrics_state",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "validate_transition",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Validate Transition"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/StateUpdateWithId" },
"title": "State Updates"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/MetricDetail" },
"title": "Response Update Metrics State Api V1 Accounts Account Name Star Schema Data Source Metric States Patch"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics/{metric_id}/display": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Set Metric Display Type",
"description": "Set a metric's display_type.",
"operationId": "set_metric_display_type",
"parameters": [
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DisplayFieldsUpdateAPI"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MetricDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/metrics_count": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Metrics Count",
"description": "Get the count of Metrics for Star Schema Data Source.\n\nThis endpoint combines the metrics from the SSDS with all the metrics from each Data Source.\nIf DataSourceIds are specified, then only metrics that reference\nthe specified Data Sources are counted.",
"operationId": "get_ssds_metrics_count",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "search",
"in": "query",
"required": false,
"schema": { "type": "string", "default": "", "title": "Search" }
},
{
"name": "state",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeStateFilter" },
{ "type": "null" }
],
"default": "valid",
"title": "State"
}
},
{
"name": "origin",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeOriginFilter" },
{ "type": "null" }
],
"default": "all",
"title": "Origin"
}
},
{
"name": "data_source_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Data Source Ids"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "integer",
"title": "Response Get Ssds Metrics Count Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Metrics Count Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/metrics": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Metrics",
"description": "Get Metrics for Star Schema Data Source.\n\nThis endpoint combines the metrics from the SSDS with all the metrics from each Data Source.\nIf DataSourceIds are specified, then only metrics that reference\nthe specified Data Sources are returned.\n\nIf cell_id is specified, then the metrics will be filtered out if they are\nstate NEW and not present in the cell's conversation.",
"operationId": "get_ssds_metrics",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"default": 200,
"title": "Limit"
}
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "search",
"in": "query",
"required": false,
"schema": { "type": "string", "default": "", "title": "Search" }
},
{
"name": "state",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeStateFilter" },
{ "type": "null" }
],
"default": "valid",
"title": "State"
}
},
{
"name": "origin",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeOriginFilter" },
{ "type": "null" }
],
"default": "all",
"title": "Origin"
}
},
{
"name": "data_source_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Data Source Ids"
}
},
{
"name": "cell_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Cell Id"
}
},
{
"name": "sort_ascending",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Sort Ascending"
}
},
{
"name": "sort_by",
"in": "query",
"required": false,
"schema": {
"allOf": [{ "$ref": "#/components/schemas/KnowledgeSort" }],
"default": "display_name",
"title": "Sort By"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/MetricView" },
"title": "Response Get Ssds Metrics Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Metrics Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics/{metric_id}/merge": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Merge Metrics",
"description": "Merge multiple metrics into one metric.\n\nThis endpoint lets users merge multiple (similar) metrics (ids_to_merge) into one metric\n(metric) to maintain SSDS better. Users can also update the metric using metric_update.",
"operationId": "merge_metrics",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_merge_metrics_api_v1_accounts__account_name__star_schema_data_source_metrics__metric_id__merge_patch"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MetricDetail" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/metrics/{metric_id}/relevant_conversations_cells": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Relevant Conversations Cells By Metric",
"description": "Get conversations and cells that use the given metric.",
"operationId": "get_relevant_conversations_cells_by_metric",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "metric_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Metric Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 200, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ConversationCellTuple"
},
"title": "Response Get Relevant Conversations Cells By Metric Api V1 Accounts Account Name Star Schema Data Source Metrics Metric Id Relevant Conversations Cells Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/filters": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Account Ssds Named Filters",
"description": "Get Named Filters from the given account and ssds.\n\nIf DataSourceIds are specified, then only metrics that reference\nthe specified Data Sources are returned.",
"operationId": "get_account_ssds_named_filters",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"default": 200,
"title": "Limit"
}
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "state",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeStateFilter" },
{ "type": "null" }
],
"default": "valid",
"title": "State"
}
},
{
"name": "data_source_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Data Source Ids"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/NamedFilterBase" },
"title": "Response Get Account Ssds Named Filters Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Filters Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Create Named Filter",
"description": "Create a Named Filter.",
"operationId": "create_named_filter",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/NamedFilterCreateAPI" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/NamedFilterBase" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Named Filters",
"description": "Bulk update multiple named filters in a single API call.",
"operationId": "update_named_filters",
"parameters": [
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/NamedFilterUpdateAPIWithId"
},
"title": "Updates"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/NamedFilterBase" },
"title": "Response Update Named Filters Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Filters Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete Named Filters",
"description": "Delete the specified named filter from the ssds.",
"operationId": "delete_named_filters",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/DeleteRequest" },
"title": "Delete Requests"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete Named Filters Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Filters Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/filters_count": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Account Ssds Named Filters Count",
"description": "Get Named Filters from the given account and ssds.\n\nIf DataSourceIds are specified, then only metrics that reference\nthe specified Data Sources are returned.",
"operationId": "get_account_ssds_named_filters_count",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "state",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/KnowledgeStateFilter" },
{ "type": "null" }
],
"default": "valid",
"title": "State"
}
},
{
"name": "data_source_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Data Source Ids"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "integer",
"title": "Response Get Account Ssds Named Filters Count Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Filters Count Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/filters/{named_filter_id}/state": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Named Filter State",
"description": "Update a filter's state.",
"operationId": "update_named_filter_state",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "named_filter_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Named Filter Id"
}
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/StateUpdate" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/NamedFilterBase" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/filter_states": {
"patch": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Named Filters State",
"description": "Bulk update multiple filter's state.",
"operationId": "update_named_filters_state",
"parameters": [
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/StateUpdateWithId" },
"title": "State Updates"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/NamedFilterBase" },
"title": "Response Update Named Filters State Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Filter States Patch"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/filters/{named_filter_id}": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Named Filter",
"description": "Update a Named Filter.",
"operationId": "update_named_filter",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "named_filter_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Named Filter Id"
}
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/NamedFilterUpdateAPI" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/NamedFilterBase" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete Named Filter",
"description": "Delete the specified named filter from the ssds.",
"operationId": "delete_named_filter",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "named_filter_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Named Filter Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete Named Filter Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Filters Named Filter Id Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/filter_options": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Named Filter Valid Operators",
"description": "Get named filter options for SSDS Dimensions.\n\nThis is analogous to BB Cell's filter options.",
"operationId": "get_named_filter_valid_operators",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/NamedFilterOptionConditionValidOperatorsWithGroup"
},
"title": "Response Get Named Filter Valid Operators Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Filter Options Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/identifiers": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Create Identifiers",
"operationId": "create_identifiers",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "update_index",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Index"
}
},
{
"name": "update_expr_types",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Expr Types"
}
},
{
"name": "update_display_types",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Display Types"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Identifier" },
"title": "Identifiers In"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Identifiers",
"description": "Get Identifiers for Star Schema Data Source.\n\nIf DataSourceIds are specified, then only dimensions that reference\nthe specified Data Sources are returned.",
"operationId": "get_ssds_identifiers",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "data_source_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Data Source Ids"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Identifier" },
"title": "Response Get Ssds Identifiers Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Identifiers Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/join_sqls": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Join Sqls",
"description": "Get the joins implied by the identifiers on an ssds.\n\nZenlytics always does <foreign key> left join <primary key>.\n\nThis function makes a lot of assumptions e.g.\nthere must always exist exactly one foreign key for each identifier name\n\nThis assumption should always be true in the datasets we control. This may break\nlater for datasets we don't control.",
"operationId": "get_ssds_join_sqls",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/SSDSJoin" },
"title": "Response Get Ssds Join Sqls Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Join Sqls Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/identifiers/suggestions": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Ssds Suggest Identifiers",
"description": "Suggest Identifiers for Star Schema Data Source.\n\nThis only works for primary/foreign key relationships. The model won't suggest anything\nfancier like a join with a condition or any an inner join.\n\nArgs:\n - overwrite_cache: whether to force the model to recompute, rather than using a cached result\n - temperature: the randomness of the model. 0.0 is deterministic, 1.0 is random\n ref: https://platform.openai.com/docs/api-reference/audio\n - max_tokens: the maximum number of tokens to generate. This is model dependent.",
"operationId": "ssds_suggest_identifiers",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "max_tokens",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"exclusiveMinimum": 0,
"default": 4000,
"title": "Max Tokens"
}
},
{
"name": "temperature",
"in": "query",
"required": false,
"schema": {
"type": "number",
"default": 0.0,
"title": "Temperature"
}
},
{
"name": "overwrite_cache",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Overwrite Cache"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/IdentifierSuggestionResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/joins": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Joins",
"description": "Get Joins for Star Schema Data Source.",
"operationId": "get_ssds_joins",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Join" },
"title": "Response Get Ssds Joins Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Joins Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Create Joins",
"description": "Create Joins for Star Schema Data Source.\n\nwe will return the ambiguous join groups,\ni.e. a list of join groups that have more than one bridge tables.",
"operationId": "create_joins",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "overwrite",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Overwrite"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Join" },
"title": "Joins"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/JoinGroup" },
"title": "Response Create Joins Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Joins Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/composite_key": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Create Composite Key Joins",
"description": "Create Joins for Star Schema Data Source.",
"operationId": "create_composite_key_joins",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/JoinGroup" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/JoinGroup" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/joins/validate": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Validate Join",
"description": "Validate Joins for Star Schema Data Source.",
"operationId": "validate_join",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "num_rows_of_left_table",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Num Rows Of Left Table"
}
},
{
"name": "num_rows_of_right_table",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Num Rows Of Right Table"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Join" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/JoinValidationResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/retrieve": {
"post": {
"tags": ["v1", "retrieval"],
"summary": "Retrieve",
"description": "Retrieve columns, dimensions, metrics and top values.\n\nEndpoint used for evaluation purposes only.",
"operationId": "retrieve",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "question",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Question" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/RetrievalParams" },
{ "type": "null" }
],
"title": "Retrieval Params"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": { "application/json": { "schema": {} } }
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/retrieve/ner": {
"get": {
"tags": ["v1", "retrieval"],
"summary": "Retrieve Ner",
"description": "Retrieve filter values from a question.",
"operationId": "retrieve_ner",
"parameters": [
{
"name": "question",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Question" }
},
{
"name": "account_name",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Retrieve Ner Api V1 Retrieve Ner Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/retrieve/text": {
"get": {
"tags": ["v1", "retrieval"],
"summary": "Retrieve Text Search",
"description": "Retrieve sample values using text search.",
"operationId": "retrieve_text_search",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "question",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Question" }
},
{
"name": "num_values_to_retrieve",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 5,
"title": "Num Values To Retrieve"
}
},
{
"name": "explain_analyze",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Explain Analyze"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Retrieve Text Search Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Retrieve Text Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/retrieve/embedding": {
"get": {
"tags": ["v1", "retrieval"],
"summary": "Retrieve Embedding Search",
"description": "Retrieve sample values using embedding search.",
"operationId": "retrieve_embedding_search",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "question",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Question" }
},
{
"name": "num_values_to_retrieve",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 5,
"title": "Num Values To Retrieve"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Retrieve Embedding Search Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Retrieve Embedding Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Read Star Schema Data Sources",
"description": "Read Star Schema Data Sources.",
"operationId": "read_star_schema_data_sources",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "sort_ascending",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Sort Ascending"
}
},
{
"name": "sort_by",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/StarSchemaDataSourceSort" },
{ "type": "null" }
],
"title": "Sort By"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Limit"
}
},
{
"name": "offset",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Offset"
}
},
{
"name": "search",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Search"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSourcesResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Create Star Schema Data Source",
"description": "Create Star Schema Data Source.",
"operationId": "create_star_schema_data_source",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "update_index",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Index"
}
},
{
"name": "update_profiles",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Profiles"
}
},
{
"name": "update_expr_types",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Expr Types"
}
},
{
"name": "update_display_types",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Display Types"
}
},
{
"name": "skip_validation_check",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Skip Validation Check"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSourceAPICreate"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Read Star Schema Data Source",
"description": "Read Star Schema Data Source.",
"operationId": "read_star_schema_data_source",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "publish_state_filter",
"in": "query",
"required": false,
"schema": {
"allOf": [
{ "$ref": "#/components/schemas/PublishStateFilterOption" }
],
"default": "only_verified",
"title": "Publish State Filter"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete Star Schema Data Source",
"description": "Delete Star Schema Data Source.\n\nThis will delete all associated conversations that end up empty after cells are removed.",
"operationId": "delete_star_schema_data_source",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/name_and_description": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Star Schema Data Source Name And Description",
"description": "Update Star Schema Data Source name and description.",
"operationId": "update_star_schema_data_source_name_and_description",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "name",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
}
},
{
"name": "description",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
}
},
{
"name": "is_demo",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Demo"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/visibility": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Star Schema Data Source Visibility",
"description": "Update Star Schema Data Source visibility.",
"operationId": "update_star_schema_data_source_visibility",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "visibility",
"in": "query",
"required": true,
"schema": { "$ref": "#/components/schemas/DataAssetVisibility" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/suggestions": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Suggested Prompts",
"description": "Get a dataset's suggested prompts from the SSDS examples.",
"operationId": "get_suggested_prompts",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "number_suggestions",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 5,
"title": "Number Suggestions"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Get Suggested Prompts Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Suggestions Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/common_values": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Star Schema Data Source Common Values",
"description": "Get the common values for an SSDS's columns.\n\nReturns:\n A dictionary mapping the column name to ColumnValue's. Only\n the value attribute on each ColumnValue is meaningful. The\n count in each ColumnValue is hard-coded to -1.",
"operationId": "get_star_schema_data_source_common_values",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": { "$ref": "#/components/schemas/ColumnValue" }
},
"title": "Response Get Star Schema Data Source Common Values Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Common Values Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/sql": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Read Star Schema Data Source Sql",
"description": "Get the SQL SELECT statement that is used to return the SSDS data.",
"operationId": "read_star_schema_data_source_sql",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "string",
"title": "Response Read Star Schema Data Source Sql Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Sql Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/data": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Read Star Schema Data Source Data",
"description": "Get the joined data for everything in an SSDS.",
"operationId": "read_star_schema_data_source_data",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/Body_read_star_schema_data_source_data_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__data_post"
}
],
"title": "Body"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/NodeDataPage" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/data_sources/{data_source_id}/profile": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Profile Data Source",
"description": "Get the data for a specific data source within an SSDS.",
"operationId": "profile_data_source",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DataSourceProfileInfo"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/data_sources/{data_source_id}/data": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Read Data Source Data",
"description": "Get the data for a specific data source within an SSDS.",
"operationId": "read_data_source_data",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Data Source Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/Body_read_data_source_data_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__data_sources__data_source_id__data_post"
}
],
"title": "Body"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/NodeDataPage" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/conversations": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Star Schema Data Source Conversations",
"description": "Read Star Schema Data Source Conversations.\n\nIf show_moonlight is True, show only moonlight conversations\nIf show_moonlight is False, show only non-moonlight conversations\nIf show_moonlight is None, show everything.\n\nIf show_training is True, show only is_training conversations\nIf show_training is False, show only non-is_training conversations\nIf show_training is None, show everything.\n\nIf show_eval is True, show only eval conversations\nIf show_eval is False, show only non-eval conversations\nIf show_eval is None, show everything.",
"operationId": "get_star_schema_data_source_conversations",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "show_hidden",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Show Hidden"
}
},
{
"name": "show_eval",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Show Eval"
}
},
{
"name": "show_moonlight",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Show Moonlight"
}
},
{
"name": "show_training",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Show Training"
}
},
{
"name": "search_query",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Search Query"
}
},
{
"name": "creator_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Creator Ids"
}
},
{
"name": "order_by",
"in": "query",
"required": false,
"schema": {
"allOf": [{ "$ref": "#/components/schemas/ConversationsSort" }],
"default": "last_modified_at",
"title": "Order By"
}
},
{
"name": "descending",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Descending"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/ConversationBasic" },
"title": "Response Get Star Schema Data Source Conversations Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Conversations Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/conversations_count": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Star Schema Data Source Conversations Count",
"description": "Read Star Schema Data Source Conversations.\n\nIf show_moonlight is True, show only moonlight conversations\nIf show_moonlight is False, show only non-moonlight conversations\nIf show_moonlight is None, show everything.\n\nIf show_training is True, show only is_training conversations\nIf show_training is False, show only non-is_training conversations\nIf show_training is None, show everything.\n\nIf show_eval is True, show only eval conversations\nIf show_eval is False, show only non-eval conversations\nIf show_eval is None, show everything.",
"operationId": "get_star_schema_data_source_conversations_count",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "show_hidden",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Show Hidden"
}
},
{
"name": "show_eval",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Show Eval"
}
},
{
"name": "show_moonlight",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Show Moonlight"
}
},
{
"name": "show_training",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Show Training"
}
},
{
"name": "search_query",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Search Query"
}
},
{
"name": "creator_ids",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Creator Ids"
}
},
{
"name": "order_by",
"in": "query",
"required": false,
"schema": {
"allOf": [{ "$ref": "#/components/schemas/ConversationsSort" }],
"default": "last_modified_at",
"title": "Order By"
}
},
{
"name": "descending",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Descending"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "integer",
"title": "Response Get Star Schema Data Source Conversations Count Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Conversations Count Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/compute-expr-types": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Recompute Expr Types",
"description": "Recompute the expr_type for all dimensions and metrics.",
"operationId": "recompute_expr_types",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": { "application/json": { "schema": {} } }
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/semantic_queries": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Account Ssds Semantic Queries",
"description": "Get semantic queries for the given account and ssds.",
"operationId": "get_account_ssds_semantic_queries",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/SemanticQuery" },
"title": "Response Get Account Ssds Semantic Queries Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Semantic Queries Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/upload_dimension_groups": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Upload Dimension Groups",
"description": "Upload dimension groups from dict mapping dm names to group ids.",
"operationId": "upload_dimension_groups",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": { "type": "string", "format": "uuid4" },
"title": "Dim Name 2 Dim Group Id"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": { "application/json": { "schema": {} } }
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/remove_dimension_groups": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Remove Dm Groups",
"description": "Create dimension groups for Star Schema Data Source.",
"operationId": "remove_dm_groups",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": { "application/json": { "schema": {} } }
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/enrich_ssds": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Enrich Ssds",
"description": "Upload dms to an existing ssds.",
"operationId": "enrich_ssds",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/Body_enrich_ssds_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__enrich_ssds_post"
}
],
"title": "Body"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/upload_examples": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Upload Examples",
"description": "Upload examples to an existing ssds.",
"operationId": "upload_examples",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/BBExample" },
"title": "Examples"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/validate": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Validate Star Schema Data Source",
"description": "Validate Star Schema Data Source.\n\nCheck all dimensions, metrics, and filters and mark invalid ones as Deprecated.",
"operationId": "validate_star_schema_data_source",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/update": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Star Schema Data Source",
"description": "Update Star Schema Data Source.\n\nThis endpoint allows users to update the star schema data schema with a new definition.\nIt requires the input of StarSchemaDataSourceColdStart, which is the same as a cold start.\nThe endpoint will scan the tables and views and add new data sources (StarSchemaDataSourceTableOrViewInfo without data_source_id),\ndelete data sources that exist in the existing SSDS but not in the tables_and_views,\nand update the existing data sources (StarSchemaDataSourceTableOrViewInfo with data_source_id)\nif either the table or SQL changes.\n\nMoreover, the endpoint introduces a new argument called `force_update` that allows users to\nupdate existing data sources to reflect the underlying database schema changes, even if the\ntable or SQL remains the same. By default, this argument is set to false, and it will only\nupdate the dimensions and metrics related to modified data sources.\n\nExample:\n\nGiven the original SSDS definition:\n```\ntables_and_views = [\n StarSchemaDataSourceTableOrViewInfo(\n name=\"MAKANA_WAITTIME_1\",\n db=\"CI_FOR_PYTEST\",\n db_schema=\"PYTEST\",\n table=\"MAKANA_WAITTIME_1\",\n ),\n StarSchemaDataSourceTableOrViewInfo(\n name=\"MAKANA_WAITTIME_2_100\",\n sql=\"SELECT * FROM CI_FOR_PYTEST.PYTEST.MAKANA_WAITTIME_2 LIMIT 100\",\n ),\n]\nbody = {\n \"tables_and_views\": cold_start_tables,\n \"ssds_name\": \"MAKANA_WAITTIMES (pytest)\",\n}\nr = client.post(\n f\"{settings.API_V1_STR}/accounts/{account.name}/star_schema_data_source/cold_start_from_tables\",\n cookies=user_cookie,\n params={\"connection_id\": connection_db.id}, # type: ignore\n json=jsonable_encoder(body),\n)\n```\n\nWe need to perform the following updates to the SSDS:\n1. Update the first data source with sql `SELECT *, 1 AS CNT FROM CI_FOR_PYTEST.PYTEST.MAKANA_WAITTIME_1 LIMIT 100;`\n2. Delete the second data source\n3. Create a new data source with table `CI_FOR_PYTEST.PYTEST.MAKANA_WAITTIME_3`\n\n```\nupdated_tables = [\n # Update the first data source since the data_source_id is filled in\n StarSchemaDataSourceTableOrViewInfo(\n data_source_id=ssds[\"data_sources\"][0][\"id\"],\n name=\"MAKANA_WAITTIME_1\",\n sql=\"SELECT *, 1 AS CNT FROM CI_FOR_PYTEST.PYTEST.MAKANA_WAITTIME_1 LIMIT 100;\",\n ),\n # Delete the second data source since the original second data source is not in the new list\n # Create a new data source with table `CI_FOR_PYTEST.PYTEST.MAKANA_WAITTIME_3`\n StarSchemaDataSourceTableOrViewInfo(\n name=\"MAKANA_WAITTIME_3\",\n db=\"CI_FOR_PYTEST\",\n db_schema=\"PYTEST\",\n table=\"MAKANA_WAITTIME_3\",\n ),\n]\nbody = {\n \"tables_and_views\": updated_tables,\n \"ssds_name\": \"updated ssds\",\n \"update_identifiers\": False,\n \"ssds_enrich_params\": {\"enable\": True},\n}\nr = client.post(\n f\"{settings.API_V1_STR}/accounts/{account.name}/star_schema_data_source/{ssds['id']}/update\",\n cookies=user_cookie,\n params={\"force_update\": False},\n json=jsonable_encoder(body),\n)\n```",
"operationId": "update_star_schema_data_source",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "force_update",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Force Update"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/StarSchemaDataSourceColdStart"
},
{ "type": "null" }
],
"title": "Input"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/add_data_sources": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Add Data Sources",
"description": "Add new data sources to the Star Schema Data Source.\n\nThis endpoint allows users to add data sources to the existing star schema data schema.\nIt requires the input of a list of StarSchemaDataSourceTableOrViewInfo without data source id.\nThe endpoint will scan the StarSchemaDataSourceTableOrViewInfo and perform cold start for the\nnew data sources and do enrich_ssds with related dimensions and metrics.",
"operationId": "add_data_sources",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/StarSchemaDataSourceTableOrViewInfo"
},
"title": "Tables And Views"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/data_sources/{data_source_id}": {
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete Data Source",
"description": "Delete a data source and set the states of all related dimensions and metrics invalid.",
"operationId": "delete_data_source",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Update Data Source",
"description": "Update existing data source in the Star Schema Data Source.\n\nThis endpoint allows users to update existing data source in the existing star schema data schema.\nIt requires the input of StarSchemaDataSourceTableOrViewInfo without data source id.\nThe endpoint will scan the StarSchemaDataSourceTableOrViewInfo and perform cold start for the\nupdated data source and do enrich_ssds with related dimensions and metrics.",
"operationId": "update_data_source",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSourceTableOrViewInfo"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSource"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/data_sources/{data_source_id}/trim_text_columns_sql": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Trim Text Columns Sql For Data Source",
"description": "Generates a SQL that trims all the text columns from an existing data source.\n\nAll the text columns will be applied with a trim.\n\nReturns:\n the modified sql",
"operationId": "trim_text_columns_sql_for_data_source",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "string",
"title": "Response Trim Text Columns Sql For Data Source Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Data Sources Data Source Id Trim Text Columns Sql Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/table_and_view_info": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Ssds Table And View Info",
"description": "Get table and view info for the given ssds.",
"operationId": "get_ssds_table_and_view_info",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/StarSchemaDataSourceTableOrViewInfo"
},
"title": "Response Get Ssds Table And View Info Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Table And View Info Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/batch_update_dm_sensitive": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Batch Update Dm Sensitive",
"description": "Batch update DMs for sensitive given the assignment.",
"operationId": "batch_update_dm_sensitive",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DMSensitiveAssignment" }
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Batch Update Dm Sensitive Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Batch Update Dm Sensitive Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/cold_start_from_tables": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Cold Start From Tables",
"description": "Cold start from table.",
"operationId": "cold_start_from_tables",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "ssds_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Ssds Id"
}
},
{
"name": "connection_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StarSchemaDataSourceColdStart"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/upload_cells": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Bulk Create Cells",
"description": "Upload cells to an account.\n\nAttempts to create with the same user, but will default to the admin\nif the user doesn't belong to the account.",
"operationId": "bulk_create_cells",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/BumblebeeCellBasic" },
"title": "Cells"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BumblebeeCellBasic"
},
"title": "Response Bulk Create Cells Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Upload Cells Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/upload_feedback": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Bulk Create Feedback",
"description": "Upload feedback to an account.\n\nAttempts to create with the same user, but will default to the admin\nif the user doesn't belong to the account.\n\nNOTE: If a user is overwritten by an admin, the admin may be re-used to give feedback,\nwhich means only the last feedback issued by the admin will apply.",
"operationId": "bulk_create_feedback",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "allow_conflicting_feedback",
"in": "query",
"required": true,
"schema": {
"type": "boolean",
"title": "Allow Conflicting Feedback"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Feedback" },
"title": "Feedback List"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Feedback" },
"title": "Response Bulk Create Feedback Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Upload Feedback Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/named_filters": {
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete All Named Filters",
"description": "Delete all Named Filters matching SSDS id.",
"operationId": "delete_all_named_filters",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete All Named Filters Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Named Filters Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/upload_named_filters": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Bulk Create Named Filters",
"description": "Add Named Filters with the appropriate SSDS id.",
"operationId": "bulk_create_named_filters",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/NamedFilterCreate" },
"title": "Named Filters"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/NamedFilterBase" },
"title": "Response Bulk Create Named Filters Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Upload Named Filters Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/upload_semantic_queries": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Bulk Create Semantic Queries",
"description": "Upload Semantic Queries associated with ssds_id.",
"operationId": "bulk_create_semantic_queries",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/SemanticQueryCreate" },
"title": "Semantic Queries"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/SemanticQuery" },
"title": "Response Bulk Create Semantic Queries Api V1 Accounts Account Name Star Schema Data Source Upload Semantic Queries Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/import_from_twb": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Import From Twb",
"description": "Import DMs from a twb/twbx file.\n\nThis parses the twb and creates a star schema data source.",
"operationId": "import_from_twb",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "ssds_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Ssds Id"
}
},
{
"name": "update_identifiers",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Update Identifiers"
}
},
{
"name": "connection_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_import_from_twb_api_v1_accounts__account_name__star_schema_data_source_import_from_twb_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Import From Twb Api V1 Accounts Account Name Star Schema Data Source Import From Twb Post"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/eval_reference_conversations": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Run Eval On Reference Conversations",
"description": "Run eval on reference conversations.\n\nArgs:\n max_eval_conversations: The upper limit of conversations to run.\n eval_filter: Select which cells to include as ground-truth cells.\n moonlight_run_params: Run parameters for cells.\n run_in_reverse_order: Preserve upstream context by running cells in reverse order to independently evaluate each cell in a conversation.\n We clone a conversation from reference and then rerun from the last (when this is set True) to reuse the reference context instead of the predicted context.\n delete_conversations: Remove newly-created conversations after evaluation.",
"operationId": "run_eval_on_reference_conversations",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "max_eval_conversations",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Max Eval Conversations"
}
},
{
"name": "run_in_reverse_order",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Run In Reverse Order"
}
},
{
"name": "delete_new_conversations",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Delete New Conversations"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_run_eval_on_reference_conversations_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__eval_reference_conversations_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/regression_test": {
"post": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Run Regression Test",
"description": "Run regression test on verified cells.\n\nArgs:\n max_eval_cells: The upper limit of conversations to run.\n moonlight_run_params: Run parameters for cells.\n delete_conversations: Remove newly-created conversations after evaluation.",
"operationId": "run_regression_test",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "max_eval_cells",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Max Eval Cells"
}
},
{
"name": "delete_new_conversations",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Delete New Conversations"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_run_regression_test_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__regression_test_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/eval_reference_conversations_results": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Eval On Reference Conversations Results",
"description": "Get eval results for an SSDS.\n\nThis returns results metadata for the SSDS. Full eval results with conversations can be retrieved by ID.",
"operationId": "get_eval_on_reference_conversations_results",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "task_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Task Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/EvalResultBase" },
"title": "Response Get Eval On Reference Conversations Results Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Eval Reference Conversations Results Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/eval_reference_conversations_results/{eval_result_id}": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Eval On Reference Conversation Result By Id",
"description": "Get eval result for an SSDS by ID.",
"operationId": "get_eval_on_reference_conversation_result_by_id",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "eval_result_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Eval Result Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Get Eval On Reference Conversation Result By Id Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Eval Reference Conversations Results Eval Result Id Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Delete Eval On Reference Conversations Result",
"description": "Delete an eval result",
"operationId": "delete_eval_on_reference_conversations_result",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "eval_result_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Eval Result Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/dm_usage": {
"get": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Get Dm Usage",
"description": "Get histogram of DM usage in semantic queries.",
"operationId": "get_dm_usage",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/FeedbackFilter" },
{ "type": "null" }
],
"title": "Feedback Filter In"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Get Dm Usage Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Dm Usage Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/remap_dms": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Remap Ssds Dms",
"description": "Remap all semantic queries to use new dimension/metric names.\n\nThis does not alter any dimension/metric definitions, but only usage in semantic queries.",
"operationId": "remap_ssds_dms",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": { "type": "string" },
"title": "Old Dm Name To New Dm Name"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Remap Ssds Dms Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Remap Dms Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/star_schema_data_source/{star_schema_data_source_id}/coalesce_dms": {
"put": {
"tags": ["v1", "star_schema_data_source"],
"summary": "Coalesce Dms",
"description": "Coalesce all semantic queries in selected cells.\n\nWe accept bumblebee cells as input, because we don't relate semantic queries directly to SSDSs.\nIf none are specified, this will coalesce all existing bumblebee cells.",
"operationId": "coalesce_dms",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "grouping_strategy",
"in": "query",
"required": true,
"schema": {
"$ref": "#/components/schemas/SemanticQueryCoalescingStrategy"
}
},
{
"name": "commit",
"in": "query",
"required": false,
"schema": { "type": "boolean", "default": true, "title": "Commit" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"type": "array",
"items": { "type": "string", "format": "uuid4" }
},
{ "type": "null" }
],
"title": "Cell Ids"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "array",
"items": { "$ref": "#/components/schemas/SemanticQuery" }
},
"title": "Response Coalesce Dms Api V1 Accounts Account Name Star Schema Data Source Star Schema Data Source Id Coalesce Dms Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/datasets/": {
"get": {
"tags": ["v1", "datasets"],
"summary": "Read All Datasets",
"description": "Read all datasets.\n\nThis includes both star schema data sources and reports.",
"operationId": "read_all_datasets",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "sort_ascending",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Sort Ascending"
}
},
{
"name": "sort_by",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/StarSchemaDataSourceSort" },
{ "type": "null" }
],
"title": "Sort By"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Limit"
}
},
{
"name": "offset",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Offset"
}
},
{
"name": "search",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Search"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DatasetsResponse" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/datasets/{star_schema_data_source_id}": {
"get": {
"tags": ["v1", "datasets"],
"summary": "Read Dataset",
"description": "Read Dataset.",
"operationId": "read_dataset",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "full_dataset",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Full Dataset"
}
},
{
"name": "dm_filter",
"in": "query",
"required": false,
"schema": {
"allOf": [{ "$ref": "#/components/schemas/DMFilter" }],
"default": "ALL",
"title": "Dm Filter"
}
},
{
"name": "conversation_cell_filter",
"in": "query",
"required": false,
"schema": {
"allOf": [
{ "$ref": "#/components/schemas/ConversationCellFilter" }
],
"default": "ALL",
"title": "Conversation Cell Filter"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BumblebeeDataset" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/datasets/add_demo_dataset": {
"post": {
"tags": ["v1", "datasets"],
"summary": "Add Demo Dataset",
"description": "Add a demo dataset to the account",
"operationId": "add_demo_dataset",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/datasets/upload": {
"post": {
"tags": ["v1", "datasets"],
"summary": "Upload Dataset",
"description": "Add a dataset from a JSON file.\n\nThe user must both be an account admin and eval maintainer to upload the dataset.",
"operationId": "upload_dataset",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Body_upload_dataset_api_v1_accounts__account_name__datasets_upload_post"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/datasets/{star_schema_data_source_id}/copy": {
"post": {
"tags": ["v1", "datasets"],
"summary": "Copy Dataset",
"description": "Copy dataset.\n\nThis endpoint lets users create a copy of a dataset in another account. You can specify the\ndestination account name (dest_account_name). The users need to be the admin for both accounts.\nYou can copy to a different account you manage, or even the same account. When copying, you have\nthe option to update the details, including the SSDS name, connection, and data source\ndefinition (data source id in the data source definition must be retained).\n\nExample:\n\nGiven the original SSDS definition:\n```\ntables_and_views = [\n StarSchemaDataSourceTableOrViewInfo(\n data_source_id=\"592a2851-f849-4dab-a4ca-614e8709dc8d\",\n name=\"MAKANA_WAITTIME_1\",\n db=\"CI_FOR_PYTEST\",\n db_schema=\"PYTEST\",\n table=\"MAKANA_WAITTIME_1\",\n )\n]\nnew_account_name = \"new_account\"\nnew_connection_id = uuid.uuid4()\nnew_ssds_name = \"MAKANA_WAITTIMES (pytest) - copy from another account\"\nr = client.post(\n f\"{settings.API_V1_STR}/accounts/{account.name}/datasets/{ssds_id}/copy\",\n headers=user_header,\n params={\n \"dest_account_name\": new_account_name,\n \"dest_connection_id\": new_connection_id,\n \"dest_ssds_name\": new_ssds_name,\n },\n json=jsonable_encoder(tables_and_views),\n)",
"operationId": "copy_dataset",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "dest_account_name",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Dest Account Name"
}
},
{
"name": "dest_connection_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Dest Connection Id"
}
},
{
"name": "dest_ssds_name",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Dest Ssds Name"
}
},
{
"name": "conversation_cell_filter",
"in": "query",
"required": false,
"schema": {
"allOf": [
{ "$ref": "#/components/schemas/ConversationCellFilter" }
],
"default": "ALL",
"title": "Conversation Cell Filter"
}
},
{
"name": "overwrite_user_question_for_sensitive_cell",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Overwrite User Question For Sensitive Cell"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/components/schemas/StarSchemaDataSourceTableOrViewInfo"
}
},
{ "type": "null" }
],
"title": "Tables And Views"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/datasets/{star_schema_data_source_id}/update": {
"post": {
"tags": ["v1", "datasets"],
"summary": "Update Dataset",
"description": "Update dataset.\n\nThis endpoint lets users push *new* knowledge from baseline dataset to derived dataset, including\nSSDS (dimensions, metrics, and named filters), conversations, cells, semantic queries, and feedback.\n\nFor SSDS, we do incremental update including adding new dimensions, metrics, and named filters (DMFs),\nalign unaligned DMFs that are identical. We will let users to review any conflict in aligned DMFs.\nFor conversations, cells, semantic queries, and feedback, we only copy the new created conversations\nand associated cells, semantic queries, and feedback. We will let users to review existing conversations\nif there is any conflict.",
"operationId": "update_dataset",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "dest_ssds_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Dest Ssds Id"
}
},
{
"name": "conversation_cell_filter",
"in": "query",
"required": false,
"schema": {
"allOf": [
{ "$ref": "#/components/schemas/ConversationCellFilter" }
],
"default": "ALL",
"title": "Conversation Cell Filter"
}
},
{
"name": "overwrite_user_question_for_sensitive_cell",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Overwrite User Question For Sensitive Cell"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/datasets/clear_open_search_index": {
"put": {
"tags": ["v1", "datasets"],
"summary": "Clear Open Search Index",
"description": "Clear the open search index for the account.\n\nThis endpoint is used to clear the open search index for the account. This is useful when the\nfields in the index are updated and need to be reindexed.",
"operationId": "clear_open_search_index",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Clear Open Search Index Api V1 Accounts Account Name Datasets Clear Open Search Index Put"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/logging/": {
"post": {
"tags": ["v1", "logging"],
"summary": "Log",
"description": "Receive logs from the browser and display them on the server.",
"operationId": "log",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/BrowserLog" }
}
}
},
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/index_reports": {
"post": {
"tags": ["v1", "index"],
"summary": "Index Reports",
"description": "Index reports.\n\nThis will index the reports in the database and search index.\nNote: We require the connection_id to be present in the report object so we can index the report\nwith different connections.\n\nFor tableau workbook, we need to have connection_id and report_id.\n\nArgs:\n db: Database session to perform the operation.\n user_session: User session to perform the operation.\n account: Account to perform the operation.\n reports: Reports to index.\n force: Whether to force the indexing of the reports even the report is already indexed\n and this will update the index. This is useful when the content of the report is updated.\n If force=False, the report will be indexed when it is not already indexed or the report\n is stale.",
"operationId": "index_reports",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "force",
"in": "query",
"required": false,
"schema": { "type": "boolean", "default": false, "title": "Force" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Report" },
"title": "Reports"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/delete_reports": {
"delete": {
"tags": ["v1", "index"],
"summary": "Delete Reports",
"description": "Delete reports from the index.\n\nArgs:\n db: Database session to perform the operation.\n user_session: User session to perform the operation.\n account: Account to perform the operation.\n reports: Reports to delete.",
"operationId": "delete_reports",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Report" },
"title": "Reports"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete Reports Api V1 Accounts Account Name Delete Reports Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/delete_all_reports": {
"delete": {
"tags": ["v1", "index"],
"summary": "Delete All Reports",
"description": "Delete all reports from the index.\n\nArgs:\n db: Database session to perform the operation.\n user_session: User session to perform the operation.\n account: Account to perform the operation.\n type: Type of the reports to delete. If not provided, all reports are deleted.",
"operationId": "delete_all_reports",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/ReportType" },
{ "type": "null" }
],
"title": "Type"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Delete All Reports Api V1 Accounts Account Name Delete All Reports Delete"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/reports": {
"get": {
"tags": ["v1", "index"],
"summary": "Read Reports",
"description": "Read indexed reports.\n\nArgs:\n db: Database session to perform the operation.\n user_session: User session to perform the operation.\n account: Account to perform the operation.\n type: Type of the reports to read. If not provided, all reports are read.\n limit: Number of reports to read.\n skip: Number of reports to skip.\n search: Search string to filter the reports.",
"operationId": "read_reports",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/ReportType" },
{ "type": "null" }
],
"title": "Type"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 100, "title": "Limit" }
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Skip" }
},
{
"name": "search",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Search"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/Report" },
"title": "Response Read Reports Api V1 Accounts Account Name Reports Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v1/accounts/{account_name}/refresh_reports": {
"post": {
"tags": ["v1", "index"],
"summary": "Refresh Reports",
"description": "Refresh reports.\n\nArgs:\n db: Database session to perform the operation.\n user_session: User session to perform the operation.\n account: Account to perform the operation.\n force: Whether to force the refresh of the reports even the report is already indexed\n and this will update the index. This is useful when the content of the report is updated.\n If force=False, the report will be indexed when it is not already indexed or the report\n is stale.",
"operationId": "refresh_reports",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "force",
"in": "query",
"required": false,
"schema": { "type": "boolean", "default": false, "title": "Force" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v2/orgs/{account_name}/login/api-key": {
"post": {
"tags": ["v2", "login_v2"],
"summary": "Login Api Key",
"description": "API key login, get an access token for future requests.\n\nArgs:\n email: The email address of the user to associate usage with.\n display_name: The display name of the user.\n m2m_token: The machine-to-machine token to store in the cache.",
"operationId": "login_api_key",
"security": [{ "APIKeyHeader": [] }],
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "email",
"in": "query",
"required": true,
"schema": { "type": "string", "format": "email", "title": "Email" }
},
{
"name": "display_name",
"in": "query",
"required": true,
"schema": { "type": "string", "title": "Display Name" }
},
{
"name": "m2m_token",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "M2M Token"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Token" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v2/orgs/{account_name}/conversations/": {
"post": {
"tags": ["v2", "conversations_v2"],
"summary": "Start Conversation",
"description": "Start a conversation.\n\nThis endpoint will start a new conversation with the NS application. If\naccepted_payload_types is null then all types are accepted. The response will\ninclude the details of the message and the conversation.",
"operationId": "start_conversation",
"security": [{ "OAuth2PasswordBearer": [] }],
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ConversationAPIStart" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ConversationAPICreateResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v2/orgs/{account_name}/conversations/{conversation_id}/messages": {
"post": {
"tags": ["v2", "conversations_v2"],
"summary": "Send Message To Conversation",
"description": "Send a message to a conversation.\n\nThis endpoint sends a message to an existing application. The response includes the\nmetadata about the created message. Note that the only message payload type that\ncan be sent is TEXT.",
"operationId": "send_message_to_conversation",
"security": [{ "OAuth2PasswordBearer": [] }],
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MessageAPISend" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageAPISendResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v2/orgs/{account_name}/conversations/{conversation_id}": {
"get": {
"tags": ["v2", "conversations_v2"],
"summary": "Read Conversation Messages",
"description": "Get messages in a conversation.\n\nThis paginated endpoint returns a conversation with up to the requested number of\nmessages. Note that the messages are ordered from newest to oldest. The client can\nspecify that they want messages after a particular index by providing an offset in\norder to only get new messages. Note that the server can choose to exclude the payload\n(returning null) from some messages for performance reasons. The client must then make\nindividual requests for those messages to get the contents.\n\nParams:\n accepted_payload_types: The payload types that can be used in the conversation.\n If included in the params then it must include the TEXT type. Note that\n excluding a type can cause messages of that type not to be sent. Messages are not\n always converted to an accepted type (i.e. if you want table contents, you\n have to have the “TABLE” type in the accepted types). If None then all types\n are accepted.\n limit: The maximum number of messages to return.\n offset: The number of messages to skip.\n bound: The index of the last message to return. The response will not include\n indexes less than this value.",
"operationId": "read_conversation_messages",
"security": [{ "OAuth2PasswordBearer": [] }],
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "conversation_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
}
},
{
"name": "accepted_payload_types",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "$ref": "#/components/schemas/MessagePayloadType" }
},
{ "type": "null" }
],
"title": "Accepted Payload Types"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 20, "title": "Limit" }
},
{
"name": "offset",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Offset" }
},
{
"name": "bound",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Bound" }
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ConversationAPIReadResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v2/orgs/{account_name}/datasets/{star_schema_data_source_id}/suggestions": {
"get": {
"tags": ["v2", "datasets_v2"],
"summary": "Get Suggested Prompts For Dataset",
"description": "Get suggested prompts for a star schema data source.",
"operationId": "get_suggested_prompts_for_dataset",
"security": [{ "OAuth2PasswordBearer": [] }],
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "number_suggestions",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 5,
"title": "Number Suggestions"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "type": "string" },
"title": "Response Get Suggested Prompts For Dataset Api V2 Orgs Account Name Datasets Star Schema Data Source Id Suggestions Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v2/orgs/{account_name}/tasks/ids": {
"get": {
"tags": ["v2", "tasks_v2"],
"summary": "Read Tasks By Ids V2",
"description": "Get specific task(s) by id(s).",
"operationId": "read_tasks_by_ids_v2",
"security": [{ "OAuth2PasswordBearer": [] }],
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "task_id",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": { "type": "string", "format": "uuid4" },
"description": "A list of task ids to retrieve.",
"default": [],
"title": "Task Id"
},
"description": "A list of task ids to retrieve."
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/TaskAPI" },
"title": "Response Read Tasks By Ids V2 Api V2 Orgs Account Name Tasks Ids Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v2/orgs/{account_name}/messages/{message_id}": {
"get": {
"tags": ["v2", "messages_v2"],
"summary": "Read Message",
"description": "Read a message.\n\nGet the message including the contents of its payload. This endpoint is needed for\nreading the contents of messages after their tasks finish and messages that would\ncause performance issues for the backend to return in batches. Note that this endpoint\naccepts different params that will be used/ignored depending on payload type. Each\nparameter will apply only to one payload type.",
"operationId": "read_message",
"security": [{ "OAuth2PasswordBearer": [] }],
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "message_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Message Id"
}
},
{
"name": "accepted_payload_types",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": { "$ref": "#/components/schemas/MessagePayloadType" }
},
{ "type": "null" }
],
"title": "Accepted Payload Types"
}
},
{
"name": "table_limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"default": 20,
"title": "Table Limit"
}
},
{
"name": "table_offset",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 0,
"default": 0,
"title": "Table Offset"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageAPIGetResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v2/orgs/{account_name}/messages/{message_id}/feedback": {
"post": {
"tags": ["v2", "messages_v2"],
"summary": "Create Feedback",
"description": "Create negative feedback for a message.\n\nNote that feedback is shared amongst all messages in the AI response. Providing\nfeedback for on message will affect all messages that share the same `responds_to`.",
"operationId": "create_feedback",
"security": [{ "OAuth2PasswordBearer": [] }],
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "message_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Message Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NegativeFeedbackAPISend"
}
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageAPIGetResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v2", "messages_v2"],
"summary": "Remove Feedback",
"description": "Remove feedback for a message.",
"operationId": "remove_feedback",
"security": [{ "OAuth2PasswordBearer": [] }],
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "message_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Message Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageAPIGetResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/agents": {
"get": {
"tags": ["v3", "chat"],
"summary": "Get Chat Agents",
"description": "Get list of available agents by name.",
"operationId": "get_chat_agents",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/AgentAPI" },
"title": "Response Get Chat Agents Api V3 Orgs Account Name Chat Agents Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/": {
"post": {
"tags": ["v3", "chat", "public"],
"summary": "Create Chat",
"description": "Create a chat. This will not send a message to the chat.\n\nNote that you can also create a chat using the send message endpoint. Doing so will\nlet you skip making a separate call to create the chat.",
"operationId": "create_chat",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChatAPICreate" }
}
}
},
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChatAPIResponse" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v3", "chat", "public"],
"summary": "Get Chats",
"description": "Read all chats.",
"operationId": "get_chats",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "sort_ascending",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"description": "Sort ascending. If false, sort descending.",
"default": true,
"title": "Sort Ascending"
},
"description": "Sort ascending. If false, sort descending."
},
{
"name": "sort_by",
"in": "query",
"required": false,
"schema": {
"allOf": [{ "$ref": "#/components/schemas/ChatsSort" }],
"description": "The field to sort by.",
"default": "created_at",
"title": "Sort By"
},
"description": "The field to sort by."
},
{
"name": "filter_by",
"in": "query",
"required": false,
"schema": {
"allOf": [{ "$ref": "#/components/schemas/ChatsFilter" }],
"description": "Filter for a particular kind of chats.",
"default": "is_by_user",
"title": "Filter By"
},
"description": "Filter for a particular kind of chats."
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "The maximum number of chats to include in the response.",
"default": 100,
"title": "Limit"
},
"description": "The maximum number of chats to include in the response."
},
{
"name": "offset",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 0,
"description": "The maximum number of chats to include in the response.",
"default": 0,
"title": "Offset"
},
"description": "The maximum number of chats to include in the response."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChatAPIResponsePage" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/{chat_id}": {
"delete": {
"tags": ["v3", "chat", "public"],
"summary": "Delete Chat",
"description": "Delete a chat.\n\nCAUTION: This is unrecoverable. All messages associated with the chat will be deleted.",
"operationId": "delete_chat",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "chat_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The ID of the chat.",
"title": "Chat Id"
},
"description": "The ID of the chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChatAPIResponse" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v3", "chat", "public"],
"summary": "Update Chat",
"description": "Update a chat.",
"operationId": "update_chat",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "chat_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The ID of the chat.",
"title": "Chat Id"
},
"description": "The ID of the chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"allOf": [{ "$ref": "#/components/schemas/ChatAPIUpdate" }],
"description": "The updates to the chat object.",
"title": "Chat In"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChatAPIResponse" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v3", "chat", "public"],
"summary": "Get Chat",
"description": "Read a single chat.\n\nNote that this does NOT include the messages of the chat. See the get\nchat messages endpoint (GET api/v3/orgs/{account_name}/chats/{chat_id}/messages/) for that.",
"operationId": "get_chat",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "chat_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The ID of the chat.",
"title": "Chat Id"
},
"description": "The ID of the chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChatAPIResponse" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/slack": {
"get": {
"tags": ["v3", "chat"],
"summary": "Get By Slack Id",
"description": "Read a single chat by slack ID.\n\nNote that this does NOT include the messages of the chat. See the get\nchat messages endpoint (GET api/v3/orgs/{account_name}/chats/{chat_id}/messages/) for that.\nIf a chat with the given slack ID does not exist, then this will 404.",
"operationId": "get_by_slack_id",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "slack_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"description": "The slack ID of the chat.",
"title": "Slack Id"
},
"description": "The slack ID of the chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChatAPIResponse" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/{chat_id}/promptlogs": {
"get": {
"tags": ["v3", "chat"],
"summary": "Get Chat Promptlogs",
"description": "Get chat message promptlogs sorted in descending order.",
"operationId": "get_chat_promptlogs",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "chat_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The ID of the chat.",
"title": "Chat Id"
},
"description": "The ID of the chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ChatMessagePromptlogInDB"
},
"title": "Response Get Chat Promptlogs Api V3 Orgs Account Name Chat Chat Id Promptlogs Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/{chat_id}/messages": {
"get": {
"tags": ["v3", "chat", "public"],
"summary": "Get Chat Messages",
"description": "Get messages in a chat.\n\nThis paginated endpoint returns a chat with up to the requested number of\nmessages. Note that the messages are ordered from newest to oldest.",
"operationId": "get_chat_messages",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "chat_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The ID of the chat.",
"title": "Chat Id"
},
"description": "The ID of the chat."
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "The maximum number of messages to include in the response.",
"default": 20,
"title": "Limit"
},
"description": "The maximum number of messages to include in the response."
},
{
"name": "offset",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 0,
"description": "The messages to skip. The response will not include indexes greater than the offset. Equivalent of 'skip' in database queries.",
"default": 0,
"title": "Offset"
},
"description": "The messages to skip. The response will not include indexes greater than the offset. Equivalent of 'skip' in database queries."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageAPIResponsePage"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/{chat_id}/interrupt": {
"post": {
"tags": ["v3", "chat", "public"],
"summary": "Send Interrupt",
"description": "Send a interrupt signal in a chat.\n\nNote that this sends the signal regardless of whether the AI is currently\ngenerating",
"operationId": "send_interrupt",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "chat_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The ID of the chat.",
"title": "Chat Id"
},
"description": "The ID of the chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": { "application/json": { "schema": {} } }
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/{chat_id}/clone": {
"post": {
"tags": ["v3", "chat", "public"],
"summary": "Clone Chat",
"description": "Clone a chat with the new user as the creator.",
"operationId": "clone_chat",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "chat_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The ID of the chat.",
"title": "Chat Id"
},
"description": "The ID of the chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/ChatAPIResponse" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/{chat_id}/eval": {
"post": {
"tags": ["v3", "eval_v3"],
"summary": "Run Eval On Chat",
"description": "Run eval on all of the messages sent in the reference chat.",
"operationId": "run_eval_on_chat",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "chat_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The ID of the chat.",
"title": "Chat Id"
},
"description": "The ID of the chat."
},
{
"name": "delete_new_chat",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Delete New Chat"
}
},
{
"name": "run_group_chat",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Run Group Chat"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/chat/{star_schema_data_source_id}/eval_chats": {
"post": {
"tags": ["v3", "eval_v3"],
"summary": "Run Eval Chats",
"description": "Run eval on reference chats.",
"operationId": "run_eval_chats",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "star_schema_data_source_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Star Schema Data Source Id"
}
},
{
"name": "max_eval_chats",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Max Eval Chats"
}
},
{
"name": "delete_new_chat",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": true,
"title": "Delete New Chat"
}
},
{
"name": "run_group_chat",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Run Group Chat"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/Task" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/messages/": {
"post": {
"tags": ["v3", "messages", "public"],
"summary": "Send Message",
"description": "Send a message.\n\nThis endpoint returns a server sent event stream composed of `MessageAPIResponse` objects.\nThe stream will close when the model is done generating responses and is ready for more\ninput.\n\nIf a chat_id is provided, the message will be sent to that chat. A chat will be created and\nthe MessageAPIResponse will contain the new chat_id. If the chat does not have a name, then\na name will be generated asynchronously. It should be available within a few seconds.",
"operationId": "send_message",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MessageAPISendV3" }
}
}
},
"responses": {
"201": {
"description": "Message sent successfully. Returns an event stream of `MessageAPIResponse` objects.",
"content": {
"text/event-stream": {
"schema": { "$ref": "#/components/schemas/MessageAPIResponse" }
}
}
},
"409": {
"description": "Chat is busy. Returns an event stream of the running chat.",
"content": {
"text/event-stream": {
"schema": { "$ref": "#/components/schemas/MessageAPIResponse" }
}
}
},
"404": { "description": "The chat or message could not be found." },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v3", "messages"],
"summary": "Get Account User Questions",
"description": "Get messages in an account.",
"operationId": "get_account_user_questions",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 20, "title": "Limit" }
},
{
"name": "offset",
"in": "query",
"required": false,
"schema": { "type": "integer", "default": 0, "title": "Offset" }
},
{
"name": "sending_agent",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/AgentName" },
{ "type": "null" }
],
"default": "user",
"title": "Sending Agent"
}
},
{
"name": "receiving_agent",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "$ref": "#/components/schemas/AgentName" },
{ "type": "null" }
],
"title": "Receiving Agent"
}
},
{
"name": "before_timestamp",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "date-time" },
{ "type": "null" }
],
"title": "Before Timestamp"
}
},
{
"name": "after_timestamp",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "string", "format": "date-time" },
{ "type": "null" }
],
"title": "After Timestamp"
}
},
{
"name": "is_positive_feedback",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Positive Feedback"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageAPIResponsePage"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/messages/{message_id}/promptlogs": {
"get": {
"tags": ["v3", "messages"],
"summary": "Get Message Promptlog",
"description": "Get chat message promptlogs.",
"operationId": "get_message_promptlog",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "message_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The id of a message in a chat.",
"title": "Message Id"
},
"description": "The id of a message in a chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ChatMessagePromptlogInDB"
},
"title": "Response Get Message Promptlog Api V3 Orgs Account Name Messages Message Id Promptlogs Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/messages/{message_id}/refresh": {
"put": {
"tags": ["v3", "messages", "public"],
"summary": "Refresh Query Message",
"description": "Refresh the SQL table in a chat message.\n\nThis will return an error if the message does not contain a table ID.\nNote that you will need to refetch the data from the data endpoint to see the updates.",
"operationId": "refresh_query_message",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "message_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The id of a message in a chat.",
"title": "Message Id"
},
"description": "The id of a message in a chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "The table associated with the message was refreshed successfully.",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MessageAPIResponse" }
}
}
},
"400": {
"description": "Bad request. Verify that the message contains a table ID."
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/messages/{message_id}/feedback": {
"put": {
"tags": ["v3", "messages", "public"],
"summary": "Update Message Feedback (Experimental 🧪)",
"description": "Update the thumbs up / down user-provided feedback on a chat message.\n\nFeedback for the system response to a user question is associated with the\nuser question, instead of the response messages. Only user messages can\nreceive feedback at this time.\n\nOnly the chat creator can provide feedback on messages within the chat.\n\nWARNING: This endpoint is experimental and its behavior may change without warning.",
"operationId": "update_message_feedback",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "message_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The id of a message in a chat.",
"title": "Message Id"
},
"description": "The id of a message in a chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MessageUpdateFeedbackAPI"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/MessageAPIResponse" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/messages/{message_id}/data": {
"get": {
"tags": ["v3", "messages", "public"],
"summary": "Read Message Table Data",
"description": "Get the table data associated with a message.\n\nThis will return an error if the message does not contain a table ID.",
"operationId": "read_message_table_data",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "message_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The id of a message in a chat.",
"title": "Message Id"
},
"description": "The id of a message in a chat."
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "The maximum number of rows to include in the response.",
"default": 100,
"title": "Limit"
},
"description": "The maximum number of rows to include in the response."
},
{
"name": "skip",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 0,
"description": "The number of rows to skip. Equivalent of 'skip' in database queries.",
"default": 0,
"title": "Skip"
},
"description": "The number of rows to skip. Equivalent of 'skip' in database queries."
},
{
"name": "sort",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{ "type": "array", "items": { "type": "string" } },
{ "type": "null" }
],
"description": "The columns to sort by. Prefix with '-' for descending order.",
"title": "Sort"
},
"description": "The columns to sort by. Prefix with '-' for descending order."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DataPage" }
}
}
},
"400": {
"description": "Bad request. Verify that the message contains a table ID."
},
"404": { "description": "The item could not be found." },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/messages/{message_id}/data/csv": {
"get": {
"tags": ["v3", "messages", "public"],
"summary": "Read Message Table Data As Csv",
"description": "Read message table data as a CSV.\n\nThis will return an error if the message does not contain a table ID.",
"operationId": "read_message_table_data_as_csv",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "message_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"description": "The id of a message in a chat.",
"title": "Message Id"
},
"description": "The id of a message in a chat."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "The table data as a CSV file.",
"content": { "text/csv": {} }
},
"400": {
"description": "Bad request. Verify that the message contains a table ID."
},
"404": { "description": "The item could not be found." },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/widgets/": {
"post": {
"tags": ["v3", "widget"],
"summary": "Create Widget",
"description": "Create a widget.\n\nFor now, we only allow one widget per account.",
"operationId": "create_widget",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "key",
"in": "query",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Key"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"201": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WidgetAPICreateResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"get": {
"tags": ["v3", "widget"],
"summary": "Get Widget For Account",
"description": "Get widget by account ID.",
"operationId": "get_widget_for_account",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WidgetAPIGetResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/widgets/{widget_id}": {
"get": {
"tags": ["v3", "widget"],
"summary": "Get Widget",
"description": "Get widget by ID.",
"operationId": "get_widget",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "widget_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Widget Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WidgetAPIGetResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"put": {
"tags": ["v3", "widget"],
"summary": "Update Widget",
"description": "Update widget by ID.\n\nCurrently this endpoint supports updating the `options` and the `key` fields.",
"operationId": "update_widget",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "widget_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Widget Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WidgetAPIUpdateRequest"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WidgetAPIUpdateResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
},
"delete": {
"tags": ["v3", "widget"],
"summary": "Delete Widget",
"description": "Delete widget by ID.",
"operationId": "delete_widget",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "widget_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"format": "uuid4",
"title": "Widget Id"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"204": { "description": "Successful Response" },
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/data_assets/": {
"get": {
"tags": ["v3", "data_assets", "public"],
"summary": "Get Data Assets For Account",
"description": "Get data assets for an account.",
"operationId": "get_data_assets_for_account",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"default": 100,
"title": "Limit"
}
},
{
"name": "offset",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 0,
"default": 0,
"title": "Offset"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/DataAssetAPIPage" }
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/data_assets/suggestions": {
"get": {
"tags": ["v3", "data_assets", "public"],
"summary": "Get Suggestions For Account",
"description": "Get suggested prompts for an account across all datasets in the account.",
"operationId": "get_suggestions_for_account",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"default": 5,
"title": "Limit"
}
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": { "$ref": "#/components/schemas/SuggestionAPI" },
"title": "Response Get Suggestions For Account Api V3 Orgs Account Name Data Assets Suggestions Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/slack/events": {
"post": {
"tags": ["v3", "slack"],
"summary": "Events",
"operationId": "events",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Events Api V3 Slack Events Post"
}
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/slack/install": {
"get": {
"tags": ["v3", "slack"],
"summary": "Install",
"operationId": "install",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": { "type": "string", "title": "Account Name" }
},
{
"name": "session_id",
"in": "cookie",
"required": false,
"schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Session Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Install Api V3 Orgs Account Name Slack Install Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
},
"/api/v3/orgs/{account_name}/slack/auth/oauth": {
"get": {
"tags": ["v3", "slack"],
"summary": "Oauth",
"operationId": "oauth",
"parameters": [
{
"name": "account_name",
"in": "path",
"required": true,
"schema": {
"type": "string",
"description": "The name of the organization or account.",
"title": "Account Name"
},
"description": "The name of the organization or account."
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"title": "Response Oauth Api V3 Orgs Account Name Slack Auth Oauth Get"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HTTPValidationError" }
}
}
}
}
}
}
},
"components": {
"schemas": {
"APIKeyAPICreate": {
"properties": {
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
}
},
"type": "object",
"title": "APIKeyAPICreate",
"description": "Properties to receive via API on creation."
},
"APIKeyCreateResponse": {
"properties": {
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"account_id": {
"type": "string",
"format": "uuid4",
"title": "Account Id"
},
"creator_id": {
"type": "string",
"format": "uuid4",
"title": "Creator Id"
},
"key": { "type": "string", "title": "Key" }
},
"type": "object",
"required": ["id", "account_id", "creator_id", "key"],
"title": "APIKeyCreateResponse",
"description": "Properties to return after creating an API Key."
},
"Account": {
"properties": {
"name": { "type": "string", "title": "Name" },
"display_name": { "type": "string", "title": "Display Name" },
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"avatar": {
"anyOf": [
{ "type": "string", "minLength": 1, "format": "uri" },
{ "type": "null" }
],
"title": "Avatar"
},
"colors": {
"anyOf": [
{
"items": { "type": "string", "format": "color" },
"type": "array",
"minItems": 10
},
{ "type": "null" }
],
"title": "Colors"
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
},
"allowed_domains": {
"items": { "$ref": "#/components/schemas/Domain" },
"type": "array",
"title": "Allowed Domains"
}
},
"type": "object",
"required": [
"name",
"display_name",
"id",
"created_at",
"updated_at",
"allowed_domains"
],
"title": "Account",
"description": "Additional properties to return via API."
},
"AccountCreate": {
"properties": {
"name": { "type": "string", "title": "Name" },
"display_name": { "type": "string", "title": "Display Name" },
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"avatar": {
"anyOf": [
{ "type": "string", "minLength": 1, "format": "uri" },
{ "type": "null" }
],
"title": "Avatar"
},
"colors": {
"anyOf": [
{
"items": { "type": "string", "format": "color" },
"type": "array",
"minItems": 10
},
{ "type": "null" }
],
"title": "Colors"
}
},
"type": "object",
"required": ["name", "display_name"],
"title": "AccountCreate",
"description": "Properties to receive via API on creation."
},
"AccountSetting_Union_bool__int__str__": {
"properties": {
"name": { "type": "string", "title": "Name" },
"description": { "type": "string", "title": "Description" },
"value_object": {
"$ref": "#/components/schemas/SettingValue_Union_bool__int__str__"
},
"is_superuser_editable": {
"type": "boolean",
"title": "Is Superuser Editable"
},
"is_admin_editable": {
"type": "boolean",
"title": "Is Admin Editable"
},
"is_value_sent_to_client": {
"type": "boolean",
"title": "Is Value Sent To Client",
"default": true
},
"value": {
"anyOf": [
{ "type": "boolean" },
{ "type": "integer" },
{ "type": "string" },
{ "type": "null" }
],
"title": "Value"
},
"admin_value": {
"anyOf": [
{ "type": "boolean" },
{ "type": "integer" },
{ "type": "string" },
{ "type": "null" }
],
"title": "Admin Value"
},
"superuser_value": {
"anyOf": [
{ "type": "boolean" },
{ "type": "integer" },
{ "type": "string" },
{ "type": "null" }
],
"title": "Superuser Value"
},
"default_value": {
"anyOf": [
{ "type": "boolean" },
{ "type": "integer" },
{ "type": "string" },
{ "type": "null" }
],
"title": "Default Value"
}
},
"type": "object",
"required": [
"name",
"description",
"value_object",
"is_superuser_editable",
"is_admin_editable",
"value"
],
"title": "AccountSetting[Union[bool, int, str]]"
},
"AccountSettings": {
"properties": {
"test_setting": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "test_setting",
"description": "Basic test setting.",
"value_object": { "value": true },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": true
}
},
"test_int_setting": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "test_int_setting",
"description": "Basic test int setting.",
"value_object": { "value": 0 },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": 0
}
},
"setting_admin_and_superuser_can_edit": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "setting_admin_and_superuser_can_edit",
"description": "Setting that the admin and the superuser can edit.",
"value_object": { "value": true },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": true
}
},
"setting_admin_can_edit": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "setting_admin_can_edit",
"description": "Setting that the admin can edit.",
"value_object": { "value": true },
"is_superuser_editable": false,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": true
}
},
"setting_superuser_can_edit": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "setting_superuser_can_edit",
"description": "Setting that the superuser can edit.",
"value_object": { "value": true },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": true
}
},
"setting_not_sent_to_client": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "setting_not_sent_to_client",
"description": "Setting that is not sent to the client.",
"value_object": { "value": true },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": false,
"value": true
}
},
"show_data_dev_tools": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "show_data_dev_tools",
"description": "Show react query dev tools within the app",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"enable_multiview_support": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "enable_multiview_support",
"description": "Enable multiview support",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"enable_copy_from_example": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "enable_copy_from_example",
"description": "Enable copy from example",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"show_charts_v2": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "show_charts_v2",
"description": "Show Cell Charts V2",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"fuzzy_filter_cardinality_threshold": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "fuzzy_filter_cardinality_threshold",
"description": "Cardinality threshold to use fuzzy match. (Defaults to 100, -1 means no fuzzy match)",
"value_object": { "value": 100 },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": 100
}
},
"dataset_update_existing_dimensions_metrics": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_update_existing_dimensions_metrics",
"description": "Update existing dimensions and metrics when creating/updating dataset.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"dataset_include_metrics": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_include_metrics",
"description": "Include metrics when creating/updating dataset.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"dataset_initial_dimension_metric_state": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_initial_dimension_metric_state",
"description": "Initial state of dimensions and metrics.",
"value_object": { "value": "Verified" },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": "Verified"
}
},
"dataset_num_rows_to_profile": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_num_rows_to_profile",
"description": "Number of rows to profile (Defaults to -1, -1 means no account setting, read from system setting)",
"value_object": { "value": -1 },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": -1
}
},
"dataset_top_k_profile_values_for_retrieval": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_top_k_profile_values_for_retrieval",
"description": "Top K profile values for retrieval (Defaults to -1, -1 means no account setting, read from system setting)",
"value_object": { "value": -1 },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": -1
}
},
"is_chats_default": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "is_chats_default",
"description": "Whether chats is the default experience in-app.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": false
}
},
"is_widget_default": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "is_widget_default",
"description": "Whether the new widget UI is the default experience in-app.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": false
}
},
"show_widget_settings": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "show_widget_settings",
"description": "Whether to show the widget settings.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": false
}
},
"show_streamlit_button": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "show_streamlit_button",
"description": "Whether to show the button that links to the streamlit demos of new agents.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"use_onboarding_agent": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "use_onboarding_agent",
"description": "Whether to use onboarding agent.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"use_predictive_model_agent": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "use_predictive_model_agent",
"description": "Whether to use predictive model agent.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"add_dms_from_reports": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "add_dms_from_reports",
"description": "Whether to extract DMs from reports",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"use_knowledge_sql": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "use_knowledge_sql",
"description": "Whether to use knowledge sql.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"grouping_strategy": {
"allOf": [
{
"$ref": "#/components/schemas/AccountSetting_Union_bool__int__str__"
}
],
"default": {
"name": "grouping_strategy",
"description": "Strategy to use to group dimensions and metrics.",
"value_object": { "value": "DM_GROUPING" },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": "DM_GROUPING"
}
}
},
"type": "object",
"title": "AccountSettings",
"description": "Object containing all account settings.\n\nThis object overrides the seeded account setting values with the values in the database.\nIt combines the default settings, the account settings, and the superuser account settings\nusing the following rules in order of precendence:\n1. If the setting is editable by the superuser and the superuser has set the value, then\n the superuser value is used.\n2. If the setting is editable by the admin and the admin has set the value, then the admin\n value is used.\n3. Otherwise, the default value is used."
},
"AccountUpdate": {
"properties": {
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"display_name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Display Name"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"avatar": {
"anyOf": [
{ "type": "string", "minLength": 1, "format": "uri" },
{ "type": "null" }
],
"title": "Avatar"
},
"colors": {
"anyOf": [
{
"items": { "type": "string", "format": "color" },
"type": "array",
"minItems": 10
},
{ "type": "null" }
],
"title": "Colors"
}
},
"type": "object",
"title": "AccountUpdate",
"description": "Properties to receive via API on update."
},
"AgentAPI": {
"properties": {
"name": { "type": "string", "title": "Name" },
"display_name": { "type": "string", "title": "Display Name" },
"description": { "type": "string", "title": "Description" },
"default": { "type": "boolean", "title": "Default" },
"deps": {
"items": { "$ref": "#/components/schemas/AgentDep" },
"type": "array",
"title": "Deps"
}
},
"type": "object",
"required": ["name", "display_name", "description", "default", "deps"],
"title": "AgentAPI",
"description": "An agent in the application.\n\nAttributes:\n name: unique identifier of the agent\n display_name: human readable name of the agent\n description: a description of what the agent does\n default: whether the agent is enabled by default\n deps: list of agents that must be enabled for this agent to be enabled"
},
"AgentDep": {
"properties": {
"agent_names": {
"items": { "type": "string" },
"type": "array",
"title": "Agent Names"
},
"require_dataset": { "type": "boolean", "title": "Require Dataset" }
},
"type": "object",
"required": ["agent_names", "require_dataset"],
"title": "AgentDep",
"description": "The dependencies for an agent.\n\nNote that conditions with a single AgentDep are always a disjunction (OR).\n\nAttributes:\n agent_names: A list of agents, one of which must be enabled.\n require_dataset: Whether selecting a dataset also satisfies this dep."
},
"AgentName": {
"type": "string",
"enum": [
"user",
"manager",
"query agent",
"sql_query_agent",
"query_explanation_agent",
"planner_agent",
"search_agent",
"search_rerank_agent",
"onboarding_agent",
"predictive_model_agent",
"vega_chart_agent",
"chart_validation_agent"
],
"title": "AgentName",
"description": "Agent names."
},
"AppSession": {
"properties": {
"id": { "type": "string", "title": "Id" },
"user_id": {
"type": "string",
"format": "uuid4",
"title": "User Id"
},
"username": { "type": "string", "title": "Username" },
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"last_accessed": {
"type": "string",
"format": "date-time",
"title": "Last Accessed"
},
"expires_at": {
"type": "string",
"format": "date-time",
"title": "Expires At"
},
"csrf_token": { "type": "string", "title": "Csrf Token" },
"client_host": { "type": "string", "title": "Client Host" },
"user_agent": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "User Agent"
},
"provider_metadata": {
"anyOf": [
{ "$ref": "#/components/schemas/OktaMetadata" },
{ "type": "null" }
]
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"user_id",
"username",
"created_at",
"last_accessed",
"expires_at",
"csrf_token",
"client_host",
"user_agent",
"provider_metadata"
],
"title": "AppSession"
},
"Axis": {
"type": "string",
"enum": ["x", "y", "size", "group"],
"title": "Axis",
"description": "Enumerates the X and Y axis."
},
"BBExample": {
"properties": {
"question": { "type": "string", "title": "Question" },
"question_openai_embedding": {
"anyOf": [
{ "items": { "type": "number" }, "type": "array" },
{ "type": "null" }
],
"title": "Question Openai Embedding"
},
"question_variants": {
"items": { "type": "string" },
"type": "array",
"title": "Question Variants",
"default": []
},
"id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Id"
},
"ssds_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Ssds Id"
},
"summary": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Summary"
},
"query": {
"anyOf": [
{ "$ref": "#/components/schemas/QueryWithValidation" },
{ "type": "null" }
]
},
"additional_dimensions": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/DimensionViewWithoutDialect"
},
"type": "array"
},
{ "type": "null" }
],
"title": "Additional Dimensions"
},
"additional_metrics": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/MetricViewWithoutDialect"
},
"type": "array"
},
{ "type": "null" }
],
"title": "Additional Metrics"
}
},
"type": "object",
"required": ["question"],
"title": "BBExample",
"description": "Bumblebee Example."
},
"BadResponseAPICreate": {
"properties": {
"user_feedback": { "type": "string", "title": "User Feedback" }
},
"type": "object",
"required": ["user_feedback"],
"title": "BadResponseAPICreate",
"description": "Create Feedback Schema DTO for API."
},
"BaseColumnStatistics": {
"properties": {
"name": { "type": "string", "title": "Name" },
"type": { "type": "string", "title": "Type" },
"count": { "type": "integer", "title": "Count" },
"num_nulls": { "type": "integer", "title": "Num Nulls" },
"num_distinct_values": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Num Distinct Values"
},
"stat_type": {
"type": "string",
"enum": ["base"],
"const": "base",
"title": "Stat Type",
"default": "base"
}
},
"type": "object",
"required": ["name", "type", "count", "num_nulls"],
"title": "BaseColumnStatistics",
"description": "Common column statistics with discriminator."
},
"BigQueryConnection": {
"properties": {
"name": { "type": "string", "title": "Name" },
"account_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Account Id"
},
"is_demo": { "type": "boolean", "title": "Is Demo" },
"is_draft": {
"type": "boolean",
"title": "Is Draft",
"default": false
},
"status": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Status"
},
"status_at": {
"anyOf": [
{ "type": "string", "format": "date-time" },
{ "type": "null" }
],
"title": "Status At"
},
"type": {
"anyOf": [
{ "$ref": "#/components/schemas/ConnectionPolyType" },
{ "type": "null" }
]
},
"max_tables": {
"type": "integer",
"exclusiveMinimum": 0.0,
"title": "Max Tables",
"default": 8000
},
"warehouse_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Warehouse Access"
},
"result_cache_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Result Cache Access"
},
"error_msg": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Error Msg"
},
"ns_database": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Ns Database"
},
"ns_schema": { "type": "string", "title": "Ns Schema" },
"location": { "$ref": "#/components/schemas/BigQueryLocation" },
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
},
"project_id": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Project Id"
},
"private_key_id": { "type": "string", "title": "Private Key Id" }
},
"type": "object",
"required": [
"name",
"is_demo",
"ns_schema",
"location",
"id",
"created_at",
"updated_at",
"private_key_id"
],
"title": "BigQueryConnection",
"description": "Additional properties to return via API."
},
"BigQueryConnectionAPICreate": {
"properties": {
"name": { "type": "string", "title": "Name" },
"type": {
"allOf": [{ "$ref": "#/components/schemas/ConnectionPolyType" }],
"default": "bigquery"
},
"keyfile": { "type": "string", "title": "Keyfile" },
"location": { "$ref": "#/components/schemas/BigQueryLocation" },
"ns_schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Ns Schema"
},
"ns_database": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Ns Database"
},
"max_tables": {
"type": "integer",
"exclusiveMinimum": 0.0,
"title": "Max Tables",
"default": 8000
}
},
"type": "object",
"required": ["name", "keyfile", "location"],
"title": "BigQueryConnectionAPICreate",
"description": "Properties to receive via API on creation."
},
"BigQueryConnectionAPIUpdate": {
"properties": {
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"keyfile": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Keyfile"
},
"location": {
"anyOf": [
{ "$ref": "#/components/schemas/BigQueryLocation" },
{ "type": "null" }
]
},
"ns_database": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Ns Database"
},
"ns_schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Ns Schema"
},
"max_tables": {
"anyOf": [
{ "type": "integer", "exclusiveMinimum": 0.0 },
{ "type": "null" }
],
"title": "Max Tables"
}
},
"type": "object",
"title": "BigQueryConnectionAPIUpdate",
"description": "Properties to receive via API on update."
},
"BigQueryConnectionLookup": {
"properties": {
"project_id": { "type": "string", "title": "Project Id" },
"location": { "type": "string", "title": "Location" }
},
"type": "object",
"required": ["project_id", "location"],
"title": "BigQueryConnectionLookup",
"description": "BigQuery Connection Lookup."
},
"BigQueryLocation": {
"type": "string",
"enum": [
"asia-east1",
"asia-east2",
"asia-northeast1",
"asia-northeast2",
"asia-northeast3",
"asia-south1",
"asia-south2",
"asia-southeast2",
"asia-southeast3",
"australia-southeast1",
"australia-southeast2",
"EU",
"europe-central2",
"europe-north1",
"europe-southwest1",
"europe-west1",
"europe-west2",
"europe-west3",
"europe-west4",
"europe-west6",
"europe-west8",
"europe-west9",
"me-west1",
"northamerica-northeast1",
"northamerica-northeast2",
"southamerica-southeast1",
"southamerica-southwest1",
"us-central1",
"us-east1",
"us-east4",
"us-east5",
"US",
"us-west1",
"us-west2",
"us-west3",
"us-west4"
],
"title": "BigQueryLocation",
"description": "Enum of all supported BigQuery locations.\n\nRef: https://cloud.google.com/bigquery/docs/locations"
},
"Body_create_dimension_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__dimensions__post": {
"properties": {
"dimension_in": {
"$ref": "#/components/schemas/DimensionViewWithoutDialect"
},
"enrich_params": {
"anyOf": [
{ "$ref": "#/components/schemas/StarSchemaDataSourceEnrichment" },
{ "type": "null" }
]
}
},
"type": "object",
"required": ["dimension_in"],
"title": "Body_create_dimension_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__dimensions__post"
},
"Body_create_metric_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__metrics__post": {
"properties": {
"metric_in": {
"$ref": "#/components/schemas/MetricViewWithoutDialect"
},
"enrich_params": {
"anyOf": [
{ "$ref": "#/components/schemas/StarSchemaDataSourceEnrichment" },
{ "type": "null" }
]
}
},
"type": "object",
"required": ["metric_in"],
"title": "Body_create_metric_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__metrics__post"
},
"Body_create_remapped_ssds_api_v1_accounts__account_name__star_schema_data_source_remap_ssds_post": {
"properties": {
"inputs": {
"items": {
"additionalProperties": { "type": "string" },
"type": "object"
},
"type": "array",
"title": "Inputs"
},
"database_schema": {
"additionalProperties": {
"additionalProperties": { "type": "string" },
"type": "object"
},
"type": "object",
"title": "Database Schema"
},
"manual_joins": {
"items": { "$ref": "#/components/schemas/RemappedQueryJoinInfo" },
"type": "array",
"title": "Manual Joins"
}
},
"type": "object",
"required": ["inputs", "database_schema"],
"title": "Body_create_remapped_ssds_api_v1_accounts__account_name__star_schema_data_source_remap_ssds_post"
},
"Body_create_user_open_api_v1_users_open_post": {
"properties": {
"password": { "type": "string", "title": "Password" },
"email": { "type": "string", "format": "email", "title": "Email" },
"name": { "type": "string", "title": "Name" },
"avatar": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Avatar"
},
"preload_demo_dataset": {
"type": "boolean",
"title": "Preload Demo Dataset",
"default": false
}
},
"type": "object",
"required": ["password", "email", "name"],
"title": "Body_create_user_open_api_v1_users_open_post"
},
"Body_enrich_ssds_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__enrich_ssds_post": {
"properties": {
"enable": { "type": "boolean", "title": "Enable", "default": true },
"update_index": {
"type": "boolean",
"title": "Update Index",
"default": true
},
"update_expr_types": {
"type": "boolean",
"title": "Update Expr Types",
"default": true
},
"update_display_types": {
"type": "boolean",
"title": "Update Display Types",
"default": true
},
"update_profiles": {
"type": "boolean",
"title": "Update Profiles",
"default": true
},
"num_rows_to_profile": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Num Rows To Profile"
},
"top_k_profile_values_for_retrieval": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Top K Profile Values For Retrieval"
}
},
"type": "object",
"title": "Body_enrich_ssds_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__enrich_ssds_post"
},
"Body_extract_sqls_from_csv_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__extract_sqls_from_csv_post": {
"properties": {
"csv_file": {
"type": "string",
"format": "binary",
"title": "Csv File"
}
},
"type": "object",
"required": ["csv_file"],
"title": "Body_extract_sqls_from_csv_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__extract_sqls_from_csv_post"
},
"Body_import_from_twb_api_v1_accounts__account_name__star_schema_data_source_import_from_twb_post": {
"properties": {
"twb_file": {
"type": "string",
"format": "binary",
"title": "Twb File"
},
"enable": { "type": "boolean", "title": "Enable", "default": true },
"update_index": {
"type": "boolean",
"title": "Update Index",
"default": true
},
"update_expr_types": {
"type": "boolean",
"title": "Update Expr Types",
"default": true
},
"update_display_types": {
"type": "boolean",
"title": "Update Display Types",
"default": true
},
"update_profiles": {
"type": "boolean",
"title": "Update Profiles",
"default": true
},
"num_rows_to_profile": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Num Rows To Profile"
},
"top_k_profile_values_for_retrieval": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Top K Profile Values For Retrieval"
}
},
"type": "object",
"required": ["twb_file"],
"title": "Body_import_from_twb_api_v1_accounts__account_name__star_schema_data_source_import_from_twb_post"
},
"Body_login_access_token_api_v1_login_access_token_post": {
"properties": {
"grant_type": {
"anyOf": [
{ "type": "string", "pattern": "password" },
{ "type": "null" }
],
"title": "Grant Type"
},
"username": { "type": "string", "title": "Username" },
"password": { "type": "string", "title": "Password" },
"scope": { "type": "string", "title": "Scope", "default": "" },
"client_id": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Client Id"
},
"client_secret": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Client Secret"
}
},
"type": "object",
"required": ["username", "password"],
"title": "Body_login_access_token_api_v1_login_access_token_post"
},
"Body_login_session_api_v1_login_session_post": {
"properties": {
"grant_type": {
"anyOf": [
{ "type": "string", "pattern": "password" },
{ "type": "null" }
],
"title": "Grant Type"
},
"username": { "type": "string", "title": "Username" },
"password": { "type": "string", "title": "Password" },
"scope": { "type": "string", "title": "Scope", "default": "" },
"client_id": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Client Id"
},
"client_secret": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Client Secret"
}
},
"type": "object",
"required": ["username", "password"],
"title": "Body_login_session_api_v1_login_session_post"
},
"Body_merge_dimensions_api_v1_accounts__account_name__star_schema_data_source_dimensions__dimension_id__merge_patch": {
"properties": {
"dimension_update": {
"anyOf": [
{ "$ref": "#/components/schemas/DimensionUpdate" },
{ "type": "null" }
]
},
"ids_to_merge": {
"items": { "type": "string", "format": "uuid4" },
"type": "array",
"title": "Ids To Merge"
}
},
"type": "object",
"required": ["dimension_update", "ids_to_merge"],
"title": "Body_merge_dimensions_api_v1_accounts__account_name__star_schema_data_source_dimensions__dimension_id__merge_patch"
},
"Body_merge_metrics_api_v1_accounts__account_name__star_schema_data_source_metrics__metric_id__merge_patch": {
"properties": {
"metric_update": {
"anyOf": [
{ "$ref": "#/components/schemas/MetricUpdate" },
{ "type": "null" }
]
},
"ids_to_merge": {
"items": { "type": "string", "format": "uuid4" },
"type": "array",
"title": "Ids To Merge"
}
},
"type": "object",
"required": ["metric_update", "ids_to_merge"],
"title": "Body_merge_metrics_api_v1_accounts__account_name__star_schema_data_source_metrics__metric_id__merge_patch"
},
"Body_read_cell_data_api_v1_accounts__account_name__conversations__conversation_id__cells__cell_id__data_post": {
"properties": {
"filters": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/TableFilter" },
"type": "array"
},
{ "type": "null" }
],
"title": "Filters"
},
"sorts": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/Sort" },
"type": "array"
},
{ "type": "null" }
],
"title": "Sorts"
}
},
"type": "object",
"title": "Body_read_cell_data_api_v1_accounts__account_name__conversations__conversation_id__cells__cell_id__data_post"
},
"Body_read_connection_data_api_v1_accounts__account_name__connections__connection_id__data_get": {
"properties": {
"filters": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/TableFilter" },
"type": "array"
},
{ "type": "null" }
],
"title": "Filters"
},
"sorts": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/Sort" },
"type": "array"
},
{ "type": "null" }
],
"title": "Sorts"
}
},
"type": "object",
"title": "Body_read_connection_data_api_v1_accounts__account_name__connections__connection_id__data_get"
},
"Body_read_data_source_data_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__data_sources__data_source_id__data_post": {
"properties": {
"filters": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/TableFilter" },
"type": "array"
},
{ "type": "null" }
],
"title": "Filters"
},
"sorts": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/Sort" },
"type": "array"
},
{ "type": "null" }
],
"title": "Sorts"
}
},
"type": "object",
"title": "Body_read_data_source_data_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__data_sources__data_source_id__data_post"
},
"Body_read_star_schema_data_source_data_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__data_post": {
"properties": {
"filters": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/TableFilter" },
"type": "array"
},
{ "type": "null" }
],
"title": "Filters"
},
"sorts": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/Sort" },
"type": "array"
},
{ "type": "null" }
],
"title": "Sorts"
}
},
"type": "object",
"title": "Body_read_star_schema_data_source_data_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__data_post"
},
"Body_recover_password_api_v1_password_recovery__post": {
"properties": {
"email": { "type": "string", "format": "email", "title": "Email" }
},
"type": "object",
"required": ["email"],
"title": "Body_recover_password_api_v1_password_recovery__post"
},
"Body_reset_password_api_v1_reset_password__post": {
"properties": {
"token": { "type": "string", "title": "Token" },
"new_password": { "type": "string", "title": "New Password" }
},
"type": "object",
"required": ["token", "new_password"],
"title": "Body_reset_password_api_v1_reset_password__post"
},
"Body_run_eval_on_reference_conversations_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__eval_reference_conversations_post": {
"properties": {
"eval_filter": { "$ref": "#/components/schemas/EvalFilter" },
"moonlight_run_params": {
"$ref": "#/components/schemas/MoonlightRunParams"
}
},
"type": "object",
"required": ["eval_filter", "moonlight_run_params"],
"title": "Body_run_eval_on_reference_conversations_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__eval_reference_conversations_post"
},
"Body_run_regression_test_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__regression_test_post": {
"properties": {
"moonlight_run_params": {
"$ref": "#/components/schemas/MoonlightRunParams"
},
"m2m_creds": {
"anyOf": [
{ "$ref": "#/components/schemas/M2MTokenCreds" },
{ "type": "null" }
]
}
},
"type": "object",
"required": ["moonlight_run_params"],
"title": "Body_run_regression_test_api_v1_accounts__account_name__star_schema_data_source__star_schema_data_source_id__regression_test_post"
},
"Body_update_user_me_api_v1_users_me_put": {
"properties": {
"password": {
"anyOf": [
{ "type": "string", "format": "password", "writeOnly": true },
{ "type": "null" }
],
"title": "Password"
},
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"email": {
"anyOf": [
{ "type": "string", "format": "email" },
{ "type": "null" }
],
"title": "Email"
}
},
"type": "object",
"title": "Body_update_user_me_api_v1_users_me_put"
},
"Body_upload_dataset_api_v1_accounts__account_name__datasets_upload_post": {
"properties": {
"dataset_in": { "$ref": "#/components/schemas/BumblebeeDataset" },
"options": {
"$ref": "#/components/schemas/BumblebeeDatasetUploadOptions"
}
},
"type": "object",
"required": ["dataset_in", "options"],
"title": "Body_upload_dataset_api_v1_accounts__account_name__datasets_upload_post"
},
"Body_write_csv_to_connection_api_v1_accounts__account_name__connections_csv__post": {
"properties": {
"connection_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Connection Id"
},
"file": { "type": "string", "format": "binary", "title": "File" }
},
"type": "object",
"required": ["file"],
"title": "Body_write_csv_to_connection_api_v1_accounts__account_name__connections_csv__post"
},
"BoolColumnStatistics": {
"properties": {
"name": { "type": "string", "title": "Name" },
"type": { "type": "string", "title": "Type" },
"count": { "type": "integer", "title": "Count" },
"num_nulls": { "type": "integer", "title": "Num Nulls" },
"num_distinct_values": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Num Distinct Values"
},
"stat_type": {
"type": "string",
"enum": ["bool"],
"const": "bool",
"title": "Stat Type",
"default": "bool"
},
"most_common_values": {
"items": { "$ref": "#/components/schemas/ColumnValue" },
"type": "array",
"title": "Most Common Values"
}
},
"type": "object",
"required": [
"name",
"type",
"count",
"num_nulls",
"most_common_values"
],
"title": "BoolColumnStatistics",
"description": "Statistics for boolean-type columns."
},
"BrowserLog": {
"properties": {
"current_url": { "type": "string", "title": "Current Url" },
"timestamp": { "type": "integer", "title": "Timestamp" },
"level": { "$ref": "#/components/schemas/LogLevel" },
"message": { "type": "string", "title": "Message" },
"data": {
"anyOf": [{ "type": "object" }, { "type": "null" }],
"title": "Data"
}
},
"type": "object",
"required": ["current_url", "timestamp", "level", "message", "data"],
"title": "BrowserLog",
"description": "An object sent from the client so we can get client information logged on the server."
},
"BumblebeeCell": {
"properties": {
"creator_id": {
"type": "string",
"format": "uuid4",
"title": "Creator Id"
},
"permissions": {
"allOf": [{ "$ref": "#/components/schemas/Permissions" }],
"default": { "read": false, "write": false }
},
"sync_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Sync Id"
},
"conversation_id": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
},
"user_question": { "type": "string", "title": "User Question" },
"updated_question": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Updated Question"
},
"question_variants": {
"items": { "type": "string" },
"type": "array",
"title": "Question Variants",
"default": []
},
"index": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Index"
},
"sql": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Sql"
},
"data_summary": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Data Summary"
},
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"bb_model": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Bb Model"
},
"semantic_query_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Semantic Query Id"
},
"ssds_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Ssds Id"
},
"explanation": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Explanation"
},
"is_holdout": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Holdout"
},
"has_feedback": {
"type": "boolean",
"title": "Has Feedback",
"default": false
},
"is_dm_sensitive": {
"type": "boolean",
"title": "Is Dm Sensitive",
"default": false
},
"is_user_sensitive": {
"type": "boolean",
"title": "Is User Sensitive",
"default": false
},
"copied_from": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Copied From"
},
"is_suggested": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Suggested",
"default": false
},
"moonlight_predicted_input_type": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Moonlight Predicted Input Type"
},
"moonlight_prompt": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Moonlight Prompt"
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"account_id": {
"type": "string",
"format": "uuid4",
"title": "Account Id"
},
"is_stale": { "type": "boolean", "title": "Is Stale" },
"state": {
"anyOf": [
{ "$ref": "#/components/schemas/CellState" },
{ "type": "null" }
]
},
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
},
"creator": {
"anyOf": [
{ "$ref": "#/components/schemas/UserBasic" },
{ "type": "null" }
]
},
"semantic_layer_view": {
"anyOf": [
{ "$ref": "#/components/schemas/SemanticLayerView" },
{ "type": "null" }
]
},
"chart_config": {
"anyOf": [
{ "$ref": "#/components/schemas/ChartConfig" },
{ "type": "null" }
]
},
"tasks": {
"items": { "$ref": "#/components/schemas/Task" },
"type": "array",
"title": "Tasks",
"default": []
},
"tags": {
"items": { "$ref": "#/components/schemas/TagAssociation" },
"type": "array",
"title": "Tags",
"default": []
},
"feedback": {
"anyOf": [
{ "$ref": "#/components/schemas/CellFeedback" },
{ "type": "null" }
]
},
"used_datasources": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/BumblebeeCellDataSource"
},
"type": "array"
},
{ "type": "null" }
],
"title": "Used Datasources"
},
"moonlight_response": {
"anyOf": [
{ "$ref": "#/components/schemas/MoonlightStreamedOutput" },
{ "type": "null" }
]
},
"is_sensitive": {
"type": "boolean",
"title": "Is Sensitive",
"default": false
}
},
"type": "object",
"required": [
"creator_id",
"conversation_id",
"user_question",
"updated_question",
"id",
"account_id",
"is_stale",
"created_at",
"updated_at"
],
"title": "BumblebeeCell",
"description": "Bumblebee Cell Schema."
},
"BumblebeeCellAPICreate": {
"properties": {
"user_question": { "type": "string", "title": "User Question" },
"updated_question": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Updated Question"
},
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"ssds_id": { "type": "string", "format": "uuid4", "title": "Ssds Id" }
},
"type": "object",
"required": ["user_question", "ssds_id"],
"title": "BumblebeeCellAPICreate",
"description": "Create Bumblebee Cell Schema."
},
"BumblebeeCellAPIUpdate": {
"properties": {
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"user_question": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "User Question"
},
"updated_question": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Updated Question"
},
"semantic_query_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Semantic Query Id"
},
"state": {
"anyOf": [
{ "$ref": "#/components/schemas/CellState" },
{ "type": "null" }
]
}
},
"type": "object",
"title": "BumblebeeCellAPIUpdate",
"description": "Update Bumblebee Cell Schema."
},
"BumblebeeCellBasic": {
"properties": {
"creator_id": {
"type": "string",
"format": "uuid4",
"title": "Creator Id"
},
"permissions": {
"allOf": [{ "$ref": "#/components/schemas/Permissions" }],
"default": { "read": false, "write": false }
},
"sync_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Sync Id"
},
"conversation_id": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
},
"user_question": { "type": "string", "title": "User Question" },
"updated_question": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Updated Question"
},
"question_variants": {
"items": { "type": "string" },
"type": "array",
"title": "Question Variants",
"default": []
},
"index": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Index"
},
"sql": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Sql"
},
"data_summary": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Data Summary"
},
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"bb_model": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Bb Model"
},
"semantic_query_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Semantic Query Id"
},
"ssds_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Ssds Id"
},
"explanation": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Explanation"
},
"is_holdout": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Holdout"
},
"has_feedback": {
"type": "boolean",
"title": "Has Feedback",
"default": false
},
"is_dm_sensitive": {
"type": "boolean",
"title": "Is Dm Sensitive",
"default": false
},
"is_user_sensitive": {
"type": "boolean",
"title": "Is User Sensitive",
"default": false
},
"copied_from": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Copied From"
},
"is_suggested": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Suggested",
"default": false
},
"moonlight_predicted_input_type": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Moonlight Predicted Input Type"
},
"moonlight_prompt": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Moonlight Prompt"
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"account_id": {
"type": "string",
"format": "uuid4",
"title": "Account Id"
},
"is_stale": { "type": "boolean", "title": "Is Stale" },
"state": {
"anyOf": [
{ "$ref": "#/components/schemas/CellState" },
{ "type": "null" }
]
},
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
},
"creator": {
"anyOf": [
{ "$ref": "#/components/schemas/UserBasic" },
{ "type": "null" }
]
},
"tags": {
"items": { "$ref": "#/components/schemas/TagAssociation" },
"type": "array",
"title": "Tags",
"default": []
},
"feedback": {
"anyOf": [
{ "$ref": "#/components/schemas/CellFeedback" },
{ "type": "null" }
]
},
"moonlight_response": {
"anyOf": [
{ "$ref": "#/components/schemas/MoonlightStreamedOutput" },
{ "type": "null" }
]
},
"is_sensitive": {
"type": "boolean",
"title": "Is Sensitive",
"default": false
}
},
"type": "object",
"required": [
"creator_id",
"conversation_id",
"user_question",
"updated_question",
"id",
"account_id",
"is_stale",
"created_at",
"updated_at"
],
"title": "BumblebeeCellBasic",
"description": "Bumblebee Cell Schema."
},
"BumblebeeCellDataSource": {
"properties": {
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"name": { "type": "string", "title": "Name" }
},
"type": "object",
"required": ["id", "name"],
"title": "BumblebeeCellDataSource",
"description": "A datasource used by the bumblebeecell."
},
"BumblebeeCellFilterOption": {
"properties": {
"metric_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Metric Id"
},
"dimension_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Dimension Id"
},
"filter_type": { "$ref": "#/components/schemas/FilterType" },
"display_name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Display Name"
},
"name": { "type": "string", "title": "Name" },
"category": { "$ref": "#/components/schemas/FilterCategory" },
"valid_operators": {
"items": { "$ref": "#/components/schemas/FilterOperator" },
"type": "array",
"title": "Valid Operators"
},
"expression": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Expression"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"state": {
"anyOf": [
{ "$ref": "#/components/schemas/PublishState" },
{ "type": "null" }
]
}
},
"type": "object",
"required": [
"filter_type",
"display_name",
"name",
"category",
"valid_operators"
],
"title": "BumblebeeCellFilterOption",
"description": "Filter Option."
},
"BumblebeeCellFilterOptionWithGroup": {
"properties": {
"metric_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Metric Id"
},
"dimension_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Dimension Id"
},
"filter_type": { "$ref": "#/components/schemas/FilterType" },
"display_name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Display Name"
},
"name": { "type": "string", "title": "Name" },
"category": { "$ref": "#/components/schemas/FilterCategory" },
"valid_operators": {
"items": { "$ref": "#/components/schemas/FilterOperator" },
"type": "array",
"title": "Valid Operators"
},
"expression": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Expression"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"state": {
"anyOf": [
{ "$ref": "#/components/schemas/PublishState" },
{ "type": "null" }
]
},
"group": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/BumblebeeCellFilterOption"
},
"type": "array"
},
{ "type": "null" }
],
"title": "Group"
}
},
"type": "object",
"required": [
"filter_type",
"display_name",
"name",
"category",
"valid_operators"
],
"title": "BumblebeeCellFilterOptionWithGroup",
"description": "Filter Option with Group."
},
"BumblebeeCellRunParams": {
"properties": {
"bb_model": {
"type": "string",
"title": "Bb Model",
"default": "gpt-4o-2024-08-06"
},
"overwrite_cache": {
"type": "boolean",
"title": "Overwrite Cache",
"default": false
},
"skip_query_execution": {
"type": "boolean",
"title": "Skip Query Execution",
"default": false
},
"copy_from_examples": {
"type": "boolean",
"title": "Copy From Examples",
"default": true
},
"max_historical_cells": {
"type": "integer",
"title": "Max Historical Cells",
"default": 0
}
},
"type": "object",
"title": "BumblebeeCellRunParams",
"description": "Bumblebee Celll Run parameters args."
},
"BumblebeeCellUpdate": {
"properties": {
"sync_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Sync Id"
},
"conversation_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Conversation Id"
},
"user_question": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "User Question"
},
"updated_question": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Updated Question"
},
"question_variants": {
"items": { "type": "string" },
"type": "array",
"title": "Question Variants",
"default": []
},
"index": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Index"
},
"sql": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Sql"
},
"data_summary": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Data Summary"
},
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"bb_model": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Bb Model"
},
"semantic_query_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Semantic Query Id"
},
"ssds_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Ssds Id"
},
"explanation": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Explanation"
},
"is_holdout": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Holdout"
},
"has_feedback": {
"type": "boolean",
"title": "Has Feedback",
"default": false
},
"is_dm_sensitive": {
"type": "boolean",
"title": "Is Dm Sensitive",
"default": false
},
"is_user_sensitive": {
"type": "boolean",
"title": "Is User Sensitive",
"default": false
},
"copied_from": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Copied From"
},
"is_suggested": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Suggested",
"default": false
},
"moonlight_predicted_input_type": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Moonlight Predicted Input Type"
},
"moonlight_prompt": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Moonlight Prompt"
},
"is_stale": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Stale"
},
"question_openai_embedding": {
"anyOf": [
{ "items": { "type": "number" }, "type": "array" },
{ "type": "null" }
],
"title": "Question Openai Embedding"
},
"retrieved_metrics": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/MetricView" },
"type": "array"
},
{ "type": "null" }
],
"title": "Retrieved Metrics"
},
"retrieved_dimensions": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/DimensionView" },
"type": "array"
},
{ "type": "null" }
],
"title": "Retrieved Dimensions"
},
"state": {
"anyOf": [
{ "$ref": "#/components/schemas/CellState" },
{ "type": "null" }
]
},
"moonlight_response": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Moonlight Response"
}
},
"type": "object",
"title": "BumblebeeCellUpdate",
"description": "Update Bumblebee Cell Schema."
},
"BumblebeeDataset": {
"properties": {
"ssds": {
"$ref": "#/components/schemas/ZenStarSchemaDataSourceBase"
},
"named_filters": {
"items": { "$ref": "#/components/schemas/NamedFilterBase" },
"type": "array",
"title": "Named Filters"
},
"connection": { "$ref": "#/components/schemas/ConnectionLookup" },
"semantic_queries": {
"items": { "$ref": "#/components/schemas/SemanticQuery" },
"type": "array",
"title": "Semantic Queries"
},
"conversations": {
"items": { "$ref": "#/components/schemas/ConversationBasic" },
"type": "array",
"title": "Conversations"
},
"cells": {
"items": { "$ref": "#/components/schemas/BumblebeeCellBasic" },
"type": "array",
"title": "Cells"
},
"feedback": {
"items": { "$ref": "#/components/schemas/Feedback" },
"type": "array",
"title": "Feedback"
}
},
"type": "object",
"required": [
"ssds",
"named_filters",
"connection",
"semantic_queries",
"conversations",
"cells",
"feedback"
],
"title": "BumblebeeDataset",
"description": "BumblebeeDataset class."
},
"BumblebeeDatasetUploadOptions": {
"properties": {
"existing_dataset": {
"type": "string",
"enum": ["clear", "ignore", "reuse"],
"title": "Existing Dataset",
"default": "ignore"
},
"skip_validation_check": {
"type": "boolean",
"title": "Skip Validation Check",
"default": false
},
"enrich_params": {
"allOf": [
{ "$ref": "#/components/schemas/StarSchemaDataSourceEnrichment" }
],
"default": {
"enable": true,
"update_index": true,
"update_profiles": true,
"update_expr_types": true,
"update_display_types": true
}
},
"allow_conflicting_feedback": {
"type": "boolean",
"title": "Allow Conflicting Feedback",
"default": false
},
"clear_named_filters": {
"type": "boolean",
"title": "Clear Named Filters",
"default": false
},
"clear_cells": {
"type": "boolean",
"title": "Clear Cells",
"default": false
},
"mark_as_demo": {
"type": "boolean",
"title": "Mark As Demo",
"default": false
},
"m2m_creds": {
"anyOf": [
{ "$ref": "#/components/schemas/M2MTokenCreds" },
{ "type": "null" }
]
}
},
"type": "object",
"title": "BumblebeeDatasetUploadOptions",
"description": "Options for BumblebeeDataset Upload."
},
"CellFeedback": {
"properties": {
"cell_id": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
},
"user_feedback": {
"type": "string",
"title": "User Feedback",
"default": ""
},
"is_verified": { "type": "boolean", "title": "Is Verified" },
"is_bad_response": { "type": "boolean", "title": "Is Bad Response" },
"is_invalid_query": {
"type": "boolean",
"title": "Is Invalid Query",
"default": false
},
"is_empty_query": {
"type": "boolean",
"title": "Is Empty Query",
"default": false
}
},
"type": "object",
"required": ["cell_id", "is_verified", "is_bad_response"],
"title": "CellFeedback",
"description": "Cell Feedback Schema."
},
"CellOrderBy": {
"type": "string",
"enum": [
"id",
"created_at",
"creator_id",
"updated_at",
"user_question"
],
"title": "CellOrderBy",
"description": "Sortable Columns in BumblebeeCell"
},
"CellRunEvent": {
"properties": {
"run_id": { "type": "string", "format": "uuid4", "title": "Run Id" },
"account_id": {
"type": "string",
"format": "uuid4",
"title": "Account Id"
},
"ssds_id": {
"type": "string",
"format": "uuid4",
"title": "Ssds Id"
},
"cell_id": {
"type": "string",
"format": "uuid4",
"title": "Cell Id"
},
"conversation_id": {
"type": "string",
"format": "uuid4",
"title": "Conversation Id"
},
"connection_id": {
"type": "string",
"format": "uuid4",
"title": "Connection Id"
},
"user_id": {
"type": "string",
"format": "uuid4",
"title": "User Id"
},
"task_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Task Id"
},
"question": { "type": "string", "title": "Question" },
"crud_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Crud Time"
},
"get_bumblebee_data_source_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Get Bumblebee Data Source Time"
},
"query_client_init_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Query Client Init Time"
},
"to_snowflake_data_source_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "To Snowflake Data Source Time"
},
"get_cell_history_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Get Cell History Time"
},
"get_unified_input_table_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Get Unified Input Table Time"
},
"retrieval_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Retrieval Time"
},
"pre_query_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Pre Query Time"
},
"get_query_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Get Query Time"
},
"query_execution_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Query Execution Time"
},
"len_retrieved_columns": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Len Retrieved Columns"
},
"len_columns": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Len Columns"
},
"len_retrieved_dimensions": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Len Retrieved Dimensions"
},
"len_dimensions": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Len Dimensions"
},
"len_retrieved_metrics": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Len Retrieved Metrics"
},
"len_metrics": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Len Metrics"
},
"num_get_query_model_calls": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Num Get Query Model Calls"
},
"moonlight_rephrase_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Moonlight Rephrase Time"
},
"moonlight_retrieval_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Moonlight Retrieval Time"
},
"moonlight_routing_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Moonlight Routing Time"
},
"moonlight_pass_to_bb_time": {
"anyOf": [{ "type": "number" }, { "type": "null" }],
"title": "Moonlight Pass To Bb Time"
},
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
}
},
"type": "object",
"required": [
"run_id",
"account_id",
"ssds_id",
"cell_id",
"conversation_id",
"connection_id",
"user_id",
"question",
"created_at",
"updated_at"
],
"title": "CellRunEvent",
"description": "Cell Run Event Schema."
},
"CellState": {
"type": "string",
"enum": ["CREATED", "FAILED", "RUNNING", "SUCCESS", "LOCKED"],
"title": "CellState",
"description": "Cell states."
},
"Chart": {
"properties": {
"data": { "$ref": "#/components/schemas/ChartSeries" }
},
"type": "object",
"required": ["data"],
"title": "Chart",
"description": "Properties of Chart."
},
"ChartConfig": {
"properties": {
"type": { "$ref": "#/components/schemas/ChartType" },
"flip_axis": { "type": "boolean", "title": "Flip Axis" },
"semantic_query_id": {
"type": "string",
"format": "uuid4",
"title": "Semantic Query Id"
},
"country_name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Country Name"
},
"limit": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Limit"
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"selected": {
"items": { "$ref": "#/components/schemas/ChartConfigDMM" },
"type": "array",
"title": "Selected"
}
},
"type": "object",
"required": [
"type",
"flip_axis",
"semantic_query_id",
"id",
"selected"
],
"title": "ChartConfig",
"description": "Properties to receive on Chart Config read."
},
"ChartConfigAPIUpdate": {
"properties": {
"type": {
"anyOf": [
{ "$ref": "#/components/schemas/ChartType" },
{ "type": "null" }
]
},
"flip_axis": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Flip Axis"
},
"semantic_query_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Semantic Query Id"
},
"country_name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Country Name"
},
"limit": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Limit"
},
"selected": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/ChartConfigDMMSelect"
},
"type": "array"
},
{ "type": "null" }
],
"title": "Selected"
}
},
"type": "object",
"title": "ChartConfigAPIUpdate",
"description": "Properties to receive on Chart Config update."
},
"ChartConfigDMM": {
"properties": {
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"chart_config_id": {
"type": "string",
"format": "uuid4",
"title": "Chart Config Id"
},
"axis": { "$ref": "#/components/schemas/Axis" },
"dimension": {
"anyOf": [
{ "$ref": "#/components/schemas/DimensionView" },
{ "type": "null" }
]
},
"metric": {
"anyOf": [
{ "$ref": "#/components/schemas/MetricView" },
{ "type": "null" }
]
},
"type": { "$ref": "#/components/schemas/ChartSelectDMMType" }
},
"type": "object",
"required": ["id", "chart_config_id", "axis", "type"],
"title": "ChartConfigDMM",
"description": "Properties for Chart Config DMM."
},
"ChartConfigDMMSelect": {
"properties": {
"dm_id": { "type": "string", "format": "uuid4", "title": "Dm Id" },
"axis": { "$ref": "#/components/schemas/Axis" }
},
"type": "object",
"required": ["dm_id", "axis"],
"title": "ChartConfigDMMSelect",
"description": "Properties to receive on Chart Config DMM select."
},
"ChartSelectDMMType": {
"type": "string",
"enum": ["metric", "dimension"],
"title": "ChartSelectDMMType",
"description": "Enumerates the possible DMM types for a chart select."
},
"ChartSeries": {
"properties": {
"type": { "$ref": "#/components/schemas/ChartType" },
"source": {
"items": { "items": {}, "type": "array" },
"type": "array",
"title": "Source"
},
"unique_group_values": {
"items": {},
"type": "array",
"title": "Unique Group Values"
}
},
"type": "object",
"required": ["type", "source", "unique_group_values"],
"title": "ChartSeries",
"description": "Properties of Chart Series.\n\nFields:\n - type: ChartType, non-Empty\n - source: List of lists describing the chart data. First row is the column names\n and the rest are the data.\n - unique_group_values: List of unique group values if a group column is selected."
},
"ChartType": {
"type": "string",
"enum": ["empty", "bar", "line", "scatter", "geo", "big_number"],
"title": "ChartType",
"description": "Enumerates the possible chart types."
},
"ChatAPICreate": {
"properties": {
"chat_name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Chat Name",
"description": "The name of the chat. If one is not provided, the chat is auto-named based on the first message."
},
"slack_id": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Slack Id",
"description": "The ID of the Slack conversation associated with the chat."
}
},
"type": "object",
"title": "ChatAPICreate",
"description": "Payload for creating a chat.\n\nUser can optionally name the chat if desired."
},
"ChatAPIResponse": {
"properties": {
"id": {
"type": "string",
"format": "uuid4",
"title": "Id",
"description": "The ID of the chat."
},
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name",
"description": "The name of the chat."
},
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At",
"description": "The time the chat was created."
},
"last_modified_at": {
"type": "string",
"format": "date-time",
"title": "Last Modified At",
"description": "The time the chat was last modified. This includes adding messages."
},
"creator": {
"allOf": [{ "$ref": "#/components/schemas/UserBasicAPIResponse" }],
"description": "The user who created the chat."
}
},
"type": "object",
"required": ["id", "name", "created_at", "last_modified_at", "creator"],
"title": "ChatAPIResponse",
"description": "Response object containing information about a single chat."
},
"ChatAPIResponsePage": {
"properties": {
"data": {
"items": { "$ref": "#/components/schemas/ChatAPIResponse" },
"type": "array",
"title": "Data",
"description": "The list of `ChatAPIResponse` objects."
},
"total": {
"type": "integer",
"title": "Total",
"description": "The total number of chats. This may be greater than the number of chats returned."
}
},
"type": "object",
"required": ["data", "total"],
"title": "ChatAPIResponsePage",
"description": "A list of chats used in a paginated response."
},
"ChatAPIUpdate": {
"properties": {
"chat_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"title": "Chat Name",
"description": "The name of the chat. It must be at least 1 character long."
}
},
"type": "object",
"required": ["chat_name"],
"title": "ChatAPIUpdate",
"description": "Payload for updating a chat with the API"
},
"ChatMessageModelParameters": {
"properties": {
"model": { "type": "string", "title": "Model" },
"max_tokens": { "type": "integer", "title": "Max Tokens" },
"temperature": { "type": "number", "title": "Temperature" },
"seed": { "type": "integer", "title": "Seed" },
"response_format": { "type": "string", "title": "Response Format" },
"tools": {
"items": { "type": "object" },
"type": "array",
"title": "Tools"
}
},
"type": "object",
"required": [
"model",
"max_tokens",
"temperature",
"seed",
"response_format",
"tools"
],
"title": "ChatMessageModelParameters",
"description": "Model Parameters for Chat Message Promptlogs."
},
"ChatMessagePromptlogInDB": {
"properties": {
"message_id": {
"type": "string",
"format": "uuid4",
"title": "Message Id"
},
"agent_name": { "type": "string", "title": "Agent Name" },
"messages": {
"items": { "type": "object" },
"type": "array",
"title": "Messages"
},
"model_params": {
"anyOf": [
{ "$ref": "#/components/schemas/ChatMessageModelParameters" },
{ "type": "null" }
]
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
}
},
"type": "object",
"required": [
"message_id",
"agent_name",
"messages",
"model_params",
"id",
"created_at",
"updated_at"
],
"title": "ChatMessagePromptlogInDB",
"description": "Class to map Pydantic ChatMessagePromptlog to ORM."
},
"ChatStep": {
"properties": {
"question": { "type": "string", "title": "Question" },
"explanation": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Explanation"
},
"query": {
"anyOf": [
{ "$ref": "#/components/schemas/SemanticQuery" },
{ "type": "null" }
]
}
},
"type": "object",
"required": ["question"],
"title": "ChatStep",
"description": "Chat Step."
},
"ChatsFilter": {
"type": "string",
"enum": ["is_pinned", "is_by_user", "is_eval", "all"],
"title": "ChatsFilter",
"description": "Filter chats by."
},
"ChatsSort": {
"type": "string",
"enum": ["created_at", "last_modified_at", "creator_id", "name"],
"title": "ChatsSort",
"description": "Sort chats by."
},
"ClientSafeAccountSettings": {
"properties": {
"test_setting": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "test_setting",
"description": "Basic test setting.",
"value_object": { "value": true },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": true
}
},
"test_int_setting": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "test_int_setting",
"description": "Basic test int setting.",
"value_object": { "value": 0 },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": 0
}
},
"setting_admin_and_superuser_can_edit": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "setting_admin_and_superuser_can_edit",
"description": "Setting that the admin and the superuser can edit.",
"value_object": { "value": true },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": true
}
},
"setting_admin_can_edit": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "setting_admin_can_edit",
"description": "Setting that the admin can edit.",
"value_object": { "value": true },
"is_superuser_editable": false,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": true
}
},
"setting_superuser_can_edit": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "setting_superuser_can_edit",
"description": "Setting that the superuser can edit.",
"value_object": { "value": true },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": true
}
},
"setting_not_sent_to_client": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "setting_not_sent_to_client",
"description": "Setting that is not sent to the client.",
"value_object": { "value": true },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": false,
"value": true
}
},
"show_data_dev_tools": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "show_data_dev_tools",
"description": "Show react query dev tools within the app",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"enable_multiview_support": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "enable_multiview_support",
"description": "Enable multiview support",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"enable_copy_from_example": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "enable_copy_from_example",
"description": "Enable copy from example",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"show_charts_v2": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "show_charts_v2",
"description": "Show Cell Charts V2",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"fuzzy_filter_cardinality_threshold": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "fuzzy_filter_cardinality_threshold",
"description": "Cardinality threshold to use fuzzy match. (Defaults to 100, -1 means no fuzzy match)",
"value_object": { "value": 100 },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": 100
}
},
"dataset_update_existing_dimensions_metrics": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_update_existing_dimensions_metrics",
"description": "Update existing dimensions and metrics when creating/updating dataset.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"dataset_include_metrics": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_include_metrics",
"description": "Include metrics when creating/updating dataset.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"dataset_initial_dimension_metric_state": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_initial_dimension_metric_state",
"description": "Initial state of dimensions and metrics.",
"value_object": { "value": "Verified" },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": "Verified"
}
},
"dataset_num_rows_to_profile": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_num_rows_to_profile",
"description": "Number of rows to profile (Defaults to -1, -1 means no account setting, read from system setting)",
"value_object": { "value": -1 },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": -1
}
},
"dataset_top_k_profile_values_for_retrieval": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "dataset_top_k_profile_values_for_retrieval",
"description": "Top K profile values for retrieval (Defaults to -1, -1 means no account setting, read from system setting)",
"value_object": { "value": -1 },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": -1
}
},
"is_chats_default": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "is_chats_default",
"description": "Whether chats is the default experience in-app.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": false
}
},
"is_widget_default": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "is_widget_default",
"description": "Whether the new widget UI is the default experience in-app.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": false
}
},
"show_widget_settings": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "show_widget_settings",
"description": "Whether to show the widget settings.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": true,
"is_value_sent_to_client": true,
"value": false
}
},
"show_streamlit_button": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "show_streamlit_button",
"description": "Whether to show the button that links to the streamlit demos of new agents.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"use_onboarding_agent": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "use_onboarding_agent",
"description": "Whether to use onboarding agent.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"use_predictive_model_agent": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "use_predictive_model_agent",
"description": "Whether to use predictive model agent.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"add_dms_from_reports": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "add_dms_from_reports",
"description": "Whether to extract DMs from reports",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"use_knowledge_sql": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "use_knowledge_sql",
"description": "Whether to use knowledge sql.",
"value_object": { "value": false },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": false
}
},
"grouping_strategy": {
"allOf": [
{
"$ref": "#/components/schemas/ClientSetting_Union_bool__int__str__"
}
],
"default": {
"name": "grouping_strategy",
"description": "Strategy to use to group dimensions and metrics.",
"value_object": { "value": "DM_GROUPING" },
"is_superuser_editable": true,
"is_admin_editable": false,
"is_value_sent_to_client": true,
"value": "DM_GROUPING"
}
}
},
"type": "object",
"title": "ClientSafeAccountSettings",
"description": "Client-safe account settings."
},
"ClientSetting_Union_bool__int__str__": {
"properties": {
"name": { "type": "string", "title": "Name" },
"description": { "type": "string", "title": "Description" },
"value_object": {
"$ref": "#/components/schemas/SettingValue_Union_bool__int__str__"
},
"is_superuser_editable": {
"type": "boolean",
"title": "Is Superuser Editable"
},
"is_admin_editable": {
"type": "boolean",
"title": "Is Admin Editable"
},
"is_value_sent_to_client": {
"type": "boolean",
"title": "Is Value Sent To Client",
"default": true
},
"value": {
"anyOf": [
{ "type": "boolean" },
{ "type": "integer" },
{ "type": "string" },
{ "type": "null" }
],
"title": "Value"
},
"admin_value": {
"anyOf": [
{ "type": "boolean" },
{ "type": "integer" },
{ "type": "string" },
{ "type": "null" }
],
"title": "Admin Value"
},
"superuser_value": {
"anyOf": [
{ "type": "boolean" },
{ "type": "integer" },
{ "type": "string" },
{ "type": "null" }
],
"title": "Superuser Value"
},
"default_value": {
"anyOf": [
{ "type": "boolean" },
{ "type": "integer" },
{ "type": "string" },
{ "type": "null" }
],
"title": "Default Value"
},
"is_test": { "type": "boolean", "title": "Is Test", "default": false }
},
"type": "object",
"required": [
"name",
"description",
"value_object",
"is_superuser_editable",
"is_admin_editable",
"value"
],
"title": "ClientSetting[Union[bool, int, str]]"
},
"ColumnMetadata": {
"properties": {
"name": { "type": "string", "title": "Name" },
"display_name": { "type": "string", "title": "Display Name" },
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"display_type": {
"anyOf": [
{ "$ref": "#/components/schemas/DisplayType" },
{ "type": "null" }
]
},
"data_type_category": {
"anyOf": [
{ "$ref": "#/components/schemas/FilterCategory" },
{ "type": "null" }
]
},
"is_nullable": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Nullable"
},
"column_default": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Column Default"
},
"dataset_id": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Dataset Id"
},
"cell_id": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Cell Id"
}
},
"type": "object",
"required": ["name", "display_name"],
"title": "ColumnMetadata",
"description": "Column metadata."
},
"ColumnMetadataV2": {
"properties": {
"dm_name": { "type": "string", "title": "Dm Name" },
"display_name": { "type": "string", "title": "Display Name" },
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"display_type": {
"anyOf": [
{ "$ref": "#/components/schemas/DisplayTypeV2" },
{ "type": "null" }
]
}
},
"type": "object",
"required": ["dm_name", "display_name", "description", "display_type"],
"title": "ColumnMetadataV2",
"description": "Metadata for a column in a table.\n\nCAUTION: This definition is in flux. It may change.\n\nAttributes:\n dm_name: The name of the column matching a dimension or metric.\n display_name: The display name of the column.\n description: The description of the column.\n display_type: The display type of the column."
},
"ColumnValue": {
"properties": {
"value": {
"anyOf": [
{ "type": "number" },
{ "type": "integer" },
{ "type": "boolean" },
{ "type": "string" },
{ "type": "string", "format": "date-time" },
{ "items": {}, "type": "array" },
{ "type": "null" }
],
"title": "Value"
},
"count": { "type": "integer", "title": "Count" }
},
"type": "object",
"required": ["count"],
"title": "ColumnValue",
"description": "Column value."
},
"Combination": {
"type": "string",
"enum": ["ALL", "ANY"],
"title": "Combination",
"description": "Combination Strategies for Filter Conditions."
},
"Connection": {
"properties": {
"name": { "type": "string", "title": "Name" },
"account_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Account Id"
},
"is_demo": { "type": "boolean", "title": "Is Demo" },
"is_draft": {
"type": "boolean",
"title": "Is Draft",
"default": false
},
"status": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Status"
},
"status_at": {
"anyOf": [
{ "type": "string", "format": "date-time" },
{ "type": "null" }
],
"title": "Status At"
},
"type": {
"anyOf": [
{ "$ref": "#/components/schemas/ConnectionPolyType" },
{ "type": "null" }
]
},
"max_tables": {
"type": "integer",
"exclusiveMinimum": 0.0,
"title": "Max Tables",
"default": 8000
},
"warehouse_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Warehouse Access"
},
"result_cache_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Result Cache Access"
},
"error_msg": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Error Msg"
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
}
},
"type": "object",
"required": ["name", "is_demo", "id", "created_at", "updated_at"],
"title": "Connection",
"description": "Additional properties to return via API."
},
"ConnectionLookup": {
"properties": {
"snowflake": {
"anyOf": [
{ "$ref": "#/components/schemas/SnowflakeConnectionLookup" },
{ "type": "null" }
]
},
"databricks": {
"anyOf": [
{ "$ref": "#/components/schemas/DatabricksConnectionLookup" },
{ "type": "null" }
]
},
"bigquery": {
"anyOf": [
{ "$ref": "#/components/schemas/BigQueryConnectionLookup" },
{ "type": "null" }
]
},
"postgres": {
"anyOf": [
{ "$ref": "#/components/schemas/PostgresConnectionLookup" },
{ "type": "null" }
]
},
"teradata": {
"anyOf": [
{ "$ref": "#/components/schemas/TeradataConnectionLookup" },
{ "type": "null" }
]
},
"redshift": {
"anyOf": [
{ "$ref": "#/components/schemas/RedshiftConnectionLookup" },
{ "type": "null" }
]
},
"ns_database": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Ns Database"
},
"ns_schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Ns Schema"
}
},
"type": "object",
"required": ["ns_database", "ns_schema"],
"title": "ConnectionLookup",
"description": "Connection Type to look up."
},
"ConnectionPage": {
"properties": {
"connections": {
"items": { "$ref": "#/components/schemas/Connection" },
"type": "array",
"title": "Connections"
},
"total": { "type": "integer", "title": "Total" }
},
"type": "object",
"required": ["connections", "total"],
"title": "ConnectionPage",
"description": "Paginated Connection response."
},
"ConnectionPolyType": {
"type": "string",
"enum": [
"bigquery",
"databricks",
"connection",
"postgres",
"redshift",
"s3",
"snowflake",
"teradata"
],
"title": "ConnectionPolyType",
"description": "Enumerates the possible connection types."
},
"ConnectionStatus": {
"type": "string",
"enum": ["success", "failure"],
"title": "ConnectionStatus",
"description": "Enumerates the possible connection statuses."
},
"ConversationAPICreate": {
"properties": {
"is_pinned": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Pinned"
},
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"is_moonlight": {
"type": "boolean",
"title": "Is Moonlight",
"default": false
},
"is_training": {
"type": "boolean",
"title": "Is Training",
"default": false
},
"is_eval_conversation": {
"type": "boolean",
"title": "Is Eval Conversation",
"default": false
},
"first_cell_question": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "First Cell Question"
},
"first_cell_ssds_id": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "First Cell Ssds Id"
}
},
"type": "object",
"title": "ConversationAPICreate",
"description": "Properties to use in API for creating."
},
"ConversationAPICreateResponse": {
"properties": {
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"creator": { "$ref": "#/components/schemas/UserBasicAPIResponse" },
"can_edit": { "type": "boolean", "title": "Can Edit" },
"accepted_payload_types": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/MessagePayloadType" },
"type": "array"
},
{ "type": "null" }
],
"title": "Accepted Payload Types"
},
"messages": {
"items": { "$ref": "#/components/schemas/MessageAPIBatchResponse" },
"type": "array",
"title": "Messages"
},
"num_messages_total": {
"type": "integer",
"title": "Num Messages Total"
},
"ai_responding": { "type": "boolean", "title": "Ai Responding" },
"task": {
"anyOf": [
{ "$ref": "#/components/schemas/TaskAPI" },
{ "type": "null" }
]
}
},
"type": "object",
"required": [
"id",
"creator",
"can_edit",
"accepted_payload_types",
"messages",
"num_messages_total",
"ai_responding"
],
"title": "ConversationAPICreateResponse",
"description": "Response from creating a conversation with the API\n\nAttributes:\n id: The ID of the conversation.\n creator: The user who created the conversation.\n can_edit: Whether the user can edit the conversation.\n accepted_payload_types: The payload types that can be returned in the conversation.\n messages: The messages in the conversation. They are ordered from neweest to\n oldest.\n num_messages_total: The total number of messages in the conversation.\n ai_responding: Whether the AI is currently responding to the conversation. If\n True, then new messages will not be added to the conversation until the AI\n is done.\n task: The ongoing task associated with the conversation if there is one."
},
"ConversationAPIReadResponse": {
"properties": {
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"creator": { "$ref": "#/components/schemas/UserBasicAPIResponse" },
"can_edit": { "type": "boolean", "title": "Can Edit" },
"accepted_payload_types": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/MessagePayloadType" },
"type": "array"
},
{ "type": "null" }
],
"title": "Accepted Payload Types"
},
"messages": {
"items": { "$ref": "#/components/schemas/MessageAPIBatchResponse" },
"type": "array",
"title": "Messages"
},
"num_messages_total": {
"type": "integer",
"title": "Num Messages Total"
},
"ai_responding": { "type": "boolean", "title": "Ai Responding" },
"task": {
"anyOf": [
{ "$ref": "#/components/schemas/TaskAPI" },
{ "type": "null" }
]
}
},
"type": "object",
"required": [
"id",
"creator",
"can_edit",
"accepted_payload_types",
"messages",
"num_messages_total",
"ai_responding"
],
"title": "ConversationAPIReadResponse",
"description": "Response from reading a conversation with the API\n\nNote that it inherits from ConversationAPICreateResponse, so it has the same\nattributes."
},
"ConversationAPIStart": {
"properties": {
"message_text": { "type": "string", "title": "Message Text" },
"ssds_id": {
"type": "string",
"format": "uuid4",
"title": "Ssds Id"
},
"accepted_payload_types": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/MessagePayloadType" },
"type": "array"
},
{ "type": "null" }
],
"title": "Accepted Payload Types"
}
},
"type": "object",
"required": ["message_text", "ssds_id"],
"title": "ConversationAPIStart",
"description": "Payload for starting a conversation with the API\n\nNote that this is the same as MessageAPISend, but it is a separate class to make\nthe API more clear."
},
"ConversationAPIUpdate": {
"properties": {
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
}
},
"type": "object",
"title": "ConversationAPIUpdate",
"description": "Properties to use in API for updating."
},
"ConversationBasic": {
"properties": {
"creator_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Creator Id"
},
"permissions": {
"allOf": [{ "$ref": "#/components/schemas/Permissions" }],
"default": { "read": false, "write": false }
},
"sync_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Sync Id"
},
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"account_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Account Id"
},
"is_pinned": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Pinned",
"default": false
},
"is_eval_conversation": {
"type": "boolean",
"title": "Is Eval Conversation",
"default": false
},
"is_hidden": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Hidden",
"default": false
},
"is_moonlight": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Moonlight",
"default": false
},
"is_training": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Training",
"default": false
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
},
"creator": {
"anyOf": [
{ "$ref": "#/components/schemas/User" },
{ "type": "null" }
]
},
"is_starred": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Starred"
},
"bumblebee_cells_count": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Bumblebee Cells Count"
}
},
"type": "object",
"required": ["id", "created_at", "updated_at"],
"title": "ConversationBasic",
"description": "Reduced properties to use when getting Conversations in a list."
},
"ConversationCellFilter": {
"type": "string",
"enum": ["ALL", "VERIFIED_CONV_ONLY", "VERIFIED_CELL_ONLY"],
"title": "ConversationCellFilter"
},
"ConversationCellTuple": {
"properties": {
"conversation": { "$ref": "#/components/schemas/ConversationBasic" },
"cell": { "$ref": "#/components/schemas/BumblebeeCellBasic" }
},
"type": "object",
"required": ["conversation", "cell"],
"title": "ConversationCellTuple",
"description": "Conversation and cell tuple."
},
"ConversationFull": {
"properties": {
"creator_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Creator Id"
},
"permissions": {
"allOf": [{ "$ref": "#/components/schemas/Permissions" }],
"default": { "read": false, "write": false }
},
"sync_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Sync Id"
},
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"account_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Account Id"
},
"is_pinned": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Pinned",
"default": false
},
"is_eval_conversation": {
"type": "boolean",
"title": "Is Eval Conversation",
"default": false
},
"is_hidden": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Hidden",
"default": false
},
"is_moonlight": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Moonlight",
"default": false
},
"is_training": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Training",
"default": false
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
},
"creator": {
"anyOf": [
{ "$ref": "#/components/schemas/User" },
{ "type": "null" }
]
},
"is_starred": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Is Starred"
},
"bumblebee_cells": {
"items": { "$ref": "#/components/schemas/BumblebeeCellBasic" },
"type": "array",
"title": "Bumblebee Cells"
},
"tasks": {
"items": { "$ref": "#/components/schemas/Task" },
"type": "array",
"title": "Tasks",
"default": []
}
},
"type": "object",
"required": ["id", "created_at", "updated_at", "bumblebee_cells"],
"title": "ConversationFull",
"description": "Additional properties to return via API."
},
"ConversationsFilter": {
"type": "string",
"enum": ["is_pinned", "is_by_user", "is_starred", "is_eval"],
"title": "ConversationsFilter",
"description": "Filter conversations by."
},
"ConversationsSort": {
"type": "string",
"enum": ["created_at", "last_modified_at", "creator_id", "name"],
"title": "ConversationsSort",
"description": "Sort conversations by."
},
"DMFilter": {
"type": "string",
"enum": ["ALL", "VERIFIED_ONLY"],
"title": "DMFilter"
},
"DMMType": {
"type": "string",
"enum": ["zendimension", "zenmeasure"],
"title": "DMMType",
"description": "Possible types."
},
"DMSensitiveAssignment": {
"properties": {
"literal_sensitive_dimension_ids": {
"items": { "type": "string", "format": "uuid" },
"type": "array",
"title": "Literal Sensitive Dimension Ids",
"default": []
},
"literal_sensitive_metric_ids": {
"items": { "type": "string", "format": "uuid" },
"type": "array",
"title": "Literal Sensitive Metric Ids",
"default": []
},
"generic_sensitive_dimension_ids": {
"items": { "type": "string", "format": "uuid" },
"type": "array",
"title": "Generic Sensitive Dimension Ids",
"default": []
},
"generic_sensitive_metric_ids": {
"items": { "type": "string", "format": "uuid" },
"type": "array",
"title": "Generic Sensitive Metric Ids",
"default": []
}
},
"type": "object",
"title": "DMSensitiveAssignment",
"description": "DM Sensitive Assignment, used for batch update."
},
"DMSensitiveKnowledgeImpact": {
"properties": {
"dm_reason": {
"type": "string",
"title": "Dm Reason",
"default": "These dimensions and metrics will be impacted by the action."
},
"dimensions": {
"items": { "$ref": "#/components/schemas/DimensionView" },
"type": "array",
"title": "Dimensions"
},
"metrics": {
"items": { "$ref": "#/components/schemas/MetricView" },
"type": "array",
"title": "Metrics"
},
"filters": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/NamedFilterBase" },
"type": "array"
},
{ "type": "null" }
],
"title": "Filters"
},
"cell_reason": {
"type": "string",
"title": "Cell Reason",
"default": "These cells will be impacted by the action."
},
"cells": {
"items": { "$ref": "#/components/schemas/BumblebeeCellBasic" },
"type": "array",
"title": "Cells"
},
"confirmation_payload": {
"allOf": [{ "$ref": "#/components/schemas/DMSensitiveAssignment" }],
"default": {
"literal_sensitive_dimension_ids": [],
"literal_sensitive_metric_ids": [],
"generic_sensitive_dimension_ids": [],
"generic_sensitive_metric_ids": []
}
}
},
"type": "object",
"required": ["dimensions", "metrics", "cells"],
"title": "DMSensitiveKnowledgeImpact",
"description": "Knowledge Impact for dimension/metric sensitive marking."
},
"DataAssetAPI": {
"properties": {
"id": {
"type": "string",
"format": "uuid4",
"title": "Id",
"description": "The UUID for the data asset."
},
"name": {
"type": "string",
"title": "Name",
"description": "The display name of the data asset."
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description",
"description": "The description of the data asset."
},
"asset_type": { "$ref": "#/components/schemas/DataAssetTypeAPI" },
"connection_type": {
"$ref": "#/components/schemas/DataAssetConnectionTypeAPI"
}
},
"type": "object",
"required": [
"id",
"name",
"description",
"asset_type",
"connection_type"
],
"title": "DataAssetAPI",
"description": "A data asset within the application.\n\nA data asset is a referenceable entity that can contain data. This might be a\ndataset (also sometimes referred to as a Star Schema Data Source) or a report."
},
"DataAssetAPIPage": {
"properties": {
"data": {
"items": { "$ref": "#/components/schemas/DataAssetAPI" },
"type": "array",
"title": "Data"
},
"total": {
"type": "integer",
"title": "Total",
"description": "The total number of data assets."
}
},
"type": "object",
"required": ["data", "total"],
"title": "DataAssetAPIPage",
"description": "A page of data assets."
},
"DataAssetConnectionTypeAPI": {
"type": "string",
"enum": [
"snowflake",
"bigquery",
"databricks",
"redshift",
"tableau",
"mode",
"unknown"
],
"title": "DataAssetConnectionTypeAPI",
"description": "The connection type of the data asset.",
"x-enumDescriptions": {
"bigquery": "A BigQuery data source. Only available for 'dataset' asset types.",
"databricks": "A Databricks data source. Only available for 'dataset' asset types.",
"mode": "A Mode report. Only available for 'report' asset types.",
"redshift": "A Redshift data source. Only available for 'dataset' asset types.",
"snowflake": "A Snowflake data source. Only available for 'dataset' asset types.",
"tableau": "A Tableau report. Only available for 'report' asset types.",
"unknown": "An unknown data source."
}
},
"DataAssetTypeAPI": {
"type": "string",
"enum": ["dataset", "report"],
"title": "DataAssetTypeAPI",
"description": "The type of data asset.",
"x-enumDescriptions": {
"dataset": "A collection of joinable tables and their associated dimensions and metrics. This is also often referred to as a dataset or a datasource within the application UI.",
"report": "A report or dashboard such as Tableau or Mode."
}
},
"DataAssetVisibility": {
"type": "string",
"enum": ["PUBLISHED", "DRAFT", "ARCHIVED"],
"title": "DataAssetVisibility",
"description": "Possible data asset visibility states."
},
"DataPage": {
"properties": {
"data": {
"type": "string",
"contentMediaType": "application/json",
"contentSchema": { "items": {}, "type": "array" },
"title": "Data"
},
"total": { "type": "integer", "title": "Total" }
},
"type": "object",
"required": ["data", "total"],
"title": "DataPage",
"description": "Paginated data response."
},
"DataSource": {
"properties": {
"id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Id"
},
"sync_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Sync Id"
},
"index": { "type": "integer", "title": "Index", "default": 0 },
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"sql_table": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Sql Table"
},
"derived_table_sql": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Derived Table Sql"
},
"description": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Description"
},
"identifiers": {
"items": { "$ref": "#/components/schemas/Identifier" },
"type": "array",
"title": "Identifiers",
"default": []
},
"dimensions": {
"items": { "$ref": "#/components/schemas/DimensionView" },
"type": "array",
"title": "Dimensions",
"default": []
},
"metrics": {
"items": { "$ref": "#/components/schemas/MetricView" },
"type": "array",
"title": "Metrics",
"default": []
}
},
"type": "object",
"title": "DataSource",
"description": "DataSource class."
},
"DataSourceMetadata": {
"properties": {
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"name": { "type": "string", "title": "Name" },
"sql_table": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Sql Table"
},
"derived_table_sql": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Derived Table Sql"
}
},
"type": "object",
"required": ["id", "name", "sql_table", "derived_table_sql"],
"title": "DataSourceMetadata"
},
"DataSourceProfileInfo": {
"properties": {
"id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Id"
},
"table_info": { "$ref": "#/components/schemas/Table" },
"num_of_rows": { "type": "integer", "title": "Num Of Rows" }
},
"type": "object",
"required": ["table_info", "num_of_rows"],
"title": "DataSourceProfileInfo",
"description": "Profiling information returned by data source profile API."
},
"DatabricksConnection": {
"properties": {
"name": { "type": "string", "title": "Name" },
"account_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Account Id"
},
"is_demo": { "type": "boolean", "title": "Is Demo" },
"is_draft": {
"type": "boolean",
"title": "Is Draft",
"default": false
},
"status": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Status"
},
"status_at": {
"anyOf": [
{ "type": "string", "format": "date-time" },
{ "type": "null" }
],
"title": "Status At"
},
"type": {
"anyOf": [
{ "$ref": "#/components/schemas/ConnectionPolyType" },
{ "type": "null" }
]
},
"max_tables": {
"type": "integer",
"exclusiveMinimum": 0.0,
"title": "Max Tables",
"default": 8000
},
"warehouse_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Warehouse Access"
},
"result_cache_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Result Cache Access"
},
"error_msg": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Error Msg"
},
"host": { "type": "string", "title": "Host" },
"http_path": { "type": "string", "title": "Http Path" },
"ns_database": {
"type": "string",
"title": "Ns Database",
"default": "NUMBERS_STATION"
},
"ns_schema": {
"type": "string",
"title": "Ns Schema",
"default": "NUMBERS_STATION"
},
"id": { "type": "string", "format": "uuid4", "title": "Id" },
"created_at": {
"type": "string",
"format": "date-time",
"title": "Created At"
},
"updated_at": {
"type": "string",
"format": "date-time",
"title": "Updated At"
}
},
"type": "object",
"required": [
"name",
"is_demo",
"host",
"http_path",
"id",
"created_at",
"updated_at"
],
"title": "DatabricksConnection",
"description": "Additional properties to return via API."
},
"DatabricksConnectionCreate": {
"properties": {
"name": { "type": "string", "title": "Name" },
"account_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Account Id"
},
"is_demo": {
"type": "boolean",
"title": "Is Demo",
"default": false
},
"is_draft": {
"type": "boolean",
"title": "Is Draft",
"default": false
},
"status": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Status"
},
"status_at": {
"anyOf": [
{ "type": "string", "format": "date-time" },
{ "type": "null" }
],
"title": "Status At"
},
"type": {
"allOf": [{ "$ref": "#/components/schemas/ConnectionPolyType" }],
"default": "databricks"
},
"max_tables": {
"type": "integer",
"exclusiveMinimum": 0.0,
"title": "Max Tables",
"default": 8000
},
"warehouse_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Warehouse Access"
},
"result_cache_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Result Cache Access"
},
"error_msg": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Error Msg"
},
"host": { "type": "string", "title": "Host" },
"http_path": { "type": "string", "title": "Http Path" },
"ns_database": {
"type": "string",
"title": "Ns Database",
"default": "NUMBERS_STATION"
},
"ns_schema": {
"type": "string",
"title": "Ns Schema",
"default": "NUMBERS_STATION"
},
"access_token": {
"type": "string",
"format": "password",
"title": "Access Token",
"writeOnly": true
}
},
"type": "object",
"required": ["name", "host", "http_path", "access_token"],
"title": "DatabricksConnectionCreate",
"description": "Properties to receive via API on creation."
},
"DatabricksConnectionLookup": {
"properties": {
"host": { "type": "string", "title": "Host" },
"http_path": { "type": "string", "title": "Http Path" }
},
"type": "object",
"required": ["host", "http_path"],
"title": "DatabricksConnectionLookup",
"description": "Databricks Connection Lookup."
},
"DatabricksConnectionUpdate": {
"properties": {
"name": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Name"
},
"account_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Account Id"
},
"is_demo": {
"type": "boolean",
"title": "Is Demo",
"default": false
},
"is_draft": {
"type": "boolean",
"title": "Is Draft",
"default": false
},
"status": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Status"
},
"status_at": {
"anyOf": [
{ "type": "string", "format": "date-time" },
{ "type": "null" }
],
"title": "Status At"
},
"type": {
"allOf": [{ "$ref": "#/components/schemas/ConnectionPolyType" }],
"default": "databricks"
},
"max_tables": {
"anyOf": [
{ "type": "integer", "exclusiveMinimum": 0.0 },
{ "type": "null" }
],
"title": "Max Tables"
},
"warehouse_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Warehouse Access"
},
"result_cache_access": {
"anyOf": [{ "type": "boolean" }, { "type": "null" }],
"title": "Result Cache Access"
},
"error_msg": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Error Msg"
},
"host": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Host"
},
"http_path": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Http Path"
},
"ns_database": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Ns Database"
},
"ns_schema": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Ns Schema"
},
"access_token": {
"anyOf": [
{ "type": "string", "format": "password", "writeOnly": true },
{ "type": "null" }
],
"title": "Access Token"
}
},
"type": "object",
"title": "DatabricksConnectionUpdate",
"description": "Properties to receive via API on update."
},
"DatasetsResponse": {
"properties": {
"data": {
"items": {
"anyOf": [
{ "$ref": "#/components/schemas/StarSchemaDataSourceBasic" },
{ "$ref": "#/components/schemas/Report" }
]
},
"type": "array",
"title": "Data"
},
"count": { "type": "integer", "title": "Count" }
},
"type": "object",
"required": ["data", "count"],
"title": "DatasetsResponse",
"description": "Star Schema Data Sources Response."
},
"DateTimeColumnStatistics": {
"properties": {
"name": { "type": "string", "title": "Name" },
"type": { "type": "string", "title": "Type" },
"count": { "type": "integer", "title": "Count" },
"num_nulls": { "type": "integer", "title": "Num Nulls" },
"num_distinct_values": {
"anyOf": [{ "type": "integer" }, { "type": "null" }],
"title": "Num Distinct Values"
},
"stat_type": {
"type": "string",
"enum": ["datetime"],
"const": "datetime",
"title": "Stat Type",
"default": "datetime"
},
"min_datetime": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Min Datetime"
},
"max_datetime": {
"anyOf": [{ "type": "string" }, { "type": "null" }],
"title": "Max Datetime"
},
"histogram": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/HistogramBucketStr" },
"type": "array"
},
{ "type": "null" }
],
"title": "Histogram"
},
"most_common_values": {
"items": { "$ref": "#/components/schemas/ColumnValue" },
"type": "array",
"title": "Most Common Values"
}
},
"type": "object",
"required": [
"name",
"type",
"count",
"num_nulls",
"most_common_values"
],
"title": "DateTimeColumnStatistics",
"description": "Statistics for datetime/timestamp columns."
},
"DebugLog": {
"properties": {
"question": { "type": "string", "title": "Question" },
"data_source": {
"anyOf": [
{ "$ref": "#/components/schemas/DataSource" },
{ "type": "null" }
]
},
"table": {
"anyOf": [
{ "$ref": "#/components/schemas/Table" },
{ "type": "null" }
]
},
"history": {
"anyOf": [
{
"items": { "$ref": "#/components/schemas/ChatStep" },
"type": "array"
},
{ "type": "null" }
],
"title": "History"
},
"ssds_id": {
"anyOf": [
{ "type": "string", "format": "uuid4" },
{ "type": "null" }
],
"title": "Ssds Id"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment