---
title: "Retrieve or search item-link-types"
method: POST
path: "/api/link-types/search"
tags: ["CRUD", "Items:Links:Types"]
---

# Retrieve or search item-link-types

`POST /api/link-types/search`

## Request

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

Returns all item-link-types or searches item-link-types by query. Always returns only item-link-types which are accessible by the current user.<br/>Requirements:<br/>- auth-client scopes: "team:read"<br/>- user permission: "read" or higher

## Query parameters

- `offset` integer
- `limit` integer
- `from` integer
- `to` integer

## Request body

- ItemLinkTypeSearchQuery
  - `nameFilter` string

## Response `200`

- ItemLinkTypeRecordWithItemLinkTypeRecordEmbedPage
  - `items` ItemLinkTypeRecordWithItemLinkTypeRecordEmbed[], required
    - `_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
  - `totalItems` integer, required

## Other responses

- `400`: If payload is invalid.
- `401`: If missing authentication token.
- `403`: If user does not have the required permission, 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)