Claude Support › Gói Team và Enterprise › Quản trị & Thành viên › Hướng dẫn tham chiếu API quản trị doanh nghiệp Claude (Claude Enterprise Admin API reference guide)

Hướng dẫn tham chiếu API quản trị doanh nghiệp Claude (Claude Enterprise Admin API reference guide)

Cập nhật: 06/10/2026 • Hướng dẫn kỹ thuật bởi vMix Việt Nam

Hướng dẫn này bao gồmgiới hạn chi tiêuvàyêu cầu tăng giới hạn chi tiêucho tổ chức Claude Enterprise của bạn bằng cách sử dụng Claude Enterprise Admin API. Giới hạn chi tiêu cho phép bạn đặt trần cho việc sử dụng tín dụng của từng thành viên trong một khoảng thời gian định kỳ, xem giới hạn của từng thành viên được kế thừa từ đâu và xem xét hoặc xử lý các yêu cầu của thành viên về giới hạn cao hơn.

Để báo cáo sử dụng và chi phí theo từng người dùng và theo khoảng thời gian, hãy xemHướng dẫn tham chiếu API phân tích.

API Quản trị Doanh nghiệp Claude hiện đang trong giai đoạn thử nghiệm công khai và có sẵn cho các tổ chức theo các gói Doanh nghiệp với chức năng tín dụng sử dụng được kích hoạt.

Tổng quan

Có tám điểm cuối trên hai tài nguyên:

Tài nguyên	Điểm cuối	Sử dụng cho
Giới hạn chi tiêu	`GET /v1/organizations/spend_limits/effective` `GET /v1/organizations/spend_limits/{spend_limit_id}` `POST /v1/organizations/spend_limits` `XÓA /v1/organizations/spend_limits/{spend_limit_id}`	Đọc giới hạn hiệu lực và chi tiêu từ đầu kỳ của từng thành viên; đặt hoặc xóa ghi đè cho từng người dùng.
Yêu cầu tăng giới hạn chi tiêu	`GET /v1/organizations/spend_limit_increase_requests` `GET /v1/organizations/spend_limit_increase_requests/{id}` `POST /v1/organizations/spend_limit_increase_requests/{id}/approve` `POST /v1/organizations/spend_limit_increase_requests/{id}/deny`	Liệt kê các yêu cầu tăng giới hạn của các thành viên, kèm theo bối cảnh cần thiết để quyết định; phê duyệt hoặc từ chối từng yêu cầu.

Sử dụnggiới hạn chi tiêuđiểm cuối để trả lời, “Giới hạn nào áp dụng cho mỗi thành viên, nó đến từ đâu, và họ đã gần đến mức đó chưa?” và để đặt ghi đè cho từng người dùng. Sử dụngyêu cầu tăng giới hạn chi tiêucác điểm đầu cuối để xử lý hàng đợi các yêu cầu do thành viên gửi.

Các yêu cầu tiên quyết và xác thực

Tổ chức của bạn phải sử dụng gói Claude Enterprise.
Tín dụng sử dụng phải được bật cho tổ chức của bạn. Chủ sở hữu chính của bạn có thể bật điều này dướiCài đặt thanh toántrong Claude.
Chủ sở hữu chính cần tạo một khóa API quản trị với một hoặc cả hai phạm vi sau:
- đọc:giới_hạn_chi_tiêu(bắt buộc cho tất cảNHẬNđiểm cuối)
- viết:giới_hạn_chi_tiêu(bắt buộc choĐĂNGvàXÓAđiểm cuối)

Đưa chìa khóa vàox-api-keytiêu đề trên mọi yêu cầu.

Quan trọng:Đừng chia sẻ khóa API công khai hoặc đưa chúng vào hệ thống quản lý mã nguồn.

Tạo một khóa API quản trị cho tổ chức Claude Enterprise của bạn

Đăng nhập với tư cách Chủ sở hữu chính—Chỉ Chủ sở hữu chính của tổ chức cha Claude Enterprise của bạn mới có thể tạo các khóa này.
Cài đặt API mở—Đi đếnCài đặt tổ chức > APIvà tìmChìa khóaphần.
Nhấp và tạo khóa—Đặt tên cho khóa và chọn các phạm vi bạn cần từbảng phạm vi. Bạn có thể kết hợp phạm vi từ các API khác nhau (ví dụ,đọc:phân tíchvàđọc:giới hạn_chi_tiêu) trên một phím duy nhất.
Sao chép và lưu trữ bí mật—Sao chép bí mật hiển thị (bắt đầu vớisk-ant-api01-) và lưu trữ nó trong trình quản lý bí mật của bạn. Toàn bộ bí mật chỉ được hiển thị một lần.

URL cơ sở

https://api.anthropic.com

Giới hạn tần suất

Tám điểm cuối đều chia sẻ một giới hạn cho mỗi tổ chức là60 yêu cầu mỗi phút. Yêu cầu vượt quá giới hạn sẽ trả về429 Quá Nhiều Yêu Cầu.

Phân trang

