---
title: "Retrieve a revision's prepare"
canonical: "https://admiral.io/docs/api/changesets/ChangeSetAPI_GetPrepare"
---

# Retrieve a revision's prepare

`GET https://api.admiral.io/v1/changesets/{change_set_id}/revisions/{revision}/prepare`

Scope: `changeset:read`

### Path parameters

- `change_set_id` (string, required): The change_set_id path parameter. Pattern `^cs-[0-9a-z]+$`.
- `revision` (string, required): The revision: its number, or its `rev-` id. Pattern `^([1-9][0-9]{0,8}|rev-[0-9a-z]+)$`.

### Response 200

Success

- `prepare` (Prepare): Prepare is a revision's render into its artifact.
  - `revision` (integer (int32)): The revision prepared: its number and its `rev-` id.
  - `revision_id` (string)
  - `status` (Status): Status is where a revision's prepare stands. One of `STATUS_UNSPECIFIED`, `STATUS_QUEUED`, `STATUS_RUNNING`, `STATUS_PREPARED`, `STATUS_FAILED`, `STATUS_SUPERSEDED`.
  - `artifact_digest` (string): `sha256:<hex>` of the artifact; set once STATUS_PREPARED.
  - `findings` (array of Finding)
    - `component` (string)
    - `code` (Code): Code names something a prepare noticed but did not refuse. One of `CODE_UNSPECIFIED`, `CODE_LOOKUP_USED`, `CODE_NONDETERMINISTIC`, `CODE_NO_CAPABILITIES`, `CODE_SCOPE_GUESSED`.
    - `message` (string)
    - `details` (array of string): For CODE_NONDETERMINISTIC, each `Kind/namespace/name field` that differs.
  - `error` (PrepareError): Set when STATUS_FAILED.
    - `class` (Class): Class says whose problem it is, and so whether asking again can help. One of `CLASS_UNSPECIFIED`, `CLASS_INPUT`, `CLASS_INTERNAL`.
    - `component` (string): Empty when the failure is not one component's.
    - `message` (string)
  - `requested_by` (ActorRef): ActorRef is a lightweight reference to the user or agent that performed an action. Server-populated on all resource responses. Clients should never send this.
    - `id` (string): The actor's typed id: a `usr-` user id or an `sa-` service account id.
    - `display_name` (string): Human-readable name (e.g., "John Smith", "deploy-bot").
    - `email` (string): Email address (empty for non-human actors).
  - `requested_at` (Timestamp): A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
  - `finished_at` (Timestamp): A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
  - `attempts` (integer (int32))