---
id: link-specification-action-list
title: "List link specification actions"
description: "List link specification actions"
sidebar_label: "List link specification actions"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get 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={"List link specification actions"}
>
</Heading>

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



List link specification actions

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

<ParamsDetails
  parameters={[{"schema":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"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}$"}]},"in":"query","name":"id","required":false},{"schema":{"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"},"in":"query","name":"nrn","required":false},{"schema":{"type":"string","minLength":1},"in":"query","name":"limit","required":false,"description":"Limits the number of results returned per page"},{"schema":{"type":"string","minLength":1},"in":"query","name":"offset","required":false,"description":"Specifies the offset for paginating through results"},{"schema":{"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}$"}]},"in":"query","name":"service_specification_id","required":false,"description":"Unique identifier for the associated service specification"},{"schema":{"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}$"}]},"in":"query","name":"link_specification_id","required":false,"description":"Unique identifier for the associated link specification"},{"schema":{"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}$"}]},"in":"query","name":"service_id","required":false,"description":"Service id identifier for dynamic additional properties"},{"schema":{"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}$"}]},"in":"query","name":"link_id","required":false,"description":"Link id identifier for dynamic additional properties"},{"schema":{"anyOf":[{"type":"null"},{"type":"integer"}]},"in":"query","name":"application_id","required":false,"description":"Application id identifier for dynamic additional properties"},{"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 pagination parameters for controlling the number and order of results","content":{"application/json":{"schema":{"title":"ActionSpecificationList","type":"object","properties":{"paging":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"description":"Limits the number of results returned"},"offset":{"type":"integer","minimum":0,"description":"Specifies the offset for paginated results"}},"required":["limit","offset"]},"results":{"type":"array","items":{"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"]}}}}},"required":["paging","results"],"description":"Object representing pagination parameters for controlling the number and order of results"}}}},"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>