Skip to content

Knowledge Bases

Attach Knowledge Bases to an Agent
post/v2/gen-ai/agents/{agent_uuid}/knowledge_bases
Attach Knowledge Base to an Agent
post/v2/gen-ai/agents/{agent_uuid}/knowledge_bases/{knowledge_base_uuid}
Detach Knowledge Base from an Agent
delete/v2/gen-ai/agents/{agent_uuid}/knowledge_bases/{knowledge_base_uuid}
ModelsExpand Collapse
created_at: optional string

Key creation date

formatdate-time
created_by: optional string

Created by user id from DO

formatuint64
deleted_at: optional string

Key deleted date

formatdate-time
name: optional string

Name

updated_at: optional string

Key last updated date

formatdate-time
uuid: optional string

Uuid

Accepts one of the following:
Accepts one of the following:
"VISIBILITY_UNKNOWN"
"VISIBILITY_DISABLED"
"VISIBILITY_PLAYGROUND"
"VISIBILITY_PUBLIC"
"VISIBILITY_PRIVATE"
Accepts one of the following:
completed_datasources: optional number

Number of datasources indexed completed

formatint64
created_at: optional string

Creation date / time

formatdate-time
data_source_jobs: optional array of APIIndexedDataSource { completed_at, data_source_uuid, error_details, 11 more }

Details on Data Sources included in the Indexing Job

completed_at: optional string

Timestamp when data source completed indexing

formatdate-time
data_source_uuid: optional string

Uuid of the indexed data source

error_details: optional string

A detailed error description

error_msg: optional string

A string code provinding a hint which part of the system experienced an error

failed_item_count: optional string

Total count of files that have failed

formatuint64
indexed_file_count: optional string

Total count of files that have been indexed

formatuint64
indexed_item_count: optional string

Total count of files that have been indexed

formatuint64
removed_item_count: optional string

Total count of files that have been removed

formatuint64
skipped_item_count: optional string

Total count of files that have been skipped

formatuint64
started_at: optional string

Timestamp when data source started indexing

formatdate-time
status: optional "DATA_SOURCE_STATUS_UNKNOWN" or "DATA_SOURCE_STATUS_IN_PROGRESS" or "DATA_SOURCE_STATUS_UPDATED" or 4 more
Accepts one of the following:
"DATA_SOURCE_STATUS_UNKNOWN"
"DATA_SOURCE_STATUS_IN_PROGRESS"
"DATA_SOURCE_STATUS_UPDATED"
"DATA_SOURCE_STATUS_PARTIALLY_UPDATED"
"DATA_SOURCE_STATUS_NOT_UPDATED"
"DATA_SOURCE_STATUS_FAILED"
"DATA_SOURCE_STATUS_CANCELLED"
total_bytes: optional string

Total size of files in data source in bytes

formatuint64
total_bytes_indexed: optional string

Total size of files in data source in bytes that have been indexed

formatuint64
total_file_count: optional string

Total file count in the data source

formatuint64
data_source_uuids: optional array of string
finished_at: optional string
formatdate-time
is_report_available: optional boolean

Boolean value to determine if the indexing job details are available

knowledge_base_uuid: optional string

Knowledge base id

phase: optional "BATCH_JOB_PHASE_UNKNOWN" or "BATCH_JOB_PHASE_PENDING" or "BATCH_JOB_PHASE_RUNNING" or 4 more
Accepts one of the following:
"BATCH_JOB_PHASE_UNKNOWN"
"BATCH_JOB_PHASE_PENDING"
"BATCH_JOB_PHASE_RUNNING"
"BATCH_JOB_PHASE_SUCCEEDED"
"BATCH_JOB_PHASE_FAILED"
"BATCH_JOB_PHASE_ERROR"
"BATCH_JOB_PHASE_CANCELLED"
started_at: optional string
formatdate-time
status: optional "INDEX_JOB_STATUS_UNKNOWN" or "INDEX_JOB_STATUS_PARTIAL" or "INDEX_JOB_STATUS_IN_PROGRESS" or 4 more
Accepts one of the following:
"INDEX_JOB_STATUS_UNKNOWN"
"INDEX_JOB_STATUS_PARTIAL"
"INDEX_JOB_STATUS_IN_PROGRESS"
"INDEX_JOB_STATUS_COMPLETED"
"INDEX_JOB_STATUS_FAILED"
"INDEX_JOB_STATUS_NO_CHANGES"
"INDEX_JOB_STATUS_PENDING"
tokens: optional number

Number of tokens [This field is deprecated]

formatint64
total_datasources: optional number

Number of datasources being indexed

formatint64
total_items_failed: optional string

Total Items Failed

formatuint64
total_items_indexed: optional string

Total Items Indexed

formatuint64
total_items_removed: optional string

Total Items Removed

formatuint64
total_items_skipped: optional string

Total Items Skipped

formatuint64
total_tokens: optional string

Total Tokens Consumed By the Indexing Job

formatuint64
updated_at: optional string

Last modified

formatdate-time
uuid: optional string

Unique id

agreement: optional APIAgreement { description, name, url, uuid }

Agreement Description

