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

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



Delete a link specification action

<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},{"schema":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"in":"path","name":"linkSpecificationId","required":true}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing action 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"},"type":{"type":"string","enum":["create","update","delete","archive","unarchive","custom","diagnose"],"description":"Type of the action. Should be one of the specified values in the ActionType enumeration"},"parameters":{"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"},"results":{"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"},"service_specification_id":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"null"},{"type":"string","pattern":"^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12},\\s*)*[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"}],"description":"Unique identifier for the associated service specification"},"link_specification_id":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"null"},{"type":"string","pattern":"^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12},\\s*)*[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"}],"description":"Unique identifier for the associated link specification"},"retryable":{"type":"boolean","default":false,"description":"Indicates whether the action can be retried if the instance is in a failed state."},"parallelize":{"type":"boolean","default":false,"description":"Indicates whether multiple instances of this action can be executed in parallel. Only applicable to custom type actions."},"annotations":{"title":"Annotation","type":"object","properties":{"runs_over":{"type":"string","enum":["deployment","scope","instance"],"description":"Entity type over which the action applies"},"show_on":{"type":"array","items":{"type":"string","enum":["scope","performance","manage","deployment"],"description":"Place in nullplatform where the action will be able to be triggered"},"uniqueItems":true}},"additionalProperties":false,"description":"Object representing annotations with key-value pairs","default":{}},"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"},"enabled_when":{"type":"string","default":"","description":"Condition that must be met for the action to run"},"icon":{"type":"string","pattern":"^([a-zA-Z0-9_-]+:[a-zA-Z0-9_-]+)?$","description":"Icon associated with the action. Format: 'icon-set:icon-variation'. Empty string to clear."},"enabled":{"type":"boolean","description":"Indicates if the action is enabled depending on enabled_when"},"external_resolution":{"type":"object","description":"Status of the external context resolution when the action 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 action specifications","additionalProperties":false,"title":"ActionSpecification","example":{"name":"my-link-specification","type":"custom","parameters":{"schema":{"type":"object","properties":{"my_string_property":{"type":"string"},"my_number_property":{"type":"number","default":0}},"required":["my_string_property"]},"values":{}},"results":{"schema":{"type":"object","properties":{"my_string_property":{"type":"string"},"my_number_property":{"type":"number","default":0}},"required":["my_string_property"]},"values":{}},"service_specification_id":"134544a6-a089-43ba-9d52-5b6e6e4fa8d1","link_specification_id":"f3e8be90-0952-4506-bd54-c4e75a5a4393","retryable":true,"parallelize":true,"enabled_when":".service.dimensions.environment == \"development\"","annotations":{"runs_over":"scope","show_on":["scope","performance"]}}}}}},"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>