Create a secret key

Create one secret key within the organization.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

organizationId?string

Organization whose keys the operation targets. User tokens must supply it unless the credential's fixed scope resolves it; secret keys may omit it (the key's organization applies).

Length1 <= length

projectId?string

Project to scope this key to. When set, the key can only access resources within this project. Omit for organization-wide access.

Formatuuid

name*string

Human-readable name for the key.

Match^[a-zA-Z0-9\s\-_]+$

Length1 <= length <= 100

expiresAt?string

Optional expiration timestamp for the key.

Formatdate-time

Response Body

`application/json`

curl -X POST "https://example.com/secret-keys" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'

{  "secretKey": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "expiresAt": "2019-08-24T14:15:22Z",    "lastUsedAt": "2019-08-24T14:15:22Z",    "createdAt": "2019-08-24T14:15:22Z",    "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",    "value": "string"  }}

Request Body

Response Body

201application/json

`application/json`