Slack Admin API — Users

naftiko: 1.0.0-alpha2
info:
  label: Slack Admin API — Users
  description: 'Slack Admin API — Users. 10 operations. Lead operation: Slack Post Admin Users Assign. Self-contained Naftiko
    capability covering one Slack business surface.'
  tags:
  - Slack
  - Users
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SLACK_API_KEY: SLACK_API_KEY
capability:
  consumes:
  - type: http
    namespace: admin-users
    baseUri: ''
    description: Slack Admin API — Users business capability. Self-contained, no shared references.
    resources:
    - name: admin.users.assign
      path: /admin.users.assign
      operations:
      - name: postadminusersassign
        method: POST
        description: Slack Post Admin Users Assign
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:write`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: admin.users.invite
      path: /admin.users.invite
      operations:
      - name: postadminusersinvite
        method: POST
        description: Slack Post Admin Users Invite
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:write`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: admin.users.list
      path: /admin.users.list
      operations:
      - name: getadminuserslist
        method: GET
        description: Slack Get Admin Users List
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:read`'
          required: true
        - name: team_id
          in: query
          type: string
          description: The ID (`T1234`) of the workspace.
          required: true
        - name: cursor
          in: query
          type: string
          description: Set `cursor` to `next_cursor` returned by the previous call to list items in the next page.
        - name: limit
          in: query
          type: integer
          description: Limit for how many users to be retrieved per page
    - name: admin.users.remove
      path: /admin.users.remove
      operations:
      - name: postadminusersremove
        method: POST
        description: Slack Post Admin Users Remove
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:write`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: admin.users.session.invalidate
      path: /admin.users.session.invalidate
      operations:
      - name: postadminuserssessioninvalidate
        method: POST
        description: Slack Post Admin Users Session Invalidate
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:write`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: admin.users.session.reset
      path: /admin.users.session.reset
      operations:
      - name: postadminuserssessionreset
        method: POST
        description: Slack Post Admin Users Session Reset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:write`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: admin.users.setAdmin
      path: /admin.users.setAdmin
      operations:
      - name: postadminuserssetadmin
        method: POST
        description: Slack Post Admin Users Setadmin
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:write`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: admin.users.setExpiration
      path: /admin.users.setExpiration
      operations:
      - name: postadminuserssetexpiration
        method: POST
        description: Slack Post Admin Users Setexpiration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:write`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: admin.users.setOwner
      path: /admin.users.setOwner
      operations:
      - name: postadminuserssetowner
        method: POST
        description: Slack Post Admin Users Setowner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:write`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: admin.users.setRegular
      path: /admin.users.setRegular
      operations:
      - name: postadminuserssetregular
        method: POST
        description: Slack Post Admin Users Setregular
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: header
          type: string
          description: 'Authentication token. Requires scope: `admin.users:write`'
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: admin-users-rest
    port: 8080
    description: REST adapter for Slack Admin API — Users. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/admin-users-assign
      name: admin-users-assign
      description: REST surface for admin.users.assign.
      operations:
      - method: POST
        name: postadminusersassign
        description: Slack Post Admin Users Assign
        call: admin-users.postadminusersassign
        with:
          token: rest.token
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin-users-invite
      name: admin-users-invite
      description: REST surface for admin.users.invite.
      operations:
      - method: POST
        name: postadminusersinvite
        description: Slack Post Admin Users Invite
        call: admin-users.postadminusersinvite
        with:
          token: rest.token
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin-users-list
      name: admin-users-list
      description: REST surface for admin.users.list.
      operations:
      - method: GET
        name: getadminuserslist
        description: Slack Get Admin Users List
        call: admin-users.getadminuserslist
        with:
          token: rest.token
          team_id: rest.team_id
          cursor: rest.cursor
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin-users-remove
      name: admin-users-remove
      description: REST surface for admin.users.remove.
      operations:
      - method: POST
        name: postadminusersremove
        description: Slack Post Admin Users Remove
        call: admin-users.postadminusersremove
        with:
          token: rest.token
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin-users-session-invalidate
      name: admin-users-session-invalidate
      description: REST surface for admin.users.session.invalidate.
      operations:
      - method: POST
        name: postadminuserssessioninvalidate
        description: Slack Post Admin Users Session Invalidate
        call: admin-users.postadminuserssessioninvalidate
        with:
          token: rest.token
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin-users-session-reset
      name: admin-users-session-reset
      description: REST surface for admin.users.session.reset.
      operations:
      - method: POST
        name: postadminuserssessionreset
        description: Slack Post Admin Users Session Reset
        call: admin-users.postadminuserssessionreset
        with:
          token: rest.token
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin-users-setadmin
      name: admin-users-setadmin
      description: REST surface for admin.users.setAdmin.
      operations:
      - method: POST
        name: postadminuserssetadmin
        description: Slack Post Admin Users Setadmin
        call: admin-users.postadminuserssetadmin
        with:
          token: rest.token
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin-users-setexpiration
      name: admin-users-setexpiration
      description: REST surface for admin.users.setExpiration.
      operations:
      - method: POST
        name: postadminuserssetexpiration
        description: Slack Post Admin Users Setexpiration
        call: admin-users.postadminuserssetexpiration
        with:
          token: rest.token
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin-users-setowner
      name: admin-users-setowner
      description: REST surface for admin.users.setOwner.
      operations:
      - method: POST
        name: postadminuserssetowner
        description: Slack Post Admin Users Setowner
        call: admin-users.postadminuserssetowner
        with:
          token: rest.token
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin-users-setregular
      name: admin-users-setregular
      description: REST surface for admin.users.setRegular.
      operations:
      - method: POST
        name: postadminuserssetregular
        description: Slack Post Admin Users Setregular
        call: admin-users.postadminuserssetregular
        with:
          token: rest.token
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: admin-users-mcp
    port: 9090
    transport: http
    description: MCP adapter for Slack Admin API — Users. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: slack-post-admin-users-assign
      description: Slack Post Admin Users Assign
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-users.postadminusersassign
      with:
        token: tools.token
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: slack-post-admin-users-invite
      description: Slack Post Admin Users Invite
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-users.postadminusersinvite
      with:
        token: tools.token
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: slack-get-admin-users-list
      description: Slack Get Admin Users List
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-users.getadminuserslist
      with:
        token: tools.token
        team_id: tools.team_id
        cursor: tools.cursor
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: slack-post-admin-users-remove
      description: Slack Post Admin Users Remove
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-users.postadminusersremove
      with:
        token: tools.token
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: slack-post-admin-users-session
      description: Slack Post Admin Users Session Invalidate
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: admin-users.postadminuserssessioninvalidate
      with:
        token: tools.token
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: slack-post-admin-users-session-2
      description: Slack Post Admin Users Session Reset
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-users.postadminuserssessionreset
      with:
        token: tools.token
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: slack-post-admin-users-setadmin
      description: Slack Post Admin Users Setadmin
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-users.postadminuserssetadmin
      with:
        token: tools.token
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: slack-post-admin-users-setexpiration
      description: Slack Post Admin Users Setexpiration
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-users.postadminuserssetexpiration
      with:
        token: tools.token
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: slack-post-admin-users-setowner
      description: Slack Post Admin Users Setowner
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-users.postadminuserssetowner
      with:
        token: tools.token
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: slack-post-admin-users-setregular
      description: Slack Post Admin Users Setregular
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-users.postadminuserssetregular
      with:
        token: tools.token
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.