Error Codes & Logs

Common errors

Code	Meaning	First checks
401 Unauthorized	Invalid or expired token	API key, session, role assignment
403 Forbidden	Insufficient workspace RBAC	Role, workspace membership
404 Not Found	Missing graph, build, or trigger ID	Deploy state, environment assignment
422 Validation Error	Bad trigger payload or tool input	Parameter schema, sample JSON
500 Server Error	Platform or unhandled tool failure	Session logs, retry

403 on registry endpoints may indicate Agent Card policy—not workspace Users RBAC. See Agent Registry.

Debugging workflow

Reproduce with the smallest sample input (trigger payload or tool test JSON).

Open Session logs filtered by Agent Graph and environment.

Inspect tool/graph configuration and env variables.

Verify integration connections for the failing subtool.

When contacting support, include input, expected output, build version, and the error code or log excerpt.

Common errors