POST/api/v1/files/upload-intents

Criar intenção de upload

Bearer tokenImplementadoescopo write:files

Contrato OpenAPI

operationId: createFileUploadIntent · Implementada

Baixar o contrato OpenAPI 3.1.

Schema do request

JSON
{
  "additionalProperties": false,
  "properties": {
    "checksum": {
      "oneOf": [
        {
          "pattern": "^[A-Fa-f0-9]{64}$",
          "type": "string"
        },
        {
          "pattern": "^[A-Za-z0-9+/]{43}=$",
          "type": "string"
        }
      ]
    },
    "filename": {
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "mimeType": {
      "enum": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "video/mp4",
        "video/quicktime",
        "video/webm",
        "audio/mpeg",
        "audio/wav",
        "audio/mp4"
      ],
      "type": "string"
    },
    "purpose": {
      "$ref": "#/components/schemas/FilePurpose"
    },
    "sizeBytes": {
      "maximum": 104857600,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "purpose",
    "filename",
    "mimeType",
    "sizeBytes",
    "checksum"
  ],
  "type": "object"
}

Respostas

HTTPSignificado
201Intenção e URL assinada de upload
defaultErro padronizado

⚠️ Narrativa ausente. Método, autenticação, schemas e respostas abaixo vêm do contrato OpenAPI canônico.