List secrets

POST 
/api/v1/secrets/list

Returns metadata for every secret in the project, paginated. Values are not included, and there is no parameter that would include them.

Send {} for the first page at the server's default size.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized tenant project secret administration.

Use this in a guide: Secret values and credential references

Request

Responses

200

Page of secret metadata

List the first page of secret metadata for the authenticated project.

Section ID: DOC-CP-secrets-api-listSecrets#example-secrets-listSecrets-request

Request example

{
  "page": 0,
  "pageSize": 20
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-CP-secrets-api-listSecrets#example-secrets-listSecrets-response

Response example

{
  "secrets": [
    {
      "name": "example",
      "projectId": "example_123",
      "description": "example",
      "labels": {},
      "version": "1",
      "createdBy": "example",
      "createdAt": "2026-09-16T12:00:00Z",
      "updatedAt": "2026-09-16T12:00:00Z"
    }
  ],
  "total": 1
}

Document ID: DOC-CP-secrets-api-listSecrets. Section identities and revisions.

Section	Stable reference
List secrets	DOC-CP-secrets-api-listSecrets#overview
Request	DOC-CP-secrets-api-listSecrets#request
Responses	DOC-CP-secrets-api-listSecrets#responses