データベース

SQL データベース接続の作成

POST /api/sql-databases/

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	必須	このデータベース接続の表示名
description	string	任意	データベースとその用途の説明
databaseType	object	必須	データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	任意	外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。
includeTables	object	任意	対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されません
chatbots	array[IdName]	任意
groups	array[IdName]	任意

リクエスト構造の例

{
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "chatbots"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
  "groups"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
}

リクエストの値の例

{
  "name": "サンプル名",
  "description": "サンプル文字列",
  "databaseType": {},
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true,
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/sql-databases/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "description": "サンプル文字列",
    "databaseType": {},
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true,
    "chatbots": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "groups": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 201

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "status": 
  {
  }
  "deletedAt": string (timestamp)
  "tables": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "chatbots": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "groups": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
  "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "description": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "status": {},
  "deletedAt": "レスポンス文字列",
  "tables": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "canUpdate": false,
  "canDelete": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

SQL データベース接続の作成

POST /api/v1/sql-databases/

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	必須	このデータベース接続の表示名
description	string	任意	データベースとその用途の説明
databaseType	object	必須	データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	任意	外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。
includeTables	object	任意	対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されません
chatbots	array[IdName]	任意
groups	array[IdName]	任意

リクエスト構造の例

{
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "chatbots"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
  "groups"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
}

リクエストの値の例

{
  "name": "サンプル名",
  "description": "サンプル文字列",
  "databaseType": {},
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true,
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/v1/sql-databases/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "description": "サンプル文字列",
    "databaseType": {},
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true,
    "chatbots": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "groups": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 201

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "status": 
  {
  }
  "deletedAt": string (timestamp)
  "tables": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "chatbots": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "groups": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
  "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "description": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "status": {},
  "deletedAt": "レスポンス文字列",
  "tables": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "canUpdate": false,
  "canDelete": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

SQL データベースの一覧取得

GET /api/sql-databases/

パラメータ

パラメータ名	必須	タイプ	説明
databaseType	❌	string	データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent `postgresql`: PostgreSQL ; `mysql`: MySQL ; `maiagent`: MaiAgent ; `oracle`: Oracle ; `mssql`: MSSQL;
isActive	❌	boolean
isExternal	❌	boolean
page	❌	integer	A page number within the paginated result set.
pageSize	❌	integer	Number of results to return per page.
query	❌	string

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/sql-databases/?databaseType=maiagent&isActive=true&isExternal=true&page=1&pageSize=1&query=example" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "count": integer
  "next"?: string (uri) // 任意
  "previous"?: string (uri) // 任意
  "results": [
    {
      "id": string (uuid)
      "name": string // このデータベース接続の表示名
      "description"?: string // データベースとその用途の説明 (任意)
      "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
      {
      }
      "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
      "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
      "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
      "status": 
      {
      }
      "deletedAt": string (timestamp)
      "tables": [
        {
          "id": string (uuid)
          "tableName": string // データベース内のテーブル名
          "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
          "status": 
          {
          }
          "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
          "sourceFile": 
          {
            "id": string (uuid)
            "name": string
            "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
          }
          "columns": [
            {
              "id": string (uuid)
              "columnName": string
              "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
              "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
              "isPrimaryKey"?: boolean // 任意
              "isNullable"?: boolean // 任意
              "createdAt": string (timestamp)
              "updatedAt": string (timestamp)
            }
          ]
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "chatbots": [
        {
          "id": string (uuid)
          "name": string
        }
      ]
      "groups": [
        {
          "id": string (uuid)
          "name": string
        }
      ]
      "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
      "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
}

レスポンスの値の例

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列",
      "description": "レスポンス文字列",
      "databaseType": {},
      "databaseUrl": "レスポンス文字列",
      "includeTables": null,
      "isActive": false,
      "status": {},
      "deletedAt": "レスポンス文字列",
      "tables": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "tableName": "レスポンス文字列",
          "description": "レスポンス文字列",
          "status": {},
          "errorMessage": "レスポンス文字列",
          "sourceFile": {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "name": "レスポンス文字列",
            "isFromKnowledgeBase": false
          },
          "columns": [
            {
              "id": "550e8400-e29b-41d4-a716-446655440000",
              "columnName": "レスポンス文字列",
              "columnType": "レスポンス文字列",
              "description": "レスポンス文字列",
              "isPrimaryKey": false,
              "isNullable": false,
              "createdAt": "レスポンス文字列",
              "updatedAt": "レスポンス文字列"
            }
          ],
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "chatbots": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "レスポンス文字列"
        }
      ],
      "groups": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "レスポンス文字列"
        }
      ],
      "canUpdate": false,
      "canDelete": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ]
}

---

SQL データベースの一覧取得

GET /api/v1/sql-databases/

パラメータ

