Hướng dẫn AgentFlow

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_VISIBLE403The launched action's `visible_when` says this caller may not run it on this record.
AGENT_ACCESS_DENIED403Starting 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_UNRESOLVED400At 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_COMPARISON422 (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_INTERRUPTED503Activation 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_REFUSED409The installation's triggers cannot be armed: each finding names a trigger and what holds it back. Nothing was armed.
APP_CALLER_REQUIRED403The operation answers an installed app, and the request did not come through one. Call it with the installed app's token.
APP_CANDIDATE_OPEN409The installation already has an open setup candidate, which the response names; continue it or abandon it.
APP_CATALOG_BACKPORT_REFUSED409The version is not above every version of the package in the catalog, withdrawn ones included.
APP_CATALOG_NOT_PUBLISHER403The caller's organization does not hold the package's publisher prefix, so it cannot withdraw the version.
APP_CATALOG_PREFIX_HELD409Another organization publishes under the package's prefix, so this organization cannot submit it.
APP_CATALOG_PREFIX_RESERVED403The prefix is reserved for the deployment's verified organization (`af`, `agentflow`, `rfx`, `reflexify`).
APP_CATALOG_SANDBOX_REFUSED403A sandbox organization cannot publish to the catalog.
APP_CATALOG_VERSION_EXISTS409The catalog already has this version of the package with different content; publish a new version.
APP_CATALOG_VERSION_WITHDRAWN409The version was withdrawn from the catalog after the setup chose it; choose the latest published version.
APP_CEILING_DENIED403The 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_AWAITING409The deployment is no longer awaiting approval: it was approved, cancelled or superseded; the detail names its status.
APP_DEPLOYMENT_NOT_FOUND404No deployment of the organization has this id.
APP_DEPLOYMENT_PLAN_CHANGED409The plan made now differs from the one shown; `extensions.plan` and `extensions.plan_hash` are the new plan to review and approve.
APP_DETACHED409The run's origin installation is detached or missing; the run cannot continue.
APP_GRANT_SOURCE_WRITES_DISABLED503`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_REUSED409The idempotency key already names an install run prepared from a different plan.
APP_INSTALLATION_BUSY409The 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_EXISTS409The organization already has an installation of this package, which the response names; open a candidate on it instead.
APP_INSTALLATION_NOT_ACTIVE409The installation is not installed (it is pending, failed or detached), so the operation does not apply; the detail names its status.
APP_NOT_ASSIGNED403The app is installed in this org, but the person is not in its audience; an admin adds them under Apps.
APP_NOT_INSTALLED403The app that obtained this token is not installed, or is disabled, in the token's org.
APP_PACKAGE_PROBLEMS422Lint found problems in the uploaded package, so it is not stored; `extensions.problems` lists each with its object and path.
APP_PACKAGE_VERSION_EXISTS409The organization already holds this version of the package with other content; raise `version` and seal again.
APP_PLAN_CHANGED409The plan derived now is not the approved one, or it cannot be approved; the detail names the first difference or finding.
APP_RELEASE_UNAVAILABLE409A release of the component is no longer stored or no longer verifies, so the run cannot activate.
APP_RUN_STILL_BLOCKED409The run's app is disabled or a pinned version is revoked; repair it before resuming.
APP_SETUP_INCOMPLETE409A required setup item is not satisfied, so nothing was prepared. `extensions.items` holds the ids of the items, sorted.
APP_VERSION_NOT_NEWER422The organization has this package at a version not below the one asked for, or that version with other content; the detail names both.
BAD_REQUEST400The request could not be read.
BULK_SELECTION_TOO_LARGE422A batch launch supplied a hand-picked id list above the by-value cap (200) or containing duplicates.
COMMENTS_CLOSED409The 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_DISABLED409The record's entity takes no comments, so a comment could not be written, edited or deleted.
COMMENT_EMPTY422A comment with neither text nor a file.
COMMENT_NOT_AUTHOR403Only the author edits a comment, and only the author or a person who may update the record deletes it.
COMMENT_NOT_FOUND404The comment does not exist on this record.
COMMENT_TOO_LONG422A comment's text is longer than the limit.
COMMENT_TOO_MANY_FILES422A comment names more files than the limit.
CONFLICT409The request conflicts with the resource's current state.
CONNECTION_TEST_FAILED400The 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_CHANGED400The cursor was issued for different filters; start again from the first page.
CURSOR_INVALID400The cursor is malformed; start again from the first page.
CURSOR_SORT_MISMATCH400The cursor was issued for a different sort; start again from the first page.
DASHBOARD_FILTER_VALUE_INVALID422A saved default naming no control, or of a shape its control's kind cannot take.
DASHBOARD_NOT_FOUND404The dashboard does not exist, or the caller may not see it.
DELEGATED_TOKEN_NOT_ACCEPTED401The token was obtained by another application acting for the person (it carries `act`); only tokens AgentFlow obtained itself are accepted.
DUPLICATE409A 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_UNVERIFIED400An email connection's From address is on a domain its provider account has not verified.
ENDPOINT_NOT_PUBLIC403A service principal's credential or a person's bearer token called an endpoint that is not part of the public API.
ENTITY_ACCESS_DENIED403The caller holds the permission, but no grant on this restricted entity allows the change.
ENTITY_ARCHIVED422The entity is archived: it takes no new records, no record edits and no work operations.
ENTITY_ATTACHMENT_INVALID422A 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_SENSITIVE403The file belongs to a sensitive field; reading it needs a profile that grants that field.
ENTITY_FIELD_NOT_FOUND400, 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_RECOMPUTING409
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_MISMATCH422
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_UNKNOWN422
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_INVALID422
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_INVALID422
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_INVALID400, 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_CONFLICT422A metric save names an id that already belongs to a different entity.
ENTITY_METRIC_IN_USE409A metric cannot be deleted while tiles still follow it; the refusal names a count, never a dashboard.
ENTITY_NATURAL_KEY_CONFLICT409A create/update would give a record the same natural (business) key as an existing record.
ENTITY_NOT_BROWSABLE403List/enumerate requested on an entity with no saved views (nothing to browse).
ENTITY_NOT_FOUND400, 404The entity does not exist, or the caller may not see it.
ENTITY_RECORD_CASCADE_FORBIDDEN403A 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_DEEP422The delete would cascade more relationships deep than the deployment allows. Nothing was written; a cascade is never applied in part.
ENTITY_RECORD_CASCADE_TOO_LARGE422The delete would affect more records than the deployment allows, deleted and cleared together. Nothing was written.
ENTITY_RECORD_IN_USE409A 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_FOUND404The record does not exist, or the caller may not see it.
ENTITY_REF_DELETE_BEHAVIOUR_INVALID422`cascade` on a `reference_list`, which would destroy a record because one of the many references it holds went.
ENTITY_REF_DELETE_BEHAVIOUR_KEY_MEMBER409`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_REQUIRED422`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_UNSUPPORTED400, 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_DENIED400, 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_DENIED403A record create or change set secured fields the caller may not set; `field_errors` names each one.
ENTITY_VALIDATION_RULE_FAILED422A record rule declared on the entity refused the write; the detail is the author's own message.
ESCALATION_POLICY_INVALID422An escalation policy needs one to ten well-formed steps under a name the organization does not already use.
EVENTS_POSITION_EXPIRED410The 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_EXCEEDED429The caller already holds six event streams; close one, or retry after the Retry-After delay.
FEATURE_DISABLED404The 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_LIST422An item operation names a field that is not a `list`.
FILE_SET_MARKER_NEEDS_FOLDER_GRAIN422A launch bound a marker-bearing set into a workflow that runs one FILE at a time.
FILE_SET_NO_READY_GROUPS422A 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_CONSUMERS422A launch bound a set into a slot the graph reads from somewhere other than the loop.
FILE_SET_UNATTENDED_START_UNSUPPORTED422Only a start a person makes can bind a watched folder.
FORBIDDEN403The caller is authenticated but may not do this.
HUMAN_ACTION_NOT_VISIBLE403The chosen action's `visible_when` says this caller may not take it on this run.
HUMAN_ACTION_REQUIRED400`submit_record_step` on a Human step that defines actions, but the payload carried no `_action` selection (or it was blank).
HUMAN_ACTION_REQUIRES_SIGNATURE400Direct `submit` of the signature-requiring action — it must complete through the eSign signing flow (prepare → sign → webhook), not `/submit`.
HUMAN_ACTION_UNKNOWN400The `_action` in the submit payload matches no action id defined on the human node (stale draft, or a renamed/removed action).
HUMAN_VIEW_SELECTION_REQUIRED400`submit_record_step` on a Human step whose embedded entity view is `selectable`.
HUMAN_VIEW_SELECTION_TOO_MANY400`submit_record_step` selection exceeds the embedded view's `maxSelection` cap.
IDEMPOTENCY_KEY_INVALID400The Idempotency-Key is empty, over 255 characters, sent twice, or not printable ASCII; retrying the same request will not help.
IDEMPOTENCY_KEY_IN_PROGRESS409A request with this Idempotency-Key is still running; retry after the Retry-After delay to receive its outcome.
IDEMPOTENCY_KEY_MISMATCH422This Idempotency-Key was used with a different request; retrying the same request will not help, so send a new key.
IDEMPOTENT_RESOURCE_GONE410The resource this Idempotency-Key created was deleted or is no longer visible; retrying the same request will not help.
INSTANCE_NOT_FAILED409`POST /instances/{id}/retry` against an instance that is not in the `failed` state (already running/paused/completed/cancelled).
INSTANCE_NOT_PAUSED409The run carries no operator pause to resume.
INSTANCE_PAUSED409The run is paused by an operator; resume it first.
INSTANCE_TOKEN_BUDGET_REMOVED400instance_token_budget_max is no longer accepted; remove it from the request.
INTERNAL_ERROR500, 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_PARAMETER400A path parameter could not be read, such as an id that is not a UUID; `field_errors` names the parameter.
INVALID_QUERY_PARAMETER400A query parameter's value is outside what the operation declares, such as a `limit` over the maximum; `field_errors` names it.
INVALID_TOKEN401The credential is missing, unknown, revoked or expired.
LIST_ITEM_NOT_FOUND422An item operation names an item id the list does not hold.
MALFORMED_JSON400The request body is not JSON, or does not match the operation's shape; `field_errors` names the member where it can.
METHOD_NOT_ALLOWED405The path exists but does not accept this method.
NOT_FOUND400, 404The resource does not exist, or the caller may not see it.
PACKAGE_ARCHIVE_INVALID422The ZIP archive is malformed or uses an unsupported layout, entry type or compression encoding.
PACKAGE_BODY_INVALID422A packaged object body violates the format rules for its declared kind.
PACKAGE_CANDIDATE_NOT_ALLOWED422The 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_PATH422The archive contains more than one entry with the same payload path.
PACKAGE_ENTITY_RESERVED422A 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_INVALID422The package hash envelope has an invalid structure, format version or payload digest.
PACKAGE_HASHES_NON_CANONICAL422The hash envelope bytes are not their RFC 8785 canonical JSON representation.
PACKAGE_IDENTIFIER_INVALID422A package identifier, object key, version or digest violates its required grammar.
PACKAGE_JSON_DUPLICATE_PROPERTY422A package JSON object contains a duplicate decoded property name.
PACKAGE_JSON_INVALID422Package JSON is malformed or exceeds the supported nesting or numeric precision rules.
PACKAGE_LIMIT_EXCEEDED422A package exceeds the compressed size, entry count or inflated byte limits.
PACKAGE_MANIFEST_INVALID422The package manifest violates the supported format schema or cross-field rules.
PACKAGE_PATH_INVALID422An archive entry has an unsafe path, filename or filesystem type.
PACKAGE_PAYLOAD_HASH_MISMATCH422The canonical payload bytes do not match the digest in the signed hash envelope.
PACKAGE_PAYLOAD_MISSING422A payload or envelope entry required by the package is absent.
PACKAGE_REFERENCE_INVALID422A package reference uses an invalid sentinel, target, slot type or dependency binding.
PACKAGE_SIGNATURE_INVALID422The package's signature entry is missing or malformed.
PACKAGE_SIGNER_NOT_ALLOWED422Not produced by this server; kept for older servers, which refused a signer the trusted root did not assign.
PACKAGE_STORAGE_BACKEND_UNSUPPORTED422The configured file storage backend cannot safely store and read candidate packages.
PACKAGE_STORAGE_ERROR422Candidate archive storage could not be safely read or written; operational details are logged on the server.
PACKAGE_STORED_ARCHIVE_MISMATCH422Stored candidate bytes or identity differ from the immutable uploaded archive.
PACKAGE_TRUST_EXPIRED422Not produced by this server; kept for older servers, which refused a package once the configured publisher root had expired.
PACKAGE_UI_FILE_INVALID422A file under `ui/` has an extension AgentFlow does not serve.
PACKAGE_UNLISTED_ENTRY422The archive contains a payload entry not declared by its signed hash envelope or manifest.
PAUSE_CASCADE_CONTENTION409The run's lineage kept growing while the pause or resume was applied; nothing changed, so retry.
PAUSE_NOT_ROOT409The run is paused as part of a lineage; resume the run the pause started from, named in extensions.
PAUSE_OWNED_BY_ROOT409Part of the run's lineage already belongs to another pause; resume that one through its own root first.
PAYLOAD_TOO_LARGE413The request body is larger than the operation accepts.
PERMISSION_DENIED403The caller's roles, grants or credential scope do not permit this operation.
PLATFORM_TOO_OLD422The package needs a newer platform than this deployment runs; the detail names both versions.
PRECONDITION_REQUIRED428A write that must name the version it read in `If-Match` named none.
RETRY_LINEAGE_BLOCKED409No failed run in the lineage can be retried; each is, or sits above, a run retry cannot resume.
RETRY_LINEAGE_BUSY409Every failed run in the lineage waits on a descendant still running; retry once it settles.
ROUTE_NOT_FOUND404No operation matches the request's path; check the path against the reference.
RUN_AS_PRINCIPAL_INACTIVE422The service principal named by the run-as policy is disabled.
RUN_AS_UNRESOLVED409A definition carrying the migrated `unresolved` run-as policy cannot be started on any path until someone decides which principal it runs as.
SANDBOX_CONNECTION_SHARED409A connection the sandbox declares uses a provider account that is already connected in another organization, so it cannot be connected here.
SANDBOX_LIMIT_REACHED409The organization already holds the most live sandboxes it may; delete one or wait for it to expire.
SANDBOX_NESTING_REFUSED403A sandbox cannot create a sandbox.
SANDBOX_NOT_LIVE409The sandbox is expired, being deleted or purged, so it accepts no sign-in or request.
SANDBOX_REQUEST_TIMEOUT504A request made on the sandbox's behalf outlived its deadline.
SEARCH_CURSOR_INVALID400The search cursor is malformed, expired or cannot be authenticated.
SEARCH_CURSOR_STALE409The search query, access, schema or physical index changed; restart without a cursor.
SEARCH_INDEX_NOT_READY409The complete keyword population is unavailable while its index is building or incompatible.
SEARCH_QUERY_TIMEOUT503The exact keyword query exceeded its deadline; narrow it or retry.
SERVICE_UNAVAILABLE503The server is temporarily out of capacity; retry after the Retry-After delay.
SESSION_REVOKED401The session was signed out at the identity provider; sign in again.
SLA_POLICY_INVALID422An 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_FAILED422A 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_INVALID422A record was given a status outside the stage model's initial statuses (on create, or when it held none).
STAGE_REQUIRED_FIELDS_MISSING422A write that moves a record between statuses omitted one or more fields the transition requires; the response lists the missing fields.
STAGE_TRANSITION_NOT_ALLOWED422A 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_VERSION409The 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_SHOWN403The 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_INVALID422A step submit whose payload fails the schema of the form the run froze.
SUBJECT_BINDING_MISMATCH422A supplied launch subject does not satisfy the workflow's declared input contract.
SUBMISSION_VALIDATION400, 422The submitted form values do not satisfy the form's schema; see field_errors.
TILE_COMPARE_MEASURE_WINDOW422
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_AMBIGUOUS422
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_REQUIRED422
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_UNAVAILABLE404 (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_MISSING422
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_VOCABULARY422
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_MISMATCH422
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_MISSING422
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_DEEP422
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_UNRESOLVED422
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_REFUSED422
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_INVALID422
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_INVALID422
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_LIMIT422
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_OUT422
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_INVALID422
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_MISMATCH422
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_INVALID422
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_MISSING422
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_EXPIRED401The access token has expired; obtain a new one.
TRANSACTION_CONFLICT409Two transactions contended and Postgres aborted one. It reaches the wire only once the server's own bounded retry is exhausted.
UNAUTHORIZED401The request carries no usable credential.
UNIT_DESTINATION_DENIED422The destination unit is not covered by the principal's effective create scope for this entity.
UNIT_NOT_WRITABLE_HERE400, 422The unit cannot be set through this surface.
UNIT_NULL_REFUSED422An explicit null unit was supplied for an entity that requires classification.
UNKNOWN_QUERY_PARAMETER400The request carries a query parameter the operation does not declare; `field_errors` names each one.
UNSUPPORTED_MEDIA_TYPE415The request body's content type is not one the operation accepts.
USER_DEACTIVATED401, 403The person's account is deactivated.
USER_IDENTITY_REQUIRED403The operation acts on a person's own work and needs a person, not a service principal.
USER_NOT_PROJECTED401, 403The 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_ERROR400, 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_RETAINED410The event this redelivery names has passed retention, so it can no longer be delivered.
WEBHOOK_EVENT_TYPE_UNKNOWN422A webhook subscription names an event type the event catalogue does not list.
WEBHOOK_PRINCIPAL_INACTIVE422A webhook subscription names a service principal that is deactivated.
WEBHOOK_PRINCIPAL_NOT_PERMITTED403The 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_LIMIT409Rotating 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_DENIED422A webhook subscription's target resolves to an address this deployment may not send to.
WEBHOOK_URL_INVALID422A webhook subscription's target must be an https URL.
WORKFLOW_STARTS_FROM_TRIGGER422A manual start of a workflow that starts from an ENABLED trigger.
WORKFLOW_TASK_LOCKED409Changing engine-owned Workflow task settings, archiving or deleting its entity, or creating a Workflow task outside the engine.
WORKFLOW_TASK_OPEN409Deleting a Workflow task whose step is still open; cancel the run instead.
WORKFLOW_TASK_SUBJECT_GONE409A step submit would write bound fields into a subject record that has been deleted; the run must be cancelled.
WORK_ALREADY_CLAIMED409Somebody — possibly the caller, on a retry — already holds this work.
WORK_ASSIGNMENT_RULE_INVALID422A 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_UNRESOLVED422The assignment resolves to nobody.
WORK_CLOCK_INVALID422A clock's settings are not valid, or a field change would break one.
WORK_CLOCK_POLICY_MISMATCH422A clock's escalation policy needs something the entity does not have, such as Work surface, a priority binding or a suitable workflow.
WORK_CONTRACT_DEPENDENCY422A work contract was turned on without the contract it depends on.
WORK_CONTRACT_IN_USE409A work contract cannot be turned off while records of the entity are live work.
WORK_CONTRACT_NOT_ENABLED409The entity does not follow the Assignable contract.
WORK_CONTRACT_UNKNOWN409The entity's work settings hold a contract this build does not know, so they cannot be saved from here.
WORK_FIELD_KEY_TAKEN422The entity already has its own field under one of the contract's keys.
WORK_LIFECYCLE_INVALID422The lifecycle needs an enum status field with every value categorized and at least one active and one done status.
WORK_NOT_ACTIVE409The record's work is not live.
WORK_NOT_CLAIMANT403The 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_ELIGIBLE403The caller is not a candidate for this work, and the entity lets only candidates claim.
WORK_POLICY_IN_USE409A clock uses this policy, so it cannot be deleted.
WORK_PRIORITY_INVALID422The priority binding needs an enum field the entity owns that is not secured.
WORK_REASSIGN_TARGET_INVALID422Work can only be handed to an active member of the organization.
WRONG_ORG403The token names an organization this deployment does not serve.