# Validation and error codes

All 58 codes the factory API and the workflow validator return, with the message each one carries.

Codes the API returns in `issues[].code` when it refuses a request, and the codes a workflow gets when it is validated for publish or a dry run. The message is the one the Resolve Platform shows; `{node}` is replaced with the step's name.

| Code | Message | Explained in |
|---|---|---|
| <span id="action_conflict"></span>`action_conflict` | In {node}, the event already names the action " | [Triggers and webhook conditions](/software-factory/workflows/triggers.md) |
| <span id="adapter_unavailable"></span>`adapter_unavailable` | In {node}, that model is not one this workflow can use. Choose clef-flash, clef, jev, tev1, pix-fast or a model from your vault. | [Decision node](/software-factory/workflows/nodes/decision.md) |
| <span id="already_decided"></span>`already_decided` |  | [Human approval](/software-factory/decisions/human-approval.md) |
| <span id="approver_missing"></span>`approver_missing` | Name who can approve in {node}. Add a team, a member, a role or the repository admins. | [Human node](/software-factory/workflows/nodes/human.md) |
| <span id="autonomy_above_max"></span>`autonomy_above_max` | autonomy is above autonomy.max ( | [Autonomy levels](/software-factory/control/autonomy.md) |
| <span id="bad_request"></span>`bad_request` |  |  |
| <span id="bad_state"></span>`bad_state` |  | [Runs and steps](/software-factory/runs/runs-and-steps.md) |
| <span id="budget_exceeds_parent"></span>`budget_exceeds_parent` | The run budget is larger than the month budget. Lower the run budget or raise the month budget. | [Budgets](/software-factory/cost/budgets.md) |
| <span id="conclusion_unsupported_event"></span>`conclusion_unsupported_event` | In {node}, the conclusion condition only applies to check runs, check suites, workflow runs and deployment statuses. Remove it or choose one of those events. | [Triggers and webhook conditions](/software-factory/workflows/triggers.md) |
| <span id="crew_not_found"></span>`crew_not_found` | Choose the crew or agent that {node} hands the work to. | [Crew node](/software-factory/workflows/nodes/crew.md) |
| <span id="custom_required"></span>`custom_required` | security.scanners custom needs security.scanners.custom | [Trust and SLSA](/software-factory/evidence/trust-and-slsa.md) |
| <span id="cycle"></span>`cycle` | %s is connected to itself. Remove that connection. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="duplicate_edge"></span>`duplicate_edge` | %s is connected to %s twice for the same outcome. Remove one of the connections. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="duplicate_id"></span>`duplicate_id` | {node} has the id " | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="environment_unsupported_event"></span>`environment_unsupported_event` | In {node}, the environment condition only applies to deployment statuses. Remove it or choose the deployment status event. | [Triggers and webhook conditions](/software-factory/workflows/triggers.md) |
| <span id="firewall_condition_unsupported_source"></span>`firewall_condition_unsupported_source` | In {node}, %s only applies to the %s source. Remove it or change the source. | [Source events and firewall triggers](/software-factory/workflows/source-events.md) |
| <span id="forbidden"></span>`forbidden` |  |  |
| <span id="fork_pr_needs_human"></span>`fork_pr_needs_human` | In {node}, the trigger takes pull requests from forks, and a crew could start without a person approving first. Add an approval step before the crew, or set where the change comes from to the same repository only. | [Human node](/software-factory/workflows/nodes/human.md) |
| <span id="github_calls_exceed_run_cap"></span>`github_calls_exceed_run_cap` | The steps can make %d GitHub calls in one run, more than the cap of %d. Lower the call limit of a step or raise the cap. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="github_rate_limited"></span>`github_rate_limited` |  | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="grant_missing"></span>`grant_missing` |  |  |
| <span id="invalid"></span>`invalid` | unknown route |  |
| <span id="invalid_base"></span>`invalid_base` | In {node}, the base branch must be default, pr_head or the name of a branch. | [Output node](/software-factory/workflows/nodes/output.md) |
| <span id="invalid_enum"></span>`invalid_enum` | In {node}, the choice for %s is not accepted. Choose one of: %s. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="invalid_glob"></span>`invalid_glob` | In {node}, %s has a blank entry. Fill it in or remove it. | [Triggers and webhook conditions](/software-factory/workflows/triggers.md) |
| <span id="invalid_id"></span>`invalid_id` | The id of {node} cannot be used. An id is 1 to 40 letters, digits, dashes or underscores. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="invalid_loop"></span>`invalid_loop` | Only a gate or a decision can send work back to a crew. The connection from %s to %s is not one of those, so it cannot be a loop. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="invalid_outcome"></span>`invalid_outcome` | " | [Decision node](/software-factory/workflows/nodes/decision.md) |
| <span id="invalid_repo"></span>`invalid_repo` | In {node}, the repository for review tickets must be owner/name. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="invalid_type"></span>`invalid_type` | In {node}, %s must be a list of patterns. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="new_to_package_only"></span>`new_to_package_only` | In {node}, "new to the repository" applies to packages only. Set it to the organisation or remove it. | [Scan node](/software-factory/workflows/nodes/scan.md) |
| <span id="no_trigger"></span>`no_trigger` | Add a trigger. A workflow needs something to start it. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="not_found"></span>`not_found` | the trigger's node is no longer in the workflow |  |
| <span id="out_of_range"></span>`out_of_range` | In {node}, %s must be %s from %g to %g (0 keeps the agent's own). | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="package_type_unsupported_event"></span>`package_type_unsupported_event` | In {node}, the package type condition only applies to published packages. Remove it or choose the registry package event. | [Triggers and webhook conditions](/software-factory/workflows/triggers.md) |
| <span id="paths_need_push"></span>`paths_need_push` | In {node}, changed paths can only be checked on a push, because GitHub sends the file list with pushes only. Use the push event or remove the path condition. | [Triggers and webhook conditions](/software-factory/workflows/triggers.md) |
| <span id="permission_missing"></span>`permission_missing` | forge.check_runs needs the App permission checks: write on every managed installation |  |
| <span id="properties_invalid"></span>`properties_invalid` | In {node}, properties must name each custom property with the values it may hold, like {"team": ["payments"]}. |  |
| <span id="provider_not_allowed"></span>`provider_not_allowed` |  |  |
| <span id="required"></span>`required` | In {node}, choose a value for %s. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="review_state_unsupported_event"></span>`review_state_unsupported_event` | In {node}, the review state condition only applies to pull request reviews. Remove it or choose the pull request review event. | [Triggers and webhook conditions](/software-factory/workflows/triggers.md) |
| <span id="revision_conflict"></span>`revision_conflict` |  | [The settings document](/software-factory/control/settings-document.md) |
| <span id="runs_on_invalid"></span>`runs_on_invalid` | In {node}, where the step runs is not set up correctly. Choose Any host, Pix Sandbox, Self-hosted, a host or a host label. | [Crew node](/software-factory/workflows/nodes/crew.md) |
| <span id="scope_unmanaged_repo"></span>`scope_unmanaged_repo` |  | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="severity_unsupported_event"></span>`severity_unsupported_event` | In {node}, the severity condition only applies to Dependabot alerts, code scanning alerts and posture findings. Remove it or choose one of those events. | [Triggers and webhook conditions](/software-factory/workflows/triggers.md) |
| <span id="slug_taken"></span>`slug_taken` |  |  |
| <span id="threshold_adapter_missing"></span>`threshold_adapter_missing` | In {node}, say which model the minimum confidence was set for. Confidence from one model is not comparable with another. | [Decision node](/software-factory/workflows/nodes/decision.md) |
| <span id="threshold_required"></span>`threshold_required` | changing systemone.model needs systemone.min_confidence in the same request | [Decision node](/software-factory/workflows/nodes/decision.md) |
| <span id="too_long"></span>`too_long` | The title of {node} is too long. Use at most 200 characters. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="too_many"></span>`too_many` | In {node}, %s has too many entries. Use at most %d. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="too_many_edges"></span>`too_many_edges` | A workflow holds at most %d connections between steps. Remove some connections or split the work into two workflows. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="too_many_nodes"></span>`too_many_nodes` | A workflow holds at most %d steps. Remove some steps or split the work into two workflows. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="tz_invalid"></span>`tz_invalid` | In {node}, that is not a timezone name. Use a name such as UTC or Australia/Melbourne. | [Schedules](/software-factory/workflows/schedules.md) |
| <span id="unknown_condition"></span>`unknown_condition` | In {node}, "%s" is not a setting of %s. Use only: %s. | [Triggers and webhook conditions](/software-factory/workflows/triggers.md) |
| <span id="unknown_node"></span>`unknown_node` | A connection starts at a step that is not in the workflow ("%s"). Remove the connection. | [Graph limits](/software-factory/workflows/graphs.md) |
| <span id="version_conflict"></span>`version_conflict` |  | [The settings document](/software-factory/control/settings-document.md) |
| <span id="workflows_published"></span>`workflows_published` | persistence.postgres can be off only while no workflow is published | [The settings document](/software-factory/control/settings-document.md) |
| <span id="write_failed"></span>`write_failed` | could not update the Factory budget |  |
