Errors

Every Taxonomy error carries a stable numeric error_code and a machine-readable reason. This page lists the logical error codes Taxonomy can return, across its domain groups (7_3xx) and infrastructure groups (7_6xx). For the full error envelope (the google.rpc.Status shape, the reason and metadata fields, and how codes are structured) see Errors.

Taxonomy codes begin with 7 (for example 7301001, read as 7_301_001: service, group, specific error). The wire value is always the flat integer; you can match on either error_code or reason, both are stable.

The Status column is the canonical gRPC status the error maps to, which the gateway renders as the matching HTTP status (see the status codes table).

Code	Reason	Status	Description
7301001	ORGANISATION_NAME_IS_BLANK	INVALID_ARGUMENT	Organisation name must not be blank.
7301002	ORGANISATION_OWNER_USER_ID_IS_BLANK	INVALID_ARGUMENT	Organisation owner_user_id must not be blank.
7301003	ORGANISATION_HAS_CHILDREN	FAILED_PRECONDITION	Organisation cannot be deleted because it has children.
7301004	ORGANISATION_NAME_TOO_LONG	INVALID_ARGUMENT	Organisation name must not exceed 128 characters.
7301005	ORGANISATION_NAME_NOT_VALID	INVALID_ARGUMENT	Organisation name must be valid: lowercase letters, digits and hyphens, starting with a letter and ending with a letter or digit.
7301006	ORGANISATION_DISPLAY_NAME_IS_BLANK	INVALID_ARGUMENT	Organisation display name is required.
7301007	ORGANISATION_DISPLAY_NAME_TOO_LONG	INVALID_ARGUMENT	Organisation display name must not exceed 128 characters.
7301008	ORGANISATION_DISPLAY_NAME_NOT_VALID	INVALID_ARGUMENT	Organisation display name must not contain control characters.
7301009	ORGANISATION_NAME_ALREADY_EXISTS	ALREADY_EXISTS	An organisation with this name already exists.
7301010	ORGANISATION_NAME_IS_RESERVED	INVALID_ARGUMENT	Organisation name is reserved by the platform.
7301011	ORGANISATION_HAS_UNARCHIVED_CHILDREN	FAILED_PRECONDITION	Organisation cannot be archived because it contains resources that are not archived. Archive them, or repeat the request with force.
7301012	ORGANISATION_HAS_SUSPENDED_DESCENDANT	FAILED_PRECONDITION	Organisation cannot be archived because it contains a suspended resource, which force does not override. A platform administrator must resume it first.
7302001	GROUP_NAME_IS_BLANK	INVALID_ARGUMENT	Group name must not be blank.
7302002	GROUP_ORGANISATION_ID_NOT_VALID	INVALID_ARGUMENT	Group organisation ID is required and must be a valid ID.
7302003	GROUP_SELF_PARENTING	INVALID_ARGUMENT	A group cannot be its own parent.
7302004	GROUP_CYCLE_DETECTED	INVALID_ARGUMENT	Moving this group would create a cycle in the hierarchy.
7302005	GROUP_MAX_DEPTH_EXCEEDED	INVALID_ARGUMENT	Group nesting exceeds the maximum allowed depth.
7302006	GROUP_HAS_CHILDREN	FAILED_PRECONDITION	Group cannot be deleted because it has children.
7302007	GROUP_NAME_TOO_LONG	INVALID_ARGUMENT	Group name must not exceed 128 characters.
7302008	GROUP_NAME_NOT_VALID	INVALID_ARGUMENT	Group name must be valid: lowercase letters, digits and hyphens, starting with a letter and ending with a letter or digit.
7302009	GROUP_DISPLAY_NAME_IS_BLANK	INVALID_ARGUMENT	Group display name is required.
7302010	GROUP_DISPLAY_NAME_TOO_LONG	INVALID_ARGUMENT	Group display name must not exceed 128 characters.
7302011	GROUP_DISPLAY_NAME_NOT_VALID	INVALID_ARGUMENT	Group display name must not contain control characters.
7302012	GROUP_NAME_ALREADY_EXISTS	ALREADY_EXISTS	A group with this name already exists under the same parent.
7302013	GROUP_DESCRIPTION_NOT_VALID	INVALID_ARGUMENT	Group description must be at most 1024 characters and carry no control or bidirectional characters.
7302014	GROUP_HAS_UNARCHIVED_CHILDREN	FAILED_PRECONDITION	Group cannot be archived because it contains resources that are not archived. Archive them, move them out of this group, or repeat the request with force.
7302015	GROUP_HAS_SUSPENDED_DESCENDANT	FAILED_PRECONDITION	Group cannot be archived because it contains a suspended resource, which force does not override. Ask a platform administrator to resume it, or move it out of this group.
7303001	WORKSPACE_NAME_IS_BLANK	INVALID_ARGUMENT	Workspace name must not be blank.
7303002	WORKSPACE_ORGANISATION_ID_NOT_VALID	INVALID_ARGUMENT	Workspace organisation ID is required and must be a valid ID.
7303003	WORKSPACE_GROUP_ID_NOT_VALID	INVALID_ARGUMENT	Workspace group ID is not a valid identifier.
7303004	WORKSPACE_NAME_TOO_LONG	INVALID_ARGUMENT	Workspace name must not exceed 128 characters.
7303005	WORKSPACE_NAME_NOT_VALID	INVALID_ARGUMENT	Workspace name must be valid: lowercase letters, digits and hyphens, starting with a letter and ending with a letter or digit.
7303006	WORKSPACE_DISPLAY_NAME_IS_BLANK	INVALID_ARGUMENT	Workspace display name is required.
7303007	WORKSPACE_DISPLAY_NAME_TOO_LONG	INVALID_ARGUMENT	Workspace display name must not exceed 128 characters.
7303008	WORKSPACE_DISPLAY_NAME_NOT_VALID	INVALID_ARGUMENT	Workspace display name must not contain control characters.
7303009	WORKSPACE_NAME_ALREADY_EXISTS	ALREADY_EXISTS	A workspace with this name already exists in the organisation.
7304001	OPERATION_PROGRESS_OUT_OF_RANGE	INVALID_ARGUMENT	Operation progress must be between 0 and 100 inclusive.
7304002	OPERATION_END_TIME_BEFORE_START_TIME	INVALID_ARGUMENT	Operation end time must not be before start time.
7304003	OPERATION_SCOPE_TYPE_NOT_VALID	INVALID_ARGUMENT	Operation scope type is not valid.
7305001	UNKNOWN_TAXONOMY_RESOURCE_STATE	INVALID_ARGUMENT	Unknown taxonomy resource state.
7305002	TAXONOMY_STATE_TRANSITION_NOT_ALLOWED	FAILED_PRECONDITION	Taxonomy resource state transition not allowed.
7305003	TAXONOMY_RESOURCE_NOT_ARCHIVED	FAILED_PRECONDITION	Taxonomy resource must be archived before it can be deleted.
7305004	TAXONOMY_RESOURCE_NOT_MARKED_FOR_DELETION	FAILED_PRECONDITION	Taxonomy resource is not marked for deletion.
7305005	TAXONOMY_PARENT_NOT_ACTIVE	FAILED_PRECONDITION	Taxonomy parent resource is not active.
7305006	TAXONOMY_HIERARCHY_ORGANISATION_MISSING	DATA_LOSS	Taxonomy hierarchy is inconsistent.
7305007	UNKNOWN_STATE_CHANGE_ORIGIN	INVALID_ARGUMENT	Unknown taxonomy state change origin.
7305008	PLATFORM_OWNED_LIFECYCLE_REFUSED	FAILED_PRECONDITION	A platform-owned taxonomy resource has no lifecycle verbs.
7306001	ACCESSIBLE_SCOPE_SET_INCOMPLETE	FAILED_PRECONDITION	The listing refused to reason about an accessible-scope set larger than the configured ceiling.
7306004	CALLER_SCOPED_GRANT_MISSING	DATA_LOSS	A caller-scoped listing ran with no grant for the permission it narrows by.
7307001	WORKSPACE_QUOTA_EXCEEDED	RESOURCE_EXHAUSTED	The workspace quota for this organisation has been exhausted.
7307002	QUOTA_NOT_FOUND	NOT_FOUND	Quota not found.
7307003	QUOTA_OVERRIDE_NOT_FOUND	NOT_FOUND	Quota override not found.
7307004	QUOTA_OVERRIDE_ALREADY_EXISTS	ALREADY_EXISTS	A quota override already exists for this scope.
7307005	QUOTA_METRIC_NOT_VALID	INVALID_ARGUMENT	Quota metric must be three lowercase segments separated by slashes, e.g. taxonomy/organisation/workspaces.
7307006	QUOTA_DISPLAY_NAME_NOT_VALID	INVALID_ARGUMENT	Quota display name is required and must not exceed ${DisplayName.MAX_LENGTH} characters.
7307007	QUOTA_DESCRIPTION_NOT_VALID	INVALID_ARGUMENT	Quota description must not exceed ${Description.MAX_LENGTH} characters.
7307008	QUOTA_DEFAULT_LIMIT_NOT_VALID	INVALID_ARGUMENT	Quota default limit must be greater than zero.
7307009	QUOTA_REFRESH_INTERVAL_NOT_VALID	INVALID_ARGUMENT	A rate quota requires a refresh interval and an allocation quota must not have one.
7307010	QUOTA_OVERRIDE_EFFECTIVE_LIMIT_NOT_VALID	INVALID_ARGUMENT	Quota override effective limit must be greater than zero.
7307011	QUOTA_OVERRIDE_SCOPE_NOT_VALID	INVALID_ARGUMENT	Quota override scope ID is required and must be a valid ID.
7307012	QUOTA_NOT_ADJUSTABLE	FAILED_PRECONDITION	This quota does not accept an override.
7307013	QUOTA_OVERRIDE_SCOPE_TYPE_NOT_VALID	INVALID_ARGUMENT	Quota override scope type must be the scope type the quota applies at.
7307014	QUOTA_OVERRIDE_SCOPE_TYPE_NOT_SUPPORTED	UNIMPLEMENTED	Quota override scope type is required and must be a supported scope type.
7307015	QUOTA_NAME_NOT_VALID	INVALID_ARGUMENT	Quota name must be a lowercase handle of letters, digits and single hyphens.
7308001	TAXONOMY_SUBTREE_TOO_LARGE	FAILED_PRECONDITION	The scope holds more resources than one lifecycle transition may change in a single transaction. Transition a smaller part of the tree, or ask an operator to raise the ceiling.
7309001	CHILD_SCOPE_COUNT_IS_AMBIGUOUS	DATA_LOSS	The number of groups and workspaces inside an organisation or group was reported twice for the same lifecycle state.
7309002	CHILD_SCOPE_COUNT_IS_NEGATIVE	DATA_LOSS	The number of groups and workspaces inside an organisation or group cannot be negative.
7601001	ORGANISATION_NOT_FOUND	NOT_FOUND	Organisation was not found in the repository.
7601002	GROUP_NOT_FOUND	NOT_FOUND	Group was not found in the repository.
7601003	WORKSPACE_NOT_FOUND	NOT_FOUND	Workspace was not found in the repository.
7601004	OPERATION_NOT_FOUND	NOT_FOUND	Operation was not found in the repository.
7601005	UNKNOWN_SCHEMA_VERSION	DATA_LOSS	Schema version is not recognized.
7601006	UNKNOWN_QUOTA_UNIT	DATA_LOSS	Quota unit is not recognized.
7601007	UNKNOWN_QUOTA_TYPE	DATA_LOSS	Quota type is not recognized.
7602001	UNKNOWN_INTEGRATION_VERSION	INVALID_ARGUMENT	The integration version is not recognized.
7602002	CALLER_PRINCIPAL_NOT_RESOLVED	UNAUTHENTICATED	The calling principal or its type could not be resolved.
7602003	MALFORMED_IAM_SCOPE_ACCESS_RESPONSE	DATA_LOSS	The IAM scope-access response is malformed.