# Copilot

## List Agents

> Route for listing AI agents.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/agent/":{"get":{"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AgentPublic"},"title":"Response List Agents Agent  Get","type":"array"}}}}},"tags":["Copilot"],"description":"Route for listing AI agents.","operationId":"list_agents_agent__get","summary":"List Agents"}}},"components":{"schemas":{"AgentPublic":{"description":"Response for an agent.","properties":{"context_id":{"title":"Context Id"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"datasource_id":{"title":"Datasource Id"},"description":{"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"index_status":{"$ref":"#/components/schemas/AgentIndexState"},"name":{"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/AgentStatus"},"type":{"$ref":"#/components/schemas/AgentType"}},"required":["id","name","description","type","status","context_id","datasource_id","created_on","index_status"],"title":"AgentPublic","type":"object"},"AgentIndexState":{"description":"Agent Index State Enum","enum":["INSYNC","OUTOFSYNC"],"title":"AgentIndexState","type":"string"},"AgentStatus":{"description":"Agent Status Enum","enum":["DEVELOPMENT","DEPLOYED","RETIRED"],"title":"AgentStatus","type":"string"},"AgentType":{"description":"Agent Type Enum","enum":["SYSTEM","USER"],"title":"AgentType","type":"string"}}}}
```

## Create Agent

> Route for creating a new AI agent.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/agent/":{"post":{"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Route for creating a new AI agent.","operationId":"create_agent_agent__post","summary":"Create Agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCreateRequest"}}},"required":true}}}},"components":{"schemas":{"AgentPublic":{"description":"Response for an agent.","properties":{"context_id":{"title":"Context Id"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"datasource_id":{"title":"Datasource Id"},"description":{"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"index_status":{"$ref":"#/components/schemas/AgentIndexState"},"name":{"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/AgentStatus"},"type":{"$ref":"#/components/schemas/AgentType"}},"required":["id","name","description","type","status","context_id","datasource_id","created_on","index_status"],"title":"AgentPublic","type":"object"},"AgentIndexState":{"description":"Agent Index State Enum","enum":["INSYNC","OUTOFSYNC"],"title":"AgentIndexState","type":"string"},"AgentStatus":{"description":"Agent Status Enum","enum":["DEVELOPMENT","DEPLOYED","RETIRED"],"title":"AgentStatus","type":"string"},"AgentType":{"description":"Agent Type Enum","enum":["SYSTEM","USER"],"title":"AgentType","type":"string"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"AgentCreateRequest":{"description":"Request for creating a new agent.","properties":{"context_id":{"format":"uuid","title":"Context Id","type":"string"},"description":{"title":"Description"},"name":{"title":"Name","type":"string"}},"required":["context_id","name","description"],"title":"AgentCreateRequest","type":"object"}}}}
```

## Import Agent