パラメータ名	必須	タイプ	説明
databaseType	❌	string	データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent `postgresql`: PostgreSQL ; `mysql`: MySQL ; `maiagent`: MaiAgent ; `oracle`: Oracle ; `mssql`: MSSQL;
isActive	❌	boolean
isExternal	❌	boolean
page	❌	integer	A page number within the paginated result set.
pageSize	❌	integer	Number of results to return per page.
query	❌	string

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/sql-databases/?databaseType=maiagent&isActive=true&isExternal=true&page=1&pageSize=1&query=example" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "count": integer
  "next"?: string (uri) // 任意
  "previous"?: string (uri) // 任意
  "results": [
    {
      "id": string (uuid)
      "name": string // このデータベース接続の表示名
      "description"?: string // データベースとその用途の説明 (任意)
      "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
      {
      }
      "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
      "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
      "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
      "status": 
      {
      }
      "deletedAt": string (timestamp)
      "tables": [
        {
          "id": string (uuid)
          "tableName": string // データベース内のテーブル名
          "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
          "status": 
          {
          }
          "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
          "sourceFile": 
          {
            "id": string (uuid)
            "name": string
            "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
          }
          "columns": [
            {
              "id": string (uuid)
              "columnName": string
              "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
              "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
              "isPrimaryKey"?: boolean // 任意
              "isNullable"?: boolean // 任意
              "createdAt": string (timestamp)
              "updatedAt": string (timestamp)
            }
          ]
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "chatbots": [
        {
          "id": string (uuid)
          "name": string
        }
      ]
      "groups": [
        {
          "id": string (uuid)
          "name": string
        }
      ]
      "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
      "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
}

レスポンスの値の例

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列",
      "description": "レスポンス文字列",
      "databaseType": {},
      "databaseUrl": "レスポンス文字列",
      "includeTables": null,
      "isActive": false,
      "status": {},
      "deletedAt": "レスポンス文字列",
      "tables": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "tableName": "レスポンス文字列",
          "description": "レスポンス文字列",
          "status": {},
          "errorMessage": "レスポンス文字列",
          "sourceFile": {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "name": "レスポンス文字列",
            "isFromKnowledgeBase": false
          },
          "columns": [
            {
              "id": "550e8400-e29b-41d4-a716-446655440000",
              "columnName": "レスポンス文字列",
              "columnType": "レスポンス文字列",
              "description": "レスポンス文字列",
              "isPrimaryKey": false,
              "isNullable": false,
              "createdAt": "レスポンス文字列",
              "updatedAt": "レスポンス文字列"
            }
          ],
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "chatbots": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "レスポンス文字列"
        }
      ],
      "groups": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "レスポンス文字列"
        }
      ],
      "canUpdate": false,
      "canDelete": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ]
}

---

特定の SQL データベースの取得

GET /api/sql-databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/sql-databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "status": 
  {
  }
  "deletedAt": string (timestamp)
  "tables": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "chatbots": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "groups": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
  "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "description": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "status": {},
  "deletedAt": "レスポンス文字列",
  "tables": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "canUpdate": false,
  "canDelete": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

特定の SQL データベースの取得

GET /api/v1/sql-databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/sql-databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "status": 
  {
  }
  "deletedAt": string (timestamp)
  "tables": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "chatbots": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "groups": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
  "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "description": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "status": {},
  "deletedAt": "レスポンス文字列",
  "tables": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "canUpdate": false,
  "canDelete": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

SQL データベースの更新

PUT /api/sql-databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	必須	このデータベース接続の表示名
description	string	任意	データベースとその用途の説明
databaseUrl	string	任意	外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。
includeTables	object	任意	対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されません
chatbots	array[IdName]	任意
groups	array[IdName]	任意

リクエスト構造の例

{
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "chatbots"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
  "groups"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
}

リクエストの値の例

