Resend an event

cURL

# Set a unique key once per new action; persist it and reuse it for every retry.
: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"
: "${REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY:?Set REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY before running this example}"

curl --fail-with-body --max-time 30 -X POST 'https://app.reflections.ai/v1/events/evt_1h3k5m7p9r1t3v5x7z9b1d3f5h/resend' \
  -H "Authorization: Bearer $REFLECTIONS_KEY" \
  -H "Reflections-Version: 2026-10-15" \
  -H "Idempotency-Key: $REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "endpoint": "we_y18vejcjn8vvdfs468q4fzhtb2"
}'

import { env, exit } from "node:process";

// Set a unique key once per new action; persist it and reuse it for every retry.
const apiKey = env.REFLECTIONS_KEY;
if (!apiKey) throw new Error("Set REFLECTIONS_KEY before running this example");
const idempotencyKey = env.REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY;
if (!idempotencyKey) throw new Error("Set REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY before running this example");

const response = await fetch("https://app.reflections.ai/v1/events/evt_1h3k5m7p9r1t3v5x7z9b1d3f5h/resend", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Reflections-Version": "2026-10-15",
    "Idempotency-Key": idempotencyKey,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "endpoint": "we_y18vejcjn8vvdfs468q4fzhtb2"
  }),
  signal: AbortSignal.timeout(30_000),
});
const responseBody = await response.text();
if (!response.ok) {
  console.error(`HTTP ${response.status}: ${responseBody}`);
  exit(1);
}
console.log(responseBody);

import json
import os
from urllib.error import HTTPError
from urllib.request import Request, urlopen

# Set a unique key once per new action; persist it and reuse it for every retry.
apiKey = os.environ["REFLECTIONS_KEY"]
if not apiKey:
    raise ValueError("Set REFLECTIONS_KEY before running this example")
idempotencyKey = os.environ["REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY"]
if not idempotencyKey:
    raise ValueError("Set REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY before running this example")

headers = {
    "Authorization": f"Bearer {apiKey}",
    "Reflections-Version": "2026-10-15",
    "Idempotency-Key": idempotencyKey,
    "Content-Type": "application/json",
}
data = json.dumps({"endpoint": "we_y18vejcjn8vvdfs468q4fzhtb2"}).encode("utf-8")
request = Request("https://app.reflections.ai/v1/events/evt_1h3k5m7p9r1t3v5x7z9b1d3f5h/resend",
                  method="POST", headers=headers, data=data)
try:
    with urlopen(request, timeout=30) as response:
        print(response.read().decode("utf-8"))
except HTTPError as error:
    error_body = error.read().decode("utf-8")
    raise RuntimeError(f"HTTP {error.code}: {error_body}") from error

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    // Set a unique key once per new action; persist it and reuse it for every retry.
    apiKey := os.Getenv("REFLECTIONS_KEY")
    if apiKey == "" {
        panic("Set REFLECTIONS_KEY before running this example")
    }
    idempotencyKey := os.Getenv("REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY")
    if idempotencyKey == "" {
        panic("Set REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY before running this example")
    }

    body := strings.NewReader(`{
      "endpoint": "we_y18vejcjn8vvdfs468q4fzhtb2"
    }`)
    request, err := http.NewRequest("POST", "https://app.reflections.ai/v1/events/evt_1h3k5m7p9r1t3v5x7z9b1d3f5h/resend", body)
    if err != nil {
        panic(err)
    }
    request.Header.Set("Authorization", "Bearer " + apiKey)
    request.Header.Set("Reflections-Version", "2026-10-15")
    request.Header.Set("Idempotency-Key", idempotencyKey)
    request.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 30 * time.Second}
    response, err := client.Do(request)
    if err != nil {
        panic(err)
    }
    defer response.Body.Close()
    responseBody, err := io.ReadAll(response.Body)
    if err != nil {
        panic(err)
    }
    if response.StatusCode < 200 || response.StatusCode >= 300 {
        panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, responseBody))
    }
    fmt.Print(string(responseBody))
}

