Attachments

This API allows users to retrieve attachments associated with a specific record in a table. Attachments can include various types of files such as documents, images, and other resources uploaded to the system.

List all attachments for a record

get

List all attachments for a record. Requires can_read_attachments permission on the table.

Authorizations

AuthorizationstringRequired

Organization API token (tot_) — preferred authentication method. Pass the token directly without Bearer prefix.

Path parameters

tableIdstringRequired

Table identifier

recordIdstringRequired

Record identifier

Header parameters

AuthorizationstringRequired

Organization token (tot_) — preferred method, or legacy Bearer JWT token. Pass the tot_ token directly without Bearer prefix; use Bearer <jwt> for legacy JWT auth.

Example:

Bearer eyJhbGciOiJub25lIn0.eyJ3b3Jrc3BhY2VJZCI6ImQ3NmVlOTI2LTJhNDYtNGIzMy04NDIzLTczNjFiZDM5YmU0MyIsICJpYXQiOjE3NTY3Mzc1NjIsICJleHAiOjE3NTY3NDExNjIsICJjdXN0b206dGVhbUlkIjoiYTlmYmY0ZGMtZGEzNS00YzIzLWE1YjItMTFlOTQ0NzNiZjBlIn0.

Responses

200

application/json;charset=UTF-8

400

Bad Request – invalid request parameters

application/json

401

Unauthorized – JWT token missing or invalid

application/json

403

Forbidden – insufficient permissions

application/json

404

Not Found – resource does not exist

application/json

500

Internal Server Error – unexpected server error

application/json

get

/tables/{tableId}/records/{recordId}/attachments

GET /tables/{tableId}/records/{recordId}/attachments HTTP/1.1
Host: api.transactionlink.io
Authorization: text
Accept: */*

[
  {
    "id": "99f59cfa-d992-4bb4-8739-79224ccb5ee9",
    "recordId": "d4e2e3b7-fd71-4ee8-adb0-d0e69e0cf965",
    "name": "document.jpeg",
    "type": "image/jpeg",
    "size": 1678186,
    "tags": [
      "tag1",
      "tag2"
    ],
    "createdDateTime": "2025-09-01T14:39:22.338552Z"
  }
]

Get link of a specific attachment

get

Get link of a specific attachment. Requires can_read_attachments permission on the table.

Authorizations

AuthorizationstringRequired

Organization API token (tot_) — preferred authentication method. Pass the token directly without Bearer prefix.

Path parameters

tableIdstringRequired

Table identifier

recordIdstringRequired

Record identifier

attachmentIdstringRequired

Attachment identifier

Header parameters

AuthorizationstringRequired

Organization token (tot_) — preferred method, or legacy Bearer JWT token. Pass the tot_ token directly without Bearer prefix; use Bearer <jwt> for legacy JWT auth.

Example:

Bearer eyJhbGciOiJub25lIn0.eyJ3b3Jrc3BhY2VJZCI6ImU5ZjhhZTBmLTQ3NmItNDYzMS1hNTNmLWIzZDIyM2M3ZTcyNyIsICJpYXQiOjE3NTY3Mzc1NjEsICJleHAiOjE3NTY3NDExNjEsICJjdXN0b206dGVhbUlkIjoiODM4MzA5NDAtMzRjNy00ZjZiLWIwZTUtNWE5ZDE5ZmM4ZTUwIn0.

Responses

200

application/json;charset=UTF-8

400

Bad Request – invalid request parameters

application/json

401

Unauthorized – JWT token missing or invalid

application/json

403

Forbidden – insufficient permissions

application/json

404

Not Found – resource does not exist

application/json

500

Internal Server Error – unexpected server error

application/json

get

/tables/{tableId}/records/{recordId}/attachments/{attachmentId}

GET /tables/{tableId}/records/{recordId}/attachments/{attachmentId} HTTP/1.1
Host: api.transactionlink.io
Authorization: text
Accept: */*

{
  "link": "http://attachments-bucket.localhost:51847/attachments/e9f8ae0f-476b-4631-a53f-b3d223c7e727/27f847ed-57df-45a8-945c-6738ebfef5a8/sample.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20250901T143921Z&X-Amz-SignedHeaders=host&X-Amz-Credential=test%2F20250901%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Expires=5&X-Amz-Signature=87564431e8320cee7a070e53fdd2c6396782c1b72e67068dd984b6bcb0d819b7"
}

Create an attachment for a record

post

Create an attachment for a record. Requires can_edit_attachments permission on the table.

Authorizations

AuthorizationstringRequired

Organization API token (tot_) — preferred authentication method. Pass the token directly without Bearer prefix.

Path parameters

tableIdstringRequired

recordIdstringRequired

Body

fileanyRequired

The file to upload

tagsstring[]Optional

Optional list of tags to associate with the uploaded file

Responses

201

application/json;charset=UTF-8

400

Bad Request – invalid request parameters

application/json

401

Unauthorized – JWT token missing or invalid

application/json

403

Forbidden – insufficient permissions

application/json

404

Not Found – resource does not exist

application/json

500

Internal Server Error – unexpected server error

application/json

post

/tables/{tableId}/records/{recordId}/attachments

POST /tables/{tableId}/records/{recordId}/attachments HTTP/1.1
Host: api.transactionlink.io
Authorization: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 29

{
  "file": null,
  "tags": [
    "text"
  ]
}

{
  "id": "94c8aff7-18d6-42f3-8f79-5143c7f23e0f",
  "recordId": "648fac6b-f7a7-4908-b9d1-7cc5af4c289c",
  "name": "document.jpeg",
  "type": "image/jpeg",
  "tags": [
    "text"
  ],
  "size": 1678186,
  "createdDateTime": "2025-09-01T14:39:20.839477Z"
}

Delete an attachment from a record

delete

Delete an attachment from a record. Requires can_edit_attachments permission on the table.

Authorizations

AuthorizationstringRequired

Organization API token (tot_) — preferred authentication method. Pass the token directly without Bearer prefix.

Path parameters

tableIdstringRequired

Table identifier

recordIdstringRequired

Record identifier

attachmentIdstringRequired

Attachment identifier

Header parameters

AuthorizationstringRequired

Organization token (tot_) — preferred method, or legacy Bearer JWT token. Pass the tot_ token directly without Bearer prefix; use Bearer <jwt> for legacy JWT auth.

Example:

Bearer eyJhbGciOiJub25lIn0.eyJ3b3Jrc3BhY2VJZCI6IjY2NGExOGQ5LWIwMzgtNDIyOC05ZDhlLTA2OGQ2ZTI1NTljMyIsICJpYXQiOjE3NTY3Mzc1NjIsICJleHAiOjE3NTY3NDExNjIsICJjdXN0b206dGVhbUlkIjoiNTI0NmIxNDItODZiMC00M2M1LTgyYzctNTVlZjJiZjkzMWZjIn0.

Responses

204

400

Bad Request – invalid request parameters

application/json

401

Unauthorized – JWT token missing or invalid

application/json

403

Forbidden – insufficient permissions

application/json

404

Not Found – resource does not exist

application/json

500

Internal Server Error – unexpected server error

application/json

delete

/tables/{tableId}/records/{recordId}/attachments/{attachmentId}

DELETE /tables/{tableId}/records/{recordId}/attachments/{attachmentId} HTTP/1.1
Host: api.transactionlink.io
Authorization: text
Accept: */*

No content

PreviousRecords NextComments

Last updated 1 month ago