llms.txt Content
# Resolve — Agent Error Resolution API
## What it is
Resolve is a lookup API for autonomous agents. When your agent encounters an error from an external API (OpenAI, Stripe, Postgres, etc.), call Resolve to get structured guidance: whether to retry, how long to wait, and what action to take.
It removes the need to hardcode retry logic for every API your agent depends on.
## Base URL
https://resolve.arflow.io
## When to use Resolve
Use Resolve when your agent encounters an error from an external service and needs to decide:
- Should I retry this request?
- If so, how long should I wait?
- Is this a temporary condition or a hard stop?
- What's the right action (retry, escalate, switch models, check billing, etc.)?
Resolve is useful for agents that call multiple external APIs and need consistent, maintained error-handling behavior without maintaining their own lookup tables.
## Covered services (20 as of March 2026)
anthropic, aws, cloudflare, discord, docker, gemini, github, huggingface, linear, openai, opensrs, pinecone, postgres, redis, resend, sendgrid, shopify, stripe, supabase, twilio
## Core endpoint
POST /resolve
Request:
```json
{
"service": "openai",
"error_code": "429",
"message": "Rate limit exceeded on tokens per minute",
"agent_id": "your-agent-id"
}
```
Response:
```json
{
"id": "uuid",
"service": "openai",
"error_code": "429",
"category": "rate_limit",
"confidence": 0.97,
"resolution": {
"action": "backoff_and_retry",
"max_retries": 5,
"backoff_seconds": [1, 2, 4, 8, 16],
"backoff_strategy": "exponential",
"notes": "Switch to lower-tier model if retry budget exhausted."
}
}
```
Only `service` is required. Include `error_code` for exact matching (fastest, highest confidence). Include `message` for pattern matching when no exact code match exists.
## Resolution categories
- `rate_limit` — backoff and retry
- `auth` — do not retry, fix credentials first
- `payment` — do not retry (max_retri
OpenAPI Spec (preview)
{
"openapi": "3.1.0",
"info": {
"title": "Resolve — Agent Error Resolution API",
"version": "1.0.0",
"description": "Resolve maps API error codes to structured resolution guidance for autonomous agents. Given a service name and error code, it returns a categorized resolution with retry strategy, backoff parameters, and action steps — so agents can recover from errors without human intervention.\n\nCoverage: 52+ error patterns across 20 services including OpenAI, Anthropic, St