organization

Create Key

Mint a named key for the organization. The secret is returned exactly once.

Any active member may call this. expires_at must be sent, explicitly null for a key that never expires, so a key's lifetime is always a choice somebody made.

post/api/v1/organizations/{organization_id}/keys

Request

Base URL
https://ndi-api.nace.ai (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/nace/apis/ndi-service/docs/api/v1/organizations/:organization_id/keys/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

organization_idstring uuid required

Organization from POST /console/session.

Request body

namestring required

How this key is identified in listings, e.g. 'ci' or 'ingestion-prod'.

descriptionstring nullable

Optional note about what the key is for, shown under its name in listings.

expires_atstring date-time nullable required

When the key should stop working, as an offset-aware timestamp. Null means never. Must be in the future.

Response

Successful Response

full_keystring required

The complete API key, shown ONLY once — it is never recoverable.

Changes

No recorded changes to this operation across all 1 revision of this API.