Abrir una carga de medio para Instagram

Abre una carga privada de un archivo en Emisso para esta conexión, sin pasar los bytes por la llamada.

Tool IDinstagram.medio.cargar
Nombre MCPinstagram__medio__cargar
Conectorinstagram
Planoaction
Scope (permiso)instagram:media
Authnone
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=false, destructive=false, idempotent=false, openWorld=false

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

Devuelve el medioId y una URL temporal a la que envías cada parte con PUT. Declaras tipo, tamaño exacto y SHA-256: la carga sólo se completa si coinciden. No publica ni prepara nada. Requiere el permiso de preparación de medios habilitado en Emisso para la conexión.

Entrada

CampoTipoRequeridoDescripción
tipo"image/jpeg" · "image/png" · "image/webp" · "image/gif" · "video/mp4" · "video/quicktime"síTipo declarado del archivo. Se compara con el contenido real al preparar; no reemplaza la inspección.
bytesentero 1-134217728síTamaño exacto del archivo en bytes.
sha256string ^[0-9a-f]{64}$síSHA-256 del archivo completo. La carga sólo se completa si las partes reunidas coinciden.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "tipo": {
      "type": "string",
      "enum": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif",
        "video/mp4",
        "video/quicktime"
      ],
      "description": "Tipo declarado del archivo. Se compara con el contenido real al preparar; no reemplaza la inspección."
    },
    "bytes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 134217728,
      "description": "Tamaño exacto del archivo en bytes."
    },
    "sha256": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$",
      "description": "SHA-256 del archivo completo. La carga sólo se completa si las partes reunidas coinciden."
    }
  },
  "required": [
    "tipo",
    "bytes",
    "sha256"
  ],
  "additionalProperties": false
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/instagram.medio.cargar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"tipo":"image/jpeg","bytes":182000,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}}'
MCP · meta-tool execute_write
{
  "tool": "instagram.medio.cargar",
  "params": {
    "tipo": "image/jpeg",
    "bytes": 182000,
    "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "medioId": "mobj_0123456789abcdefghijk",
    "estado": "cargando",
    "partes": 1,
    "bytesPorParte": 4194304,
    "subida": {
      "url": "https://connect.emisso.ai/api/medios/partes?token=…",
      "metodo": "PUT",
      "expiraEn": "2026-11-14T15:15:00.000Z"
    },
    "conservaHasta": "2026-11-21T15:00:00.000Z"
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "instagram.medio.cargar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

Salida

CampoTipoRequeridoDescripción
medioIdstring ^mobj_[0-9a-z]{21}$síIdentificador estable de un archivo guardado en Emisso para esta conexión.
estadostringsíLa carga espera sus partes.
partesentero 1-64síCantidad de partes a enviar.
bytesPorParteenterosíTamaño de cada parte, salvo la última.
subidaobjetosíCómo enviar las partes.
subida.urlstringsíDestino de las partes. Agrega el parámetro parte (0 a partes-1) y envía los bytes de esa parte con PUT.
subida.metodostringsíMétodo HTTP de cada parte.
subida.expiraEnstring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
conservaHastastring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "medioId": {
      "type": "string",
      "pattern": "^mobj_[0-9a-z]{21}$",
      "description": "Identificador estable de un archivo guardado en Emisso para esta conexión."
    },
    "estado": {
      "type": "string",
      "const": "cargando",
      "description": "La carga espera sus partes."
    },
    "partes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 64,
      "description": "Cantidad de partes a enviar."
    },
    "bytesPorParte": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Tamaño de cada parte, salvo la última."
    },
    "subida": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 8192,
          "format": "uri",
          "description": "Destino de las partes. Agrega el parámetro `parte` (0 a partes-1) y envía los bytes de esa parte con PUT."
        },
        "metodo": {
          "type": "string",
          "const": "PUT",
          "description": "Método HTTP de cada parte."
        },
        "expiraEn": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
          "description": "Hasta cuándo se aceptan partes. Las partes ya guardadas se conservan hasta entonces."
        }
      },
      "required": [
        "url",
        "metodo",
        "expiraEn"
      ],
      "additionalProperties": false,
      "description": "Cómo enviar las partes."
    },
    "conservaHasta": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Fin de la retención del archivo en Emisso."
    }
  },
  "required": [
    "medioId",
    "estado",
    "partes",
    "bytesPorParte",
    "subida",
    "conservaHasta"
  ],
  "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.

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