Skip to main content

kobana kadu secrets

Commands of kobana kadu secrets. Every global option (Global options) applies here.

CommandHTTPDescription
secrets listGET /v1/secretsList secrets
secrets createPOST /v1/secretsCreate secret
secrets getGET /v1/secrets/{id}Get secret details
secrets updatePATCH /v1/secrets/{id}Update secret
secrets deleteDELETE /v1/secrets/{id}Delete secret (soft delete)

secrets list​

List secrets

kobana kadu secrets list [OPTIONS]

GET /v1/secrets

Query parameters

NameTypeRequiredDescription
cursorstringno
limitnumberno
sort_bystringnoField in snake_case: created_at (default), updated_at or a filterable field.
sort_orderstringnoDefault: desc. Values: asc, desc.

Responses

HTTPDescription
200OK
503AS_UNAVAILABLE — token verification is unavailable (Authorization Server down or configuration missing). Try again (Retry-After).

secrets create​

Create secret

kobana kadu secrets create [OPTIONS]

POST /v1/secrets

The value is stored encrypted and never returned.

Request body

NameTypeRequiredDescription
environment_idstring (uuid)yes
keystringyes
valuestringyes
workspace_idstring (uuid)no
notesstringno

More fields and nested objects: kobana schema kadu.secrets.create.

Responses

HTTPDescription
201created
409IDEMPOTENCY_KEY_REUSED / IDEMPOTENCY_REQUEST_IN_PROGRESS (or the route's CONFLICT)
422VALIDATION_ERROR — environment or workspace outside the organization
503AS_UNAVAILABLE — token verification is unavailable (Authorization Server down or configuration missing). Try again (Retry-After).

secrets get​

Get secret details

kobana kadu secrets get [ID] [OPTIONS]

GET /v1/secrets/{id}

Path arguments: id

Responses

HTTPDescription
200OK
404not found
503AS_UNAVAILABLE — token verification is unavailable (Authorization Server down or configuration missing). Try again (Retry-After).

secrets update​

Update secret

kobana kadu secrets update [ID] [OPTIONS]

PATCH /v1/secrets/{id}

A missing or empty value keeps the stored value.

Path arguments: id

Request body

NameTypeRequiredDescription
environment_idstring (uuid)no
workspace_idstring (uuid)no
keystringno
valuestringno
notesstringno

More fields and nested objects: kobana schema kadu.secrets.update.

Responses

HTTPDescription
200OK
404NOT_FOUND
409IDEMPOTENCY_KEY_REUSED / IDEMPOTENCY_REQUEST_IN_PROGRESS (or the route's CONFLICT)
422VALIDATION_ERROR — environment or workspace outside the organization
503AS_UNAVAILABLE — token verification is unavailable (Authorization Server down or configuration missing). Try again (Retry-After).

secrets delete​

Delete secret (soft delete)

kobana kadu secrets delete [ID] [OPTIONS]

DELETE /v1/secrets/{id}

Path arguments: id

Responses

HTTPDescription
200OK
404NOT_FOUND
503AS_UNAVAILABLE — token verification is unavailable (Authorization Server down or configuration missing). Try again (Retry-After).