---
title: "Updates a Link"
method: PUT
path: "/Organisations/{id}/Links"
tags: ["Organisations"]
---

# Updates a Link

`PUT /Organisations/{id}/Links`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Organisations/{id}/Links`
- Auth: none declared. Required headers: `Authorization`

## Path parameters

- `id` integer, required

## Headers

- `Authorization` string, required

## Request body

- APILinkDto
  - `LINK_ID` integer
  - `OBJECT_NAME` string
  - `OBJECT_ID` integer
  - `LINK_OBJECT_NAME` string
  - `LINK_OBJECT_ID` integer
  - `ROLE` string
  - `DETAILS` string
  - `RELATIONSHIP_ID` integer
  - `IS_FORWARD` boolean

## Response `200`

Request succeeded.

- APILinkDto
  - `LINK_ID` integer
  - `OBJECT_NAME` string
  - `OBJECT_ID` integer
  - `LINK_OBJECT_NAME` string
  - `LINK_OBJECT_ID` integer
  - `ROLE` string
  - `DETAILS` string
  - `RELATIONSHIP_ID` integer
  - `IS_FORWARD` boolean

## Other responses

- `400`: Data validation error.
- `401`: Authentication failed.
- `403`: API User does not have access to Record.
- `404`: Record or Link not found.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)