---
id: link-delete
title: "Delete a link"
description: "Delete a link"
sidebar_label: "Delete a link"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "delete api-method"
info_path: docs/api/nullplatform-api
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Delete a link"}
>
</Heading>

<MethodEndpoint
  method={"delete"}
  path={"/link/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Delete a link

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"schema":{"type":"boolean","default":false},"in":"query","name":"force","required":false,"description":"Specifies whether to force delete the link. If set to true, the link will be deleted without checking for delete action existence"},{"schema":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"in":"path","name":"id","required":true}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing link instances","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"name":{"type":"string","minLength":1,"maxLength":255,"not":{"enum":[null]},"description":"Name of the entity. Must be a non-empty string and not equal to null"},"slug":{"type":"string","minLength":1,"maxLength":255,"not":{"enum":[null]},"description":"Slug of the entity. Automatically generated from \"name\""},"specification_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"desired_specification_id":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"null"}],"description":"Desired unique identifier for the associated specification"},"messages":{"title":"Message","type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["debug","info","information","warn","warning","error","fatal"],"default":"info","description":"Message severity level. Defaults to \"info\""},"message":{"type":"string","description":"The actual message content"},"timestamp":{"type":"number","description":"Timestamp of the message in milliseconds"}},"required":["message"],"additionalProperties":false,"description":"Object representing messages with severity levels"}},"created_at":{"type":"string","format":"date"},"updated_at":{"type":"string","format":"date"},"archived_at":{"type":"string","format":"date","nullable":true,"description":"When the instance was last archived. `null` while the instance is not archived"},"status":{"type":"string","enum":["pending_create","pending","creating","updating","archiving","active","archived","failed","cancelled"],"description":"Status of the link. Should be one of the specified values in the enumeration"},"service_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"dimensions":{"title":"Dimension","type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":100,"not":{"enum":[null]},"description":"Key-value pairs representing dimensions. Each key must be a non-null string with a minimum length of 1"},"description":"Object representing dimensions with key-value pairs"},"attributes":{"type":"object","description":"Attributes associated with the link, should be valid against the link specification attribute schema"},"entity_nrn":{"title":"NRN","type":"string","pattern":"^organization=[0-9*]+(:account=[0-9*]+)?(:namespace=[0-9*]+)?(:application=[0-9*]+)?(:scope=[0-9*]+)?$","description":"Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources"},"selectors":{"title":"Selector","type":"object","properties":{"imported":{"type":"boolean","default":false},"provider":{"type":"string","minLength":1,"maxLength":100,"default":"any"},"category":{"type":"string","minLength":1,"maxLength":100,"default":"any"},"sub_category":{"type":"string","minLength":1,"maxLength":100,"default":"any"}},"additionalProperties":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"description":"Key-value object representing instance selectors"}},"description":"Object representing link instances","additionalProperties":false,"title":"Link","example":{"name":"my-link","service_id":"9548393c-f1d1-4bbc-97a6-c3968862f2a4","specification_id":"5a872c9a-9a16-4a6d-a000-d0e7404a15aa","entity_nrn":"organization=1:account=1:namespace=1:application=1","dimensions":{"environment":"production"},"attributes":{"my_link_attribute":"my_value"}}}}}},"4XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}},"5XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}}}}
>
  
</StatusCodes>