**Versions de l’API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=fr)

# Téléversements

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

Hébergement public de fichiers de l’organisation partagé par les parcours email, site web et documents. L’envoi des octets en JSON et l’import depuis une URL publique sont accessibles via le MCP. REST accepte aussi les téléversements multipart.

## Opérations

## POST /uploads

Téléverser un média depuis ses octets ou une URL publique

`create_upload`

Permission requise, `uploads:write`. Le point d’entrée REST générique accepte aussi `messages:write` pour compatibilité.

Accepte les images matricielles prises en charge jusqu’à 5 Mio, les PDF jusqu’à 15 Mio et les vidéos jusqu’à 20 Mio.

Stocke un fichier dans cette organisation et renvoie son URL publique hébergée et son nom de fichier. Choisir exactement une source, contentBase64 avec mimeType pour les octets réels du fichier, ou url pour un fichier HTTP(S) déjà accessible publiquement. filename est une métadonnée d’affichage facultative. Utiliser uniquement du base64 standard avec remplissage, sans préfixe data URL. Fournir les octets réels, sans les inventer ni envoyer un chemin local, un identifiant de pièce jointe ou une URL de sandbox privée. L’hôte IA doit donner accès aux octets réels de la pièce jointe ou à une URL publique. Tailles décodées maximales, image 5 Mio, PDF 15 Mio et vidéo 20 Mio. Les octets réels, le type MIME, la taille et l’appartenance sont contrôlés avant publication. Les SVG, HTML, scripts, archives et autres types de fichiers sont refusés. Le téléversement rend le fichier accessible à toute personne disposant de son URL. Utiliser uniquement un contenu autorisé pour un hébergement public. Le téléversement ne joint pas le fichier à une page, n’envoie aucun email et ne change pas le logo de l’organisation. Utiliser la url renvoyée dans le HTML d’email ou de page, ou filename lorsque la destination attend un média appartenant à l’organisation. Pour un logo d’email, téléverser l’image, enregistrer le HTML du modèle avec la url renvoyée, puis donner à l’utilisateur le previewUrl du modèle. REST conserve aussi son transport multipart existant. Des octets identiques réutilisent le média de l’organisation. Après un résultat incertain, réessayer avec les mêmes octets.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "uploads:write",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "multipart/form-data": {
      "schema": {
        "type": "object",
        "minProperties": 1,
        "maxProperties": 1,
        "additionalProperties": {
          "type": "string",
          "format": "binary"
        }
      },
      "x-unisoft-file-policy": [
        {
          "contentType": "image/*",
          "maxBytes": 5242880
        },
        {
          "contentType": "application/pdf",
          "maxBytes": 15728640
        },
        {
          "contentType": "video/*",
          "maxBytes": 20971520
        }
      ]
    },
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_695f3576db52b08c3bf5"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UploadResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UNSUPPORTED_MEDIA_TYPE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "UNSUPPORTED_MEDIA_TYPE"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "uploads:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## POST /uploads/image

Téléverser une image depuis ses octets ou une URL publique

`create_upload_image`

Permission requise, `uploads:write`.

Accepte uniquement les images matricielles prises en charge, jusqu’à 5 Mio.

