Skip to content
Linq Copy agent prompt

List signing secrets

GET/v1/webhook_endpoints/{endpoint}/secrets

Lists an endpoint’s signing secrets — ids and status only, never the key material. Oldest first, which is the order their signatures appear in the header.

Path ParametersExpand Collapse
endpoint: string
ReturnsExpand Collapse
SigningSecretList object { data }

An endpoint’s signing secrets, oldest first — the order they sign in.

data: array of SigningSecret { id, created_at, retired_at, status }
id: string

The secret’s id. Safe to log: it is a handle, not key material.

created_at: string
formatdate-time
retired_at: string

When this secret stopped signing. null while it is active.

formatdate-time
status: string

active or retired. Values grow additively.

List signing secrets

curl https://whatsapp.messages.api.linqapp.com/v1/webhook_endpoints/$ENDPOINT/secrets \
    -H "Authorization: Bearer $LINQ_WHATSAPP_API_KEY"
{
  "data": [
    {
      "id": "id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "retired_at": "2019-12-27T18:11:19.117Z",
      "status": "status"
    }
  ]
}
Returns Examples
{
  "data": [
    {
      "id": "id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "retired_at": "2019-12-27T18:11:19.117Z",
      "status": "status"
    }
  ]
}