Primitive GraphQL

Public, read-only GraphQL endpoint returning synthetic sample data. POST a GraphQL query as JSON:

curl -s https://api.primitive.dev/v1/graphql \
  -H 'content-type: application/json' \
  -d '{"query":"{ emails(first:2){ edges{ node{ id subject status } } pageInfo{ hasNextPage endCursor } } }"}'

Introspect the schema with the standard __schema query, or fetch the full SDL as text at https://api.primitive.dev/graphql.graphql. The authenticated REST API at https://api.primitive.dev/v1 is the system of record.

Versioning & deprecation policy

This GraphQL schema is versioned via the apiVersion field (currently v1). Within a version every change is additive and backward-compatible (schema evolution by addition only). Any field scheduled for removal is annotated with the GraphQL @deprecated directive and a concrete removal date, stays available until that date, and is only then dropped. Breaking changes ship under a new version, never silently within v1. The same deprecation policy is documented in the SDL and mirrors the REST API's versioning & deprecation policy.