# How can I retry an AI agent tool call without paying twice? Handle agent tool errors with existing run IDs and idempotency. By [Agentik](/about.md). Updated: 2026-10-19. Before retrying a tool call, determine whether the original operation was rejected, is still pending or may already have consumed provider usage. Agentik exposes run state and documented error handling so the agent can follow the existing execution. A network failure alone does not establish that a paid operation never started. - [Connect your agent](/docs/clients.md) ## Classify the failure before deciding to retry An input validation failure calls for correcting the input. An authorization failure calls for checking workspace authority or account consent. A rate limit calls for the returned retry guidance. These should not all enter a generic “try again” loop. If a request was dispatched but its response is lost, the outcome is uncertain. Preserve the original request identity and inspect the run. Report what is known instead of claiming failure, success or no charge from a client-side exception. ## Keep one identity for one intended execution Use the same idempotency key for the same intended operation according to the documented contract. Persist that identity before dispatch so a process restart does not create an unrelated replacement. A genuinely changed task needs its own reviewed execution plan. Do not imply that idempotency prevents every possible upstream duplicate in every failure mode. Follow the documented retention and conflict behavior, check the existing run and preserve any provider identifiers returned by the tool. ## Report partial work and its cost honestly A provider can consume resources before a later step fails. Review the receipt and any retained reservation alongside the output. A billing question and an unusable deliverable are related but distinct issues to investigate. If an alternative provider is needed, inspect its schema, output and price before continuing. Keep earlier useful evidence, state the missing step and obtain any additional authority required. Do not silently turn recovery into a larger paid workflow. ## What you pay for Supported paid tools use Agentik's prepaid workspace balance. Inspect the selected tool's pricing units and maximum before approving a run; a reservation can differ from its settled charge. Funding fees, taxes and your model's usage are separate. Current terms are on the Pricing and Billing pages linked below. ## Recover from a lost generation response A video submission times out at the client. The correct first action depends on the original operation’s state, not the timeout label alone. Recover from a lost generation response | Observed condition | Next action | | --- | --- | | Validation rejected before execution | Correct the documented input and review scope. | | Run ID known | Retrieve that run and follow its state. | | Response lost after dispatch | Use the original idempotency identity and documented recovery. | | Partial output or charge | Review existing evidence and receipt before proposing more work. | ## A prompt to try [Connect your agent](/docs/clients.md), then use this prompt with your connected assistant. Keep credentials in the authorized connection. ```text Help recover [failed or uncertain Agentik operation]. Use the original run ID, input and idempotency key that I provide. Consult the error and idempotency contracts; ask for missing evidence. Classify validation, authorization, rate-limit, pending and uncertain outcomes. Retrieve the existing run before proposing another paid submission. Report completed output, consumed usage, retained reservations and the exact next step without inventing a refund or success. ``` ## A related workflow [AI video ads](/ai-video-ads.md). Hooks from your niche’s longest-running video ads, objections from YouTube reviews, then frames, clips, a voiceover and music. Example tool-call maximum: at most $3.57. 10 video ads studied and 5 transcripts read, 3 YouTube reviews, one product page, 3 frames and 3 clips of 8 seconds, a 60-word voiceover and 24 seconds of music. This catalog-based reservation maximum belongs to the playbook’s inputs, separately from this guide’s worked example. It is not an executed charge. Optional calls, funding fees, taxes and model usage are excluded. - [adspy/search-creatives](/providers/adspy/search-creatives.md) - [adspy/get-creatives](/providers/adspy/get-creatives.md) - [dataforseo/youtube-search](/providers/dataforseo/youtube-search.md) [View every step, input and tool in the playbook](/ai-video-ads.md). ## Questions ### Does a timeout mean the provider did not run? No. Retrieve the existing execution and follow the documented idempotency and retry behavior. ### Are all failed tool calls free? No. Consumed provider usage can be billable even when the client receives an error or only partial output. ## Sources and next steps Agentik publishes this guide. The editorial update date is 2026-10-19; provider terms and availability can change. - [Errors and retries](/docs/errors.md) - [Idempotency behavior](/docs/idempotency.md) - [Billing settlement](/docs/billing.md) ### Continue with Agentik - [Error reference](/docs/errors.md) - [Idempotency contract](/docs/idempotency.md) - [Async runs](/docs/async.md) ## Related guides - [Long-running tool workflows](/ai-agent-async-tool-workflows.md) - [One balance for your agent's tool calls](/ai-agent-tool-billing.md) - [Control your agent's tool access and spending](/ai-agent-tool-access-control.md) [Browse all agent tool guides](/agent-tool-guides.md) --- [HTML page](/ai-agent-tool-error-handling) · [Agent index](/llms.txt)