Manage users

Retrieve users in all associated accounts

Returns a list of users in the main account and all associated sub accounts as an array of JSON objects per account.

Retrieve all users

Returns a list of users as an array of JSON objects. If you run this endpoint without the accountID, then you will retrieve all users within the account the token of which you provide. If you run this endpoint with the accountID, then you will retrieve users only from the given accountID. In this case you must run it with the token of the main account that the accountID belongs to.

Create a user

Creates a new user with specified permissions to access your log data. If you run this endpoint with the token of the main account, then you can perform actions on the main account or any sub-account within the main account by providing the sub-account’s accountID. If you run this endpoint with the token of the sub-account, then you can perform actions only on the given sub-account.

Retrieve a user by ID

Returns user information and permissions as a JSON object.

Update a user

Changes an existing user's details or permissions. If you run this endpoint with the token of the main account, then you can perform actions on the main account or any sub-account within the main account by providing the sub-account’s accountID. If you run this endpoint with the token of the sub-account, then you can perform actions only on the given sub-account.

Delete a user

Revokes a user's access to the account. The API token determines the account the user will be deleted from. If you run this endpoint without the accountID, then you can perform actions on the account that belongs to the token you provided. If you run this endpoint with the accountID, then you will delete only the user from the given accountID. In this case you must run it with the token of the main account that the accountID belongs to.

Delete a user from all accounts

Deletes a user from the main account and all associated sub accounts. Must be run with an API token for the main account.

Suspend a user

Locks a user's access to your accounts

Unsuspend a user

Restores a suspended user's access to your accounts

Suspend a user from all accounts

Suspends a user from the main account and all associated sub accounts. Must be run with an API token for the main account. The user will not be suspended from accounts for which there are no other users. In other words, any accounts where the user is the last user will be skipped. The success message will list accounts that were skipped.

Unsuspend a user from all accounts

Unsuspends a user from the main account and all associated sub accounts. Must be run with an API token for the main account.