---
title: "Get a Secret."
method: GET
path: "/v1/secrets/{name}"
tags: ["secrets"]
---

# Get a Secret.

`GET /v1/secrets/{name}`

Retrieve a Secret by name. The secret value is not included for security.

## Path parameters

- `name` string, required

## Response `200`

Successfully retrieved the Secret. Value is omitted for security.

- SecretView — A Secret represents a key-value pair that can be securely stored and used in Devboxes as environment variables.
  - `id` string, required — The unique identifier of the Secret.
  - `name` string, required — The globally unique name of the Secret. Used as the environment variable name in Devboxes.
  - `create_time_ms` integer, required — Creation time of the Secret (Unix timestamp in milliseconds).
  - `update_time_ms` integer, required — Last update time of the Secret (Unix timestamp in milliseconds).

## Other responses

- `404` — Secret not found.

---

[API](https://skmtc.dev/runloopai/apis/runloop-api.md) · [All operations](https://skmtc.dev/runloopai/apis/runloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runloopai/runloop-api/revisions/e9dc776053e4/schema)