Errors
Status codes and exact message strings the tools module returns.
Status codes
| Status | When | Exact body |
|---|---|---|
401 | No authenticated user (credentials endpoints) | {"success":false,"message":"Unauthenticated."} |
403 | Assigning another owner without admin rights | {"success":false,"message":"You may only create tools for yourself."} |
403 | Target owner outside your account | {"success":false,"message":"Target user is outside your reseller."} |
403 | Mutating a Global Tool as a non-super-admin | {"success":false,"message":"Global tools are read-only and cannot be edited or deleted."} |
404 | Unknown or out-of-scope tool | {"success":false,"message":"Tool not found"} |
404 | Unknown or unowned credential | {"success":false,"message":"Credential not found."} |
422 | Target owner unknown | {"success":false,"message":"Target user not found."} |
422 | Composition rejected by the live platform | {"success":false,"message":"Tool payload invalid: <detail>"} |
422 | Attaching a draft to assistants | {"success":false,"message":"Publish the tool first — drafts cannot be attached to assistants."} |
422 | Credential auth type differs from the stored one | {"success":false,"message":"Auth type cannot be changed (credential is <type>). Create a new credential instead."} |
422 | Credential missing a per-type required field | e.g. {"success":false,"message":"Token is required."}, "Token URL, Client ID and Client Secret are required.", "Secret Key and Algorithm are required." |
422 | Validation failed | {"message":"…","errors":{…}} — e.g. "Tool name is required.", "Unsupported tool type.", "The tool name may only contain letters, numbers, underscores and dashes.", "Please provide a valid request URL." |
500 | Live write succeeded, local mirror failed | body carries upstream_id for support |
500 | Duplicate failed | {"success":false,"message":"Failed to duplicate tool: <detail>"} |
502 | Live platform write failed (tool store/update/publish, credential create/update/delete) | generic failure message — retry, then contact support |
502 | One or more assistant assignment updates failed | {"success":false,"message":"Some assistants could not be updated: <names>","data":{…}} |
403 | Feature tools not enabled for the account | {"message":"This feature is not enabled for your account. Please contact your administrator.","feature":"tools"} |
Platform-wide 401/409/429 responses are documented once in the Introduction.