{
  "id": "evt_d3m3h3ycs6hxt7k37pam23cw1t",
  "object": "event",
  "type": "revocation.created",
  "api_version": "2026-10-15",
  "livemode": true,
  "account": null,
  "sequence": 1,
  "created_at": "2026-10-17T18:03:41Z",
  "data": {
    "object": {
      "id": "rvk_s9t0wxyhk5zba2q8v1m3n7p4r6",
      "object": "revocation",
      "livemode": true,
      "scope": "license",
      "targets": {
        "talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
        "licenses": [
          "lic_ba2q8v1m3n7p4r6s9t0wxyhk5z"
        ],
        "facets": [
          "fct_v1m3n7p4r6s9t0wxyhk5zba2q8"
        ],
        "mandate": null
      },
      "status": "pending_acknowledgement",
      "initiated_by": "talent",
      "for_cause": false,
      "cause": null,
      "note": null,
      "effective_at": "2026-10-17T18:03:40Z",
      "post_revocation": {
        "policy": "retain",
        "withdraw_by": null
      },
      "required_actions": [
        "stop_generation",
        "purge_cached_decisions",
        "delete_provider_copies"
      ],
      "provider_copies": [
        {
          "facet": "fct_v1m3n7p4r6s9t0wxyhk5zba2q8",
          "provider": "example-voice-provider",
          "external_id": "vx_4f9a2c"
        }
      ],
      "affected": {
        "checks_denied": 3,
        "generations_denied": 0,
        "sessions_terminated": 1,
        "released_outputs": 418
      },
      "acknowledge_by": "2026-10-18T18:03:40Z",
      "acknowledgements": [],
      "created_at": "2026-10-17T18:03:40Z"
    }
  }
}

{
  "type": "https://docs.reflections.ai/errors/parameter_invalid",
  "title": "A parameter is invalid",
  "status": 400,
  "code": "parameter_invalid",
  "param": "use.territories[1]",
  "detail": "\"UK\" is not an ISO 3166-1 alpha-2 code. Use \"GB\".",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/invalid_api_key",
  "title": "The API key is not valid",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/account_not_connected",
  "title": "The licensee has not connected your platform",
  "status": 403,
  "code": "account_not_connected",
  "detail": "acct_2q8v1m3n7p4r6s9t0wxyhk5zba has no active connection with your account.",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/resource_not_found",
  "title": "No such object",
  "status": 404,
  "code": "resource_not_found",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/idempotency_key_in_use",
  "title": "A request with this key is still running",
  "status": 409,
  "code": "idempotency_key_in_use",
  "detail": "Retry with the same key after a short wait.",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/idempotency_key_reused",
  "title": "This key was used for a different request",
  "status": 422,
  "code": "idempotency_key_reused",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "invalid_request",
  "request_id": "<string>",
  "detail": "<string>",
  "param": "<string>",
  "doc_url": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "invalid_request",
  "request_id": "<string>",
  "detail": "<string>",
  "param": "<string>",
  "doc_url": "<string>"
}

POST

events

{event_id}

resend

cURL

# Set a unique key once per new action; persist it and reuse it for every retry.
: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"
: "${REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY:?Set REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY before running this example}"

curl --fail-with-body --max-time 30 -X POST 'https://app.reflections.ai/v1/events/evt_1h3k5m7p9r1t3v5x7z9b1d3f5h/resend' \
  -H "Authorization: Bearer $REFLECTIONS_KEY" \
  -H "Reflections-Version: 2026-10-15" \
  -H "Idempotency-Key: $REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "endpoint": "we_y18vejcjn8vvdfs468q4fzhtb2"
}'

import { env, exit } from "node:process";

// Set a unique key once per new action; persist it and reuse it for every retry.
const apiKey = env.REFLECTIONS_KEY;
if (!apiKey) throw new Error("Set REFLECTIONS_KEY before running this example");
const idempotencyKey = env.REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY;
if (!idempotencyKey) throw new Error("Set REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY before running this example");

const response = await fetch("https://app.reflections.ai/v1/events/evt_1h3k5m7p9r1t3v5x7z9b1d3f5h/resend", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Reflections-Version": "2026-10-15",
    "Idempotency-Key": idempotencyKey,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "endpoint": "we_y18vejcjn8vvdfs468q4fzhtb2"
  }),
  signal: AbortSignal.timeout(30_000),
});
const responseBody = await response.text();
if (!response.ok) {
  console.error(`HTTP ${response.status}: ${responseBody}`);
  exit(1);
}
console.log(responseBody);