> Import an agent from JSON

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/agent/import":{"post":{"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Import an agent from JSON","operationId":"import_agent_agent_import_post","summary":"Import Agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentImportRequest"}}},"required":true}}}},"components":{"schemas":{"AgentPublic":{"description":"Response for an agent.","properties":{"context_id":{"title":"Context Id"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"datasource_id":{"title":"Datasource Id"},"description":{"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"index_status":{"$ref":"#/components/schemas/AgentIndexState"},"name":{"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/AgentStatus"},"type":{"$ref":"#/components/schemas/AgentType"}},"required":["id","name","description","type","status","context_id","datasource_id","created_on","index_status"],"title":"AgentPublic","type":"object"},"AgentIndexState":{"description":"Agent Index State Enum","enum":["INSYNC","OUTOFSYNC"],"title":"AgentIndexState","type":"string"},"AgentStatus":{"description":"Agent Status Enum","enum":["DEVELOPMENT","DEPLOYED","RETIRED"],"title":"AgentStatus","type":"string"},"AgentType":{"description":"Agent Type Enum","enum":["SYSTEM","USER"],"title":"AgentType","type":"string"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"AgentImportRequest":{"description":"Request for importing an agent.","properties":{"data":{"$ref":"#/components/schemas/AgentExport-Input"},"datasource_id":{"format":"uuid","title":"Datasource Id","type":"string"}},"required":["datasource_id","data"],"title":"AgentImportRequest","type":"object"},"AgentExport-Input":{"description":"Response for exporting an agent.","properties":{"context":{"$ref":"#/components/schemas/ContextExport-Input"},"description":{"title":"Description"},"name":{"title":"Name","type":"string"}},"required":["name","description","context"],"title":"AgentExport","type":"object"},"ContextExport-Input":{"description":"Response for exporting a context.","properties":{"description":{"title":"Description"},"name":{"title":"Name","type":"string"},"tables":{"items":{"$ref":"#/components/schemas/TableExport-Input"},"title":"Tables","type":"array"}},"required":["name","description","tables"],"title":"ContextExport","type":"object"},"TableExport-Input":{"description":"Response for exporting a table.","properties":{"columns":{"items":{"$ref":"#/components/schemas/ColumnExport"},"title":"Columns","type":"array"},"description":{"title":"Description"},"name":{"title":"Name","type":"string"}},"required":["name","description","columns"],"title":"TableExport","type":"object"},"ColumnExport":{"description":"Response for exporting a column.","properties":{"data_role":{},"description":{"title":"Description"},"name":{"title":"Name","type":"string"},"type":{"title":"Type","type":"string"}},"required":["name","type","description","data_role"],"title":"ColumnExport","type":"object"}}}}
```

## Get Agent

> Route for retrieving an AI agent.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/agent/{agent_id}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"agent_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Route for retrieving an AI agent.","operationId":"get_agent_agent__agent_id__get","summary":"Get Agent"}}},"components":{"schemas":{"AgentPublic":{"description":"Response for an agent.","properties":{"context_id":{"title":"Context Id"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"datasource_id":{"title":"Datasource Id"},"description":{"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"index_status":{"$ref":"#/components/schemas/AgentIndexState"},"name":{"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/AgentStatus"},"type":{"$ref":"#/components/schemas/AgentType"}},"required":["id","name","description","type","status","context_id","datasource_id","created_on","index_status"],"title":"AgentPublic","type":"object"},"AgentIndexState":{"description":"Agent Index State Enum","enum":["INSYNC","OUTOFSYNC"],"title":"AgentIndexState","type":"string"},"AgentStatus":{"description":"Agent Status Enum","enum":["DEVELOPMENT","DEPLOYED","RETIRED"],"title":"AgentStatus","type":"string"},"AgentType":{"description":"Agent Type Enum","enum":["SYSTEM","USER"],"title":"AgentType","type":"string"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Delete Agent

> Route for deleting an AI agent.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/agent/{agent_id}":{"delete":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"agent_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Route for deleting an AI agent.","operationId":"delete_agent_agent__agent_id__delete","summary":"Delete Agent"}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Update Agent

> Route for updating an AI agent.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/agent/{agent_id}":{"patch":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"agent_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Route for updating an AI agent.","operationId":"update_agent_agent__agent_id__patch","summary":"Update Agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentUpdateRequest"}}},"required":true}}}},"components":{"schemas":{"AgentPublic":{"description":"Response for an agent.","properties":{"context_id":{"title":"Context Id"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"datasource_id":{"title":"Datasource Id"},"description":{"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"index_status":{"$ref":"#/components/schemas/AgentIndexState"},"name":{"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/AgentStatus"},"type":{"$ref":"#/components/schemas/AgentType"}},"required":["id","name","description","type","status","context_id","datasource_id","created_on","index_status"],"title":"AgentPublic","type":"object"},"AgentIndexState":{"description":"Agent Index State Enum","enum":["INSYNC","OUTOFSYNC"],"title":"AgentIndexState","type":"string"},"AgentStatus":{"description":"Agent Status Enum","enum":["DEVELOPMENT","DEPLOYED","RETIRED"],"title":"AgentStatus","type":"string"},"AgentType":{"description":"Agent Type Enum","enum":["SYSTEM","USER"],"title":"AgentType","type":"string"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"AgentUpdateRequest":{"description":"Request for updating a agent.","properties":{"context_id":{"title":"Context Id"},"description":{"title":"Description"},"name":{"title":"Name"},"status":{}},"title":"AgentUpdateRequest","type":"object"}}}}
```

