---
title: "Publish phiên bản mới của liên kết (version + 1)"
method: PUT
path: "/office/links/{id}"
tags: ["OfficeLinks"]
---

# Publish phiên bản mới của liên kết (version + 1)

`PUT /office/links/{id}`

## Request

- Base URL: `https://api.fireant.vn`
- URL: `https://api.fireant.vn/office/links/{id}`
- Auth: OAuth 2
  - Implicit: `https://accounts.fireant.vn/connect/authorize`
  - Scopes: `user-data-write`
- TypeScript: <https://skmtc.dev/fireant/apis/fireant-restful-api/docs/office/links/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

Body JSON cùng dạng với POST: payload bắt buộc; name, kind, sourceApp, sourceDocument, sourceRef tùy chọn
(null / không gửi = giữ nguyên; sourceDocument / sourceRef "" = xóa).

## Path parameters

- `id` string, required

## Response `200`

Liên kết sau cập nhật (không kèm payload)

- FireAntApiModelsOfficeLinksOfficeLinkItem: Một liên kết dữ liệu Office (Excel → Word / PowerPoint) của người dùng hiện tại - không kèm payload (danh sách, kết quả tạo / publish)
  - `id` string: ID công khai của liên kết: 22 ký tự base64url (A-Z a-z 0-9 _ -), phân biệt hoa thường
  - `name` string: Tên liên kết
  - `kind` string: Loại: table | chart | value
  - `sourceApp` string: Ứng dụng nguồn: excel | word | powerpoint
  - `sourceDocument` string: Tài liệu nguồn (tên / URL workbook), null nếu không có
  - `sourceRef` string: Vị trí nguồn: "Sheet1!A1:F12" hoặc tên biểu đồ, null nếu không có
  - `version` integer: Phiên bản snapshot: 1 khi tạo, tăng 1 mỗi lần publish (PUT)
  - `createdAt` string, date-time: Thời điểm tạo (UTC)
  - `updatedAt` string, date-time: Thời điểm publish gần nhất (UTC)

## Other responses

- `400`: Dữ liệu không hợp lệ
- `401`: Chưa đăng nhập
- `404`: Không tồn tại, đã xóa hoặc không phải liên kết của bạn
- `413`: Dữ liệu gửi lên quá lớn

## Changes

- **2026-10-10** `300cfd8b632c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/office/links/:id/put.md)

---

[API](https://skmtc.dev/fireant/apis/fireant-restful-api.md) - [All operations](https://skmtc.dev/fireant/apis/fireant-restful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireant/apis/fireant-restful-api/revisions/c9b3aa855f95?raw)