{
  "name": "サンプル名",
  "description": "サンプル文字列",
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true,
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PUT "https://api.maiagent.ai/api/sql-databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "description": "サンプル文字列",
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true,
    "chatbots": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "groups": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "status": 
  {
  }
  "deletedAt": string (timestamp)
  "tables": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "chatbots": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "groups": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
  "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "description": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "status": {},
  "deletedAt": "レスポンス文字列",
  "tables": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "canUpdate": false,
  "canDelete": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

SQL データベースの更新

PUT /api/v1/sql-databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	必須	このデータベース接続の表示名
description	string	任意	データベースとその用途の説明
databaseUrl	string	任意	外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。
includeTables	object	任意	対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されません
chatbots	array[IdName]	任意
groups	array[IdName]	任意

リクエスト構造の例

{
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "chatbots"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
  "groups"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
}

リクエストの値の例

{
  "name": "サンプル名",
  "description": "サンプル文字列",
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true,
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PUT "https://api.maiagent.ai/api/v1/sql-databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "description": "サンプル文字列",
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true,
    "chatbots": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "groups": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "status": 
  {
  }
  "deletedAt": string (timestamp)
  "tables": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "chatbots": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "groups": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
  "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "description": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "status": {},
  "deletedAt": "レスポンス文字列",
  "tables": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "canUpdate": false,
  "canDelete": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

SQL データベースの部分更新

PATCH /api/sql-databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	任意	このデータベース接続の表示名
description	string	任意	データベースとその用途の説明
databaseUrl	string	任意	外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。
includeTables	object	任意	対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されません
chatbots	array[IdName]	任意
groups	array[IdName]	任意

リクエスト構造の例

{
  "name"?: string // このデータベース接続の表示名 (任意)
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "chatbots"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
  "groups"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
}

リクエストの値の例

{
  "name": "サンプル名",
  "description": "サンプル文字列",
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true,
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PATCH "https://api.maiagent.ai/api/sql-databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "description": "サンプル文字列",
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true,
    "chatbots": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "groups": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "status": 
  {
  }
  "deletedAt": string (timestamp)
  "tables": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "chatbots": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "groups": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
  "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "description": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "status": {},
  "deletedAt": "レスポンス文字列",
  "tables": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "canUpdate": false,
  "canDelete": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

SQL データベースの部分更新

PATCH /api/v1/sql-databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	任意	このデータベース接続の表示名
description	string	任意	データベースとその用途の説明
databaseUrl	string	任意	外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。
includeTables	object	任意	対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されません
chatbots	array[IdName]	任意
groups	array[IdName]	任意

リクエスト構造の例

{
  "name"?: string // このデータベース接続の表示名 (任意)
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "chatbots"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
  "groups"?: [ // 任意
    {
      "id": string (uuid)
    }
  ]
}

リクエストの値の例

{
  "name": "サンプル名",
  "description": "サンプル文字列",
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true,
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PATCH "https://api.maiagent.ai/api/v1/sql-databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "description": "サンプル文字列",
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true,
    "chatbots": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "groups": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // このデータベース接続の表示名
  "description"?: string // データベースとその用途の説明 (任意)
  "databaseType":  // データベースのタイプ: PostgreSQL、MySQL、MSSQL、Oracle、または MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl"?: string // 外部データベースの接続文字列です。MaiAgent タイプではシステムの既定値を使用するため不要です。 (任意)
  "includeTables"?: object // 対象に含めるテーブルのリスト（任意）。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプでは、アップロードされたファイルから自動的に設定されます。 (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されません (任意)
  "status": 
  {
  }
  "deletedAt": string (timestamp)
  "tables": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "chatbots": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "groups": [
    {
      "id": string (uuid)
      "name": string
    }
  ]
  "canUpdate": boolean // 現在のユーザーがこのリソースを更新できるかどうかを返します。
  "canDelete": boolean // 現在のユーザーがこのリソースを削除できるかどうかを返します。
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "description": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "status": {},
  "deletedAt": "レスポンス文字列",
  "tables": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "chatbots": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列"
    }
  ],
  "canUpdate": false,
  "canDelete": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

SQL データベースの削除

DELETE /api/sql-databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X DELETE "https://api.maiagent.ai/api/sql-databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---

SQL データベースの削除

DELETE /api/v1/sql-databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X DELETE "https://api.maiagent.ai/api/v1/sql-databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---

データベース接続のテスト

POST /api/sql-databases/{id}/test-connection/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
databaseType	string (enum: postgresql, mysql, maiagent, oracle, mssql)	必須	postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	必須

リクエスト構造の例

{
  "databaseType": string (enum: postgresql, mysql, maiagent, oracle, mssql) // * `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  "databaseUrl": string
}

リクエストの値の例

{
  "databaseType": "postgresql",
  "databaseUrl": "サンプル文字列"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/sql-databases/550e8400-e29b-41d4-a716-446655440000/test-connection/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "databaseType": "postgresql",
    "databaseUrl": "サンプル文字列"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "success"?: boolean // 任意
  "message"?: string // 任意
}

レスポンスの値の例

{
  "success": false,
  "message": "レスポンス文字列"
}

---

データベース接続のテスト

POST /api/v1/sql-databases/{id}/test-connection/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
databaseType	string (enum: postgresql, mysql, maiagent, oracle, mssql)	必須	postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	必須

リクエスト構造の例

{
  "databaseType": string (enum: postgresql, mysql, maiagent, oracle, mssql) // * `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  "databaseUrl": string
}

リクエストの値の例

{
  "databaseType": "postgresql",
  "databaseUrl": "サンプル文字列"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/v1/sql-databases/550e8400-e29b-41d4-a716-446655440000/test-connection/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "databaseType": "postgresql",
    "databaseUrl": "サンプル文字列"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "success"?: boolean // 任意
  "message"?: string // 任意
}

レスポンスの値の例

{
  "success": false,
  "message": "レスポンス文字列"
}

---

データベースへのファイルアップロード

POST /api/sql-databases/{id}/upload-files/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
files	array[object]	必須

リクエスト構造の例

{
  "files": [
    {
      "file": string // 署名付き URL アップロードによるファイルパス（例: media/chatbotfiles/xxx/file.csv）
      "filename": string // 元のファイル名
      "size": integer // ファイルサイズ（バイト）
    }
  ]
}

リクエストの値の例

{
  "files": [
    {
      "file": "media/chatbotfiles/xxx/data.csv",
      "filename": "data.csv",
      "size": 1024
    },
    {
      "file": "media/chatbotfiles/xxx/report.xlsx",
      "filename": "report.xlsx",
      "size": 2048
    }
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/sql-databases/550e8400-e29b-41d4-a716-446655440000/upload-files/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {
        "file": "media/chatbotfiles/xxx/data.csv",
        "filename": "data.csv",
        "size": 1024
      },
      {
        "file": "media/chatbotfiles/xxx/report.xlsx",
        "filename": "report.xlsx",
        "size": 2048
      }
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 201

レスポンス構造の例

{
  "message"?: string // 任意
  "filesCount"?: integer // 任意
  "fileIds"?: [ // 任意
    string (uuid)
  ]
}

レスポンスの値の例

{
  "message": "レスポンス文字列",
  "filesCount": 456,
  "fileIds": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
}

---

データベースへのファイルアップロード

POST /api/v1/sql-databases/{id}/upload-files/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この SQL データベースを識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
files	array[object]	必須

リクエスト構造の例

{
  "files": [
    {
      "file": string // 署名付き URL アップロードによるファイルパス（例: media/chatbotfiles/xxx/file.csv）
      "filename": string // 元のファイル名
      "size": integer // ファイルサイズ（バイト）
    }
  ]
}

リクエストの値の例

{
  "files": [
    {
      "file": "media/chatbotfiles/xxx/data.csv",
      "filename": "data.csv",
      "size": 1024
    },
    {
      "file": "media/chatbotfiles/xxx/report.xlsx",
      "filename": "report.xlsx",
      "size": 2048
    }
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/v1/sql-databases/550e8400-e29b-41d4-a716-446655440000/upload-files/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {
        "file": "media/chatbotfiles/xxx/data.csv",
        "filename": "data.csv",
        "size": 1024
      },
      {
        "file": "media/chatbotfiles/xxx/report.xlsx",
        "filename": "report.xlsx",
        "size": 2048
      }
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 201

レスポンス構造の例

{
  "message"?: string // 任意
  "filesCount"?: integer // 任意
  "fileIds"?: [ // 任意
    string (uuid)
  ]
}

レスポンスの値の例

{
  "message": "レスポンス文字列",
  "filesCount": 456,
  "fileIds": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
}

---

SQL データベースの一括削除

POST /api/sql-databases/batch-delete/

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
ids	array[string]	必須

リクエスト構造の例

{
  "ids": [
    string (uuid)
  ]
}

リクエストの値の例

{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/sql-databases/batch-delete/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "550e8400-e29b-41d4-a716-446655440000"
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---

SQL データベースの一括削除

POST /api/v1/sql-databases/batch-delete/

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
ids	array[string]	必須

リクエスト構造の例

{
  "ids": [
    string (uuid)
  ]
}

リクエストの値の例

{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/v1/sql-databases/batch-delete/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "550e8400-e29b-41d4-a716-446655440000"
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---

データテーブルの一覧取得

GET /api/sql-databases/{sqlDatabasePk}/tables/

パラメータ

パラメータ名	必須	タイプ	説明
sqlDatabasePk	✅	string
page	❌	integer	A page number within the paginated result set.
pageSize	❌	integer	Number of results to return per page.
query	❌	string
status	❌	string	`pending`: Pending ; `processing`: Processing ; `success`: Success ; `failed`: Failed ; `dropping`: Dropping ; `drop_failed`: Drop Failed;

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/?page=1&pageSize=1&query=example&status=drop_failed" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "count": integer
  "next"?: string (uri) // 任意
  "previous"?: string (uri) // 任意
  "results": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
}

レスポンスの値の例

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ]
}

---

データテーブルの一覧取得

GET /api/v1/sql-databases/{sqlDatabasePk}/tables/

パラメータ

パラメータ名	必須	タイプ	説明
sqlDatabasePk	✅	string
page	❌	integer	A page number within the paginated result set.
pageSize	❌	integer	Number of results to return per page.
query	❌	string
status	❌	string	`pending`: Pending ; `processing`: Processing ; `success`: Success ; `failed`: Failed ; `dropping`: Dropping ; `drop_failed`: Drop Failed;

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/?page=1&pageSize=1&query=example&status=drop_failed" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "count": integer
  "next"?: string (uri) // 任意
  "previous"?: string (uri) // 任意
  "results": [
    {
      "id": string (uuid)
      "tableName": string // データベース内のテーブル名
      "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
      "status": 
      {
      }
      "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
      "sourceFile": 
      {
        "id": string (uuid)
        "name": string
        "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
      }
      "columns": [
        {
          "id": string (uuid)
          "columnName": string
          "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
          "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
          "isPrimaryKey"?: boolean // 任意
          "isNullable"?: boolean // 任意
          "createdAt": string (timestamp)
          "updatedAt": string (timestamp)
        }
      ]
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
}

レスポンスの値の例

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tableName": "レスポンス文字列",
      "description": "レスポンス文字列",
      "status": {},
      "errorMessage": "レスポンス文字列",
      "sourceFile": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "レスポンス文字列",
        "isFromKnowledgeBase": false
      },
      "columns": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "columnName": "レスポンス文字列",
          "columnType": "レスポンス文字列",
          "description": "レスポンス文字列",
          "isPrimaryKey": false,
          "isNullable": false,
          "createdAt": "レスポンス文字列",
          "updatedAt": "レスポンス文字列"
        }
      ],
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ]
}

---

データテーブルの作成

POST /api/sql-databases/{sqlDatabasePk}/tables/

パラメータ

パラメータ名	必須	タイプ	説明
sqlDatabasePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
tableName	string	必須	データベース内のテーブル名
description	string	任意	Text-to-SQL の理解を高めるための、テーブルとそのデータの説明

リクエスト構造の例

{
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
}

リクエストの値の例

{
  "tableName": "サンプル文字列",
  "description": "サンプル文字列"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tableName": "サンプル文字列",
    "description": "サンプル文字列"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 201

レスポンス構造の例

{
  "id": string (uuid)
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
  "status": 
  {
  }
  "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
  "sourceFile": 
  {
    "id": string (uuid)
    "name": string
    "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
  }
  "columns": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tableName": "レスポンス文字列",
  "description": "レスポンス文字列",
  "status": {},
  "errorMessage": "レスポンス文字列",
  "sourceFile": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "レスポンス文字列",
    "isFromKnowledgeBase": false
  },
  "columns": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データテーブルの作成

POST /api/v1/sql-databases/{sqlDatabasePk}/tables/

パラメータ

パラメータ名	必須	タイプ	説明
sqlDatabasePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
tableName	string	必須	データベース内のテーブル名
description	string	任意	Text-to-SQL の理解を高めるための、テーブルとそのデータの説明

リクエスト構造の例

{
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
}

リクエストの値の例

{
  "tableName": "サンプル文字列",
  "description": "サンプル文字列"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tableName": "サンプル文字列",
    "description": "サンプル文字列"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 201

レスポンス構造の例

{
  "id": string (uuid)
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
  "status": 
  {
  }
  "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
  "sourceFile": 
  {
    "id": string (uuid)
    "name": string
    "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
  }
  "columns": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tableName": "レスポンス文字列",
  "description": "レスポンス文字列",
  "status": {},
  "errorMessage": "レスポンス文字列",
  "sourceFile": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "レスポンス文字列",
    "isFromKnowledgeBase": false
  },
  "columns": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

特定のデータテーブルの取得

GET /api/sql-databases/{sqlDatabasePk}/tables/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルを識別する UUID 文字列です。
sqlDatabasePk	✅	string

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
  "status": 
  {
  }
  "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
  "sourceFile": 
  {
    "id": string (uuid)
    "name": string
    "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
  }
  "columns": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tableName": "レスポンス文字列",
  "description": "レスポンス文字列",
  "status": {},
  "errorMessage": "レスポンス文字列",
  "sourceFile": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "レスポンス文字列",
    "isFromKnowledgeBase": false
  },
  "columns": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

特定のデータテーブルの取得

GET /api/v1/sql-databases/{sqlDatabasePk}/tables/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルを識別する UUID 文字列です。
sqlDatabasePk	✅	string

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
  "status": 
  {
  }
  "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
  "sourceFile": 
  {
    "id": string (uuid)
    "name": string
    "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
  }
  "columns": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tableName": "レスポンス文字列",
  "description": "レスポンス文字列",
  "status": {},
  "errorMessage": "レスポンス文字列",
  "sourceFile": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "レスポンス文字列",
    "isFromKnowledgeBase": false
  },
  "columns": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データテーブルの更新

PUT /api/sql-databases/{sqlDatabasePk}/tables/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルを識別する UUID 文字列です。
sqlDatabasePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
tableName	string	必須	データベース内のテーブル名
description	string	任意	Text-to-SQL の理解を高めるための、テーブルとそのデータの説明

リクエスト構造の例

{
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
}

リクエストの値の例

{
  "tableName": "サンプル文字列",
  "description": "サンプル文字列"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PUT "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tableName": "サンプル文字列",
    "description": "サンプル文字列"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
  "status": 
  {
  }
  "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
  "sourceFile": 
  {
    "id": string (uuid)
    "name": string
    "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
  }
  "columns": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tableName": "レスポンス文字列",
  "description": "レスポンス文字列",
  "status": {},
  "errorMessage": "レスポンス文字列",
  "sourceFile": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "レスポンス文字列",
    "isFromKnowledgeBase": false
  },
  "columns": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データテーブルの更新

PUT /api/v1/sql-databases/{sqlDatabasePk}/tables/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルを識別する UUID 文字列です。
sqlDatabasePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
tableName	string	必須	データベース内のテーブル名
description	string	任意	Text-to-SQL の理解を高めるための、テーブルとそのデータの説明

リクエスト構造の例

{
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
}

リクエストの値の例

{
  "tableName": "サンプル文字列",
  "description": "サンプル文字列"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PUT "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tableName": "サンプル文字列",
    "description": "サンプル文字列"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
  "status": 
  {
  }
  "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
  "sourceFile": 
  {
    "id": string (uuid)
    "name": string
    "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
  }
  "columns": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tableName": "レスポンス文字列",
  "description": "レスポンス文字列",
  "status": {},
  "errorMessage": "レスポンス文字列",
  "sourceFile": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "レスポンス文字列",
    "isFromKnowledgeBase": false
  },
  "columns": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データテーブルの部分更新

PATCH /api/sql-databases/{sqlDatabasePk}/tables/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルを識別する UUID 文字列です。
sqlDatabasePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
tableName	string	任意	データベース内のテーブル名
description	string	任意	Text-to-SQL の理解を高めるための、テーブルとそのデータの説明

リクエスト構造の例

{
  "tableName"?: string // データベース内のテーブル名 (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
}

リクエストの値の例

{
  "tableName": "サンプル文字列",
  "description": "サンプル文字列"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PATCH "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tableName": "サンプル文字列",
    "description": "サンプル文字列"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
  "status": 
  {
  }
  "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
  "sourceFile": 
  {
    "id": string (uuid)
    "name": string
    "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
  }
  "columns": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tableName": "レスポンス文字列",
  "description": "レスポンス文字列",
  "status": {},
  "errorMessage": "レスポンス文字列",
  "sourceFile": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "レスポンス文字列",
    "isFromKnowledgeBase": false
  },
  "columns": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データテーブルの部分更新

PATCH /api/v1/sql-databases/{sqlDatabasePk}/tables/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルを識別する UUID 文字列です。
sqlDatabasePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
tableName	string	任意	データベース内のテーブル名
description	string	任意	Text-to-SQL の理解を高めるための、テーブルとそのデータの説明

リクエスト構造の例

{
  "tableName"?: string // データベース内のテーブル名 (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
}

リクエストの値の例

{
  "tableName": "サンプル文字列",
  "description": "サンプル文字列"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PATCH "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tableName": "サンプル文字列",
    "description": "サンプル文字列"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "tableName": string // データベース内のテーブル名
  "description"?: string // Text-to-SQL の理解を高めるための、テーブルとそのデータの説明 (任意)
  "status": 
  {
  }
  "errorMessage": string // テーブルの作成または削除が失敗した場合のエラー詳細
  "sourceFile": 
  {
    "id": string (uuid)
    "name": string
    "isFromKnowledgeBase": boolean // ソースファイルがナレッジベースのアップロード由来かどうかを判定します。

ファイルがナレッジベース経由でアップロードされた場合は True を、
データベースに直接アップロードされた場合は False を返します。
  }
  "columns": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tableName": "レスポンス文字列",
  "description": "レスポンス文字列",
  "status": {},
  "errorMessage": "レスポンス文字列",
  "sourceFile": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "レスポンス文字列",
    "isFromKnowledgeBase": false
  },
  "columns": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ],
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データテーブルの削除

