API reference

Advance a confirmation

Sends the next pending step now, instead of waiting for its scheduled time.

POST/v1/confirmations/{id}/advance

Brings the next pending step forward so it goes out straight away: the text instead of waiting for tomorrow, or the call instead of waiting for the afternoon. It's what the "send the next step now" button in the console does.

curl -X POST https://api.anyonein.co.uk/v1/confirmations/cf_7d2a9c41e0b3f658/advance \
  -H "Authorization: Bearer $ANYONEIN_KEY"

const res = await fetch(
  'https://api.anyonein.co.uk/v1/confirmations/cf_7d2a9c41e0b3f658/advance',
  { method: 'POST', headers: { Authorization: `Bearer ${process.env.ANYONEIN_KEY}` } },
);
if (res.status === 409) console.log((await res.json()).error); // closed, or nothing left to send

res = requests.post(
    "https://api.anyonein.co.uk/v1/confirmations/cf_7d2a9c41e0b3f658/advance",
    headers={"Authorization": f"Bearer {os.environ['ANYONEIN_KEY']}"},
    timeout=15,
)
if res.status_code == 409:
    print(res.json()["error"])

<?php
$ch = curl_init('https://api.anyonein.co.uk/v1/confirmations/cf_7d2a9c41e0b3f658/advance');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ANYONEIN_KEY')],
]);
$body = json_decode(curl_exec($ch), true);

Response200 OK

{
  "confirmation": {
    "id": "cf_7d2a9c41e0b3f658",
    "status": "in_progress",
    "steps": [
      { "id": "st_4be1a09c", "channel": "email", "state": "sent", "sentAt": "2026-10-10T09:00:02.117Z" },
      { "id": "st_91c3d27e", "channel": "sms", "state": "pending", "dueAt": "2026-10-10T15:27:40.009Z" },
      { "id": "st_0a6f58b2", "channel": "call", "state": "pending", "dueAt": "2026-10-12T10:00:00.000Z" }
    ],
    "events": [
      { "id": "ev_61b0c9e2d7", "kind": "system", "text": "Text brought forward by ops." }
    ]
  }
}

Path parameters

idstringrequired: The confirmation's id.

Returns

200 OK with the updated confirmation. The next pending step's dueAt is now, and a system event records that it was brought forward. The step itself goes out within a few seconds; retrieve the confirmation, or wait for the outcome webhook, to see the result.

Only the next step moves. Later steps keep their times.

Important

An advanced step goes out immediately, even outside the usual contact hours. Use it when someone on your team has decided a customer should be contacted now.

Errors

Status	`error`	When
`404`	`No confirmation with that id.`	The `id` doesn't exist
`409`	`This confirmation is already closed.`	It's `confirmed`, `rescheduled`, `action_needed`, `unreachable` or `cancelled`
`409`	`Nothing left to send.`	Every step has already gone out

Base URL https://api.anyonein.co.uk/v1 is a placeholder until the production domain is confirmed. Found a mistake? Tell us.

#Path parameters

#Returns

#Errors

Path parameters

Returns

Errors