Public validation example

A small API, completely documented.

This owned, synthetic example pairs a machine-readable OpenAPI 3.1 contract with a human-readable reference and copyable requests. It is runnable portfolio proof, not client work.

3operations
4shared schemas
5response examples
0lint errors

Documented surface

GET
/tasks
List tasks with an optional status filter.
POST
/tasks
Create a queued task with validated input.
GET
/tasks/{taskId}
Retrieve a task or a structured 404 response.

Reproduce the lint check

spectral lint openapi.yaml --ruleset .spectral.yaml

Validated with Spectral CLI 6.16.2. The contract returns no lint results at error, warning, information, or hint severity.

Download and inspect

OpenAPI YAML Endpoint reference Sample requests Validation runbook Contra case study
Need this for your own endpoints?

The fixed-price service covers up to 15 endpoints and includes lint-clean OpenAPI 3.1 YAML, a readable reference, and request and response examples grounded in your supplied source.

Order for $25 on Contra →