Get Upload URL

curl --request POST \
  --url https://operator.opus.com/job/file/upload \
  --header 'Content-Type: application/json' \
  --header 'x-service-key: {YOUR_SERVICE_KEY}' \
  --data '{
    "fileExtension": ".pdf",
    "originalName": "Q4-Report.pdf",
    "accessScope": "organization"
  }'

import requests

url = "https://operator.opus.com/job/file/upload"
headers = {
    "Content-Type": "application/json",
    "x-service-key": "{YOUR_SERVICE_KEY}"
}
payload = {
    "fileExtension": ".pdf",
    "originalName": "Q4-Report.pdf",
    "accessScope": "organization"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)

const response = await fetch("https://operator.opus.com/job/file/upload", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-service-key": "{YOUR_SERVICE_KEY}",
  },
  body: JSON.stringify({
    fileExtension: ".pdf",
    originalName: "Q4-Report.pdf",
    accessScope: "organization",
  }),
});

const data = await response.json();
console.log(data);

{
  "presignedUrl": "{PRESIGNED_URL}",
  "fileUrl": "{FILE_URL}"
}

POST

job

file

upload

curl --request POST \
  --url https://operator.opus.com/job/file/upload \
  --header 'Content-Type: application/json' \
  --header 'x-service-key: {YOUR_SERVICE_KEY}' \
  --data '{
    "fileExtension": ".pdf",
    "originalName": "Q4-Report.pdf",
    "accessScope": "organization"
  }'

import requests

url = "https://operator.opus.com/job/file/upload"
headers = {
    "Content-Type": "application/json",
    "x-service-key": "{YOUR_SERVICE_KEY}"
}
payload = {
    "fileExtension": ".pdf",
    "originalName": "Q4-Report.pdf",
    "accessScope": "organization"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)

const response = await fetch("https://operator.opus.com/job/file/upload", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-service-key": "{YOUR_SERVICE_KEY}",
  },
  body: JSON.stringify({
    fileExtension: ".pdf",
    originalName: "Q4-Report.pdf",
    accessScope: "organization",
  }),
});

const data = await response.json();
console.log(data);

{
  "presignedUrl": "{PRESIGNED_URL}",
  "fileUrl": "{FILE_URL}"
}

If your workflow contains file inputs (type: file or array_files), you must upload files before executing the job. This endpoint generates a presigned URL for uploading.

Call this endpoint once for each file you need to upload. After receiving the presigned URL, proceed to Upload File to complete the upload.

Headers

string

required

Your API authentication key

Body Parameters

string

required

The file extension including the dot (e.g., .pdf, .docx)

string

Access scope for the file. Options: all, user, workspace, organization. If omitted, the file is uploaded as unlisted — tracked by the platform but not shown in the file library.

string

The original filename of the file being uploaded (e.g., Q4-Report.pdf). Surfaced in the Opus file library to make the file easier to identify later.

string

Target workspace ID for the file. Required when accessScope is workspace and workflowId is not provided.

string

Target workflow ID for the file. The workspace that owns this workflow becomes the owner of the file. Required when accessScope is workspace and workspaceId is not provided.

Supported File Types

Extension	Description
`.pdf`	PDF documents
`.docx`	Word documents
`.csv`	CSV spreadsheets
`.xls`, `.xlsx`	Excel spreadsheets
`.txt`	Plain text files
`.json`	JSON files
`.html`	HTML files
`.xml`	XML files
`.jpeg`, `.jpg`, `.png`	Image files

The maximum file size for uploads is 10 MB. Files exceeding this limit will be rejected.

Response

string

required

Temporary URL for uploading your file. Use this in the Upload File step.

string

required

Permanent URL to reference this file in your Execute Job request.

curl --request POST \
  --url https://operator.opus.com/job/file/upload \
  --header 'Content-Type: application/json' \
  --header 'x-service-key: {YOUR_SERVICE_KEY}' \
  --data '{
    "fileExtension": ".pdf",
    "originalName": "Q4-Report.pdf",
    "accessScope": "organization"
  }'

import requests

url = "https://operator.opus.com/job/file/upload"
headers = {
    "Content-Type": "application/json",
    "x-service-key": "{YOUR_SERVICE_KEY}"
}
payload = {
    "fileExtension": ".pdf",
    "originalName": "Q4-Report.pdf",
    "accessScope": "organization"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)

const response = await fetch("https://operator.opus.com/job/file/upload", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-service-key": "{YOUR_SERVICE_KEY}",
  },
  body: JSON.stringify({
    fileExtension: ".pdf",
    originalName: "Q4-Report.pdf",
    accessScope: "organization",
  }),
});

const data = await response.json();
console.log(data);

{
  "presignedUrl": "{PRESIGNED_URL}",
  "fileUrl": "{FILE_URL}"
}

⌘I

Get Started

Jobs

Workflow Generation

Headers

Body Parameters

Supported File Types

Response

​Headers

​Body Parameters

​Supported File Types

​Response

Headers

Body Parameters

Supported File Types

Response