APIs & SDKs/shadw REST API/Create an API key

Create an API key

POSThttps://api.shadw.cloud/v1/apikeys

Create a long-lived platform API key (hive_…) bound to the active team. The plaintext token is returned exactly once — only its SHA-256 hash is stored. Present it as `Authorization: Bearer hive_…` to scope requests to the key's team.

Authentication

AuthorizationbearerToken

A platform API key (hive_…, created under Settings → API Keys) or a short-lived JWT minted with POST /v1/token. An API key scopes the request to the team it was created under.

Body parameters

namestringRequired

A label for the key (e.g. "ci").

role"owner" | "member"Optional

Role bound to the key (default "member").