Get Deployment

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/{id}

Get Deployment details

Path parameters

  • id string(uuid) Required

Responses

  • 404 application/json

    Not Found

    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.

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • gpu-count integer(int64)

      Number of GPUs

      Minimum value is 1.

    • updated-at string(date-time)

      Update time

    • deployment-url string Required

      Deployment inference endpoint URL

    • service-level string

      Service level

      Minimum length is 1.

    • inference-engine-version string

      Inference engine version

      Values are 0.12.0, 0.15.1, 0.16.0, 0.17.0, 0.18.0, 0.18.1, 0.19.0, 0.19.1, 0.20.0, 0.20.1, 0.20.2, 0.21.0, 0.22.0, 0.22.1, 0.23.0, 0.24.0, 0.25.0, 0.25.1, or 0.26.0. Default value is 0.26.0.

    • 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

      GPU type family

      Minimum length is 1.

    • id string(uuid)

      Deployment ID

    • replicas integer(int64)

      Number of replicas (>=0)

      Minimum value is 0.

    • state-details string

      Deployment state details

    • created-at string(date-time)

      Creation time

    • visibility string Required

      Deployment visibility: private for your organization's deployments, public for Exoscale Managed Inference deployments.

      Values are public or private.

    • inference-engine-parameters array[string]

      Optional extra inference engine server CLI args

    • 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

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