---
title: "Update an existing item-link-type"
method: PUT
path: "/api/link-types/{itemLinkTypeId}"
tags: ["CRUD", "Items:Links:Types"]
---

# Update an existing item-link-type

`PUT /api/link-types/{itemLinkTypeId}`

## Request

- Base URL: `https://app.airfocus.com`
- URL: `https://app.airfocus.com/api/link-types/{itemLinkTypeId}`
- Auth: HTTP bearer

Returns updated item-link-type with its sanitised data.<br/><strong>Note:</strong> The following item-link-type IDs are reserved as read-only and will be present on all teams:<br/>- 11111111-1111-1111-1111-111111111111<br/>- 22222222-2222-2222-2222-222222222222<br/>- 33333333-3333-3333-3333-333333333333<br/>Requirements:<br/>- auth-client scopes: "team"<br/>- user role: "admin"<br/>- user permission: "write" or higher

## Path parameters

- `itemLinkTypeId` string, uuid, required

## Request body

- UpdateItemLinkTypeRequest: Custom item link type that defines how items can be related in both directions
  - `backwardsName` string, required: The name of the link type used in the backward direction ("{to} {backwards_name} {from}"), e.g., "is blocked by" in "B-34 is blocked by A-12". Must contain at least one letter or digit.
  - `name` string, required: The name of the link type used in the forward direction ("{from} {name} {to}"), e.g., "blocks" in "A-12 blocks B-34". Must contain at least one letter or digit.

## Response `200`

- ItemLinkTypeRecordWithItemLinkTypeRecordEmbed: Custom item link type that defines how items can be related in both directions
  - `_embedded` ItemLinkTypeRecordEmbed, required
  - `backwardsName` string, required: The name of the link type used in the backward direction ("{to} {backwards_name} {from}"), e.g., "is blocked by" in "B-34 is blocked by A-12". Must contain at least one letter or digit.
  - `id` string, uuid, required
  - `name` string, required: The name of the link type used in the forward direction ("{from} {name} {to}"), e.g., "blocks" in "A-12 blocks B-34". Must contain at least one letter or digit.
  - `teamId` string, uuid, required

## Other responses

- `400`: If path parameters are invalid or payload is invalid or resource does not exist.
- `401`: If missing authentication token.
- `403`: If user does not have the required permission, or user does not match the required role, or authenticated client does not have the required access scopes.
- `default`: If any other error happens.

---

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