List Deployments

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://openapi-v2.exoscale.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "Exoscale APIv2 MCP server": {
    "url": "https://openapi-v2.exoscale.com/mcp"
  }
}

Close
GET /ai/deployment

List Deployments

Query parameters

  • visibility string

Responses

  • 200 application/json

    200

    Hide response attribute Show response attribute object
    • deployments array[object] Required

      AI deployment

      Hide deployments attributes Show deployments attributes object

      AI deployment

      • gpu-count integer(int64) Required

        Number of GPUs

        Minimum value is 1.

      • updated-at string(date-time) Required

        Update time

      • deployment-url string Required

        Deployment inference endpoint URL

      • service-level string Required

        Service level

        Minimum length is 1.

      • name string Required

        Deployment name

        Minimum length is 1.

      • state string Required

        Deployment state

        Values are ready, creating, preparing, error, deploying, scaling, or updating.

      • gpu-type string Required

        GPU type family

        Minimum length is 1.

      • id string(uuid) Required

        Deployment ID

      • replicas integer(int64) Required

        Number of replicas (>=0)

        Minimum value is 0.

      • created-at string(date-time) Required

        Creation time

      • model object Required

        Model reference. Provide either id or name.

        Hide model attributes Show model attributes object
        • name string

          Associated model name

          Minimum length is 1.

        • id string(uuid)

          Associated model ID

  • 400 application/json

    400

    Hide response attributes Show response attributes object
    • type string(uri-reference) Required

      An absolute or relative URI reference pointing to human-readable documentation concerning the specific problem type encountered.

    • title string Required

      A brief summary defining the class of failure, optimal for quick user interface groupings.

    • status integer Required

      Minimum value is 100, maximum value is 599.

    • detail string Required

      A highly contextual, readable explanation breaking down explicitly what triggered this error scenario.

GET /ai/deployment
curl \
 --request GET 'https://api-ch-gva-2.exoscale.com/v2/ai/deployment'
Response examples (200)
{
  "deployments": [
    {
      "gpu-count": 42,
      "updated-at": "2026-05-04T09:42:00Z",
      "deployment-url": "string",
      "service-level": "string",
      "name": "string",
      "state": "ready",
      "gpu-type": "string",
      "id": "string",
      "replicas": 42,
      "created-at": "2026-05-04T09:42:00Z",
      "model": {
        "name": "string",
        "id": "string"
      }
    }
  ]
}
Response examples (400)
{
  "type": "string",
  "title": "string",
  "status": 42,
  "detail": "string"
}