Create a new API key - Bronto Docs

curl --request POST \ --url https://api.eu.bronto.io/api-keys \ --header 'Content-Type: application/json' \ --header 'X-BRONTO-API-KEY: <api-key>' \ --data ' { "name": "Production Monitoring API Key", "roles": [ "IngestionApi", "SearchApi", "AdminApi" ], "ttl": 31536000 } '

{ "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "name": "Production API Key", "api_key": "2ad85149", "roles": [ "SearchApi", "IngestionApi" ], "tags": { "region": "eu", "environment": "production" }, "expires_at": 1757000000, "metadata": { "created_at": 123, "created_by": { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }, "modified_at": 123, "modified_by": { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }, "deleted_at": 123, "deleted_by": { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }, "last_heartbeat_at": 123 } }

Authorizations

X-BRONTO-API-KEY

string

header

required

Body

application/json

name

string

required

The name of the API key to create

Required string length: 1 - 255

Example:

"Production API Key"

roles

object

required

A list of api key role ids

Example:

["IngestionApi"]

ttl

integer<int64>

The time to live for the API key in seconds, defaults to no expiry

Required range: 0 <= x <= 70000000

Example:

31536000

Response

API keys is created successfully

string<uuid>

The unique identifier for the API key

name

string

The name of the API key

Example:

"Production API Key"

api_key

string

The first 8 characters of the API key. Note its not possible to retrieve the key after creation time.

Example:

"2ad85149"

roles

object

A list of api key role ids

Example:

["SearchApi", "IngestionApi"]