---
title: "Update terms"
method: PUT
path: "/terminology/organization/{organizationId}/team/{teamId}"
tags: ["terminology"]
---

# Update terms

`PUT /terminology/organization/{organizationId}/team/{teamId}`

## Request

- Base URL: `https://enterprise-api.writer.com`
- URL: `https://enterprise-api.writer.com/terminology/organization/{organizationId}/team/{teamId}`
- Auth: none required

## Path parameters

- `organizationId` integer, required
- `teamId` integer, required

## Headers

- `Authorization` string, required
- `X-Request-ID` string

## Request body

- UpdateTermsRequest
  - `models` TermUpdate[]
    - `id` integer, required
    - `term` string, required
    - `type` 'approved' | 'banned' | 'pending', required
    - `pos` 'noun' | 'verb' | 'adverb' | 'adjective'
    - `caseSensitive` boolean, required
    - `description` string
    - `highlight` boolean
    - `examples` TermExampleCreate[]
      - `example` string, required
      - `type` 'good' | 'bad', required
    - `mistakes` TermMistakeCreate[]
      - `reference` string
      - `mistake` string, required
      - `pos` 'noun' | 'verb' | 'adverb' | 'adjective'
      - `caseSensitive` boolean, required
    - `tags` TermTagCreate[]
      - `tag` string, required
    - `linkedTerms` LinkedTermCreate[]
      - `reference` string
      - `linkedTermId` integer
    - `approvedTermExtension` ApprovedTermExtensionCreate
      - `capitalize` boolean, required
      - `fixCommonMistakes` boolean, required
      - `fixCase` boolean, required
  - `failHandling` 'accumulate' | 'validate' | 'skip' | 'validateOnly'

## Response `200`

- CreateTermsResponse
  - `models` FullTermWithUser[]
    - `id` integer, required
    - `termBankId` integer, required
    - `term` string, required
    - `type` 'approved' | 'banned' | 'pending', required
    - `pos` 'noun' | 'verb' | 'adverb' | 'adjective'
    - `caseSensitive` boolean, required
    - `description` string
    - `highlight` boolean, required
    - `creationTime` string, date-time, required
    - `modificationTime` string, date-time, required
    - `createdUser` TerminologyUser, required
      - `id` integer, required
      - `fullName` string
      - `email` string
    - `modifiedUser` TerminologyUser, required
      - `id` integer, required
      - `fullName` string
      - `email` string
    - `examples` TermExample[]
      - `id` integer
      - `termId` integer, required
      - `termBankId` integer, required
      - `example` string, required
      - `type` 'good' | 'bad', required
    - `mistakes` TermMistake[]
      - `id` integer
      - `termId` integer, required
      - `termBankId` integer, required
      - `mistake` string, required
      - `pos` 'noun' | 'verb' | 'adverb' | 'adjective'
      - `caseSensitive` boolean, required
    - `tags` TermTagResponse[]
      - `id` integer, required
      - `tag` string, required
      - `termId` integer, required
      - `parentTagId` integer, required
    - `linkedTerms` FullLinkedTerm[]
      - `id` integer
      - `termId` integer, required
      - `linkedTermId` integer, required
      - `term` string, required
      - `pos` 'noun' | 'verb' | 'adverb' | 'adjective'
      - `caseSensitive` boolean, required
      - `approvedTermExtension` ApprovedTermExtension
        - `id` integer
        - `termId` integer, required
        - `capitalize` boolean, required
        - `fixCommonMistakes` boolean, required
        - `fixCase` boolean, required
    - `backlinkedTerms` FullLinkedTerm[]
      - `id` integer
      - `termId` integer, required
      - `linkedTermId` integer, required
      - `term` string, required
      - `pos` 'noun' | 'verb' | 'adverb' | 'adjective'
      - `caseSensitive` boolean, required
      - `approvedTermExtension` ApprovedTermExtension
        - `id` integer
        - `termId` integer, required
        - `capitalize` boolean, required
        - `fixCommonMistakes` boolean, required
        - `fixCase` boolean, required
    - `approvedTermExtension` ApprovedTermExtension
      - `id` integer
      - `termId` integer, required
      - `capitalize` boolean, required
      - `fixCommonMistakes` boolean, required
      - `fixCase` boolean, required
  - `fails` FailMessage[]
    - `description` string, required
    - `key` string, required
    - `extras` unknown, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/writer/apis/writer-enterprise-api.md) - [All operations](https://skmtc.dev/writer/apis/writer-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/writer/apis/writer-enterprise-api/revisions/313187c251a5?raw)