Small File Uploads (POST)

Upload files up to 100MB using simple HTTP POST with multipart/form-data.

Endpoint

POST https://ipfs.pinner.xyz/api/upload

Content-Type

Use multipart/form-data with the file in the file field.

Form Fields

Field	Type	Required	Description
`file`	`File`	Yes	The file to upload
`name`	`string`	No	Custom display name

Query Parameters

Parameter	Type	Required	Description
`archive_mode`	`string`	No	`extract` or `preserve` (archives only)

Request Headers

Header	Value	Description
`Authorization`	`Bearer TOKEN`	Your API token

Examples

Basic upload:

curl -X POST "https://ipfs.pinner.xyz/api/upload" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@document.pdf"

With custom name:

curl -X POST "https://ipfs.pinner.xyz/api/upload" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@document.pdf" \
  -F "name=my-document"

Archive with extract mode:

curl -X POST "https://ipfs.pinner.xyz/api/upload?archive_mode=extract" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@archive.zip"

Archive with preserve mode:

curl -X POST "https://ipfs.pinner.xyz/api/upload?archive_mode=preserve" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@archive.zip"

Response

{
  "id": "12345",
  "cid": "bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq",
  "name": "document.pdf",
  "size": 1048576,
  "mimeType": "application/pdf",
  "operationId": 12345
}

Limits

Limit	Value
Max file size	100MB
Supported formats	Any file type