Create Organization API Key

Create an organization or subaccount API key. The secret is returned once in the response. To rotate a key, create its replacement first, cut traffic over, then revoke the old key — key prefixes identify which key made a request.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Request

This endpoint expects an object.

expiresAtdatetime or nullOptional

namestringOptional1-200 characters

scopeslist of "*"Optional

subaccountIdstringOptional>=1 character

Response

Created

dataobject

secretstring>=1 character

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

429

Too Many Requests Error

$	curl -X POST https://api.bctrl.ai/v1/api-keys \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"data": {
3	"createdAt": "2024-06-01T12:00:00Z",
4	"expiresAt": "2025-06-01T12:00:00Z",
5	"id": "api_key_1234567890abcdef",
6	"keyKind": "organization",
7	"keyPrefix": "org_abc123",
8	"lastUsedAt": "2024-06-10T08:30:00Z",
9	"name": "Primary Organization API Key",
10	"scopes": [
11	"*"
12	],
13	"subaccountId": "subacct_9876543210fedcba",
14	"updatedAt": "2024-06-05T15:45:00Z",
15	"usageCount": 42
16	},
17	"secret": "sk_live_4f3b2a1c9d8e7f6a"
18	}