DELETE /api/sql-databases/{sqlDatabasePk}/tables/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルを識別する UUID 文字列です。
sqlDatabasePk	✅	string

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X DELETE "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---

データテーブルの削除

DELETE /api/v1/sql-databases/{sqlDatabasePk}/tables/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルを識別する UUID 文字列です。
sqlDatabasePk	✅	string

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X DELETE "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---

データテーブルの一括削除

POST /api/sql-databases/{sqlDatabasePk}/tables/batch-delete/

パラメータ

パラメータ名	必須	タイプ	説明
sqlDatabasePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
ids	array[string]	必須

リクエスト構造の例

{
  "ids": [
    string (uuid)
  ]
}

リクエストの値の例

{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/batch-delete/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "550e8400-e29b-41d4-a716-446655440000"
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---

データテーブルの一括削除

POST /api/v1/sql-databases/{sqlDatabasePk}/tables/batch-delete/

パラメータ

パラメータ名	必須	タイプ	説明
sqlDatabasePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
ids	array[string]	必須

リクエスト構造の例

{
  "ids": [
    string (uuid)
  ]
}

リクエストの値の例

{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/batch-delete/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "550e8400-e29b-41d4-a716-446655440000"
    ]
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---

データカラムの一覧取得

GET /api/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/

パラメータ

パラメータ名	必須	タイプ	説明
sqlDatabasePk	✅	string
tablePk	✅	string
page	❌	integer	A page number within the paginated result set.
pageSize	❌	integer	Number of results to return per page.

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/?page=1&pageSize=1" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "count": integer
  "next"?: string (uri) // 任意
  "previous"?: string (uri) // 任意
  "results": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
}

