API Documentation

GET /api/find?id=[$id]

Looks up a JSON schema by its $id value.

Parameters

• id: The $id value of a JSON schema

Response

A JSON object containing a "data" object with the following property:

• url: A URL to the matching definition file

{
  "data": {
    "url": "https://example.com/schema.json"
  }
}

Response

A JSON object containing a "data" object with the following proprties:

• id: The created schema's ID
• url: A URL for the schema on Schemas.Pub

{
  "data": {
    "url": "https://schemas.pub/schemas/30/definition/341"
  }
}

POST /api/schemas

Creates a new schema.

Body

The body of your request should be a Schemas.Pub manifest.

Response

A JSON object containing a "data" object with the following proprties:

• id: The schema's ID
• url: A URL for the schema on Schemas.Pub

{
  "data": {
    "id": 30,
    "url": "https://schemas.pub/schemas/30"
  }
}

PUT /api/schemas/[schema_id]

Updates the specified schema.

Body

The body of your request should be a Schemas.Pub manifest.

Response

A JSON object containing a "data" object with the following proprties:

• id: The schema's ID
• url: A URL for the schema on Schemas.Pub

{
  "data": {
    "id": 30,
    "url": "https://schemas.pub/schemas/30"
  }
}