Retrieves a list of manual approvals, with their status.

Retrieves a list of manual approvals, with their status, and the ability to include/exclude optional software. See Using Global API Keys for more information on permission and scope requirements.

SecuritybearerAuth
Request
query Parameters
o
required
integer <int64>

Organization ID. If omitted, results will include the default (authenticated) organization. for the authenticated user.

Example: o=123456
page
integer
Default: 0

The page of results you wish to be returned with page numbers starting at 0. See About Automox API - Pagination

Example: page=0
limit
integer [ 1 .. 500 ]
Default: 500

A limit on the number of results to be returned, between 1 and 500 with a default of 500. Use with page parameter. See About Automox API - Pagination

Example: limit=500
policy_id[]
string

The ID or IDs of the policy/policies to retrieve. If omitted, this will retrieve all policies for the given organization.

Example: policy_id[]=policy_id[123456,789012]
include_optional
boolean
Default: false

Enable or disable inclusion of optional Windows patches for this policy NOTE: Will default to false if not included.

Example: include_optional=include_optional=true
sort_by
string

The field you want to sort by.

Value: "name"
Example: sort_by=sort_by=name
sort_dir
string

The sort direction, ascending or descending.

Enum Value Description
asc

Ascending order

desc

Descending order

Example: sort_dir=sort_dir=asc
Responses
200

successful operation

4XX

Invalid Request

default

Invalid Request

get/approvals
Request samples
$apiKey = 'your_automox_api_key'
$headers = @{
    "Authorization" = "Bearer $apiKey"
    "Content-Type" = "application/json"
}
$url = "https://console.automox.com/api/approvals?o=0000"
$response = (Invoke-WebRequest -Method Get -Uri $url -Headers $headers).Content
Response samples
application/json
{
  • "size": 1,
  • "results": [
    • {
      • "id": 351,
      • "manual_approval": null,
      • "manual_approval_time": null,
      • "status": "pending",
      • "software": {
        • "id": 137,
        • "software_version_id": 324,
        • "display_name": "Adobe Refresh Manager",
        • "version": "0.0.19",
        • "os_family": "Mac",
        • "cves": [ ]
        },
      • "policy": {
        • "id": 5,
        • "name": "A Manual Policy"
        }
      }
    ]
}