Documents Upload File
documents.upload_fileUploads and saves a user-selected ChatGPT PDF attachment from an approved HTTPS file host. With tableSlug, attempts to create an extraction job immediately, returning job on success or job_error on failure. Without tableSlug, automatic processing uses project routing rules or an active splitter. Returns document identifiers and processing details. Maximum file size: 8 MiB.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file": "<file>"
},
"name": "documents.upload_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | ||
| tableSlug | No | ||
| project_slug | No | Slug of an owned project. Optional only when the account has exactly one visible project; required for accounts with multiple visible projects. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | Yes | ||
| fileId | Yes | ||
| status | Yes | ||
| file_id | Yes | ||
| uploadId | Yes | ||
| job_error | No | ||
| document_id | Yes | ||
| next_action | Yes | ||
| routing_mode | Yes |