Stride

Search Documentation

Search for articles, guides, and more

← API overview

List your subscriptions

GET/v1/app/webhooksrequires app.manage

Every callback your app has registered, with its health. While an endpoint is failing, failing_since says when that began and consecutive_failures how many attempts have failed; both clear on any success, so a flaky endpoint is never disabled for being occasionally slow. An endpoint with no successful delivery for three days after failing_since is disabled.

Secrets are not returned here. They are shown once, at creation.

Example

bash
curl -X GET "https://api.stride.is/v1/app/webhooks" \
  -H "Authorization: Bearer $STRIDE_TOKEN"

Response200

Success.

  • webhooksobject[]always present
    • consecutive_failuresintegeralways present
    • created_atstringalways present
    • disabled_reasonstring
    • eventsstring[]always present
    • failing_sincestring
    • idstringalways present
    • last_delivery_atstring
    • secretstring
    • statusstringalways present
    • urlstringalways present

Errors

Every error is an RFC 9457 problem document. Branch on itscode, which is stable;detail is prose and may be reworded.

  • 400The request was malformed: an unparseable date, an unknown enum value, or a parameter combination that cannot be satisfied.
  • 401No access token was supplied, or it is not valid for this API.
  • 402The Stride account the token belongs to has no active subscription or trial.
  • 403The token does not hold the scope this endpoint requires, or may not act on the athlete or team named.
  • 404No such resource, or it is not visible to this token. The two are deliberately indistinguishable.
  • 405The path exists but does not serve this method. The Allow header lists the ones it does.
  • 429A rate limit was exceeded. Retry after the period in the Retry-After header.
  • 500Something failed on Stride's side. The failure is logged with a trace ID.