Discord HTTP API (Preview) — Guilds

naftiko: 1.0.0-alpha2
info:
  label: Discord HTTP API (Preview) — Guilds
  description: 'Discord HTTP API (Preview) — Guilds. 77 operations. Lead operation: Guilds. Self-contained Naftiko capability
    covering one Discord business surface.'
  tags:
  - Discord
  - Guilds
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    DISCORD_API_KEY: DISCORD_API_KEY
capability:
  consumes:
  - type: http
    namespace: discord-guilds
    baseUri: https://discord.com/api/v10
    description: Discord HTTP API (Preview) — Guilds business capability. Self-contained, no shared references.
    resources:
    - name: guilds
      path: /guilds
      operations:
      - name: createguild
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-templates-code
      path: /guilds/templates/{code}
      operations:
      - name: getguildtemplate
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createguildfromtemplate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id
      path: /guilds/{guild_id}
      operations:
      - name: getguild
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: with_counts
          in: query
          type: boolean
      - name: deleteguild
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateguild
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-audit-logs
      path: /guilds/{guild_id}/audit-logs
      operations:
      - name: listguildauditlogentries
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: query
          type: string
        - name: target_id
          in: query
          type: string
        - name: action_type
          in: query
          type: integer
        - name: before
          in: query
          type: string
        - name: after
          in: query
          type: string
        - name: limit
          in: query
          type: integer
    - name: guilds-guild_id-auto-moderation-rules
      path: /guilds/{guild_id}/auto-moderation/rules
      operations:
      - name: listautomoderationrules
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createautomoderationrule
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-auto-moderation-rules-rule_id
      path: /guilds/{guild_id}/auto-moderation/rules/{rule_id}
      operations:
      - name: getautomoderationrule
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteautomoderationrule
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateautomoderationrule
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-bans
      path: /guilds/{guild_id}/bans
      operations:
      - name: listguildbans
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
        - name: before
          in: query
          type: string
        - name: after
          in: query
          type: string
    - name: guilds-guild_id-bans-user_id
      path: /guilds/{guild_id}/bans/{user_id}
      operations:
      - name: getguildban
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: banuserfromguild
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: unbanuserfromguild
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-bulk-ban
      path: /guilds/{guild_id}/bulk-ban
      operations:
      - name: bulkbanusersfromguild
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-channels
      path: /guilds/{guild_id}/channels
      operations:
      - name: listguildchannels
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createguildchannel
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: bulkupdateguildchannels
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-emojis
      path: /guilds/{guild_id}/emojis
      operations:
      - name: listguildemojis
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createguildemoji
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-emojis-emoji_id
      path: /guilds/{guild_id}/emojis/{emoji_id}
      operations:
      - name: getguildemoji
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteguildemoji
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateguildemoji
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-integrations
      path: /guilds/{guild_id}/integrations
      operations:
      - name: listguildintegrations
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-integrations-integration_id
      path: /guilds/{guild_id}/integrations/{integration_id}
      operations:
      - name: deleteguildintegration
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-invites
      path: /guilds/{guild_id}/invites
      operations:
      - name: listguildinvites
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-members
      path: /guilds/{guild_id}/members
      operations:
      - name: listguildmembers
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
        - name: after
          in: query
          type: integer
    - name: guilds-guild_id-members-@me
      path: /guilds/{guild_id}/members/@me
      operations:
      - name: updatemyguildmember
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-members-search
      path: /guilds/{guild_id}/members/search
      operations:
      - name: searchguildmembers
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: true
        - name: query
          in: query
          type: string
          required: true
    - name: guilds-guild_id-members-user_id
      path: /guilds/{guild_id}/members/{user_id}
      operations:
      - name: getguildmember
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: addguildmember
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteguildmember
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateguildmember
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-members-user_id-roles-role_id
      path: /guilds/{guild_id}/members/{user_id}/roles/{role_id}
      operations:
      - name: addguildmemberrole
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteguildmemberrole
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-mfa
      path: /guilds/{guild_id}/mfa
      operations:
      - name: setguildmfalevel
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-new-member-welcome
      path: /guilds/{guild_id}/new-member-welcome
      operations:
      - name: getguildnewmemberwelcome
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-onboarding
      path: /guilds/{guild_id}/onboarding
      operations:
      - name: getguildsonboarding
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: putguildsonboarding
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-preview
      path: /guilds/{guild_id}/preview
      operations:
      - name: getguildpreview
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-prune
      path: /guilds/{guild_id}/prune
      operations:
      - name: previewpruneguild
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: days
          in: query
          type: integer
        - name: include_roles
          in: query
          type: string
      - name: pruneguild
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-regions
      path: /guilds/{guild_id}/regions
      operations:
      - name: listguildvoiceregions
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-roles
      path: /guilds/{guild_id}/roles
      operations:
      - name: listguildroles
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createguildrole
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: bulkupdateguildroles
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-roles-role_id
      path: /guilds/{guild_id}/roles/{role_id}
      operations:
      - name: deleteguildrole
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateguildrole
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-scheduled-events
      path: /guilds/{guild_id}/scheduled-events
      operations:
      - name: listguildscheduledevents
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: with_user_count
          in: query
          type: boolean
      - name: createguildscheduledevent
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-scheduled-events-guild_scheduled_event_id
      path: /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}
      operations:
      - name: getguildscheduledevent
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: with_user_count
          in: query
          type: boolean
      - name: deleteguildscheduledevent
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateguildscheduledevent
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-scheduled-events-guild_scheduled_event_id-users
      path: /guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/users
      operations:
      - name: listguildscheduledeventusers
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: with_member
          in: query
          type: boolean
        - name: limit
          in: query
          type: integer
        - name: before
          in: query
          type: string
        - name: after
          in: query
          type: string
    - name: guilds-guild_id-stickers
      path: /guilds/{guild_id}/stickers
      operations:
      - name: listguildstickers
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createguildsticker
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-stickers-sticker_id
      path: /guilds/{guild_id}/stickers/{sticker_id}
      operations:
      - name: getguildsticker
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteguildsticker
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateguildsticker
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-templates
      path: /guilds/{guild_id}/templates
      operations:
      - name: listguildtemplates
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createguildtemplate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-templates-code
      path: /guilds/{guild_id}/templates/{code}
      operations:
      - name: syncguildtemplate
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteguildtemplate
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateguildtemplate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-threads-active
      path: /guilds/{guild_id}/threads/active
      operations:
      - name: getactiveguildthreads
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-vanity-url
      path: /guilds/{guild_id}/vanity-url
      operations:
      - name: getguildvanityurl
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-voice-states-@me
      path: /guilds/{guild_id}/voice-states/@me
      operations:
      - name: updateselfvoicestate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-voice-states-user_id
      path: /guilds/{guild_id}/voice-states/{user_id}
      operations:
      - name: updatevoicestate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-webhooks
      path: /guilds/{guild_id}/webhooks
      operations:
      - name: getguildwebhooks
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-welcome-screen
      path: /guilds/{guild_id}/welcome-screen
      operations:
      - name: getguildwelcomescreen
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateguildwelcomescreen
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-widget
      path: /guilds/{guild_id}/widget
      operations:
      - name: getguildwidgetsettings
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateguildwidgetsettings
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: guilds-guild_id-widget.json
      path: /guilds/{guild_id}/widget.json
      operations:
      - name: getguildwidget
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: guilds-guild_id-widget.png
      path: /guilds/{guild_id}/widget.png
      operations:
      - name: getguildwidgetpng
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: style
          in: query
          type: string
    authentication:
      type: bearer
      token: '{{env.DISCORD_API_KEY}}'
  exposes:
  - type: rest
    namespace: discord-guilds-rest
    port: 8080
    description: REST adapter for Discord HTTP API (Preview) — Guilds. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/guilds
      name: guilds
      description: REST surface for guilds.
      operations:
      - method: POST
        name: createguild
        description: createguild
        call: discord-guilds.createguild
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/guilds/templates/{code}
      name: guilds-templates-code
      description: REST surface for guilds-templates-code.
      operations:
      - method: GET
        name: getguildtemplate
        description: getguildtemplate
        call: discord-guilds.getguildtemplate
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createguildfromtemplate
        description: createguildfromtemplate
        call: discord-guilds.createguildfromtemplate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/guilds/{guild-id}
      name: guilds-guild-id
      description: REST surface for guilds-guild_id.
      operations:
      - method: GET
        name: getguild
        description: getguild
        call: discord-guilds.getguild
        with:
          with_counts: rest.with_counts
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteguild
        description: deleteguild
        call: discord-guilds.deleteguild
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateguild
        description: updateguild
        call: discord-guilds.updateguild
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/guilds/{guild-id}/audit-logs
      name: guilds-guild-id-audit-logs
      description: REST surface for guilds-guild_id-audit-logs.
      operations:
      - method: GET
        name: listguildauditlogentries
        description: listguildauditlogentries
        call: discord-guilds.listguildauditlogentries
        with:
          user_id: rest.user_id
          target_id: rest.target_id
          action_type: rest.action_type
          before: rest.before
          after: rest.after
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/guilds/{guild-id}/auto-moderation/rules
      name: guilds-guild-id-auto-moderation-rules
      description: REST surface for guilds-guild_id-auto-moderation-rules.
      operations:
      - method: GET
        name: listautomoderationrules
        description: listautomoderationrules
        call: discord-guilds.listautomoderationrules
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createautomoderationrule
        description: createautomoderationrule
        call: discord-guilds.createautomoderationrule
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/guilds/{guild-id}/auto-moderation/rules/{rule-id}
      name: guilds-guild-id-auto-moderation-rules-rule-id
      description: REST surface for guilds-guild_id-auto-moderation-rules-rule_id.
      operations:
      - method: GET
        name: getautomoderationrule
        description: getautomoderationrule
        call: discord-guilds.getautomoderationrule
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteautomoderationrule
        description: deleteautomoderationrule
        call: discord-guilds.deleteautomoderationrule
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateautomoderationrule
        description: updateautomoderationrule
        call: discord-guilds.updateautomoderationrule
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/guilds/{guild-id}/bans
      name: guilds-guild-id-bans
      description: REST surface for guilds-guild_id-bans.
      operations:
      - method: GET
        name: listguildbans
        description: listguildbans
        call: discord-guilds.listguildbans
        with:
          limit: rest.limit
          before: rest.before
          after: rest.after
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/guilds/{guild-id}/bans/{user-id}
      name: guilds-guild-id-bans-user-id
      description: REST surface for guilds-guild_id-bans-user_id.
      operations:
      - method: GET
        name: getguildban
        description: getguildban
        call: discord-guilds.getguildban
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: banuserfromguild
        description: banuserfromguild
        call: discord-guilds.banuserfromguild
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: unbanuserfromguild
        description: unbanuserfromguild
        call: discord-guilds.unbanuserfr

# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/discord/refs/heads/main/capabilities/discord-guilds.yaml