---
id: approval-action-read
title: "Read an approval action"
description: "Reads an approval action."
sidebar_label: "Read an approval action"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/approval
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={"Read an approval action"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/approval/action/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Reads an approval action.

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

<ParamsDetails
  parameters={[{"in":"path","name":"id","schema":{"type":"integer"},"required":true,"description":"The ID of the approval action."}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["id","nrn","entity","action"],"properties":{"id":{"type":"integer","description":"A unique identifier for the approval action.","example":1234},"nrn":{"type":"string","description":"A resource identifier (NRN) specifying where this action applies.","example":"organization=1:account=2:namespace=3:application=4"},"entity":{"type":"string","description":"The entity that requires approval.","enum":["deployment","scope","service:action","parameter","action_item"],"example":"deployment","title":"entity"},"action":{"type":"string","description":"The action that requires approval.","enum":["deployment:create","scope:create","scope:recreate","scope:write","scope:delete","scope:stop","service:action:create","parameter:read-secrets","action_item:resolve","action_item:defer","action_item:reject"],"example":"deployment:create","title":"action"},"dimensions":{"type":"object","description":"Key-value pairs defining the scope of the action.","example":{"environment":"production","country":"us"}},"on_policy_success":{"type":"string","enum":["approve","manual"],"description":"The action to be taken when the policy check is successful.\n\n> **Note:** If omitted, this value defaults to **manual**.\n","example":"approve"},"on_policy_fail":{"type":"string","enum":["manual","deny"],"description":"The action to be taken when the policy check fails.\n\n> **Note:** If omitted, this value defaults to **manual**.\n","example":"deny"},"time_to_reply":{"type":"integer","description":"How long (in milliseconds) approvers have to respond before the request expires. If the window closes without a decision, the request status moves to `expired`.","example":259200000},"allowed_time_to_execute":{"type":"integer","description":"How long (in milliseconds) after approval the action can be executed. If execution doesn't happen within this window, the `execution_status` moves to `expired`.","example":86400000}},"title":"approval_action"}}}},"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>