Requests & TicketsApprovals

listRequestApprovalPolicies

View as Markdown

List saved REQUEST approval policies.

Lists saved approval policies that can be referenced by initiateRequestApprovalByPolicy. Scope is REQUEST entity only — change/asset policies are not returned by this tool. When to Use:

  • Before calling initiateRequestApprovalByPolicy, to discover which policy_id to pass.

Parameters

NameTypeRequiredDescription
workspace_idintegerYesWorkspace to scope the listing to. Required.
search_keystringNoOptional case‑insensitive substring match on the policy name.
pageintegerNoPage number (1-indexed). Defaults to 1. Default: 1.
per_pageintegerNoPage size (max 100). Defaults to 50. Default: 50.