レスポンスの値の例

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ]
}

---

データカラムの一覧取得

GET /api/v1/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/

パラメータ

パラメータ名	必須	タイプ	説明
sqlDatabasePk	✅	string
tablePk	✅	string
page	❌	integer	A page number within the paginated result set.
pageSize	❌	integer	Number of results to return per page.

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/?page=1&pageSize=1" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "count": integer
  "next"?: string (uri) // 任意
  "previous"?: string (uri) // 任意
  "results": [
    {
      "id": string (uuid)
      "columnName": string
      "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
      "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
      "isPrimaryKey"?: boolean // 任意
      "isNullable"?: boolean // 任意
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
}

レスポンスの値の例

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "columnName": "レスポンス文字列",
      "columnType": "レスポンス文字列",
      "description": "レスポンス文字列",
      "isPrimaryKey": false,
      "isNullable": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ]
}

---

特定のデータカラムの取得

GET /api/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルのカラムを識別する UUID 文字列です。
sqlDatabasePk	✅	string
tablePk	✅	string

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "columnName": string
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "columnName": "レスポンス文字列",
  "columnType": "レスポンス文字列",
  "description": "レスポンス文字列",
  "isPrimaryKey": false,
  "isNullable": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

特定のデータカラムの取得

GET /api/v1/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルのカラムを識別する UUID 文字列です。
sqlDatabasePk	✅	string
tablePk	✅	string

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "columnName": string
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "columnName": "レスポンス文字列",
  "columnType": "レスポンス文字列",
  "description": "レスポンス文字列",
  "isPrimaryKey": false,
  "isNullable": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データカラムの更新