import json
import os
from urllib.error import HTTPError
from urllib.request import Request, urlopen

# Set a unique key once per new action; persist it and reuse it for every retry.
apiKey = os.environ["REFLECTIONS_KEY"]
if not apiKey:
    raise ValueError("Set REFLECTIONS_KEY before running this example")
idempotencyKey = os.environ["REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY"]
if not idempotencyKey:
    raise ValueError("Set REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY before running this example")

headers = {
    "Authorization": f"Bearer {apiKey}",
    "Reflections-Version": "2026-10-15",
    "Idempotency-Key": idempotencyKey,
    "Content-Type": "application/json",
}
data = json.dumps({"endpoint": "we_y18vejcjn8vvdfs468q4fzhtb2"}).encode("utf-8")
request = Request("https://app.reflections.ai/v1/events/evt_1h3k5m7p9r1t3v5x7z9b1d3f5h/resend",
                  method="POST", headers=headers, data=data)
try:
    with urlopen(request, timeout=30) as response:
        print(response.read().decode("utf-8"))
except HTTPError as error:
    error_body = error.read().decode("utf-8")
    raise RuntimeError(f"HTTP {error.code}: {error_body}") from error

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    // Set a unique key once per new action; persist it and reuse it for every retry.
    apiKey := os.Getenv("REFLECTIONS_KEY")
    if apiKey == "" {
        panic("Set REFLECTIONS_KEY before running this example")
    }
    idempotencyKey := os.Getenv("REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY")
    if idempotencyKey == "" {
        panic("Set REFLECTIONS_RESEND_EVENT_IDEMPOTENCY_KEY before running this example")
    }

    body := strings.NewReader(`{
      "endpoint": "we_y18vejcjn8vvdfs468q4fzhtb2"
    }`)
    request, err := http.NewRequest("POST", "https://app.reflections.ai/v1/events/evt_1h3k5m7p9r1t3v5x7z9b1d3f5h/resend", body)
    if err != nil {
        panic(err)
    }
    request.Header.Set("Authorization", "Bearer " + apiKey)
    request.Header.Set("Reflections-Version", "2026-10-15")
    request.Header.Set("Idempotency-Key", idempotencyKey)
    request.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 30 * time.Second}
    response, err := client.Do(request)
    if err != nil {
        panic(err)
    }
    defer response.Body.Close()
    responseBody, err := io.ReadAll(response.Body)
    if err != nil {
        panic(err)
    }
    if response.StatusCode < 200 || response.StatusCode >= 300 {
        panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, responseBody))
    }
    fmt.Print(string(responseBody))
}

{
  "id": "evt_d3m3h3ycs6hxt7k37pam23cw1t",
  "object": "event",
  "type": "revocation.created",
  "api_version": "2026-10-15",
  "livemode": true,
  "account": null,
  "sequence": 1,
  "created_at": "2026-10-17T18:03:41Z",
  "data": {
    "object": {
      "id": "rvk_s9t0wxyhk5zba2q8v1m3n7p4r6",
      "object": "revocation",
      "livemode": true,
      "scope": "license",
      "targets": {
        "talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
        "licenses": [
          "lic_ba2q8v1m3n7p4r6s9t0wxyhk5z"
        ],
        "facets": [
          "fct_v1m3n7p4r6s9t0wxyhk5zba2q8"
        ],
        "mandate": null
      },
      "status": "pending_acknowledgement",
      "initiated_by": "talent",
      "for_cause": false,
      "cause": null,
      "note": null,
      "effective_at": "2026-10-17T18:03:40Z",
      "post_revocation": {
        "policy": "retain",
        "withdraw_by": null
      },
      "required_actions": [
        "stop_generation",
        "purge_cached_decisions",
        "delete_provider_copies"
      ],
      "provider_copies": [
        {
          "facet": "fct_v1m3n7p4r6s9t0wxyhk5zba2q8",
          "provider": "example-voice-provider",
          "external_id": "vx_4f9a2c"
        }
      ],
      "affected": {
        "checks_denied": 3,
        "generations_denied": 0,
        "sessions_terminated": 1,
        "released_outputs": 418
      },
      "acknowledge_by": "2026-10-18T18:03:40Z",
      "acknowledgements": [],
      "created_at": "2026-10-17T18:03:40Z"
    }
  }
}

