Waitlist API reference

Waitlist API · Entries

post/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries/bulkAuth

Approve, reject or invite up to 100 entries at once

Applies one action to every id, serially. Per-row results are returned, so one bad id does not fail the batch.

Path parameters

workspace_id*string · uuid

Id of the workspace.

waitlist_id*string · uuid

Id of the waitlist.

Headers

Idempotency-Keystring

Idempotency key (24 h). A retry with the same key and body returns the first response instead of acting twice.

Request body

ids*array

Entry UUIDs to act on in this batch. Capped at 100 per call; the request is processed serially and per-row results are returned. De-duped server-side.

Example: ["11111111-1111-1111-1111-111111111111","22222222-2222-2222-2222-222222222222"]

action*object

Action to apply to every id.

Example: "approve"

app_slugstring

Auth app slug override for `action: invite-to-app`. When omitted, falls back to the workspace Waitlist settings default (`default_heimdall_app_slug`). Ignored for approve/reject.

Example: "acme-product"

send_emailboolean

Whether to send the approval email with the invite link baked in. Defaults to `true`. Ignored for approve/reject.

Example: true

Response · 200 `{ requested, succeeded, failed, results }`. Each row in `results` carries `{ id, status: "ok" | "error", error?: { code, status_code, message } }` so a partial failure (one bad id) doesn't fail the whole batch. `code` is the same error code the single-entry call would fail with (`NOT_FOUND`, `CONFLICT`, ...).

requested*integer

Number of unique ids processed (after de-dupe).

succeeded*integer

Rows the action succeeded on.

failed*integer

Rows it failed on.

results*array

One result per requested id.

Example

Request

POST https://api.waitlist.productcraft.co/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries/bulk
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "ids": [
    "11111111-1111-1111-1111-111111111111",
    "22222222-2222-2222-2222-222222222222"
  ],
  "action": "approve",
  "app_slug": "acme-product",
  "send_email": true
}

Response

{
  "requested": 0,
  "succeeded": 0,
  "failed": 0,
  "results": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status": {},
      "error": {}
    }
  ]
}