GET /v1/organizations/spend_limits/effectivevàGET /v1/organizations/spend_limit_increase_requestsđược đánh số trang với mộtcon trỏ mờ. Yêu cầu đầu tiên trả về tối đagiới hạnhàng cộng với mộttrang tiếp theocon trỏ. Truyền con trỏ đó mà không thay đổi nhưtrangtham số trong yêu cầu tiếp theo, và lặp lại cho đến khitrang tiếp theolànull.

Quan trọng:Đừng thay đổi các tham số truy vấn giữa chừng. Con trỏ bị ràng buộc với các bộ lọc đã tạo ra chúng. Nếu bạn thay đổiid_người_dùng[],trạng thái[], hoặcdanh_sách_id_diễn_viên[]và truyền một con trỏ cũ, bạn sẽ nhận được lỗi 400 với thông báo “cursor không khớp với các tham số truy vấn hiện tại”. Hãy bắt đầu một chuỗi mới từ trang đầu tiên thay vào đó.

Xem chuỗi con trỏ như không trong suốt: đừng phân tích, sửa đổi hoặc tự tạo ra nó.

Tuần tự hóa các tham số danh sách

Liệt kê các tham số sử dụng cú pháp dấu ngoặc: lặp lại tên tham số với[]cho mỗi giá trị.

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

Phản hồi lỗi

Trạng thái	Ý nghĩa
Bốn trăm	Dữ liệu đầu vào không hợp lệ, giá trị tham số không được hỗ trợ, con trỏ trang không khớp với các tham số hiện tại, hoặc một điều kiện tiên quyết chưa được đáp ứng (xem phần Kiểm tra hợp lệ theo từng đầu cuối).
Bốn trăm lẻ một	Thiếu`khóa-api-x`tiêu đề.
Bốn trăm lẻ ba	Khóa API thiếu phạm vi yêu cầu (`đọc:giới hạn_chi_tiêu`hoặc`viết:giới_hạn_chi_tiêu`).
Bốn trăm linh bốn	Không tìm thấy tài nguyên, hoặc khóa API không xác định, đã hết hạn, hoặc bị thu hồi.
Bốn trăm hai mươi chín	Vượt quá giới hạn tốc độ.
Năm trăm	Lỗi nội bộ.

Các khối lỗi có hình dạng:

{"type": "error", "error": {"type": "", "message": "..."}, "request_id": "req_..."}

loại.lỗilà một bộ phân biệt phụ thuộc vào trạng thái:lỗi_đầu_mục_không_hợp_le(400),lỗi xác thực(401),lỗi quyền(403),lỗi_không_tìm_thấy(404),lỗi giới hạn tốc độ(429),lỗi_api(500).mã_yêu_cầuluôn hiện diện và là giá trị để trích dẫn khi liên hệ với bộ phận hỗ trợ. Bảng Xác thực dưới mỗi điểm cuối liệt kê các thông điệp cụ thể.

Các khái niệm

Cấp bậc giới hạn chi tiêu

Việc chi tiêu tín dụng sử dụng của mỗi thành viên bị giới hạn bởi mộtgiới hạn chi tiêu hiệu quả, được giải quyết từ một hệ thống các cấp độ phạm vi. Khi một thành viên không có thiết lập ghi đè cho từng người dùng, họ sẽ kế thừa giới hạn được cấu hình cho hạng ghế của họ, nhóm của họ (nếu tổ chức của bạn sử dụng giới hạn dựa trên nhóm), hoặc mặc định toàn tổ chức.

ĐọcGET /v1/organizations/spend_limits/effectivetrả về tất cả thành viên hiện tại với giới hạn hiệu quả đã được giải quyết của họ, nơi giới hạn đó đã được giải quyết từ (nguồn), và khoản chi tiêu tính đến thời điểm hiện tại của họ. Thiết lập ghi đè cho từng người dùng thông quaPOST /v1/organizations/spend_limitsghim một thành viên vào một giới hạn cụ thể bất kể họ sẽ thừa kế gì. Xóa ghi đè sẽ trả họ về giới hạn được thừa kế.

Phạm vi

Một phạm vi xác định mức giới hạn chi tiêu được ghi hoặc giải quyết tại đâu:

Loại	Các lĩnh vực	Ý nghĩa
`người dùng`	`mã_người_dùng`	Một thành viên cụ thể.`mã_người_dùng`khớp với các ID được trả về bởi các điểm cuối người dùng của Admin API.
`hạng_ghế`	`hạng_ghế`	Mức ghế mặc định.`hạng_ghế`các giá trị là các định danh đầy đủ như`tiêu chuẩn doanh nghiệp`hoặc`doanh_nghiệp_cấp_1`; có thể thêm các giá trị bổ sung.
`nhóm_rbac`	`id_nhóm_rbac`	Mặc định theo nhóm, khi tổ chức của bạn quản lý hạn mức theo nhóm.
`tổ chức`	—	Mặc định cho toàn bộ tổ chức.

phạm vi.loạilà một chuỗi mở. Khách hàng nên coi các giá trị không xác định là không rõ và tiếp tục thay vì thất bại. Các loại phạm vi bổ sung có thể được thêm trong tương lai.

Kỳ

kỳlà cửa sổ định kỳ trong đó giới hạn được thực thi và chi tiêu được đặt lại. Giá trị duy nhất hiện nay làhàng tháng.

