SecretsProject Secrets

List a project's secrets

GET
/v1/orgs/{org}/projects/{project}/secrets
AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

org*string
project*string

Query Parameters

scope?string

Which secrets to list: all project secrets, only the shared project values, or only the ones scoped to you

Default"all"

Value in

  • "all"
  • "project"
  • "personal"
folder?string

List one level under this folder, such as payments/live: its folders, then its secrets. Omit for the root

Match^[a-z0-9][a-z0-9_-]*(/[a-z0-9][a-z0-9_-]*)*$
Lengthlength <= 256
q?string

Return only secrets whose key contains this text, ignoring case, at every depth under the folder, and no folders

Lengthlength <= 256
key?string

Return only the secrets with exactly this full key. A project list of all scopes returns up to two: the project secret and your personal one. Not valid with folder or q

Match^[a-z0-9][a-z0-9_-]*(/[a-z0-9][a-z0-9_-]*)*$
Lengthlength <= 256
cursor?string

Opaque pagination cursor from a previous response

limit?integer

Maximum number of items to return (1–100)

Formatint32
Range1 <= value <= 100
Default20

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/v1/orgs/string/projects/string/secrets"
{  "items": [    {      "kind": "folder",      "name": "string",      "secret": {        "aws_access_key_id": "string",        "created_at": "string",        "id": "string",        "key": "string",        "owner_user_id": "string",        "scope": "org",        "type": "generic",        "updated_at": "string",        "username": "string"      }    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string",    "total_count": 0  }}