---
title: "Reveal a callback endpoint signing secret"
method: GET
path: "/v1/endpoints/{endpointId}/signing-secret"
---

# Reveal a callback endpoint signing secret

`GET /v1/endpoints/{endpointId}/signing-secret`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/endpoints/{endpointId}/signing-secret`
- Auth: HTTP bearer and API key in header `Greatwait-Environment` and API key in header `Greatwait-Project`

Reveals an endpoint's signing secret to a signed-in member: the value `endpoints.create` and `endpoints.rotateSigningKey` hand out once, readable again from the endpoint's own page. During a rotation both keys are returned, with the instant the overlap ends. Only a member session is accepted; an API credential or an OAuth token is refused, so an integration that needs the secret keeps the one the create or rotation that minted it returned. A disabled endpoint has nothing to reveal.

## Path parameters

- `endpointId` string, required

## Response `200`

Reveal a callback endpoint signing secret

- object
  - `current` object, required
    - `keyId` string, required
    - `secret` string, required
  - `id` string, required
  - `next` object
    - `keyId` string, required
    - `secret` string, required
    - `overlapEndsAt` string, required

## Other responses

- `400`: Problem document. Possible codes at this status: invalid_request.
- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing.
- `404`: Problem document. Possible codes at this status: not_found.
- `409`: Problem document. Possible codes at this status: project_archived, state_conflict.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)