Reanudar una publicación preparada de Instagram

Consulta y continúa una operación creada con preparaciones listas.

Tool IDinstagram.publicacion.reanudar
Nombre MCPinstagram__publicacion__reanudar
Conectorinstagram
Planoaction
Scope (permiso)instagram:publish
Authconnection_credentials
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=false, destructive=true, idempotent=true, openWorld=true

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute_write de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

Exige instagram:media e instagram:publish en el emisor y la conexión. Revalida el mismo actor, conexión, permisos, archivos y retención. Sólo permite reanudar mientras siga vigente la entrega: como máximo una hora desde la creación de la operación, o menos si algún archivo vence antes. Después no se renueva ni se reanuda esa operación. Conserva su operacionId y revisa el resultado en Instagram; publicacion.verificar sirve sólo si ya conoces el ID de la publicación. Un resultado incierto no autoriza otro envío ni otra clave. Exige una Idempotency-Key UUID v4 estable para esta solicitud; no repite un envío cuyo resultado es incierto, ni crea otra intención. Un contenedor FINISHED no acredita publicación. No admite operaciones creadas con URLs ni perfiles Story.

Entrada

CampoTipoRequeridoDescripción
operacionIdstringsíIdentificador de la operación original devuelto al publicar. Se conserva al reanudar; no es el identificador de la nueva solicitud.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "operacionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240,
      "description": "Identificador de la operación original devuelto al publicar. Se conserva al reanudar; no es el identificador de la nueva solicitud."
    }
  },
  "required": [
    "operacionId"
  ],
  "additionalProperties": false
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/instagram.publicacion.reanudar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Idempotency-Key: 9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743" \
  -H "Content-Type: application/json" \
  -d '{"input":{"operacionId":"req_ejemplo"}}'
MCP · meta-tool execute_write
{
  "tool": "instagram.publicacion.reanudar",
  "params": {
    "operacionId": "req_ejemplo"
  },
  "connectionId": "conn_9tKfR2mQx4Vb",
  "idempotencyKey": "9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743"
}

Clave de idempotencia obligatoria. Sin ella la llamada responde idempotency_key_missing. Genera un UUID v4 nuevo por operación y envíalo en Idempotency-Key (REST) o en idempotencyKey (MCP). Repite la misma clave solo al reintentar esa operación.

Salida esperada (200):

{
  "data": {
    "estado": "pendiente",
    "publicacionId": null,
    "url": null,
    "operacionId": "req_ejemplo",
    "puedeReintentar": false
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "instagram.publicacion.reanudar",
    "plane": "action",
    "latency_ms": 7410,
    "audit_status": "recorded"
  }
}

Salida

CampoTipoRequeridoDescripción
estado"publicado" · "pendiente" · "resultado_desconocido" · "no_publicado"sípublicado exige una lectura independiente de la misma cuenta; pendiente conserva un identificador aceptado; resultado_desconocido requiere revisión; no_publicado indica rechazo confirmado.
publicacionIdstringnullsí
urlstringnullsí
operacionIdstringsíIdentificador de la operación de publicación; se conserva al reanudar.
puedeReintentarbooleanosíNo crees otra clave para repetir el efecto. Una repetición de transporte conserva la misma clave.
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "estado": {
      "type": "string",
      "enum": [
        "publicado",
        "pendiente",
        "resultado_desconocido",
        "no_publicado"
      ],
      "description": "publicado exige una lectura independiente de la misma cuenta; pendiente conserva un identificador aceptado; resultado_desconocido requiere revisión; no_publicado indica rechazo confirmado."
    },
    "publicacionId": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 240
        },
        {
          "type": "null"
        }
      ],
      "description": "Identificador confirmado por el proveedor; null cuando no se conoce. Tener un ID no acredita publicación visible."
    },
    "url": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2048,
          "format": "uri"
        },
        {
          "type": "null"
        }
      ],
      "description": "Enlace público de la publicación confirmada, o null."
    },
    "operacionId": {
      "type": "string",
      "description": "Identificador de la operación de publicación; se conserva al reanudar."
    },
    "puedeReintentar": {
      "type": "boolean",
      "const": false,
      "description": "No crees otra clave para repetir el efecto. Una repetición de transporte conserva la misma clave."
    }
  },
  "required": [
    "estado",
    "publicacionId",
    "url",
    "operacionId",
    "puedeReintentar"
  ],
  "additionalProperties": false
}

Errores de esta tool

CódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
connection_credential_required428noCrea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior.
connection_busy409síEspera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.
upstream_error502síReintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.
timeout504síReintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.
connector_onboarding_required428noLee el mensaje: dice qué falta. Se completa en el portal de ese sistema, no en Emisso, y después la llamada funciona sin cambios.
connection_scope_not_enabled403noPide a un owner/admin que habilite el scope en /connections para esa conexión, o usa otra que ya lo tenga activo. Cambiar la credencial del actor no resuelve este error.
rate_limited429síEspera y reintenta con backoff exponencial.
upstream_unexpected_response502noNo reintentes: la respuesta es determinista. Repórtalo con el request_id para que actualicemos el conector.
idempotency_key_missing400noGenera un UUID v4, envíalo como Idempotency-Key y reutilízalo solo para reintentos de esta misma operación.
idempotency_in_progress409síEspera unos segundos y reintenta con la MISMA clave. Generar una nueva para la misma operación es lo que duplica el efecto.
idempotency_conflict409noGenera una clave nueva para una operación nueva; reutiliza la clave solo para reintentar la misma.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

En esta página