# Get a draft

### Get a draft

`GET /api/v1/drafts/{draftId}`

Operation ID: `getDraft`

One draft, with where it is in review.

**Path parameters**

- `draftId` (string · uuid, required): Draft id

**200**: The draft.

- `draft` (object, required)
  - `id` (string · uuid, required)
  - `status` ("awaiting_review" | "sent" | "failed" | "discarded", required): `awaiting_review` until a member approves or discards it in the Needle inbox. Approving sends it right away: it becomes `sent`, or stays `awaiting_review` with `lastError` when the send fails. `failed` means it could not be sent and cannot be approved again; `discarded` means it will not be sent.
  - `channel` ("linkedin" | "instagram", required)
  - `action` ("linkedin_message" | "linkedin_inmail" | "linkedin_invitation" | "instagram_message", required)
  - `text` (string, required): What will be sent, or was sent. A member may edit it before approving.
  - `subject` (string | null, required): The InMail subject.
  - `lead` (object, required)
    - `id` (string · uuid, required)
    - `name` (string | null, required)
  - `connectedAccountId` (string · uuid, required)
  - `campaignId` (string · uuid | null, required): Set when a campaign step drafted the message.
  - `taskId` (string · uuid | null, required): The campaign task the draft holds. Null for API drafts.
  - `discardReason` ("rejected" | "superseded" | "withdrawn" | "enrollment_stopped" | "campaign_archived" | "task_cancelled" | null, required)
  - `lastError` (string | null, required): Why the last attempt to send it failed.
  - `createdBy` (string · uuid | null, required): The member who created it. Null when a campaign step did.
  - `reviewedBy` (string · uuid | null, required): The member who approved or discarded it.
  - `reviewedAt` (string · date-time | null, required)
  - `createdAt` (string · date-time, required)
  - `updatedAt` (string · date-time, required)
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload