> ## Documentation Index
> Fetch the complete documentation index at: https://swapnice.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Entries and ontologies

> Catalog objects of intent and the field maps that validate them.

An ontology is a versioned field map (`ygo`, `pokemon`, …). An entry is one object a user can show intent toward. You send readable field names; compact internal storage keys are not part of this API.

Use the returned `entry_id` as `object` on events so intents roll up.

## Endpoints in this group

| Method | Path                                                                                        | Scope              |
| ------ | ------------------------------------------------------------------------------------------- | ------------------ |
| `GET`  | [`/v1/ontologies`](/partners/api-reference/ontologies-list)                                 | `ontologies:read`  |
| `GET`  | [`/v1/ontologies/{ontology_id}`](/partners/api-reference/ontologies-get)                    | `ontologies:read`  |
| `POST` | [`/v1/ontologies/{ontology_id}/fields/rebuild`](/partners/api-reference/ontologies-rebuild) | `ontologies:write` |
| `POST` | [`/v1/entries`](/partners/api-reference/entries-upsert)                                     | `entries:write`    |
| `GET`  | [`/v1/entries/{entry_id}`](/partners/api-reference/entries-get)                             | `entries:read`     |
| `PUT`  | [`/v1/entries/{entry_id}`](/partners/api-reference/entries-update)                          | `entries:write`    |

`POST /v1/entries` upserts. `status` is `created`, `updated`, or `unchanged`. Identity fields for that ontology are required.

Guide: [entries and ontologies](/partners/catalog).