Mã lỗi

Mọi phản hồi lỗi có cùng một cấu trúc. Hãy dựa vào trạng thái HTTP và error.code; error.message là văn bản tiếng Anh dễ đọc và có thể thay đổi.

Định dạng lỗi

{
  "detail": "…",
  "error": {
    "code": "api.cursor_invalid",
    "message": "The cursor is malformed or was issued for different filters.",
    "details": {"parameter": "cursor"},
    "request_id": "01JB7Q2M4X9V3K8T5N6P0R1S2A",
    "doc_url": "https://developers.sursa.com/errors/api.cursor_invalid"
  }
}

error.code là mã trên trang này; error.request_id khớp với header X-Request-Id; error.doc_url là liên kết tới trang này.

access_requests

409access_requests.closedđã có quyết định cho yêu cầu truy cập này
400access_requests.invalid{reason}
404access_requests.not_foundkhông tìm thấy yêu cầu truy cập hoặc câu trả lời
403access_requests.not_personyêu cầu truy cập chỉ dành cho người dùng, không dành cho khóa API hay chế độ “View as”

analytics

403analytics.admins_onlyphân tích sản phẩm chỉ dành cho quản trị viên của tổ chức
422analytics.invalid_periodkhoảng thời gian không hợp lệ: {reason}

announcements

422announcements.audience_requiredhãy chọn ít nhất một nhóm hoặc một người dùng
403announcements.author_onlychỉ tác giả mới có thể làm việc này
422announcements.invalid_viewview phải là inbox, my_sent, all_sent hoặc my_scheduled
404announcements.not_foundkhông tìm thấy thông báo
409announcements.not_sentthông báo chưa được gửi
422announcements.note_too_longghi chú không được dài quá 700 ký tự
422announcements.scheduled_pastngày gửi phải ở trong tương lai

answers

400answers.empty_questioncâu hỏi trống
429answers.engine_busydịch vụ trả lời đang bận; hãy thử lại sau {retry_after} giây
409answers.external_ai_disabledxử lý bên ngoài đã bị tắt cho tổ chức, và không thể tạo câu trả lời này nếu không có nó
400answers.last_message_not_usertin nhắn cuối cùng phải là của người dùng
404answers.no_collectionskhông có bộ sưu tập nào bạn có quyền đọc
422answers.scope_invalidkhông thể áp dụng phạm vi câu hỏi: {reason}

api

400api.cursor_invalidcon trỏ sai định dạng hoặc được cấp cho bộ lọc khác
400api.expand_invalidexpand[] không hợp lệ: {reason}
410api.gonetuyến API này đã ngừng hoạt động; xem docs/api/CHANGELOG.md
409api.idempotency_in_progressmột yêu cầu với Idempotency-Key này vẫn đang được xử lý; hãy thử lại sau
400api.idempotency_key_invalidheader Idempotency-Key phải gồm từ 1 đến 255 ký tự ASCII in được
409api.idempotency_mismatchIdempotency-Key này đã được dùng cho một yêu cầu khác
400api.metadata_invalidsiêu dữ liệu không hợp lệ: {reason}
404api.not_foundKhông tìm thấy
413api.payload_too_largephần thân yêu cầu quá lớn
429api.quota_exceededtổ chức đã dùng hết hạn mức yêu cầu API trong khoảng thời gian này
429api.rate_limitedquá nhiều yêu cầu; hãy thử lại sau

api_keys

400api_keys.data_profile_not_applicabledata_profile không áp dụng cho vai trò admin; khóa quản trị viên thấy mọi dữ liệu của tổ chức
401api_keys.expiredkhóa API đã hết hạn
403api_keys.feature_disabledgói của tổ chức không bao gồm token API
400api_keys.invalid_cidrsallowed_cidrs phải là danh sách mạng, ví dụ 10.0.0.0/8: {reason}
400api_keys.invalid_collectionscollection_ids phải liệt kê các bộ sưu tập của tổ chức: {reason}
400api_keys.invalid_expiresexpires_at phải là một thời điểm trong tương lai theo ISO 8601
400api_keys.invalid_scopesscopes phải là danh sách các giá trị read, write, admin, system: {reason}
403api_keys.ip_not_allowedkhông cho phép gửi yêu cầu với khóa API này từ mạng này
403api_keys.mcp_onlykhóa MCP cá nhân chỉ hoạt động trên endpoint /mcp
404api_keys.not_foundkhông tìm thấy khóa
403api_keys.scopekhóa API không có phạm vi {scope}

