Files

​

Direct upload

curl https://api.fortiseval.com/v1/files \
  -H "Authorization: Bearer sk-your-secret-key" \
  -F "file=@/path/to/transcript.pdf"

{
  "message": "File uploaded successfully.",
  "data": {
    "id": "upload_abc123...",
    "status": "ready",
    "source": "direct_upload",
    "file_name": "transcript.pdf",
    "mime_type": "application/pdf",
    "size": 182044
  }
}

​

Ingest by URL

curl https://api.fortiseval.com/v1/files \
  -H "Authorization: Bearer sk-your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/documents/diploma.pdf" }'

• Webhooks — subscribe to file.ready / file.failed (recommended).
• Polling — GET /v1/files/{id} until status is ready or failed (failure_message explains failures).

​

File states

​

Rules

• Supported types: PDFs, images (JPEG/PNG/HEIC/TIFF), Microsoft Office documents, text, RTF, and ZIP archives. Maximum size 150 MB.
• Single use: attaching a file to a quote consumes it. To use the same document on another quote, upload it again.
• Files must be ready and unconsumed when referenced in document_ids, otherwise quote creation returns a 422 validation error for that entry.
• You can also skip the files API entirely and pass document_urls directly when creating a quote.