Hookdeck Admin REST API — Requests

naftiko: 1.0.0-alpha2
info:
  label: Hookdeck Admin REST API — Requests
  description: 'Hookdeck Admin REST API — Requests. 6 operations. Lead operation: Retrieve requests. Self-contained Naftiko capability covering one business surface.'
  tags:
  - Hookdeck
  - Requests
  created: '2026-05-20'
  modified: '2026-05-20'
binds:
- namespace: env
  keys:
    HOOKDECK_API_KEY: HOOKDECK_API_KEY
capability:
  consumes:
  - type: http
    namespace: hookdeck-requests
    baseUri: https://api.hookdeck.com/2025-07-01
    description: Hookdeck Admin REST API — Requests business capability. Self-contained, no shared references.
    resources:
    - name: requests
      path: /requests
      operations:
      - name: getrequests
        method: GET
        description: Retrieve requests
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
          description: query parameter id.
        - name: status
          in: query
          type: string
          description: query parameter status.
        - name: rejection_cause
          in: query
          type: string
          description: query parameter rejection_cause.
        - name: source_id
          in: query
          type: string
          description: query parameter source_id.
        - name: verified
          in: query
          type: boolean
          description: query parameter verified.
        - name: search_term
          in: query
          type: string
          description: query parameter search_term.
        - name: headers
          in: query
          type: string
          description: query parameter headers.
        - name: body
          in: query
          type: string
          description: query parameter body.
        - name: parsed_query
          in: query
          type: string
          description: query parameter parsed_query.
        - name: path
          in: query
          type: string
          description: query parameter path.
        - name: ignored_count
          in: query
          type: string
          description: query parameter ignored_count.
        - name: events_count
          in: query
          type: string
          description: query parameter events_count.
        - name: cli_events_count
          in: query
          type: string
          description: query parameter cli_events_count.
        - name: created_at
          in: query
          type: string
          description: query parameter created_at.
        - name: ingested_at
          in: query
          type: string
          description: query parameter ingested_at.
        - name: bulk_retry_id
          in: query
          type: string
          description: query parameter bulk_retry_id.
        - name: include
          in: query
          type: string
          description: query parameter include.
        - name: progressive
          in: query
          type: string
          description: query parameter progressive.
        - name: order_by
          in: query
          type: string
          description: query parameter order_by.
        - name: dir
          in: query
          type: string
          description: query parameter dir.
        - name: limit
          in: query
          type: integer
          description: query parameter limit.
        - name: next
          in: query
          type: string
          description: query parameter next.
        - name: prev
          in: query
          type: string
          description: query parameter prev.
    - name: requests-id
      path: /requests/{id}
      operations:
      - name: getrequest
        method: GET
        description: Retrieve a request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: path parameter id.
          required: true
    - name: requests-id-raw-body
      path: /requests/{id}/raw_body
      operations:
      - name: getrequestrawbody
        method: GET
        description: Get a request raw body data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: path parameter id.
          required: true
    - name: requests-id-retry
      path: /requests/{id}/retry
      operations:
      - name: retryrequest
        method: POST
        description: Retry a request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: path parameter id.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: requests-id-events
      path: /requests/{id}/events
      operations:
      - name: getrequestevents
        method: GET
        description: Retrieve request events
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
          description: query parameter id.
        - name: status
          in: query
          type: string
          description: query parameter status.
        - name: webhook_id
          in: query
          type: string
          description: query parameter webhook_id.
        - name: destination_id
          in: query
          type: string
          description: query parameter destination_id.
        - name: source_id
          in: query
          type: string
          description: query parameter source_id.
        - name: attempts
          in: query
          type: string
          description: query parameter attempts.
        - name: response_status
          in: query
          type: string
          description: query parameter response_status.
        - name: successful_at
          in: query
          type: string
          description: query parameter successful_at.
        - name: created_at
          in: query
          type: string
          description: query parameter created_at.
        - name: error_code
          in: query
          type: string
          description: query parameter error_code.
        - name: cli_id
          in: query
          type: string
          description: query parameter cli_id.
        - name: last_attempt_at
          in: query
          type: string
          description: query parameter last_attempt_at.
        - name: next_attempt_at
          in: query
          type: string
          description: query parameter next_attempt_at.
        - name: search_term
          in: query
          type: string
          description: query parameter search_term.
        - name: headers
          in: query
          type: string
          description: query parameter headers.
        - name: body
          in: query
          type: string
          description: query parameter body.
        - name: parsed_query
          in: query
          type: string
          description: query parameter parsed_query.
        - name: path
          in: query
          type: string
          description: query parameter path.
        - name: cli_user_id
          in: query
          type: string
          description: query parameter cli_user_id.
        - name: issue_id
          in: query
          type: string
          description: query parameter issue_id.
        - name: event_data_id
          in: query
          type: string
          description: query parameter event_data_id.
        - name: bulk_retry_id
          in: query
          type: string
          description: query parameter bulk_retry_id.
        - name: include
          in: query
          type: string
          description: query parameter include.
        - name: progressive
          in: query
          type: string
          description: query parameter progressive.
        - name: order_by
          in: query
          type: string
          description: query parameter order_by.
        - name: dir
          in: query
          type: string
          description: query parameter dir.
        - name: limit
          in: query
          type: integer
          description: query parameter limit.
        - name: next
          in: query
          type: string
          description: query parameter next.
        - name: prev
          in: query
          type: string
          description: query parameter prev.
        - name: id
          in: path
          type: string
          description: path parameter id.
          required: true
    - name: requests-id-ignored-events
      path: /requests/{id}/ignored_events
      operations:
      - name: getrequestignoredevents
        method: GET
        description: Retrieve request ignored events
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
          description: query parameter id.
        - name: order_by
          in: query
          type: string
          description: query parameter order_by.
        - name: dir
          in: query
          type: string
          description: query parameter dir.
        - name: limit
          in: query
          type: integer
          description: query parameter limit.
        - name: next
          in: query
          type: string
          description: query parameter next.
        - name: prev
          in: query
          type: string
          description: query parameter prev.
        - name: id
          in: path
          type: string
          description: path parameter id.
          required: true
  exposes:
  - type: rest
    namespace: hookdeck-requests-rest
    port: 8080
    description: REST adapter for Hookdeck Admin REST API — Requests. One resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/requests
      name: requests
      description: REST surface for requests.
      operations:
      - method: GET
        name: getrequests
        description: Retrieve requests
        call: hookdeck-requests.getrequests
        with:
          id: rest.id
          status: rest.status
          rejection_cause: rest.rejection_cause
          source_id: rest.source_id
          verified: rest.verified
          search_term: rest.search_term
          headers: rest.headers
          body: rest.body
          parsed_query: rest.parsed_query
          path: rest.path
          ignored_count: rest.ignored_count
          events_count: rest.events_count
          cli_events_count: rest.cli_events_count
          created_at: rest.created_at
          ingested_at: rest.ingested_at
          bulk_retry_id: rest.bulk_retry_id
          include: rest.include
          progressive: rest.progressive
          order_by: rest.order_by
          dir: rest.dir
          limit: rest.limit
          next: rest.next
          prev: rest.prev
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/requests/{id}
      name: requests-id
      description: REST surface for requests-id.
      operations:
      - method: GET
        name: getrequest
        description: Retrieve a request
        call: hookdeck-requests.getrequest
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/requests/{id}/raw_body
      name: requests-id-raw-body
      description: REST surface for requests-id-raw-body.
      operations:
      - method: GET
        name: getrequestrawbody
        description: Get a request raw body data
        call: hookdeck-requests.getrequestrawbody
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/requests/{id}/retry
      name: requests-id-retry
      description: REST surface for requests-id-retry.
      operations:
      - method: POST
        name: retryrequest
        description: Retry a request
        call: hookdeck-requests.retryrequest
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/requests/{id}/events
      name: requests-id-events
      description: REST surface for requests-id-events.
      operations:
      - method: GET
        name: getrequestevents
        description: Retrieve request events
        call: hookdeck-requests.getrequestevents
        with:
          id: rest.id
          status: rest.status
          webhook_id: rest.webhook_id
          destination_id: rest.destination_id
          source_id: rest.source_id
          attempts: rest.attempts
          response_status: rest.response_status
          successful_at: rest.successful_at
          created_at: rest.created_at
          error_code: rest.error_code
          cli_id: rest.cli_id
          last_attempt_at: rest.last_attempt_at
          next_attempt_at: rest.next_attempt_at
          search_term: rest.search_term
          headers: rest.headers
          body: rest.body
          parsed_query: rest.parsed_query
          path: rest.path
          cli_user_id: rest.cli_user_id
          issue_id: rest.issue_id
          event_data_id: rest.event_data_id
          bulk_retry_id: rest.bulk_retry_id
          include: rest.include
          progressive: rest.progressive
          order_by: rest.order_by
          dir: rest.dir
          limit: rest.limit
          next: rest.next
          prev: rest.prev
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/requests/{id}/ignored_events
      name: requests-id-ignored-events
      description: REST surface for requests-id-ignored-events.
      operations:
      - method: GET
        name: getrequestignoredevents
        description: Retrieve request ignored events
        call: hookdeck-requests.getrequestignoredevents
        with:
          id: rest.id
          order_by: rest.order_by
          dir: rest.dir
          limit: rest.limit
          next: rest.next
          prev: rest.prev
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: hookdeck-requests-mcp
    port: 9090
    transport: http
    description: MCP adapter for Hookdeck Admin REST API — Requests. One tool per consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: hookdeck-getrequests
      description: Retrieve requests
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: hookdeck-requests.getrequests
      with:
        id: tools.id
        status: tools.status
        rejection_cause: tools.rejection_cause
        source_id: tools.source_id
        verified: tools.verified
        search_term: tools.search_term
        headers: tools.headers
        body: tools.body
        parsed_query: tools.parsed_query
        path: tools.path
        ignored_count: tools.ignored_count
        events_count: tools.events_count
        cli_events_count: tools.cli_events_count
        created_at: tools.created_at
        ingested_at: tools.ingested_at
        bulk_retry_id: tools.bulk_retry_id
        include: tools.include
        progressive: tools.progressive
        order_by: tools.order_by
        dir: tools.dir
        limit: tools.limit
        next: tools.next
        prev: tools.prev
      outputParameters:
      - type: object
        mapping: $.
    - name: hookdeck-getrequest
      description: Retrieve a request
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: hookdeck-requests.getrequest
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: hookdeck-getrequestrawbody
      description: Get a request raw body data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: hookdeck-requests.getrequestrawbody
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: hookdeck-retryrequest
      description: Retry a request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: hookdeck-requests.retryrequest
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: hookdeck-getrequestevents
      description: Retrieve request events
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: hookdeck-requests.getrequestevents
      with:
        id: tools.id
        status: tools.status
        webhook_id: tools.webhook_id
        destination_id: tools.destination_id
        source_id: tools.source_id
        attempts: tools.attempts
        response_status: tools.response_status
        successful_at: tools.successful_at
        created_at: tools.created_at
        error_code: tools.error_code
        cli_id: tools.cli_id
        last_attempt_at: tools.last_attempt_at
        next_attempt_at: tools.next_attempt_at
        search_term: tools.search_term
        headers: tools.headers
        body: tools.body
        parsed_query: tools.parsed_query
        path: tools.path
        cli_user_id: tools.cli_user_id
        issue_id: tools.issue_id
        event_data_id: tools.event_data_id
        bulk_retry_id: tools.bulk_retry_id
        include: tools.include
        progressive: tools.progressive
        order_by: tools.order_by
        dir: tools.dir
        limit: tools.limit
        next: tools.next
        prev: tools.prev
      outputParameters:
      - type: object
        mapping: $.
    - name: hookdeck-getrequestignoredevents
      description: Retrieve request ignored events
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: hookdeck-requests.getrequestignoredevents
      with:
        id: tools.id
        order_by: tools.order_by
        dir: tools.dir
        limit: tools.limit
        next: tools.next
        prev: tools.prev
      outputParameters:
      - type: object
        mapping: $.