api_logs

404api_logs.not_foundkhông tìm thấy yêu cầu trong nhật ký API hoặc yêu cầu đã cũ hơn 14 ngày

auth

403auth.admin_requiredcần vai trò quản trị viên
403auth.editor_requiredcần vai trò biên tập viên
401auth.not_authenticatedchưa xác thực
403auth.system_scopequản trị viên hệ thống không có quyền truy cập dữ liệu của tổ chức

authz

403authz.forbiddencần quyền '{permission}'
400authz.group_key_invalidkhóa nhóm không hợp lệ: chữ cái Latin, chữ số, '_' và '-', tối đa 80 ký tự, bắt đầu bằng chữ cái
409authz.group_key_takenkhóa nhóm '{key}' đã được sử dụng
409authz.group_kind_immutableđây là nhóm có sẵn; thành viên của nhóm được tính tự động và không thể chỉnh sửa, và không thể xóa nhóm này
409authz.group_managed_externallynhóm do nhà cung cấp danh tính (SCIM) quản lý
404authz.group_not_foundkhông tìm thấy nhóm
409authz.last_ownerđối tượng phải còn ít nhất một '{role}'
409authz.legacy_admin_single_user_onlyvai trò quản trị viên chỉ được gán cho người dùng, không gán cho nhóm
409authz.managed_by_sourcequyền của đối tượng này do nguồn của nó quản lý
400authz.role_key_invalidkhóa vai trò không hợp lệ: chữ cái Latin, chữ số, '_' và '-', tối đa 64 ký tự, bắt đầu bằng chữ cái
409authz.role_key_takenkhóa vai trò '{key}' đã được sử dụng
404authz.role_not_foundkhông tìm thấy vai trò
400authz.role_scope_mismatchkhông thể gán vai trò '{key}' trên {object_type}
409authz.role_system_immutablekhông thể thay đổi hoặc xóa vai trò hệ thống
400authz.subject_requiredcần đúng một trong hai trường group_id và user_id
400authz.unknown_permissionquyền không xác định '{permission}'
400authz.user_not_in_orgkhông tìm thấy người dùng trong tổ chức
400authz.view_requiredvai trò cho đối tượng phải bao gồm COLLECTION_VIEW

billing

402billing.seats_exceededTất cả {purchased} chỗ của gói đăng ký đã được dùng hết ({reserved} người dùng đang hoạt động và lời mời đang chờ). Hãy thêm chỗ trên trang Billing (Thanh toán) để mời thêm người.

cards

