---
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: eJzdWG1vGzcS/isDfrlEWMuKYx+ue0gBNU0vuga5wFGuBWxDosmRljWX3JBcyaqw/70YcvWykl2n194dUH9Ya7kk53memSGHXDOJXjhVBWUNy9klcumBG+BV5eyCa+CCPvVZxmyFjtPLSLKcbTpMUofcIZcsY4HPPcuv2DC2spuMVdzxEgM6al8zRWYqHgqWMcNLZDlTNNCLAkvO8jULqyq2moBzdKzJmMPPtXIoWR5cjdkB5nGBMPoW7AxCgcfAm5uMeRS1U2EVEdwid+iGdShYfnVDnx36yhqPnsyfDQb079jGlj8suQdfC4Hez2pN2ghrAppAA3lVaSVix9OfPI1eH5Oztz+hCGyf2lXSwTjDMoYmENyM8Z2OjgAElVAq+YBUh8oMoTbqc42gJE04U+hgZt3DOmUM73lZaWT5i7OX502CsjPig1Nm/oANh97WTnSsPHt/+f45+AqFmq2UmcOyQIcQCuVbgxB1Qt8xzKybc6N+juq9epFzIWxtwquznELFV1zgq5f5nsKvzik+WrWexEpeTH0hFDxAK77fihHBmLokb0istF2V5FWKTlsh/Ue3UALz1i170b311UQFLMlhO1adqYIKsbEF3Wx9/EXwW/F+C/xcOOQBNywOXx0eNCyd2nuTqHHv1QdbHemwm3IrR1wPTjzNHXxXm5wCRi/woFXi7FDF3GFMk0fE3JndaNoq2WRMqhKNV9b4h7Kuq+v3uDpZcF0jVFw5DxJnylDQUp5E2tvF5ThX1gzNQjlrontzSlNZb6IjRq9bsZzVnjVNxqyZVFYrsZq068dDXt+4MLmV+JXc1FyTDo9HhIVbhMDv0FCymYg32QJRoLgD1Vm0rs21+Rp6vfc2YN7rwWgGtlQhoMxSmiZFJM54rYOn+Xu9hKPX61+bTtpukHYYzrjSv0avJUWczOp3ciNb/o/lFFElQtGGVj48ySkOyliFRqYPj3nuB0rgglcVmoiDGFE+ow+JogoetnbB1QbatPHAPUwJyLQP/zJ6BZRqoMxe99JK/Hur0Am9tEp6qD3CtOujKSjjA3IZ9TuBKZGY5h1IirLCKJRg6+DUvAh9uMSFwiU6D9whGFygA2PjBiCBGwmJO7jYDwQ3fwnkx3ZOJHsnMG21OjDoA1952nJNH8a7dtrA1D362FdwYkOW2q8e+Jwrk5EtgdpnYB1wf+fjrse7gDJYFkoURC0K7rp0WiIJYxp4AHFuMbquSzOKA3zJVy2yR2b9DyK1VarX68PQgDILrpVsezoMtTMepueDAYze/3v4bvTt5PXbN6+/fzf6OJ58Nxy9m3wYjt9OD8N8m4WbNfQ43hv6WOIk2InDSq++oPJ4a5egrZnDM2WgVForj8Ia6Z+3mxUpUvAFErNUfkm4xZmNRcJOY7yvaIfrk0DUvlRG2iUIbT16WKpQ2DoAB4lC0WqfHQZRqD2UdpE8NU3TyWlnBT+7+OpsQH+0FWttlygnG754j6IO+DsZzyhutwXXbiOhOKWMaK3ISDO90Fdp0VPOpGUislUmhUfSIbGdbkdMEuHpU4z/9tfzRLjZ2zq79TxrGvp6/uOPx8Xwa63QBEDnrINt7Qyyjt7cxKUyVR0oAUvlPe2mu4PAH1YxJ76vraRNMuKhJRe953M8rpn3en+BP8fjD5sAErSCOqwceqraNpVBrG6VALGvxzPsz/sZnA8G9HhBj5f0OH/eccF5DDfRxfJoiV1yUSiDJ7TS81uNra2IK5aCggecW6d+bpdGqs9oreRK1w67NfYtl5M2Q2LxHGX7AhC3TuEsg6Iuudkh2eu1qZISOJpuo8Y1+4ZLuExGrxk1fDK8DkWELK9ZV5z93gRx49GnQUqp6CfXIDFQTQD8llaILayunfH+rss9lFzPrCtpmyN1TeDKoNyG9H4EN03KkIuHMuRjkv8wQ5SRMc7NnI7YyvsawaZqZvhhBF5J/JOlht8Xog2GC0qNi8EZPV52HX/x/8sKIusM15PUaZIk+5/lx6g1D23ovKE+KVM+prMWfDJ8wZWmWY8S5sHh/9XUGRqoDd5XKALKlpIVonaO9rEPGrlHCG6VSjLQPKDbZE3EFQpL90hzDPHcSLcx7HSzC52mXeh0rWTTHjc3F0i10yxnRQiVz09PeaX6pta60jxQ6vaFLTtXPh8pW1KQ71/8bOWgiTbXT3F1jJ1Y1v74zrqS07nunz+M4wlOmZml4YQnKfeiP+gP9gqoYcuB5K+sDyWPadtedtEN2wMXbIf+WO9WgV+9lGtZBLwPp5XmKh5+o0TrVtSr7da+u07KWK4krQKF9YG6rNe33OMnp5uGmj/XSKfWq5uMLbhTFHJRe6k8/ZYsn3HtD2/i9jE/u2zXoufwxP3cIxzaRh7PU7HGZTljGbvDVboybG6ajBXIJbqILX0YCoFV2BtytIJScGyj7x9vxqRKNyQOQiDO/iCc9Tr1GNs7NE2zRRfonQA2zS/PnHT+
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"},"on_checklist_fail":{"type":"string","enum":["deny","pending","manual"],"description":"What happens to the request when its checklist run resolves as `fail`. Only read in checklist mode; policy-mode actions use `on_policy_fail` instead.\n\n- `deny`: the request is denied outright. Reviewers are never notified and manual review can't be requested.\n- `pending`: the request stays open. The requester fixes the cause and requests again, cancels, or asks for a manual review, which is when reviewers are notified.\n- `manual`: the request goes to manual review right away and reviewers are notified.\n\n> **Note:** If omitted, this value defaults to **pending**. An invalid value returns `400 INVALID_CHECKLIST_FAIL_PATH`.\n","example":"manual","title":"on_checklist_fail"},"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>