naftiko: 1.0.0-alpha2
info:
  label: Knock API — Users
  description: 'Knock API — Users. 35 operations. Lead operation: List users. Self-contained Naftiko capability covering one
    Knock business surface.'
  tags:
  - Knock
  - Users
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    KNOCK_API_KEY: KNOCK_API_KEY
capability:
  consumes:
  - type: http
    namespace: knock-users
    baseUri: https://api.knock.app
    description: Knock API — Users business capability. Self-contained, no shared references.
    resources:
    - name: v1-users
      path: /v1/users
      operations:
      - name: listusers
        method: GET
        description: List users
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: include[]
          in: query
          type: array
          description: Associated resources to include in the response.
        - name: after
          in: query
          type: string
          description: The cursor to fetch entries after.
        - name: before
          in: query
          type: string
          description: The cursor to fetch entries before.
        - name: page_size
          in: query
          type: integer
          description: The number of items per page (defaults to 50).
    - name: v1-users-bulk-delete
      path: /v1/users/bulk/delete
      operations:
      - name: bulkdeleteusers
        method: POST
        description: Bulk delete users
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-bulk-identify
      path: /v1/users/bulk/identify
      operations:
      - name: bulkidentifyusers
        method: POST
        description: Bulk identify users
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-bulk-preferences
      path: /v1/users/bulk/preferences
      operations:
      - name: bulksetuserpreferences
        method: POST
        description: Bulk set preferences
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id
      path: /v1/users/{user_id}
      operations:
      - name: deleteuser
        method: DELETE
        description: Delete user
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The ID of the user to delete.
          required: true
      - name: getuser
        method: GET
        description: Get user
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The ID of the user to retrieve.
          required: true
      - name: identifyuser
        method: PUT
        description: Identify user
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-channel_data-channel_id
      path: /v1/users/{user_id}/channel_data/{channel_id}
      operations:
      - name: unsetuserchanneldata
        method: DELETE
        description: Unset channel data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: channel_id
          in: path
          type: string
          description: The unique identifier for the channel.
          required: true
      - name: getuserchanneldata
        method: GET
        description: Get channel data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: channel_id
          in: path
          type: string
          description: The unique identifier for the channel.
          required: true
      - name: setuserchanneldata
        method: PUT
        description: Set channel data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: channel_id
          in: path
          type: string
          description: The unique identifier for the channel.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-feeds-id
      path: /v1/users/{user_id}/feeds/{id}
      operations:
      - name: listuserinappfeeditems
        method: GET
        description: List feed items
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: id
          in: path
          type: string
          description: The unique identifier for the channel.
          required: true
        - name: status
          in: query
          type: string
          description: The status of the feed items.
        - name: source
          in: query
          type: string
          description: The workflow key associated with the message in the feed.
        - name: tenant
          in: query
          type: string
          description: The tenant associated with the feed items.
        - name: has_tenant
          in: query
          type: boolean
          description: Whether the feed items have a tenant.
        - name: workflow_categories[]
          in: query
          type: array
          description: The workflow categories of the feed items.
        - name: archived
          in: query
          type: string
          description: The archived status of the feed items.
        - name: trigger_data
          in: query
          type: string
          description: The trigger data of the feed items (as a JSON string).
        - name: locale
          in: query
          type: string
          description: The locale to render the feed items in. Must be in the IETF 5646 format (e.g. `en-US`). When not provided,
            will default to the locale that the feed items were r
        - name: exclude
          in: query
          type: string
          description: Comma-separated list of field paths to exclude from the response. Use dot notation for nested fields
            (e.g., `entries.archived_at`). Limited to 3 levels deep.
        - name: mode
          in: query
          type: string
          description: The mode to render the feed items in. Can be `compact` or `rich`. Defaults to `rich`. When `mode` is
            `compact`, feed items will not have `activities` and `total
        - name: after
          in: query
          type: string
          description: The cursor to fetch entries after.
        - name: before
          in: query
          type: string
          description: The cursor to fetch entries before.
        - name: page_size
          in: query
          type: integer
          description: The number of items per page (defaults to 50).
        - name: inserted_at.gt
          in: query
          type: string
          description: Limits the results to items inserted after the given date.
        - name: inserted_at.gte
          in: query
          type: string
          description: Limits the results to items inserted after or on the given date.
        - name: inserted_at.lt
          in: query
          type: string
          description: Limits the results to items inserted before the given date.
        - name: inserted_at.lte
          in: query
          type: string
          description: Limits the results to items inserted before or on the given date.
    - name: v1-users-user_id-feeds-id-settings
      path: /v1/users/{user_id}/feeds/{id}/settings
      operations:
      - name: getuserinappfeedsettings
        method: GET
        description: Get feed settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: id
          in: path
          type: string
          description: The unique identifier for the channel.
          required: true
    - name: v1-users-user_id-guides-engagements-reset
      path: /v1/users/{user_id}/guides/engagements/reset
      operations:
      - name: resetuserguideengagement
        method: PUT
        description: Reset guide engagement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-guides-messages-archived
      path: /v1/users/{user_id}/guides/messages/archived
      operations:
      - name: markuserguideasunarchived
        method: DELETE
        description: Mark guide as unarchived
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: markuserguideasarchived2
        method: PUT
        description: Mark guide as archived
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-guides-messages-interacted
      path: /v1/users/{user_id}/guides/messages/interacted
      operations:
      - name: markuserguideasinteracted2
        method: PUT
        description: Mark guide as interacted
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-guides-messages-seen
      path: /v1/users/{user_id}/guides/messages/seen
      operations:
      - name: markuserguideasseen2
        method: PUT
        description: Mark guide as seen
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-guides-messages-message_id-archived
      path: /v1/users/{user_id}/guides/messages/{message_id}/archived
      operations:
      - name: markuserguideasarchived
        method: PUT
        description: Mark guide as archived
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-guides-messages-message_id-interacted
      path: /v1/users/{user_id}/guides/messages/{message_id}/interacted
      operations:
      - name: markuserguideasinteracted
        method: PUT
        description: Mark guide as interacted
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-guides-messages-message_id-seen
      path: /v1/users/{user_id}/guides/messages/{message_id}/seen
      operations:
      - name: markuserguideasseen
        method: PUT
        description: Mark guide as seen
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-guides-channel_id
      path: /v1/users/{user_id}/guides/{channel_id}
      operations:
      - name: listuserguides
        method: GET
        description: List guides
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: channel_id
          in: path
          type: string
          description: The unique identifier for the channel.
          required: true
        - name: tenant
          in: query
          type: string
          description: The tenant ID to use for targeting and rendering guides.
        - name: data
          in: query
          type: string
          description: The data (JSON encoded object) to use for targeting and rendering guides.
        - name: type
          in: query
          type: string
          description: The type of guides to filter by.
    - name: v1-users-user_id-merge
      path: /v1/users/{user_id}/merge
      operations:
      - name: mergeuser
        method: POST
        description: Merge users
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The id of the user to merge into.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-messages
      path: /v1/users/{user_id}/messages
      operations:
      - name: listmessagesforuser
        method: GET
        description: List user messages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: after
          in: query
          type: string
          description: The cursor to fetch entries after.
        - name: before
          in: query
          type: string
          description: The cursor to fetch entries before.
        - name: page_size
          in: query
          type: integer
          description: The number of items per page (defaults to 50).
        - name: tenant
          in: query
          type: string
          description: Limits the results to items with the corresponding tenant.
        - name: channel_id
          in: query
          type: string
          description: Limits the results to items with the corresponding channel ID.
        - name: status[]
          in: query
          type: array
          description: Limits the results to messages with the given delivery status.
        - name: engagement_status[]
          in: query
          type: array
          description: Limits the results to messages with the given engagement status.
        - name: message_ids[]
          in: query
          type: array
          description: 'Limits the results to only the message IDs given (max 50). Note: when using this option, the results
            will be subject to any other filters applied to the query.'
        - name: workflow_categories[]
          in: query
          type: array
          description: Limits the results to messages related to any of the provided categories.
        - name: source
          in: query
          type: string
          description: Limits the results to messages triggered by the given workflow key.
        - name: workflow_run_id
          in: query
          type: string
          description: Limits the results to messages associated with the top-level workflow run ID returned by the workflow
            trigger request.
        - name: workflow_recipient_run_id
          in: query
          type: string
          description: Limits the results to messages for a specific recipient's workflow run.
        - name: trigger_data
          in: query
          type: string
          description: Limits the results to only messages that were generated with the given data. See [trigger data filtering](/api-reference/overview/trigger-data-filtering)
            for mo
        - name: inserted_at.gt
          in: query
          type: string
          description: Limits the results to items inserted after the given date.
        - name: inserted_at.gte
          in: query
          type: string
          description: Limits the results to items inserted after or on the given date.
        - name: inserted_at.lt
          in: query
          type: string
          description: Limits the results to items inserted before the given date.
        - name: inserted_at.lte
          in: query
          type: string
          description: Limits the results to items inserted before or on the given date.
        - name: user_id
          in: path
          type: string
          description: The user ID to list messages for.
          required: true
    - name: v1-users-user_id-preferences
      path: /v1/users/{user_id}/preferences
      operations:
      - name: listuserpreferencesets
        method: GET
        description: List user preference sets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
    - name: v1-users-user_id-preferences-id
      path: /v1/users/{user_id}/preferences/{id}
      operations:
      - name: deleteuserpreferenceset
        method: DELETE
        description: Delete user preference set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: id
          in: path
          type: string
          description: Unique identifier for the preference set.
          required: true
      - name: getuserpreferenceset
        method: GET
        description: Get user preference set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: id
          in: path
          type: string
          description: Unique identifier for the preference set.
          required: true
        - name: tenant
          in: query
          type: string
          description: The unique identifier for the tenant.
      - name: updateuserpreferenceset
        method: PUT
        description: Update user preference set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The unique identifier of the user.
          required: true
        - name: id
          in: path
          type: string
          description: Unique identifier for the preference set.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-users-user_id-preferences-id-categories
      path: /v1/users/{user_id}/preferences/{id}/categories
      operations:
      - name: updateuserpreferencecategories
        method: PUT
        description: Update categories in user preference set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-users-user_id-preferences-id-categories-key
      path: /v1/users/{user_id}/preferences/{id}/categories/{key}
      operations:
      - name: updateuserpreferencecategory
        method: PUT
        description: Update category in user preference set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-users-user_id-preferences-id-channel_types
      path: /v1/users/{user_id}/preferences/{id}/channel_types
      operations:
      - name: updateuserpreferencechanneltypes
        method: PUT
        description: Update channel types in preference set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-users-user_id-preferences-id-channel_types-type
      path: /v1/users/{user_id}/preferences/{id}/channel_types/{type}
      operations:
      - name: updateuserpreferencechanneltype
        method: PUT
        description: Update channel type in preference set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-users-user_id-preferences-id-workflows
      path: /v1/users/{user_id}/preferences/{id}/workflows
      operations:
      - name: updateuserpreferenceworkflows
        method: PUT
        description: Update workflows in preference set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-users-user_id-preferences-id-workflows-key
      path: /v1/users/{user_id}/preferences/{id}/workflows/{key}
      operations:
      - name: updateuserpreferenceworkflow
        method: PUT
        description: Update workflow in user preference set
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-users-user_id-schedules
      path: /v1/users/{user_id}/schedules
      operations:
      - name: listuserschedules
        method: GET
        description: List user schedules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The user ID to list schedules for.
          required: true
        - name: workflow
          in: query
          type: string
          description: The workflow key to filter schedules for.
        - name: tenant
          in: query
          type: string
          description: The tenant ID to filter schedules for.
        - name: after
          in: query
          type: string
          description: The cursor to fetch entries after.
        - name: before
          in: query
          type: string
          description: The cursor to fetch entries before.
        - name: page_size
          in: query
          type: integer
          description: The number of items per page (defaults to 50).
    - name: v1-users-user_id-subscriptions
      path: /v1/users/{user_id}/subscriptions
      operations:
      - name: listsubscriptionsforuser
        method: GET
        description: List user subscriptions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: path
          type: string
          description: The user ID to list subscriptions for.
          required: true
        - name: include[]
          in: query
          type: array
          description: Associated resources to include in the response.
        - name: objects[]
          in: query
          type: array
          description: Only returns subscriptions for the specified object references.
        - name: after
          in: query
          type: string
          description: The cursor to fetch entries after.
        - name: before
          in: query
          type: string
          description: The cursor to fetch entries before.
        - name: page_size
          in: query
          type: integer
          description: The number of items per page (defaults to 50).
    authentication:
      type: bearer
      token: '{{env.KNOCK_API_KEY}}'
  exposes:
  - type: rest
    namespace: knock-users-rest
    port: 8080
    description: REST adapter for Knock API — Users. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/v1/users
      name: v1-users
      description: REST surface for v1-users.
      operations:
      - method: GET
        name: listusers
        description: List users
        call: knock-users.listusers
        with:
          include[]: rest.include[]
          after: rest.after
          before: rest.before
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/bulk/delete
      name: v1-users-bulk-delete
      description: REST surface for v1-users-bulk-delete.
      operations:
      - method: POST
        name: bulkdeleteusers
        description: Bulk delete users
        call: knock-users.bulkdeleteusers
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/bulk/identify
      name: v1-users-bulk-identify
      description: REST surface for v1-users-bulk-identify.
      operations:
      - method: POST
        name: bulkidentifyusers
        description: Bulk identify users
        call: knock-users.bulkidentifyusers
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/bulk/preferences
      name: v1-users-bulk-preferences
      description: REST surface for v1-users-bulk-preferences.
      operations:
      - method: POST
        name: bulksetuserpreferences
        description: Bulk set preferences
        call: knock-users.bulksetuserpreferences
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}
      name: v1-users-user-id
      description: REST surface for v1-users-user_id.
      operations:
      - method: DELETE
        name: deleteuser
        description: Delete user
        call: knock-users.deleteuser
        with:
          user_id: rest.user_id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getuser
        description: Get user
        call: knock-users.getuser
        with:
          user_id: rest.user_id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: identifyuser
        description: Identify user
        call: knock-users.identifyuser
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/channel-data/{channel-id}
      name: v1-users-user-id-channel-data-channel-id
      description: REST surface for v1-users-user_id-channel_data-channel_id.
      operations:
      - method: DELETE
        name: unsetuserchanneldata
        description: Unset channel data
        call: knock-users.unsetuserchanneldata
        with:
          user_id: rest.user_id
          channel_id: rest.channel_id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getuserchanneldata
        description: Get channel data
        call: knock-users.getuserchanneldata
        with:
          user_id: rest.user_id
          channel_id: rest.channel_id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: setuserchanneldata
        description: Set channel data
        call: knock-users.setuserchanneldata
        with:
          user_id: rest.user_id
          channel_id: rest.channel_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/feeds/{id}
      name: v1-users-user-id-feeds-id
      description: REST surface for v1-users-user_id-feeds-id.
      operations:
      - method: GET
        name: listuserinappfeeditems
        description: List feed items
        call: knock-users.listuserinappfeeditems
        with:
          user_id: rest.user_id
          id: rest.id
          status: rest.status
          source: rest.source
          tenant: rest.tenant
          has_tenant: rest.has_tenant
          workflow_categories[]: rest.workflow_categories[]
          archived: rest.archived
          trigger_data: rest.trigger_data
          locale: rest.locale
          exclude: rest.exclude
          mode: rest.mode
          after: rest.after
          before: rest.before
          page_size: rest.page_size
          inserted_at.gt: rest.inserted_at.gt
          inserted_at.gte: rest.inserted_at.gte
          inserted_at.lt: rest.inserted_at.lt
          inserted_at.lte: rest.inserted_at.lte
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/feeds/{id}/settings
      name: v1-users-user-id-feeds-id-settings
      description: REST surface for v1-users-user_id-feeds-id-settings.
      operations:
      - method: GET
        name: getuserinappfeedsettings
        description: Get feed settings
        call: knock-users.getuserinappfeedsettings
        with:
          user_id: rest.user_id
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/guides/engagements/reset
      name: v1-users-user-id-guides-engagements-reset
      description: REST surface for v1-users-user_id-guides-engagements-reset.
      operations:
      - method: PUT
        name: resetuserguideengagement
        description: Reset guide engagement
        call: knock-users.resetuserguideengagement
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/guides/messages/archived
      name: v1-users-user-id-guides-messages-archived
      description: REST surface for v1-users-user_id-guides-messages-archived.
      operations:
      - method: DELETE
        name: markuserguideasunarchived
        description: Mark guide as unarchived
        call: knock-users.markuserguideasunarchived
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: markuserguideasarchived2
        description: Mark guide as archived
        call: knock-users.markuserguideasarchived2
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/guides/messages/interacted
      name: v1-users-user-id-guides-messages-interacted
      description: REST surface for v1-users-user_id-guides-messages-interacted.
      operations:
      - method: PUT
        name: markuserguideasinteracted2
        description: Mark guide as interacted
        call: knock-users.markuserguideasinteracted2
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/guides/messages/seen
      name: v1-users-user-id-guides-messages-seen
      description: REST surface for v1-users-user_id-guides-messages-seen.
      operations:
      - method: PUT
        name: markuserguideasseen2
        description: Mark guide as seen
        call: knock-users.markuserguideasseen2
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/guides/messages/{message-id}/archived
      name: v1-users-user-id-guides-messages-message-id-archived
      description: REST surface for v1-users-user_id-guides-messages-message_id-archived.
      operations:
      - method: PUT
        name: markuserguideasarchived
        description: Mark guide as archived
        call: knock-users.markuserguideasarchived
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/guides/messages/{message-id}/interacted
      name: v1-users-user-id-guides-messages-message-id-interacted
      description: REST surface for v1-users-user_id-guides-messages-message_id-interacted.
      operations:
      - method: PUT
        name: markuserguideasinteracted
        description: Mark guide as interacted
        call: knock-users.markuserguideasinteracted
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/guides/messages/{message-id}/seen
      name: v1-users-user-id-guides-messages-message-id-seen
      description: REST surface for v1-users-user_id-guides-messages-message_id-seen.
      operations:
      - method: PUT
        name: markuserguideasseen
        description: Mark guide as seen
        call: knock-users.markuserguideasseen
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/guides/{channel-id}
      name: v1-users-user-id-guides-channel-id
      description: REST surface for v1-users-user_id-guides-channel_id.
      operations:
      - method: GET
        name: listuserguides
        description: List guides
        call: knock-users.listuserguides
        with:
          user_id: rest.user_id
          channel_id: rest.channel_id
          tenant: rest.tenant
          data: rest.data
          type: rest.type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/merge
      name: v1-users-user-id-merge
      description: REST surface for v1-users-user_id-merge.
      operations:
      - method: POST
        name: mergeuser
        description: Merge users
        call: knock-users.mergeuser
        with:
          user_id: rest.user_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/messages
      name: v1-users-user-id-messages
      description: REST surface for v1-users-user_id-messages.
      operations:
      - method: GET
        name: listmessagesforuser
        description: List user messages
        call: knock-users.listmessagesforuser
        with:
          after: rest.after
          before: rest.before
          page_size: rest.page_size
          tenant: rest.tenant
          channel_id: rest.channel_id
          status[]: rest.status[]
          engagement_status[]: rest.engagement_status[]
          message_ids[]: rest.message_ids[]
          workflow_categories[]: rest.workflow_categories[]
          source: rest.source
          workflow_run_id: rest.workflow_run_id
          workflow_recipient_run_id: rest.workflow_recipient_run_id
          trigger_data: rest.trigger_data
          inserted_at.gt: rest.inserted_at.gt
          inserted_at.gte: rest.inserted_at.gte
          inserted_at.lt: rest.inserted_at.lt
          inserted_at.lte: rest.inserted_at.lte
          user_id: rest.user_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/preferences
      name: v1-users-user-id-preferences
      description: REST surface for v1-users-user_id-preferences.
      operations:
      - method: GET
        name: listuserpreferencesets
        description: List user preference sets
        call: knock-users.listuserpreferencesets
        with:
          user_id: rest.user_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/preferences/{id}
      name: v1-users-user-id-preferences-id
      description: REST surface for v1-users-user_id-preferences-id.
      operations:
      - method: DELETE
        name: deleteuserpreferenceset
        description: Delete user preference set
        call: knock-users.deleteuserpreferenceset
        with:
          user_id: rest.user_id
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getuserpreferenceset
        description: Get user preference set
        call: knock-users.getuserpreferenceset
        with:
          user_id: rest.user_id
          id: rest.id
          tenant: rest.tenant
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateuserpreferenceset
        description: Update user preference set
        call: knock-users.updateuserpreferenceset
        with:
          user_id: rest.user_id
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/preferences/{id}/categories
      name: v1-users-user-id-preferences-id-categories
      description: REST surface for v1-users-user_id-preferences-id-categories.
      operations:
      - method: PUT
        name: updateuserpreferencecategories
        description: Update categories in user preference set
        call: knock-users.updateuserpreferencecategories
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/preferences/{id}/categories/{key}
      name: v1-users-user-id-preferences-id-categories-key
      description: REST surface for v1-users-user_id-preferences-id-categories-key.
      operations:
      - method: PUT
        name: updateuserpreferencecategory
        description: Update category in user preference set
        call: knock-users.updateuserpreferencecategory
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/preferences/{id}/channel-types
      name: v1-users-user-id-preferences-id-channel-types
      description: REST surface for v1-users-user_id-preferences-id-channel_types.
      operations:
      - method: PUT
        name: updateuserpreferencechanneltypes
        description: Update channel types in preference set
        call: knock-users.updateuserpreferencechanneltypes
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/preferences/{id}/channel-types/{type}
      name: v1-users-user-id-preferences-id-channel-types-type
      description: REST surface for v1-users-user_id-preferences-id-channel_types-type.
      operations:
      - method: PUT
        name: updateuserpreferencechanneltype
        description: Update channel type in preference set
        call: knock-users.updateuserpreferencechanneltype
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/preferences/{id}/workflows
      name: v1-users-user-id-preferences-id-workflows
      description: REST surface for v1-users-user_id-preferences-id-workflows.
      operations:
      - method: PUT
        name: updateuserpreferenceworkflows
        description: Update workflows in preference set
        call: knock-users.updateuserpreferenceworkflows
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/preferences/{id}/workflows/{key}
      name: v1-users-user-id-preferences-id-workflows-key
      description: REST surface for v1-users-user_id-preferences-id-workflows-key.
      operations:
      - method: PUT
        name: updateuserpreferenceworkflow
        description: Update workflow in user preference set
        call: knock-users.updateuserpreferenceworkflow
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/schedules
      name: v1-users-user-id-schedules
      description: REST surface for v1-users-user_id-schedules.
      operations:
      - method: GET
        name: listuserschedules
        description: List user schedules
        call: knock-users.listuserschedules
        with:
          user_id: rest.user_id
          workflow: rest.workflow
          tenant: rest.tenant
          after: rest.after
          before: rest.before
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/users/{user-id}/subscriptions
      name: v1-users-user-id-subscriptions
      description: REST surface for v1-users-user_id-subscriptions.
      operations:
      - method: GET
        name: listsubscriptionsforuser
        description: List user subscriptions
        call: knock-users.listsubscriptionsforuser
        with:
          user_id: rest.user_id
          include[]: rest.include[]
          objects[]: rest.objects[]
          after: rest.after
          before: rest.before
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: knock-users-mcp
    port: 9090
    transport: http
    description: MCP adapter for Knock API — Users. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: list-users
      description: List users
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.listusers
      with:
        include[]: tools.include[]
        after: tools.after
        before: tools.before
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: bulk-delete-users
      description: Bulk delete users
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: knock-users.bulkdeleteusers
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: bulk-identify-users
      description: Bulk identify users
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: knock-users.bulkidentifyusers
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: bulk-set-preferences
      description: Bulk set preferences
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: knock-users.bulksetuserpreferences
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-user
      description: Delete user
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: knock-users.deleteuser
      with:
        user_id: tools.user_id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-user
      description: Get user
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.getuser
      with:
        user_id: tools.user_id
      outputParameters:
      - type: object
        mapping: $.
    - name: identify-user
      description: Identify user
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.identifyuser
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: unset-channel-data
      description: Unset channel data
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: knock-users.unsetuserchanneldata
      with:
        user_id: tools.user_id
        channel_id: tools.channel_id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-channel-data
      description: Get channel data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.getuserchanneldata
      with:
        user_id: tools.user_id
        channel_id: tools.channel_id
      outputParameters:
      - type: object
        mapping: $.
    - name: set-channel-data
      description: Set channel data
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.setuserchanneldata
      with:
        user_id: tools.user_id
        channel_id: tools.channel_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-feed-items
      description: List feed items
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.listuserinappfeeditems
      with:
        user_id: tools.user_id
        id: tools.id
        status: tools.status
        source: tools.source
        tenant: tools.tenant
        has_tenant: tools.has_tenant
        workflow_categories[]: tools.workflow_categories[]
        archived: tools.archived
        trigger_data: tools.trigger_data
        locale: tools.locale
        exclude: tools.exclude
        mode: tools.mode
        after: tools.after
        before: tools.before
        page_size: tools.page_size
        inserted_at.gt: tools.inserted_at.gt
        inserted_at.gte: tools.inserted_at.gte
        inserted_at.lt: tools.inserted_at.lt
        inserted_at.lte: tools.inserted_at.lte
      outputParameters:
      - type: object
        mapping: $.
    - name: get-feed-settings
      description: Get feed settings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.getuserinappfeedsettings
      with:
        user_id: tools.user_id
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: reset-guide-engagement
      description: Reset guide engagement
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.resetuserguideengagement
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mark-guide-unarchived
      description: Mark guide as unarchived
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: knock-users.markuserguideasunarchived
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mark-guide-archived
      description: Mark guide as archived
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.markuserguideasarchived2
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mark-guide-interacted
      description: Mark guide as interacted
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.markuserguideasinteracted2
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mark-guide-seen
      description: Mark guide as seen
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.markuserguideasseen2
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mark-guide-archived-2
      description: Mark guide as archived
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.markuserguideasarchived
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mark-guide-interacted-2
      description: Mark guide as interacted
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.markuserguideasinteracted
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: mark-guide-seen-2
      description: Mark guide as seen
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.markuserguideasseen
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-guides
      description: List guides
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.listuserguides
      with:
        user_id: tools.user_id
        channel_id: tools.channel_id
        tenant: tools.tenant
        data: tools.data
        type: tools.type
      outputParameters:
      - type: object
        mapping: $.
    - name: merge-users
      description: Merge users
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: knock-users.mergeuser
      with:
        user_id: tools.user_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-user-messages
      description: List user messages
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.listmessagesforuser
      with:
        after: tools.after
        before: tools.before
        page_size: tools.page_size
        tenant: tools.tenant
        channel_id: tools.channel_id
        status[]: tools.status[]
        engagement_status[]: tools.engagement_status[]
        message_ids[]: tools.message_ids[]
        workflow_categories[]: tools.workflow_categories[]
        source: tools.source
        workflow_run_id: tools.workflow_run_id
        workflow_recipient_run_id: tools.workflow_recipient_run_id
        trigger_data: tools.trigger_data
        inserted_at.gt: tools.inserted_at.gt
        inserted_at.gte: tools.inserted_at.gte
        inserted_at.lt: tools.inserted_at.lt
        inserted_at.lte: tools.inserted_at.lte
        user_id: tools.user_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-user-preference-sets
      description: List user preference sets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.listuserpreferencesets
      with:
        user_id: tools.user_id
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-user-preference-set
      description: Delete user preference set
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: knock-users.deleteuserpreferenceset
      with:
        user_id: tools.user_id
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-user-preference-set
      description: Get user preference set
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.getuserpreferenceset
      with:
        user_id: tools.user_id
        id: tools.id
        tenant: tools.tenant
      outputParameters:
      - type: object
        mapping: $.
    - name: update-user-preference-set
      description: Update user preference set
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.updateuserpreferenceset
      with:
        user_id: tools.user_id
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-categories-user-preference-set
      description: Update categories in user preference set
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.updateuserpreferencecategories
      outputParameters:
      - type: object
        mapping: $.
    - name: update-category-user-preference-set
      description: Update category in user preference set
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.updateuserpreferencecategory
      outputParameters:
      - type: object
        mapping: $.
    - name: update-channel-types-preference-set
      description: Update channel types in preference set
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.updateuserpreferencechanneltypes
      outputParameters:
      - type: object
        mapping: $.
    - name: update-channel-type-preference-set
      description: Update channel type in preference set
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.updateuserpreferencechanneltype
      outputParameters:
      - type: object
        mapping: $.
    - name: update-workflows-preference-set
      description: Update workflows in preference set
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.updateuserpreferenceworkflows
      outputParameters:
      - type: object
        mapping: $.
    - name: update-workflow-user-preference-set
      description: Update workflow in user preference set
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: knock-users.updateuserpreferenceworkflow
      outputParameters:
      - type: object
        mapping: $.
    - name: list-user-schedules
      description: List user schedules
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.listuserschedules
      with:
        user_id: tools.user_id
        workflow: tools.workflow
        tenant: tools.tenant
        after: tools.after
        before: tools.before
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: list-user-subscriptions
      description: List user subscriptions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: knock-users.listsubscriptionsforuser
      with:
        user_id: tools.user_id
        include[]: tools.include[]
        objects[]: tools.objects[]
        after: tools.after
        before: tools.before
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.