400cards.archive_emptytệp nén không chứa tài liệu nào được hỗ trợ
400cards.archive_encryptedtệp nén đã được mã hóa; hãy tải lên tệp nén không có mật khẩu
400cards.archive_invalidtệp không phải tệp nén zip hoặc tệp nén bị hỏng
404cards.archive_job_not_foundkhông tìm thấy tác vụ giải nén tệp nén
413cards.archive_too_largetệp nén sau khi giải nén lớn hơn mức cho phép
413cards.archive_too_many_filestệp nén chứa nhiều tệp hơn mức cho phép
400cards.bulk_invalid{reason}
403cards.category_whole_accesschỉ có thể thay đổi danh mục khi có quyền truy cập toàn bộ tài liệu
404cards.comment_not_foundkhông tìm thấy bình luận hoặc bình luận không phải của bạn
403cards.content_whole_accesschỉ có thể thay thế nội dung thẻ khi có quyền truy cập toàn bộ tài liệu
403cards.delete_whole_accesschỉ có thể xóa thẻ khi có quyền truy cập toàn bộ tài liệu
403cards.duplicate_restrictedđã có một tài liệu giống hệt, nhưng hồ sơ dữ liệu của bạn không cho phép truy cập đầy đủ tài liệu đó
400cards.export_formatformat phải là pdf, docx hoặc md
409cards.external_id_takenexternal_id '{external_id}' đã được một thẻ khác của tổ chức sử dụng
409cards.indexing_in_progressthẻ đang được lập chỉ mục
400cards.invalid_folder_filterfolder=none cần có tham số collection
400cards.invalid_kind_filterkind phải là một trong các giá trị ('file', 'text', 'connector')
400cards.invalid_orderorder phải là 'asc' hoặc 'desc'
400cards.invalid_owner_filterowner phải là 'me', 'none' hoặc ID của người dùng
400cards.invalid_sortsort phải là một trong các giá trị ('created_at', 'updated_at', 'title', 'size', 'verified_at', 'trust', 'due')
400cards.invalid_status_filterstatus phải là một trong các giá trị ('processing', 'ready', 'error', 'archived', 'all')
400cards.invalid_type_filtertype phải là 'table' hoặc 'text'
400cards.invalid_verification_filterverification phải là một trong các giá trị ('verified', 'needs_verification', 'stale')
409cards.managed_by_sourcethẻ này do một nguồn quản lý; hãy thay đổi tài liệu trong nguồn (với nguồn tùy chỉnh, hãy đẩy lại tài liệu)
403cards.no_accesskhông có quyền {action} đối với thẻ này
409cards.no_original_filetệp gốc của thẻ này không được lưu trữ
404cards.not_foundkhông tìm thấy thẻ
400cards.review_requires_asyncreview=true cần async=true: bản xem trước kết quả đọc tệp được hiển thị trong khi tác vụ chờ
403cards.sensitivity_admin_onlychỉ quản trị viên mới có thể hạ mức độ nhạy cảm hoặc di chuyển thẻ nhạy cảm
404cards.table_not_foundkhông tìm thấy bảng
400cards.unknown_table_partbảng không xác định '{table_id}'
415cards.unsupported_formatđịnh dạng {ext} không được hỗ trợ; cho phép: ['.adoc', '.asciidoc', '.bmp', '.csv', '.docx', '.eml', '.htm', '.html', '.jpeg', '.jpg', '.markdown', '.md', '.ods', '.pdf', '.png', '.pptx', '.tif', '.tiff', '.tsv', '.txt', '.webp', '.xls', '.xlsm', '.xlsx']
403cards.verify_forbiddenchỉ người phụ trách, người kiểm chứng hoặc quản trị viên mới có thể kiểm chứng thẻ này
400cards.verify_user_account_requiredviệc kiểm chứng cần tài khoản người dùng, không phải khóa API
404cards.version_not_foundkhông tìm thấy phiên bản

catalog

404catalog.icon_not_founddịch vụ không có biểu tượng
404catalog.service_not_founddịch vụ không xác định '{service_id}'

collections

403collections.admin_fieldscần vai trò quản trị viên để thay đổi cài đặt truy cập, mức độ nhạy cảm, giá trị mặc định và cài đặt tìm kiếm của bộ sưu tập
409collections.index_outdatedchỉ mục của bộ sưu tập này đã cũ; hãy nâng cấp trước: PATCH /v1/collections/{name} với upgrade_index: true sẽ lập chỉ mục lại bộ sưu tập
409collections.indexing_in_progresstài liệu của bộ sưu tập này đang được lập chỉ mục; hãy thay đổi cài đặt tìm kiếm khi quá trình lập chỉ mục kết thúc
400collections.invalid_nametên bộ sưu tập không hợp lệ: 1-64 ký tự, chữ cái Latin, chữ số, '_' và '-'
403collections.no_accesskhông có quyền '{action}' đối với bộ sưu tập '{name}'
403collections.no_write_accesskhông có quyền ghi vào bộ sưu tập '{name}'
404collections.not_foundkhông tìm thấy bộ sưu tập '{name}'

comments

422comments.body_requiredcần nhập nội dung bình luận
403comments.forbiddenbạn không thể thay đổi bình luận này
404comments.not_foundkhông tìm thấy bình luận
400comments.reply_to_replychỉ có thể trả lời bình luận gốc
409comments.resolved_editkhông thể chỉnh sửa bình luận đã được đánh dấu đã xử lý

conversations

422conversations.invalid_cursorcon trỏ không hợp lệ
404conversations.not_foundkhông tìm thấy cuộc trò chuyện
422conversations.title_emptytiêu đề không được để trống

drafts

