Office

Bảng dữ liệu no-code (Base/Bitable) và luồng phê duyệt (Approval).

10 endpoint · base /api/v1/office

POST/api/v1/office/tables/{id}/records/listThử ngay ▶

Liệt kê record trong 1 table.

Tool MCP: office_list_recordsScope: office.base.record.viewAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`Idempotency-Key` Mới	string	header	không	Mã do bạn tự sinh cho MỖI thao tác ghi (vd UUID), tối đa 200 ký tự. Gửi lại cùng mã trong 24 giờ ⇒ nhận lại đúng kết quả lần đầu, không tạo bản ghi thứ hai. Cùng mã mà khác nội dung ⇒ 422.
`id`	GUID	path	có	Table id
`page`	int	body	không	—
`pageSize`	int	body	không	Số dòng mỗi trang

Ví dụ

curl -X POST https://api.nextx.vn/api/v1/office/tables/<id>/records/list \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Idempotency-Key: 7f3c2a90-…" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "pageSize": 1
  }'

Ví dụ phản hồi

Đang cập nhật schema phản hồi từ mã nguồn.

GET/api/v1/office/tables/{id}/records/{recordId}Thử ngay ▶

Chi tiết 1 record.

Tool MCP: office_get_recordScope: office.base.record.viewAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`id`	GUID	path	có	Table id
`recordId`	GUID	path	có	—

Ví dụ

curl https://api.nextx.vn/api/v1/office/tables/<id>/records/<recordId> \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

Đang cập nhật schema phản hồi từ mã nguồn.

POST/api/v1/office/tables/{id}/recordsThử ngay ▶

Tạo record.

Tool MCP: office_create_recordScope: office.base.record.manageAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`Idempotency-Key` Mới	string	header	không	Mã do bạn tự sinh cho MỖI thao tác ghi (vd UUID), tối đa 200 ký tự. Gửi lại cùng mã trong 24 giờ ⇒ nhận lại đúng kết quả lần đầu, không tạo bản ghi thứ hai. Cùng mã mà khác nội dung ⇒ 422.
`id`	GUID	path	có	Table id
`data`	object	body	có	Giá trị field theo field_id

Ví dụ

curl -X POST https://api.nextx.vn/api/v1/office/tables/<id>/records \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Idempotency-Key: 7f3c2a90-…" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {}
  }'

Ví dụ phản hồi

Đang cập nhật schema phản hồi từ mã nguồn.

PUT/api/v1/office/tables/{id}/records/{recordId}Thử ngay ▶

Sửa record.

Tool MCP: office_update_recordScope: office.base.record.manageAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`Idempotency-Key` Mới	string	header	không	Mã do bạn tự sinh cho MỖI thao tác ghi (vd UUID), tối đa 200 ký tự. Gửi lại cùng mã trong 24 giờ ⇒ nhận lại đúng kết quả lần đầu, không tạo bản ghi thứ hai. Cùng mã mà khác nội dung ⇒ 422.
`id`	GUID	path	có	Table id
`recordId`	GUID	path	có	—
`data`	object	body	có	—
`replace`	bool	body	không	true = ghi đè toàn bộ

Ví dụ

curl -X PUT https://api.nextx.vn/api/v1/office/tables/<id>/records/<recordId> \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Idempotency-Key: 7f3c2a90-…" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {},
    "replace": false
  }'

Ví dụ phản hồi

Đang cập nhật schema phản hồi từ mã nguồn.

DELETE/api/v1/office/tables/{id}/records/{recordId}Thử ngay ▶

Xoá record.

Tool MCP: office_delete_recordScope: office.base.record.manageAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`id`	GUID	path	có	Table id
`recordId`	GUID	path	có	—

Ví dụ

curl -X DELETE https://api.nextx.vn/api/v1/office/tables/<id>/records/<recordId> \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

Đang cập nhật schema phản hồi từ mã nguồn.

GET/api/v1/office/approvals/instancesThử ngay ▶

Liệt kê đơn phê duyệt.

Tool MCP: office_list_approval_instancesScope: office.approval.instance.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`role`	string	query	không	Scope đơn; mặc định mine (đơn do người gọi nộp)
`page`	int	query	không	—
`pageSize`	int	query	không	Số dòng mỗi trang

Ví dụ

