---
id: link-action-create
title: "Create a link action"
description: "Create a link action"
sidebar_label: "Create a link action"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post 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={"Create a link action"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/link/{linkId}/action"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Create a link 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":"linkId","required":true}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"title":"Action","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"not":{"enum":[null]},"description":"Name of the entity. Must be a non-empty string and not equal to null"},"specification_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"desired_specification_id":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"null"}],"description":"Desired unique identifier for the associated specification"},"messages":{"title":"Message","type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["debug","info","information","warn","warning","error","fatal"],"default":"info","description":"Message severity level. Defaults to \"info\""},"message":{"type":"string","description":"The actual message content"},"timestamp":{"type":"number","description":"Timestamp of the message in milliseconds"}},"required":["message"],"additionalProperties":false,"description":"Object representing messages with severity levels"}},"parameters":{"default":{},"type":"object","description":"Parameters associated with the action"},"results":{"default":{},"type":"object","description":"Results produced by the action"},"isTest":{"type":"boolean","default":false},"status":{"type":"string","enum":["pending_create","pending","in_progress","success","failed","cancelled"],"description":"Status of the action. Should be one of the specified values in the ActionStatus enumeration"},"service_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"link_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"created_by":{"type":"string","description":"User ID of the user who created the action"}},"description":"Object representing instances","type":"object","additionalProperties":false,"required":["specification_id"],"anyOf":[{"required":["service_id"],"not":{"required":["link_id"]}},{"required":["link_id"],"not":{"required":["service_id"]}},{"not":{"required":["service_id","link_id"]}}]}}},"description":"Object representing instances"}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing instances","content":{"application/json":{"schema":{"title":"Action","properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"name":{"type":"string","minLength":1,"maxLength":255,"not":{"enum":[null]},"description":"Name of the entity. Must be a non-empty string and not equal to null"},"slug":{"type":"string","minLength":1,"maxLength":255,"not":{"enum":[null]},"description":"Slug of the entity. Automatically generated from \"name\""},"specification_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"desired_specification_id":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"null"}],"description":"Desired unique identifier for the associated specification"},"messages":{"title":"Message","type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["debug","info","information","warn","warning","error","fatal"],"default":"info","description":"Message severity level. Defaults to \"info\""},"message":{"type":"string","description":"The actual message content"},"timestamp":{"type":"number","description":"Timestamp of the message in milliseconds"}},"required":["message"],"additionalProperties":false,"description":"Object representing messages with severity levels"}},"created_at":{"type":"string","format":"date"},"updated_at":{"type":"string","format":"date"},"status":{"type":"string","enum":["pending_create","pending","in_progress","success","failed","cancelled"],"description":"Status of the action. Should be one of the specified values in the ActionStatus enumeration"},"parameters":{"type":"object","description":"Parameters associated with the action"},"results":{"type":"object","description":"Results produced by the action"},"service_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"link_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"created_by":{"type":"string","description":"User ID of the user who created the action"}},"description":"Object representing instances","type":"object","additionalProperties":false}}}},"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>