Secrets

Set, list, and delete secrets from the tektona CLI, and browse them by folder.

tektona secret manages the values that egress proxy profiles inject. For the model, scopes and folders, see Secrets.

tektona secret set <key>      # create a secret, or update its value
tektona secret ls [folder]    # list one folder level
tektona secret rm <key>       # delete a secret

Set

set reads the value from stdin. In a terminal, set asks for the value and does not show what you type. The prompt reads one line, so pipe a value that has more lines. With --no-input in a terminal, set fails. If the key exists in the scope, set updates the value in place. Otherwise it creates the secret. Give the full key, including its folders:

tektona secret set payments/live/api-key                # asks for the value
printf '%s' "$API_KEY" | tektona secret set payments/live/api-key
printf '%s' "$API_KEY" | tektona secret set payments/live/api-key --scope personal
FlagDefaultMeaning
--scopeprojectorg, project or personal
--typegenericgeneric or aws. An update without --type keeps the stored type
--aws-access-key-idThe AWS access key id. Required with --type aws

List

ls lists one folder level: the folders first, then the secrets. Without a folder, it lists the root. A folder shows with a trailing /. Values are never shown.

tektona secret ls                    # the root
tektona secret ls payments/live      # one level under payments/live
tektona secret ls --query live       # every key that contains "live"
NAME       TYPE     SCOPE     UPDATED
sandbox/   -        -         -
api-key    generic  project   2026-11-06T09:12:44Z
api-key    generic  personal  2026-11-06T09:15:02Z

--query searches the full key in every folder below the listed folder, and ignores case. It prints the full key of each hit and no folders.

FlagDefaultMeaning
--queryKeep only the secrets whose key contains this text
--scopeallall, project, personal or org. all lists the project and your personal secrets
--limit0The maximum number of entries. 0 lists all

Delete

rm deletes one secret. Give the full key:

tektona secret rm payments/live/api-key
tektona secret rm payments/live/api-key --scope personal
FlagDefaultMeaning
--scopeprojectThe scope of the secret: org, project or personal

To empty a folder, delete each secret in it. The folder goes away with its last secret.

Sealing keys

sealing-key (alias sk) manages the keys that seal secret values. It is a subcommand of org for the org key and of project for the project key. The org key seals org secrets. The project key seals project and personal secrets. For the key statuses, see Sealing keys.

tektona project sealing-key ls                # list the keys
tektona project sealing-key rotate            # make a new active key
tektona project sealing-key retire <keyId>    # retire a decrypt_only key
tektona org sk ls --org acme-corp
ID                                    STATUS        CREATED
4b0e7a52-1f7c-4f0e-9d8a-2a1c5e0b9c11  active        2026-11-14 10:02:11 CET
9a3d2c10-77b1-4a55-8f02-6c4e1d7a3b80  decrypt_only  2026-10-05 08:30:00 CEST

ls lists the active key first, then the decrypt_only keys, then the retired keys. Times are in your local time zone. rotate prints the new key and retire prints the retired key. The project comes from your context or from --project. The org comes from your context or from --org. With -o json, the output also holds the public key of the active key.

rotate and retire need the admin role in the project, or in the org for org keys. retire refuses the active key: rotate first.

On this page