curl https://api.nextx.vn/api/v1/office/approvals/instances?role=...&page=1&pageSize=1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "items": [
    {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "definitionId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "definitionCode": "string",
      "applicantId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "status": "string",
      "formValue": "string",
      "currentNodeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "enrollmentId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "createdAt": "2026-10-27T09:00:00+07:00",
      "definitionName": "string",
      "myPendingTaskId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  ],
  "totalCount": 0,
  "page": 0,
  "pageSize": 0,
  "totalPages": 0,
  "hasNextPage": false,
  "hasPreviousPage": false
}

GET/api/v1/office/approvals/instances/{id}Thử ngay ▶

Chi tiết đơn phê duyệt.

Tool MCP: office_get_approval_instanceScope: office.approval.instance.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`id`	GUID	path	có	—

Ví dụ

curl https://api.nextx.vn/api/v1/office/approvals/instances/<id> \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "instance": {
    "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "definitionId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "definitionCode": "string",
    "applicantId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "status": "string",
    "formValue": "string",
    "currentNodeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "enrollmentId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "createdAt": "2026-10-27T09:00:00+07:00",
    "definitionName": "string",
    "myPendingTaskId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
  },
  "tasks": [
    {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "instanceId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "nodeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "approverId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "status": "string",
      "taskKind": "string",
      "comment": "string",
      "actedAt": "2026-10-27T09:00:00+07:00",
      "originTaskId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "position": 0,
      "dueAt": "2026-10-27T09:00:00+07:00",
      "escalatedAt": "2026-10-27T09:00:00+07:00",
      "delegatedForUserId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  ],
  "timeline": [
    {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "taskId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "action": "string",
      "actorId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "comment": "string",
      "createdAt": "2026-10-27T09:00:00+07:00"
    }
  ]
}

POST/api/v1/office/approvals/instancesThử ngay ▶

Tạo đơn phê duyệt từ mẫu.

Tool MCP: office_create_approval_instanceScope: office.approval.instance.manageOAuth người dùngAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`Idempotency-Key` Mới	string	header	không	Mã do bạn tự sinh cho MỖI thao tác ghi (vd UUID), tối đa 200 ký tự. Gửi lại cùng mã trong 24 giờ ⇒ nhận lại đúng kết quả lần đầu, không tạo bản ghi thứ hai. Cùng mã mà khác nội dung ⇒ 422.
`definitionCode`	string	body	có	Mã mẫu phê duyệt
`formValue`	string	body	không	Giá trị form (JSON string)

Ví dụ

curl -X POST https://api.nextx.vn/api/v1/office/approvals/instances \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Idempotency-Key: 7f3c2a90-…" \
  -H "Content-Type: application/json" \
  -d '{
    "definitionCode": "...",
    "formValue": "..."
  }'

Ví dụ phản hồi

null

POST/api/v1/office/approvals/tasks/{taskId}/approveThử ngay ▶

Duyệt 1 task phê duyệt.

Tool MCP: office_approve_taskScope: office.approval.instance.manageOAuth người dùngAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`Idempotency-Key` Mới	string	header	không	Mã do bạn tự sinh cho MỖI thao tác ghi (vd UUID), tối đa 200 ký tự. Gửi lại cùng mã trong 24 giờ ⇒ nhận lại đúng kết quả lần đầu, không tạo bản ghi thứ hai. Cùng mã mà khác nội dung ⇒ 422.
`taskId`	GUID	path	có	—
`comment`	string	body	không	—

Ví dụ

curl -X POST https://api.nextx.vn/api/v1/office/approvals/tasks/<taskId>/approve \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Idempotency-Key: 7f3c2a90-…" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "..."
  }'

Ví dụ phản hồi

Đang cập nhật schema phản hồi từ mã nguồn.

POST/api/v1/office/approvals/tasks/{taskId}/rejectThử ngay ▶

Từ chối 1 task phê duyệt.

Tool MCP: office_reject_taskScope: office.approval.instance.manageOAuth người dùngAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`Idempotency-Key` Mới	string	header	không	Mã do bạn tự sinh cho MỖI thao tác ghi (vd UUID), tối đa 200 ký tự. Gửi lại cùng mã trong 24 giờ ⇒ nhận lại đúng kết quả lần đầu, không tạo bản ghi thứ hai. Cùng mã mà khác nội dung ⇒ 422.
`taskId`	GUID	path	có	—
`comment`	string	body	không	—

Ví dụ

curl -X POST https://api.nextx.vn/api/v1/office/approvals/tasks/<taskId>/reject \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Idempotency-Key: 7f3c2a90-…" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "..."
  }'

Ví dụ phản hồi

Đang cập nhật schema phản hồi từ mã nguồn.