List all of the environment's application resources.
limit | integer [ 1 .. 150 ] Default: 50 The number of results returned |
ending_before | string A cursor for use in pagination. |
starting_after | string A cursor for use in pagination. starting_after is a resource ID that defines your place in the list. For instance, if you make a list request and receive 100 resource objects, ending with resource_obj_n, your subsequent call can include starting_after=resource_obj_n in order to fetch the next page of the list. |
before | string <date-time> Results to return that occurred UP TO the timestamp provided. |
after | string <date-time> Results to return that occurred AFTER the timestamp provided. |
applications = client.applications.list
{- "data": [
- {
- "uid": "string",
- "name": "string",
- "rate_limit": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "retry_strategy": {
- "type": "base_exponential_backoff_with_deadline",
- "max_retries": 0,
- "retry_delay": 0,
- "deadline": 0
}
}
], - "done": true
}
Create a new application.
uid | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ | ||||||||||||||||||||
name required | string | ||||||||||||||||||||
rate_limit | integer | ||||||||||||||||||||
object (RetryStrategy) | |||||||||||||||||||||
|
{- "uid": "the-pizza-club",
- "name": "The Pizza Club",
- "rate_limit": 1000
}
{- "uid": "the-pizza-club",
- "name": "The Pizza Club",
- "rateLimit": 1000,
- "id": "app_xxx",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Get an application resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
application = client.applications.retrieve("app-uid-1")
{- "uid": "the-pizza-club",
- "name": "The Pizza Club",
- "rateLimit": 1000,
- "id": "app_xxx",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Update an application resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
uid | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ | ||||||||||||||||||||
name required | string | ||||||||||||||||||||
rate_limit | integer | ||||||||||||||||||||
object (RetryStrategy) | |||||||||||||||||||||
|
{- "uid": "the-pizza-club",
- "name": "The Pizza Club",
- "rate_limit": 1000
}
{- "uid": "string",
- "name": "string",
- "rate_limit": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "retry_strategy": {
- "type": "base_exponential_backoff_with_deadline",
- "max_retries": 0,
- "retry_delay": 0,
- "deadline": 0
}
}
Delete an application resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
boolean_response = client.applications.delete("app-uid-1")
{- "code": "string",
- "error": "string"
}
Endpoints are associated with an Application and hold the routing rules. Each application can have multiple endpoints and every message sent to the application will be routed to all endpoints - depending on the routing rules at each endpoint the message may not be attempted for a particular endpoint.
List all of the application's endpoint resources.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
limit | integer [ 1 .. 150 ] Default: 50 The number of results returned |
ending_before | string A cursor for use in pagination. |
starting_after | string A cursor for use in pagination. starting_after is a resource ID that defines your place in the list. For instance, if you make a list request and receive 100 resource objects, ending with resource_obj_n, your subsequent call can include starting_after=resource_obj_n in order to fetch the next page of the list. |
before | string <date-time> Results to return that occurred UP TO the timestamp provided. |
after | string <date-time> Results to return that occurred AFTER the timestamp provided. |
app_uid = 'app-uid-1' endpoints = client.endpoints.list(app_uid)
{- "data": [
- {
- "uid": "the-pizza-club-core",
- "version": "v1",
- "description": "Example description of the endpoint",
- "filterTypes": [
- "account.created"
], - "topics": [
- "a_b_test_carrot_toppping"
], - "disabled": false,
- "rateLimit": 1000,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
]
}
Create a new endpoint resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
uid | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ | ||||
url required | string <uri> [ 1 .. 2048 ] characters | ||||
version | string^[a-zA-Z0-9\-_.]+$ | ||||
description | string | ||||
filter_types | Array of strings | ||||
topics | Array of strings unique | ||||
rate_limit | integer >= 1 | ||||
object (Headers) | |||||
| |||||
secret | string^whsec_[a-zA-Z0-9]{64}$ | ||||
active | boolean Default: true |
{- "uid": "ep_xxxxx",
- "version": "v1",
- "description": "An example endpoint name",
- "filter_types": [
- "account.created"
], - "topics": [
- "a_b_test_carrot_toppping"
], - "rate_limit": 1000,
- "secret": "whsec_vepZNLxI3tJ2tWEIDAU5BWPJq3yYxm4mV4R65pNLpFk6dTvApVfz7yfTc2grpDC2",
- "active": true
}
{- "uid": "the-pizza-club-core",
- "version": "v1",
- "description": "Example description of the endpoint",
- "filterTypes": [
- "account.created"
], - "topics": [
- "a_b_test_carrot_toppping"
], - "disabled": false,
- "rateLimit": 1000,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Get an endpoint resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
endpoint_id required | string Example: ep_xxxxx The endpoint's UID |
app_uid = 'app-uid-1' endpoint_uid = 'endpoint-1' endpoint = client.endpoints.retrieve(app_uid, endpoint_uid)
{- "uid": "the-pizza-club-core",
- "version": "v1",
- "description": "Example description of the endpoint",
- "filterTypes": [
- "account.created"
], - "topics": [
- "a_b_test_carrot_toppping"
], - "disabled": false,
- "rateLimit": 1000,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Update an endpoint resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
endpoint_id required | string Example: ep_xxxxx The endpoint's UID |
uid | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ | ||||
url required | string <uri> [ 1 .. 2048 ] characters | ||||
version | string^[a-zA-Z0-9\-_.]+$ | ||||
description | string | ||||
filter_types | Array of strings | ||||
topics | Array of strings unique | ||||
rate_limit | integer >= 1 | ||||
object (Headers) | |||||
| |||||
secret | string^whsec_[a-zA-Z0-9]{64}$ | ||||
active | boolean Default: true |
{- "uid": "ep_xxxxx",
- "version": "v1",
- "description": "An example endpoint name",
- "filter_types": [
- "account.created"
], - "topics": [
- "a_b_test_carrot_toppping"
], - "rate_limit": 1000,
- "secret": "whsec_vepZNLxI3tJ2tWEIDAU5BWPJq3yYxm4mV4R65pNLpFk6dTvApVfz7yfTc2grpDC2",
- "active": true
}
{- "uid": "the-pizza-club-core",
- "version": "v1",
- "description": "Example description of the endpoint",
- "filter_types": [
- "account.created"
], - "topics": [
- "a_b_test_carrot_toppping"
], - "active": true,
- "rate_limit": 1000,
- "headers": {
- "headers": { },
- "sensitive": true
}, - "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
Delete an endpoint resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
endpoint_id required | string Example: ep_xxxxx The endpoint's UID |
app_uid = 'app-uid-1' endpoint_uid = 'endpoint-1' endpoint = client.endpoints.delete(app_uid, endpoint_uid)
{- "code": "string",
- "error": "string"
}
Send faild events to the endpoint.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
endpoint_id required | string Example: ep_xxxxx The endpoint's UID |
since | string <date-time> RFC3339 timestamp |
{- "since": "2019-08-24T14:15:22Z"
}
Rotate the endpoint secret
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
endpoint_id required | string Example: ep_xxxxx The endpoint's UID |
key | string |
{- "key": "string"
}
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
endpoint_id required | string Example: ep_xxxxx The endpoint's UID |
app_uid = 'app-uid-1' endpoint_uid = 'endpoint-1' secret = client.endpoints.retrieve_secret(app_uid, endpoint_uid)
{- "key": "string"
}
List endpoints to which a given Event is delivered to.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
event_id required | string The event's ID |
limit | integer [ 1 .. 150 ] Default: 50 The number of results returned |
starting_after | string A cursor for use in pagination. starting_after is a resource ID that defines your place in the list. For instance, if you make a list request and receive 100 resource objects, ending with resource_obj_n, your subsequent call can include starting_after=resource_obj_n in order to fetch the next page of the list. |
ending_before | string A cursor for use in pagination. |
app_uid = 'app-uid-1' event_uid = 'event-uid-1' endpoints = client.events.retrieve_endpoints(app_uid, event_uid)
{- "eventType": "account.created",
- "uid": "8537f7d761-c4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "retentionPeriod": 15,
- "created_at": "2019-08-24T14:15:22Z"
}
An event is an envelope that contains metadata and the event data - payload - you wish to send to endpoint(s).
List all of the application's event resources.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
limit | integer [ 1 .. 150 ] Default: 50 The number of results returned |
event_types | Array of strings unique Example: event_types=account.created |
topics | Array of strings unique Example: topics=a_b_test_carrot_toppping Filter by event topics |
before | string <date-time> Results to return that occurred UP TO the timestamp provided. |
after | string <date-time> Results to return that occurred AFTER the timestamp provided. |
app_uid = 'app-uid-1' events = client.events.list(app_uid)
{- "data": [
- {
- "eventType": "account.created",
- "eventId": "8537f7d761-c4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "payloadRetentionPeriod": 15
}
]
}
Create a new event resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
event_type | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ |
uid | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ |
topics | Array of strings unique [ items [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ ] |
payload | object |
retention_period | integer |
{- "event_type": "account.created",
- "uid": "8537f7d761c-4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "retention_period": 0
}
{- "eventType": "account.created",
- "uid": "8537f7d761-c4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "retentionPeriod": 15,
- "created_at": "2019-08-24T14:15:22Z"
}
Get an event resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
event_id required | string The event's ID |
app_uid = 'app-uid-1' event_uid = 'event-uid-1' event = client.events.retrieve(app_uid, event_uid)
{- "eventType": "account.created",
- "uid": "8537f7d761-c4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "retentionPeriod": 15,
- "created_at": "2019-08-24T14:15:22Z"
}
List events for a given Endpoint resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
endpoint_id required | string Example: ep_xxxxx The endpoint's UID |
limit | integer [ 1 .. 150 ] Default: 50 The number of results returned |
status | integer Enum: 0 1 2 3 The delivery status of an Event |
event_types | Array of strings unique Example: event_types=account.created |
topics | Array of strings unique Example: topics=a_b_test_carrot_toppping Filter by event topics |
before | string <date-time> Results to return that occurred UP TO the timestamp provided. |
after | string <date-time> Results to return that occurred AFTER the timestamp provided. |
starting_after | string A cursor for use in pagination. starting_after is a resource ID that defines your place in the list. For instance, if you make a list request and receive 100 resource objects, ending with resource_obj_n, your subsequent call can include starting_after=resource_obj_n in order to fetch the next page of the list. |
ending_before | string A cursor for use in pagination. |
app_uid = 'app-uid-1' endpoint_uid = 'endpoint-1' events = client.endpoint.retrieve_attempted_events(app_uid, endpoint_uid)
{- "eventType": "account.created",
- "uid": "8537f7d761-c4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "retentionPeriod": 15,
- "created_at": "2019-08-24T14:15:22Z"
}
Enqueue event for delivery to the specified Endpoint regardless of its current delivery status.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
event_id required | string The event's ID |
endpoint_id required | string Example: ep_xxxxx The endpoint's UID |
app_uid = 'app-uid-1' endpoint_uid = 'endpoint-1' event_uid = 'event-uid-1' boolean_response = client.events.retry(app_uid, endpoint_uid, event_uid)
{- "code": "string",
- "error": "string"
}
Delivery attempts are logs of our system attempting to deliver an Event to an Endpoint.
List delivery attempts for a given Endpoint resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
endpoint_id required | string |
limit | integer [ 1 .. 150 ] Default: 50 The number of results returned |
status | integer Enum: 0 1 2 3 The delivery status of an Event |
event_types | Array of strings unique Example: event_types=account.created |
topics | Array of strings unique Example: topics=a_b_test_carrot_toppping Filter by event topics |
response_status_code | integer Enum: 0 200 300 400 500 Filter by the delivery attempts response HTTP status code |
before | string <date-time> Results to return that occurred UP TO the timestamp provided. |
after | string <date-time> Results to return that occurred AFTER the timestamp provided. |
starting_after | string A cursor for use in pagination. starting_after is a resource ID that defines your place in the list. For instance, if you make a list request and receive 100 resource objects, ending with resource_obj_n, your subsequent call can include starting_after=resource_obj_n in order to fetch the next page of the list. |
ending_before | string A cursor for use in pagination. |
app_uid = 'app-uid-1' endpoint_uid = 'endpoint-1' delivery_attempts = client.endpoints.retrieve_delivery_attempts(app_uid, endpoint_uid)
{- "eventType": "account.created",
- "uid": "8537f7d761-c4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "retentionPeriod": 15,
- "created_at": "2019-08-24T14:15:22Z"
}
List delivery attempts for a given Endpoint resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
event_id required | string |
limit | integer [ 1 .. 150 ] Default: 50 The number of results returned |
status | integer Enum: 0 1 2 3 The delivery status of an Event |
response_status_code | integer Enum: 0 200 300 400 500 Filter by the delivery attempts response HTTP status code |
before | string <date-time> Results to return that occurred UP TO the timestamp provided. |
after | string <date-time> Results to return that occurred AFTER the timestamp provided. |
starting_after | string A cursor for use in pagination. starting_after is a resource ID that defines your place in the list. For instance, if you make a list request and receive 100 resource objects, ending with resource_obj_n, your subsequent call can include starting_after=resource_obj_n in order to fetch the next page of the list. |
ending_before | string A cursor for use in pagination. |
app_uid = 'app-uid-1' event_uid = 'event-uid-1' delivery_attempts = client.events.retrieve_delivery_attempts(app_uid, event_uid)
{- "eventType": "account.created",
- "uid": "8537f7d761-c4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "retentionPeriod": 15,
- "created_at": "2019-08-24T14:15:22Z"
}
List delivery attempts for a given Endpoint resource.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
event_id required | string The event's ID |
delivery_attempt_id required | string |
app_uid = 'app-uid-1' event_uid = 'event-uid-1' delivery_attempt_id = 'djSDIHVubd42dSAD' delivery_attempt = client.events.retrieve_delivery_attempt(app_uid, event_uid, delivery_attempt_id)
{- "eventType": "account.created",
- "uid": "8537f7d761-c4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "retentionPeriod": 15,
- "created_at": "2019-08-24T14:15:22Z"
}
List endpoints to which a given Event is delivered to.
app_id required | string [ 1 .. 255 ] characters ^[a-zA-Z0-9\-_.]+$ Example: app_xxx The application's UID |
event_id required | string The event's ID |
limit | integer [ 1 .. 150 ] Default: 50 The number of results returned |
starting_after | string A cursor for use in pagination. starting_after is a resource ID that defines your place in the list. For instance, if you make a list request and receive 100 resource objects, ending with resource_obj_n, your subsequent call can include starting_after=resource_obj_n in order to fetch the next page of the list. |
ending_before | string A cursor for use in pagination. |
app_uid = 'app-uid-1' event_uid = 'event-uid-1' endpoints = client.events.retrieve_endpoints(app_uid, event_uid)
{- "eventType": "account.created",
- "uid": "8537f7d761-c4356b38a2f20-3184a4490c",
- "topics": [
- "a_b_test_carrot_toppping"
], - "payload": {
- "trialing": true,
- "referral": false,
- "id": 1003,
- "user": "alice@example.com"
}, - "retentionPeriod": 15,
- "created_at": "2019-08-24T14:15:22Z"
}