---
id: scope-troubleshooting-action-create
title: "Create a troubleshooting action"
description: "Submits an action to kill a specific instance or pod."
sidebar_label: "Create a troubleshooting 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 troubleshooting action"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/scope/{scopeId}/action"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Submits an action to kill a specific instance or pod.

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

<ParamsDetails
  parameters={[{"name":"scopeId","in":"path","required":true,"schema":{"type":"string"},"description":"The ID of the scope."}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","parameters"],"properties":{"name":{"type":"string","description":"The name of the troubleshooting action","example":"instance_kill","enum":["instance_kill","instance_restart","autoscaling_fix","autoscaling_stop","autoscaling_start"]},"parameters":{"type":"object","description":"Defines the parameters required for troubleshooting actions.\n\n  > **Note**: Actions with the name `autoscaling_stop` and `autoscaling_start` do not require parameters.","example":{"instance_id":"i-0a1234567890b1234"},"properties":{"instance_id":{"type":"string","description":"The ID of the instance to terminate. Applies only to the `instance_kill` action.","example":"i-0a1234567890b1234"},"desired_instances":{"type":"integer","description":"The target number of instances. Applies only to the `autoscaling_fix` action.","example":10},"autoscaling_enabled":{"type":"boolean","description":"Indicates whether autoscaling should be enabled. Applies only to the `autoscaling_fix` action.","example":true}},"title":"ScopeActionParameters"}},"example":{"name":"instance_kill","parameters":{"instance_id":"i-0a1234567890b1234"}},"title":"ScopeActionInstanceKillCreate"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the troubleshooting action.","example":"5678"},"name":{"type":"string","description":"The name of the troubleshooting action.","example":"instance_kill"},"status":{"type":"string","description":"The status of the troubleshooting action.","enum":["pending_approval","pending_approval_denied","pending","executed","cancelled","failed"],"example":"pending"},"entity":{"type":"string","description":"The entity that the troubleshooting action is associated with.","example":"scope"},"entity_id":{"type":"string","description":"The ID of the entity that the troubleshooting action is associated with.","example":"1234"},"parameters":{"type":"object","description":"The parameters for the troubleshooting action.","example":{"instance_id":"i-0a1234567890b1234"}},"messages":{"type":"array","items":{"type":"string"},"description":"The messages for the troubleshooting action.","example":["Instance i-0a1234567890b1234 not found"]},"nrn":{"type":"string","description":"The NRN of the entity that the troubleshooting action is associated with.","example":"organization=1:account=2:namespace=3:application=4:scope=1234"},"created_at":{"type":"string","description":"The ISO-8601 UTC timestamp of when the troubleshooting action was created.","format":"date-time","example":"2021-01-02T00:00:00Z"},"updated_at":{"type":"string","nullable":true,"description":"The ISO-8601 UTC timestamp of when the troubleshooting action was last updated.","format":"date-time","example":"2021-01-02T00:00:00Z"}},"example":{"id":"5678","name":"instance_kill","parameters":{"instance_id":"i-0a1234567890b1234"}},"title":"ScopeAction"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>