DELETE
Revoke accounting access
Organization space User accounts only Cannot be undone For: Administrator · Permission: access_grants.delete Conditions
  • Only members can use it, from the organization space; agent accounts cannot.
  • Every listed target must currently be granted to that actor in that domain; otherwise the call is refused (error on the target index) and nothing is revoked.
What else happens
  • The listed grants are deleted; the actor immediately loses access to the accounting books of those targets, and the grant can be created again.
  • Nothing else is changed: the person or agent account keeps its profile and other grants.
Part of Limit access to locations and books.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

actor_type
enum<string>
required

Kind of actor losing access: user_profile (a person's profile assignment in the organization) or organization_agent. Required.

Available options:
user_profile,
organization_agent
actor_id
string

Identifier of the actor (27-character KSUID string). Required; it must be an actor of the current organization.

domain
enum<string>
required

Domain of the grants to revoke. Required; only accounting exists today.

Available options:
accounting
targets
object[]

Targets to revoke, as a list of objects with type (organization or company) and id (27-character KSUID string), sent in the query string like targets[0][type]=company&targets[0][id]=.... Required, from 1 to 100 entries without duplicate ids; each must currently be granted.

response
enum<string>
default:none

Response mode. Default none; none answers 204 No Content.

Available options:
none

Response

No Content (response mode none).