Dashboards v3 · embed

Create or rotate the workspace embed signing secret

Workspace owners and admins only. Returns the plaintext secret ONCE; no read route ever includes it. Rotating keeps the previous secret valid for 24 hours. This route is excluded from the request log.

post/workspaces/{workspace_id}/embed/secret

Request

  • Base URL: https://app.mammoth.io/api/v2
  • URL: https://app.mammoth.io/api/v2/workspaces/{workspace_id}/embed/secret
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-KEY and API key in header X-API-SECRET and API key in header X-WORKSPACE-ID

Path parameters

workspace_idinteger required

Response

A new workspace embed secret (shown once)

secretstring required
token_ttlinteger required
rotated_atstring date-time nullable

Changes

No recorded changes to this operation across all 3 revisions of this API.