Deployments

List deployments

Returns up to 50 recent deployments for your workspace, ordered by creation time (newest first). Use branch, projectId, or status query parameters to filter results — especially useful in CI to check if a deployment for a given branch already exists.

get/api/v1/deployments

Request

  • Base URL: https://previewdrop.dev
  • URL: https://previewdrop.dev/api/v1/deployments
  • Auth: HTTP bearer

Query parameters

branchstring

Filter by branch name. Exact match, case-sensitive.

projectIdstring uuid

Filter by project UUID.

status'queued' | 'building' | 'deploying' | 'ready' | 'failed' | 'stopped' | 'expired'

Filter by deployment status.

Response

OK

Example response

{
  "deployments": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "tenant_id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
      "project_id": "11223344-5566-7788-99aa-bbccddeeff00",
      "pd_projects": {
        "github_repo": "acme/my-app"
      },
      "worker_deploy_id": "abc123def456",
      "url": "https://prv-abc123.previews.previewdrop.dev",
      "status": "ready",
      "framework": "nextjs",
      "branch": "feat/new-checkout",
      "detected_env_vars": [
        "DATABASE_URL",
        "NEXT_PUBLIC_API_URL"
      ],
      "build_log": "[1/4] Installing dependencies...\n[2/4] Building application...",
      "expires_at": "2026-04-09T14:00:00.000Z",
      "created_at": "2026-04-09T10:00:00.000Z",
      "updated_at": "2026-04-09T10:03:42.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.