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.

Request
Security:
query Parameters
o
required
integer

Organization ID. If omitted, results will include all organizations for the authenticated user.

page
integer
Default: 0

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

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

policy_id[]
integer

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

include_optional
boolean
Default: false

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

sort_by
string

The field you want to sort by.

Value: "name"
sort_dir
string

The sort direction, ascending or descending.

Enum: Description
asc

Ascending order

desc

Descending order

Responses
200

successful operation

400

Invalid Request

401

Access token is missing or invalid

403

You do not have permission to perform this action.

404

Entity not found

429

Too many requests

503

Service Unavailable

get/approvals
Request samples
curl -i -X GET \
  'https://console.automox.com/api/approvals?o=0&page=0&limit=500&policy_id%5B%5D=0&include_optional=false&sort_by=name&sort_dir=asc' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
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",
        • "severity": null,
        • "cves": [ ]
        },
      • "policy": {
        • "id": 5,
        • "name": "A Manual Policy"
        }
      }
    ]
}