---
title: "Describe pipeline secret"
method: GET
path: "/pipeline-secrets/{secretId}"
tags: ["pipeline-secrets"]
---

# Describe pipeline secret

`GET /pipeline-secrets/{secretId}`

Retrieves the details of the pipeline secret identified by the given `secretId`.

## Path parameters

- `secretId` integer, required

## Query parameters

- `workspaceId` integer

## Response `200`

OK

- DescribePipelineSecretResponse
  - `pipelineSecret` PipelineSecret
    - `dateCreated` string, date-time
    - `id` integer, nullable
    - `lastUpdated` string, date-time
    - `lastUsed` string, date-time, nullable
    - `name` string, required

## Other responses

- `400` — Bad request
- `403` — Operation not allowed

## Changes

> 14 revisions in range; 1 not diffed.

- **2026-08-27** `97f7655d105a` — 1 breaking
  - the response property `pipelineSecret/lastUsed` became nullable for the status `200`

[Change history](https://skmtc.dev/seqeralabs/apis/seqera-api/changes/pipeline-secrets/:secretId/get.md)

---

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