Stocke un fichier dans cette organisation et renvoie son URL publique hébergée et son nom de fichier. Choisir exactement une source, contentBase64 avec mimeType pour les octets réels du fichier, ou url pour un fichier HTTP(S) déjà accessible publiquement. filename est une métadonnée d’affichage facultative. Utiliser uniquement du base64 standard avec remplissage, sans préfixe data URL. Fournir les octets réels, sans les inventer ni envoyer un chemin local, un identifiant de pièce jointe ou une URL de sandbox privée. L’hôte IA doit donner accès aux octets réels de la pièce jointe ou à une URL publique. Tailles décodées maximales, image 5 Mio, PDF 15 Mio et vidéo 20 Mio. Les octets réels, le type MIME, la taille et l’appartenance sont contrôlés avant publication. Les SVG, HTML, scripts, archives et autres types de fichiers sont refusés. Le téléversement rend le fichier accessible à toute personne disposant de son URL. Utiliser uniquement un contenu autorisé pour un hébergement public. Le téléversement ne joint pas le fichier à une page, n’envoie aucun email et ne change pas le logo de l’organisation. Utiliser la url renvoyée dans le HTML d’email ou de page, ou filename lorsque la destination attend un média appartenant à l’organisation. Pour un logo d’email, téléverser l’image, enregistrer le HTML du modèle avec la url renvoyée, puis donner à l’utilisateur le previewUrl du modèle. REST conserve aussi son transport multipart existant. Des octets identiques réutilisent le média de l’organisation. Après un résultat incertain, réessayer avec les mêmes octets.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "uploads:write",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "multipart/form-data": {
      "schema": {
        "type": "object",
        "minProperties": 1,
        "maxProperties": 1,
        "additionalProperties": {
          "type": "string",
          "format": "binary"
        }
      },
      "x-unisoft-file-policy": [
        {
          "contentType": "image/*",
          "maxBytes": 5242880
        }
      ]
    },
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_3f4d6f556799cc1fe37a"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UploadResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "WRONG_MEDIA_FAMILY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "WRONG_MEDIA_FAMILY"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "uploads:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## POST /uploads/pdf

Téléverser un PDF depuis ses octets ou une URL publique

`create_upload_pdf`

Permission requise, `uploads:write`.

Accepte uniquement les fichiers PDF, jusqu’à 15 Mio.

