OAuth2 Authorization Code flow
Agent ID
Original filename with extension
"manual.pdf"
MIME content type
"application/pdf"
File size in bytes
1048576
SHA-256 hex hash of the file content for deduplication
"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
Source URL for files downloaded from external sources
"https://example.com/manual.pdf"
Page ID to associate this file with
"page_abc123"
Whether this file can be fetched without authentication through its public URL
false
Knowledge file upload created
Object type
"page"
Unique identifier
"p_abc123"
Creation timestamp
"2024-01-15T10:30:00.000Z"
Last update timestamp
"2024-01-15T14:45:00.000Z"
Upload status
pending, uploaded, failed "uploaded"
Original filename
"report.pdf"
MIME content type
"application/pdf"
File size in bytes (null if not yet uploaded)
1048576
File metadata. PDF page count is stored at metadata.page_count when available.
When the file was successfully uploaded (null if pending)
"2024-11-14T10:31:23.456Z"
When the upload URL expires (ISO 8601 string for API response)
"2024-11-14T11:30:00.000Z"
Whether this file can be fetched without authentication through public_url.
false
Document classification stage - determines document type and next stages
Parse stage - converts OCR output to markdown
Index stage - vector embedding for semantic search
Insights stage - skill-based analysis generating claims/issues/checks
Principal who created this object
Principal who last updated this object
Whether this response reuses an existing file (content-based dedup)
false
Presigned S3 upload URL (only present when status is 'pending' and reused is false) Client should PUT file contents to this URL Expires after 1 hour
"https://s3.amazonaws.com/bucket/key?X-Amz-Signature=..."
Extra headers required for uploading to the presigned URL (only present when status is pending).
Authenticated files URL (CloudFront signed cookies) Only present when the file has an S3 key
"https://files.base39.cloud/uploads/org_abc/fl_abc123/report.pdf"
Authenticated preview URL for the first generated thumbnail page. Only present when a preview image exists.
"https://files.base39.cloud/uploads/org_abc/fl_abc123/preview/page-01.png"
Presigned S3 download URL.
Only returned when explicitly requested via ?fields=downloadUrl and status is 'uploaded'.
Expires after 1 hour.
"https://s3.amazonaws.com/bucket/key?X-Amz-Signature=..."
Page ID associated with this file upload (optional)
"page_abc123"
Upload purpose
agent, knowledge, skill, metadata, dataset, company, page, session, page_run_output, export, whatsapp, fiscal_document Direct files URL. Only present when public is true.
"https://files.base39.com.br/uploads/org_abc/fl_abc123/report.pdf"
Provider-specific file resources attached to this upload.