Create a scoped API key (session credential only)

Authorization

AuthorizationBearer <token>

API key auth. Prefix cf_live_ for production orgs, cf_test_ for sandbox.

In: header

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Length1 <= length

permissions*

Resource → actions grant. Resources: media, sessions, projects, renders, webhooks. Actions: read, write. Least-privilege — grant only what's needed.

expiresIn?integer

Lifetime in seconds; omit for no expiry.

Range0 < value

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

{  "key": "string",  "id": "string",  "prefix": "string",  "start": "string"}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}