Skip to main content
POST
/
v1
/
material-sourcing
/
{id}
/
upload-file
Upload and link a file
curl --request POST \
  --url https://api.cula.tech/tracking/v1/v1/material-sourcing/{id}/upload-file \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form site=ste_01kqzcjrpyf27tge6smsbnhkh5 \
  --form external_id=GC-DOC-SCALE-TICKET-001
{
  "id": "fil_01kqzcjrpyf27tgeaqk8twgw91",
  "file_name": "puro_LCA_RCCS_Q4.xlsm",
  "file_size_bytes": 2451230,
  "mime_type": "application/vnd.ms-excel.sheet.macroEnabled.12",
  "site": {
    "id": "<string>",
    "external_id": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "external_id": "GC-DOC-Q4-LCA-2025"
}

Documentation Index

Fetch the complete documentation index at: https://docs.cula.tech/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token. Keys are scoped to one organisation and a set of permitted sites. Two keys per scope (primary + secondary) are issued to support zero-downtime rotation.

Authorization: Bearer <api-key>

Path Parameters

​
id
string
required

Cula-assigned resource ID in TypeID format (e.g. stp_01kqzcjrpxf27tge33jwvjhkff). Alternatively, pass your external ID prefixed with ext- (e.g. ext-MY-STEP-001). The ext- prefix is unambiguous because TypeIDs use _ separators and never start with ext-.

Body

multipart/form-data
​
file
file
required

The file to upload.

​
site
string
required

ID or ext-{externalId} of the site this file belongs to.

Example:

"ste_01kqzcjrpyf27tge6smsbnhkh5"

​
external_id
string

Partner-assigned identifier for the file.

Example:

"GC-DOC-SCALE-TICKET-001"

Response

File uploaded and linked.

​
id
string
required
Example:

"fil_01kqzcjrpyf27tgeaqk8twgw91"

​
file_name
string
required
Example:

"puro_LCA_RCCS_Q4.xlsm"

​
file_size_bytes
integer
required
Example:

2451230

​
mime_type
string
required
Example:

"application/vnd.ms-excel.sheet.macroEnabled.12"

​
site
object
required

The site this file belongs to.

​
created_at
string<date-time>
required
​
external_id
string | null
Example:

"GC-DOC-Q4-LCA-2025"