description: optional string
name: optional string
url: optional string
uuid: optional string
created_at: optional string

Creation date / time

formatdate-time
inference_name: optional string

Internally used name

inference_version: optional string

Internally used version

is_foundational: optional boolean

True if it is a foundational model provided by do

metadata: optional unknown

Additional meta data

name: optional string

Name of the model

parent_uuid: optional string

Unique id of the model, this model is based on

provider: optional "MODEL_PROVIDER_DIGITALOCEAN" or "MODEL_PROVIDER_ANTHROPIC" or "MODEL_PROVIDER_OPENAI"
Accepts one of the following:
"MODEL_PROVIDER_DIGITALOCEAN"
"MODEL_PROVIDER_ANTHROPIC"
"MODEL_PROVIDER_OPENAI"
updated_at: optional string

Last modified

formatdate-time
upload_complete: optional boolean

Model has been fully uploaded

url: optional string

Download url

usecases: optional array of "MODEL_USECASE_UNKNOWN" or "MODEL_USECASE_AGENT" or "MODEL_USECASE_FINETUNED" or 4 more

Usecases of the model

Accepts one of the following:
"MODEL_USECASE_UNKNOWN"
"MODEL_USECASE_AGENT"
"MODEL_USECASE_FINETUNED"
"MODEL_USECASE_KNOWLEDGEBASE"
"MODEL_USECASE_GUARDRAIL"
"MODEL_USECASE_REASONING"
"MODEL_USECASE_SERVERLESS"
uuid: optional string

Unique id

version: optional APIModelVersion { major, minor, patch }

Version Information about a Model

major: optional number

Major version number

formatint64
minor: optional number

Minor version number

formatint64
patch: optional number

Patch version number

formatint64
description: optional string
name: optional string
url: optional string
uuid: optional string
Accepts one of the following:
Accepts one of the following:
major: optional number

Major version number

formatint64
minor: optional number

Minor version number

formatint64
patch: optional number

Patch version number

formatint64
Accepts one of the following:
created_at: optional string

Key creation date

formatdate-time
created_by: optional string

Created by user id from DO

formatuint64
deleted_at: optional string

Key deleted date

formatdate-time
models: optional array of APIAgentModel { agreement, created_at, inference_name, 12 more }

Models supported by the openAI api key

agreement: optional APIAgreement { description, name, url, uuid }

Agreement Description

description: optional string
name: optional string
url: optional string
uuid: optional string
created_at: optional string

Creation date / time

formatdate-time
inference_name: optional string

Internally used name

inference_version: optional string

Internally used version

is_foundational: optional boolean

True if it is a foundational model provided by do

metadata: optional unknown

Additional meta data

name: optional string

Name of the model

parent_uuid: optional string

Unique id of the model, this model is based on

provider: optional "MODEL_PROVIDER_DIGITALOCEAN" or "MODEL_PROVIDER_ANTHROPIC" or "MODEL_PROVIDER_OPENAI"
Accepts one of the following:
"MODEL_PROVIDER_DIGITALOCEAN"
"MODEL_PROVIDER_ANTHROPIC"
"MODEL_PROVIDER_OPENAI"
updated_at: optional string

Last modified

formatdate-time
upload_complete: optional boolean

Model has been fully uploaded

url: optional string

Download url

usecases: optional array of "MODEL_USECASE_UNKNOWN" or "MODEL_USECASE_AGENT" or "MODEL_USECASE_FINETUNED" or 4 more

Usecases of the model

Accepts one of the following:
"MODEL_USECASE_UNKNOWN"
"MODEL_USECASE_AGENT"
"MODEL_USECASE_FINETUNED"
"MODEL_USECASE_KNOWLEDGEBASE"
"MODEL_USECASE_GUARDRAIL"
"MODEL_USECASE_REASONING"
"MODEL_USECASE_SERVERLESS"
uuid: optional string

Unique id

version: optional APIModelVersion { major, minor, patch }

Version Information about a Model

major: optional number

Major version number

formatint64
minor: optional number

Minor version number

formatint64
patch: optional number

Patch version number

formatint64
name: optional string

Name

updated_at: optional string

Key last updated date

formatdate-time
uuid: optional string

Uuid

Accepts one of the following:
"RETRIEVAL_METHOD_UNKNOWN"
"RETRIEVAL_METHOD_REWRITE"
"RETRIEVAL_METHOD_STEP_BACK"
"RETRIEVAL_METHOD_SUB_QUERIES"
"RETRIEVAL_METHOD_NONE"
completed_datasources: optional number

Number of datasources indexed completed

formatint64
created_at: optional string

Creation date / time

formatdate-time
data_source_jobs: optional array of APIIndexedDataSource { completed_at, data_source_uuid, error_details, 11 more }

Details on Data Sources included in the Indexing Job

completed_at: optional string

Timestamp when data source completed indexing

formatdate-time
data_source_uuid: optional string

Uuid of the indexed data source

error_details: optional string

A detailed error description

error_msg: optional string

A string code provinding a hint which part of the system experienced an error

failed_item_count: optional string

Total count of files that have failed

formatuint64
indexed_file_count: optional string

Total count of files that have been indexed