409drafts.already_requestedđã có yêu cầu xuất bản cho bản nháp này; bạn có thể tiếp tục chỉnh sửa trong khi bản nháp chờ duyệt
409drafts.card_deletedthẻ của bản nháp này đã bị xóa
409drafts.card_publishedthẻ đã được xuất bản hoặc thay đổi sau khi bản nháp này được tạo; hãy tạo bản nháp mới từ phiên bản đã xuất bản
422drafts.content_json_invalidcontent_json phải là đối tượng có schemaVersion (chuỗi) và doc (đối tượng), tối đa 500000 byte
409drafts.deleted_by_collaboratormột cộng tác viên khác đã xóa bản nháp này; hãy tạo bản nháp mới để tiếp tục chỉnh sửa
409drafts.existsbạn đã có một bản nháp của thẻ này
422drafts.invalid_scopescope phải là mine, all hoặc orphaned
403drafts.not_collaboratorchỉ cộng tác viên hoặc quản trị viên mới có thể thay đổi bản nháp này
404drafts.not_foundkhông tìm thấy bản nháp
409drafts.not_requestedchưa có yêu cầu xuất bản cho bản nháp này
403drafts.publish_forbiddenbạn không có quyền xuất bản vào bộ sưu tập này
422drafts.scheduled_pastngày đã lên lịch phải ở trong tương lai
422drafts.title_requiredcần có tiêu đề

events

404events.not_foundkhông tìm thấy sự kiện hoặc sự kiện đã cũ hơn 30 ngày

files

410files.expiredtệp đã hết hạn
422files.infectedtệp {filename} bị trình quét virus từ chối: {signature}
422files.invalid_expiry_filterexpiry phải là một trong các giá trị active, expiring, expired
422files.invalid_kind_filterkind phải là một trong các giá trị pdf, xlsx, csv, docx, md
422files.invalid_origin_filterorigin phải là một trong các giá trị answer, card, insights, list
409files.no_expirytệp này được lưu giữ không có ngày hết hạn
404files.not_foundkhông tìm thấy tệp
409files.not_regenerable{reason}
422files.preview_failedkhông thể xem trước tệp này: {reason}
404files.regeneration_requiredtệp này được tạo ở địa chỉ chính và chứa các chi tiết mà địa chỉ API không trả về; hãy tạo lại bằng POST /v1/files/{file_id}/regenerate hoặc tải xuống ở địa chỉ chính
409files.removedtệp đã bị xóa sau khi hết hạn; hãy tạo lại tệp
503files.scan_unavailablehiện không thể quét virus; hãy thử lại sau
413files.too_largetệp {filename} vượt quá giới hạn tải lên {limit}
415files.type_mismatchtệp {filename} không khớp với loại của nó: phần mở rộng {extension}, loại khai báo {declared}, nội dung {detected}

finance

503finance.engine_unavailabletrợ lý hiện không khả dụng: {reason}
413finance.export_too_largetệp xuất có hơn {limit} dòng: hãy thu hẹp bộ lọc
403finance.forbiddenhồ sơ dữ liệu của bạn không có quyền truy cập dữ liệu tài chính
400finance.invalid{reason}

folders

400folders.appearance_invalidcolor phải là một trong các giá trị blue, violet, emerald, amber, orange, rose, cyan, slate; icon phải là khóa danh mục hoặc lock
400folders.card_collection_mismatchthẻ và thư mục thuộc các bộ sưu tập khác nhau
409folders.cyclekhông thể di chuyển thư mục vào chính nó hoặc vào thư mục con của nó
409folders.depth_exceededđộ sâu thư mục sau khi thay đổi vượt quá mức tối đa là 3
404folders.not_foundkhông tìm thấy thư mục
400folders.parent_mismatchthư mục cha thuộc bộ sưu tập khác
400folders.sibling_not_foundprev_sibling_id phải là 'first', 'last' hoặc ID của một thư mục cùng cấp trong thư mục cha đích
400folders.title_invalidtên thư mục phải dài từ 1 đến 200 ký tự

insights

403insights.finance_forbiddenhồ sơ dữ liệu của bạn không có quyền truy cập dữ liệu tài chính
400insights.invalid_period{name}: khoảng thời gian phải có dạng YYYY-MM, nhận được '{value}'
404insights.no_datakhông có dữ liệu dạng bảng cho phân tích tri thức
400insights.period_ordersince không được muộn hơn until

internal

500internal.errorlỗi máy chủ nội bộ

jobs

409jobs.already_processingtác vụ đang được xử lý và không thể xóa khỏi hàng đợi nữa
409jobs.cancel_failedkhông thể xóa tác vụ khỏi hàng đợi
410jobs.cancel_unsupportedtác vụ được đưa vào hàng đợi trước khi có tính năng hủy; hãy đợi đến khi tác vụ hoàn tất
422jobs.invalid_filter{reason}
404jobs.not_foundkhông tìm thấy tác vụ
409jobs.not_queuedchỉ có thể xóa khỏi hàng đợi những tác vụ đang chờ (tác vụ này đang ở trạng thái {status})