kỳlà một chuỗi mở. Khách hàng nên coi các giá trị không rõ là không thể nhìn thấu và tiếp tục xử lý thay vì lỗi. Các giá trị thời kỳ bổ sung có thể được thêm vào trong tương lai.

Số tiền và tiền tệ

Tất cả giá trị tiền tệ đều là chuỗi trongđơn vị nhỏ của đồng tiền thanh toán của tổ chức(xu, cho USD). Ví dụ,50000đại diện cho 500,00 USD. Phân tích cú pháp dưới dạng số thập phân và chia cho 100 để hiển thị đô la. Tránh sử dụng số dấu chấm động nhị phân cho các giá trị lớn.

số lượnglàcó thể null:nullcó nghĩa làvô hạn(không giới hạn).0có nghĩa là tín dụng sử dụng làbị vô hiệu hóacho thành viên đó.

chi tiêu từ đầu kỳ đến naylà số tín dụng sử dụng của thành viên tích lũy kể từ đầu của hiện tạikỳ, dưới cùng định dạng đơn vị nhỏ. Nó có thể bao gồm phần thập phân (ví dụ,41280,125).

Tăng vòng đời yêu cầu

Ayêu cầu tăng giới hạn chi tiêuđược tạo ra khi một thành viên nhấp vào “yêu cầu sử dụng thêm” trong claude.ai. Yêu cầu không được tạo ra thông qua API này.

Trạng thái	Ý nghĩa
`đang chờ`	Đang chờ hành động của quản trị viên. Yêu cầu thường đi kèm với một phiên trực tiếp`tóm tắt chi tiêu`vì vậy bạn có thể nhìn thấy giới hạn hiệu lực hiện tại của thành viên và chi tiêu từ đầu kỳ đến nay trong khi đưa ra quyết định.`tóm tắt chi tiêu`có thể`null`nếu nó không thể tính được, thì xử lý trường hợp đó.
`đã được phê duyệt`	Yêu cầu đã được giải quyết với sự chấp thuận: hoặc một quản trị viên đã phê duyệt rõ ràng (viết một giới hạn chi tiêu cho từng người dùng theo số tiền do quản trị viên cung cấp), một hành động quản trị viên khác đã làm cho tín dụng sử dụng có sẵn cho thành viên (ví dụ, nâng giới hạn cấp ghế hoặc bật thanh toán tín dụng sử dụng cho tổ chức), hoặc bộ phận hỗ trợ Anthropic đã nâng giới hạn thay mặt cho tổ chức.`tóm tắt chi tiêu`là`null`.
`bị từ chối`	Một quản trị viên từ chối.`tóm tắt chi tiêu`là`null`. Claude.ai ẩn nút yêu cầu của thành viên đó trong 30 ngày kể từ`đã giải quyết vào`; một quản trị viên vẫn có thể trực tiếp tăng giới hạn của thành viên bất cứ lúc nào.

Cả haiđã được phê duyệtvàbị từ chốilà cuối. Một thành viên nhiều nhất có mộtđang chờyêu cầu một lần.

Phê duyệt quaPOST …/approveghi cùng một hàng giới hạn chi tiêu trên mỗi người dùng màPOST /v1/organizations/spend_limitsviết. Việc đặt một giới hạn chi tiêu trực tiếp sẽkhôngchuyển đổi một yêu cầu đang chờ. Sử dụng điểm kết duyệt để giải quyết một yêu cầu.

Theo mặc định, Anthropic sẽ gửi email cho thành viên khi yêu cầu của họ được chấp thuận hoặc từ chối. Bỏ quachặn_thông_báo: đúngchọn phê duyệt hoặc từ chối để chặn email đó (ví dụ, khi hệ thống của bạn thông báo cho thành viên).

Đối tượng SpendLimit

Một giới hạn được cấu hình ở một cấp độ phạm vi.

