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 ID | instagram.medio.cargar |
| Nombre MCP | instagram__medio__cargar |
| Conector | instagram |
| Plano | action |
| Scope (permiso) | instagram:media |
| Auth | none |
| Versión | 1 |
| Sensible | sí |
| Deprecado | no |
| Comportamiento | readOnly=false, destructive=false, idempotent=false, openWorld=false |
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
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
| Campo | Tipo | Requerido | Descripció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. |
bytes | entero 1-134217728 | sí | Tamaño exacto del archivo en bytes. |
sha256 | string ^[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 -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"}}'{
"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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
medioId | string ^mobj_[0-9a-z]{21}$ | sí | Identificador estable de un archivo guardado en Emisso para esta conexión. |
estado | string | sí | La carga espera sus partes. |
partes | entero 1-64 | sí | Cantidad de partes a enviar. |
bytesPorParte | entero | sí | Tamaño de cada parte, salvo la última. |
subida | objeto | sí | Cómo enviar las partes. |
subida.url | string | sí | Destino de las partes. Agrega el parámetro parte (0 a partes-1) y envía los bytes de esa parte con PUT. |
subida.metodo | string | sí | Método HTTP de cada parte. |
subida.expiraEn | string `^(?:(?:\d\d[2468][048] | \d\d[13579][26] | \d\d0[48] |
conservaHasta | string `^(?:(?:\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ó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. |
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.
Verificar la cuenta de Instagram
Comprueba la identidad de la cuenta o página de Instagram autorizada en esta conexión y sus permisos efectivos.
Preparar un medio para Instagram
Inspecciona el contenido real de un archivo cargado o de una URL pública y lo adecua al destino de Instagram con un perfil versionado.