Developer Hub
Request Demo
Request Demo
Support
  1. Configuration
  • Getting Started
    • Introduction
  • API Reference
    • Admins
      • Bulk Admins Download API (Early Access)
    • Apps
      • Bulk Apps Download API (Early Access)
    • Business Owners
      • Bulk Business Owners Download API (Early Access)
      • Bulk Business Owners Upload API (Early Access)
    • Campaigns
      • Bulk Campaigns Download API (Early Access)
      • Bulk Campaigns Upload API (Early Access)
    • Configuration
      • Bulk Applied Labels Upload API (Early Access)
        POST
      • Bulk Entity Finding Rules Download API (Early Access)
        POST
      • Bulk Custom Insights (Entity Rules) Download API (Early Access)
        POST
      • Bulk Filters Download API (Early Access)
        POST
      • Bulk Filters Upload API (Early Access)
        POST
      • Bulk Findings Download API (Early Access)
        POST
      • Bulk Findings Upload API (Early Access)
        POST
      • Bulk Labels Download API (Early Access)
        POST
      • Bulk Labels Upload API (Early Access)
        POST
      • Bulk Privileged Download API (Early Access)
        POST
      • Bulk Privileged Upload API (Early Access)
        POST
      • Bulk RBAC Download API (Early Access)
        POST
      • Bulk RBAC Upload API (Early Access)
        POST
      • Bulk RBAC2 Download API (Early Access)
        POST
      • Bulk RBAC2 Upload API (Early Access)
        POST
      • Bulk Rules Download API (Early Access)
        POST
      • Bulk Rules Upload API (Early Access)
        POST
    • Employees
      • Bulk Employees Download API (Early Access)
      • Bulk Employees Upload API (Early Access)
    • Entitlements
      • Bulk Entitlements Download API (Early Access)
      • Bulk Entitlements Upload API (Early Access)
    • Entities
      • Bulk Entities Download API (Early Access)
      • Bulk Entities Upload API (Early Access)
    • EntityInsights
      • Bulk Entity Insights Download API (Early Access)
      • Bulk Entity Insights Upload API (Early Access)
    • EntityRelations
      • Bulk Entity Relations Download API (Early Access)
      • Bulk Entity Relations Upload API (Early Access)
    • EntityRBAC
      • Bulk Entity RBAC Download API
      • Bulk Entity RBAC Upload API
    • Integrations
      • Bulk Integrations Download API (Early Access)
      • Bulk Integrations Upload API (Early Access)
    • Purposes
      • Bulk Purposes Download API (Early Access)
      • Bulk Purposes Upload API (Early Access)
    • Relations
      • Bulk Relations Download API (Early Access)
      • Bulk Relations Upload API (Early Access)
    • Requests
      • Bulk Requests Download API (Early Access)
      • Bulk Requests Upload API (Early Access)
    • Reviews
      • Bulk Reviews Download API (Early Access)
      • Bulk Reviews Upload API (Early Access)
    • Playbooks
      • Bulk Playbook Templates Download API (Early Access)
      • Bulk Playbook Templates API (Early Access)
    • Webhooks
      • Bulk Webhook Templates Download API (Early Access)
      • Bulk Webhook Templates API (Early Access)
  • Playbooks
    • Overview
  1. Configuration

Bulk Privileged Upload API (Early Access)

POST
https://app.balkan.id/api/rest/v0/privileged/upload-url

BalkanID Privileged Upload CSV Format#

In this section, we will explain the BalkanID Privileged CSV format.

Sample CSV#

Integration IDSaved FiltersTrigger Auto-sync
datadog/01HQ5TDJMXX670YZ0AGATJSZ3101HV4E2Z8NV9YRGDEQ7VAP3P8T, 01HR1JWGJX1FNX2NAMSS7G9257true/false
Column Definitions#
Column NameColumn Description
Integration IDID of the integration.
Saved FiltersIDs of the saved filters.
Trigger Auto-syncTrigger auto-sync for the integration.

Upload the CSV file via the pre-signed URL#

After retrieving the pre-signed URL in the previous step, all that remains
is to upload the CSV in BalkanID Privileged CSV format to the pre-signed URL.
Below is a summary of the request using curl:
The request URL is the pre-signed URL from previous step.
The request method is PUT.
Required request body is the CSV in BalkanID Privileged CSV
format.

Request

Header Params
X-Api-Key-ID
string 
optional
X-Api-Key-Secret
string 
optional
Content-Type
string 
optional
Default:
application/json

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://app.balkan.id/api/rest/v0/privileged/upload-url' \
--header 'X-Api-Key-ID;' \
--header 'X-Api-Key-Secret;' \
--header 'Content-Type: application/json'

Responses

🟢200OK
application/json
upload url response
Body
Upload URL endpoint response
url
string 
required
The value is the pre-signed URL to which to upload your CSV file.
Example
{
    "url": "string"
}
🔴500Server Error
Modified at 2025-04-10 03:44:22
Previous
Bulk Privileged Download API (Early Access)
Next
Bulk RBAC Download API (Early Access)
Built with