Bulk Export Users

POST https://{{axpAPIDomain}}/api/admin/user/v1/accounts/:accountId/users:bulkExport?jobName=Bulk Job&filter=firstName:VoiceUser*&orderBy=loginId

This API requires the Account Administrator role.

Bulk exports the list of users for an account based on the criteria provided.

The following fields must be unique otherwise a HTTP 409 Conflict will be returned: * jobName

Will trigger an asynchronous job, the status of which should be monitored via /jobs/{jobId}.

Once the job has completed, the file can be downloaded using the API /jobs/{jobId}:downloadExportedUsers.

Request Params

KeyDatatypeRequiredDescription
jobNamestringOptional, job name that can be provided to uniquely identify the job.
filterstringSpecifies details of a row filter.

The possible fields you can filter on are:

  • firstName
  • lastName

The allowed format:

  • Begins with the column name to be filtered, followed by a colon, (This will be used as Contains operator.) then:
    • Either an exact string to match, or
    • A string expression including the * wildcard character.
      • :{PREFIX}* will be used to find out word start with.
      • :*{POSTFIX} will be used to find out word end with
      • : will be used to match exact word
  • Begin with column name to be filtered, followed by a = operator. (this will be used to match exact string) | | orderBy | string | | Field name on which sorting needs to be performed. The default sorting order is ascending.

The possible fields that can be ordered on are:

  • firstName
  • lastName
  • loginId

Field Names are case-sensitive (should be written as it is in description).

To specify descending order, a suffix " desc" should be added. For example, "loginId" for ascending or "loginId desc" for descending". |

HEADERS

KeyDatatypeRequiredDescription
appkeystring
Acceptstring