---
title: "POST /wordlift/v1/term-matches/{term_id}/matches"
method: POST
path: "/wordlift/v1/term-matches/{term_id}/matches"
tags: ["Term Matches"]
---

# POST /wordlift/v1/term-matches/{term_id}/matches

`POST /wordlift/v1/term-matches/{term_id}/matches`

## Request

- Base URL: `https` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `https/wordlift/v1/term-matches/{term_id}/matches`
- Auth: none declared
- TypeScript: <https://skmtc.dev/insideout10/apis/wordlift-plugin/docs/wordlift/v1/term-matches/:term_id/matches/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a term match for the given term ID.

## Path parameters

- `term_id` integer, required

## Response `201`

Created

- TermMatch
  - `name` string, required: The name of the term
  - `id` integer, required: The ID of the term.
  - `match_name` string, required: The name of the matched term.
  - `match_id` integer, required: The ID of the matched term.
  - `match_jsonld` string: The JSON-LD of the matched term.
  - `occurrences` integer, required: The number of times the term is used.

## Changes

- **2023-07-13** `1cff586b2a8d`: 1 breaking
  - the `match_jsonld` response's property type changed from `object` to `string` for status `201`
- **2023-07-13** `18ae40c3d22f`: 1 info
  - endpoint added
- **2023-04-17** `f968547046e0`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/insideout10/apis/wordlift-plugin/changes/wordlift/v1/term-matches/:term_id/matches/post.md)

---

[API](https://skmtc.dev/insideout10/apis/wordlift-plugin.md) - [All operations](https://skmtc.dev/insideout10/apis/wordlift-plugin/llms.txt) - [OpenAPI document](https://skmtc.dev/insideout10/apis/wordlift-plugin/revisions/00576e6d31eb?raw)