Batch Import Subject Compatibility

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "apply": true,
  "entries": [
    {
      "row": 123,
      "subject": "<string>",
      "userId": "<string>"
    }
  ],
  "importId": "<string>"
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import"

payload = {
    "apply": True,
    "entries": [
        {
            "row": 123,
            "subject": "<string>",
            "userId": "<string>"
        }
    ],
    "importId": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    apply: true,
    entries: [{row: 123, subject: '<string>', userId: '<string>'}],
    importId: '<string>'
  })
};

fetch('https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'apply' => true,
    'entries' => [
        [
                'row' => 123,
                'subject' => '<string>',
                'userId' => '<string>'
        ]
    ],
    'importId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import"

	payload := strings.NewReader("{\n  \"apply\": true,\n  \"entries\": [\n    {\n      \"row\": 123,\n      \"subject\": \"<string>\",\n      \"userId\": \"<string>\"\n    }\n  ],\n  \"importId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"apply\": true,\n  \"entries\": [\n    {\n      \"row\": 123,\n      \"subject\": \"<string>\",\n      \"userId\": \"<string>\"\n    }\n  ],\n  \"importId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"apply\": true,\n  \"entries\": [\n    {\n      \"row\": 123,\n      \"subject\": \"<string>\",\n      \"userId\": \"<string>\"\n    }\n  ],\n  \"importId\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "blockingUserIds": [
    "<string>"
  ],
  "importedRows": 123,
  "importedUserIds": [
    "<string>"
  ],
  "issues": [
    {
      "reason": "<string>",
      "row": 123,
      "subject": "<string>",
      "userId": "<string>"
    }
  ],
  "recoverableUserIds": [
    "<string>"
  ],
  "totalRows": 123,
  "validRows": 123
}

POST

api

apps

{app_id}

sso

applications

{id}

subjects

import

Batch Import Subject Compatibility

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "apply": true,
  "entries": [
    {
      "row": 123,
      "subject": "<string>",
      "userId": "<string>"
    }
  ],
  "importId": "<string>"
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import"

payload = {
    "apply": True,
    "entries": [
        {
            "row": 123,
            "subject": "<string>",
            "userId": "<string>"
        }
    ],
    "importId": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    apply: true,
    entries: [{row: 123, subject: '<string>', userId: '<string>'}],
    importId: '<string>'
  })
};

fetch('https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'apply' => true,
    'entries' => [
        [
                'row' => 123,
                'subject' => '<string>',
                'userId' => '<string>'
        ]
    ],
    'importId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import"

	payload := strings.NewReader("{\n  \"apply\": true,\n  \"entries\": [\n    {\n      \"row\": 123,\n      \"subject\": \"<string>\",\n      \"userId\": \"<string>\"\n    }\n  ],\n  \"importId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"apply\": true,\n  \"entries\": [\n    {\n      \"row\": 123,\n      \"subject\": \"<string>\",\n      \"userId\": \"<string>\"\n    }\n  ],\n  \"importId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/apps/{app_id}/sso/applications/{id}/subjects/import")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"apply\": true,\n  \"entries\": [\n    {\n      \"row\": 123,\n      \"subject\": \"<string>\",\n      \"userId\": \"<string>\"\n    }\n  ],\n  \"importId\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "blockingUserIds": [
    "<string>"
  ],
  "importedRows": 123,
  "importedUserIds": [
    "<string>"
  ],
  "issues": [
    {
      "reason": "<string>",
      "row": 123,
      "subject": "<string>",
      "userId": "<string>"
    }
  ],
  "recoverableUserIds": [
    "<string>"
  ],
  "totalRows": 123,
  "validRows": 123
}

Authorizations

Authorization

string

header

required

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

Authorization

string

header

required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Path Parameters

app_id

string

required

The application in your catalog that owns the SSO application.

string

required

Unique identifier for the SSO application.

Body

application/json

SSOApplicationServiceBatchImportSubjectCompatibilityRequest validates or imports a bounded batch of per-user subject bindings.

apply

boolean

When false, validate without writing. Clients should validate every batch before beginning the apply pass.

entries

Sso Subject Compatibility Import Entry · object[] | null

Client-parsed rows. Each request is bounded to 50 entries.

Show child attributes

importId

string

Client-generated identifier shared by every batch from one source file.

Response

200 - application/json

SSOApplicationServiceBatchImportSubjectCompatibilityResponse summarizes one bounded validation or apply batch.

blockingUserIds

string[] | null

Import-created binding owners that block one or more submitted corrections. This is a subset of recoverable_user_ids.

importedRows

integer<int32>

Number of bindings successfully written. Zero for validation-only requests; may be less than valid_rows if apply stops on a write failure.

importedUserIds

string[] | null

Users whose bindings were created by this import, or were already created by an earlier retry carrying the same import_id.

issues

Sso Subject Compatibility Import Issue · object[] | null

Row-level validation or apply failures.

Show child attributes

recoverableUserIds

string[] | null

Users whose import-created binding is implicated by a submitted row. This may include the current owner of a submitted subject even when that owner was not itself submitted.

totalRows

integer<int32>

Number of entries in this batch.

validRows

integer<int32>

Number of rows that can be imported.

⌘I

Welcome

Endpoints

Batch Import Subject Compatibility

Authorizations

Path Parameters

Body

Response