Docs
Search docs

List webhooks

GET/api/repos/{owner}/{repo}/hooks

listWebhooks

Lists all webhooks on a repository. Requires admin access.

Requires authentication using a bearer token or a session cookie — see tokens and scopes.

curl

curl -X GET 'https://neosource.dev/api/repos/OWNER/REPO/hooks' \
  -H 'Authorization: Bearer $NEOSOURCE_TOKEN'

fetch

fetch("https://neosource.dev/api/repos/OWNER/REPO/hooks", {
  method: "GET",
  headers: {
    Authorization: "Bearer $NEOSOURCE_TOKEN",
  },
});

Path parameters

ownerrequired

Repository owner or organization slug.

string

reporequired

Repository name.

string

Responses

200Webhook list

application/json

WebhookListResponse

object

webhooksrequired

array

items

WebhookResponse

object

activerequired

boolean

created_atrequired

integerint64

eventsrequired

array

Event types this webhook is subscribed to.

has_secretrequired

boolean

Whether deliveries are signed (`X-Hub-Signature-256`). The secret itself is never returned.

repo_idrequired

string

updated_atrequired

integerint64

urlrequired

string

webhook_idrequired

string

Standard errors

Bodies documented once for the whole API — see standard errors.

  • 400Bad Request — one of: invalid_input
  • 401Authentication required
  • 403Forbidden — one of: forbidden
  • 404Not Found — one of: not_found
  • 423Locked — one of: busy
  • 429Rate limited — retry after the `Retry-After` header
  • 500Internal server error
  • 503Service temporarily unavailable / at capacity — retry after the `Retry-After` header
  • 504Gateway timeout — the request exceeded the server's handling budget

Schemas

Referenced above. Listed here rather than expanded inline, so the same definition is not repeated at every level.

WebhookEventType

string

User-facing event types for webhook subscriptions. The vocabulary is deliberately closed; the `OpenAPI` spec advertises it as a real enum so SDK clients get exhaustive types. New events extend this enum. Only `workflow_run`, `registry_package` and `release` are delivered today; the other six are accepted but not yet delivered (#511).

"push""pull_request""mention""assigned""review_requested""issue_comment""workflow_run""registry_package""release""ping"