naftiko: 1.0.0-alpha2 info: label: github-repo-hooks-api — Repositories description: 'github-repo-hooks-api — Repositories. 16 operations. Lead operation: GitHub List Repository Webhooks. Self-contained Naftiko capability covering one Github business surface.' tags: - Github - Repositories created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: GITHUB_API_KEY: GITHUB_API_KEY capability: consumes: - type: http namespace: repo-hooks-repositories baseUri: '' description: github-repo-hooks-api — Repositories business capability. Self-contained, no shared references. resources: - name: repos-owner-repo-hooks path: /repos/{owner}/{repo}/hooks operations: - name: listrepositorywebhooks method: GET description: GitHub List Repository Webhooks outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: createrepositorywebhook method: POST description: GitHub Create Repository Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: false - name: repos-owner-repo-hooks-hook_id path: /repos/{owner}/{repo}/hooks/{hook_id} operations: - name: getrepositorywebhook method: GET description: GitHub Get Repository Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: updaterepositorywebhook method: PATCH description: GitHub Update Repository Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: true - name: deleterepositorywebhook method: DELETE description: GitHub Delete Repository Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-hooks-hook_id-config path: /repos/{owner}/{repo}/hooks/{hook_id}/config operations: - name: getwebhookconfigurationforrepository method: GET description: GitHub Get Webhook Configuration for Repository outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: updatewebhookconfigurationforrepository method: PATCH description: GitHub Update Webhook Configuration for Repository outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: false - name: repos-owner-repo-hooks-hook_id-deliveries path: /repos/{owner}/{repo}/hooks/{hook_id}/deliveries operations: - name: listdeliveriesforrepositorywebhook method: GET description: GitHub List Deliveries for Repository Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: redelivery in: query type: boolean - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-hooks-hook_id-deliveries-delivery_id path: /repos/{owner}/{repo}/hooks/{hook_id}/deliveries/{delivery_id} operations: - name: getdeliveryforrepositorywebhook method: GET description: GitHub Get Delivery for Repository Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-hooks-hook_id-deliveries-delivery_id-attempts path: /repos/{owner}/{repo}/hooks/{hook_id}/deliveries/{delivery_id}/attempts operations: - name: redeliverdeliveryforrepositorywebhook method: POST description: GitHub Redeliver Delivery for Repository Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-hooks-hook_id-pings path: /repos/{owner}/{repo}/hooks/{hook_id}/pings operations: - name: pingrepositorywebhook method: POST description: GitHub Ping Repository Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-hooks-hook_id-tests path: /repos/{owner}/{repo}/hooks/{hook_id}/tests operations: - name: testthepushrepositorywebhook method: POST description: GitHub Test the Push Repository Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-pre-receive-hooks path: /repos/{owner}/{repo}/pre-receive-hooks operations: - name: listprereceivehooksforrepository method: GET description: GitHub List Pre-receive Hooks for Repository outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: sort in: query type: string - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-pre-receive-hooks-pre_receive_hook_id path: /repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id} operations: - name: getprereceivehookforrepository method: GET description: GitHub Get Pre-receive Hook for Repository outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: updateprereceivehookenforcementforrepository method: PATCH description: GitHub Update Pre-receive Hook Enforcement for Repository outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: false - name: removeprereceivehookenforcementforrepository method: DELETE description: GitHub Remove Pre-receive Hook Enforcement for Repository outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string authentication: type: bearer token: '{{env.GITHUB_API_KEY}}' exposes: - type: rest namespace: repo-hooks-repositories-rest port: 8080 description: REST adapter for github-repo-hooks-api — Repositories. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/repos/{owner}/{repo}/hooks name: repos-owner-repo-hooks description: REST surface for repos-owner-repo-hooks. operations: - method: GET name: listrepositorywebhooks description: GitHub List Repository Webhooks call: repo-hooks-repositories.listrepositorywebhooks with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: POST name: createrepositorywebhook description: GitHub Create Repository Webhook call: repo-hooks-repositories.createrepositorywebhook with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/hooks/{hook-id} name: repos-owner-repo-hooks-hook-id description: REST surface for repos-owner-repo-hooks-hook_id. operations: - method: GET name: getrepositorywebhook description: GitHub Get Repository Webhook call: repo-hooks-repositories.getrepositorywebhook with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: PATCH name: updaterepositorywebhook description: GitHub Update Repository Webhook call: repo-hooks-repositories.updaterepositorywebhook with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleterepositorywebhook description: GitHub Delete Repository Webhook call: repo-hooks-repositories.deleterepositorywebhook with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/hooks/{hook-id}/config name: repos-owner-repo-hooks-hook-id-config description: REST surface for repos-owner-repo-hooks-hook_id-config. operations: - method: GET name: getwebhookconfigurationforrepository description: GitHub Get Webhook Configuration for Repository call: repo-hooks-repositories.getwebhookconfigurationforrepository with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: PATCH name: updatewebhookconfigurationforrepository description: GitHub Update Webhook Configuration for Repository call: repo-hooks-repositories.updatewebhookconfigurationforrepository with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/hooks/{hook-id}/deliveries name: repos-owner-repo-hooks-hook-id-deliveries description: REST surface for repos-owner-repo-hooks-hook_id-deliveries. operations: - method: GET name: listdeliveriesforrepositorywebhook description: GitHub List Deliveries for Repository Webhook call: repo-hooks-repositories.listdeliveriesforrepositorywebhook with: redelivery: rest.redelivery Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/hooks/{hook-id}/deliveries/{delivery-id} name: repos-owner-repo-hooks-hook-id-deliveries-delivery-id description: REST surface for repos-owner-repo-hooks-hook_id-deliveries-delivery_id. operations: - method: GET name: getdeliveryforrepositorywebhook description: GitHub Get Delivery for Repository Webhook call: repo-hooks-repositories.getdeliveryforrepositorywebhook with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/hooks/{hook-id}/deliveries/{delivery-id}/attempts name: repos-owner-repo-hooks-hook-id-deliveries-delivery-id-attempts description: REST surface for repos-owner-repo-hooks-hook_id-deliveries-delivery_id-attempts. operations: - method: POST name: redeliverdeliveryforrepositorywebhook description: GitHub Redeliver Delivery for Repository Webhook call: repo-hooks-repositories.redeliverdeliveryforrepositorywebhook with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/hooks/{hook-id}/pings name: repos-owner-repo-hooks-hook-id-pings description: REST surface for repos-owner-repo-hooks-hook_id-pings. operations: - method: POST name: pingrepositorywebhook description: GitHub Ping Repository Webhook call: repo-hooks-repositories.pingrepositorywebhook with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/hooks/{hook-id}/tests name: repos-owner-repo-hooks-hook-id-tests description: REST surface for repos-owner-repo-hooks-hook_id-tests. operations: - method: POST name: testthepushrepositorywebhook description: GitHub Test the Push Repository Webhook call: repo-hooks-repositories.testthepushrepositorywebhook with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/pre-receive-hooks name: repos-owner-repo-pre-receive-hooks description: REST surface for repos-owner-repo-pre-receive-hooks. operations: - method: GET name: listprereceivehooksforrepository description: GitHub List Pre-receive Hooks for Repository call: repo-hooks-repositories.listprereceivehooksforrepository with: sort: rest.sort Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/pre-receive-hooks/{pre-receive-hook-id} name: repos-owner-repo-pre-receive-hooks-pre-receive-hook-id description: REST surface for repos-owner-repo-pre-receive-hooks-pre_receive_hook_id. operations: - method: GET name: getprereceivehookforrepository description: GitHub Get Pre-receive Hook for Repository call: repo-hooks-repositories.getprereceivehookforrepository with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: PATCH name: updateprereceivehookenforcementforrepository description: GitHub Update Pre-receive Hook Enforcement for Repository call: repo-hooks-repositories.updateprereceivehookenforcementforrepository with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: removeprereceivehookenforcementforrepository description: GitHub Remove Pre-receive Hook Enforcement for Repository call: repo-hooks-repositories.removeprereceivehookenforcementforrepository with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - type: mcp namespace: repo-hooks-repositories-mcp port: 9090 transport: http description: MCP adapter for github-repo-hooks-api — Repositories. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: github-list-repository-webhooks description: GitHub List Repository Webhooks hints: readOnly: true destructive: false idempotent: true call: repo-hooks-repositories.listrepositorywebhooks with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-create-repository-webhook description: GitHub Create Repository Webhook hints: readOnly: false destructive: false idempotent: false call: repo-hooks-repositories.createrepositorywebhook with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: github-get-repository-webhook description: GitHub Get Repository Webhook hints: readOnly: true destructive: false idempotent: true call: repo-hooks-repositories.getrepositorywebhook with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-update-repository-webhook description: GitHub Update Repository Webhook hints: readOnly: false destructive: false idempotent: true call: repo-hooks-repositories.updaterepositorywebhook with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-repository-webhook description: GitHub Delete Repository Webhook hints: readOnly: false destructive: true idempotent: true call: repo-hooks-repositories.deleterepositorywebhook with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-get-webhook-configuration-repository description: GitHub Get Webhook Configuration for Repository hints: readOnly: true destructive: false idempotent: true call: repo-hooks-repositories.getwebhookconfigurationforrepository with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-update-webhook-configuration-repository description: GitHub Update Webhook Configuration for Repository hints: readOnly: false destructive: false idempotent: true call: repo-hooks-repositories.updatewebhookconfigurationforrepository with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: github-list-deliveries-repository-webhook description: GitHub List Deliveries for Repository Webhook hints: readOnly: true destructive: false idempotent: true call: repo-hooks-repositories.listdeliveriesforrepositorywebhook with: redelivery: tools.redelivery Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-get-delivery-repository-webhook description: GitHub Get Delivery for Repository Webhook hints: readOnly: true destructive: false idempotent: true call: repo-hooks-repositories.getdeliveryforrepositorywebhook with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-redeliver-delivery-repository-webhook description: GitHub Redeliver Delivery for Repository Webhook hints: readOnly: false destructive: false idempotent: false call: repo-hooks-repositories.redeliverdeliveryforrepositorywebhook with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-ping-repository-webhook description: GitHub Ping Repository Webhook hints: readOnly: false destructive: false idempotent: false call: repo-hooks-repositories.pingrepositorywebhook with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-test-push-repository-webhook description: GitHub Test the Push Repository Webhook hints: readOnly: true destructive: false idempotent: false call: repo-hooks-repositories.testthepushrepositorywebhook with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-list-pre-receive-hooks description: GitHub List Pre-receive Hooks for Repository hints: readOnly: true destructive: false idempotent: true call: repo-hooks-repositories.listprereceivehooksforrepository with: sort: tools.sort Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-get-pre-receive-hook description: GitHub Get Pre-receive Hook for Repository hints: readOnly: true destructive: false idempotent: true call: repo-hooks-repositories.getprereceivehookforrepository with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: github-update-pre-receive-hook description: GitHub Update Pre-receive Hook Enforcement for Repository hints: readOnly: false destructive: false idempotent: true call: repo-hooks-repositories.updateprereceivehookenforcementforrepository with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-pre-receive-hook description: GitHub Remove Pre-receive Hook Enforcement for Repository hints: readOnly: false destructive: true idempotent: true call: repo-hooks-repositories.removeprereceivehookenforcementforrepository with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $.