---
title: "Get a deployment"
openapi: "api/radiant.openapi.yaml"
method: "GET"
path: "/v1/deployments/{deploymentId}"
---

# Get a deployment

GET `/v1/deployments/{deploymentId}`

Returns the current status of one deployment belonging to the API key's site.

OpenAPI spec: https://radiantdocs.com/docs/api/radiant.openapi.yaml

## Path Parameters

| Name | Required | Type | Description |
| --- | --- | --- | --- |
| `deploymentId` | Yes | `string (uuid)` | The deployment identifier returned when the deployment was created. |

## Header

| Name | Required | Type | Description |
| --- | --- | --- | --- |
| `Authorization` | Yes | `string` | A site-scoped key created from the Radiant dashboard. |

## Responses

### 200

The deployment and its current status.

Content types: `application/json`

### 401

The request is missing a valid, active Radiant API key.

Content types: `application/json`

### 403

The API key does not have the scope required by the operation.

Content types: `application/json`

### 404

The resource does not exist or is outside the API key's site scope.

Content types: `application/json`

### 500

Radiant could not complete the request because of an internal error.

Content types: `application/json`

## OpenAPI operation

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Radiant API",
    "version": "1.0.0",
    "description": "Trigger Radiant Docs deployments and retrieve their status.",
    "contact": {
      "name": "Radiant Docs Support",
      "url": "https://radiantdocs.com/contact"
    }
  },
  "servers": [
    {
      "url": "https://radiantdocs.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/v1/deployments/{deploymentId}": {
      "get": {
        "operationId": "getDeployment",
        "summary": "Get a deployment",
        "description": "Returns the current status of one deployment belonging to the API key's site.",
        "tags": [
          "Deployments"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/DeploymentId"
          }
        ],
        "responses": {
          "200": {
            "description": "The deployment and its current status.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deployment"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Deployments",
      "description": "Build and publish a documentation site."
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Radiant API key",
        "description": "A site-scoped key created from the Radiant dashboard."
      }
    },
    "parameters": {
      "DeploymentId": {
        "name": "deploymentId",
        "in": "path",
        "required": true,
        "description": "The deployment identifier returned when the deployment was created.",
        "schema": {
          "type": "string",
          "format": "uuid"
        },
        "example": "90a76b22-8f25-4fc7-95cc-b3a5b2f24108"
      }
    },
    "schemas": {
      "Deployment": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "siteId",
          "status",
          "trigger",
          "commit",
          "failure",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "example": "90a76b22-8f25-4fc7-95cc-b3a5b2f24108"
          },
          "siteId": {
            "type": "string",
            "format": "uuid",
            "example": "25853bf0-7640-45c6-b008-568c6d90d8f8"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "building",
              "success",
              "failed",
              "canceled"
            ],
            "example": "building"
          },
          "trigger": {
            "type": "string",
            "description": "The workflow that created the deployment.",
            "example": "api"
          },
          "commit": {
            "$ref": "#/components/schemas/Commit"
          },
          "failure": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/DeploymentFailure"
              },
              {
                "type": "null"
              }
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "example": "2026-08-01T18:30:00.000Z"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "example": "2026-08-01T18:30:06.000Z"
          }
        }
      },
      "Commit": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "sha",
          "message"
        ],
        "properties": {
          "sha": {
            "type": "string",
            "example": "4f91d8616e87bb258320565ff3eeca7c1f5f260b"
          },
          "message": {
            "type": [
              "string",
              "null"
            ],
            "example": "Update authentication documentation"
          }
        }
      },
      "DeploymentFailure": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "message"
        ],
        "properties": {
          "message": {
            "type": "string",
            "example": "The docs configuration is invalid."
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string",
                "example": "not_found"
              },
              "message": {
                "type": "string",
                "example": "Deployment not found."
              },
              "details": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "The request is missing a valid, active Radiant API key.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "Forbidden": {
        "description": "The API key does not have the scope required by the operation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "NotFound": {
        "description": "The resource does not exist or is outside the API key's site scope.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "InternalError": {
        "description": "Radiant could not complete the request because of an internal error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      }
    }
  }
}
```