InfiniteRanks documentation

List saved prompts and their latest revisions

The prompts resource returns saved question records with latest revision and tag information. Reading it does not start collection.

InfiniteRanks editorial team

Supported request

GET /api/v1/prompts?limit=50 on https://app.infiniteranks.com with an Authorization: Bearer <read-only-key> header. Prompt records contain id, state, createdAt, revisions and tags. The selected revisions array contains the latest saved revision, including id, version, text, topic and createdAt.

A practical client workflow

Paginate until nextCursor is null and keep the prompt ID separate from its revision ID. Use answer observation revision metadata when explaining an older capture, not simply the current prompt text.

Limits and interpretation

The latest revision in the prompt library may differ from the revision measured by a historical answer. Do not rewrite the meaning of older observations by joining only current wording. For list resources, use limit from 1 to 100 and continue with nextCursor. Keep raw record identifiers when presenting derived metrics.

Credential and error handling

Keep the key in trusted client or server configuration. It reads only its assigned workspace. Handle authentication failures without retry loops and respect Retry-After when the workspace request allowance is reached. Reading saved records does not trigger a paid provider call.

Sources and further reading

Sources explain the underlying standards. They do not endorse InfiniteRanks or guarantee a ranking outcome.

Be part of the conversation.

Explore a model response with your own provider key.