Troubleshooting

Common errors and how to fix them when integrating with Thirdfy

Common Rejection Reasons

Error / Symptom	Cause	Fix
Invalid API key	API key missing, wrong, or revoked	Get key from Creator Platform Identity tab. Rotate if revoked.
Action not in allowlist	Action not enabled for your agent	Run `GET /api/v1/agent/actions?agentApiKey=YOUR_KEY` to see allowed actions. Enable in Creator Platform Actions tab.
Params mismatch	`params` don't match action schema	Check `paramsSchema` from `GET /api/v1/agent/actions`. Ensure required fields present and types correct.
Amount limit exceeded	`estimatedAmountUsd` exceeds policy	Reduce amount or request limit increase. Check policy/mandate.
Runtime not bound	Package files missing	Upload `skill.json`, `skill.md`, `heartbeat.md`, `openapi.json` in Creator Platform Skills tab.
No actions returned	Agent not claimed or actions not enabled	Complete onboarding. Enable actions in Creator Platform. Run `GET /api/v1/agent/onboarding/me/actions`.
Intent rejected (generic)	Policy, mandate, or validation failed	Check: API key valid, action allowed, params correct, amount within limits. See Execute Intents.

API key — Valid? Not revoked? From Identity tab?
Actions — Is your action in the allowlist? GET /api/v1/agent/actions?agentApiKey=YOUR_KEY
Params — Match schema? Required fields present?
Environment — THIRDFY_API_URL and THIRDFY_AGENT_API_KEY set correctly?