---
title: "List Secrets"
method: GET
path: "/api/v1/secrets"
tags: ["secrets"]
---

# List Secrets

`GET /api/v1/secrets`

## Request

- Base URL: `https://api.mengi.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mengi.cloud/api/v1/secrets`
- Auth: none declared

List secrets in the active organization's namespace (defaults to the user's
personal org). If deployment_id is provided, the deployment's org namespace
is listed and the result contains the secrets that deployment can consume:
its own deployment-scoped secrets plus the org-wide (unscoped) ones. Other
deployments' scoped secrets are excluded.

## Query parameters

- `deployment_id` string, uuid, nullable
- `organization_id` string, uuid, nullable

## Response `200`

Successful Response

- SecretListResponse
  - `secrets` SecretResponse[], required
    - `name` string, required
    - `key` string, required
    - `deployment_id` string, nullable
    - `database_id` string, nullable
    - `organization_id` string, nullable
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mengi/apis/mengi-cloud.md) · [All operations](https://skmtc.dev/mengi/apis/mengi-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/mengi/apis/mengi-cloud/revisions/70dc8775b002?raw)