{
"type": "giới_hạn_chi_tiêu",
"id": "spl_01AbCdEfGhIjKlMnOpQrSt", 
"created_at": "2026-05-01T12:00:00Z"
"updated_at": "2026-05-03T09:14:11Z"
"phạm vi": { "loại": "người dùng", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "hàng tháng"
}

Trường	Loại	Mô tả
`loại`	chuỗi	Luôn luôn`giới hạn chi tiêu`.
`thẻ căn cước`	chuỗi	Được thêm tiền tố`spl_`.
`tạo lúc`	chuỗi (RFC 3339)	Khi giới hạn này được đặt lần đầu tiên.
`cập nhật lúc`	chuỗi (RFC 3339)	Khi giới hạn này được thay đổi lần cuối.
`phạm vi`	Phạm vi	Mức mà giới hạn này được viết ở. Xem phần “Phạm vi”.
`số lượng`	chuỗi hoặc null	Giới hạn cho`kỳ`, theo các đơn vị nhỏ.`null`có nghĩa là vô hạn.
`tiền tệ`	chuỗi	ISO 4217. Đồng tiền thanh toán của tổ chức.
`kỳ`	chuỗi	Cửa sổ tái diễn mà qua đó`số lượng`được thực thi. Xem phần “Thời hạn”.

Đối tượng SpendSummary

Một hàng báo cáo được tính cho từng thành viên: giới hạn hiệu quả của thành viên, nguồn gốc của nó và khoản chi tiêu từ đầu kỳ đến hiện tại của họ. Không phải là tài nguyên có thể định địa chỉ (khôngthẻ căn cước).

{
"phạm vi": { "loại": "người dùng", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "hàng tháng",
"nguồn": { "loại": "hạng_chỗ", "hạng_chỗ": "doanh_nghiệp_tiêu_chuẩn" }
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "31402.5"
}

Trường	Loại	Mô tả
`phạm vi`	Phạm vi (`loại: "người dùng"`)	Thành viên mà hàng này dành cho.
`số lượng`	chuỗi hoặc null	Giới hạn hiệu quả cho`kỳ`, theo đơn vị nhỏ.`null`nghĩa là không giới hạn;`0`có nghĩa là các khoản tín dụng sử dụng bị vô hiệu.
`tiền tệ`	chuỗi	ISO 4217.
`kỳ`	chuỗi	Khoảng thời gian của giới hạn chi tiêu mà`nguồn`quyết định. Xem phần “Thời kỳ”.
`nguồn`	Phạm vi	Ở đâu`số lượng`đã được giải quyết từ trong hệ thống phân cấp. Bằng nhau`phạm vi`khi thành viên có một ghi đè theo từng người dùng.
`id_giới_hạn_chi_tiêu`	chuỗi	ID của`Giới hạn chi tiêu`đó`nguồn`quyết định. Lấy nó với`GET /v1/organizations/spend_limits/{spend_limit_id}`.
`chi tiêu từ đầu kỳ đến nay`	chuỗi	Các tín dụng sử dụng của thành viên đã tích lũy kể từ đầu của hiện tại`kỳ`, theo các đơn vị nhỏ.

Đối tượng YêuCầuTăngGiớiHạnChiTiêu

{
"type": "yêu_cầu_tăng_giới_hạn_chi_tiêu",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt"
"created_at": "2026-05-04T16:22:09Z"
"status": "đang chờ"
"resolved_at": null,
"resolved_by": null,
"diễn viên": {"
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"địa_chỉ_email": ""[email protected]"
},
"spend_summary": {"
"phạm vi": { "loại": "người dùng", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "hàng tháng",
"nguồn": { "loại": "hạng_chỗ", "hạng_chỗ": "doanh_nghiệp_tiêu_chuẩn" }
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "48900"
}
}

Cánh đồng	Loại	Mô tả
`loại`	chuỗi	Luôn luôn`yêu_cầu_tăng_giới_hạn_chi_tiêu`.
`thẻ căn cước`	chuỗi	Được thêm tiền tố`slir_`.
`ngày tạo`	chuỗi (RFC 3339)	Khi thành viên gửi yêu cầu.
`trạng thái`	chuỗi	`đang chờ`,`đã được phê duyệt`, hoặc`bị từ chối`.
`đã giải quyết vào`	chuỗi (RFC 3339) hoặc null	Khi yêu cầu được chấp thuận hoặc từ chối.`null`trong khi chờ xử lý.
`được giải quyết bởi`	Diễn viên hoặc null	Ai đã phê duyệt hoặc từ chối yêu cầu: hoặc một`người_dùng_diễn_viên`(một quản trị viên đã thực hiện trong claude.ai) hoặc một`khóa_api_phạm_vi_diễn_viên`(được giải quyết thông qua API này). Khi một yêu cầu được tự động giải quyết bởi hành động của quản trị viên trong claude.ai (ví dụ: nâng giới hạn hạng ghế, bật thanh toán tín dụng sử dụng cho tổ chức, hoặc nâng giới hạn của thành viên),`được giải quyết bởi`là quyền quản trị tạm thời của`người_dùng_diễn_viên`.`null`trong khi chờ xử lý, khi tài khoản của quản trị viên giải quyết đã bị xóa, hoặc khi yêu cầu được bộ phận hỗ trợ của Anthropic giải quyết. A`khóa_api_phạm_vi_diễn_viên`có thể tham chiếu đến một khóa đã bị xóa hoặc thu hồi. Xử lý`id_khoá_api_phạm_vi`như một tham chiếu lịch sử và chịu đựng thất bại khi tra cứu.
`diễn viên`	Diễn viên (`người_dùng_diễn_viên`)	Thành viên đã gửi yêu cầu.
`tóm tắt chi tiêu`	Tóm tắt chi tiêu hoặc null	Ngữ cảnh quyết định trực tiếp cho người yêu cầu: giới hạn hiệu lực và chi tiêu từ đầu kỳ đến nay của họ. Hiển thị trong khi`trạng thái`đang chờ xử lý (có thể`null`nếu bản tóm tắt không thể được tính toán); luôn luôn`null`một khi được giải quyết.

Diễn viên

Trường	Loại	Mô tả
`loại`	chuỗi	`người_dùng_diễn_viên`hoặc`khóa_api_phạm_vi_diễn_viên`.
`mã_người_dùng`	chuỗi	Có mặt`người_dùng_diễn_viên`. ID người dùng; cùng giá trị được chấp nhận bởi`danh_sách_id_diễn_viên[]`.
`tên`	chuỗi hoặc null	Có mặt`người_dùng_diễn_viên`. Tên người dùng;`null`nếu tài khoản đã bị xóa hoặc người dùng chưa đặt tên.
`địa_chỉ_email`	chuỗi hoặc null	Có mặt`người_dùng_diễn_viên`. Email của người dùng;`null`nếu tài khoản đã bị xóa.
`id_khoá_api_phạm_vi`	chuỗi	Có mặt`khóa_api_phạm_vi_diễn_viên`. Có tiền tố`apikey_`.

Giới hạn chi tiêu

1. Liệt kê giới hạn chi tiêu hiệu quả

GET /v1/organizations/spend_limits/effective

Trả vềmọi thành viên hiện tạicủa tổ chức với giới hạn hiệu quả đã được giải quyết và chi tiêu tính đến thời điểm hiện tại. Các thành viên không có ghi đè theo người dùng xuất hiện vớinguồn.loạicủahạng_ghế,nhóm_rbac, hoặctổ chức. Các thành viên trước đây không được liệt kê.

Yêu cầu phạm vi:đọc:giới hạn_chi_tiêu.

Tham số truy vấn

Trường	Loại	Bắt buộc	Mặc định	Mô tả
`id_người_dùng[]`	chuỗi, tối đa 100 mục	Không	tất cả các thành viên	Thu hẹp đến các thành viên cụ thể. Chấp nhận`người_dùng_...`ID. Một mục không phải là thành viên hiện tại sẽ bị bỏ qua một cách âm thầm từ`dữ liệu`.
`giới hạn`	số nguyên 1–1000	Không	Hai mươi	Số hàng trên mỗi trang.
`trang`	chuỗi con trỏ mờ	Không	—	Cái`trang tiếp theo`giá trị từ phản hồi trước đó.

Các trường phản hồi

Trường	Loại	Mô tả
`dữ liệu`	mảng SpendSummary	Mỗi thành viên chỉ có một mục, được sắp xếp theo thời gian gia nhập tổ chức của thành viên (mới nhất trước).
`trang tiếp theo`	chuỗi hoặc null	Con trỏ mờ cho trang tiếp theo;`null`khi không còn trang nào nữa.

Yêu cầu ví dụ

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20"
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Ví dụ về phản hồi

{
"dữ liệu": ["
{
"phạm vi": { "loại": "người dùng", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "hàng tháng",
doanh nghiệp tiêu chuẩn
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "31402.5"
}
],
"trang_tiếp_theo": "trang_..."
}

Xác thực

Điều kiện	Trạng thái	Tin nhắn
`id_người_dùng[]`mục nhập sai định dạng	Bốn trăm	`user_ids[]: mục nhập không phải là ID người dùng hợp lệ`
`id_người_dùng[]`có hơn 100 mục	Bốn trăm
`giới hạn`bên ngoài 1–1000	Bốn trăm
`trang`con trỏ không hợp lệ	Bốn trăm	`trang: con trỏ không hợp lệ`
`trang`con trỏ không khớp với hiện tại`id_người_dùng[]`	Bốn trăm	`trang: con trỏ không khớp với các tham số truy vấn hiện tại`
`trang`con trỏ từ một phiên bản API khác	Bốn trăm	`trang: con trỏ được phát hành bởi phiên bản API khác`
Tổ chức không có gói Doanh nghiệp	Bốn trăm	`đầu cuối này không được hỗ trợ cho loại tổ chức này`
Chưa bật thanh toán tín dụng sử dụng	Bốn trăm	`chưa bật tính năng tính phí vượt mức cho tổ chức này`

2. Đặt giới hạn chi tiêu

GET /v1/organizations/spend_limits/{spend_limit_id}

Trả về một giới hạn chi tiêu đơn lẻ theo ID. Sử dụng điều này để kiểm tra hàng mà mộtSpendSummary.id_giới_hạn_chi_tiêuhoặc mộtĐĂNGphản hồi được tham chiếu.

Yêu cầu phạm vi:đọc:giới hạn_chi_tiêu.

Tham số đường dẫn

Trường	Loại	Mô tả
`id_giới_hạn_chi_tiêu`	chuỗi	Được thêm tiền tố`spl_`.

Phản hồi

Một đối tượng SpendLimit.

Yêu cầu ví dụ

curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt"
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Xác thực

Điều kiện	Trạng thái	Tin nhắn
`id_giới_hạn_chi_tiêu`không tìm thấy trong tổ chức này	Bốn trăm linh bốn
Tổ chức không có gói Doanh nghiệp	Bốn trăm	`đầu cuối này không được hỗ trợ cho loại tổ chức này`
Chưa bật thanh toán tín dụng sử dụng	Bốn trăm	`chưa bật tính năng tính phí vượt mức cho tổ chức này`

3. Đặt giới hạn chi tiêu

POST /v1/organizations/spend_limits

Đặt mộttheo từng người dùngghi đè giới hạn chi tiêu. Upsert: đặt giới hạn cho một người dùng đã có giới hạn sẽ ghi đè trực tiếp lên giới hạn đó.

Chỉscope.type: "người dùng"được chấp nhận. Mặc định theo loại ghế, nhóm và cấp tổ chức được cấu hình trong cài đặt claude.ai.

Thiết lập giới hạn chi tiêu trực tiếp sẽkhôngchuyển trạng thái yêu cầu tăng hạn mức đang chờ của thành viên. Sử dụng điểm cuối phê duyệt để xử lý yêu cầu.

Yêu cầu phạm vi:viết:giới_hạn_chi_tiêu.

Nội dung yêu cầu

Trường	Loại	Bắt buộc	Mô tả
`phạm vi`	vật thể	Vâng	`{ "type": "người dùng", "user_id": "người_dùng_..." }`.
`số lượng`	chuỗi hoặc null	Vâng	Giới hạn mới cho`kỳ`, theo các đơn vị nhỏ, dưới dạng chuỗi số thập phân nguyên không âm.`0`vô hiệu hóa tín dụng sử dụng cho thành viên.`null`gỡ bỏ giới hạn (không giới hạn).
`kỳ`	chuỗi	Không	Mặc định`hàng tháng`. Xem phần “Kỳ hạn”.

Phản hồi

Một đối tượng SpendLimit phản ánh ghi đè đã được viết.

Yêu cầu ví dụ

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limits"
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
-H "content-type: application/json"
-d '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'

Ví dụ về phản hồi

{
"type": "giới_hạn_chi_tiêu",
"id": "spl_01RsTuVwXyZaBcDeFgHiJk",
"created_at": "2026-05-11T10:02:44Z"
"updated_at": "2026-05-11T10:02:44Z"
"phạm vi": { "loại": "người dùng", "user_id": "user_01AbCdEfGh" },
"amount": "75000",
"currency": "USD",
"period": "hàng tháng"
}

Xác thực

Điều kiện	Trạng thái	Tin nhắn
`phạm vi.loại`không phải`người dùng`	Bốn trăm	`scope.type: chưa được hỗ trợ`
`phạm vi.user_id`bất thường	Bốn trăm	`scope.user_id: định dạng sai`
`phạm vi.user_id`không phải là thành viên của tổ chức này	Bốn trăm	`scope.user_id: không phải là thành viên của tổ chức này`
`số lượng`âm, phân số, hoặc không phải là chuỗi thập phân hợp lệ	Bốn trăm
`kỳ`không phải`hàng tháng`	Bốn trăm	`giai đoạn: chưa được hỗ trợ`
Tổ chức không có gói Doanh nghiệp	Bốn trăm	`điểm cuối này không được hỗ trợ cho loại tổ chức này`
Thanh toán tín dụng sử dụng chưa được kích hoạt	Bốn trăm	`chưa bật tính năng tính phí vượt mức cho tổ chức này`

4. Xóa hạn mức chi tiêu

XÓA /v1/organizations/spend_limits/{spend_limit_id}

Loại bỏ mộttheo từng người dùngghi đè để thành viên quay lại giới hạn được thừa hưởng (cấp ghế, nhóm hoặc mặc định của tổ chức). Các hàng cấp ghế, nhóm và cấp tổ chức không thể bị xóa thông qua điểm cuối này.

Yêu cầu phạm vi:viết:giới_hạn_chi_tiêu.

Tham số đường dẫn

Trường	Loại	Mô tả
`id_giới_hạn_chi_tiêu`	chuỗi	Được thêm tiền tố`spl_`. Phải là ID của một ghi đè theo từng người dùng.

Phản hồi

{ "type": "giới_hạn_chi_tiêu_đã_xóa", "id": "spl_01RsTuVwXyZaBcDeFgHiJk" }

Yêu cầu ví dụ

curl -X DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk"
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Xác thực

Điều kiện	Trạng thái	Tin nhắn
`id_giới_hạn_chi_tiêu`không tìm thấy trong tổ chức này	Bốn trăm linh bốn
`id_giới_hạn_chi_tiêu`là một hàng chỗ ngồi, nhóm hoặc tổ chức	Bốn trăm	`Chỉ các giới hạn chi tiêu theo người dùng mới có thể bị xoá thông qua điểm cuối này.`
Tổ chức không có gói Doanh nghiệp	Bốn trăm	`đầu cuối này không được hỗ trợ cho loại tổ chức này`
Chưa bật thanh toán tín dụng sử dụng	Bốn trăm	`chưa bật tính năng tính phí vượt mức cho tổ chức này`

Yêu cầu tăng giới hạn chi tiêu

5. Liệt kê các yêu cầu tăng

GET /v1/organizations/requests_tăng_giới_hạn_chi_tiêu

Liệt kê các yêu cầu tăng, mới nhất trước. Các yêu cầu mà người yêu cầu không còn là thành viên của tổ chức sẽ bị loại trừ.

Yêu cầu phạm vi:đọc:giới_hạn_chi_tiêu.

Tham số truy vấn

Trường	Loại	Bắt buộc	Mặc định	Mô tả
`trạng thái[]`	một hoặc nhiều hơn`đang chờ`,`đã được phê duyệt`,`bị từ chối`	Không	tất cả	Lọc theo trạng thái. Lặp lại tham số để sử dụng nhiều giá trị.
`danh_sách_id_diễn_viên[]`	chuỗi	Không	tất cả	Lọc theo người yêu cầu. Chấp nhận`người_dùng_...`Thẻ căn cước.
`giới hạn`	số nguyên 1–1000	Không	Hai mươi	Số hàng trên mỗi trang.
`trang`	chuỗi con trỏ mờ	Không	—	Cái`trang tiếp theo`giá trị từ phản hồi trước đó.

Các trường phản hồi

Trường	Loại	Mô tả
`dữ liệu`	mảng các YêuCầuTăngGiớiHạnChiTiêu	Được đặt bởi`tạo lúc`giảm dần.
`trang tiếp theo`	chuỗi hoặc null	Con trỏ mờ cho trang tiếp theo;`null`khi không còn trang nào nữa.

Yêu cầu ví dụ

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50"
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Ví dụ về phản hồi

{
"dữ liệu": ["
{
"type": "yêu_cầu_tăng_giới_hạn_chi_tiêu",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt"
"created_at": "2026-05-04T16:22:09Z"
"trạng thái": "đang chờ",
"resolved_at": null,
"resolved_by": null,
"diễn viên": {"
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"địa_chỉ_email": ""[email protected]"
},
"spend_summary": {"
"phạm_vi": { "loại": "người_dùng", "id_người_dùng": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "hàng tháng"
"nguồn": { "loại": "hạng_chỗ", "hạng_chỗ": "doanh_nghiệp_tiêu_chuẩn" }
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "48900"
}
}
],
"next_page": null
}

Xác thực

Điều kiện	Trạng thái	Tin nhắn
`danh_sách_id_diễn_viên[]`mục nhập sai định dạng	Bốn trăm	`actor_ids[]: ID người dùng được gắn thẻ không hợp lệ`
`giới hạn`bên ngoài 1–1000	Bốn trăm
`trang`con trỏ bị biến dạng	Bốn trăm	`định dạng con trỏ trang không hợp lệ`hoặc`con trỏ trang không hợp lệ`
`trang`con trỏ không khớp với hiện tại`trạng thái[]`hoặc`danh_sách_id_diễn_viên[]`	Bốn trăm	`con trỏ trang không khớp với các tham số truy vấn hiện tại`
`trang`con trỏ từ một phiên bản API khác	Bốn trăm	`con trỏ trang đã được phát hành bởi một phiên bản API khác; khởi động lại phân trang`
Tổ chức không có gói Doanh nghiệp	Bốn trăm	`điểm cuối này không được hỗ trợ cho loại tổ chức này`
Chưa bật thanh toán tín dụng sử dụng	Bốn trăm	`chưa bật tính năng tính phí vượt mức cho tổ chức này`

6. Yêu cầu tăng lương

LẤY /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Trả về một yêu cầu tăng duy nhất.

Yêu cầu phạm vi:đọc:giới hạn_chi_tiêu.

Tham số đường dẫn

Cánh đồng	Loại	Mô tả
`yêu_cầu_tăng_giới_hạn_chi_tiêu_id`	chuỗi	Được thêm tiền tố`slir_`.

Phản hồi

Một đối tượng YêuCầuTăngGiớiHạnChi Tiêu.

Yêu cầu ví dụ

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt"
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Xác thực

Điều kiện	Trạng thái	Tin nhắn
Yêu cầu không tìm thấy trong tổ chức này	Bốn trăm linh bốn
Người yêu cầu không còn là thành viên của tổ chức này	Bốn trăm linh bốn
Tổ chức không có gói Doanh nghiệp	Bốn trăm	`điểm cuối này không được hỗ trợ cho loại tổ chức này`
Thanh toán tín dụng sử dụng chưa được kích hoạt	Bốn trăm	`chưa bật tính năng tính phí vượt mức cho tổ chức này`

7. Phê duyệt yêu cầu tăng

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Phê duyệt một yêu cầu đang chờ xử lý. Viết mộtgiới hạn chi tiêu theo từng người dùngtạisố lượngcho người yêu cầu và chuyển yêu cầu đếnđã được phê duyệt. Yêu cầu không mang theo một số tiền được yêu cầu, quản trị viên cung cấp giới hạn mới khi phê duyệt.

Yêu cầu phạm vi:viết:giới_hạn_chi_tiêu.

Tham số đường dẫn

Cánh đồng	Loại	Mô tả
`yêu_cầu_tăng_giới_hạn_chi_tiêu_id`	chuỗi	Được thêm tiền tố`slir_`.

Thân yêu cầu

Cánh đồng	Loại	Bắt buộc	Mặc định	Mô tả
`số lượng`	chuỗi	Vâng	—	Giới hạn mới theo từng người dùng cho`kỳ`, theo các đơn vị nhỏ, dưới dạng chuỗi số thập phân nguyên không âm.
`kỳ`	chuỗi	Không	`hàng tháng`	Xem phần “Kỳ hạn”.
`chặn_thông_báo`	boolean	Không	`sai`	Nếu`đúng`, Anthropic không gửi email cho thành viên rằng yêu cầu của họ đã được chấp thuận.

Phản hồi

Yêu cầu Tăng Giới Hạn Chi tiêu ở trạng tháiđã được phê duyệt, với thêmgiới hạn chi tiêutrường chứa SpendLimit đã được ghi.

Yêu cầu ví dụ

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve"
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
-H "content-type: application/json"
-d '{"amount": "75000", "suppress_notification": true}'

Ví dụ về phản hồi

{
"type": "yêu_cầu_tăng_giới_hạn_chi_tiêu",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt"
"created_at": "2026-05-04T16:22:09Z"
"trạng thái": "đã phê duyệt",
"resolved_at": "2026-05-11T10:05:02Z"
"được_giải_quyết_bởi": {
"type": "scoped_api_key_actor",
"scoped_api_key_id": "apikey_01ZyXwVuTsRqPoNmLkJiHg"
},
"diễn viên": {"
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"địa_chỉ_email": ""[email protected]"
},
"tóm_tắt_chi_tiêu": null,
"spend_limit": {"
"type": "giới_hạn_chi_tiêu",
"id": "spl_01RsTuVwXyZaBcDeFgHiJk",
"created_at": "2026-05-11T10:05:02Z"
"updated_at": "2026-05-11T10:05:02Z"
"phạm vi": { "loại": "người dùng", "user_id": "user_01AbCdEfGh" },
"amount": "75000",
"currency": "USD",
"period": "hàng tháng"
}
}

Xác thực

Điều kiện	Trạng thái	Tin nhắn
Yêu cầu không tìm thấy trong tổ chức này	Bốn trăm linh bốn
Người yêu cầu không còn là thành viên của tổ chức này	Bốn trăm linh bốn
Yêu cầu đã được gửi`đã được phê duyệt`hoặc`bị từ chối`	Bốn trăm	`yêu cầu tăng giới hạn chi tiêu đã được giải quyết`
`số lượng`âm, phân số, hoặc không phải là chuỗi thập phân hợp lệ	Bốn trăm
`kỳ`không phải`hàng tháng`	Bốn trăm	`giai đoạn: chưa được hỗ trợ`
Tổ chức không có gói Doanh nghiệp	Bốn trăm	`đầu cuối này không được hỗ trợ cho loại tổ chức này`
Chưa bật thanh toán tín dụng sử dụng	Bốn trăm	`chưa bật tính năng tính phí vượt mức cho tổ chức này`

8. Từ chối yêu cầu tăng

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Từ chối một yêu cầu đang chờ xử lý. Bất biến trênbị từ chối: từ chối một yêu cầu đã bị từ chối trước đó sẽ trả về 200 với tài nguyên hiện có. Từ chối một yêu cầu đã được chấp thuận trước đó sẽ bị từ chối để tự động hóa có thể phân biệt được việc thử lại với một quyết định mâu thuẫn.

Yêu cầu phạm vi:viết:giới_hạn_chi_tiêu.

Tham số đường dẫn

Cánh đồng	Loại	Mô tả
`yêu_cầu_tăng_giới_hạn_chi_tiêu`	chuỗi	Được thêm tiền tố`slir_`.

Nội dung yêu cầu

Cánh đồng	Loại	Bắt buộc	Mặc định	Mô tả
`chặn_thông_báo`	boolean	Không	`sai`	Nếu`đúng`, Anthropic không gửi email cho thành viên rằng yêu cầu của họ đã bị từ chối.

Phản hồi

Một Yêu cầu Tăng Giới hạn Chi tiêu ở trạng thái bị từ chối.

Yêu cầu ví dụ

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny"
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
-H "content-type: application/json"
-d '{"suppress_notification": true}'

Xác thực

Điều kiện	Trạng thái	Tin nhắn
Yêu cầu không tìm thấy trong tổ chức này	Bốn trăm linh bốn
Người yêu cầu không còn là thành viên của tổ chức này	Bốn trăm linh bốn
Yêu cầu đã được gửi`đã được phê duyệt`	Bốn trăm	`yêu cầu tăng giới hạn chi tiêu đã được phê duyệt`
Yêu cầu đã được gửi`bị từ chối`	— (200, idempotent)
Tổ chức không có gói Doanh nghiệp	Bốn trăm	`đầu cuối này không được hỗ trợ cho loại tổ chức này`
Tín dụng sử dụng chưa được bật	Bốn trăm	`chưa bật tính năng tính phí vượt mức cho tổ chức này`

✦ LIÊN HỆ TƯ VẤN CÁC DỊCH VỤ AI

Hỗ trợ tư vấn, đào tạo và chuyển giao giải pháp AI cho cá nhân, doanh nghiệp và tổ chức.

📞 0981.243.678

Liên hệ qua Zalo

Nguồn tài liệu tham khảo: Bài viết được chuyển ngữ và tổng hợp từ tài liệu hỗ trợ chính thức của Anthropic Claude Support: https://support.claude.com/en/articles/15330651-claude-enterprise-admin-api-reference-guide ↗

Bản quyền nội dung gốc thuộc về Anthropic. Bản dịch tiếng Việt phục vụ mục đích học tập và tra cứu cộng đồng.