Skip to main content
POST
/
v1
/
files
CreateFile
curl --request POST \
  --url https://api.manus.ai/v1/files \
  --header 'API_KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filename": "<string>"
}
'
{
  "id": "<string>",
  "object": "<string>",
  "filename": "<string>",
  "status": "<string>",
  "upload_url": "<string>",
  "upload_expires_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z"
}
Creates a file record and returns a presigned URL for uploading the file content to S3. After receiving the upload URL, use a PUT request to upload your file content. The file can then be referenced in task attachments using the returned file_id.

Authorizations

​
API_KEY
string
header
required

Body

application/json
​
filename
string
required

Name of the file to upload

Response

200 - application/json

File record created successfully.

​
id
string

Unique identifier for the file

​
object
string

Always "file"

​
filename
string

Name of the file

​
status
string

Initial status is "pending"

​
upload_url
string

Presigned S3 URL for uploading the file content (PUT request)

​
upload_expires_at
string<date-time>

ISO 8601 timestamp when the upload URL expires

​
created_at
string<date-time>

ISO 8601 timestamp when the file record was created