# 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"}}}}
```