---
title: "Try to claim one exact queued attempt. Start work only when the response carries claim_won:true. A changed:false result is a non-winner even when another session uses the same credential. Scope 'act'; free."
method: POST
path: "/api/v1/queue/{id}/pick-up"
---

# Try to claim one exact queued attempt. Start work only when the response carries claim_won:true. A changed:false result is a non-winner even when another session uses the same credential. Scope 'act'; free.

`POST /api/v1/queue/{id}/pick-up`

## Request

- Base URL: `https://afterlaunch.io`
- URL: `https://afterlaunch.io/api/v1/queue/{id}/pick-up`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `attempt_id` string, uuid, nullable, required
  - `session_url` string, nullable: Optional. The launch already gave your user the link to this session; pass it only when you opened this session yourself and can see its address.
  - `site_repository` string, nullable: Optional, for a routine working a site move: the repository it can write to, as owner/name, or null if it has none. Omit it to say nothing.

## Response `200`

Claimed. picked_up_by is the API key label the claim was recorded under.

- object
  - `data` object, required
  - `meta` object, required
    - `enrollment_id` string, uuid, required
    - `generated_at` string, date-time, required

## Other responses

- `401`: Missing, invalid or revoked API key.
- `403`: The key does not carry the scope this endpoint requires.
- `404`: No job with that id is in the queue on this product run.
- `409`: Another agent claimed it first, or it has already moved on.
- `429`: Per-key rate limit exceeded. Honour Retry-After.

---

[API](https://skmtc.dev/afterlaunch/apis/afterlaunch-public-api.md) · [All operations](https://skmtc.dev/afterlaunch/apis/afterlaunch-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/afterlaunch/apis/afterlaunch-public-api/revisions/d67a599194a4?raw)