---
title: "List deployments"
method: GET
path: "/deployments"
tags: ["Deployments"]
---

# List deployments

`GET /deployments`

List deployments. Optionally filter by application name and version.

## Query parameters

- `app_name` string
- `app_version` string
- `limit` integer
- `offset` integer
- `query` string

## Response `200`

List of deployments.

- Deployment[]
  - `id` string, required — Unique identifier for the deployment
  - `status` 'queued' | 'in_progress' | 'running' | 'failed' | 'stopped', required — Current status of the deployment
  - `status_reason` string — Status reason
  - `region` 'aws.us-east-1a', required — Deployment region code
  - `entrypoint_rel_path` string — Relative path to the application entrypoint
  - `env_vars` object — Environment variables configured for this deployment. Values are redacted for API key, OAuth, and managed-auth callers, which receive every key with an empty string value. Only dashboard sessions receive the actual values.
  - `created_at` string, date-time, required — Timestamp when the deployment was created
  - `updated_at` string, date-time, nullable — Timestamp when the deployment was last updated
  - `source_type` 'file' | 'github' — Origin of the deployed source code. This is read-only response provenance; `file` indicates an uploaded archive and `github` indicates a repository fetched by the API.
  - `source_url` string — For GitHub-sourced deployments, the repository URL that was fetched. Omitted for file uploads.
  - `source_ref` string — For GitHub-sourced deployments, the git ref as requested at deploy time (branch, tag, or commit SHA — not resolved to a commit). Omitted for file uploads.
  - `source_path` string — For GitHub-sourced deployments, the subpath within the repository that was used as the deploy root. Omitted when the repo root was used or for file uploads.
  - `source_checksum` string — Hex-encoded SHA-256 checksum of the source archive. For file uploads, this hashes the uploaded archive; for GitHub-sourced deployments, this hashes the GitHub archive downloaded by the API. Omitted for deployments created before this field was recorded.

## Other responses

- `400` — Bad Request – invalid input
- `401` — Unauthorized – missing or invalid authorization token
- `500` — Internal Server Error

---

[API](https://skmtc.net/kernel/apis/kernel-api.md) · [All operations](https://skmtc.net/kernel/apis/kernel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/kernel-api/versions/9e8ce9fcf5e1/schema)