# Get Deployment Status

`GET /api/workflows/{id}/deploy`

## Description
Return whether the workflow is deployed, when, and whether the saved workflow has changed since. Requires read access; scoped keys need a read grant.

## Parameters

- **id** (path) (required) — `string`: The unique identifier of the workflow.

## Responses

### 200 — Deployment status.

```json
{
  "type": "object",
  "properties": {
    "isDeployed": {
      "type": "boolean",
      "description": "Whether the workflow has an active deployment."
    },
    "deployedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "When the active deployment was created."
    },
    "apiKey": {
      "type": [
        "string",
        "null"
      ],
      "description": "Which API keys can execute the deployment: `Workspace API keys` or `Personal API keys`. Never a key value."
    },
    "needsRedeployment": {
      "type": "boolean",
      "description": "Whether the saved workflow differs from the active deployment."
    },
    "isPublicApi": {
      "type": "boolean",
      "description": "Whether the deployment can be executed without an API key."
    }
  }
}
```

### 401 — Invalid or missing API key. Ensure the X-API-Key header is set with a valid key.

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Human-readable error message."
    }
  }
}
```

### 403 — The key's owner lacks read access to the workflow in its workspace.

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Human-readable error message."
    }
  }
}
```

### 404 — The requested resource was not found. Verify the ID is correct and belongs to your workspace.

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Human-readable error message."
    }
  }
}
```