Providing Files | Further AI

When you create a workflow execution, you need to provide the documents that the workflow will process. Further AI supports four file submission methods, determined by the file access configuration set on your workflow.

The file access type is configured per workflow. Contact your Further AI representative to set or change the file access method for your workflow.

Method Overview

Method	Access Type	Content-Type	Best For
A. Multipart Upload	`multipart`	`multipart/form-data`	Direct file uploads from your server
B. Public URLs	`public_urls`	`application/json`	Files accessible via public URLs
C. OAuth2-Protected URLs	`oauth2`	`application/json`	Files behind OAuth2 authentication
D. Box Shared Links	`box`	`application/json`	Files hosted on Box

A. Multipart File Upload

Upload files directly as multipart form data. This is the most common method and works well when your application has local access to the files.

Request Format

Content-Type: multipart/form-data
Field name: files (repeat for multiple files)

Single File Upload

Python

cURL

1 import requests
2 
3 url = f"https://api.further.ai/api/v1/workflow-builder/workflows/{workflow_id}/executions"
4 headers = {"Authorization": f"Bearer {access_token}"}
5 
6 files = [
7     ("files", ("document.pdf", open("document.pdf", "rb"), "application/pdf"))
8 ]
9 
10 response = requests.post(url, headers=headers, files=files)
11 print(response.json())

Multiple File Upload

Python

cURL

1 import requests
2 
3 url = f"https://api.further.ai/api/v1/workflow-builder/workflows/{workflow_id}/executions"
4 headers = {"Authorization": f"Bearer {access_token}"}
5 
6 files = [
7     ("files", ("policy.pdf", open("policy.pdf", "rb"), "application/pdf")),
8     ("files", ("claim.pdf", open("claim.pdf", "rb"), "application/pdf")),
9     ("files", ("photos.zip", open("photos.zip", "rb"), "application/zip")),
10 ]
11 
12 response = requests.post(url, headers=headers, files=files)
13 print(response.json())

Multipart Upload with Text Inputs

You can include additional text inputs alongside your files by adding a user_inputs field containing a JSON string:

Python

cURL

1 import json
2 import requests
3 
4 url = f"https://api.further.ai/api/v1/workflow-builder/workflows/{workflow_id}/executions"
5 headers = {"Authorization": f"Bearer {access_token}"}
6 
7 files = [
8     ("files", ("policy.pdf", open("policy.pdf", "rb"), "application/pdf")),
9 ]
10 
11 data = {
12     "user_inputs": json.dumps({
13         "claim_number": "CLM-2024-001",
14         "policy_type": "auto"
15     })
16 }
17 
18 response = requests.post(url, headers=headers, files=files, data=data)
19 print(response.json())

B. Public URLs

Provide publicly accessible URLs pointing to your documents. Further AI will download the files before processing.

Request Format

Content-Type: application/json

1 {
2   "file_urls": [
3     "https://example.com/documents/policy.pdf",
4     "https://example.com/documents/claim.pdf"
5   ]
6 }

Example

Python

cURL

1 import requests
2 
3 url = f"https://api.further.ai/api/v1/workflow-builder/workflows/{workflow_id}/executions"
4 
5 headers = {
6     "Authorization": f"Bearer {access_token}",
7     "Content-Type": "application/json"
8 }
9 
10 payload = {
11     "file_urls": [
12         "https://example.com/documents/policy.pdf",
13         "https://example.com/documents/claim.pdf"
14     ]
15 }
16 
17 response = requests.post(url, headers=headers, json=payload)
18 print(response.json())

Public URLs with Text Inputs

1 {
2   "file_urls": [
3     "https://example.com/documents/policy.pdf"
4   ],
5   "user_inputs": {
6     "claim_number": "CLM-2024-001",
7     "policy_type": "auto"
8   }
9 }

URLs must be publicly accessible without authentication. If your files require auth, use OAuth2-Protected URLs or Box Shared Links instead.

C. OAuth2-Protected URLs

For files behind an OAuth2-protected service, you provide the file URLs and your OAuth2 credentials. Further AI uses your credentials to obtain an access token and download the files on your behalf.

Request Format

Content-Type: application/json

1 {
2   "file_urls": [
3     "https://your-service.com/api/documents/12345",
4     "https://your-service.com/api/documents/67890"
5   ],
6   "oauth2_credentials": {
7     "token_url": "https://your-service.com/oauth/token",
8     "client_id": "your_oauth_client_id",
9     "client_secret": "your_oauth_client_secret",
10     "scope": "documents:read"
11   }
12 }

Example

Python

cURL

1 import requests
2 
3 url = f"https://api.further.ai/api/v1/workflow-builder/workflows/{workflow_id}/executions"
4 
5 headers = {
6     "Authorization": f"Bearer {access_token}",
7     "Content-Type": "application/json"
8 }
9 
10 payload = {
11     "file_urls": [
12         "https://your-service.com/api/documents/12345"
13     ],
14     "oauth2_credentials": {
15         "token_url": "https://your-service.com/oauth/token",
16         "client_id": "your_oauth_client_id",
17         "client_secret": "your_oauth_client_secret",
18         "scope": "documents:read"
19     }
20 }
21 
22 response = requests.post(url, headers=headers, json=payload)
23 print(response.json())

OAuth2 Credentials Fields

Field	Type	Required	Description
`token_url`	string	Yes	The OAuth2 token endpoint URL
`client_id`	string	Yes	OAuth2 client identifier
`client_secret`	string	Yes	OAuth2 client secret
`scope`	string	No	OAuth2 scope(s) required to access the files

D. Box Shared Links

For documents stored in your Box instance, provide Box shared links. You provide your Box credentials to Further AI during setup, and the system uses them to download files via the Box API.

Request Format

Content-Type: application/json

1 {
2   "file_urls": [
3     "https://app.box.com/s/abc123def456",
4     "https://app.box.com/s/ghi789jkl012"
5   ]
6 }

Example

Python

cURL

1 import requests
2 
3 url = f"https://api.further.ai/api/v1/workflow-builder/workflows/{workflow_id}/executions"
4 
5 headers = {
6     "Authorization": f"Bearer {access_token}",
7     "Content-Type": "application/json"
8 }
9 
10 payload = {
11     "file_urls": [
12         "https://app.box.com/s/abc123def456",
13         "https://app.box.com/s/ghi789jkl012"
14     ]
15 }
16 
17 response = requests.post(url, headers=headers, json=payload)
18 print(response.json())

Box shared links must have the appropriate access level set (e.g., “People with the link” or “Company”). Restricted links that require Box authentication will not work with this method.

Supported File Types

Further AI supports a variety of document formats:

Category	Formats
Documents	PDF, DOCX, DOC, TXT, RTF
Spreadsheets	XLSX, XLS, CSV
Images	PNG, JPG, JPEG, TIFF, BMP, GIF
Archives	ZIP (containing supported formats)
Email	EML, MSG

Maximum file size and count limits vary by workflow configuration. Contact your Further AI representative for your specific limits.