Get a deployment

Read the status, source revision and diagnosis for a deployment in this project, and detectedRuntime: what it runs and why, such as "Static site (public/)" or "Node app (npm start)". Set waitSeconds (up to 50) to wait for the deployment to finish: the response comes back as soon as the status is success, failed or cancelled, or when the time is up, with done saying which. A failed deployment includes logTail, the end of its build log, when the credential has logs:read.

Tool: getDeployment
Permission: deployments:read
Kind: Read-only

Arguments

Name	Type	Required	Limits
`waitSeconds`	`integer`	No	Minimum 0; Maximum 50
`projectId`	`string`	Yes	At least 1 character(s)
`deploymentId`	`string`	Yes	At least 1 character(s)

Full input schema

{
  "type": "object",
  "properties": {
    "waitSeconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 50
    },
    "projectId": {
      "type": "string",
      "minLength": 1
    },
    "deploymentId": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "projectId",
    "deploymentId"
  ],
  "additionalProperties": false
}

Example call

The params of a tools/call request. Replace the placeholder values with your own IDs.

{
  "name": "getDeployment",
  "arguments": {
    "projectId": "REPLACE_WITH_PROJECT_ID",
    "deploymentId": "REPLACE_WITH_DEPLOYMENT_ID"
  }
}

Result

The same data as the API operation, wrapped as {"untrusted_data": true, "source": "getDeployment", "note": "...", "data": ...} so the model treats project content as data, not instructions.