PUT /api/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルのカラムを識別する UUID 文字列です。
sqlDatabasePk	✅	string
tablePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
columnName	string	必須
columnType	string	任意	カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP）
description	string	任意	Text-to-SQL の理解を高めるための、カラムの説明
isPrimaryKey	boolean	任意
isNullable	boolean	任意

リクエスト構造の例

{
  "columnName": string
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
}

リクエストの値の例

{
  "columnName": "サンプル文字列",
  "columnType": "サンプル文字列",
  "description": "サンプル文字列",
  "isPrimaryKey": true,
  "isNullable": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PUT "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "columnName": "サンプル文字列",
    "columnType": "サンプル文字列",
    "description": "サンプル文字列",
    "isPrimaryKey": true,
    "isNullable": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "columnName": string
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "columnName": "レスポンス文字列",
  "columnType": "レスポンス文字列",
  "description": "レスポンス文字列",
  "isPrimaryKey": false,
  "isNullable": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データカラムの更新

PUT /api/v1/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルのカラムを識別する UUID 文字列です。
sqlDatabasePk	✅	string
tablePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
columnName	string	必須
columnType	string	任意	カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP）
description	string	任意	Text-to-SQL の理解を高めるための、カラムの説明
isPrimaryKey	boolean	任意
isNullable	boolean	任意

リクエスト構造の例

{
  "columnName": string
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
}

リクエストの値の例

{
  "columnName": "サンプル文字列",
  "columnType": "サンプル文字列",
  "description": "サンプル文字列",
  "isPrimaryKey": true,
  "isNullable": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PUT "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "columnName": "サンプル文字列",
    "columnType": "サンプル文字列",
    "description": "サンプル文字列",
    "isPrimaryKey": true,
    "isNullable": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "columnName": string
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "columnName": "レスポンス文字列",
  "columnType": "レスポンス文字列",
  "description": "レスポンス文字列",
  "isPrimaryKey": false,
  "isNullable": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データカラムの部分更新

PATCH /api/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルのカラムを識別する UUID 文字列です。
sqlDatabasePk	✅	string
tablePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
columnName	string	任意
columnType	string	任意	カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP）
description	string	任意	Text-to-SQL の理解を高めるための、カラムの説明
isPrimaryKey	boolean	任意
isNullable	boolean	任意

リクエスト構造の例

{
  "columnName"?: string // 任意
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
}

リクエストの値の例

{
  "columnName": "サンプル文字列",
  "columnType": "サンプル文字列",
  "description": "サンプル文字列",
  "isPrimaryKey": true,
  "isNullable": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PATCH "https://api.maiagent.ai/api/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "columnName": "サンプル文字列",
    "columnType": "サンプル文字列",
    "description": "サンプル文字列",
    "isPrimaryKey": true,
    "isNullable": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "columnName": string
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "columnName": "レスポンス文字列",
  "columnType": "レスポンス文字列",
  "description": "レスポンス文字列",
  "isPrimaryKey": false,
  "isNullable": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データカラムの部分更新

PATCH /api/v1/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	このデータベーステーブルのカラムを識別する UUID 文字列です。
sqlDatabasePk	✅	string
tablePk	✅	string

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
columnName	string	任意
columnType	string	任意	カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP）
description	string	任意	Text-to-SQL の理解を高めるための、カラムの説明
isPrimaryKey	boolean	任意
isNullable	boolean	任意

リクエスト構造の例

{
  "columnName"?: string // 任意
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
}

リクエストの値の例

{
  "columnName": "サンプル文字列",
  "columnType": "サンプル文字列",
  "description": "サンプル文字列",
  "isPrimaryKey": true,
  "isNullable": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PATCH "https://api.maiagent.ai/api/v1/sql-databases/{sqlDatabasePk}/tables/{tablePk}/columns/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "columnName": "サンプル文字列",
    "columnType": "サンプル文字列",
    "description": "サンプル文字列",
    "isPrimaryKey": true,
    "isNullable": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "columnName": string
  "columnType"?: string // カラムのデータ型（例: VARCHAR、INTEGER、TIMESTAMP） (任意)
  "description"?: string // Text-to-SQL の理解を高めるための、カラムの説明 (任意)
  "isPrimaryKey"?: boolean // 任意
  "isNullable"?: boolean // 任意
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "columnName": "レスポンス文字列",
  "columnType": "レスポンス文字列",
  "description": "レスポンス文字列",
  "isPrimaryKey": false,
  "isNullable": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データベース接続のテスト（汎用）

POST /api/database-connection/test/

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
databaseType	object	必須	データベースのタイプ（MaiAgent 内部利用タイプは含まれません） postgresql: PostgreSQL ; mysql: MySQL ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	必須	データベース接続文字列

リクエスト構造の例

{
  "databaseType":  // データベースのタイプ（MaiAgent 内部利用タイプは含まれません）

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
}

リクエストの値の例

{
  "database_type": "postgresql",
  "database_url": "postgresql://user:password@localhost:5432/dbname"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/database-connection/test/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "database_type": "postgresql",
    "database_url": "postgresql://user:password@localhost:5432/dbname"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "status":  // 接続状態

* `success` - success
* `failed` - failed
  {
  }
  "responseTime"?: number (double) // レスポンス時間（秒） (任意)
  "message"?: string // 成功メッセージ (任意)
  "errorMessage"?: string // エラーメッセージ (任意)
}

レスポンスの値の例

{
  "status": "success",
  "response_time": 0.123,
  "message": "PostgreSQL データベースへの接続に成功しました"
}

ステータスコード: 400

レスポンス構造の例

{
  "detail"?: string // 任意
}

レスポンスの値の例

{
  "status": "success",
  "response_time": 0.123,
  "message": "PostgreSQL データベースへの接続に成功しました"
}

---

データベース接続のテスト（汎用）

POST /api/v1/database-connection/test/

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
databaseType	object	必須	データベースのタイプ（MaiAgent 内部利用タイプは含まれません） postgresql: PostgreSQL ; mysql: MySQL ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	必須	データベース接続文字列

リクエスト構造の例

{
  "databaseType":  // データベースのタイプ（MaiAgent 内部利用タイプは含まれません）

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
}

リクエストの値の例

{
  "database_type": "postgresql",
  "database_url": "postgresql://user:password@localhost:5432/dbname"
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/v1/database-connection/test/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "database_type": "postgresql",
    "database_url": "postgresql://user:password@localhost:5432/dbname"
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "status":  // 接続状態

* `success` - success
* `failed` - failed
  {
  }
  "responseTime"?: number (double) // レスポンス時間（秒） (任意)
  "message"?: string // 成功メッセージ (任意)
  "errorMessage"?: string // エラーメッセージ (任意)
}

レスポンスの値の例

{
  "status": "success",
  "response_time": 0.123,
  "message": "PostgreSQL データベースへの接続に成功しました"
}

ステータスコード: 400

レスポンス構造の例

{
  "detail"?: string // 任意
}

レスポンスの値の例

{
  "status": "success",
  "response_time": 0.123,
  "message": "PostgreSQL データベースへの接続に成功しました"
}

---

データベース接続文字列の例の一覧取得

GET /api/database-examples/

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/database-examples/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

[
  {
    "databaseType"?:  // データベースのタイプの選択肢

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL (任意)
    {
    }
    "databaseTypeExample": string // 例: postgresql://db_user:db_password@db_ip:db_port/db_name
  }
]

レスポンスの値の例

[
  {
    "databaseType": {},
    "databaseTypeExample": "レスポンス文字列"
  }
]

ステータスコード: 401

レスポンス構造の例

{
  "detail"?: string // 任意
}

レスポンスの値の例

{
  "detail": "レスポンス文字列"
}

---

データベース接続文字列の例の一覧取得

GET /api/v1/database-examples/

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/database-examples/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

[
  {
    "databaseType"?:  // データベースのタイプの選択肢

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL (任意)
    {
    }
    "databaseTypeExample": string // 例: postgresql://db_user:db_password@db_ip:db_port/db_name
  }
]

レスポンスの値の例

[
  {
    "databaseType": {},
    "databaseTypeExample": "レスポンス文字列"
  }
]

ステータスコード: 401

レスポンス構造の例

{
  "detail"?: string // 任意
}

レスポンスの値の例

{
  "detail": "レスポンス文字列"
}

---

特定の接続文字列の例の取得

GET /api/database-examples/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この データベース接続の例 を識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/database-examples/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "databaseType"?:  // データベースのタイプの選択肢

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL (任意)
  {
  }
  "databaseTypeExample": string // 例: postgresql://db_user:db_password@db_ip:db_port/db_name
}

レスポンスの値の例

{
  "databaseType": {},
  "databaseTypeExample": "レスポンス文字列"
}

---

特定の接続文字列の例の取得

GET /api/v1/database-examples/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
id	✅	string	この データベース接続の例 を識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/database-examples/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "databaseType"?:  // データベースのタイプの選択肢

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL (任意)
  {
  }
  "databaseTypeExample": string // 例: postgresql://db_user:db_password@db_ip:db_port/db_name
}

レスポンスの値の例

{
  "databaseType": {},
  "databaseTypeExample": "レスポンス文字列"
}

---

AI アシスタントのデータベース設定の一覧取得

GET /api/chatbots/{chatbotPk}/databases/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
page	❌	integer	A page number within the paginated result set.
pageSize	❌	integer	Number of results to return per page.

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/?page=1&pageSize=1" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "count": integer
  "next"?: string (uri) // 任意
  "previous"?: string (uri) // 任意
  "results": [
    {
      "id": string (uuid)
      "name": string // 表示用の名前。例: メイン業務DB、分析DB
      "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
      {
      }
      "databaseUrl": string // データベース接続文字列
      "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
      "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
}

レスポンスの値の例

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列",
      "databaseType": {},
      "databaseUrl": "レスポンス文字列",
      "includeTables": null,
      "isActive": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ]
}

---

AI アシスタントのデータベース設定の一覧取得

GET /api/v1/chatbots/{chatbotPk}/databases/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
page	❌	integer	A page number within the paginated result set.
pageSize	❌	integer	Number of results to return per page.

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/?page=1&pageSize=1" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "count": integer
  "next"?: string (uri) // 任意
  "previous"?: string (uri) // 任意
  "results": [
    {
      "id": string (uuid)
      "name": string // 表示用の名前。例: メイン業務DB、分析DB
      "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
      {
      }
      "databaseUrl": string // データベース接続文字列
      "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
      "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
      "createdAt": string (timestamp)
      "updatedAt": string (timestamp)
    }
  ]
}

