Instagram · OpenAPI Overlay 1.0.0

API Evangelist enrichment overlay - Instagram Graph Comments Publishing API

5 actions 5 updates update extends instagram-publishing-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Instagram's API. It is a proposal applied on top of the contract, not a document Instagram publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-agentic-consequencex-reversal-operationx-reversibility-notex-apievangelist-enrichmentx-apievangelist-artifactsx-apievangelist-error-catalogx-apievangelist-error-envelope

Targets 5

$.info
$
$.paths.*.*.responses
$.paths['/{user_id}/media'].post
$.paths['/{user_id}/media_publish'].post

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist enrichment overlay - Instagram Graph Comments Publishing API
  version: 1.0.0
  x-generated: '2026-08-29'
  x-method: generated
  x-source: openapi/instagram-publishing-api-openapi.yml
  x-description: Captures API Evangelist enrichment on top of the original definition. Does not mutate
    the original; apply with an Overlay 1.0.0 processor.
extends: instagram-publishing-api-openapi.yml
actions:
- target: $.info
  description: Record the enrichment provenance and the version drift against the live Graph API.
  update:
    x-apievangelist-enrichment:
      repo: https://github.com/api-evangelist/instagram
      generated: '2026-08-29'
      spec-graph-api-version: '21.0'
      live-graph-api-version: v26.0
      live-version-released: '2026-07-29'
      drift-note: This definition describes Graph API v21.0; live is v26.0. Meta silently redirects expired-version
        calls to the next oldest usable version.
- target: $
  description: Attach the repo artifacts that carry the runtime semantics this definition does not express.
  update:
    x-apievangelist-artifacts:
      authentication: authentication/instagram-authentication.yml
      scopes: scopes/instagram-scopes.yml
      conventions: conventions/instagram-conventions.yml
      errors: errors/instagram-problem-types.yml
      rate-limits: rate-limits/instagram-rate-limits.yml
      lifecycle: lifecycle/instagram-lifecycle.yml
      webhooks: asyncapi/instagram-webhooks.yml
      data-model: data-model/instagram-data-model.yml
      conformance: conformance/instagram-conformance.yml
      packages: packages/instagram-packages.yml
      sandbox: sandbox/instagram-sandbox.yml
      agentic-access: agentic-access/instagram-agentic-access.yml
- target: $.paths.*.*.responses
  description: Note that Meta error responses are not described in this contract; the catalog is docs-derived.
  update:
    x-apievangelist-error-catalog: errors/instagram-problem-types.yml
    x-apievangelist-error-envelope: error.{message,type,code,error_subcode,error_user_title,error_user_msg,fbtrace_id}
      - not RFC 9457
- target: $.paths['/{user_id}/media'].post
  description: Reversibility annotation for createMediaContainer.
  update:
    x-agentic-consequence: write
    x-reversal-operation: abandon - container expires after 24 hours
    x-reversibility-note: stated window
- target: $.paths['/{user_id}/media_publish'].post
  description: Reversibility annotation for publishMedia.
  update:
    x-agentic-consequence: write
    x-reversal-operation: deleteMedia (destructive)
    x-reversibility-note: one-way door