Reanudar una publicación preparada de Instagram
Consulta y continúa una operación creada con preparaciones listas.
| Tool ID | instagram.publicacion.reanudar |
| Nombre MCP | instagram__publicacion__reanudar |
| Conector | instagram |
| Plano | action |
| Scope (permiso) | instagram:publish |
| Auth | connection_credentials |
| Versión | 1 |
| Sensible | sí |
| Deprecado | no |
| Comportamiento | readOnly=false, destructive=true, idempotent=true, openWorld=true |
Requiere conexión. Indica cuál en cada llamada: header
X-Connect-Connectionen REST y campoconnectionIden elexecute_writede MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
operacionId | string | sí | 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 -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"}}'{
"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 enIdempotency-Key(REST) o enidempotencyKey(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
| Campo | Tipo | Requerido | Descripció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. |
publicacionId | string | null | sí |
url | string | null | sí |
operacionId | string | sí | Identificador de la operación de publicación; se conserva al reanudar. |
puedeReintentar | booleano | sí | 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ódigo | HTTP | Reintentable | Qué hacer |
|---|---|---|---|
connection_disabled | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
connection_not_found | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
connection_credential_required | 428 | no | Crea 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_busy | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
upstream_error | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
timeout | 504 | sí | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. |
connector_onboarding_required | 428 | no | Lee 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_enabled | 403 | no | Pide 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_limited | 429 | sí | Espera y reintenta con backoff exponencial. |
upstream_unexpected_response | 502 | no | No reintentes: la respuesta es determinista. Repórtalo con el request_id para que actualicemos el conector. |
idempotency_key_missing | 400 | no | Genera un UUID v4, envíalo como Idempotency-Key y reutilízalo solo para reintentos de esta misma operación. |
idempotency_in_progress | 409 | sí | Espera unos segundos y reintenta con la MISMA clave. Generar una nueva para la misma operación es lo que duplica el efecto. |
idempotency_conflict | 409 | no | Genera 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.