Sign in
latestOpenAPI 3.1.02026-08-211286041.7 MB

b0c8a1820333

Application

Create Application

Create a new application.

post/api/v1/app

Query parameters

get_if_existsboolean

Get an existing application, or create a new one if doesn't exist. It's two separate functions in the libs.

Get an existing application, or create a new one if doesn't exist. It's two separate functions in the libs.

Headers

idempotency-keystring

The request's idempotency key

Request body

metadataobject
namestring required

Application name for human consumption.

throttleRateinteger nullable

Maximum messages per second to send to this application.

Outgoing messages will be throttled to this rate.

uidstring nullable

Optional unique identifier for the application.

Example request

{
  "name": "My first application",
  "uid": "unique-identifier"
}

Response

createdAtstring date-time required
idstring required

The Application's ID.

metadataobject required
namestring required

Application name for human consumption.

throttleRateinteger nullable

Maximum messages per second to send to this application.

Outgoing messages will be throttled to this rate.

uidstring nullable

Optional unique identifier for the application.

updatedAtstring date-time required

Example response

{
  "id": "app_1srOrx2ZWZBpBUvZwXKQmoEYga2",
  "name": "My first application",
  "uid": "unique-identifier"
}