---
title: "Get workspace webhook secret status"
method: GET
path: "/workspaces/{id}/webhooks/secret-status"
tags: ["Webhooks"]
---

# Get workspace webhook secret status

`GET /workspaces/{id}/webhooks/secret-status`

Returns the status of the workspace webhook secret including creation date, rotation date, and grace period status.

## Path parameters

- `id` string, uuid, required

## Response `200`

Secret status retrieved

- SecretStatusResponse — Webhook secret status and rotation info
  - `created_at` string, date-time, nullable, required — When the webhook secret was created
  - `last_rotated_at` string, date-time, nullable — When the webhook secret was last rotated
  - `grace_period_active` boolean — Whether the old secret is still valid alongside the new one
  - `grace_period_ends_at` string, date-time, nullable — When the old secret grace period expires

---

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