BalkanID API CLI
BalkanID API CLI is a command line interface that can be installed on any system and provides commands to interact with the BalkanID APIs, both downloading and uploading data.
BalkanID Bulk Download CLI
The bulk-download-cli
allows you to retrieve various datasets from your BalkanID tenant.
bulk-download-cli --help
Usage:
bulk-download-cli [command]
Available Commands:
admins Download admins data
applied-labels Download applied labels data
apps Download apps data
business-owners Download business owners data
campaigns Download campaigns data
completion Generate the autocompletion script for the specified shell
custom-insights Download custom insights data
employees Download employees data
entities Download entities data
entity-finding-rules Download entity finding rules data
entity-insights Download entity insights data
entity-rbac Download entity rbac data
entity-relations Download entity relations data
entitlements Download entitlements data for an integration
filters Download filters data
findings Download findings data
help Help about any command
integrations Download integrations data
labels Download labels data
playbook-templates Download playbook-templates data
privileged Download privileged data
purposes Download purposes data
relations Download employees identities relations data
requests Download access requests data
reviews Download all reviews
reviews-by-campaign Download reviews for a campaign
rules Download rules data
webhook-templates Download webhook-templates data
Flags:
-h, --help help for bulk-download-cli
Use "bulk-download-cli [command] --help" for more information about a command.
BalkanID Bulk Upload CLI
The bulk-upload-cli
allows you to upload various datasets to your BalkanID tenant.
bulk-upload-cli --help
Usage:
bulk-upload-cli [command]
Available Commands:
admins Upload admins data
applied-labels Upload applied labels data
apps Upload apps data
business-owners Upload business owners data
campaigns Upload campaigns data
custom-insights Upload custom insights data
employees Upload employees data
entities Upload entities data
entity-finding-rules Upload entity finding rules data
entity-insights Upload entity insights data
entity-rbac Upload entity rbac data
entity-relations Upload entity relations data
entitlements Upload entitlements data for an integration
filters Upload filters data
findings Upload findings data
help Help about any command
integrations Upload integrations data
labels Upload labels data
playbook-templates Upload playbook-templates data
privileged Upload privileged data
purposes Upload purposes data
relations Upload employees identities relations data
requests Upload access requests data
reviews Upload all reviews
reviews-by-campaign Upload reviews for a campaign
rules Upload rules data
webhook-templates Upload webhook-templates data
Flags:
-h, --help help for bulk-upload-cli
Use "bulk-upload-cli [command] --help" for more information about a command.
CLI Usage Examples
Here are some examples demonstrating how to use the bulk-download-cli
commands. Remember to replace <SECRET>
and <API_KEY>
with your actual credentials. The usage pattern for bulk-upload-cli
follows a similar structure.
Example 1: Downloading Campaigns
To download campaigns data, you can specify whether to include completed and draft campaigns.
Command Help:
> bulk-download-cli campaigns --help
Output:
Download campaigns data
Usage:
bulk-download-cli campaigns [flags]
Flags:
--api-key string API Key
-h, --help help for campaigns
--include-completed string Include completed campaigns? (y/n)
--include-draft string Include draft campaigns? (y/n)
--secret string API Key Secret
Running the Command:
bulk-download-cli campaigns --secret <YOUR_API_SECRET> --api-key <YOUR_API_KEY>
The CLI will then prompt for further details:
Include completed campaigns? (y/n): y
Include draft campaigns? (y/n): y
Downloading campaigns data...
Download URL: https://<your_download_url>
You will receive a download URL where you can retrieve the campaign data.
Example 2: Downloading Reviews for a Specific Campaign
To download reviews for a particular campaign, you'll need its Campaign ID.
Running the Command:
bulk-download-cli reviews --secret <YOUR_API_SECRET> --api-key <YOUR_API_KEY>
The CLI will prompt for the Campaign ID:
Campaign ID: 01HBKKYMCTG5YBCF2F1FXC9YWV
Downloading reviews data...
File is not ready yet. Retrying in 5 seconds...
File is not ready yet. Retrying in 5 seconds...
...
File is not ready yet. Retrying in 5 seconds...
Download URL: <your_download_url>
The system will periodically check if the file is ready and provide a download URL once it's available.
Need Assistance?
If you need any help or assistance with the BalkanID API CLI or any other part of the platform, don't hesitate to reach out to the BalkanID team at [email protected].
Last updated
Was this helpful?