---
id: link-specification-delete
title: "Delete a link specification"
description: "Delete a link specification"
sidebar_label: "Delete a link specification"
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 specification"}
>
</Heading>

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



Delete a link specification

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

<ParamsDetails
  parameters={[{"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 specifications","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,"not":{"enum":[null]},"description":"Name of the entity. Must be a non-empty string and not equal to null"},"slug":{"type":"string","minLength":1,"not":{"enum":[null]},"description":"Slug of the specification. Automatically generated from \"name\""},"created_at":{"type":"string","format":"date"},"updated_at":{"type":"string","format":"date"},"visible_to":{"title":"Visibility","type":"array","description":"Array representing visibility settings for the entity. Specifies what/who can see this entity","items":{"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"}},"unique":{"type":"boolean","description":"Indicates whether the service can be linked only once by an instance of this link specification"},"specification_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"dimensions":{"title":"Specification Dimension","type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"required":{"type":"boolean"},"values":{"type":"array","items":{"type":"string"}}},"additionalProperties":false,"required":["required"]}},"scopes":{"title":"Specification Scope","type":"object","properties":{"provider":{"type":"object","properties":{"values":{"type":"array","items":{"oneOf":[{"type":"string","enum":["AWS:SERVERLESS:LAMBDA","AWS:WEB_POOL:EC2INSTANCES","AWS:WEB_POOL:EKS","AZURE:WEB_POOL:AKS","GOOGLE:WEB_POOL:GKE","OCI:WEB_POOL:OKE"]},{"type":"string","format":"uuid","description":"UUID of a scope specification"}]},"minItems":1}},"additionalProperties":false,"required":["values"]}},"additionalProperties":false},"assignable_to":{"type":"string","enum":["any","dimension","scope"],"description":"Specifies if the service can be assigned to any entity, only dimensions, or only scopes."},"attributes":{"title":"Attribute","type":"object","properties":{"schema":{"type":"object","default":{},"description":"Specification of the attribute schema. Must be a valid JSON Schema"},"values":{"type":"object","default":{},"description":"Values associated with the attribute. Must validate against provided schema"}},"required":["schema","values"],"propertyNames":{"enum":["schema","values"],"description":"Allowed property names"},"additionalProperties":false,"description":"Object representing an attribute with a schema and associated values"},"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"},"use_default_actions":{"type":"boolean","description":"Specifies if the link specification should autogenerate its create, update, and delete actions from the attributes schema. Defaults to true for new specifications"},"use_default_naming":{"type":"boolean","description":"When true, the link name is optional and generated by nullplatform or taken from the schema's `name` property. When false, a caller-provided name is required. Defaults to true for new specifications"},"external":{"title":"External","type":"object","nullable":true,"properties":{"action":{"type":"string","minLength":1,"description":"Action to send to the agent for resolving external data"},"output_schema":{"type":"object","description":"JSON Schema to validate the agent response against"}},"additionalProperties":false,"required":["action","output_schema"],"description":"Configuration for resolving external context data via the nullplatform agent"},"external_resolution":{"type":"object","description":"Status of the external context resolution when the link specification was read","properties":{"status":{"type":"string","description":"Resolution outcome. One of: success, no_channel, agent_error, timeout, auth_error, service_unavailable, invalid_response"},"error":{"type":"string","description":"Human-readable error detail when status is not success"},"notification_id":{"type":"string","description":"ID of the notification sent to the agent. Present on error statuses to facilitate debugging"}},"required":["status"]}},"description":"Object representing link specifications","additionalProperties":false,"title":"LinkSpecification","example":{"name":"my-link-specification","specification_id":"eb0b880a-b7e4-42b8-98f9-40c262c59a23","unique":true,"dimensions":{"environment":{"required":true,"values":["production","staging"]}},"scopes":{"provider":{"values":["AWS:SERVERLESS:LAMBDA","AWS:WEB_POOL:EC2INSTANCES","uuid-of-a-specific-scope-specification"]}},"assignable_to":"any","attributes":{"schema":{"type":"object","properties":{"my_string_property":{"type":"string"},"my_number_property":{"type":"number","default":0}},"required":["my_string_property"]},"values":{}}}}}}},"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>