The Retry Admissibility API from WritersLogic Verifiable AI Agent Hub — 1 operation(s) for retry admissibility.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/writerslogic-com:writerslogic-com-retry-admissibility-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: WritersLogic Verifiable AI Agent Hub Retry Admissibility API
version: 2.0.0
description: Pay-per-call agents settled in USDC on Base via x402. Every response carries a signed provenance envelope.
contact:
name: WritersLogic
url: https://writerslogic.com/agents
email: agents@writerslogic.com
servers:
- url: https://agents.writerslogic.com
tags:
- name: Retry Admissibility
paths:
/api/v1/retry-admissibility:
post:
operationId: retry_admissibility
summary: Decide whether a failed HTTP call may be retried, must be reconciled, or must…
description: 'Given a request''s method, how it ended (response status, timeout, reset, refused), idempotency-key evidence and optional caller policy, returns retry / do-not-retry / reconcile / unknown for an agent deciding what to do after a failed tool or API call. Encodes RFC 9110 method idempotency, the proxy and retry-of-a-retry rules and Retry-After parsing; a timeout or reset is never read as success or as safe to repeat for a non-idempotent request. status pass = retry is admissible; fail = do-not-retry or reconcile (see decision); unknown = evidence missing. Does not know any vendor''s idempotency-key scope or whether a 429 means unprocessed: those must come from the caller.
Price: 0.005 USDC on Base (x402).'
x-x402-price-usdc: '0.005'
x-x402-amount: '5000'
x-payment-info:
protocols:
- x402
price:
mode: fixed
currency: USD
amount: '0.005'
x-audience: agent-infra
x-sample-url: https://agents.writerslogic.com/api/v1/samples/retry-admissibility
security:
- x402: []
- apiKey: []
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- method
- ended
properties:
method:
type: string
minLength: 1
maxLength: 32
description: HTTP method, case-sensitive (GET, POST, ...).
ended:
type: string
enum:
- response
- timeout
- connection-reset
- connection-refused
- dns-failure
- tls-failure
- aborted-by-client
description: How the attempt ended.
status:
type: integer
minimum: 100
maximum: 599
description: Required when ended is 'response'.
requestSent:
type: string
enum:
- unknown
- not-sent
- sent
description: Whether request bytes reached the network. connection-refused and dns-failure imply not-sent.
idempotencyKey:
type: object
additionalProperties: false
required:
- present
description: 'Caller-asserted evidence: the engine knows no vendor''s key semantics.'
properties:
present:
type: boolean
serverHonors:
type: string
enum:
- 'yes'
- 'no'
- unknown
description: Whether the provider documents that it deduplicates on this key for this operation.
retryAfter:
type: string
maxLength: 100
description: Retry-After header value.
attempt:
type: integer
minimum: 1
maximum: 1000
description: 1-based number of the attempt that just ended. Default 1.
automatic:
type: boolean
description: True when the retry would be issued automatically (library or proxy) rather than by a deliberate decision.
previousAttemptWasAutomaticRetry:
type: boolean
actor:
type: string
enum:
- client
- proxy
asOf:
type: string
maxLength: 40
description: RFC 3339 instant; needed only to turn a Retry-After HTTP-date into seconds.
policy:
type: object
additionalProperties: false
properties:
maxAttempts:
type: integer
minimum: 1
maximum: 1000
maxWaitSeconds:
type: integer
minimum: 0
maximum: 31536000
retryStatuses:
type: array
maxItems: 50
items:
type: integer
minimum: 100
maximum: 599
description: If given, only these statuses may be retried.
notProcessedStatuses:
type: array
maxItems: 50
items:
type: integer
minimum: 100
maximum: 599
description: Statuses the vendor documents as 'rejected before processing'.
example:
method: POST
ended: timeout
requestSent: sent
idempotencyKey:
present: false
responses:
'200':
description: Paid result with provenance
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
status:
type: string
enum:
- pass
- fail
- unknown
- unsupported
description: 'pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass.'
decision:
type: string
enum:
- retry
- do-not-retry
- reconcile
- unknown
reason:
type: string
methodClass:
type: string
enum:
- safe
- idempotent
- non-idempotent
- unknown
delaySeconds:
type: integer
description: Wait before retrying, when Retry-After was readable.
timeoutIsSuccess:
type: boolean
description: Always false.
witnesses:
type: array
items:
type: object
properties:
ruleId:
type: string
detail:
type: string
path:
type: string
description: JSON pointer or dotted path into the input.
offset:
type: integer
index:
type: integer
expected:
description: What the rule required.
actual:
description: What the input had.
versions:
type: object
description: Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile).
limits:
type: array
items:
type: string
deterministic:
type: boolean
description: 'Always true: pure code, no model.'
_provenance:
type: object
description: C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance
required:
- data
- _provenance
'400':
description: Invalid request (no payment consumed)
content:
application/json:
schema:
type: object
properties:
error:
type: string
code:
type: string
'401':
description: Invalid X-API-KEY
content:
application/json:
schema:
type: object
properties:
error:
type: string
code:
type: string
'402':
description: Payment required or invalid
content:
application/json:
schema:
type: object
description: x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)
properties:
x402Version:
type: integer
error:
type: string
code:
type: string
resource:
type: object
accepts:
type: array
items:
type: object
extensions:
type: object
'502':
description: Upstream failure; the payment is released or not settled
content:
application/json:
schema:
type: object
properties:
error:
type: string
code:
type: string
tags:
- Retry Admissibility
components:
securitySchemes:
x402:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 v2 payment payload (base64) sent after a 402 challenge
apiKey:
type: apiKey
in: header
name: X-API-KEY