limits

402limits.cardsTổ chức đã đạt giới hạn {limit} thẻ{plan}. Hãy xóa những thẻ bạn không còn cần hoặc đề nghị quản trị viên hệ thống nâng giới hạn.
429limits.concurrent_answerstổ chức đang có {used} câu trả lời đang được tạo (giới hạn {limit}); hãy thử lại sau vài giây
429limits.questionsTổ chức đã dùng hết giới hạn {limit} câu hỏi trong 24 giờ{plan}. Bạn có thể đặt câu hỏi trở lại sau khoảng {wait}. Nếu cần nhiều hơn, hãy đề nghị quản trị viên hệ thống nâng giới hạn.
402limits.sourcesTổ chức đã đạt giới hạn {limit} nguồn{plan}. Hãy xóa những nguồn bạn không còn cần hoặc đề nghị quản trị viên hệ thống nâng giới hạn.
402limits.sources_instantGói của tổ chức{plan} không bao gồm cập nhật tức thì; nguồn vẫn cập nhật theo lịch.
402limits.storageKhông đủ dung lượng lưu trữ: tổ chức đang dùng {used} trên {limit} GB{plan}, và tệp này cần thêm {amount}. Hãy xóa những thẻ hoặc tệp bạn không còn cần hoặc đề nghị quản trị viên hệ thống nâng giới hạn.
402limits.usersTổ chức đã đạt giới hạn {limit} người dùng{plan}, tính cả người dùng đang hoạt động và lời mời đang chờ. Hãy vô hiệu hóa tài khoản hoặc thu hồi lời mời bạn không còn cần, hoặc đề nghị quản trị viên hệ thống nâng giới hạn.

notifications

422notifications.invalid_filter{reason}

oauth

403oauth.operation_not_allowedthao tác này không khả dụng với token của ứng dụng OAuth
401oauth.token_expiredtoken truy cập đã hết hạn; hãy lấy token mới bằng token làm mới

oauth_apps

400oauth_apps.invalid{reason}
400oauth_apps.invalid_redirect_uriURI chuyển hướng '{uri}' không được phép: hãy dùng https, chỉ dùng http cho localhost, hoặc dùng scheme ứng dụng dạng tên miền đảo ngược, không có phần fragment
400oauth_apps.invalid_scopephạm vi quyền không xác định '{scope}'
409oauth_apps.not_confidentialứng dụng này là ứng dụng công khai: nó không có khóa bí mật của client và không có quyền truy cập theo client credentials
404oauth_apps.not_foundkhông tìm thấy ứng dụng OAuth
409oauth_apps.too_manytổ chức đã có {max} ứng dụng OAuth

oauth_authorizations

404oauth_authorizations.not_foundkhông tìm thấy ủy quyền của ứng dụng

org

403org.deletedtổ chức này đã bị xóa
404org.not_foundkhông tìm thấy tổ chức
403org.suspendedtổ chức này đang bị tạm ngưng: không thể đăng nhập, dữ liệu vẫn được giữ; hãy liên hệ quản trị viên của bạn

profiles

400profiles.unknownhồ sơ dữ liệu không xác định '{key}'

quality

400quality.filter_invalid{reason}
409quality.followup_closedlỗ hổng tri thức đã được đóng
404quality.followup_not_foundkhông tìm thấy lỗ hổng tri thức đang được xử lý

query

422query.invalid_datengày không hợp lệ: {value}

questions

400questions.answer_emptycâu trả lời trống và không thể lưu thành thẻ
404questions.answer_table_not_foundkhông tìm thấy bảng trong câu trả lời
404questions.dataset_not_foundkhông tìm thấy tập dữ liệu
400questions.export_formatformat phải là một trong các giá trị pdf, xlsx, csv, docx, md
400questions.export_rowsrows phải liệt kê số thứ tự dòng của bảng, bắt đầu từ 0, cách nhau bằng dấu phẩy, khoảng dùng dấu gạch nối (0-4,7)
422questions.invalid_feedback_filterfeedback phải là positive, negative, rated, none hoặc unanswered
422questions.invalid_q_fieldq_field phải là all hoặc question
422questions.invalid_view_as_filterview_as phải là only hoặc exclude
404questions.not_foundkhông tìm thấy câu hỏi
400questions.save_card_error{reason}