Stocke un fichier dans cette organisation et renvoie son URL publique hébergée et son nom de fichier. Choisir exactement une source, contentBase64 avec mimeType pour les octets réels du fichier, ou url pour un fichier HTTP(S) déjà accessible publiquement. filename est une métadonnée d’affichage facultative. Utiliser uniquement du base64 standard avec remplissage, sans préfixe data URL. Fournir les octets réels, sans les inventer ni envoyer un chemin local, un identifiant de pièce jointe ou une URL de sandbox privée. L’hôte IA doit donner accès aux octets réels de la pièce jointe ou à une URL publique. Tailles décodées maximales, image 5 Mio, PDF 15 Mio et vidéo 20 Mio. Les octets réels, le type MIME, la taille et l’appartenance sont contrôlés avant publication. Les SVG, HTML, scripts, archives et autres types de fichiers sont refusés. Le téléversement rend le fichier accessible à toute personne disposant de son URL. Utiliser uniquement un contenu autorisé pour un hébergement public. Le téléversement ne joint pas le fichier à une page, n’envoie aucun email et ne change pas le logo de l’organisation. Utiliser la url renvoyée dans le HTML d’email ou de page, ou filename lorsque la destination attend un média appartenant à l’organisation. Pour un logo d’email, téléverser l’image, enregistrer le HTML du modèle avec la url renvoyée, puis donner à l’utilisateur le previewUrl du modèle. REST conserve aussi son transport multipart existant. Des octets identiques réutilisent le média de l’organisation. Après un résultat incertain, réessayer avec les mêmes octets.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "uploads:write",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "multipart/form-data": {
      "schema": {
        "type": "object",
        "minProperties": 1,
        "maxProperties": 1,
        "additionalProperties": {
          "type": "string",
          "format": "binary"
        }
      },
      "x-unisoft-file-policy": [
        {
          "contentType": "application/pdf",
          "maxBytes": 15728640
        }
      ]
    },
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_2e8d05753d86e4582298"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UploadResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "WRONG_MEDIA_FAMILY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "WRONG_MEDIA_FAMILY"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "uploads:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "UnisoftRequest_695f3576db52b08c3bf5": {
        "type": "object",
        "properties": {
          "contentBase64": {
            "type": "string",
            "minLength": 4,
            "maxLength": 27962028,
            "format": "byte",
            "description": "Octets réels du fichier encodés en base64 standard avec remplissage, sans préfixe data URL. Obligatoire avec mimeType en l’absence de url."
          },
          "mimeType": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Type MIME réel du média, comme image/png, image/jpeg ou application/pdf. Obligatoire avec contentBase64. À omettre pour les imports par url."
          },
          "filename": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Nom de fichier d’origine facultatif pour l’affichage. Il ne détermine ni chemin serveur, ni nom stocké, ni type de fichier."
          },
          "url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4096,
            "format": "uri",
            "description": "URL source HTTP(S) publique à importer. Les destinations privées, les identifiants dans l’URL et les redirections non sûres sont refusés. Omettre contentBase64 et mimeType."
          }
        },
        "additionalProperties": false,
        "oneOf": [
          {
            "required": [
              "contentBase64",
              "mimeType"
            ],
            "not": {
              "required": [
                "url"
              ]
            }
          },
          {
            "required": [
              "url"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "contentBase64"
                  ]
                },
                {
                  "required": [
                    "mimeType"
                  ]
                }
              ]
            }
          }
        ]
      },
      "UploadResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "filename",
              "url",
              "mimetype",
              "size"
            ],
            "properties": {
              "filename": {
                "type": "string"
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimetype": {
                "type": "string"
              },
              "size": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20971520
              }
            }
          }
        }
      },
      "UnisoftRequest_3f4d6f556799cc1fe37a": {
        "type": "object",
        "properties": {
          "contentBase64": {
            "type": "string",
            "minLength": 4,
            "maxLength": 6990508,
            "format": "byte",
            "description": "Octets réels du fichier encodés en base64 standard avec remplissage, sans préfixe data URL. Obligatoire avec mimeType en l’absence de url."
          },
          "mimeType": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Type MIME réel du média, comme image/png, image/jpeg ou application/pdf. Obligatoire avec contentBase64. À omettre pour les imports par url."
          },
          "filename": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Nom de fichier d’origine facultatif pour l’affichage. Il ne détermine ni chemin serveur, ni nom stocké, ni type de fichier."
          },
          "url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4096,
            "format": "uri",
            "description": "URL source HTTP(S) publique à importer. Les destinations privées, les identifiants dans l’URL et les redirections non sûres sont refusés. Omettre contentBase64 et mimeType."
          }
        },
        "additionalProperties": false,
        "oneOf": [
          {
            "required": [
              "contentBase64",
              "mimeType"
            ],
            "not": {
              "required": [
                "url"
              ]
            }
          },
          {
            "required": [
              "url"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "contentBase64"
                  ]
                },
                {
                  "required": [
                    "mimeType"
                  ]
                }
              ]
            }
          }
        ]
      },
      "UnisoftRequest_2e8d05753d86e4582298": {
        "type": "object",
        "properties": {
          "contentBase64": {
            "type": "string",
            "minLength": 4,
            "maxLength": 20971520,
            "format": "byte",
            "description": "Octets réels du fichier encodés en base64 standard avec remplissage, sans préfixe data URL. Obligatoire avec mimeType en l’absence de url."
          },
          "mimeType": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Type MIME réel du média, comme image/png, image/jpeg ou application/pdf. Obligatoire avec contentBase64. À omettre pour les imports par url."
          },
          "filename": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Nom de fichier d’origine facultatif pour l’affichage. Il ne détermine ni chemin serveur, ni nom stocké, ni type de fichier."
          },
          "url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4096,
            "format": "uri",
            "description": "URL source HTTP(S) publique à importer. Les destinations privées, les identifiants dans l’URL et les redirections non sûres sont refusés. Omettre contentBase64 et mimeType."
          }
        },
        "additionalProperties": false,
        "oneOf": [
          {
            "required": [
              "contentBase64",
              "mimeType"
            ],
            "not": {
              "required": [
                "url"
              ]
            }
          },
          {
            "required": [
              "url"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "contentBase64"
                  ]
                },
                {
                  "required": [
                    "mimeType"
                  ]
                }
              ]
            }
          }
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
