Re-sign part URLs for an upload already in flight

POST

files

upload

multipart

urls

refresh

Re-sign part URLs for an upload already in flight

curl --request POST \
  --url https://api.orion.file.ai/prod/v1/files/upload/multipart/urls/refresh \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "id": "upload_abc123xyz",
  "key": "org_123/workspace_456/device/file_abc/document.pdf",
  "partNumbers": [
    7,
    8,
    9,
    10
  ]
}
'

import requests

url = "https://api.orion.file.ai/prod/v1/files/upload/multipart/urls/refresh"

payload = {
    "id": "upload_abc123xyz",
    "key": "org_123/workspace_456/device/file_abc/document.pdf",
    "partNumbers": [7, 8, 9, 10]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: 'upload_abc123xyz',
    key: 'org_123/workspace_456/device/file_abc/document.pdf',
    partNumbers: [7, 8, 9, 10]
  })
};

fetch('https://api.orion.file.ai/prod/v1/files/upload/multipart/urls/refresh', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "upload_aws_xyz789",
  "key": "uploads/devices/workspaces/456/organizations/123/files/file_abc/file_abc#stmt-a.pdf",
  "urlsExpireAt": "2026-08-19T10:15:00.000Z",
  "presignedUrls": [
    {
      "partNumber": 7,
      "presignedUrl": "https://s3.amazonaws.com/...?signature=...",
      "startByte": 201326592,
      "endByte": 234881024,
      "size": 33554432
    },
    {
      "partNumber": 8,
      "presignedUrl": "https://s3.amazonaws.com/...?signature=...",
      "startByte": 234881024,
      "endByte": 268435456,
      "size": 33554432
    }
  ]
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "Invalid partNumbers: 41, 42. This upload has 13 parts.",
  "instance": "/v1/{route}",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [],
  "message": "Invalid partNumbers: 41, 42. This upload has 13 parts.",
  "error": "Unprocessable Entity",
  "statusCode": 422
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}

Request · Guide: Upload files

More details

This is what makes a long bulk transfer work. Part URLs are deliberately short-lived, so a 30-file transfer will outlive the URLs it started with; ask for the parts still outstanding and carry on.Nothing about the upload changes. Parts already uploaded under earlier URLs stay uploaded, the upload id is unchanged, and completion still expects the full part list.The input should contain:

id: the ID from the multipart upload initiation
key: the S3 key from the multipart upload initiation
partNumbers: the parts to re-sign, 1-based and within the upload’s totalParts

An id/key pair that does not belong to your API key’s account returns 404, the same as one that never existed.

Authorizations

x-api-key

string

header

required

API key for authentication

Headers

Idempotency-Key

string

Accepted for client uniformity but IGNORED on this endpoint. It has no side effects, and it exists to hand back part URLs newer than the ones you hold — they last 900 seconds, so replaying a cached response inside the 24h window would return the very URLs that just expired. Every request executes fresh: no 24h window, no replay, no Idempotent-Replayed header, and no key-reuse 422.

Body

application/json

string

required

ID from the multipart upload initiation

Example:

"upload_abc123xyz"

key

string

required

S3 key from the multipart upload initiation

Example:

"org_123/workspace_456/device/file_abc/document.pdf"

partNumbers

number[]

required

Part numbers to re-sign. 1-based, and each must be within the upload's totalParts.

Required array length: 1 - 2500 elements

Example:

[7, 8, 9, 10]

Response

Freshly signed URLs for exactly the requested parts

Re-sign part URLs for an upload already in flight

curl --request POST \
  --url https://api.orion.file.ai/prod/v1/files/upload/multipart/urls/refresh \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "id": "upload_abc123xyz",
  "key": "org_123/workspace_456/device/file_abc/document.pdf",
  "partNumbers": [
    7,
    8,
    9,
    10
  ]
}
'

import requests

url = "https://api.orion.file.ai/prod/v1/files/upload/multipart/urls/refresh"

payload = {
    "id": "upload_abc123xyz",
    "key": "org_123/workspace_456/device/file_abc/document.pdf",
    "partNumbers": [7, 8, 9, 10]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: 'upload_abc123xyz',
    key: 'org_123/workspace_456/device/file_abc/document.pdf',
    partNumbers: [7, 8, 9, 10]
  })
};

fetch('https://api.orion.file.ai/prod/v1/files/upload/multipart/urls/refresh', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "upload_aws_xyz789",
  "key": "uploads/devices/workspaces/456/organizations/123/files/file_abc/file_abc#stmt-a.pdf",
  "urlsExpireAt": "2026-08-19T10:15:00.000Z",
  "presignedUrls": [
    {
      "partNumber": 7,
      "presignedUrl": "https://s3.amazonaws.com/...?signature=...",
      "startByte": 201326592,
      "endByte": 234881024,
      "size": 33554432
    },
    {
      "partNumber": 8,
      "presignedUrl": "https://s3.amazonaws.com/...?signature=...",
      "startByte": 234881024,
      "endByte": 268435456,
      "size": 33554432
    }
  ]
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "Invalid partNumbers: 41, 42. This upload has 13 parts.",
  "instance": "/v1/{route}",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [],
  "message": "Invalid partNumbers: 41, 42. This upload has 13 parts.",
  "error": "Unprocessable Entity",
  "statusCode": 422
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}

{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}