sources

400sources.connection_kind_mismatchkết nối này dành cho {kind}, không dành cho nguồn này
404sources.connection_not_foundkhông tìm thấy kết nối của nguồn
403sources.connection_not_usablekết nối này thuộc về người dùng khác hoặc đã bị vô hiệu hóa
403sources.feature_disabledgói của tổ chức không bao gồm trình kết nối nguồn chỉ với một cú nhấp
400sources.folder_invalidthư mục không nằm trong bộ sưu tập của nguồn hoặc bạn không thể thêm thẻ vào thư mục đó
400sources.invalid_configcài đặt nguồn không hợp lệ: {reason}
400sources.kind_not_allowed_for_keykhóa API chỉ có thể tạo và thay đổi nguồn tùy chỉnh; hãy kết nối các nguồn khác trong trình duyệt
404sources.not_foundkhông tìm thấy nguồn
422sources.push_batch_rejectedlô không được áp dụng vì một số tài liệu bị từ chối; xem details.results
400sources.push_document_invalid{reason}
404sources.push_document_not_foundkhông tìm thấy tài liệu trong nguồn
409sources.push_initial_requiredhãy hoàn tất lần đồng bộ ban đầu trước khi đồng bộ gia tăng
401sources.push_key_invalidkhóa API của nguồn bị thiếu, không hợp lệ hoặc đã bị thu hồi
404sources.push_key_not_foundkhông tìm thấy khóa API của nguồn
409sources.push_sync_closedphiên đồng bộ đã đóng hoặc đã hết hạn; hãy mở phiên mới
404sources.push_sync_not_foundkhông tìm thấy phiên đồng bộ
409sources.push_sync_openmột phiên đồng bộ khác đang mở cho nguồn này; hãy đóng phiên đó hoặc đợi đến khi nó hết hạn
409sources.push_too_many_documentsnguồn đã đạt giới hạn tài liệu của gói của bạn
400sources.push_unsupportednguồn này không nhận tài liệu được đẩy lên (chỉ nguồn tùy chỉnh mới nhận)

tasks

400tasks.invalid_scopescope phải là 'mine' hoặc 'team'
403tasks.team_forbiddenchế độ xem của đội chỉ dành cho quản trị viên và người kiểm chứng
400tasks.user_account_requiredcông việc cá nhân thuộc về tài khoản người dùng, không thuộc về khóa API

uploads

409uploads.already_usedlượt tải lên đã được sử dụng
422uploads.checksum_mismatchtổng kiểm SHA-256 không khớp ({reason})
410uploads.expiredlượt tải lên đã hết hạn
409uploads.incompletelượt tải lên còn thiếu {missing_count} phần
404uploads.not_foundkhông tìm thấy lượt tải lên
409uploads.not_readylượt tải lên chưa sẵn sàng (trạng thái {status})
400uploads.part_invalidphần tải lên {n} không hợp lệ: {reason}
422uploads.purpose_mismatchlượt tải lên được tạo cho {purpose}, không phải cho {expected}
422uploads.rejectedlượt tải lên bị từ chối: {reason}
409uploads.state_conflictlượt tải lên không chấp nhận thao tác này ở trạng thái {status}
503uploads.storage_unavailablekho lưu trữ tệp tạm thời không khả dụng; hãy thử lại sau
413uploads.too_largetệp vượt quá giới hạn tải lên {limit_bytes} byte
415uploads.unsupported_formatkhông thể tải lên tệp có phần mở rộng {extension} cho {purpose}

users

422users.display_name_emptytên hiển thị không được để trống
409users.email_takentrong tổ chức đã có người dùng với email này
400users.inactive_assignmentkhông thể giao cho người dùng không hoạt động
409users.last_admintổ chức phải luôn có ít nhất một quản trị viên đang hoạt động
409users.managed_by_scimtài khoản này do nhà cung cấp danh tính (SCIM) của bạn quản lý; hãy thay đổi ở đó
404users.not_foundkhông tìm thấy người dùng
400users.not_in_orgkhông tìm thấy người dùng trong tổ chức
400users.offboard_targetngười nhận bàn giao phải là người dùng đang hoạt động trong cùng tổ chức, khác với người được cho rời tổ chức
403users.password_not_allowedtài khoản này đăng nhập qua nhà cung cấp danh tính của bạn và không có mật khẩu; quản trị viên có thể thêm mật khẩu bằng liên kết đặt lại
400users.unknown_or_inactivengười dùng không xác định hoặc không hoạt động: {ids}
400users.update_invalid{reason}
409users.username_takentrong tổ chức đã có người dùng với tên đăng nhập này

