List the hooks in a repository

GET

/repos/{owner}/{repo}/hooks

curl --request GET \
  --url https://gitea.com/api/v1/repos/example/example/hooks \
  --header 'Authorization: Basic <credentials>'

Authorizations

• BasicAuth
• Token
• AccessToken
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

Query Parameters

page

integer

Page number of results to return (1-based)

limit

integer

Page size of results

Responses

200

HookList

Media typeapplication/json

Array<object>

Hook a hook is a web hook when one repository changed

object

active

Whether the webhook is active and will be triggered

boolean

authorization_header

Authorization header to include in webhook requests

string

branch_filter

Branch filter pattern to determine which branches trigger the webhook

string

config

Configuration settings for the webhook

object

key

additional properties

string

created_at

string format: date-time

events

List of events that trigger this webhook

Array<string>

id

The unique identifier of the webhook

integer format: int64

name

Optional human-readable name for the webhook

string

type

The type of the webhook (e.g., gitea, slack, discord)

string

updated_at

string format: date-time

Example^generated

[
  {
    "active": true,
    "authorization_header": "example",
    "branch_filter": "example",
    "config": {
      "additionalProperty": "example"
    },
    "created_at": "2026-04-15T12:00:00Z",
    "events": [
      "example"
    ],
    "id": 1,
    "name": "example",
    "type": "example",
    "updated_at": "2026-04-15T12:00:00Z"
  }
]

404

APINotFound is a not found empty response

Media typeapplication/json