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

<MethodEndpoint
  method={"delete"}
  path={"/service_specification/{serviceSpecificationId}/action_specification/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Delete a service 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":"serviceSpecificationId","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>