## Export Agent

> Export agent to JSON

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/agent/{agent_id}/export":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"agent_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentExport-Output"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Export agent to JSON","operationId":"export_agent_agent__agent_id__export_get","summary":"Export Agent"}}},"components":{"schemas":{"AgentExport-Output":{"description":"Response for exporting an agent.","properties":{"context":{"$ref":"#/components/schemas/ContextExport-Output"},"description":{"title":"Description"},"name":{"title":"Name","type":"string"}},"required":["name","description","context"],"title":"AgentExport","type":"object"},"ContextExport-Output":{"description":"Response for exporting a context.","properties":{"description":{"title":"Description"},"name":{"title":"Name","type":"string"},"tables":{"items":{"$ref":"#/components/schemas/TableExport-Output"},"title":"Tables","type":"array"}},"required":["name","description","tables"],"title":"ContextExport","type":"object"},"TableExport-Output":{"description":"Response for exporting a table.","properties":{"columns":{"items":{"$ref":"#/components/schemas/ColumnExport"},"title":"Columns","type":"array"},"description":{"title":"Description"},"name":{"title":"Name","type":"string"}},"required":["name","description","columns"],"title":"TableExport","type":"object"},"ColumnExport":{"description":"Response for exporting a column.","properties":{"data_role":{},"description":{"title":"Description"},"name":{"title":"Name","type":"string"},"type":{"title":"Type","type":"string"}},"required":["name","type","description","data_role"],"title":"ColumnExport","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Generate Agent

> Generate semantics for the agent context based on the description

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/agent/{agent_id}/generate":{"post":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"agent_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextPublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Generate semantics for the agent context based on the description","operationId":"generate_agent_agent__agent_id__generate_post","summary":"Generate Agent"}}},"components":{"schemas":{"ContextPublic":{"description":"API Response for a context.","properties":{"created_on":{"format":"date-time","title":"Created On","type":"string"},"datasource_id":{"format":"uuid","title":"Datasource Id","type":"string"},"description":{"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"tables":{"items":{"$ref":"#/components/schemas/TablePublic"},"title":"Tables","type":"array"}},"required":["id","name","description","datasource_id","created_on","tables"],"title":"ContextPublic","type":"object"},"TablePublic":{"description":"API Response for a table.","properties":{"available_columns":{"items":{"$ref":"#/components/schemas/ColumnPublic"},"title":"Available Columns","type":"array"},"columns":{"items":{"$ref":"#/components/schemas/ColumnPublic"},"title":"Columns","type":"array"},"context_id":{"format":"uuid","title":"Context Id","type":"string"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"description":{"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"}},"required":["id","name","description","context_id","created_on","columns","available_columns"],"title":"TablePublic","type":"object"},"ColumnPublic":{"description":"API Response for a column.","properties":{"data_role":{},"description":{"title":"Description"},"id":{"title":"Id"},"name":{"title":"Name","type":"string"},"type":{"title":"Type","type":"string"}},"required":["id","name","type","description","data_role"],"title":"ColumnPublic","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Rebuild Agent

> Rebuild agent LLM context

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/agent/{agent_id}/rebuild":{"post":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"agent_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Rebuild agent LLM context","operationId":"rebuild_agent_agent__agent_id__rebuild_post","summary":"Rebuild Agent"}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Chat

> Chat with an AI agent

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/chat/":{"post":{"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Chat"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Chat with an AI agent","operationId":"chat_chat__post","summary":"Chat","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}},"required":true}}}},"components":{"schemas":{"Chat":{"description":"Response for the app chat API.","properties":{"prompt":{"title":"Prompt","type":"string"},"response":{"$ref":"#/components/schemas/LlamaResponse"}},"required":["prompt","response"],"title":"Chat","type":"object"},"LlamaResponse":{"description":"Response for the app chat API.","properties":{"col_keys":{"items":{"type":"string"},"title":"Col Keys","type":"array"},"content":{"title":"Content"},"error_text":{"title":"Error Text","type":"string"},"sql_text":{"title":"Sql Text","type":"string"}},"required":["content","sql_text","error_text","col_keys"],"title":"LlamaResponse","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"ChatRequest":{"description":"Request for the app chat API.","properties":{"agent_id":{"format":"uuid","title":"Agent Id","type":"string"},"config":{"default":{},"title":"Config","type":"object"},"prompt":{"title":"Prompt","type":"string"}},"required":["prompt","agent_id"],"title":"ChatRequest","type":"object"}}}}
```

## List Datasources

> List all datasources.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/data-source/":{"get":{"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DataSourceListItem"},"title":"Response List Datasources Data Source  Get","type":"array"}}}}},"tags":["Copilot"],"description":"List all datasources.","operationId":"list_datasources_data_source__get","summary":"List Datasources"}}},"components":{"schemas":{"DataSourceListItem":{"description":"Response for a data source connection list","properties":{"host":{"title":"Host","type":"string"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"port":{"title":"Port","type":"integer"},"type":{"$ref":"#/components/schemas/DataSourceType"},"username":{"title":"Username","type":"string"}},"required":["id","name","host","username","port","type","created_on"],"title":"DataSourceListItem","type":"object"},"DataSourceType":{"description":"Data Source Type Enum","enum":["SYSTEM","USER"],"title":"DataSourceType","type":"string"}}}}
```

## Create Datasource

> Create a new data source connection.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/data-source/":{"post":{"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourcePublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Create a new data source connection.","operationId":"create_datasource_data_source__post","summary":"Create Datasource","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceCreateRequest"}}},"required":true}}}},"components":{"schemas":{"DataSourcePublic":{"description":"Response for a data source connection","properties":{"host":{"title":"Host","type":"string"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"port":{"title":"Port","type":"integer"},"schemas":{"items":{"$ref":"#/components/schemas/Schema"},"title":"Schemas","type":"array"},"type":{"$ref":"#/components/schemas/DataSourceType"},"username":{"title":"Username","type":"string"}},"required":["id","name","host","username","port","type","created_on","schemas"],"title":"DataSourcePublic","type":"object"},"Schema":{"description":"Schema model.","properties":{"name":{"title":"Name","type":"string"},"tables":{"items":{"type":"string"},"title":"Tables","type":"array"}},"required":["name","tables"],"title":"Schema","type":"object"},"DataSourceType":{"description":"Data Source Type Enum","enum":["SYSTEM","USER"],"title":"DataSourceType","type":"string"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"DataSourceCreateRequest":{"description":"Request for creating a new data source connection","properties":{"host":{"title":"Host","type":"string"},"name":{"title":"Name","type":"string"},"password":{"title":"Password","type":"string"},"port":{"title":"Port","type":"integer"},"username":{"title":"Username","type":"string"}},"required":["name","host","username","port","password"],"title":"DataSourceCreateRequest","type":"object"}}}}
```

## Get Datasource

> Retrieve a data source connection.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/data-source/{datasource_id}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"datasource_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourcePublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Retrieve a data source connection.","operationId":"get_datasource_data_source__datasource_id__get","summary":"Get Datasource"}}},"components":{"schemas":{"DataSourcePublic":{"description":"Response for a data source connection","properties":{"host":{"title":"Host","type":"string"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"port":{"title":"Port","type":"integer"},"schemas":{"items":{"$ref":"#/components/schemas/Schema"},"title":"Schemas","type":"array"},"type":{"$ref":"#/components/schemas/DataSourceType"},"username":{"title":"Username","type":"string"}},"required":["id","name","host","username","port","type","created_on","schemas"],"title":"DataSourcePublic","type":"object"},"Schema":{"description":"Schema model.","properties":{"name":{"title":"Name","type":"string"},"tables":{"items":{"type":"string"},"title":"Tables","type":"array"}},"required":["name","tables"],"title":"Schema","type":"object"},"DataSourceType":{"description":"Data Source Type Enum","enum":["SYSTEM","USER"],"title":"DataSourceType","type":"string"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Delete Datasource

> Delete a data source connection.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/data-source/{datasource_id}":{"delete":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"datasource_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Delete a data source connection.","operationId":"delete_datasource_data_source__datasource_id__delete","summary":"Delete Datasource"}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Update Datasource

> Update a data source connection.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/data-source/{datasource_id}":{"patch":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"datasource_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourcePublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Update a data source connection.","operationId":"update_datasource_data_source__datasource_id__patch","summary":"Update Datasource","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceUpdateRequest"}}},"required":true}}}},"components":{"schemas":{"DataSourcePublic":{"description":"Response for a data source connection","properties":{"host":{"title":"Host","type":"string"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"port":{"title":"Port","type":"integer"},"schemas":{"items":{"$ref":"#/components/schemas/Schema"},"title":"Schemas","type":"array"},"type":{"$ref":"#/components/schemas/DataSourceType"},"username":{"title":"Username","type":"string"}},"required":["id","name","host","username","port","type","created_on","schemas"],"title":"DataSourcePublic","type":"object"},"Schema":{"description":"Schema model.","properties":{"name":{"title":"Name","type":"string"},"tables":{"items":{"type":"string"},"title":"Tables","type":"array"}},"required":["name","tables"],"title":"Schema","type":"object"},"DataSourceType":{"description":"Data Source Type Enum","enum":["SYSTEM","USER"],"title":"DataSourceType","type":"string"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"DataSourceUpdateRequest":{"description":"Request for updating a data source connection","properties":{"name":{"title":"Name"},"password":{"title":"Password"},"username":{"title":"Username"}},"title":"DataSourceUpdateRequest","type":"object"}}}}
```

## Get Quota

> Get the current quota usage.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/quota/":{"get":{"parameters":[{"schema":{"type":"string"},"in":"query","name":"start","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end","required":false},{"schema":{"type":"string"},"in":"query","name":"event","required":false}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/QuotaItem"},"title":"Response Get Quota Quota  Get","type":"array"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Get the current quota usage.","operationId":"get_quota_quota__get","summary":"Get Quota"}}},"components":{"schemas":{"QuotaItem":{"properties":{"description":{"title":"Description","type":"string"},"name":{"title":"Name","type":"string"},"unit":{"title":"Unit","type":"string"},"usage":{"title":"Usage","type":"integer"},"value":{"title":"Value","type":"integer"}},"required":["name","description","unit","value","usage"],"title":"QuotaItem","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## List Sessions

> Route for chat session management.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/session/":{"get":{"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SessionListResponse"},"title":"Response List Sessions Session  Get","type":"array"}}}},"404":{"description":"Not found"}},"tags":["Copilot"],"description":"Route for chat session management.","operationId":"list_sessions_session__get","summary":"List Sessions"}}},"components":{"schemas":{"SessionListResponse":{"description":"Session list response model","properties":{"agent_config":{"title":"Agent Config","type":"object"},"agent_id":{"title":"Agent Id"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"summary":{"title":"Summary"}},"required":["id","summary","agent_id","agent_config","created_on"],"title":"SessionListResponse","type":"object"}}}}
```

## Create Session

> Route for creating a new chat session.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/session/":{"post":{"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionPublic"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Route for creating a new chat session.","operationId":"create_session_session__post","summary":"Create Session","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionCreateRequest"}}},"required":true}}}},"components":{"schemas":{"SessionPublic":{"description":"Public session model","properties":{"agent_config":{"title":"Agent Config","type":"object"},"agent_id":{"title":"Agent Id"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"entries":{"items":{"$ref":"#/components/schemas/SessionEntryPublic"},"title":"Entries","type":"array"},"id":{"format":"uuid","title":"Id","type":"string"},"summary":{"title":"Summary"}},"required":["id","summary","agent_id","agent_config","created_on","entries"],"title":"SessionPublic","type":"object"},"SessionEntryPublic":{"description":"Public session entry model","properties":{"chat":{"$ref":"#/components/schemas/Chat"},"confidence":{"title":"Confidence"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"feedback":{},"id":{"format":"uuid","title":"Id","type":"string"}},"required":["id","confidence","created_on","chat","feedback"],"title":"SessionEntryPublic","type":"object"},"Chat":{"description":"Response for the app chat API.","properties":{"prompt":{"title":"Prompt","type":"string"},"response":{"$ref":"#/components/schemas/LlamaResponse"}},"required":["prompt","response"],"title":"Chat","type":"object"},"LlamaResponse":{"description":"Response for the app chat API.","properties":{"col_keys":{"items":{"type":"string"},"title":"Col Keys","type":"array"},"content":{"title":"Content"},"error_text":{"title":"Error Text","type":"string"},"sql_text":{"title":"Sql Text","type":"string"}},"required":["content","sql_text","error_text","col_keys"],"title":"LlamaResponse","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"SessionCreateRequest":{"description":"Request for creating a new session","properties":{"agent_id":{"format":"uuid","title":"Agent Id","type":"string"},"chat":{},"config":{"additionalProperties":{"type":"string"},"default":{},"title":"Config","type":"object"}},"required":["agent_id"],"title":"SessionCreateRequest","type":"object"}}}}
```

## Get Session

> Retrieve a chat session

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/session/{session_id}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"session_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionPublic"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Retrieve a chat session","operationId":"get_session_session__session_id__get","summary":"Get Session"}}},"components":{"schemas":{"SessionPublic":{"description":"Public session model","properties":{"agent_config":{"title":"Agent Config","type":"object"},"agent_id":{"title":"Agent Id"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"entries":{"items":{"$ref":"#/components/schemas/SessionEntryPublic"},"title":"Entries","type":"array"},"id":{"format":"uuid","title":"Id","type":"string"},"summary":{"title":"Summary"}},"required":["id","summary","agent_id","agent_config","created_on","entries"],"title":"SessionPublic","type":"object"},"SessionEntryPublic":{"description":"Public session entry model","properties":{"chat":{"$ref":"#/components/schemas/Chat"},"confidence":{"title":"Confidence"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"feedback":{},"id":{"format":"uuid","title":"Id","type":"string"}},"required":["id","confidence","created_on","chat","feedback"],"title":"SessionEntryPublic","type":"object"},"Chat":{"description":"Response for the app chat API.","properties":{"prompt":{"title":"Prompt","type":"string"},"response":{"$ref":"#/components/schemas/LlamaResponse"}},"required":["prompt","response"],"title":"Chat","type":"object"},"LlamaResponse":{"description":"Response for the app chat API.","properties":{"col_keys":{"items":{"type":"string"},"title":"Col Keys","type":"array"},"content":{"title":"Content"},"error_text":{"title":"Error Text","type":"string"},"sql_text":{"title":"Sql Text","type":"string"}},"required":["content","sql_text","error_text","col_keys"],"title":"LlamaResponse","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Update Session

> Update a chat session

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/session/{session_id}":{"put":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"session_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionPublic"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"deprecated":true,"description":"Update a chat session","operationId":"update_session_session__session_id__put","summary":"Update Session","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionChatRequest"}}},"required":true}}}},"components":{"schemas":{"SessionPublic":{"description":"Public session model","properties":{"agent_config":{"title":"Agent Config","type":"object"},"agent_id":{"title":"Agent Id"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"entries":{"items":{"$ref":"#/components/schemas/SessionEntryPublic"},"title":"Entries","type":"array"},"id":{"format":"uuid","title":"Id","type":"string"},"summary":{"title":"Summary"}},"required":["id","summary","agent_id","agent_config","created_on","entries"],"title":"SessionPublic","type":"object"},"SessionEntryPublic":{"description":"Public session entry model","properties":{"chat":{"$ref":"#/components/schemas/Chat"},"confidence":{"title":"Confidence"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"feedback":{},"id":{"format":"uuid","title":"Id","type":"string"}},"required":["id","confidence","created_on","chat","feedback"],"title":"SessionEntryPublic","type":"object"},"Chat":{"description":"Response for the app chat API.","properties":{"prompt":{"title":"Prompt","type":"string"},"response":{"$ref":"#/components/schemas/LlamaResponse"}},"required":["prompt","response"],"title":"Chat","type":"object"},"LlamaResponse":{"description":"Response for the app chat API.","properties":{"col_keys":{"items":{"type":"string"},"title":"Col Keys","type":"array"},"content":{"title":"Content"},"error_text":{"title":"Error Text","type":"string"},"sql_text":{"title":"Sql Text","type":"string"}},"required":["content","sql_text","error_text","col_keys"],"title":"LlamaResponse","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"SessionChatRequest":{"description":"Request for chatting with a session","properties":{"prompt":{"title":"Prompt","type":"string"}},"required":["prompt"],"title":"SessionChatRequest","type":"object"}}}}
```

## Delete Session

> Delete a chat session

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/session/{session_id}":{"delete":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"session_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Delete a chat session","operationId":"delete_session_session__session_id__delete","summary":"Delete Session"}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Add Session Entry

> Add a chat entry to a session

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/session/{session_id}/entry":{"post":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"session_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionEntryPublic"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Add a chat entry to a session","operationId":"add_session_entry_session__session_id__entry_post","summary":"Add Session Entry","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionChatRequest"}}},"required":true}}}},"components":{"schemas":{"SessionEntryPublic":{"description":"Public session entry model","properties":{"chat":{"$ref":"#/components/schemas/Chat"},"confidence":{"title":"Confidence"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"feedback":{},"id":{"format":"uuid","title":"Id","type":"string"}},"required":["id","confidence","created_on","chat","feedback"],"title":"SessionEntryPublic","type":"object"},"Chat":{"description":"Response for the app chat API.","properties":{"prompt":{"title":"Prompt","type":"string"},"response":{"$ref":"#/components/schemas/LlamaResponse"}},"required":["prompt","response"],"title":"Chat","type":"object"},"LlamaResponse":{"description":"Response for the app chat API.","properties":{"col_keys":{"items":{"type":"string"},"title":"Col Keys","type":"array"},"content":{"title":"Content"},"error_text":{"title":"Error Text","type":"string"},"sql_text":{"title":"Sql Text","type":"string"}},"required":["content","sql_text","error_text","col_keys"],"title":"LlamaResponse","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"SessionChatRequest":{"description":"Request for chatting with a session","properties":{"prompt":{"title":"Prompt","type":"string"}},"required":["prompt"],"title":"SessionChatRequest","type":"object"}}}}
```

## Delete Session Entry

> Delete all chat entries from a session

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/session/{session_id}/entry":{"delete":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"session_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Delete all chat entries from a session","operationId":"delete_session_entry_session__session_id__entry_delete","summary":"Delete Session Entry"}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Patch Session Entry

> Patch a chat entry in a session

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"servers":[{"url":"https://api.skysql.com/"}],"paths":{"/copilot/v1/session/{session_id}/entry/{entry_id}":{"patch":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"session_id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"entry_id","required":true}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionEntryPublic"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Copilot"],"description":"Patch a chat entry in a session","operationId":"patch_session_entry_session__session_id__entry__entry_id__patch","summary":"Patch Session Entry","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionEntryPatchRequest"}}},"required":true}}}},"components":{"schemas":{"SessionEntryPublic":{"description":"Public session entry model","properties":{"chat":{"$ref":"#/components/schemas/Chat"},"confidence":{"title":"Confidence"},"created_on":{"format":"date-time","title":"Created On","type":"string"},"feedback":{},"id":{"format":"uuid","title":"Id","type":"string"}},"required":["id","confidence","created_on","chat","feedback"],"title":"SessionEntryPublic","type":"object"},"Chat":{"description":"Response for the app chat API.","properties":{"prompt":{"title":"Prompt","type":"string"},"response":{"$ref":"#/components/schemas/LlamaResponse"}},"required":["prompt","response"],"title":"Chat","type":"object"},"LlamaResponse":{"description":"Response for the app chat API.","properties":{"col_keys":{"items":{"type":"string"},"title":"Col Keys","type":"array"},"content":{"title":"Content"},"error_text":{"title":"Error Text","type":"string"},"sql_text":{"title":"Sql Text","type":"string"}},"required":["content","sql_text","error_text","col_keys"],"title":"LlamaResponse","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"SessionEntryPatchRequest":{"description":"Request for patching a session entry","properties":{"chat":{},"feedback":{}},"title":"SessionEntryPatchRequest","type":"object"}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mariadb.com/docs/mariadb-cloud/reference/mariadb-cloud-api-reference-guide/copilot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.