Get a list of webhooks

GET /webhooks

Get a list of all the current webhooks.

Requires an API key with the webhooks:read scope.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • id string

      ID of the webhook (auto-generated)

    • type string Required

      Type of webhook

      Values are NewMeasurement, NewEvent, InstrumentStatus, CalibrationFinished, or SicFinished.

    • instrument string Required

      Serial number of the instrument

    • url string(uri) Required

      URL to send the webhook message to. Must use HTTPS.

    • secret string

      Secret used to sign the webhook message. If not set, a random secret will be generated.
  • 401 application/json

    Your access token is invalid or has expired

    Hide response attributes Show response attributes object
  • 403 application/json

    You do not have permission to access this data

    Hide response attributes Show response attributes object
  • 429 application/json

    You have made too many requests in a short time

    Hide response attributes Show response attributes object
GET /webhooks 
curl \
 --request GET 'https://api.mycirrus.cloud/v1/webhooks'
Response examples (200) 
[
  {
    "id": "xxxxxxxxxxxx",
    "url": "https://example.com/mywebhook",
    "type": "NewMeasurement",
    "secret": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "instrument": "QT123456"
  }
]
Response examples (401) 
{
  "error": "TokenExpired",
  "description": "Your access token is invalid or has expired. Try refreshing the token."
}
Response examples (403) 
{
  "error": "AccessDenied",
  "description": "You do not have permission to access this data."
}
Response examples (429) 
{
  "error": "TooManyRequests",
  "description": "You have made too many requests in a short time. Please wait before trying again."
}