file.detail

Retrieves a file’s details including upload status, size, and expiration time. Check that status is uploaded before using the file in task.create. Files expire 48 hours after upload.

GET /v2/file.detail

cURL

cURL

curl --request GET \
  --url 'https://api.manus.ai/v2/file.detail?file_id=<string>' \
  --header 'x-manus-api-key: <api-key>'

200

{
  "ok": true,
  "request_id": "<string>",
  "file": {
    "id": "<string>",
    "filename": "<string>",
    "created_at": 123,
    "bytes": 123,
    "content_type": "<string>",
    "expires_at": 123,
    "error_message": "<string>"
  }
}

^{Questions or issues? Contact us at [e-mail].}

OAuth scope: create_task or manage_all_tasks — see the OAuth2 guide.

Headers

x-manus-api-key · string

API key for direct authentication. Provide either this or Authorization, not both. See Authentication.

Authorization · string

OAuth2 access token in Bearer {token} format. Provide either this or x-manus-api-key, not both. See the OAuth2 guide.

Example:

"Bearer {access_token}"

Query Parameters

file_id · string · required

The unique identifier of the file to retrieve.

Response

200

application/json

File retrieved successfully.

ok · boolean

Whether the request was successful.

Example:

true

request_id · string

Unique identifier for this API request.

file · object

The file object with full details.

Hide child attributes

file. id · string

Unique identifier for the file.

file. filename · string

Name of the file.

file. status · enum<string>

File status. "pending" — waiting for upload. "uploaded" — ready to use. "deleted" — file has been deleted. "error" — upload failed.

Available options: pending, uploaded, deleted, error

file. created_at · integer<int64>

Unix timestamp (seconds) when the file record was created.

file. bytes · integer<int64> | null

File size in bytes. Only available after upload is complete.

file. content_type · string

MIME type of the file (e.g., "application/pdf", "text/csv").

file. expires_at · integer<int64>

Unix timestamp (seconds) when the file will be automatically deleted (48 hours after upload).

file. error_message · string | null

Error description if the file status is "error".