Retry signals
Sends 1 to 50 PENDING signals through processing again, for example after you created the missing customer. Answers 202 at once; see the result in List raw signals. A signal gets 11 attempts, then becomes REJECTED. A retry never counts a signal twice.
Base URL https://events.clocknext.com/api/v1
apiKeyAuthorizationBearer <cnk_…>Organisation-scoped key from Settings → API Keys.
application/json- body
signalIds*array<>1 to 50 signal ids to send again.
1 <= items <= 50The ids, sorted by result. A 202 also when no id was queued.
application/json- response
statusCode*integerThe HTTP status code of the answer, for example 200 or 202.
statusDetail*The status of the request and a short message.
result*The ids you sent, sorted into one list for each result.
curl -X POST 'https://events.clocknext.com/api/v1/signal/retry' \ -H 'Content-Type: application/json' \ -d '{ "signalIds": [ "01a15a15-ccec-758e-ad47-1f18e965ad90", "01a15a15-cbda-71e8-8e8f-8a4cc080bdd6", "01a15a15-caca-712e-ae8c-7ac5e1c3fe68", "01a15a15-c9b8-72a0-a2c9-466de0f8fc56", "01a15a15-9753-7652-a00b-2ef6597b1f12" ]}'{ "statusCode": 202, "statusDetail": { "status": "SUCCESS", "message": "Signals queued for retry." }, "result": { "queued": [ { "signalId": "01a15a15-ccec-758e-ad47-1f18e965ad90", "attempt": 2 }, { "signalId": "01a15a15-cbda-71e8-8e8f-8a4cc080bdd6", "attempt": 2 }, { "signalId": "01a15a15-caca-712e-ae8c-7ac5e1c3fe68", "attempt": 2 } ], "notFound": [], "attemptLimitReached": [], "notPending": [], "failed": [] }}Types
Every object type on this page, with its fields.
SignalRetryResult
| Field | Type | Required | Description |
|---|---|---|---|
queued | object[] | yes | Sent for processing again, with this attempt number. Read the result later. |
notFound | string[] | yes | No signal with this id in your organization. |
attemptLimitReached | string[] | yes | The signal has used all 11 attempts. Send a new signal instead. |
notPending | string[] | yes | Counted already, REJECTED, or stored without a body to send. |
failed | string[] | yes | Not sent this time (a short outage, or its externalId could not be looked up). Retry these ids. |
SignalRetryResult.queued
| Field | Type | Required | Description |
|---|---|---|---|
signalId | string | yes | The signal id, in lower case. |
attempt | integer | yes | The number of this attempt. The first send is attempt 1. |
List raw signals GET
Your organization's signals with their status (`SUCCESS`, `PENDING` or `REJECTED`), newest first, 50 a page, for the last 30 days unless you send `from` or `to`. Resend `PENDING` ones with [Retry signals](/docs/api-reference/signals/eventsRetrySignals). An unknown customer gives an empty list, not a `404`.
List Customer Usage Log GET
One customer's counted signals in one feed, newest first: credit, outcome steps and completions, unit, wallet and composite. Name the customer with `customerId` or `externalId`. Paged with `limit` and `cursor`, for the last 30 days unless you send `from` or `to`. A row a composite covers shows 0.