users_import

422users_import.csv_invalidtệp không phải CSV hợp lệ: {reason}
422users_import.emptytệp không có dòng nào sau dòng tiêu đề
422users_import.no_email_columndòng tiêu đề không có cột email (email, e-mail, mail); tìm thấy: {columns}
413users_import.too_many_rowstệp có {rows} dòng; mỗi lần chỉ nhập tối đa {limit} dòng

validation

422validation.faileddữ liệu của yêu cầu không hợp lệ

verification

409verification.absolute_expiredngày kiểm chứng đã qua: hãy đặt khoảng kiểm chứng mới trước khi kiểm chứng
409verification.archivedthẻ đã được lưu trữ
400verification.date_requiredcần một ngày trong tương lai
422verification.invalid_actionkind phải là view hoặc copy
400verification.invalid_intervalkhoảng kiểm chứng phải từ 1 đến 3650 ngày
422verification.invalid_modemode phải là up_first hoặc all
400verification.invalid_reasonreason phải là manual, automation hoặc requested
422verification.invalid_sorttrường sắp xếp hoặc thứ tự không xác định
400verification.invalid_typeloại kiểm chứng phải là relative, absolute hoặc manual
409verification.self_remindbạn là người kiểm chứng duy nhất của thẻ này: không có ai để nhắc
400verification.verifier_requiredcần ít nhất một người kiểm chứng

view_as

403view_as.admin_key_requiredX-View-As cần một khóa API có vai trò admin
400view_as.invalid_headerX-View-As phải có dạng <profile>[:viewer|verifier|editor] với một hồ sơ đang tồn tại
403view_as.read_onlychế độ xem: không thể thay đổi trong khi xem với tư cách hồ sơ khác

webhooks

400webhooks.access_invalidvai trò, chế độ payload, hồ sơ dữ liệu, bộ sưu tập hoặc nhãn của webhook không hợp lệ
400webhooks.auth_invalidthông tin ủy quyền gửi kèm phải là bearer kèm token hoặc basic kèm tên người dùng và mật khẩu
403webhooks.collections_outside_keykhóa API này bị giới hạn trong một số bộ sưu tập: hãy liệt kê collection_ids của webhook, tất cả đều phải nằm trong các bộ sưu tập của khóa
404webhooks.delivery_not_foundkhông tìm thấy lần gửi webhook
400webhooks.description_too_longmô tả webhook dài hơn 200 ký tự
409webhooks.endpoint_disabledwebhook đang bị tắt; hãy bật nó trước
409webhooks.event_not_permittedwebhook sẽ không nhận sự kiện này vào lúc này: vai trò, hồ sơ dữ liệu, bộ sưu tập hoặc nhãn của nó không còn cho phép, nên lần gửi không được lặp lại
400webhooks.events_requiredhãy đăng ký nhận ít nhất một sự kiện
403webhooks.feature_disabledgói của tổ chức không bao gồm webhook
400webhooks.headers_invalidheader tùy chỉnh của webhook không hợp lệ: tối đa 10 header, tên gồm chữ cái, chữ số và dấu gạch nối, không dùng tên dành riêng, giá trị tối đa 1024 byte
400webhooks.invalid_urlurl của webhook phải là địa chỉ https tuyệt đối, không chứa thông tin xác thực
404webhooks.not_foundkhông tìm thấy webhook
400webhooks.overlap_invalidthời gian chồng lấn khi xoay vòng phải từ 0 đến 168 giờ
400webhooks.private_addressmáy chủ của webhook phân giải thành địa chỉ mạng riêng hoặc dành riêng
400webhooks.redeliver_invalidkhoảng thời gian gửi lại phải nằm trong 30 ngày gần nhất, since phải trước until, và statuses phải là success, exhausted hoặc cancelled
409webhooks.too_manymột tổ chức có thể có tối đa 20 webhook
400webhooks.unknown_eventsự kiện webhook không xác định {type}
400webhooks.unresolvablekhông thể phân giải máy chủ của webhook