Faz upload de um novo arquivo para a organização. O arquivo deve ser enviado como multipart/form-data.
Autenticação
Requer um token de acesso válido (CHARGEFY_ACCESS_TOKEN) no header Authorization.
Parâmetros do Body (multipart/form-data)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
file | file | Sim | Arquivo a ser enviado |
name | string | Não | Nome personalizado para o arquivo |
organizationId | string | Sim | ID da organização |
Campos da Resposta
| Campo | Tipo | Descrição |
|---|
id | string | ID do arquivo |
name | string | Nome do arquivo |
mimeType | string | Tipo MIME |
size | integer | Tamanho em bytes |
publicUrl | string | URL pública |
createdAt | datetime | Data de criação |
Exemplo de Requisição
curl -X POST "https://api.chargefy.io/api/v1/files/" \
-H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
-F "file=@/caminho/para/ebook.pdf" \
-F "name=ebook-guia-completo.pdf" \
-F "organizationId=org_abc"
Exemplo de Resposta
{
"id": "file_new456",
"name": "ebook-guia-completo.pdf",
"mimeType": "application/pdf",
"size": 2456789,
"publicUrl": "https://cdn.chargefy.io/files/file_new456/ebook-guia-completo.pdf",
"createdAt": "2026-03-12T10:00:00Z"
}
