openapi: 3.1.0
info:
title: Svix Application Statistics API
description: 'Welcome to the Svix API documentation!
Useful links: [Homepage](https://www.svix.com) | [Support email](mailto:support+docs@svix.com) | [Blog](https://www.svix.com/blog/) | [Slack Community](https://www.svix.com/slack/)
# Introduction
This is the reference documentation and schemas for the [Svix webhook service](https://www.svix.com) API. For tutorials and other documentation please refer to [the documentation](https://docs.svix.com).
## Main concepts
In Svix you have four important entities you will be interacting with:
- `messages`: these are the webhooks being sent. They can have contents and a few other properties.
- `application`: this is where `messages` are sent to. Usually you want to create one application for each user on your platform.
- `endpoint`: endpoints are the URLs messages will be sent to. Each application can have multiple `endpoints` and each message sent to that application will be sent to all of them (unless they are not subscribed to the sent event type).
- `event-type`: event types are identifiers denoting the type of the message being sent. Event types are primarily used to decide which events are sent to which endpoint.
## Authentication
Get your authentication token (`AUTH_TOKEN`) from the [Svix dashboard](https://dashboard.svix.com) and use it as part of the `Authorization` header as such: `Authorization: Bearer ${AUTH_TOKEN}`. For more information on authentication, please refer to the [authentication token docs](https://docs.svix.com/api-keys).
<SecurityDefinitions />
## Code samples
The code samples assume you already have the respective libraries installed and you know how to use them. For the latest information on how to do that, please refer to [the documentation](https://docs.svix.com/).
## Idempotency
Svix supports [idempotency](https://en.wikipedia.org/wiki/Idempotence) for safely retrying requests without accidentally performing the same operation twice. This is useful when an API call is disrupted in transit and you do not receive a response.
To perform an idempotent request, pass the idempotency key in the `Idempotency-Key` header to the request. The idempotency key should be a unique value generated by the client. You can create the key in however way you like, though we suggest using UUID v4, or any other string with enough entropy to avoid collisions. Your idempotency key should not begin with the string `auto_`, which is reserved for internal use by the client libraries.
Svix''s idempotency works by saving the resulting status code and body of the first request made for any given idempotency key for any successful request. Subsequent requests with the same key return the same result for a period of up to 12 hours.
Please note that idempotency is only supported for `POST` requests.
## Cross-Origin Resource Sharing
This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/). And that allows cross-domain communication from the browser. All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site.
'
version: 1.84.0
x-logo:
altText: Svix Logo
url: https://www.svix.com/static/img/brand-padded.svg
servers:
- url: https://api.eu.svix.com/
description: The Svix EU region
- url: https://api.us.svix.com/
description: The Svix US region
- url: https://api.ca.svix.com/
description: The Svix Canada region
- url: https://api.au.svix.com/
description: The Svix Australia region
- url: https://api.in.svix.com/
description: The Svix India region
tags:
- name: Statistics
description: Generate statistics about your Svix utilization
paths:
/api/v1/stats/usage/app:
post:
tags:
- Statistics
summary: Aggregate App Stats
description: "Creates a background task to calculate the number of message attempts (`messageDestinations`) made for all applications in the environment.\n\nNote that this endpoint is asynchronous. You will need to poll the `Get Background Task` endpoint to\nretrieve the results of the operation.\n\nThe completed background task will return a payload like the following:\n```json\n{\n \"id\": \"qtask_33qe39Stble9Rn3ZxFrqL5ZSsjT\",\n \"status\": \"finished\",\n \"task\": \"application.stats\",\n \"data\": {\n \"appStats\": [\n {\n \"messageDestinations\": 2,\n \"appId\": \"app_33W1An2Zz5cO9SWbhHsYyDmVC6m\",\n \"appUid\": null\n }\n ]\n }\n}\n```"
operationId: v1.statistics.aggregate-app-stats
parameters:
- in: header
name: idempotency-key
description: The request's idempotency key
schema:
type: string
style: simple
- in: header
name: idempotency-key
description: The request's idempotency key
schema:
type: string
style: simple
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AppUsageStatsIn'
required: true
responses:
'202':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/AppUsageStatsOut'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'409':
description: Conflict
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
security:
- HTTPBearer: []
x-codeSamples:
- label: JavaScript
lang: TypeScript
source: "const response = await svix.statistics.aggregateAppStats({\n appIds: [],\n since: new Date(\"2025-10-02T20:28:42+00:00\"),\n until: new Date(\"2025-10-02T20:28:42+00:00\"),\n});"
- label: TypeScript
lang: TypeScript
source: "const response = await svix.statistics.aggregateAppStats({\n appIds: [],\n since: new Date(\"2025-10-02T20:28:42+00:00\"),\n until: new Date(\"2025-10-02T20:28:42+00:00\"),\n});"
- label: Python
lang: Python
source: "response = svix.statistics.aggregate_app_stats(\n AppUsageStatsIn(\n app_ids=[],\n since=datetime.fromisoformat(\"2025-10-02T20:28:42+00:00\"),\n until=datetime.fromisoformat(\"2025-10-02T20:28:42+00:00\"),\n ),\n)"
- label: Python (Async)
lang: Python
source: "response = await svix.statistics.aggregate_app_stats(\n AppUsageStatsIn(\n app_ids=[],\n since=datetime.fromisoformat(\"2025-10-02T20:28:42+00:00\"),\n until=datetime.fromisoformat(\"2025-10-02T20:28:42+00:00\"),\n ),\n)"
- label: Go
lang: Go
source: "response, err := svix.Statistics.AggregateAppStats(\n\tctx,\n\tAppUsageStatsIn{\n\t\tAppIds: []string{},\n\t\tSince: time.Date(2025, 10, 2, 20, 28, 42, 0, time.UTC),\n\t\tUntil: time.Date(2025, 10, 2, 20, 28, 42, 0, time.UTC),\n\t},\n\tnil,\n)"
- label: Kotlin
lang: Kotlin
source: "val response =\n svix.statistics.aggregateAppStats(\n AppUsageStatsIn(\n appIds = setOf(),\n since = Instant.parse(\"2025-10-02T20:28:42+00:00\"),\n until = Instant.parse(\"2025-10-02T20:28:42+00:00\"),\n )\n )"
- label: Java
lang: Java
source: "var response = svix.getStatistics()\n .aggregateAppStats(new AppUsageStatsIn()\n .appIds(Set.of())\n .since(OffsetDateTime.parse(\"2025-10-02T20:28:42+00:00\"))\n .until(OffsetDateTime.parse(\"2025-10-02T20:28:42+00:00\")));"
- label: Ruby
lang: Ruby
source: "response = svix\n .statistics\n .aggregate_app_stats({appIds: [], since: \"2025-10-02T20:28:42+00:00\", until: \"2025-10-02T20:28:42+00:00\"})"
- label: Rust
lang: Rust
source: "let response = svix\n .statistics()\n .aggregate_app_stats(\n AppUsageStatsIn {\n app_ids: Some(vec![]),\n since: \"2025-10-02T20:28:42+00:00\".to_string(),\n until: \"2025-10-02T20:28:42+00:00\".to_string(),\n },\n None,\n )\n .await?;"
- label: C#
lang: C#
source: "var response = svix.Statistics.AggregateAppStats(\n new AppUsageStatsIn\n {\n AppIds = [],\n Since = DateTime.Parse(\"2025-10-02T20:28:42+00:00\"),\n Until = DateTime.Parse(\"2025-10-02T20:28:42+00:00\"),\n }\n);"
- label: PHP
lang: PHP
source: "$response = $svix->statistics->aggregateAppStats(\n AppUsageStatsIn::create(\n since: new DateTimeImmutable(\"2025-10-02T20:28:42+00:00\"),\n until: new DateTimeImmutable(\"2025-10-02T20:28:42+00:00\")\n )\n ->withAppIds([])\n);"
- label: CLI
lang: Shell
source: "svix statistics aggregate-app-stats '{\n \"appIds\": [],\n \"since\": \"2025-10-02T20:28:42+00:00\",\n \"until\": \"2025-10-02T20:28:42+00:00\"\n }'"
- label: cURL
lang: Shell
source: "curl -X 'POST' \\\n 'https://api.eu.svix.com/api/v1/stats/usage/app' \\\n -H 'Authorization: Bearer AUTH_TOKEN' \\\n -H 'Accept: application/json' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"appIds\": [],\n \"since\": \"2025-10-02T20:28:42+00:00\",\n \"until\": \"2025-10-02T20:28:42+00:00\"\n }'"
/api/v1/stats/usage/event-types:
put:
tags:
- Statistics
summary: Aggregate Event Types
description: "Creates a background task to calculate the listed event types for all apps in the organization.\n\nNote that this endpoint is asynchronous. You will need to poll the `Get Background Task` endpoint to\nretrieve the results of the operation.\n\nThe completed background task will return a payload like the following:\n```json\n{\n \"id\": \"qtask_33qe39Stble9Rn3ZxFrqL5ZSsjT\",\n \"status\": \"finished\",\n \"task\": \"event-type.aggregate\",\n \"data\": {\n \"event_types\": [\n {\n \"appId\": \"app_33W1An2Zz5cO9SWbhHsYyDmVC6m\",\n \"explicitlySubscribedEventTypes\": [\"user.signup\", \"user.deleted\"],\n \"hasCatchAllEndpoint\": false\n }\n ]\n }\n}\n```"
operationId: v1.statistics.aggregate-event-types
responses:
'202':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/AggregateEventTypesOut'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'409':
description: Conflict
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/HttpErrorOut'
security:
- HTTPBearer: []
x-codeSamples:
- label: JavaScript
lang: TypeScript
source: const response = await svix.statistics.aggregateEventTypes();
- label: TypeScript
lang: TypeScript
source: const response = await svix.statistics.aggregateEventTypes();
- label: Python
lang: Python
source: response = svix.statistics.aggregate_event_types()
- label: Python (Async)
lang: Python
source: response = await svix.statistics.aggregate_event_types()
- label: Go
lang: Go
source: response, err := svix.Statistics.AggregateEventTypes(ctx)
- label: Kotlin
lang: Kotlin
source: val response = svix.statistics.aggregateEventTypes()
- label: Java
lang: Java
source: var response = svix.getStatistics().aggregateEventTypes();
- label: Ruby
lang: Ruby
source: response = svix.statistics.aggregate_event_types
- label: Rust
lang: Rust
source: let response = svix.statistics().aggregate_event_types().await?;
- label: C#
lang: C#
source: var response = svix.Statistics.AggregateEventTypes();
- label: PHP
lang: PHP
source: $response = $svix->statistics->aggregateEventTypes();
- label: CLI
lang: Shell
source: svix statistics aggregate-event-types
- label: cURL
lang: Shell
source: "curl -X 'PUT' \\\n 'https://api.eu.svix.com/api/v1/stats/usage/event-types' \\\n -H 'Authorization: Bearer AUTH_TOKEN' \\\n -H 'Accept: application/json'"
components:
schemas:
HTTPValidationError:
type: object
required:
- detail
properties:
detail:
type: array
items:
$ref: '#/components/schemas/ValidationError'
ValidationError:
description: Validation errors have their own schema to provide context for invalid requests eg. mismatched types and out of bounds values. There may be any number of these per 422 UNPROCESSABLE ENTITY error.
type: object
required:
- loc
- msg
- type
properties:
loc:
description: The location as a [`Vec`] of [`String`]s -- often in the form `["body", "field_name"]`, `["query", "field_name"]`, etc. They may, however, be arbitrarily deep.
type: array
items:
type: string
msg:
description: The message accompanying the validation error item.
type: string
type:
description: The type of error, often "type_error" or "value_error", but sometimes with more context like as "value_error.number.not_ge"
type: string
BackgroundTaskType:
type: string
enum:
- endpoint.replay
- endpoint.recover
- application.stats
- message.broadcast
- sdk.generate
- event-type.aggregate
- application.purge_content
- endpoint.bulk-replay
AppUsageStatsIn:
type: object
required:
- since
- until
properties:
appIds:
description: 'Specific app IDs or UIDs to aggregate stats for.
Note that if none of the given IDs or UIDs are resolved, a 422 response will be given.'
type: array
items:
description: The Application's ID or UID.
type: string
maxLength: 256
minLength: 1
pattern: ^[a-zA-Z0-9\-_.]+$
example: unique-identifier
uniqueItems: true
nullable: true
since:
type: string
format: date-time
until:
type: string
format: date-time
BackgroundTaskStatus:
type: string
enum:
- running
- finished
- failed
AppUsageStatsOut:
type: object
required:
- id
- status
- task
- unresolvedAppIds
- updatedAt
properties:
id:
description: The QueueBackgroundTask's ID.
type: string
maxLength: 33
minLength: 33
pattern: ^qtask_[A-Za-z0-9]{27}$
example: qtask_1srOrx2ZWZBpBUvZwXKQmoEYga2
status:
$ref: '#/components/schemas/BackgroundTaskStatus'
task:
$ref: '#/components/schemas/BackgroundTaskType'
unresolvedAppIds:
description: 'Any app IDs or UIDs received in the request that weren''t found.
Stats will be produced for all the others.'
type: array
items:
description: The Application's ID or UID.
type: string
maxLength: 256
minLength: 1
pattern: ^[a-zA-Z0-9\-_.]+$
example: unique-identifier
uniqueItems: true
updatedAt:
type: string
format: date-time
AggregateEventTypesOut:
type: object
required:
- id
- status
- task
- updatedAt
properties:
id:
description: The QueueBackgroundTask's ID.
type: string
maxLength: 33
minLength: 33
pattern: ^qtask_[A-Za-z0-9]{27}$
example: qtask_1srOrx2ZWZBpBUvZwXKQmoEYga2
status:
$ref: '#/components/schemas/BackgroundTaskStatus'
task:
$ref: '#/components/schemas/BackgroundTaskType'
updatedAt:
type: string
format: date-time
HttpErrorOut:
title: HttpError
type: object
required:
- code
- detail
properties:
code:
type: string
detail:
type: string
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
description: HTTP Bearer token passed in the `Authorization` header
x-tagGroups:
- name: General
tags:
- Background Task
- Environment
- name: Dispatch
tags:
- Application
- Event Type
- Authentication
- Endpoint
- Message
- Message Attempt
- Integration
- Connector
- name: Stream
tags:
- Stream
- Sink
- Event
- Stream Event Type
- Stream Authentication
- name: Ingest
tags:
- Ingest Source
- Ingest Endpoint
- name: Operational Webhooks
tags:
- Webhook
- Webhook Endpoint
- name: Statistics
tags:
- Statistics
- name: Utility
tags:
- Health
x-webhooks:
background_task.finished:
post:
description: Sent when a background task is finished.
operationId: background_task.finished
requestBody:
content:
application/json:
example:
data:
data:
appStats:
- appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: null
messageDestinations: 343
status: finished
task: application.stats
taskId: qtask_1srOrx2ZWZBpBUvZwXKQmoEYga2
type: background_task.finished
schema:
$ref: '#/components/schemas/BackgroundTaskFinishedEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: background_task.finished
tags:
- Webhook
endpoint.created:
post:
description: Sent when an endpoint is created.
operationId: endpoint.created
requestBody:
content:
application/json:
example:
data:
appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: unique-app-identifier
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
endpointUid: unique-endpoint-identifier
type: endpoint.created
schema:
$ref: '#/components/schemas/EndpointCreatedEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: endpoint.created
tags:
- Webhook
x-svix-group-name: dispatch
endpoint.deleted:
post:
description: Sent when an endpoint is deleted.
operationId: endpoint.deleted
requestBody:
content:
application/json:
example:
data:
appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: unique-app-identifier
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
endpointUid: unique-endpoint-identifier
type: endpoint.deleted
schema:
$ref: '#/components/schemas/EndpointDeletedEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: endpoint.deleted
tags:
- Webhook
x-svix-group-name: dispatch
endpoint.disabled:
post:
description: Sent when an endpoint has been automatically disabled after continuous failures, or manually via an API call.
operationId: endpoint.disabled
requestBody:
content:
application/json:
example:
data:
appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: unique-app-identifier
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
endpointUid: unique-endpoint-identifier
failSince: '2022-11-06T15:04:05Z'
trigger: automatic
type: endpoint.disabled
schema:
$ref: '#/components/schemas/EndpointDisabledEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: endpoint.disabled
tags:
- Webhook
x-svix-group-name: dispatch
endpoint.enabled:
post:
description: Sent when an endpoint has been enabled.
operationId: endpoint.enabled
requestBody:
content:
application/json:
example:
data:
appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: unique-app-identifier
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
endpointUid: unique-endpoint-identifier
type: endpoint.enabled
schema:
$ref: '#/components/schemas/EndpointEnabledEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: endpoint.enabled
tags:
- Webhook
x-svix-group-name: dispatch
endpoint.updated:
post:
description: Sent when an endpoint is updated.
operationId: endpoint.updated
requestBody:
content:
application/json:
example:
data:
appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: unique-app-identifier
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
endpointUid: unique-endpoint-identifier
type: endpoint.updated
schema:
$ref: '#/components/schemas/EndpointUpdatedEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: endpoint.updated
tags:
- Webhook
x-svix-group-name: dispatch
ingest.endpoint.disabled:
post:
description: Sent when an ingest endpoint has been automatically disabled after continuous failures, or manually via an API call.
operationId: ingest.endpoint.disabled
requestBody:
content:
application/json:
example:
data:
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
endpointUid: unique-endpoint-identifier
failSince: '2022-11-06T15:04:05Z'
sourceId: src_30HT9jb8WZXKVWIO44ZDr
trigger: automatic
type: ingest.endpoint.disabled
schema:
$ref: '#/components/schemas/IngestEndpointDisabledEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: ingest.endpoint.disabled
tags:
- Webhook
ingest.message.attempt.exhausted:
post:
description: Sent when a message delivery has failed (all of the retry attempts have been exhausted).
operationId: ingest.message.attempt.exhausted
requestBody:
content:
application/json:
example:
data:
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
lastAttempt:
id: atmpt_1srOrx2ZWZBpBUvZwXKQmoEYga2
responseStatusCode: 500
timestamp: '2022-11-06T15:04:05Z'
msgEventId: unique-msg-identifier
msgId: msg_1srOrx2ZWZBpBUvZwXKQmoEYga2
sourceId: src_30HT9jb8WZXKVWIO44ZDr
type: ingest.message.attempt.exhausted
schema:
$ref: '#/components/schemas/IngestMessageAttemptExhaustedEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: ingest.message.attempt.exhausted
tags:
- Webhook
ingest.message.attempt.failing:
post:
description: 'Sent after a message has been failing for a few times.
It''s sent on the fourth failure. It complements `ingest.message.attempt.exhausted` which is sent after the last failure.'
operationId: ingest.message.attempt.failing
requestBody:
content:
application/json:
example:
data:
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
lastAttempt:
id: atmpt_1srOrx2ZWZBpBUvZwXKQmoEYga2
responseStatusCode: 500
timestamp: '2022-11-06T15:04:05Z'
msgEventId: unique-msg-identifier
msgId: msg_1srOrx2ZWZBpBUvZwXKQmoEYga2
sourceId: src_30HT9jb8WZXKVWIO44ZDr
type: ingest.message.attempt.failing
schema:
$ref: '#/components/schemas/IngestMessageAttemptFailingEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: ingest.message.attempt.failing
tags:
- Webhook
ingest.message.attempt.recovered:
post:
description: Sent on a successful dispatch after an earlier failure op webhook has already been sent.
operationId: ingest.message.attempt.recovered
requestBody:
content:
application/json:
example:
data:
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
lastAttempt:
id: atmpt_1srOrx2ZWZBpBUvZwXKQmoEYga2
responseStatusCode: 200
timestamp: '2022-11-06T15:04:05Z'
msgEventId: unique-msg-identifier
msgId: msg_1srOrx2ZWZBpBUvZwXKQmoEYga2
sourceId: src_30HT9jb8WZXKVWIO44ZDr
type: ingest.message.attempt.recovered
schema:
$ref: '#/components/schemas/IngestMessageAttemptRecoveredEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: ingest.message.attempt.recovered
tags:
- Webhook
message.attempt.exhausted:
post:
description: Sent when a message delivery has failed (all of the retry attempts have been exhausted).
operationId: message.attempt.exhausted
requestBody:
content:
application/json:
example:
data:
appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: unique-app-identifier
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
lastAttempt:
id: atmpt_1srOrx2ZWZBpBUvZwXKQmoEYga2
responseStatusCode: 500
timestamp: '2022-11-06T15:04:05Z'
msgEventId: unique-msg-identifier
msgId: msg_1srOrx2ZWZBpBUvZwXKQmoEYga2
type: message.attempt.exhausted
schema:
$ref: '#/components/schemas/MessageAttemptExhaustedEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: message.attempt.exhausted
tags:
- Webhook
x-svix-group-name: dispatch
message.attempt.failing:
post:
description: 'Sent after a message has been failing for a few times.
It''s sent on the fourth failure. It complements `message.attempt.exhausted` which is sent after the last failure.'
operationId: message.attempt.failing
requestBody:
content:
application/json:
example:
data:
appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: unique-app-identifier
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
lastAttempt:
id: atmpt_1srOrx2ZWZBpBUvZwXKQmoEYga2
responseStatusCode: 500
timestamp: '2022-11-06T15:04:05Z'
msgEventId: unique-msg-identifier
msgId: msg_1srOrx2ZWZBpBUvZwXKQmoEYga2
type: message.attempt.failing
schema:
$ref: '#/components/schemas/MessageAttemptFailingEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: message.attempt.failing
tags:
- Webhook
x-svix-group-name: dispatch
message.attempt.log:
post:
description: Sent after message attempts are made. Contains metadata about message attempts and their results. In order to reduce the frequency of webhooks, these are sent in batches periodically.
operationId: message.attempt.log
requestBody:
content:
application/json:
example:
data:
- appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: unique-app-identifier
attemptCount: 1
attemptEnd: '2022-11-06T15:04:07Z'
attemptId: atmpt_1srOrx2ZWZBpBUvZwXKQmoEYga2
attemptStart: '2022-11-06T15:04:06Z'
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
eventType: user.signup
msgCreated: '2022-11-06T15:04:05Z'
msgEventId: unique-msg-identifier
msgId: msg_1srOrx2ZWZBpBUvZwXKQmoEYga2
orgId: env_1srOrx2ZWZBpBUvZwXKQmoEYga2
responseStatusCode: 200
status: 0
type: message.attempt.log
schema:
$ref: '#/components/schemas/MessageAttemptLogEvent'
responses:
2XX:
description: Return any 2XX status to indicate that the data was received successfully
summary: message.attempt.log
tags:
- Webhook
x-internal: true
x-svix-feature-flags:
- attempt_log
x-svix-group-name: dispatch
message.attempt.recovered:
post:
description: Sent on a successful dispatch after an earlier failure op webhook has already been sent.
operationId: message.attempt.recovered
requestBody:
content:
application/json:
example:
data:
appId: app_1srOrx2ZWZBpBUvZwXKQmoEYga2
appUid: unique-app-identifier
endpointId: ep_1srOrx2ZWZBpBUvZwXKQmoEYga2
lastAttempt:
i
# --- truncated at 32 KB (32 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/svix/refs/heads/main/openapi/svix-statistics-api-openapi.yml