Schemas
Tenant
id
stringUser-defined system ID for the tenant.
destinations_count
integerNumber of destinations associated with the tenant.
topics
string[]List of subscribed topics across all destinations for this tenant.
created_at
string · date-timeISO Date when the tenant was created.
PortalRedirect
redirect_url
string · urlRedirect URL containing a JWT to authenticate the user with the portal.
TenantToken
token
stringJWT token scoped to the tenant for safe browser API calls.
SuccessResponse
success
boolean
DestinationOAuthRedirect
redirect_url
string · urlRedirect URL for OAuth flow if applicable during destination update.
Topics
WebhookConfig
url
string · url · requiredThe URL to send the webhook events to.
WebhookCredentials
secret
stringThe secret used for signing webhook requests. Auto-generated if omitted on creation by admin. Read-only for tenants unless rotating.
previous_secret
stringThe previous secret used during rotation. Valid for 24 hours by default. Read-only.
previous_secret_invalid_at
string · date-timeISO timestamp when the previous secret becomes invalid. Read-only.
AWSSQSConfig
queue_url
string · url · requiredThe URL of the SQS queue.
endpoint
string · urlOptional. Custom AWS endpoint URL (e.g., for LocalStack or specific regions).
AWSSQSCredentials
key
string · requiredAWS Access Key ID.
secret
string · requiredAWS Secret Access Key.
session
stringOptional AWS Session Token (for temporary credentials).
RabbitMQConfig
server_url
string · requiredRabbitMQ server address (host:port).
exchange
string · requiredThe exchange to publish messages to.
tls
string · enumWhether to use TLS connection (amqps). Defaults to "false".
Enum values:truefalse
RabbitMQCredentials
username
string · requiredRabbitMQ username.
password
string · requiredRabbitMQ password.
DestinationWebhook
id
string · requiredControl plane generated ID or user provided ID for the destination.
type
string · enum · requiredType of the destination.
Enum values:webhooktopics
required"*" or an array of enabled topics.
disabled_at
string · date-time · requiredISO Date when the destination was disabled, or null if enabled.
created_at
string · date-time · requiredISO Date when the destination was created.
config
object · requiredcredentials
object · required
DestinationAWSSQS
id
string · requiredControl plane generated ID or user provided ID for the destination.
type
string · enum · requiredType of the destination.
Enum values:aws_sqstopics
required"*" or an array of enabled topics.
disabled_at
string · date-time · requiredISO Date when the destination was disabled, or null if enabled.
created_at
string · date-time · requiredISO Date when the destination was created.
config
object · requiredcredentials
object · required
DestinationRabbitMQ
id
string · requiredControl plane generated ID or user provided ID for the destination.
type
string · enum · requiredType of the destination.
Enum values:rabbitmqtopics
required"*" or an array of enabled topics.
disabled_at
string · date-time · requiredISO Date when the destination was disabled, or null if enabled.
created_at
string · date-time · requiredISO Date when the destination was created.
config
object · requiredcredentials
object · required
Destination
id
string · requiredControl plane generated ID or user provided ID for the destination.
type
string · enum · requiredType of the destination.
Enum values:webhooktopics
required"*" or an array of enabled topics.
disabled_at
string · date-time · requiredISO Date when the destination was disabled, or null if enabled.
created_at
string · date-time · requiredISO Date when the destination was created.
config
object · requiredcredentials
object · required
id
string · requiredControl plane generated ID or user provided ID for the destination.
type
string · enum · requiredType of the destination.
Enum values:aws_sqstopics
required"*" or an array of enabled topics.
disabled_at
string · date-time · requiredISO Date when the destination was disabled, or null if enabled.
created_at
string · date-time · requiredISO Date when the destination was created.
config
object · requiredcredentials
object · required
id
string · requiredControl plane generated ID or user provided ID for the destination.
type
string · enum · requiredType of the destination.
Enum values:rabbitmqtopics
required"*" or an array of enabled topics.
disabled_at
string · date-time · requiredISO Date when the destination was disabled, or null if enabled.
created_at
string · date-time · requiredISO Date when the destination was created.
config
object · requiredcredentials
object · required
DestinationCreateWebhook
type
string · enum · requiredType of the destination. Must be 'webhook'.
Enum values:webhooktopics
required"*" or an array of enabled topics.
config
object · required
id
stringOptional user-provided ID. A UUID will be generated if empty.
credentials
object
DestinationCreateAWSSQS
type
string · enum · requiredType of the destination. Must be 'aws_sqs'.
Enum values:aws_sqstopics
required"*" or an array of enabled topics.
config
object · requiredcredentials
object · required
id
stringOptional user-provided ID. A UUID will be generated if empty.
DestinationCreateRabbitMQ
type
string · enum · requiredType of the destination. Must be 'rabbitmq'.
Enum values:rabbitmqtopics
required"*" or an array of enabled topics.
config
object · requiredcredentials
object · required
id
stringOptional user-provided ID. A UUID will be generated if empty.
DestinationCreate
type
string · enum · requiredType of the destination. Must be 'webhook'.
Enum values:webhooktopics
required"*" or an array of enabled topics.
config
object · required
id
stringOptional user-provided ID. A UUID will be generated if empty.
credentials
object
type
string · enum · requiredType of the destination. Must be 'aws_sqs'.
Enum values:aws_sqstopics
required"*" or an array of enabled topics.
config
object · requiredcredentials
object · required
id
stringOptional user-provided ID. A UUID will be generated if empty.
type
string · enum · requiredType of the destination. Must be 'rabbitmq'.
Enum values:rabbitmqtopics
required"*" or an array of enabled topics.
config
object · requiredcredentials
object · required
id
stringOptional user-provided ID. A UUID will be generated if empty.
WebhookCredentialsUpdate
secret
stringNew secret (only allowed for admin).
previous_secret
stringPrevious secret for rotation (only allowed for admin).
previous_secret_invalid_at
string · date-timeInvalidation time for previous secret (only allowed for admin).
rotate_secret
booleanSet to true to rotate the secret. The current secret becomes the previous_secret, and a new secret is generated.
previous_secret_invalid_at
defaults to 24h if not provided.
DestinationUpdateWebhook
topics
"*" or an array of enabled topics.
config
objectcredentials
object
DestinationUpdateAWSSQS
topics
"*" or an array of enabled topics.
config
objectcredentials
object
DestinationUpdateRabbitMQ
topics
"*" or an array of enabled topics.
config
objectcredentials
object
DestinationUpdate
topics
"*" or an array of enabled topics.
config
objectcredentials
object
topics
"*" or an array of enabled topics.
config
objectcredentials
object
topics
"*" or an array of enabled topics.
config
objectcredentials
object
PublishRequest
tenant_id
string · requiredThe ID of the tenant to publish for.
topic
string · requiredTopic name for the event.
eligible_for_retry
boolean · requiredShould event delivery be retried on failure.
data
object · requiredAny JSON payload for the event data.
destination_id
stringOptional. Route event to a specific destination.
metadata
objectAny key-value string pairs for metadata.
Event
id
stringdestination_id
stringtopic
stringtime
string · date-timeTime the event was received/processed.
successful_at
string · date-timeTime the event was successfully delivered.
metadata
objectKey-value string pairs of metadata associated with the event.
data
objectFreeform JSON data of the event.
DeliveryAttempt
delivered_at
string · date-timestatus
string · enumEnum values:successfailedresponse_status_code
integerresponse_body
stringresponse_headers
object
DestinationTypeSchema
type
stringlabel
stringdescription
stringicon
stringSVG icon string.
instructions
stringMarkdown instructions.
remote_setup_url
string · urlSome destinations may have Oauth flow or other managed-setup flow that can be triggered with a link. If a
remote_setup_url
is set then the user should be prompted to follow the link to configure the destination. See the dashboard design guide for recommended UI patterns and wireframes for implementation in your own app.config_fields
object[]Config fields are non-secret values that can be stored and displayed to the user in plain text.
credential_fields
object[]Credential fields are secret values that will be AES encrypted and obfuscated to the user. Some credentials may not be obfuscated; the destination type dictates the obfuscation logic.
DestinationSchemaField
type
string · enumEnum values:textnumberbooleanlabel
stringdescription
stringvalidation
stringRegex string for validation.
required
boolean