{
  "type": "https://docs.reflections.ai/errors/parameter_invalid",
  "title": "A parameter is invalid",
  "status": 400,
  "code": "parameter_invalid",
  "param": "use.territories[1]",
  "detail": "\"UK\" is not an ISO 3166-1 alpha-2 code. Use \"GB\".",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/invalid_api_key",
  "title": "The API key is not valid",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/account_not_connected",
  "title": "The licensee has not connected your platform",
  "status": 403,
  "code": "account_not_connected",
  "detail": "acct_2q8v1m3n7p4r6s9t0wxyhk5zba has no active connection with your account.",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/resource_not_found",
  "title": "No such object",
  "status": 404,
  "code": "resource_not_found",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/idempotency_key_in_use",
  "title": "A request with this key is still running",
  "status": 409,
  "code": "idempotency_key_in_use",
  "detail": "Retry with the same key after a short wait.",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/idempotency_key_reused",
  "title": "This key was used for a different request",
  "status": 422,
  "code": "idempotency_key_reused",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "https://docs.reflections.ai/errors/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "invalid_request",
  "request_id": "<string>",
  "detail": "<string>",
  "param": "<string>",
  "doc_url": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "invalid_request",
  "request_id": "<string>",
  "detail": "<string>",
  "param": "<string>",
  "doc_url": "<string>"
}

Authorizations

Authorization

string

header

required

Your secret key, rk_test_… or rk_live_…, sent as Authorization: Bearer <key>. Keep it on your server. Restricted keys carry only the scopes you give them.

Headers

Reflections-Version

string

The dated API version. Defaults to the version your account is pinned to.

Example:

"2026-10-15"

Idempotency-Key

string

A unique key for this operation, up to 255 characters. In test mode, POST keys are scoped to your account and mode and bind the endpoint and body for 24 hours. A different endpoint or body with the same key is refused.

Initial live check and generation creation require a nonempty key. Each operation has a separate account-scoped namespace; retain the same API key, body and idempotency key for retries within 24 hours of creation. A pending check returns 202 with status: "checking". Completed checks replay their sealed response; successful generation POSTs replay the original accepted 202, so use GET for current state. Live verification is a read-only query that returns a fresh verification ID on each call, without exact response caching.

The broader delegated-account contract also scopes keys to Reflections-Account; delegated requests and the other planned live POST operations remain unsupported.

Maximum string length: 255

Path Parameters

event_id

string

required

The event's ID, equal to the webhook-id header of its deliveries.

Pattern: ^evt_[0-9a-hjkmnp-tv-z]{26}$

Body

application/json

endpoint

string

Resend only to this endpoint.

Pattern: ^we_[0-9a-hjkmnp-tv-z]{26}$

Response

The event, queued for delivery.

An event of any type. type names it, and data.object is the object that type carries.

string

required

Equal to the webhook-id header.

Pattern: ^evt_[0-9a-hjkmnp-tv-z]{26}$

object

string

required

Always event.

Allowed value: "event"

type

enum<string>

required

The event type, one of the license.* event types.

Available options:

license.issued,

license.accepted,

license.revised,

license.revision_pending,

license.revision_declined,

license.suspended,

license.resumed,

license.revoked,

license.expired,

license.declined

api_version

string

required

The API version data.object is rendered in.

livemode

boolean

required

true for live events, false for test events.

sequence

integer

required

Increases by one with each event about the same object. Ignore an event whose sequence is lower than one you have processed.

created_at

string<date-time>

required

When the event happened.

data

object

required

The license in object and, when the event changed it, the old values of the changed fields in previous_attributes.

Show child attributes

account

string | null

The connected licensee the event concerns, when it is not your own account.

Pattern: ^acct_[0-9a-hjkmnp-tv-z]{26}$

Overview

Account

Talent

Facets

Resolutions

Licenses

License requests

Connections

Files

Checks

Generations

Sessions

Receipts

Verifications

Revocations

Usage records

Statements

Mandates

Escalations

License drafts

Webhook endpoints

Events

Discovery

OAuth

Test helpers

Webhooks

Real-time

Formats

MCP

Authorizations

Headers

Path Parameters

Body

Response