Mã lỗi
Danh mục mã lỗi của API công khai — mỗi mã một ý nghĩa ổn định, cùng các trạng thái HTTP có thể đi kèm.
Mỗi lỗi API trả về mang một mã trong trường type. Mã ổn định, còn câu chữ trong detail thì không — vì vậy hãy rẽ nhánh theo mã. Cấu trúc đầy đủ của một lỗi nằm ở Lỗi.
Bảng dưới đây được dựng từ chính tài liệu API mà phần tham chiếu dùng, vào lúc bộ hướng dẫn được xây dựng. Một mã có thể đi kèm nhiều trạng thái HTTP; cột thứ hai liệt kê chúng. Có mã không đến dưới dạng một phản hồi lỗi mà nằm bên trong một phản hồi thành công, chẳng hạn một ô của bảng điều khiển không tính được; cột thứ hai ghi trạng thái của những mã đó kèm chú thích "bên trong một phản hồi thành công". Cột Ý nghĩa giữ nguyên văn tiếng Anh như được công bố.
Mã (type) | Trạng thái HTTP | Ý nghĩa |
|---|---|---|
ACTION_NOT_VISIBLE | 403 | The launched action's `visible_when` says this caller may not run it on this record. |
AGENT_ACCESS_DENIED | 403 | Starting a version other than the published one, such as the draft, whose Agent step uses an agent the caller may not use, or any agent for a service principal. |
AGENT_REF_UNRESOLVED | 400 | At run start, an Agent step cannot run: its agent, or a skill that agent binds, is missing, archived or unpublished, or the step does not parse. |
ANALYTICS_CAP_UNBOUNDED_COMPARISON | 422 (bên trong một phản hồi thành công) | A target or threshold comparison over a capped figure that admits no bound in either direction (an average, a median, a ratio, a sum that may hold negatives). |
APP_ACTIVATION_INTERRUPTED | 503 | Activation was cut short (run `prepared` again), or prepare, cancel, decline, enable, disable, arm, detach, undo, start or abandon met an install lock. Retry. |
APP_ARM_REFUSED | 409 | The installation's triggers cannot be armed: each finding names a trigger and what holds it back. Nothing was armed. |
APP_CALLER_REQUIRED | 403 | The operation answers an installed app, and the request did not come through one. Call it with the installed app's token. |
APP_CANDIDATE_OPEN | 409 | The installation already has an open setup candidate, which the response names; continue it or abandon it. |
APP_CATALOG_BACKPORT_REFUSED | 409 | The version is not above every version of the package in the catalog, withdrawn ones included. |
APP_CATALOG_NOT_PUBLISHER | 403 | The caller's organization does not hold the package's publisher prefix, so it cannot withdraw the version. |
APP_CATALOG_PREFIX_HELD | 409 | Another organization publishes under the package's prefix, so this organization cannot submit it. |
APP_CATALOG_PREFIX_RESERVED | 403 | The prefix is reserved for the deployment's verified organization (`af`, `agentflow`, `rfx`, `reflexify`). |
APP_CATALOG_SANDBOX_REFUSED | 403 | A sandbox organization cannot publish to the catalog. |
APP_CATALOG_VERSION_EXISTS | 409 | The catalog already has this version of the package with different content; publish a new version. |
APP_CATALOG_VERSION_WITHDRAWN | 409 | The version was withdrawn from the catalog after the setup chose it; choose the latest published version. |
APP_CEILING_DENIED | 403 | The app this request came through is not approved for this object or operation, or the operation is one an installed app is never offered. |
APP_DEPLOYMENT_NOT_AWAITING | 409 | The deployment is no longer awaiting approval: it was approved, cancelled or superseded; the detail names its status. |
APP_DEPLOYMENT_NOT_FOUND | 404 | No deployment of the organization has this id. |
APP_DEPLOYMENT_PLAN_CHANGED | 409 | The plan made now differs from the one shown; `extensions.plan` and `extensions.plan_hash` are the new plan to review and approve. |
APP_DETACHED | 409 | The run's origin installation is detached or missing; the run cannot continue. |
APP_GRANT_SOURCE_WRITES_DISABLED | 503 | `APP_GRANT_SOURCE_WRITES_ENABLED` is off: a plan that writes grants stays `prepared`, and a decline, detach or undo of an app that has grants is refused. |
APP_IDEMPOTENCY_KEY_REUSED | 409 | The idempotency key already names an install run prepared from a different plan. |
APP_INSTALLATION_BUSY | 409 | The installation cannot be changed now: an unsettled run or a change approved on its setup page holds it, or its setup changed meanwhile. The detail says why. |
APP_INSTALLATION_EXISTS | 409 | The organization already has an installation of this package, which the response names; open a candidate on it instead. |
APP_INSTALLATION_NOT_ACTIVE | 409 | The installation is not installed (it is pending, failed or detached), so the operation does not apply; the detail names its status. |
APP_NOT_ASSIGNED | 403 | The app is installed in this org, but the person is not in its audience; an admin adds them under Apps. |
APP_NOT_INSTALLED | 403 | The app that obtained this token is not installed, or is disabled, in the token's org. |
APP_PACKAGE_PROBLEMS | 422 | Lint found problems in the uploaded package, so it is not stored; `extensions.problems` lists each with its object and path. |
APP_PACKAGE_VERSION_EXISTS | 409 | The organization already holds this version of the package with other content; raise `version` and seal again. |
APP_PLAN_CHANGED | 409 | The plan derived now is not the approved one, or it cannot be approved; the detail names the first difference or finding. |
APP_RELEASE_UNAVAILABLE | 409 | A release of the component is no longer stored or no longer verifies, so the run cannot activate. |
APP_RUN_STILL_BLOCKED | 409 | The run's app is disabled or a pinned version is revoked; repair it before resuming. |
APP_SETUP_INCOMPLETE | 409 | A required setup item is not satisfied, so nothing was prepared. `extensions.items` holds the ids of the items, sorted. |
APP_VERSION_NOT_NEWER | 422 | The organization has this package at a version not below the one asked for, or that version with other content; the detail names both. |
BAD_REQUEST | 400 | The request could not be read. |
BULK_SELECTION_TOO_LARGE | 422 | A batch launch supplied a hand-picked id list above the by-value cap (200) or containing duplicates. |
COMMENTS_CLOSED | 409 | The record's comments are read-only while the entity's closing condition holds on it, so a comment could not be written, edited or deleted. |
COMMENTS_DISABLED | 409 | The record's entity takes no comments, so a comment could not be written, edited or deleted. |
COMMENT_EMPTY | 422 | A comment with neither text nor a file. |
COMMENT_NOT_AUTHOR | 403 | Only the author edits a comment, and only the author or a person who may update the record deletes it. |
COMMENT_NOT_FOUND | 404 | The comment does not exist on this record. |
COMMENT_TOO_LONG | 422 | A comment's text is longer than the limit. |
COMMENT_TOO_MANY_FILES | 422 | A comment names more files than the limit. |
CONFLICT | 409 | The request conflicts with the resource's current state. |
CONNECTION_TEST_FAILED | 400 | The target was unreachable or rejected the credentials; a sandbox create also returns it when a declared connection fails or its shared-account check can't run. |
CURSOR_FILTERS_CHANGED | 400 | The cursor was issued for different filters; start again from the first page. |
CURSOR_INVALID | 400 | The cursor is malformed; start again from the first page. |
CURSOR_SORT_MISMATCH | 400 | The cursor was issued for a different sort; start again from the first page. |
DASHBOARD_FILTER_VALUE_INVALID | 422 | A saved default naming no control, or of a shape its control's kind cannot take. |
DASHBOARD_NOT_FOUND | 404 | The dashboard does not exist, or the caller may not see it. |
DELEGATED_TOKEN_NOT_ACCEPTED | 401 | The token was obtained by another application acting for the person (it carries `act`); only tokens AgentFlow obtained itself are accepted. |
DUPLICATE | 409 | A resource with the same unique name or key already exists, such as two principals of one sandbox's cast with the same name. |
EMAIL_FROM_DOMAIN_UNVERIFIED | 400 | An email connection's From address is on a domain its provider account has not verified. |
ENDPOINT_NOT_PUBLIC | 403 | A service principal's credential or a person's bearer token called an endpoint that is not part of the public API. |
ENTITY_ACCESS_DENIED | 403 | The caller holds the permission, but no grant on this restricted entity allows the change. |
ENTITY_ARCHIVED | 422 | The entity is archived: it takes no new records, no record edits and no work operations. |
ENTITY_ATTACHMENT_INVALID | 422 | A file in the request cannot be attached: the value is malformed or repeats a file, or a file is missing, another organization's, or attached elsewhere. |
ENTITY_ATTACHMENT_SENSITIVE | 403 | The file belongs to a sensitive field; reading it needs a profile that grants that field. |
ENTITY_FIELD_NOT_FOUND | 400, 404, 422 422 (bên trong một phản hồi thành công) | Field `key` resolves to no row in the entity (already removed, or never existed). |
ENTITY_FORMULA_RECOMPUTING | 409 422 (bên trong một phản hồi thành công) | Filter/sort/facet touched a formula field while the entity's stored formula values are being recomputed. |
ENTITY_LAYOUT_FILTER_BINDING_OP_MISMATCH | 422 422 (bên trong một phản hồi thành công) | The binding's arity or type can never satisfy its operator (e.g. `viewer.groups` with `eq`, `today` on a text field). |
ENTITY_LAYOUT_FILTER_BINDING_UNKNOWN | 422 422 (bên trong một phản hồi thành công) | A filter value's `$bind` token is outside the layout binding vocabulary (`viewer.id`, `viewer.groups`, `today`, `record.<field>`). |
ENTITY_LAYOUT_FILTER_INVALID | 422 422 (bên trong một phản hồi thành công) | A related-list block's per-list filter is malformed — too many rules, or a child field that isn't filterable. |
ENTITY_LAYOUT_FILTER_OP_INVALID | 422 422 (bên trong một phản hồi thành công) | The operator isn't valid for the child field's type. |
ENTITY_LAYOUT_STATS_INVALID | 400, 422 422 (bên trong một phản hồi thành công) | A stats block is malformed — too many metrics or aggregate-producing blocks, a function applied to a field type it can't reduce, a `count` carrying a field. |
ENTITY_METRIC_ID_CONFLICT | 422 | A metric save names an id that already belongs to a different entity. |
ENTITY_METRIC_IN_USE | 409 | A metric cannot be deleted while tiles still follow it; the refusal names a count, never a dashboard. |
ENTITY_NATURAL_KEY_CONFLICT | 409 | A create/update would give a record the same natural (business) key as an existing record. |
ENTITY_NOT_BROWSABLE | 403 | List/enumerate requested on an entity with no saved views (nothing to browse). |
ENTITY_NOT_FOUND | 400, 404 | The entity does not exist, or the caller may not see it. |
ENTITY_RECORD_CASCADE_FORBIDDEN | 403 | A relationship's `cascade` or `clear` would reach records the caller may not write. Nothing was written; `extensions.cascade_forbidden` counts them per entity. |
ENTITY_RECORD_CASCADE_TOO_DEEP | 422 | The delete would cascade more relationships deep than the deployment allows. Nothing was written; a cascade is never applied in part. |
ENTITY_RECORD_CASCADE_TOO_LARGE | 422 | The delete would affect more records than the deployment allows, deleted and cleared together. Nothing was written. |
ENTITY_RECORD_IN_USE | 409 | A relationship pointing at the record declares `restrict` (an undeclared one means the same). `extensions.record_in_use` says what is in the way. |
ENTITY_RECORD_NOT_FOUND | 404 | The record does not exist, or the caller may not see it. |
ENTITY_REF_DELETE_BEHAVIOUR_INVALID | 422 | `cascade` on a `reference_list`, which would destroy a record because one of the many references it holds went. |
ENTITY_REF_DELETE_BEHAVIOUR_KEY_MEMBER | 409 | `clear` on a reference that is part of a live alternate key: emptying it would drop the record out of that key's namespace silently. |
ENTITY_REF_DELETE_BEHAVIOUR_REQUIRED | 422 | `clear` on a REQUIRED reference, or `required` set on one carrying `clear`. Either leaves records in a state every write path refuses. |
ENTITY_REF_JOIN_UNSUPPORTED | 400, 422 422 (bên trong một phản hồi thành công) | Sort/filter addressed a target-field of a reference whose target is a system entity (Users/Groups). |
ENTITY_SENSITIVE_FILTER_DENIED | 400, 403, 422 422 (bên trong một phản hồi thành công) | Filter, sort, or text-search referenced a secured field the caller may not read. |
ENTITY_SENSITIVE_WRITE_DENIED | 403 | A record create or change set secured fields the caller may not set; `field_errors` names each one. |
ENTITY_VALIDATION_RULE_FAILED | 422 | A record rule declared on the entity refused the write; the detail is the author's own message. |
ESCALATION_POLICY_INVALID | 422 | An escalation policy needs one to ten well-formed steps under a name the organization does not already use. |
EVENTS_POSITION_EXPIRED | 410 | The caller missed events older than the resume window since this position, or the position is beyond the newest one: refetch what you show, then read from now. |
EVENT_STREAMS_PER_CALLER_EXCEEDED | 429 | The caller already holds six event streams; close one, or retry after the Retry-After delay. |
FEATURE_DISABLED | 404 | The feature is off here: the event stream and presence (`REALTIME_CHANNEL_ENABLED`), apps' UI modules (`APP_MODULES_ENABLED`), or simulation and test-run mode. |
FIELD_NOT_LIST | 422 | An item operation names a field that is not a `list`. |
FILE_SET_MARKER_NEEDS_FOLDER_GRAIN | 422 | A launch bound a marker-bearing set into a workflow that runs one FILE at a time. |
FILE_SET_NO_READY_GROUPS | 422 | A launch bound a set that offers no folder this run may take — everything is still being written, or is held back a pass by a removal, or failed a cap. |
FILE_SET_SLOT_HAS_OTHER_CONSUMERS | 422 | A launch bound a set into a slot the graph reads from somewhere other than the loop. |
FILE_SET_UNATTENDED_START_UNSUPPORTED | 422 | Only a start a person makes can bind a watched folder. |
FORBIDDEN | 403 | The caller is authenticated but may not do this. |
HUMAN_ACTION_NOT_VISIBLE | 403 | The chosen action's `visible_when` says this caller may not take it on this run. |
HUMAN_ACTION_REQUIRED | 400 | `submit_record_step` on a Human step that defines actions, but the payload carried no `_action` selection (or it was blank). |
HUMAN_ACTION_REQUIRES_SIGNATURE | 400 | Direct `submit` of the signature-requiring action — it must complete through the eSign signing flow (prepare → sign → webhook), not `/submit`. |
HUMAN_ACTION_UNKNOWN | 400 | The `_action` in the submit payload matches no action id defined on the human node (stale draft, or a renamed/removed action). |
HUMAN_VIEW_SELECTION_REQUIRED | 400 | `submit_record_step` on a Human step whose embedded entity view is `selectable`. |
HUMAN_VIEW_SELECTION_TOO_MANY | 400 | `submit_record_step` selection exceeds the embedded view's `maxSelection` cap. |
IDEMPOTENCY_KEY_INVALID | 400 | The Idempotency-Key is empty, over 255 characters, sent twice, or not printable ASCII; retrying the same request will not help. |
IDEMPOTENCY_KEY_IN_PROGRESS | 409 | A request with this Idempotency-Key is still running; retry after the Retry-After delay to receive its outcome. |
IDEMPOTENCY_KEY_MISMATCH | 422 | This Idempotency-Key was used with a different request; retrying the same request will not help, so send a new key. |
IDEMPOTENT_RESOURCE_GONE | 410 | The resource this Idempotency-Key created was deleted or is no longer visible; retrying the same request will not help. |
INSTANCE_NOT_FAILED | 409 | `POST /instances/{id}/retry` against an instance that is not in the `failed` state (already running/paused/completed/cancelled). |
INSTANCE_NOT_PAUSED | 409 | The run carries no operator pause to resume. |
INSTANCE_PAUSED | 409 | The run is paused by an operator; resume it first. |
INSTANCE_TOKEN_BUDGET_REMOVED | 400 | instance_token_budget_max is no longer accepted; remove it from the request. |
INTERNAL_ERROR | 500, 503 422 (bên trong một phản hồi thành công) | An unexpected fault. Quote the request id to support. |
INVALID_PATH_PARAMETER | 400 | A path parameter could not be read, such as an id that is not a UUID; `field_errors` names the parameter. |
INVALID_QUERY_PARAMETER | 400 | A query parameter's value is outside what the operation declares, such as a `limit` over the maximum; `field_errors` names it. |
INVALID_TOKEN | 401 | The credential is missing, unknown, revoked or expired. |
LIST_ITEM_NOT_FOUND | 422 | An item operation names an item id the list does not hold. |
MALFORMED_JSON | 400 | The request body is not JSON, or does not match the operation's shape; `field_errors` names the member where it can. |
METHOD_NOT_ALLOWED | 405 | The path exists but does not accept this method. |
NOT_FOUND | 400, 404 | The resource does not exist, or the caller may not see it. |
PACKAGE_ARCHIVE_INVALID | 422 | The ZIP archive is malformed or uses an unsupported layout, entry type or compression encoding. |
PACKAGE_BODY_INVALID | 422 | A packaged object body violates the format rules for its declared kind. |
PACKAGE_CANDIDATE_NOT_ALLOWED | 422 | The candidate release is not found in this organization (it belongs to another organization or does not exist), refused when a release is loaded. |
PACKAGE_DUPLICATE_PATH | 422 | The archive contains more than one entry with the same payload path. |
PACKAGE_ENTITY_RESERVED | 422 | A package requires, or names as the target of one of its objects, an entity the platform keeps for itself, such as the Workflow task entity. |
PACKAGE_HASHES_INVALID | 422 | The package hash envelope has an invalid structure, format version or payload digest. |
PACKAGE_HASHES_NON_CANONICAL | 422 | The hash envelope bytes are not their RFC 8785 canonical JSON representation. |
PACKAGE_IDENTIFIER_INVALID | 422 | A package identifier, object key, version or digest violates its required grammar. |
PACKAGE_JSON_DUPLICATE_PROPERTY | 422 | A package JSON object contains a duplicate decoded property name. |
PACKAGE_JSON_INVALID | 422 | Package JSON is malformed or exceeds the supported nesting or numeric precision rules. |
PACKAGE_LIMIT_EXCEEDED | 422 | A package exceeds the compressed size, entry count or inflated byte limits. |
PACKAGE_MANIFEST_INVALID | 422 | The package manifest violates the supported format schema or cross-field rules. |
PACKAGE_PATH_INVALID | 422 | An archive entry has an unsafe path, filename or filesystem type. |
PACKAGE_PAYLOAD_HASH_MISMATCH | 422 | The canonical payload bytes do not match the digest in the signed hash envelope. |
PACKAGE_PAYLOAD_MISSING | 422 | A payload or envelope entry required by the package is absent. |
PACKAGE_REFERENCE_INVALID | 422 | A package reference uses an invalid sentinel, target, slot type or dependency binding. |
PACKAGE_SIGNATURE_INVALID | 422 | The package's signature entry is missing or malformed. |
PACKAGE_SIGNER_NOT_ALLOWED | 422 | Not produced by this server; kept for older servers, which refused a signer the trusted root did not assign. |
PACKAGE_STORAGE_BACKEND_UNSUPPORTED | 422 | The configured file storage backend cannot safely store and read candidate packages. |
PACKAGE_STORAGE_ERROR | 422 | Candidate archive storage could not be safely read or written; operational details are logged on the server. |
PACKAGE_STORED_ARCHIVE_MISMATCH | 422 | Stored candidate bytes or identity differ from the immutable uploaded archive. |
PACKAGE_TRUST_EXPIRED | 422 | Not produced by this server; kept for older servers, which refused a package once the configured publisher root had expired. |
PACKAGE_UI_FILE_INVALID | 422 | A file under `ui/` has an extension AgentFlow does not serve. |
PACKAGE_UNLISTED_ENTRY | 422 | The archive contains a payload entry not declared by its signed hash envelope or manifest. |
PAUSE_CASCADE_CONTENTION | 409 | The run's lineage kept growing while the pause or resume was applied; nothing changed, so retry. |
PAUSE_NOT_ROOT | 409 | The run is paused as part of a lineage; resume the run the pause started from, named in extensions. |
PAUSE_OWNED_BY_ROOT | 409 | Part of the run's lineage already belongs to another pause; resume that one through its own root first. |
PAYLOAD_TOO_LARGE | 413 | The request body is larger than the operation accepts. |
PERMISSION_DENIED | 403 | The caller's roles, grants or credential scope do not permit this operation. |
PLATFORM_TOO_OLD | 422 | The package needs a newer platform than this deployment runs; the detail names both versions. |
PRECONDITION_REQUIRED | 428 | A write that must name the version it read in `If-Match` named none. |
RETRY_LINEAGE_BLOCKED | 409 | No failed run in the lineage can be retried; each is, or sits above, a run retry cannot resume. |
RETRY_LINEAGE_BUSY | 409 | Every failed run in the lineage waits on a descendant still running; retry once it settles. |
ROUTE_NOT_FOUND | 404 | No operation matches the request's path; check the path against the reference. |
RUN_AS_PRINCIPAL_INACTIVE | 422 | The service principal named by the run-as policy is disabled. |
RUN_AS_UNRESOLVED | 409 | A definition carrying the migrated `unresolved` run-as policy cannot be started on any path until someone decides which principal it runs as. |
SANDBOX_CONNECTION_SHARED | 409 | A connection the sandbox declares uses a provider account that is already connected in another organization, so it cannot be connected here. |
SANDBOX_LIMIT_REACHED | 409 | The organization already holds the most live sandboxes it may; delete one or wait for it to expire. |
SANDBOX_NESTING_REFUSED | 403 | A sandbox cannot create a sandbox. |
SANDBOX_NOT_LIVE | 409 | The sandbox is expired, being deleted or purged, so it accepts no sign-in or request. |
SANDBOX_REQUEST_TIMEOUT | 504 | A request made on the sandbox's behalf outlived its deadline. |
SEARCH_CURSOR_INVALID | 400 | The search cursor is malformed, expired or cannot be authenticated. |
SEARCH_CURSOR_STALE | 409 | The search query, access, schema or physical index changed; restart without a cursor. |
SEARCH_INDEX_NOT_READY | 409 | The complete keyword population is unavailable while its index is building or incompatible. |
SEARCH_QUERY_TIMEOUT | 503 | The exact keyword query exceeded its deadline; narrow it or retry. |
SERVICE_UNAVAILABLE | 503 | The server is temporarily out of capacity; retry after the Retry-After delay. |
SESSION_REVOKED | 401 | The session was signed out at the identity provider; sign in again. |
SLA_POLICY_INVALID | 422 | An SLA policy needs four targets in one base, each between a minute and a year, under a name the organization does not already use. |
STAGE_CONDITION_FAILED | 422 | A write that moves a record between statuses was blocked because the transition's condition evaluated false against the record as the write leaves it. |
STAGE_INITIAL_STATUS_INVALID | 422 | A record was given a status outside the stage model's initial statuses (on create, or when it held none). |
STAGE_REQUIRED_FIELDS_MISSING | 422 | A write that moves a record between statuses omitted one or more fields the transition requires; the response lists the missing fields. |
STAGE_TRANSITION_NOT_ALLOWED | 422 | A status change was refused by the stage model: no such transition, status cleared, engine-only move, no matching mover, or the entity has no stage gates. |
STALE_VERSION | 409 | The version token sent does not match the resource's current version, or what the request acts on changed since it was read; read it again and retry. |
STEP_CONTENT_NOT_SHOWN | 403 | The holder was not shown an installed run's step and its form has a writable bound field, so its draft, signature or submit was refused; nothing was stored. |
STEP_PAYLOAD_INVALID | 422 | A step submit whose payload fails the schema of the form the run froze. |
SUBJECT_BINDING_MISMATCH | 422 | A supplied launch subject does not satisfy the workflow's declared input contract. |
SUBMISSION_VALIDATION | 400, 422 | The submitted form values do not satisfy the form's schema; see field_errors. |
TILE_COMPARE_MEASURE_WINDOW | 422 422 (bên trong một phản hồi thành công) | A compared tile's measure filter reads the clock — a relative window or a `today` binding. |
TILE_COMPARE_WINDOW_AMBIGUOUS | 422 422 (bên trong một phản hồi thành công) | A comparison window named by two coinciding sources of different kinds that would compare differently — refused rather than guessed. |
TILE_DERIVED_ORDER_REQUIRED | 422 422 (bên trong một phản hồi thành công) | A running total over a split with no meaningful order — only a date or datetime bucket orders a series. |
TILE_ENTITY_UNAVAILABLE | 404 (bên trong một phản hồi thành công) | A tile over an entity the reader may not list. |
TILE_EXPRESSION_MEASURE_MISSING | 422 422 (bên trong một phản hồi thành công) | A bare name in a formula that is no measure key on the tile: a key renamed or removed since the formula was written, or a field name. |
TILE_EXPRESSION_VOCABULARY | 422 422 (bên trong một phản hồi thành công) | A formula path outside what a formula may read — a field, a record, an entity, a tile or another bucket. |
TILE_METRIC_ENTITY_MISMATCH | 422 422 (bên trong một phản hồi thành công) | A measure follows a metric belonging to a different entity than the tile measures. |
TILE_METRIC_MISSING | 422 422 (bên trong một phản hồi thành công) | A measure follows an entity metric that no longer exists; it never falls back to the stored inline copy. |
TILE_PATH_TOO_DEEP | 422 422 (bên trong một phản hồi thành công) | A split path traverses more than one relationship hop. |
TILE_PATH_UNRESOLVED | 422 422 (bên trong một phản hồi thành công) | A split names a relationship, field or entity that no longer resolves from the measured entity. |
TILE_RATIO_AVG_REFUSED | 422 422 (bên trong một phản hồi thành công) | An average over a field that declares itself a ratio of two other fields. |
TILE_RATIO_REDUCER_INVALID | 422 422 (bên trong một phản hồi thành công) | A ratio measure whose numerator or denominator uses a non-additive reducer. |
TILE_SPEC_INVALID | 422 422 (bên trong một phản hồi thành công) | A tile specification carries an unknown key, or a shape its kind does not admit. |
TILE_SPLIT_BUCKET_LIMIT | 422 422 (bên trong một phản hồi thành công) | A date-bucketed split whose filled series exceeds the ordered bucket ceiling. |
TILE_STACK_FANS_OUT | 422 422 (bên trong một phản hồi thành công) | A stack by a field a record can land in twice — a multi-value field, a reference list, an inverse relationship or any to-many hop. |
TILE_STACK_MEASURE_INVALID | 422 422 (bên trong một phản hồi thành công) | A stack under a reducer that does not add — an average, a median, an extremum, a distinct count or a ratio — or on a tile carrying more than one measure. |
TILE_VIEW_ENTITY_MISMATCH | 422 422 (bên trong một phản hồi thành công) | A List tile names a saved view belonging to a different entity than the tile declares. |
TILE_VIEW_KIND_INVALID | 422 422 (bên trong một phản hồi thành công) | A List tile names a Detail view — a single record's layout, which renders no rows. |
TILE_VIEW_MISSING | 422 422 (bên trong một phản hồi thành công) | A List tile names a saved view that no longer exists. |
TOKEN_EXPIRED | 401 | The access token has expired; obtain a new one. |
TRANSACTION_CONFLICT | 409 | Two transactions contended and Postgres aborted one. It reaches the wire only once the server's own bounded retry is exhausted. |
UNAUTHORIZED | 401 | The request carries no usable credential. |
UNIT_DESTINATION_DENIED | 422 | The destination unit is not covered by the principal's effective create scope for this entity. |
UNIT_NOT_WRITABLE_HERE | 400, 422 | The unit cannot be set through this surface. |
UNIT_NULL_REFUSED | 422 | An explicit null unit was supplied for an entity that requires classification. |
UNKNOWN_QUERY_PARAMETER | 400 | The request carries a query parameter the operation does not declare; `field_errors` names each one. |
UNSUPPORTED_MEDIA_TYPE | 415 | The request body's content type is not one the operation accepts. |
USER_DEACTIVATED | 401, 403 | The person's account is deactivated. |
USER_IDENTITY_REQUIRED | 403 | The operation acts on a person's own work and needs a person, not a service principal. |
USER_NOT_PROJECTED | 401, 403 | The person has no AgentFlow account in the token's org, and an installed app's token never creates one; they sign in to AgentFlow first. |
VALIDATION_ERROR | 400, 422 422 (bên trong một phản hồi thành công) | The request is well formed but a value in it is not acceptable; see field_errors. |
WEBHOOK_EVENT_NOT_RETAINED | 410 | The event this redelivery names has passed retention, so it can no longer be delivered. |
WEBHOOK_EVENT_TYPE_UNKNOWN | 422 | A webhook subscription names an event type the event catalogue does not list. |
WEBHOOK_PRINCIPAL_INACTIVE | 422 | A webhook subscription names a service principal that is deactivated. |
WEBHOOK_PRINCIPAL_NOT_PERMITTED | 403 | The caller may not name this service principal, redirect its events or rotate its secret: a principal names only itself, a person also needs deployment.admin. |
WEBHOOK_SECRET_ROTATION_LIMIT | 409 | Rotating now would leave more signing secrets in their overlap than this deployment allows; retry once the oldest overlap ends, or rotate with revoke_previous. |
WEBHOOK_URL_EGRESS_DENIED | 422 | A webhook subscription's target resolves to an address this deployment may not send to. |
WEBHOOK_URL_INVALID | 422 | A webhook subscription's target must be an https URL. |
WORKFLOW_STARTS_FROM_TRIGGER | 422 | A manual start of a workflow that starts from an ENABLED trigger. |
WORKFLOW_TASK_LOCKED | 409 | Changing engine-owned Workflow task settings, archiving or deleting its entity, or creating a Workflow task outside the engine. |
WORKFLOW_TASK_OPEN | 409 | Deleting a Workflow task whose step is still open; cancel the run instead. |
WORKFLOW_TASK_SUBJECT_GONE | 409 | A step submit would write bound fields into a subject record that has been deleted; the run must be cancelled. |
WORK_ALREADY_CLAIMED | 409 | Somebody — possibly the caller, on a retry — already holds this work. |
WORK_ASSIGNMENT_RULE_INVALID | 422 | A routing rule or an assignment names an unknown status, a field it may not read, a list past the cap, a manager of a list, or an assignee the resolver refuses. |
WORK_ASSIGNMENT_UNRESOLVED | 422 | The assignment resolves to nobody. |
WORK_CLOCK_INVALID | 422 | A clock's settings are not valid, or a field change would break one. |
WORK_CLOCK_POLICY_MISMATCH | 422 | A clock's escalation policy needs something the entity does not have, such as Work surface, a priority binding or a suitable workflow. |
WORK_CONTRACT_DEPENDENCY | 422 | A work contract was turned on without the contract it depends on. |
WORK_CONTRACT_IN_USE | 409 | A work contract cannot be turned off while records of the entity are live work. |
WORK_CONTRACT_NOT_ENABLED | 409 | The entity does not follow the Assignable contract. |
WORK_CONTRACT_UNKNOWN | 409 | The entity's work settings hold a contract this build does not know, so they cannot be saved from here. |
WORK_FIELD_KEY_TAKEN | 422 | The entity already has its own field under one of the contract's keys. |
WORK_LIFECYCLE_INVALID | 422 | The lifecycle needs an enum status field with every value categorized and at least one active and one done status. |
WORK_NOT_ACTIVE | 409 | The record's work is not live. |
WORK_NOT_CLAIMANT | 403 | The caller does not hold the work: a release with nobody holding it, or a step's draft, submit or signing by anyone but its holder. |
WORK_NOT_ELIGIBLE | 403 | The caller is not a candidate for this work, and the entity lets only candidates claim. |
WORK_POLICY_IN_USE | 409 | A clock uses this policy, so it cannot be deleted. |
WORK_PRIORITY_INVALID | 422 | The priority binding needs an enum field the entity owns that is not secured. |
WORK_REASSIGN_TARGET_INVALID | 422 | Work can only be handed to an active member of the organization. |
WRONG_ORG | 403 | The token names an organization this deployment does not serve. |