Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Svix Integration 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.922.0
x-logo:
url: https://www.svix.com/static/img/brand-padded.svg
altText: Svix Logo
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: Integration
description: Integrations are services your users connect an application to. An integration can manage the application and its endpoints.
paths:
/api/v1/app/{app_id}/integration:
get:
tags:
- Integration
summary: List Integrations
description: List the application's integrations.
operationId: v1.integration.list
parameters:
- in: path
name: app_id
description: The Application's ID or UID.
required: true
schema:
description: The Application's ID or UID.
type: string
maxLength: 256
minLength: 1
pattern: ^[a-zA-Z0-9\-_.]+$
example: unique-identifier
style: simple
- in: query
name: limit
description: Limit the number of returned items
schema:
description: Limit the number of returned items
type: integer
format: uint64
maximum: 250
minimum: 1.0
style: form
- in: query
name: iterator
description: The iterator returned from a prior invocation
schema:
description: The iterator returned from a prior invocation
type: string
maxLength: 33
minLength: 33
pattern: ^integ_[A-Za-z0-9]{27}$
nullable: true
example: integ_1srOrx2ZWZBpBUvZwXKQmoEYga2
style: form
- in: query
name: order
description: The sorting order of the returned items
schema:
description: The sorting order of the returned items
$ref: '#/components/schemas/Ordering'
nullable: true
style: form
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ListResponse_IntegrationOut_'
'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:
- lang: TypeScript
label: JavaScript
source: const response = await svix.integration.list("app_1srOrx2ZWZBpBUvZwXKQmoEYga2");
- lang: TypeScript
label: TypeScript
source: const response = await svix.integration.list("app_1srOrx2ZWZBpBUvZwXKQmoEYga2");
- lang: Python
label: Python
source: "response = svix.integration.list(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n)"
- lang: Python
label: Python (Async)
source: "response = await svix.integration.list(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n)"
- lang: Go
label: Go
source: response, err := svix.Integration.List(ctx, "app_1srOrx2ZWZBpBUvZwXKQmoEYga2", nil)
- lang: Kotlin
label: Kotlin
source: val response = svix.integration.list("app_1srOrx2ZWZBpBUvZwXKQmoEYga2")
- lang: Java
label: Java
source: var response = svix.getIntegration().list("app_1srOrx2ZWZBpBUvZwXKQmoEYga2");
- lang: Ruby
label: Ruby
source: response = svix.integration.list("app_1srOrx2ZWZBpBUvZwXKQmoEYga2")
- lang: Rust
label: Rust
source: "let response = svix\n .integration()\n .list(\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\".to_string(), None)\n .await?;"
- lang: C#
label: C#
source: var response = svix.Integration.List("app_1srOrx2ZWZBpBUvZwXKQmoEYga2");
- lang: PHP
label: PHP
source: "$response = $svix->integration->list(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\"\n);"
- lang: Shell
label: CLI
source: svix integration list "app_1srOrx2ZWZBpBUvZwXKQmoEYga2"
- lang: Shell
label: cURL
source: "curl -X 'GET' \\\n 'https://api.eu.svix.com/api/v1/app/app_1srOrx2ZWZBpBUvZwXKQmoEYga2/integration' \\\n -H 'Authorization: Bearer AUTH_TOKEN' \\\n -H 'Accept: application/json'"
post:
tags:
- Integration
summary: Create Integration
description: Create an integration.
operationId: v1.integration.create
parameters:
- in: path
name: app_id
description: The Application's ID or UID.
required: true
schema:
description: The Application's ID or UID.
type: string
maxLength: 256
minLength: 1
pattern: ^[a-zA-Z0-9\-_.]+$
example: unique-identifier
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/IntegrationIn'
required: true
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationOut'
'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:
- lang: TypeScript
label: JavaScript
source: "const response = await svix.integration.create(\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\", {\n name: \"Example Integration\",\n featureFlags: [],\n});"
- lang: TypeScript
label: TypeScript
source: "const response = await svix.integration.create(\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\", {\n name: \"Example Integration\",\n featureFlags: [],\n});"
- lang: Python
label: Python
source: "response = svix.integration.create(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n IntegrationIn(\n name=\"Example Integration\",\n feature_flags=[],\n ),\n)"
- lang: Python
label: Python (Async)
source: "response = await svix.integration.create(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n IntegrationIn(\n name=\"Example Integration\",\n feature_flags=[],\n ),\n)"
- lang: Go
label: Go
source: "response, err := svix.Integration.Create(\n\tctx,\n\t\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n\tIntegrationIn{Name: \"Example Integration\", FeatureFlags: []string{}},\n\tnil,\n)"
- lang: Kotlin
label: Kotlin
source: "val response =\n svix.integration.create(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n IntegrationIn(name = \"Example Integration\", featureFlags = setOf()),\n )"
- lang: Java
label: Java
source: "var response = svix.getIntegration()\n .create(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n new IntegrationIn().name(\"Example Integration\").featureFlags(Set.of()));"
- lang: Ruby
label: Ruby
source: 'response = svix.integration.create("app_1srOrx2ZWZBpBUvZwXKQmoEYga2", {name: "Example Integration", featureFlags: []})'
- lang: Rust
label: Rust
source: "let response = svix\n .integration()\n .create(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\".to_string(),\n IntegrationIn {\n name: \"Example Integration\".to_string(),\n feature_flags: Some(vec![]),\n },\n None,\n )\n .await?;"
- lang: C#
label: C#
source: "var response = svix.Integration.Create(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n new IntegrationIn { Name = \"Example Integration\", FeatureFlags = [] }\n);"
- lang: PHP
label: PHP
source: "$response = $svix->integration->create(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n IntegrationIn::create(\n name: \"Example Integration\"\n )\n ->withFeatureFlags([])\n);"
- lang: Shell
label: CLI
source: "svix integration create \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\" '{\n \"name\": \"Example Integration\",\n \"featureFlags\": []\n }'"
- lang: Shell
label: cURL
source: "curl -X 'POST' \\\n 'https://api.eu.svix.com/api/v1/app/app_1srOrx2ZWZBpBUvZwXKQmoEYga2/integration' \\\n -H 'Authorization: Bearer AUTH_TOKEN' \\\n -H 'Accept: application/json' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"name\": \"Example Integration\",\n \"featureFlags\": []\n }'"
/api/v1/app/{app_id}/integration/{integ_id}:
get:
tags:
- Integration
summary: Get Integration
description: Get an integration.
operationId: v1.integration.get
parameters:
- in: path
name: app_id
description: The Application's ID or UID.
required: true
schema:
description: The Application's ID or UID.
type: string
maxLength: 256
minLength: 1
pattern: ^[a-zA-Z0-9\-_.]+$
example: unique-identifier
style: simple
- in: path
name: integ_id
description: The Integration's ID.
required: true
schema:
description: The Integration's ID.
type: string
maxLength: 33
minLength: 33
pattern: ^integ_[A-Za-z0-9]{27}$
example: integ_1srOrx2ZWZBpBUvZwXKQmoEYga2
style: simple
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationOut'
'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:
- lang: TypeScript
label: JavaScript
source: "const response = await svix.integration.get(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\"\n);"
- lang: TypeScript
label: TypeScript
source: "const response = await svix.integration.get(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\"\n);"
- lang: Python
label: Python
source: "response = svix.integration.get(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n)"
- lang: Python
label: Python (Async)
source: "response = await svix.integration.get(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n)"
- lang: Go
label: Go
source: "response, err := svix.Integration.Get(\n\tctx,\n\t\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n\t\"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n)"
- lang: Kotlin
label: Kotlin
source: "val response =\n svix.integration.get(\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\", \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\")"
- lang: Java
label: Java
source: "var response = svix.getIntegration()\n .get(\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\", \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\");"
- lang: Ruby
label: Ruby
source: response = svix.integration.get("app_1srOrx2ZWZBpBUvZwXKQmoEYga2", "integ_1srOrx2ZWZBpBUvZwXKQmoEYga2")
- lang: Rust
label: Rust
source: "let response = svix\n .integration()\n .get(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\".to_string(),\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\".to_string(),\n )\n .await?;"
- lang: C#
label: C#
source: "var response = svix.Integration.Get(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\"\n);"
- lang: PHP
label: PHP
source: "$response = $svix->integration->get(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\"\n);"
- lang: Shell
label: CLI
source: svix integration get "app_1srOrx2ZWZBpBUvZwXKQmoEYga2" "integ_1srOrx2ZWZBpBUvZwXKQmoEYga2"
- lang: Shell
label: cURL
source: "curl -X 'GET' \\\n 'https://api.eu.svix.com/api/v1/app/app_1srOrx2ZWZBpBUvZwXKQmoEYga2/integration/integ_1srOrx2ZWZBpBUvZwXKQmoEYga2' \\\n -H 'Authorization: Bearer AUTH_TOKEN' \\\n -H 'Accept: application/json'"
put:
tags:
- Integration
summary: Update Integration
description: Update an integration.
operationId: v1.integration.update
parameters:
- in: path
name: app_id
description: The Application's ID or UID.
required: true
schema:
description: The Application's ID or UID.
type: string
maxLength: 256
minLength: 1
pattern: ^[a-zA-Z0-9\-_.]+$
example: unique-identifier
style: simple
- in: path
name: integ_id
description: The Integration's ID.
required: true
schema:
description: The Integration's ID.
type: string
maxLength: 33
minLength: 33
pattern: ^integ_[A-Za-z0-9]{27}$
example: integ_1srOrx2ZWZBpBUvZwXKQmoEYga2
style: simple
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationUpdate'
required: true
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationOut'
'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:
- lang: TypeScript
label: JavaScript
source: "const response = await svix.integration.update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n {\n name: \"Example Integration\",\n featureFlags: [],\n }\n);"
- lang: TypeScript
label: TypeScript
source: "const response = await svix.integration.update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n {\n name: \"Example Integration\",\n featureFlags: [],\n }\n);"
- lang: Python
label: Python
source: "response = svix.integration.update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n IntegrationUpdate(\n name=\"Example Integration\",\n feature_flags=[],\n ),\n)"
- lang: Python
label: Python (Async)
source: "response = await svix.integration.update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n IntegrationUpdate(\n name=\"Example Integration\",\n feature_flags=[],\n ),\n)"
- lang: Go
label: Go
source: "response, err := svix.Integration.Update(\n\tctx,\n\t\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n\t\"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n\tIntegrationUpdate{Name: \"Example Integration\", FeatureFlags: []string{}},\n)"
- lang: Kotlin
label: Kotlin
source: "val response =\n svix.integration.update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n IntegrationUpdate(name = \"Example Integration\", featureFlags = setOf()),\n )"
- lang: Java
label: Java
source: "var response = svix.getIntegration()\n .update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n new IntegrationUpdate().name(\"Example Integration\").featureFlags(Set.of()));"
- lang: Ruby
label: Ruby
source: "response = svix\n .integration\n .update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n {name: \"Example Integration\", featureFlags: []}\n )"
- lang: Rust
label: Rust
source: "let response = svix\n .integration()\n .update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\".to_string(),\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\".to_string(),\n IntegrationUpdate {\n name: \"Example Integration\".to_string(),\n feature_flags: Some(vec![]),\n },\n )\n .await?;"
- lang: C#
label: C#
source: "var response = svix.Integration.Update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n new IntegrationUpdate { Name = \"Example Integration\", FeatureFlags = [] }\n);"
- lang: PHP
label: PHP
source: "$response = $svix->integration->update(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n IntegrationUpdate::create(\n name: \"Example Integration\"\n )\n ->withFeatureFlags([])\n);"
- lang: Shell
label: CLI
source: "svix integration update \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\" \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\" '{\n \"name\": \"Example Integration\",\n \"featureFlags\": []\n }'"
- lang: Shell
label: cURL
source: "curl -X 'PUT' \\\n 'https://api.eu.svix.com/api/v1/app/app_1srOrx2ZWZBpBUvZwXKQmoEYga2/integration/integ_1srOrx2ZWZBpBUvZwXKQmoEYga2' \\\n -H 'Authorization: Bearer AUTH_TOKEN' \\\n -H 'Accept: application/json' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"name\": \"Example Integration\",\n \"featureFlags\": []\n }'"
delete:
tags:
- Integration
summary: Delete Integration
description: Delete an integration.
operationId: v1.integration.delete
parameters:
- in: path
name: app_id
description: The Application's ID or UID.
required: true
schema:
description: The Application's ID or UID.
type: string
maxLength: 256
minLength: 1
pattern: ^[a-zA-Z0-9\-_.]+$
example: unique-identifier
style: simple
- in: path
name: integ_id
description: The Integration's ID.
required: true
schema:
description: The Integration's ID.
type: string
maxLength: 33
minLength: 33
pattern: ^integ_[A-Za-z0-9]{27}$
example: integ_1srOrx2ZWZBpBUvZwXKQmoEYga2
style: simple
responses:
'204':
description: no content
'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:
- lang: TypeScript
label: JavaScript
source: "await svix.integration.delete(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\"\n);"
- lang: TypeScript
label: TypeScript
source: "await svix.integration.delete(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\"\n);"
- lang: Python
label: Python
source: "svix.integration.delete(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n)"
- lang: Python
label: Python (Async)
source: "await svix.integration.delete(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n)"
- lang: Go
label: Go
source: "err := svix.Integration.Delete(\n\tctx,\n\t\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n\t\"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n)"
- lang: Kotlin
label: Kotlin
source: "svix.integration.delete(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n)"
- lang: Java
label: Java
source: "svix.getIntegration()\n .delete(\"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\", \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\");"
- lang: Ruby
label: Ruby
source: response = svix.integration.delete("app_1srOrx2ZWZBpBUvZwXKQmoEYga2", "integ_1srOrx2ZWZBpBUvZwXKQmoEYga2")
- lang: Rust
label: Rust
source: "svix.integration()\n .delete(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\".to_string(),\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\".to_string(),\n )\n .await?;"
- lang: C#
label: C#
source: "var response = svix.Integration.Delete(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\"\n);"
- lang: PHP
label: PHP
source: "$svix->integration->delete(\n \"app_1srOrx2ZWZBpBUvZwXKQmoEYga2\",\n \"integ_1srOrx2ZWZBpBUvZwXKQmoEYga2\"\n);"
- lang: Shell
label: CLI
source: svix integration delete "app_1srOrx2ZWZBpBUvZwXKQmoEYga2" "integ_1srOrx2ZWZBpBUvZwXKQmoEYga2"
- lang: Shell
label: cURL
source: "curl -X 'DELETE' \\\n 'https://api.eu.svix.com/api/v1/app/app_1srOrx2ZWZBpBUvZwXKQmoEYga2/integration/integ_1srOrx2ZWZBpBUvZwXKQmoEYga2' \\\n -H 'Authorization: Bearer AUTH_TOKEN'"
/api/v1/app/{app_id}/integration/{integ_id}/key/rotate:
post:
tags:
- Integration
summary: Rotate Integration Key
description: Rotate the integration's key. The previous key will be immediately revoked.
operationId: v1.integration.rotate-key
parameters:
- in: path
name: app_id
description: The Application's ID or UID.
required: true
schema:
description: The Application's ID or UID.
type: string
maxLength: 256
minLength: 1
pattern: ^[a-zA-Z0-9\-_.]+$
example: unique-identifier
style: simple
- in: path
name: integ_id
description: The Integration's ID.
required: true
schema:
description: The Integration's ID.
type: string
maxLength: 33
minLength: 33
pattern: ^integ_[A-Za-z0-9]{27}$
example: integ_1srOrx2ZWZBpBUvZwXKQmoEYga2
style: simple
- in: header
name: idempotency-key
description: The request's idempotency key
schema:
type: string
style: simple
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/IntegrationKeyOut'
'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:
applicat
# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/svix/refs/heads/main/openapi/svix-integration-api-openapi.yml