Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ReqRes Legacy API

The Legacy API from ReqRes — 4 operation(s) for legacy.

ReqRes Legacy API is one of 6 APIs that ReqRes publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 16 JSON Schema definitions.

Tagged areas include Legacy. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, pricing, an engineering blog, a JSON-LD context, and 16 JSON Schemas.

This API exposes 8 operations across 4 paths, and defines 9 schemas. It is described by OpenAPI 3.0.3, at version 2.1.0.

Requests are made against 2 base URLs: https://reqres.in, http://localhost:8000.

8 operations 4 paths 9 schemas 1 DELETE4 GET1 PATCH1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.1.0
Base URL
https://reqres.in/
Authentication
API Key, HTTP Bearer
License
Resource Areas
1

Authentication & Security 2

ReqRes Legacy API declares 2 security schemes for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). It accepts HTTP bearer tokens (session_token) (BearerAuth).

Paths & Operations 8

Across 4 paths, the API surfaces 8 operations — 1 DELETE, 4 GET, 1 PATCH, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Legacy 8
GET
/api/users
ReqRes List Users (legacy)
getLegacyUsers 2 params → 200400
POST
/api/users
ReqRes Create User (legacy)
createLegacyUser body → 201400
GET
/api/users/{id}
ReqRes Get User by Id (legacy)
getLegacyUserById 1 param → 200404
PUT
/api/users/{id}
ReqRes Update User (legacy)
updateLegacyUser 1 param body → 200400
PATCH
/api/users/{id}
ReqRes Patch User (legacy)
patchLegacyUser 1 param body → 200400
DELETE
/api/users/{id}
ReqRes Delete User (legacy)
deleteLegacyUser 1 param → 204
GET
/api/unknown
ReqRes List Resources (legacy)
getLegacyUnknown 2 params → 200400
GET
/api/unknown/{id}
ReqRes Get Resource by Id (legacy)
getLegacyUnknownById 1 param → 200404

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are LegacyUnknownListResponse (6 properties), LegacyUserListResponse (6 properties), LegacyUser (5 properties), LegacyUnknown (5 properties). Each schema is shown below with its type and property counts.

LegacyMutationRequest
object
LegacyUser
object
5 properties 5 required
LegacyMutationResponse
object
3 properties
ErrorResponse
object
2 properties 1 required
LegacyUnknown
object
5 properties 5 required
LegacyUserResponse
object
2 properties 1 required
LegacyUserListResponse
object
6 properties 5 required
LegacyUnknownResponse
object
2 properties 1 required
LegacyUnknownListResponse
object
6 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

reqres-legacy-api-openapi.yml Raw ↑

Other APIs ReqRes publishes across the network.

ReqRes Agent Sandbox API
ReqRes App Users API
ReqRes Authentication API
ReqRes Collections API
ReqRes Custom Endpoints API