---
title: "Create a new Link. Warning : This is a beta endpoint, the payload / response can change"
method: POST
path: "/links"
tags: ["Document"]
---

# Create a new Link. Warning : This is a beta endpoint, the payload / response can change

`POST /links`

Creates a Link resource.

## Request body

- LinkLinkInputLinkInputCreate
  - `linkType` EmbedLinkTypeInputLinkInputCreate
    - `id` string
  - `origin` EmbedLinkRelationInputLinkInputCreate
    - `id` string
  - `target` EmbedLinkRelationInputLinkInputCreate
    - `id` string
  - `attributes` unknown[] — In this example below, keys are corresponding to attribute control type
    - unknown
  - `sequence` integer

## Response `201`

Link resource created

- LinkLinkOutputLinkOutput
  - `linkType` LinkTypeLinkTypeOutputLinkOutput
    - `id` string — This is the unique identifier of the resource
  - `origin` string
  - `target` string
  - `sequence` integer
  - `attributes` string[]
  - `dateCreated` string, date-time, nullable — This is an ISO datetime
  - `dateModified` string, date-time, nullable — This is an ISO datetime
  - `id` string — This is the unique identifier of the resource
  - `legacyId` integer

## Other responses

- `400` — Invalid input
- `422` — Unprocessable entity

---

[API](https://skmtc.dev/quable/apis/quable-pim-api-documentation-v5.md) · [All operations](https://skmtc.dev/quable/apis/quable-pim-api-documentation-v5/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/quable/quable-pim-api-documentation-v5/revisions/1641096abb34/schema)