Deployment Service

List deployments

GET
/projects/{projectId}/endpoints/{endpointId}/deployments

Lists the deployments attached to an endpoint, including their model, configuration, scaling settings, placement, and current status.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

projectId*string

ID of the project that owns the endpoint.

endpointId*string

ID of the endpoint whose deployments are listed.

Query Parameters

limit?integer

Maximum number of deployments to return. Max 500, defaults to 50.

after?string

Cursor from a previous deployment list response.

orderBy?string

Sort field for the results. Supports created_at or updated_at, optionally followed by asc or desc.

filter?string

Filter expression using name, state, model, created_at, or updated_at with comparison operators and AND/OR/NOT; state takes a DeploymentState enum name and model takes a model resource name. name supports substring matching with : and prefix/suffix wildcards with *, and accepts a bare deployment name or <project_slug>/<endpoint_name>/<deployment_name>.

Response Body

application/json

application/json

curl -X GET "https://example.com/projects/string/endpoints/string/deployments"
{  "data": [    {      "id": "string",      "projectId": "string",      "endpointId": "string",      "name": "string",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "modelId": "string",      "modelRevisionId": "string",      "model": "string",      "autoscaling": {        "minReplicas": 0,        "maxReplicas": 0,        "scaleDownWindow": "string",        "scaleUpWindow": "string",        "scaleToZeroWindow": "string",        "scalingMetrics": [          {            "name": "active_sessions",            "type": "METRIC_TARGET_TYPE_VALUE",            "target": 0,            "percentile": "string"          }        ],        "scaleUp": {          "policies": [            {              "type": "SCALING_POLICY_TYPE_PODS",              "value": 1,              "periodSeconds": 1            }          ],          "selectPolicy": "SCALING_POLICY_SELECT_MAX"        },        "scaleDown": {          "policies": [            {              "type": "SCALING_POLICY_TYPE_PODS",              "value": 1,              "periodSeconds": 1            }          ],          "selectPolicy": "SCALING_POLICY_SELECT_MAX"        }      },      "configId": "string",      "config": "string",      "speculatorId": "string",      "speculatorRevisionId": "string",      "speculator": "string",      "estimatedEffectiveTrafficShare": 0.1,      "maxConcurrentRequestsPerReplica": "string",      "inactiveTimeout": 0,      "etag": "string",      "hardware": "string",      "trafficMode": "TRAFFIC_MODE_LIVE",      "runtimeInfo": {        "engineType": "string",        "engineVersion": "string",        "functionCallingSupported": true,        "structuredOutputSupported": true      },      "desiredReplicas": 0,      "status": {        "state": "DEPLOYMENT_STATE_PROVISIONING",        "readyReplicas": 0,        "message": "string",        "scheduledReplicas": 0,        "details": {          "region": [            {              "region": "string",              "scheduledReplicas": 0,              "readyReplicas": 0            }          ]        }      },      "placement": {        "inline": {          "regions": [            "string"          ],          "constraint": "ENFORCEMENT_REQUIRED",          "compliancePolicy": {            "hipaa": true          }        }      }    }  ],  "next_cursor": "string",  "object": "list"}