bldinit Discord Rest API

The discord-rest API from bldinit — 9 operation(s) for discord-rest.

GitHub OpenAPI

Operations 12

GET /api/v1/discord/channels/{channel_id}/messages 채널 메시지 history (Mode A) #
POST /api/v1/discord/channels/{channel_id}/messages 채널에 메시지 발송 (Mode A, ★ irreversible) #
GET /api/v1/discord/channels/{channel_id}/messages/{message_id} 메시지 detail (Mode A) #
PATCH /api/v1/discord/channels/{channel_id}/messages/{message_id} 메시지 수정 (Mode A) #
DELETE /api/v1/discord/channels/{channel_id}/messages/{message_id} 메시지 삭제 (Mode A, ★ irreversible) #
GET /api/v1/discord/channels/{channel_id} 채널 detail (Mode A) #
GET /api/v1/discord/users/@me/guilds Bot 이 가입한 guild (서버) list (Mode A) #
GET /api/v1/discord/guilds/{guild_id}/channels Guild (서버) 의 채널 list (Mode A) #
GET /api/v1/discord/guilds/{guild_id}/members Guild 멤버 list (Mode A) #
PUT /api/v1/discord/channels/{channel_id}/messages/{message_id}/reactions/{emoji}/@me 메시지에 이모지 reaction (Mode A) #
POST /api/v1/discord/users/@me/channels DM 채널 생성 (Mode A) #
POST /api/v1/discord/webhooks/{webhook_id}/{webhook_token} Webhook URL 로 메시지 발송 (Mode B, ★ irreversible) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-discord-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpweave-com-discord-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Discord Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: discord-rest
paths:
  /api/v1/discord/channels/{channel_id}/messages:
    get:
      tags:
      - discord-rest
      summary: 채널 메시지 history (Mode A)
      description: '``channel_id`` 의 최근 메시지 list. ``limit`` (default 50, max 100).


        Pagination via ``before`` / ``after`` / ``around`` (snowflake message id).


        Native pass-through.'
      operationId: discord_list_messages
      parameters:
      - name: channel_id
        in: path
        required: true
        schema:
          type: string
          title: Channel Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Limit
      - name: before
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Before
      - name: after
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: After
      - name: around
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Around
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    post:
      tags:
      - discord-rest
      summary: 채널에 메시지 발송 (Mode A, ★ irreversible)
      description: '``channel_id`` 채널에 메시지 발송. ``content`` (text) 또는 ``embeds``

        (rich embed array).


        **Irreversible (ADR-028/030 Cat A — 외부 도달)**: 채널 멤버 모두에게 즉시

        알림 도달, mcpweave 측 회수 불가. ``discord_delete_message`` 로 메시지

        자체 삭제 가능하지만 알림은 회수 불가.


        ``embeds`` 는 Discord 의 강력한 rich content (제목/색상/thumbnail/fields/footer).

        사용자 (LLM agent) 가 직접 작성.


        Native pass-through.'
      operationId: discord_send_message
      parameters:
      - name: channel_id
        in: path
        required: true
        schema:
          type: string
          title: Channel Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/discord/channels/{channel_id}/messages/{message_id}:
    get:
      tags:
      - discord-rest
      summary: 메시지 detail (Mode A)
      description: 특정 메시지 detail (content / embeds / reactions / author / timestamp). Native pass-through.
      operationId: discord_get_message
      parameters:
      - name: channel_id
        in: path
        required: true
        schema:
          type: string
          title: Channel Id
      - name: message_id
        in: path
        required: true
        schema:
          type: string
          title: Message Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    patch:
      tags:
      - discord-rest
      summary: 메시지 수정 (Mode A)
      description: 'bot 이 발송한 메시지의 content / embeds 수정.


        Recoverable — 다시 edit 으로 이전 텍스트 복원 가능. irreversible 아님.


        Native pass-through.'
      operationId: discord_edit_message
      parameters:
      - name: channel_id
        in: path
        required: true
        schema:
          type: string
          title: Channel Id
      - name: message_id
        in: path
        required: true
        schema:
          type: string
          title: Message Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    delete:
      tags:
      - discord-rest
      summary: 메시지 삭제 (Mode A, ★ irreversible)
      description: 'bot 이 발송한 메시지 (또는 bot 이 ``Manage Messages`` 권한 가진 채널의

        다른 메시지) 삭제.


        **Irreversible (ADR-028/030 Cat B — 영구 삭제)**: API 삭제 후 복구 불가

        (Discord 측 message archive X). client 가 첫 호출 시 ``confirmation_token``

        발급, 재호출 시 검증.


        응답 = 204 No Content (body 없음).


        Native pass-through.'
      operationId: discord_delete_message
      parameters:
      - name: channel_id
        in: path
        required: true
        schema:
          type: string
          title: Channel Id
      - name: message_id
        in: path
        required: true
        schema:
          type: string
          title: Message Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/discord/channels/{channel_id}:
    get:
      tags:
      - discord-rest
      summary: 채널 detail (Mode A)
      description: 채널 metadata (name / topic / type / parent_id 등). Native pass-through.
      operationId: discord_get_channel
      parameters:
      - name: channel_id
        in: path
        required: true
        schema:
          type: string
          title: Channel Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/discord/users/@me/guilds:
    get:
      tags:
      - discord-rest
      summary: Bot 이 가입한 guild (서버) list (Mode A)
      description: 'Bot 사용자가 멤버인 guild list. ``id`` (snowflake) + ``name`` + ``icon`` +

        ``permissions`` 반환. ``discord_list_channels`` / ``discord_list_guild_members``

        의 ``guild_id`` 발견용. ``discord_get_connection_info`` 의 cached

        ``provider_metadata.guilds`` 와 동일 source.


        Pagination: ``after`` / ``before`` (snowflake). Native pass-through.


        > Discord docs: discord.com/developers/docs/resources/user#get-current-user-guilds'
      operationId: discord_list_guilds
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Limit
      - name: before
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Before
      - name: after
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: After
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/discord/guilds/{guild_id}/channels:
    get:
      tags:
      - discord-rest
      summary: Guild (서버) 의 채널 list (Mode A)
      description: Guild 내 모든 채널 (text / voice / category / forum / etc.). bot 가 가입한 guild 만. ``guild_id`` 는 ``discord_list_guilds`` 또는 ``discord_get_connection_info`` 의 cached metadata 에서 발견. Native pass-through.
      operationId: discord_list_channels
      parameters:
      - name: guild_id
        in: path
        required: true
        schema:
          type: string
          title: Guild Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/discord/guilds/{guild_id}/members:
    get:
      tags:
      - discord-rest
      summary: Guild 멤버 list (Mode A)
      description: 'Guild 의 멤버 list. ``limit`` (default 1, max 1000), ``after`` (snowflake

        user id) pagination.


        **Privileged Intent**: ``GUILD_MEMBERS`` intent 필요 — bot config 에서

        활성화 + Discord 측 verification (100+ guilds 시).


        Native pass-through.'
      operationId: discord_list_guild_members
      parameters:
      - name: guild_id
        in: path
        required: true
        schema:
          type: string
          title: Guild Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Limit
      - name: after
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: After
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/discord/channels/{channel_id}/messages/{message_id}/reactions/{emoji}/@me:
    put:
      tags:
      - discord-rest
      summary: 메시지에 이모지 reaction (Mode A)
      description: 'bot 이 메시지에 emoji reaction 추가. ``emoji`` 는 URL-encode 된 unicode

        (e.g. ``%F0%9F%91%8D`` = 👍) 또는 custom emoji ``name:id``.


        Recoverable — DELETE 같은 endpoint 로 제거 가능.


        응답 = 204 No Content.


        Native pass-through.'
      operationId: discord_add_reaction
      parameters:
      - name: channel_id
        in: path
        required: true
        schema:
          type: string
          title: Channel Id
      - name: message_id
        in: path
        required: true
        schema:
          type: string
          title: Message Id
      - name: emoji
        in: path
        required: true
        schema:
          type: string
          title: Emoji
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/discord/users/@me/channels:
    post:
      tags:
      - discord-rest
      summary: DM 채널 생성 (Mode A)
      description: '``recipient_id`` (user snowflake) 와의 DM 채널 생성. 이미 존재하면

        그대로 반환 (idempotent).


        DM 채널 생성 자체는 메시지 발송 X — recoverable.


        Native pass-through.'
      operationId: discord_create_dm
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/discord/webhooks/{webhook_id}/{webhook_token}:
    post:
      tags:
      - discord-rest
      summary: Webhook URL 로 메시지 발송 (Mode B, ★ irreversible)
      description: '**Mode B (Webhook URL)**: Discord 채널의 webhook 으로 메시지 발송.

        ``Authorization`` header 없음 — webhook URL 자체가 인증.


        ``content`` 또는 ``embeds``. ``username`` / ``avatar_url`` 로 발송자

        표시 override 가능 (bot 무관).


        **Irreversible (ADR-028/030 Cat A — 외부 도달)**: webhook 채널 멤버 모두

        알림 도달.


        ``webhook_id`` / ``webhook_token`` 은 BYOC 등록 시 mcpweave 가 저장한

        webhook URL 에서 자동 로드 (Discord provider 의 make_request 가 access

        token 의 URL 형태를 인식하여 endpoint 대신 사용). Agent 는

        ``connection_id`` + body 만 제공.


        Native pass-through.'
      operationId: discord_send_webhook
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)