API Keys

API Keys can be managed with these endpoints.

Get all API keys associated with a company

Securityoauth2 or bearerAuth or apiKeyHeader
Request
query Parameters
status
string
Default: "active"
Enum: "active" "inactive"
limit
integer [ 1 .. 100 ]
Default: 25

The maximum count of results to retrieve.

startingAfter
string

Return results starting after the provided object identifier.

endingBefore
string

Return results ending before the provided object identifier.

offset
integer >= 0

Offset from the start of results.

Responses
200

Success

get/keys
Response samples
application/json
{
  • "status": 0,
  • "total": 0,
  • "count": 0,
  • "nextUrl": "string",
  • "previousUrl": "string",
  • "data": [
    ]
}

Create an API key associated with a company

Securityoauth2 or bearerAuth or apiKeyHeader
Request
Request Body schema: application/json
required
userId
required
string
whitelistedIPs
Array of strings or null (WhitelistedIPs)

IP addresses or CIDR blocks for which to restrict access to this API key.

description
string or null (APIKeyDescription) [ 1 .. 200 ] characters

A description of the API key. This field is optional and can be used to provide additional context about the API key.

Responses
201

Created

post/keys
Request samples
application/json
{
  • "userId": "string",
  • "whitelistedIPs": [
    ],
  • "description": "string"
}
Response samples
application/json
{
  • "id": "string",
  • "companyId": "string",
  • "userId": "string",
  • "key": "string",
  • "whitelistedIPs": [
    ],
  • "status": "active",
  • "description": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "deletedAt": "2019-08-24T14:15:22Z"
}

Get an API key associated with a company

Securityoauth2 or bearerAuth or apiKeyHeader
Request
path Parameters
keyId
required
string

The API key id.

Responses
200

Success

get/keys/{keyId}
Response samples
application/json
{
  • "id": "string",
  • "companyId": "string",
  • "userId": "string",
  • "key": "string",
  • "whitelistedIPs": [
    ],
  • "status": "active",
  • "description": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "deletedAt": "2019-08-24T14:15:22Z"
}

Delete an API key associated with a company

Securityoauth2 or bearerAuth or apiKeyHeader
Request
path Parameters
keyId
required
string

The API key id.

Responses
204

Success

delete/keys/{keyId}

Request sandbox access