naftiko: 1.0.0-alpha2
info:
  label: Zoom REST API — User
  description: 'Zoom REST API — User. 20 operations. Lead operation: User. Self-contained Naftiko capability covering one
    Zoom business surface.'
  tags:
  - Zoom
  - User
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ZOOM_API_KEY: ZOOM_API_KEY
capability:
  consumes:
  - type: http
    namespace: zoom-user
    baseUri: https://api.zoom.us/v1
    description: Zoom REST API — User business capability. Self-contained, no shared references.
    resources:
    - name: user-activate
      path: /user/activate
      operations:
      - name: useractivate
        method: POST
        description: Activate a user on Zoom, return the user ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-assistant-delete
      path: /user/assistant/delete
      operations:
      - name: userassistantdelete
        method: POST
        description: Delete a user's assistant.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-assistant-set
      path: /user/assistant/set
      operations:
      - name: userassistantset
        method: POST
        description: Set a user's assistant which can schedule meeting for him.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-autocreate
      path: /user/autocreate
      operations:
      - name: userautocreate
        method: POST
        description: Create a user on Zoom, returns the created user ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-checkemail
      path: /user/checkemail
      operations:
      - name: usercheckemail
        method: POST
        description: Check if the user email exists.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-checkzpk
      path: /user/checkzpk
      operations:
      - name: usercheckzpk
        method: POST
        description: Check if the zpk is expired. The zpk is used to authenticate a user.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-create
      path: /user/create
      operations:
      - name: usercreate
        method: POST
        description: Create a user on Zoom, returns the created user ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-custcreate
      path: /user/custcreate
      operations:
      - name: usercustcreate
        method: POST
        description: Create a user on Zoom, returns the created user ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-deactivate
      path: /user/deactivate
      operations:
      - name: userdeactivate
        method: POST
        description: Deactivate a user on Zoom, return the user ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-delete
      path: /user/delete
      operations:
      - name: userdelete
        method: POST
        description: Delete a user on Zoom, return the deleted user ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-get
      path: /user/get
      operations:
      - name: userget
        method: POST
        description: Get a user info on Zoom via user ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-getbyemail
      path: /user/getbyemail
      operations:
      - name: usergetbyemail
        method: POST
        description: Get a user on Zoom via user email address and login type, return the user info.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-list
      path: /user/list
      operations:
      - name: userlist
        method: POST
        description: List all the users on Zoom
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-pending
      path: /user/pending
      operations:
      - name: userpending
        method: POST
        description: List all the pending users on Zoom
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-permanentdelete
      path: /user/permanentdelete
      operations:
      - name: userpermanentdelete
        method: POST
        description: Delete a user from Zoom system permanently.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-revoketoken
      path: /user/revoketoken
      operations:
      - name: userrevoketoken
        method: POST
        description: Revoke a user's SSO token.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-scheduleforhost-list
      path: /user/scheduleforhost/list
      operations:
      - name: userscheduleforhostlist
        method: POST
        description: List assigned schedule privilege for host users.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-ssocreate
      path: /user/ssocreate
      operations:
      - name: userssocreate
        method: POST
        description: Create a SSO user on Zoom, return the created user ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-update
      path: /user/update
      operations:
      - name: userupdate
        method: POST
        description: Update user info on Zoom via user ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-updatepassword
      path: /user/updatepassword
      operations:
      - name: userupdatepassword
        method: POST
        description: Upload and update user's profile picture on Zoom via user ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: api_key
      value: '{{env.ZOOM_API_KEY}}'
      placement: query
  exposes:
  - type: rest
    namespace: zoom-user-rest
    port: 8080
    description: REST adapter for Zoom REST API — User. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/user/activate
      name: user-activate
      description: REST surface for user-activate.
      operations:
      - method: POST
        name: useractivate
        description: Activate a user on Zoom, return the user ID.
        call: zoom-user.useractivate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/assistant/delete
      name: user-assistant-delete
      description: REST surface for user-assistant-delete.
      operations:
      - method: POST
        name: userassistantdelete
        description: Delete a user's assistant.
        call: zoom-user.userassistantdelete
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/assistant/set
      name: user-assistant-set
      description: REST surface for user-assistant-set.
      operations:
      - method: POST
        name: userassistantset
        description: Set a user's assistant which can schedule meeting for him.
        call: zoom-user.userassistantset
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/autocreate
      name: user-autocreate
      description: REST surface for user-autocreate.
      operations:
      - method: POST
        name: userautocreate
        description: Create a user on Zoom, returns the created user ID.
        call: zoom-user.userautocreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/checkemail
      name: user-checkemail
      description: REST surface for user-checkemail.
      operations:
      - method: POST
        name: usercheckemail
        description: Check if the user email exists.
        call: zoom-user.usercheckemail
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/checkzpk
      name: user-checkzpk
      description: REST surface for user-checkzpk.
      operations:
      - method: POST
        name: usercheckzpk
        description: Check if the zpk is expired. The zpk is used to authenticate a user.
        call: zoom-user.usercheckzpk
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/create
      name: user-create
      description: REST surface for user-create.
      operations:
      - method: POST
        name: usercreate
        description: Create a user on Zoom, returns the created user ID.
        call: zoom-user.usercreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/custcreate
      name: user-custcreate
      description: REST surface for user-custcreate.
      operations:
      - method: POST
        name: usercustcreate
        description: Create a user on Zoom, returns the created user ID.
        call: zoom-user.usercustcreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/deactivate
      name: user-deactivate
      description: REST surface for user-deactivate.
      operations:
      - method: POST
        name: userdeactivate
        description: Deactivate a user on Zoom, return the user ID.
        call: zoom-user.userdeactivate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/delete
      name: user-delete
      description: REST surface for user-delete.
      operations:
      - method: POST
        name: userdelete
        description: Delete a user on Zoom, return the deleted user ID.
        call: zoom-user.userdelete
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/get
      name: user-get
      description: REST surface for user-get.
      operations:
      - method: POST
        name: userget
        description: Get a user info on Zoom via user ID
        call: zoom-user.userget
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/getbyemail
      name: user-getbyemail
      description: REST surface for user-getbyemail.
      operations:
      - method: POST
        name: usergetbyemail
        description: Get a user on Zoom via user email address and login type, return the user info.
        call: zoom-user.usergetbyemail
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/list
      name: user-list
      description: REST surface for user-list.
      operations:
      - method: POST
        name: userlist
        description: List all the users on Zoom
        call: zoom-user.userlist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/pending
      name: user-pending
      description: REST surface for user-pending.
      operations:
      - method: POST
        name: userpending
        description: List all the pending users on Zoom
        call: zoom-user.userpending
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/permanentdelete
      name: user-permanentdelete
      description: REST surface for user-permanentdelete.
      operations:
      - method: POST
        name: userpermanentdelete
        description: Delete a user from Zoom system permanently.
        call: zoom-user.userpermanentdelete
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/revoketoken
      name: user-revoketoken
      description: REST surface for user-revoketoken.
      operations:
      - method: POST
        name: userrevoketoken
        description: Revoke a user's SSO token.
        call: zoom-user.userrevoketoken
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/scheduleforhost/list
      name: user-scheduleforhost-list
      description: REST surface for user-scheduleforhost-list.
      operations:
      - method: POST
        name: userscheduleforhostlist
        description: List assigned schedule privilege for host users.
        call: zoom-user.userscheduleforhostlist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/ssocreate
      name: user-ssocreate
      description: REST surface for user-ssocreate.
      operations:
      - method: POST
        name: userssocreate
        description: Create a SSO user on Zoom, return the created user ID.
        call: zoom-user.userssocreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/update
      name: user-update
      description: REST surface for user-update.
      operations:
      - method: POST
        name: userupdate
        description: Update user info on Zoom via user ID.
        call: zoom-user.userupdate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/updatepassword
      name: user-updatepassword
      description: REST surface for user-updatepassword.
      operations:
      - method: POST
        name: userupdatepassword
        description: Upload and update user's profile picture on Zoom via user ID.
        call: zoom-user.userupdatepassword
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: zoom-user-mcp
    port: 9090
    transport: http
    description: MCP adapter for Zoom REST API — User. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: activate-user-zoom-return-user
      description: Activate a user on Zoom, return the user ID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.useractivate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-user-s-assistant
      description: Delete a user's assistant.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userassistantdelete
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: set-user-s-assistant-which-can
      description: Set a user's assistant which can schedule meeting for him.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userassistantset
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-user-zoom-returns-created
      description: Create a user on Zoom, returns the created user ID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userautocreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: check-if-user-email-exists
      description: Check if the user email exists.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: zoom-user.usercheckemail
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: check-if-zpk-is-expired
      description: Check if the zpk is expired. The zpk is used to authenticate a user.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: zoom-user.usercheckzpk
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-user-zoom-returns-created-2
      description: Create a user on Zoom, returns the created user ID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.usercreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-user-zoom-returns-created-3
      description: Create a user on Zoom, returns the created user ID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.usercustcreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: deactivate-user-zoom-return-user
      description: Deactivate a user on Zoom, return the user ID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userdeactivate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-user-zoom-return-deleted
      description: Delete a user on Zoom, return the deleted user ID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userdelete
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-user-info-zoom-user
      description: Get a user info on Zoom via user ID
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: zoom-user.userget
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-user-zoom-user-email
      description: Get a user on Zoom via user email address and login type, return the user info.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: zoom-user.usergetbyemail
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-all-users-zoom
      description: List all the users on Zoom
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: zoom-user.userlist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-all-pending-users-zoom
      description: List all the pending users on Zoom
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: zoom-user.userpending
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-user-zoom-system-permanently
      description: Delete a user from Zoom system permanently.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userpermanentdelete
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: revoke-user-s-sso-token
      description: Revoke a user's SSO token.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userrevoketoken
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-assigned-schedule-privilege-host
      description: List assigned schedule privilege for host users.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: zoom-user.userscheduleforhostlist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-sso-user-zoom-return
      description: Create a SSO user on Zoom, return the created user ID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userssocreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-user-info-zoom-user
      description: Update user info on Zoom via user ID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userupdate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: upload-and-update-user-s-profile
      description: Upload and update user's profile picture on Zoom via user ID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: zoom-user.userupdatepassword
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.