---
id: service-specification-actions-list
title: "List service specification actions"
description: "List service specification actions."
sidebar_label: "List service 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 service specification actions"}
>
</Heading>

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



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