---
title: "Save a new glossary entry"
method: POST
path: "/rest/glossary/{version}/create"
tags: ["glossary"]
---

# Save a new glossary entry

`POST /rest/glossary/{version}/create`

## Request

- Base URL: `https://api.seer.cancer.gov`
- URL: `https://api.seer.cancer.gov/rest/glossary/{version}/create`
- Auth: API key in header `X-SEERAPI-Key`
- TypeScript: <https://skmtc.dev/cancer/apis/seer-api/docs/rest/glossary/:version/create/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `version` string, required

## Request body

- Glossary: Glossary entity
  - `id` string
  - `name` string
  - `version` string
  - `hidden` boolean
  - `status` string
  - `assigned_to` string
  - `first_published` string, date-time
  - `last_modified` string, date-time
  - `fingerprint` string
  - `note` string
  - `field_notes` object
  - `score` number, double
  - `glossary` ApiKeywordMatch[]
    - `id` string
    - `name` string
    - `keyword` string
    - `category` string[]
    - `start` integer
    - `end` integer
  - `definition` string
  - `alternate_name` string[]
  - `abstractor_note` string
  - `histology` string[]
  - `primary_site` string[]
  - `category` string[]
  - `subcategory` string[]
  - `resource` GlossaryResource[]
    - `name` string
    - `subtitle` string
    - `reference_type` string
    - `url` string
    - `edition` string
    - `year` string
    - `page` string
    - `citation` string

## Response `201`

Success

- Glossary: Glossary entity
  - `id` string
  - `name` string
  - `version` string
  - `hidden` boolean
  - `status` string
  - `assigned_to` string
  - `first_published` string, date-time
  - `last_modified` string, date-time
  - `fingerprint` string
  - `note` string
  - `field_notes` object
  - `score` number, double
  - `glossary` ApiKeywordMatch[]
    - `id` string
    - `name` string
    - `keyword` string
    - `category` string[]
    - `start` integer
    - `end` integer
  - `definition` string
  - `alternate_name` string[]
  - `abstractor_note` string
  - `histology` string[]
  - `primary_site` string[]
  - `category` string[]
  - `subcategory` string[]
  - `resource` GlossaryResource[]
    - `name` string
    - `subtitle` string
    - `reference_type` string
    - `url` string
    - `edition` string
    - `year` string
    - `page` string
    - `citation` string

## Other responses

- `400`: Invalid input
- `404`: Unknown version

---

[API](https://skmtc.dev/cancer/apis/seer-api.md) - [All operations](https://skmtc.dev/cancer/apis/seer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cancer/apis/seer-api/revisions/2ab11538b3c7?raw)