bldinit Instagram Rest API

The instagram-rest API from bldinit — 14 operation(s) for instagram-rest.

GitHub OpenAPI

Operations 16

GET /api/v1/instagram/{ig_user_id} Instagram Business 계정 프로필 #
GET /api/v1/instagram/{ig_user_id}/media 내 미디어 list #
POST /api/v1/instagram/{ig_user_id}/media 미디어 container 생성 (publishing 1단계) #
POST /api/v1/instagram/{ig_user_id}/media_publish Container publish (★ irreversible — public 노출) #
GET /api/v1/instagram/{ig_media_id} 미디어 detail #
GET /api/v1/instagram/{ig_media_id}/comments 미디어 댓글 list #
POST /api/v1/instagram/{ig_comment_id}/replies 댓글에 답글 작성 (★ irreversible) #
GET /api/v1/instagram/{ig_media_id}/insights 미디어 인사이트 (engagement / impressions / reach) #
GET /api/v1/instagram/{ig_user_id}/insights 계정 인사이트 (audience / follower demographics) #
GET /api/v1/instagram/{ig_user_id}/content_publishing_limit 콘텐츠 발행 한도 조회 (24h 잔여) #
POST /api/v1/instagram/{ig_user_id}/media/reel 릴스 container 생성 (발행 전) #
POST /api/v1/instagram/{ig_user_id}/media/story 스토리 container 생성 (발행 전) #
DELETE /api/v1/instagram/{ig_comment_id} 댓글 영구 삭제 (★ irreversible) #
POST /api/v1/instagram/{ig_comment_id} 댓글 숨김/숨김 해제 (토글) #

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-instagram-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-instagram-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Instagram Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: instagram-rest
paths:
  /api/v1/instagram/{ig_user_id}:
    get:
      tags:
      - instagram-rest
      summary: Instagram Business 계정 프로필
      description: '``ig_user_id`` (Instagram Business Account ID) 의 프로필 metadata —

        username / name / followers_count / media_count / biography 등.


        Native pass-through.'
      operationId: instagram_get_profile
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - 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/instagram/{ig_user_id}/media:
    get:
      tags:
      - instagram-rest
      summary: 내 미디어 list
      description: 'Instagram Business 계정의 게시된 미디어 list (image / video / carousel).


        Pagination: ``after`` cursor.


        Native pass-through.'
      operationId: instagram_list_media
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - 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)
    post:
      tags:
      - instagram-rest
      summary: 미디어 container 생성 (publishing 1단계)
      description: '**Publishing 2-step 의 1단계** — 게시될 미디어의 container 생성.

        container_id 발급 후 ``instagram_publish_container`` 로 실제 publish.


        ``image_url`` (single image) 또는 ``video_url`` (video). 외부 URL =

        Meta 가 fetch (URL 은 publicly accessible 해야 함).


        Carousel (multiple images) = 별도 child container 흐름 (Phase 2 trigger).


        Recoverable — container 는 staged 상태 (24h 이내 publish 안 하면

        자동 expire). 자체로는 외부 노출 X.


        Native pass-through.'
      operationId: instagram_create_media_container
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User 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)
  /api/v1/instagram/{ig_user_id}/media_publish:
    post:
      tags:
      - instagram-rest
      summary: Container publish (★ irreversible — public 노출)
      description: '**Publishing 2-step 의 2단계** — ``creation_id`` (container_id) 를 받아

        실제 게시. 이 시점에 followers + 공개 viewers 에게 노출.


        **Irreversible (ADR-028/030 Cat A — 외부 도달)**: 게시 후 followers

        피드 노출. mcpweave 가 미디어 삭제 가능하지만 노출 흔적 (캐시 / 인용 /

        screenshot) 회수 불가.


        Native pass-through.'
      operationId: instagram_publish_container
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User 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/instagram/{ig_media_id}:
    get:
      tags:
      - instagram-rest
      summary: 미디어 detail
      description: 특정 게시물의 metadata. Native pass-through.
      operationId: instagram_get_media
      parameters:
      - name: ig_media_id
        in: path
        required: true
        schema:
          type: string
          title: Ig Media Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - 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/instagram/{ig_media_id}/comments:
    get:
      tags:
      - instagram-rest
      summary: 미디어 댓글 list
      description: '``ig_media_id`` 의 top-level 댓글 list. Pagination ``after`` cursor.


        Native pass-through.'
      operationId: instagram_list_comments
      parameters:
      - name: ig_media_id
        in: path
        required: true
        schema:
          type: string
          title: Ig Media Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - 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/instagram/{ig_comment_id}/replies:
    post:
      tags:
      - instagram-rest
      summary: 댓글에 답글 작성 (★ irreversible)
      description: '기존 댓글 (``ig_comment_id``) 에 답글 작성. post owner + viewers 에게

        공개 노출.


        **Irreversible (ADR-028/030 Cat A — 외부 도달)**.


        Native pass-through.'
      operationId: instagram_reply_comment
      parameters:
      - name: ig_comment_id
        in: path
        required: true
        schema:
          type: string
          title: Ig Comment 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/instagram/{ig_media_id}/insights:
    get:
      tags:
      - instagram-rest
      summary: 미디어 인사이트 (engagement / impressions / reach)
      description: '미디어 별 metrics. ``metric`` 은 comma-separated.


        Common metrics: ``engagement,impressions,reach,saved,video_views``.

        media_type 별 사용 가능 metric 다름 — Meta docs 참조.


        Native pass-through.'
      operationId: instagram_get_media_insights
      parameters:
      - name: ig_media_id
        in: path
        required: true
        schema:
          type: string
          title: Ig Media Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: metric
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Metric
      - 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/instagram/{ig_user_id}/insights:
    get:
      tags:
      - instagram-rest
      summary: 계정 인사이트 (audience / follower demographics)
      description: '계정 단위 metrics. ``metric`` + ``period`` (day / week / days_28 /

        lifetime). audience metric 은 ``period=lifetime`` + ``metric_type=total_value``.


        Common metrics:

        - ``follower_count`` (period=day) — 팔로워수 시간별

        - ``audience_city`` / ``audience_country`` / ``audience_gender_age`` (lifetime)

        - ``impressions`` / ``reach`` / ``profile_views`` (day/week/days_28)


        Native pass-through.'
      operationId: instagram_get_account_insights
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: metric
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Metric
      - name: period
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Period
      - name: metric_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Metric Type
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Since
      - name: until
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Until
      - 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/instagram/{ig_user_id}/content_publishing_limit:
    get:
      tags:
      - instagram-rest
      summary: 콘텐츠 발행 한도 조회 (24h 잔여)
      description: 'IG Business 계정의 24시간 콘텐츠 발행 한도 조회.

        ``quota_usage`` (사용량) + ``config`` (``quota_total`` / ``quota_duration`` 초) 반환.

        발행 전 잔여 한도 확인 용도 — 초과 시 Meta 가 발행 거부(오류).


        **응답 shape** (Graph API content_publishing_limit):

        ``data[0].config.quota_total`` (기본 ~50/24h),

        ``data[0].config.quota_duration`` (86400초),

        ``data[0].quota_usage`` (현재 사용량).


        Native pass-through.'
      operationId: instagram_get_publishing_limit
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - 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/instagram/{ig_user_id}/media/carousel_item:
    post:
      tags:
      - instagram-rest
      summary: 캐러셀 child container 생성 (1단계)
      description: '캐러셀 게시물의 **개별 슬라이드 container** 생성. ``is_carousel_item=true`` 필수.

        ``image_url`` (이미지) 또는 ``video_url`` (동영상) 중 하나 제공.

        반환된 ``id`` 를 ``instagram_create_carousel_container`` 의 ``children`` 에 사용.


        Recoverable — staged container (24h auto-expire, 외부 노출 X).


        **경로 매핑**: 실제 Graph API endpoint = ``POST /{ig-user-id}/media`` 에

        ``is_carousel_item=true`` body param 추가. mcpweave 경로는 명시적으로 분리.


        Native pass-through.'
      operationId: instagram_create_carousel_item
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User 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)
  /api/v1/instagram/{ig_user_id}/media/carousel:
    post:
      tags:
      - instagram-rest
      summary: 캐러셀 container 생성 (2단계, 발행 전)
      description: '**캐러셀 발행 흐름의 2단계** — child container ID 목록을 묶어 carousel container 생성.

        생성 후 ``instagram_publish_container`` (creation_id=carousel container ID) 로 발행.


        ``children``: child container ID comma-separated 문자열 (예: ``"id1,id2,id3"``).

        **Meta Graph API 명세**: 2~10개 child container ID (comma-separated string 형식).


        Recoverable — staged container (24h auto-expire, 발행 전 외부 노출 X).


        **경로 매핑**: 실제 Graph API endpoint = ``POST /{ig-user-id}/media`` 에

        ``media_type=CAROUSEL`` + ``children`` 추가. mcpweave 경로 명시적 분리.


        Native pass-through.'
      operationId: instagram_create_carousel_container
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User 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)
  /api/v1/instagram/{ig_user_id}/media/reel:
    post:
      tags:
      - instagram-rest
      summary: 릴스 container 생성 (발행 전)
      description: 'Instagram Reels container 생성. 생성 후 ``instagram_publish_container``

        (creation_id=reel container ID) 로 발행.


        ``video_url`` 은 publicly accessible MP4/MOV URL. Meta 가 URL fetch 후 처리

        (인코딩 비동기 — 완료 전 publish 시 ``MEDIA_NOT_READY`` 오류). 발행 전

        ``GET /{container-id}?fields=status_code`` 로 ``FINISHED`` 확인 권장.


        **``instagram_content_publish`` 스코프가 REELS 생성·발행 모두 커버** (Graph API

        content_publishing_limit 공식 문서 확인 — ADR-038 Phase 2 Amendment 2026-06-10).


        Recoverable — staged container (24h auto-expire, 외부 노출 X).


        Native pass-through.'
      operationId: instagram_create_reel
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User 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)
  /api/v1/instagram/{ig_user_id}/media/story:
    post:
      tags:
      - instagram-rest
      summary: 스토리 container 생성 (발행 전)
      description: 'Instagram Stories container 생성. 생성 후 ``instagram_publish_container``

        (creation_id=story container ID) 로 발행.


        ``image_url`` 또는 ``video_url`` 중 하나 필수. 비율 9:16 권장.

        스토리는 24h 후 자동 만료 (Instagram 정책 — 삭제 없이 소멸).


        **``instagram_content_publish`` 스코프가 STORIES 생성·발행 모두 커버** (Graph API

        공식 문서 확인 — ADR-038 Phase 2 Amendment 2026-06-10).


        Recoverable — staged container (24h auto-expire, 외부 노출 X).


        Native pass-through.'
      operationId: instagram_create_story
      parameters:
      - name: ig_user_id
        in: path
        required: true
        schema:
          type: string
          title: Ig User 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)
  /api/v1/instagram/{ig_comment_id}:
    delete:
      tags:
      - instagram-rest
      summary: 댓글 영구 삭제 (★ irreversible)
      description: 'Instagram 댓글을 **영구 삭제**. 복구 API 없음 — 삭제 즉시 비가역.


        **Irreversible (ADR-028/030 Cat B — 영구 삭제)**: 댓글 + 하위 답글 전부 삭제.

        취소 불가.


        Native pass-through.'
      operationId: instagram_delete_comment
      parameters:
      - name: ig_comment_id
        in: path
        required: true
        schema:
          type: string
          title: Ig Comment 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)
    post:
      tags:
      - instagram-rest
      summary: 댓글 숨김/숨김 해제 (토글)
      description: 'Instagram 댓글을 숨기거나 숨김 해제. ``hide=true`` 로 숨김,

        ``hide=false`` 로 복구 가능 — **reversible**.


        댓글 작성자 본인에게는 댓글이 보이지만, 다른 사용자에게는 안 보임.


        Native pass-through.'
      operationId: instagram_hide_comment
      parameters:
      - name: ig_comment_id
        in: path
        required: true
        schema:
          type: string
          title: Ig Comment Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: hide
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Hide
      - 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)