Slack Users API — Conversations

naftiko: 1.0.0-alpha2
info:
  label: Slack Users API — Conversations
  description: 'Slack Users API — Conversations. 1 operations. Lead operation: Slack Get Users Conversations. Self-contained
    Naftiko capability covering one Slack business surface.'
  tags:
  - Slack
  - Conversations
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SLACK_API_KEY: SLACK_API_KEY
capability:
  consumes:
  - type: http
    namespace: users-conversations
    baseUri: ''
    description: Slack Users API — Conversations business capability. Self-contained, no shared references.
    resources:
    - name: users.conversations
      path: /users.conversations
      operations:
      - name: getusersconversations
        method: GET
        description: Slack Get Users Conversations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: query
          type: string
          description: 'Authentication token. Requires scope: `conversations:read`'
        - name: user
          in: query
          type: string
          description: Browse conversations by a specific user ID's membership. Non-public channels are restricted to those
            where the calling user shares membership.
        - name: types
          in: query
          type: string
          description: Mix and match channel types by providing a comma-separated list of any combination of `public_channel`,
            `private_channel`, `mpim`, `im`
        - name: exclude_archived
          in: query
          type: boolean
          description: Set to `true` to exclude archived channels from the list
        - name: limit
          in: query
          type: integer
          description: The maximum number of items to return. Fewer than the requested number of items may be returned, even
            if the end of the list hasn't been reached. Must be an int
        - name: cursor
          in: query
          type: string
          description: Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute
            returned by a previous request's `response_metadata`. Defaul
  exposes:
  - type: rest
    namespace: users-conversations-rest
    port: 8080
    description: REST adapter for Slack Users API — Conversations. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/users-conversations
      name: users-conversations
      description: REST surface for users.conversations.
      operations:
      - method: GET
        name: getusersconversations
        description: Slack Get Users Conversations
        call: users-conversations.getusersconversations
        with:
          token: rest.token
          user: rest.user
          types: rest.types
          exclude_archived: rest.exclude_archived
          limit: rest.limit
          cursor: rest.cursor
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: users-conversations-mcp
    port: 9090
    transport: http
    description: MCP adapter for Slack Users API — Conversations. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: slack-get-users-conversations
      description: Slack Get Users Conversations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: users-conversations.getusersconversations
      with:
        token: tools.token
        user: tools.user
        types: tools.types
        exclude_archived: tools.exclude_archived
        limit: tools.limit
        cursor: tools.cursor
      outputParameters:
      - type: object
        mapping: $.