# 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.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                      |
| ------------------- | -------------------------------------------------------------------- |
| **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-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`](/docs/referencia/conexiones/estado-consultar).

## Qué hace [#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 [#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.             |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="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"}}'
```

```json title="MCP · meta-tool execute_write"
{
  "tool": "instagram.medio.cargar",
  "params": {
    "tipo": "image/jpeg",
    "bytes": 182000,
    "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}
```

**Salida esperada (200):**

```json
{
  "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 [#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]                                                                                                | \[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)))$\` | sí | Hasta cuándo se aceptan partes. Las partes ya guardadas se conservan hasta entonces. |
| `conservaHasta`   | string \`^(?:(?:\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)))$\` | sí | Fin de la retención del archivo en Emisso.                                           |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Errores de esta tool [#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](/docs/referencia/errores).


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/instagram/medio-cargar.
