Errors

Every Taxonomy error carries a stable numeric error_code and a machine-readable reason. This page lists the logical (domain) error codes Taxonomy can return. 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	INVALID_ARGUMENT	Organisation cannot be deleted because it has children.
7301004	ORGANISATION_NAME_TOO_LONG	INVALID_ARGUMENT	Organisation name must not exceed 128 characters.
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	INVALID_ARGUMENT	Group cannot be deleted because it has children.
7302007	GROUP_NAME_TOO_LONG	INVALID_ARGUMENT	Group name must not exceed 128 characters.
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.
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.