XLSX

Upload Excel file to create relations in bulk

post

Accepts a multipart/form-data file upload containing relations data, processes it asynchronously, and returns a task reference for tracking the upload status.

Body

multipart/form-data

relationsstring · binaryRequired

Excel file (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet or application/octet-stream)

sourcestringRequired

Source resource type (e.g., business_concept)

targetstringRequired

Target resource type (e.g., data_structure)

Responses

202

Accepted

application/json

file_hashstringRequired

MD5 hash of the uploaded file

statusstringRequired

Upload status (e.g., PENDING, EVENT_FAILED)

task_referencestringRequired

Reference to the background job (e.g., oban:123)

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

post/api/relations/links/upload

HTTPcURLJavaScriptPython

POST /api/relations/links/upload HTTP/1.1
Content-Type: multipart/form-data
Accept: */*
Content-Length: 82

{
  "relations": "file content",
  "source": "business_concept",
  "target": "data_structure"
}

{
  "file_hash": "d41d8cd98f00b204e9800998ecf8427e",
  "status": "PENDING",
  "task_reference": "oban:123"
}