Manual · 9

Record endpoints

Method Path Description
GET /tables/{id}/records List rows – filter/sorting/grouping/summary, see Conventions
GET /tables/{id}/records/{pk} Fetch a single row
POST /tables/{id}/records Create a row (only if there’s exactly one primary key)
PATCH /tables/{id}/records/{pk} Edit a row
DELETE /tables/{id}/records/{pk} Delete a row
POST /tables/{id}/records/{pk}/links/{colId} Add a link – see Links fields (n:m)
DELETE /tables/{id}/records/{pk}/links/{colId}/{targetId} Remove a link
POST /tables/{id}/records/{pk}/attachments/{colId} Upload a file (multipart) – see Attachment
POST /tables/{id}/records/{pk}/attachments/{colId}/link Attach an already-uploaded file to this cell (body {"file_id": "..."}, file ID e.g. via GET /attachment-files) instead of uploading it again
GET /tables/{id}/records/{pk}/attachments/{colId}/{fileId} Download a file
DELETE /tables/{id}/records/{pk}/attachments/{colId}/{fileId} Unlink a file from this cell – the file itself is kept (unlinked, if that was its last reference) and, if needed, must be permanently deleted separately via /attachment-files/{id}

Rows with a composite or missing primary key stay read-only – only the read endpoint works then.