formatuint64
indexed_item_count: optional string

Total count of files that have been indexed

formatuint64
removed_item_count: optional string

Total count of files that have been removed

formatuint64
skipped_item_count: optional string

Total count of files that have been skipped

formatuint64
started_at: optional string

Timestamp when data source started indexing

formatdate-time
status: optional "DATA_SOURCE_STATUS_UNKNOWN" or "DATA_SOURCE_STATUS_IN_PROGRESS" or "DATA_SOURCE_STATUS_UPDATED" or 4 more
Accepts one of the following:
"DATA_SOURCE_STATUS_UNKNOWN"
"DATA_SOURCE_STATUS_IN_PROGRESS"
"DATA_SOURCE_STATUS_UPDATED"
"DATA_SOURCE_STATUS_PARTIALLY_UPDATED"
"DATA_SOURCE_STATUS_NOT_UPDATED"
"DATA_SOURCE_STATUS_FAILED"
"DATA_SOURCE_STATUS_CANCELLED"
total_bytes: optional string

Total size of files in data source in bytes

formatuint64
total_bytes_indexed: optional string

Total size of files in data source in bytes that have been indexed

formatuint64
total_file_count: optional string

Total file count in the data source

formatuint64
data_source_uuids: optional array of string
finished_at: optional string
formatdate-time
is_report_available: optional boolean

Boolean value to determine if the indexing job details are available

knowledge_base_uuid: optional string

Knowledge base id

phase: optional "BATCH_JOB_PHASE_UNKNOWN" or "BATCH_JOB_PHASE_PENDING" or "BATCH_JOB_PHASE_RUNNING" or 4 more
Accepts one of the following:
"BATCH_JOB_PHASE_UNKNOWN"
"BATCH_JOB_PHASE_PENDING"
"BATCH_JOB_PHASE_RUNNING"
"BATCH_JOB_PHASE_SUCCEEDED"
"BATCH_JOB_PHASE_FAILED"
"BATCH_JOB_PHASE_ERROR"
"BATCH_JOB_PHASE_CANCELLED"
started_at: optional string
formatdate-time
status: optional "INDEX_JOB_STATUS_UNKNOWN" or "INDEX_JOB_STATUS_PARTIAL" or "INDEX_JOB_STATUS_IN_PROGRESS" or 4 more
Accepts one of the following:
"INDEX_JOB_STATUS_UNKNOWN"
"INDEX_JOB_STATUS_PARTIAL"
"INDEX_JOB_STATUS_IN_PROGRESS"
"INDEX_JOB_STATUS_COMPLETED"
"INDEX_JOB_STATUS_FAILED"
"INDEX_JOB_STATUS_NO_CHANGES"
"INDEX_JOB_STATUS_PENDING"
tokens: optional number

Number of tokens [This field is deprecated]

formatint64
total_datasources: optional number

Number of datasources being indexed

formatint64
total_items_failed: optional string

Total Items Failed

formatuint64
total_items_indexed: optional string

Total Items Indexed

formatuint64
total_items_removed: optional string

Total Items Removed

formatuint64
total_items_skipped: optional string

Total Items Skipped

formatuint64
total_tokens: optional string

Total Tokens Consumed By the Indexing Job

formatuint64
updated_at: optional string

Last modified

formatdate-time
uuid: optional string

Unique id

agreement: optional APIAgreement { description, name, url, uuid }

Agreement Description

description: optional string
name: optional string
url: optional string
uuid: optional string
created_at: optional string

Creation date / time

formatdate-time
inference_name: optional string

Internally used name

inference_version: optional string

Internally used version

is_foundational: optional boolean

True if it is a foundational model provided by do

metadata: optional unknown

Additional meta data

name: optional string

Name of the model

parent_uuid: optional string

Unique id of the model, this model is based on

provider: optional "MODEL_PROVIDER_DIGITALOCEAN" or "MODEL_PROVIDER_ANTHROPIC" or "MODEL_PROVIDER_OPENAI"
Accepts one of the following:
"MODEL_PROVIDER_DIGITALOCEAN"
"MODEL_PROVIDER_ANTHROPIC"
"MODEL_PROVIDER_OPENAI"
updated_at: optional string

Last modified

formatdate-time
upload_complete: optional boolean

Model has been fully uploaded

url: optional string

Download url

usecases: optional array of "MODEL_USECASE_UNKNOWN" or "MODEL_USECASE_AGENT" or "MODEL_USECASE_FINETUNED" or 4 more

Usecases of the model

Accepts one of the following:
"MODEL_USECASE_UNKNOWN"
"MODEL_USECASE_AGENT"
"MODEL_USECASE_FINETUNED"
"MODEL_USECASE_KNOWLEDGEBASE"
"MODEL_USECASE_GUARDRAIL"
"MODEL_USECASE_REASONING"
"MODEL_USECASE_SERVERLESS"
uuid: optional string

Unique id

version: optional APIModelVersion { major, minor, patch }

Version Information about a Model

major: optional number

Major version number

formatint64
minor: optional number

Minor version number

formatint64
patch: optional number

Patch version number

formatint64
Accepts one of the following: