List unblock requests
Changed onReturns a page of unblock requests for the selected tab, scoped to the organizations the caller can see the queue for (policy managers and read-only members alike). Active Requests default to Time of Attempt ascending; Request History defaults to Resolved Date descending. Each row carries can_action, which is false when the caller may view the request but not decide it (read-only).
Column filters (TEAL-1701). Each filter is a top-level param carrying either a bare value (uses the column's default operator) or an object: field[value]=…&field[operator]=…. All filters AND together, and combine with search/tab. An unsupported operator for a field returns 422.
Request
- Base URLhttps://api.dnsfilter.com
- URLhttps://api.dnsfilter.com/v2/unblock_requests
- AuthAPI key in header Authorization
Query parameters
History tab only. Actioning admin. Operators: is (default)/isnot take user id(s) (comma separated); contains/doesnotcontain match the admin's name/email.
Category id(s), comma separated. Operators: is (default, array overlap), isnot.
Deployment name, matched against the request-time snapshot (TEAL-1799). Operators: contains (default), doesnotcontain.
Deployment type (site, roaming_client, relay, clientless), comma separated. Operators: is (default), isnot. isnot also returns rows with no deployment snapshot, since those genuinely are not of the excluded kind.
Domain. Operators: contains (default), doesnotcontain.
Requester email. Operators: contains (default), doesnotcontain.
Logged-in user (friendly/user name). Operators: contains (default), doesnotcontain.
MSP ID. When provided, returns requests across all organizations belonging to this MSP.
Organization name. Operators: contains (default), doesnotcontain.
Organization ID. Optional. Omit for the caller's full administrable set (all EDIT_POLICIES orgs, including MSP-inherited).
Organization IDs (comma separated).
Page number (defaults to 1) and size (defaults to 25, options 50/100, maximum 100).
Policy name. Operators: contains (default), doesnotcontain.
Request reason. Operators: contains (default), doesnotcontain.
History tab only. Resolved date (decided_at). Operators: between (default), notbetween, after, before — same value shape as time_of_attempt.
Free-text search across the tab's text-bearing columns.
Site (network) name. Operators: contains (default), doesnotcontain.
JSON:API sort, comma separated, "-" prefix for descending (e.g. "-decided_at,domain"). Allowed: requested_at, decided_at, status, domain, policy_name, logged_in_user_name, requester_name, requester_email, organization_name, site_name, deployment_name, deployment_type, actioned_by.
History tab only. Resolution / "Action" status (e.g. allowed, denied, ignored, resolved_already_allowed, expired), comma separated. Named status because action is a reserved param. Operators: is (default), isnot.
Which grid to populate: "active" (default) or "history".
Time of attempt. NOTE: filters and sorts on requested_at (submission time), while the serialized time_of_attempt value is the block time (blocked_at) — see UnblockRequest#time_of_attempt. Operators: between (default), notbetween, after, before. between/notbetween take value {from, to}; a between with only from/to collapses to after/before. after/before take a single date.
Response
Unblock requests page
Changes
- info
endpoint added
- info