---
title: "Post Ground"
method: POST
path: "/v3/api/ground"
tags: ["text_annotation"]
---

# Post Ground

`POST /v3/api/ground`

## Request

- Base URL: `https://monarchinitiative.org` (the document declares no server; this is the origin it was published from)
- URL: `https://monarchinitiative.org/v3/api/ground`
- Auth: none declared

## Request body

- TextAnnotationRequest
  - `content` string, required
  - `prefix` string[], nullable
  - `category` EntityCategory[], nullable
  - `include_phenotypes` boolean
  - `include_descendants` boolean

## Response `200`

Successful Response

- Entity[]
  - `id` string, required
  - `category` string, nullable
  - `name` string, nullable
  - `description` string, nullable
  - `xref` string[], nullable
  - `synonym` string[], nullable
  - `exact_synonym` string[], nullable: An exact synonym for the entity
  - `broad_synonym` string[], nullable: A broader synonym for the entity
  - `narrow_synonym` string[], nullable: A narrower synonym for the entity
  - `related_synonym` string[], nullable: A related synonym for the entity
  - `deprecated` boolean, nullable: A boolean flag indicating that an entity is no longer considered current or valid.
  - `in_taxon` string, nullable: The biolink taxon that the entity is in the closure of.
  - `in_taxon_label` string, nullable: The label of the biolink taxon that the entity is in the closure of.
  - `iri` string, nullable
  - `same_as` string[], nullable
  - `subsets` string[], nullable: A list of subsets that the entity belongs to
  - `file_source` string, nullable: Source file stem injected by koza at load time.
  - `provided_by` string, nullable
  - `full_name` string, nullable: The long form name of an entity
  - `symbol` string, nullable
  - `has_gene` string[], nullable
  - `type` string, nullable: The type of the entity (e.g. sequence onotology type for genes etc)
  - `has_attribute` string[], nullable
  - `has_biological_sex` string, nullable: The biological sex of an individual entity.
  - `synonyms` string, nullable
  - `namespace` string, nullable: The namespace/prefix portion of this entity's identifier
  - `has_phenotype` string[], nullable: A list of phenotype identifiers that are known to be associated with this entity
  - `has_phenotype_label` string[], nullable: A list of phenotype labels that are known to be associated with this entity
  - `has_phenotype_count` integer, nullable: A count of the number of phenotypes that are known to be associated with this entity
  - `has_phenotype_closure` string[], nullable: A list of phenotype identifiers that are known to be associated with this entity expanded to include all ancestors
  - `has_phenotype_closure_label` string[], nullable: A list of phenotype labels that are known to be associated with this entity expanded to include all ancestors
  - `has_descendant` string[], nullable: A list of entity identifiers that are known to be descendants of this entity
  - `has_descendant_label` string[], nullable: A list of entity labels that are known to be descendants of this entity
  - `has_descendant_count` integer, nullable: A count of the number of entities that are known to be descendants of this entity

## Other responses

- `404`: Not Found
- `422`: Validation Error

## Changes

- **2026-09-26** `00871419e83e`: 3 info
  - added the new optional request property `include_descendants`
  - added the new optional request property `include_phenotypes`
  - added the new `biolink:ClinicalMeasurement` enum value to the request property `category/anyOf[subschema #1]/items/`
- **2026-07-26** `1dd6862950fc`: 2 info
  - added the new optional request property `category`
  - added the new optional request property `prefix`

[Operation history](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api/changes/v3/api/ground/post.md)

---

[API](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api.md) - [All operations](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api/revisions/00871419e83e?raw)