Skip to main content
POST
Create a Provider Integration Resource (e.g. AWS DevOps Agent)

Authorizations

X-BRONTO-API-KEY
string
header
required

Body

application/json
provider
enum<string>
required

The provider to send alerts to

Available options:
aws-devops-agent
Example:

"aws-devops-agent"

url
string
required

The provider webhook URL. For aws-devops-agent, an https URL on an *.api.aws host.

Required string length: 10 - 2048
Example:

"https://event-ai.us-east-1.api.aws/webhook/generic/abc-123"

secret
string
required

The provider's HMAC signing secret. Surrounding whitespace and a leading "Bearer " are removed. Never returned.

Required string length: 1 - 4096
Example:

"xxxxx"

auth_type
enum<string>
required

How requests to the provider are authenticated. Requests are signed with HMAC-SHA256 using the secret, which is never sent.

Available options:
hmac
Example:

"hmac"

name
string

The integration name. Defaults to the provider's name.

Maximum string length: 255
Example:

"AWS DevOps Agent"

Response

Resource created successfully

id
string
required

A unique identifier for the integration resource

Example:

"550e8400-e29b-41d4-a716-446655440000"

name
string
required

The integration name

Example:

"AWS DevOps Agent"

provider
enum<string>
required

The provider the integration sends alerts to

Available options:
aws-devops-agent
Example:

"aws-devops-agent"

url
string
required

The provider webhook URL

Example:

"https://event-ai.us-east-1.api.aws/webhook/generic/abc-123"

has_secret
boolean
required

Whether a secret is stored. The secret itself is never returned.

Example:

true

auth_type
enum<string>
required

How requests to the provider are authenticated. Requests are signed with HMAC-SHA256 using the secret, which is never sent.

Available options:
hmac
Example:

"hmac"