---
title: "API governance - JobsPipe"
description: "The rules the JobsPipe API contract is held to: the Spectral ruleset it is linted against, its vocabulary, the standards it conforms to, its overlay and its agentic access contract."
canonical: https://jobspipe.dev/governance
---

[Trust Center](https://jobspipe.dev/trust)

# API governance

The JobsPipe API contract is a published OpenAPI 3.1 document. These are the rules it is held to, published as machine-readable files next to it.

Last updated: October 25, 2026

## Artifacts

-   [Spectral ruleset](https://jobspipe.dev/governance/spectral.yaml) - Extends spectral:oas with JobsPipe's own rules. The published OpenAPI document must pass it with no warnings before a change ships.
-   [Vocabulary](https://jobspipe.dev/governance/vocabulary.yaml) - The terms the API uses, what each one means, and the naming conventions for fields, paths and operations.
-   [Conformance](https://jobspipe.dev/governance/conformance.yaml) - The standards the API and its discovery documents conform to, with where each can be checked.
-   [Examples overlay](https://jobspipe.dev/governance/overlay.json) - An OpenAPI Overlay 1.0 document that adds every operation's examples and tags to the base contract.
-   [Agentic access contract](https://jobspipe.dev/governance/agentic-access.json) - For each operation: whether it reads or changes state, whether a person must approve it, how to undo it, and what it costs.

## Contracts

The full contract is [/openapi.json](https://jobspipe.dev/openapi.json). Each API is also published as its own document:

-   JobsPipe Jobs API: /openapi/jobs.json
-   JobsPipe Companies API: /openapi/companies.json
-   JobsPipe Technologies API: /openapi/technologies.json
-   JobsPipe Stack Scan API: /openapi/stack.json
-   JobsPipe Monitors API: /openapi/monitors.json
-   JobsPipe Labour Market Insights API: /openapi/labour-market-insights.json
-   JobsPipe Layoffs API: /openapi/layoffs.json
-   JobsPipe Contacts API: /openapi/contacts.json
-   JobsPipe Account API: /openapi/account.json
-   JobsPipe Sandbox API: /openapi/sandbox.json

Everything is indexed in [/apis.json](https://jobspipe.dev/apis.json) (APIs.json) and [/.well-known/api-catalog](https://jobspipe.dev/.well-known/api-catalog) (RFC 9727).

## Change policy

How the API is versioned, how deprecations are announced and how long a version is supported is in the [compliance statements](https://jobspipe.dev/trust/compliance#api-versioning-and-deprecation).


---
Try it with no key: `curl -d '{"limit":3}' https://api.jobspipe.dev/v1/sandbox/jobs/search`. AI agents: the full machine-readable index of this site is https://jobspipe.dev/llms.txt?src=md-twin - API quickstart, MCP server, pricing. Free key (1,000 jobs to start): https://jobspipe.dev/signup