レスポンスの値の例

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "レスポンス文字列",
      "databaseType": {},
      "databaseUrl": "レスポンス文字列",
      "includeTables": null,
      "isActive": false,
      "createdAt": "レスポンス文字列",
      "updatedAt": "レスポンス文字列"
    }
  ]
}

---

AI アシスタントのデータベース設定の追加

POST /api/chatbots/{chatbotPk}/databases/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	必須	表示用の名前。例: メイン業務DB、分析DB
databaseType	object	必須	データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	必須	データベース接続文字列
includeTables	object	任意	クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります

リクエスト構造の例

{
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
}

リクエストの値の例

{
  "name": "サンプル名",
  "databaseType": {},
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "databaseType": {},
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 201

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

AI アシスタントのデータベース設定の追加

POST /api/v1/chatbots/{chatbotPk}/databases/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	必須	表示用の名前。例: メイン業務DB、分析DB
databaseType	object	必須	データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	必須	データベース接続文字列
includeTables	object	任意	クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります

リクエスト構造の例

{
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
}

リクエストの値の例

{
  "name": "サンプル名",
  "databaseType": {},
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X POST "https://api.maiagent.ai/api/v1/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "databaseType": {},
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 201

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

特定のデータベース設定の取得

GET /api/chatbots/{chatbotPk}/databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
id	✅	string	この Chatbot のデータベース設定を識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

特定のデータベース設定の取得

GET /api/v1/chatbots/{chatbotPk}/databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
id	✅	string	この Chatbot のデータベース設定を識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X GET "https://api.maiagent.ai/api/v1/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データベース設定の更新

PUT /api/chatbots/{chatbotPk}/databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
id	✅	string	この Chatbot のデータベース設定を識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	必須	表示用の名前。例: メイン業務DB、分析DB
databaseType	object	必須	データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	必須	データベース接続文字列
includeTables	object	任意	クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります

リクエスト構造の例

{
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
}

リクエストの値の例

{
  "name": "サンプル名",
  "databaseType": {},
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PUT "https://api.maiagent.ai/api/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "databaseType": {},
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データベース設定の更新

PUT /api/v1/chatbots/{chatbotPk}/databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
id	✅	string	この Chatbot のデータベース設定を識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	必須	表示用の名前。例: メイン業務DB、分析DB
databaseType	object	必須	データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	必須	データベース接続文字列
includeTables	object	任意	クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります

リクエスト構造の例

{
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
}

リクエストの値の例

{
  "name": "サンプル名",
  "databaseType": {},
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PUT "https://api.maiagent.ai/api/v1/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "databaseType": {},
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データベース設定の部分更新

PATCH /api/chatbots/{chatbotPk}/databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
id	✅	string	この Chatbot のデータベース設定を識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	任意	表示用の名前。例: メイン業務DB、分析DB
databaseType	object	任意	データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	任意	データベース接続文字列
includeTables	object	任意	クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります

リクエスト構造の例

{
  "name"?: string // 表示用の名前。例: メイン業務DB、分析DB (任意)
  "databaseType"?:  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL (任意)
  {
  }
  "databaseUrl"?: string // データベース接続文字列 (任意)
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
}

リクエストの値の例

{
  "name": "サンプル名",
  "databaseType": {},
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PATCH "https://api.maiagent.ai/api/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "databaseType": {},
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データベース設定の部分更新

PATCH /api/v1/chatbots/{chatbotPk}/databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
id	✅	string	この Chatbot のデータベース設定を識別する UUID 文字列です。

リクエスト内容

リクエストパラメータ

フィールド	タイプ	必須	説明
name	string	任意	表示用の名前。例: メイン業務DB、分析DB
databaseType	object	任意	データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent postgresql: PostgreSQL ; mysql: MySQL ; maiagent: MaiAgent ; oracle: Oracle ; mssql: MSSQL;
databaseUrl	string	任意	データベース接続文字列
includeTables	object	任意	クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません
isActive	boolean	任意	無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります

リクエスト構造の例

{
  "name"?: string // 表示用の名前。例: メイン業務DB、分析DB (任意)
  "databaseType"?:  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL (任意)
  {
  }
  "databaseUrl"?: string // データベース接続文字列 (任意)
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
}

リクエストの値の例

{
  "name": "サンプル名",
  "databaseType": {},
  "databaseUrl": "サンプル文字列",
  "includeTables": null,
  "isActive": true
}

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X PATCH "https://api.maiagent.ai/api/v1/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "サンプル名",
    "databaseType": {},
    "databaseUrl": "サンプル文字列",
    "includeTables": null,
    "isActive": true
  }'

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード: 200

レスポンス構造の例

{
  "id": string (uuid)
  "name": string // 表示用の名前。例: メイン業務DB、分析DB
  "databaseType":  // データベースのタイプの選択肢: MySQL、PostgreSQL、MSSQL、Oracle、MaiAgent

* `postgresql` - PostgreSQL
* `mysql` - MySQL
* `maiagent` - MaiAgent
* `oracle` - Oracle
* `mssql` - MSSQL
  {
  }
  "databaseUrl": string // データベース接続文字列
  "includeTables"?: object // クエリ対象のデータテーブルのリストを指定します。形式: {"tables": ["table1", "table2"]}。MaiAgent タイプではアップロードされたファイルから自動的に取得されるため、手動で設定する必要はありません (任意)
  "isActive"?: boolean // 無効にすると、このデータベースは Text-to-SQL クエリで使用されなくなります (任意)
  "createdAt": string (timestamp)
  "updatedAt": string (timestamp)
}

レスポンスの値の例

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "レスポンス文字列",
  "databaseType": {},
  "databaseUrl": "レスポンス文字列",
  "includeTables": null,
  "isActive": false,
  "createdAt": "レスポンス文字列",
  "updatedAt": "レスポンス文字列"
}

---

データベース設定の削除

DELETE /api/chatbots/{chatbotPk}/databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
id	✅	string	この Chatbot のデータベース設定を識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X DELETE "https://api.maiagent.ai/api/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---

データベース設定の削除

DELETE /api/v1/chatbots/{chatbotPk}/databases/{id}/

パラメータ

パラメータ名	必須	タイプ	説明
chatbotPk	✅	string	この Chatbot ID を識別する UUID 文字列です
id	✅	string	この Chatbot のデータベース設定を識別する UUID 文字列です。

コードサンプル

Shell/Bash

# API 呼び出しの例 (Shell)
curl -X DELETE "https://api.maiagent.ai/api/v1/chatbots/550e8400-e29b-41d4-a716-446655440000/databases/550e8400-e29b-41d4-a716-446655440000/" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# 実行前に YOUR_API_KEY を置き換え、リクエストデータを確認してください。

JavaScript

Python

PHP

レスポンス内容

ステータスコード	説明
204	No response body

---