API & ModelsIdempotency keyIdempotent request

Idempotency

The property that repeating a request produces the same effect, which is what makes a retry safe to send after a timeout.

Open docs.typesafe.ai All 164 terms

Category: API & Models
Also known as: Idempotency key, Idempotent request
Related terms: 5
Directory entries: 16
Docs: docs.typesafe.ai
Added: 2026-10-12

Definition

An idempotent request can be sent again without changing the outcome, so a client that times out can retry without risking a double effect. A question that only reads a state is naturally idempotent; a request that also triggers an action is not, and needs a key to be deduplicated.

It is the precondition for the retry policies the SDKs apply: retrying is only safe because a repeated decision returns the same answer. When the decision feeds a side effect, put the idempotency in the code that performs the effect, not in the model call.

Tagsapi

Related terms

Definitions that connect to this one.

Retry policyThe SDK configuration for retrying failed requests: attempt count, retryable statuses, backoff, and retry-header handling.API & Models Exponential backoffThe retry strategy the docs recommend for 429 and 529 responses: wait longer after each attempt instead of retrying immediately.API & Models Rate limitThe throughput caps — 250,000 tokens per second and 1,200 requests per minute — that return 429 when exceeded.API & Models API errorThe four documented failure statuses — 401, 422, 429, and 529 — with retry guidance for the last two.API & Models Wire-compatible endpointA local server that accepts POST /v1/systemone and returns Choice, Score, or Noul answers in the documented JSON shape.Ecosystem

From the Jev directory

Python SDK Retries

RetryPolicy for the Python SDK: attempt count, exponential backoff with jitter, which HTTP statuses retry, and a total time budget.

Jev Repos & SDKsDocs#official#docs#sdk

Official

API Reference

The raw HTTP contract behind every SDK: POST a state plus typed noul, choice, and score questions to /v1/systemone, and get one answer per question, with error codes and retry guidance.

Jev Guides & ArticlesDocs#official#docs#api

Official

classifier.dev

A zero-shot text classification service over plain HTTP: send text and a list of labels, get the best-fitting label and a calibrated probability per label, with Jev as the default and fast tier.

Jev Integrations & Adapters#community#api#classification

Community

Decision models on Router+

A router playground that serves several System One decision models from one place: Jev, Perplexity's Decider, Bespoke Nimble, Mercury Decide, Clef, Kev 4B, and Decider 2B, with three of them free.

Jev Integrations & Adapters#community#router#api

Community

JevAPI.dev