Get

Get

curl --request GET \
  --url https://devx.{environment}.oleria.io/v1/user-groups/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://devx.{environment}.oleria.io/v1/user-groups/{id}', 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://devx.{environment}.oleria.io/v1/user-groups/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://devx.{environment}.oleria.io/v1/user-groups/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://devx.{environment}.oleria.io/v1/user-groups/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "applicationGroupType": "EmailDistributionList",
  "id": "team:T_kgDOLL0doQ (GitHub), 37d284db-1d76-4587-aa78-5a33cfcc021f:member (SharePoint)",
  "name": "AI Maintainers",
  "objectMetadata": {
    "ApplicationInstanceId": "<string>",
    "GeneratedTime": "2023-11-07T05:31:56Z",
    "ObjectOrRelationshipType": "<string>"
  },
  "type": "Custom",
  "globalId": "<string>",
  "oleriaObjectMetadata": {
    "enrichmentVersion": "<string>",
    "generatedTime": "2023-11-07T05:31:56Z"
  },
  "authenticationRequirements": {
    "isMFAAuthority": true,
    "isSSOBasedMFARequired": false,
    "authenticationKeys": [
      "XD+NWux+oeqdAa1eUPtNC06g/HtrzM6AbNiZU2MhHSM="
    ],
    "adaptiveAuthenticationMethodSelectionPolicy": [
      {
        "policy": {
          "accountConditions": {
            "context": [
              {
                "id": "<string>",
                "name": "<string>",
                "namespace": "<string>",
                "value": {}
              }
            ],
            "overrides": [],
            "rootOperator": {
              "operator": {
                "isArrayGeneratingDynamicValue": true,
                "arrayOpKey": {
                  "keySpecification": {
                    "parameters": [
                      {
                        "id": "<string>",
                        "name": "<string>",
                        "namespace": "<string>",
                        "value": {}
                      }
                    ]
                  },
                  "value": "<string>"
                },
                "arrayOpValue": {
                  "values": [
                    {
                      "staticConditionValueData": {}
                    }
                  ]
                }
              }
            }
          },
          "assignedApplicationConditions": {
            "context": [
              {
                "id": "<string>",
                "name": "<string>",
                "namespace": "<string>",
                "value": {}
              }
            ],
            "overrides": [],
            "rootOperator": {
              "operator": {
                "isArrayGeneratingDynamicValue": true,
                "arrayOpKey": {
                  "keySpecification": {
                    "parameters": [
                      {
                        "id": "<string>",
                        "name": "<string>",
                        "namespace": "<string>",
                        "value": {}
                      }
                    ]
                  },
                  "value": "<string>"
                },
                "arrayOpValue": {
                  "values": [
                    {
                      "staticConditionValueData": {}
                    }
                  ]
                }
              }
            }
          },
          "authorizedLocations": {
            "isInherited": true,
            "policy": {
              "allowAll": true,
              "authorizedLocations": [
                {
                  "typeSpecificData": {
                    "ipAddressExclusions": [
                      "<string>"
                    ],
                    "ipAddressInclusions": [
                      "<string>"
                    ],
                    "name": "<string>",
                    "supplementaryInformation": {
                      "geoLocation": {
                        "latitude": 123,
                        "longtitude": 123
                      },
                      "additionalLocationMetadata": [
                        {
                          "id": "<string>",
                          "name": "<string>",
                          "namespace": "<string>",
                          "value": {}
                        }
                      ]
                    }
                  }
                }
              ]
            }
          },
          "excludedAuthenticationMethods": [
            {
              "type": "<string>",
              "description": "<string>"
            }
          ],
          "includedAuthenticationMethods": [
            {
              "type": "<string>",
              "description": "<string>"
            }
          ]
        }
      }
    ],
    "authenticationMethodSelectionPolicy": {
      "accountConditions": {
        "context": [
          {
            "id": "<string>",
            "name": "<string>",
            "namespace": "<string>",
            "value": {}
          }
        ],
        "overrides": [],
        "rootOperator": {
          "operator": {
            "isArrayGeneratingDynamicValue": true,
            "arrayOpKey": {
              "keySpecification": {
                "parameters": [
                  {
                    "id": "<string>",
                    "name": "<string>",
                    "namespace": "<string>",
                    "value": {}
                  }
                ]
              },
              "value": "<string>"
            },
            "arrayOpValue": {
              "values": [
                {
                  "staticConditionValueData": {}
                }
              ]
            }
          }
        }
      },
      "assignedApplicationConditions": {
        "context": [
          {
            "id": "<string>",
            "name": "<string>",
            "namespace": "<string>",
            "value": {}
          }
        ],
        "overrides": [],
        "rootOperator": {
          "operator": {
            "isArrayGeneratingDynamicValue": true,
            "arrayOpKey": {
              "keySpecification": {
                "parameters": [
                  {
                    "id": "<string>",
                    "name": "<string>",
                    "namespace": "<string>",
                    "value": {}
                  }
                ]
              },
              "value": "<string>"
            },
            "arrayOpValue": {
              "values": [
                {
                  "staticConditionValueData": {}
                }
              ]
            }
          }
        }
      },
      "authorizedLocations": {
        "isInherited": true,
        "policy": {
          "allowAll": true,
          "authorizedLocations": [
            {
              "typeSpecificData": {
                "ipAddressExclusions": [
                  "<string>"
                ],
                "ipAddressInclusions": [
                  "<string>"
                ],
                "name": "<string>",
                "supplementaryInformation": {
                  "geoLocation": {
                    "latitude": 123,
                    "longtitude": 123
                  },
                  "additionalLocationMetadata": [
                    {
                      "id": "<string>",
                      "name": "<string>",
                      "namespace": "<string>",
                      "value": {}
                    }
                  ]
                }
              }
            }
          ]
        }
      },
      "excludedAuthenticationMethods": [
        {
          "type": "<string>",
          "description": "<string>"
        }
      ],
      "includedAuthenticationMethods": [
        {
          "type": "<string>",
          "description": "<string>"
        }
      ]
    },
    "availableAuthenticationMethods": [
      {
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "enforcedAuthenticationMethods": [
      {
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "passwordPolicy": {
      "expirationLengthInDays": 123,
      "length": 123,
      "reuseDisallowed": true,
      "resetViaSelfServiceAllowed": true,
      "characters": [],
      "mfaRequirements": "Required",
      "policyMetadata": [
        {
          "id": "<string>",
          "name": "<string>",
          "namespace": "<string>",
          "value": {}
        }
      ]
    },
    "secondaryFactorRequirements": "Required",
    "ssoExclusions": [
      "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)"
    ]
  },
  "authorizedLocations": {
    "isInherited": true,
    "policy": {
      "allowAll": true,
      "authorizedLocations": [
        {
          "typeSpecificData": {
            "ipAddressExclusions": [
              "<string>"
            ],
            "ipAddressInclusions": [
              "<string>"
            ],
            "name": "<string>",
            "supplementaryInformation": {
              "geoLocation": {
                "latitude": 123,
                "longtitude": 123
              },
              "additionalLocationMetadata": [
                {
                  "id": "<string>",
                  "name": "<string>",
                  "namespace": "<string>",
                  "value": {}
                }
              ]
            }
          }
        }
      ]
    }
  },
  "createdBy": "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)",
  "createdByFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "createdDate": "2024-05-02T03:17:34.948Z",
  "description": "AI Maintainers",
  "directoryEntryFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "directoryEntryId": "<string>",
  "directoryProviderFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "directoryProviderId": "<string>",
  "email": "ai-maintainers@oleria.com",
  "labels": [
    {
      "id": "<string>",
      "name": "<string>",
      "namespace": "<string>",
      "value": {}
    }
  ],
  "lastModifiedBy": "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)",
  "lastModifiedByFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "lastModifiedDate": "2024-05-02T03:17:34.948Z",
  "objectDirectoryContainerFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "objectDirectoryContainerId": "repo:R_kgDOLL0doQ (GitHub based on repository node identifier), 1BUxdX4M-H7X8GKRgTjprJS8fjY_Ij1giE82lQlny2kc (Google Drive based on file id)",
  "profileMetadata": [
    {
      "id": "<string>",
      "name": "<string>",
      "namespace": "<string>",
      "value": {}
    }
  ],
  "provisioning": [
    {
      "authenticationKey": "<string>",
      "entitySync": {
        "attributeControls": [
          {
            "attributeSync": [],
            "id": "<string>",
            "sourceAttributeName": "<string>",
            "sourceEntityType": "Account",
            "targetAttributeName": "<string>",
            "targetEntityType": "Account"
          }
        ],
        "protocolControls": []
      },
      "syncKey": "Oleria Repository Writers"
    }
  ],
  "sourceTag": "OrgTeams",
  "globalAuthenticationRequirements": {
    "isMFAAuthority": true,
    "isSSOBasedMFARequired": false,
    "authenticationKeys": [
      "XD+NWux+oeqdAa1eUPtNC06g/HtrzM6AbNiZU2MhHSM="
    ],
    "adaptiveAuthenticationMethodSelectionPolicy": [
      {
        "policy": {
          "accountConditions": {
            "context": [
              {
                "id": "<string>",
                "name": "<string>",
                "namespace": "<string>",
                "value": {}
              }
            ],
            "overrides": [],
            "rootOperator": {
              "operator": {
                "isArrayGeneratingDynamicValue": true,
                "arrayOpKey": {
                  "keySpecification": {
                    "parameters": [
                      {
                        "id": "<string>",
                        "name": "<string>",
                        "namespace": "<string>",
                        "value": {}
                      }
                    ]
                  },
                  "value": "<string>"
                },
                "arrayOpValue": {
                  "values": [
                    {
                      "staticConditionValueData": {}
                    }
                  ]
                }
              }
            }
          },
          "assignedApplicationConditions": {
            "context": [
              {
                "id": "<string>",
                "name": "<string>",
                "namespace": "<string>",
                "value": {}
              }
            ],
            "overrides": [],
            "rootOperator": {
              "operator": {
                "isArrayGeneratingDynamicValue": true,
                "arrayOpKey": {
                  "keySpecification": {
                    "parameters": [
                      {
                        "id": "<string>",
                        "name": "<string>",
                        "namespace": "<string>",
                        "value": {}
                      }
                    ]
                  },
                  "value": "<string>"
                },
                "arrayOpValue": {
                  "values": [
                    {
                      "staticConditionValueData": {}
                    }
                  ]
                }
              }
            }
          },
          "authorizedLocations": {
            "isInherited": true,
            "policy": {
              "allowAll": true,
              "authorizedLocations": [
                {
                  "typeSpecificData": {
                    "ipAddressExclusions": [
                      "<string>"
                    ],
                    "ipAddressInclusions": [
                      "<string>"
                    ],
                    "name": "<string>",
                    "supplementaryInformation": {
                      "geoLocation": {
                        "latitude": 123,
                        "longtitude": 123
                      },
                      "additionalLocationMetadata": [
                        {
                          "id": "<string>",
                          "name": "<string>",
                          "namespace": "<string>",
                          "value": {}
                        }
                      ]
                    }
                  }
                }
              ]
            }
          },
          "excludedAuthenticationMethods": [
            {
              "type": "<string>",
              "description": "<string>"
            }
          ],
          "includedAuthenticationMethods": [
            {
              "type": "<string>",
              "description": "<string>"
            }
          ]
        }
      }
    ],
    "authenticationMethodSelectionPolicy": {
      "accountConditions": {
        "context": [
          {
            "id": "<string>",
            "name": "<string>",
            "namespace": "<string>",
            "value": {}
          }
        ],
        "overrides": [],
        "rootOperator": {
          "operator": {
            "isArrayGeneratingDynamicValue": true,
            "arrayOpKey": {
              "keySpecification": {
                "parameters": [
                  {
                    "id": "<string>",
                    "name": "<string>",
                    "namespace": "<string>",
                    "value": {}
                  }
                ]
              },
              "value": "<string>"
            },
            "arrayOpValue": {
              "values": [
                {
                  "staticConditionValueData": {}
                }
              ]
            }
          }
        }
      },
      "assignedApplicationConditions": {
        "context": [
          {
            "id": "<string>",
            "name": "<string>",
            "namespace": "<string>",
            "value": {}
          }
        ],
        "overrides": [],
        "rootOperator": {
          "operator": {
            "isArrayGeneratingDynamicValue": true,
            "arrayOpKey": {
              "keySpecification": {
                "parameters": [
                  {
                    "id": "<string>",
                    "name": "<string>",
                    "namespace": "<string>",
                    "value": {}
                  }
                ]
              },
              "value": "<string>"
            },
            "arrayOpValue": {
              "values": [
                {
                  "staticConditionValueData": {}
                }
              ]
            }
          }
        }
      },
      "authorizedLocations": {
        "isInherited": true,
        "policy": {
          "allowAll": true,
          "authorizedLocations": [
            {
              "typeSpecificData": {
                "ipAddressExclusions": [
                  "<string>"
                ],
                "ipAddressInclusions": [
                  "<string>"
                ],
                "name": "<string>",
                "supplementaryInformation": {
                  "geoLocation": {
                    "latitude": 123,
                    "longtitude": 123
                  },
                  "additionalLocationMetadata": [
                    {
                      "id": "<string>",
                      "name": "<string>",
                      "namespace": "<string>",
                      "value": {}
                    }
                  ]
                }
              }
            }
          ]
        }
      },
      "excludedAuthenticationMethods": [
        {
          "type": "<string>",
          "description": "<string>"
        }
      ],
      "includedAuthenticationMethods": [
        {
          "type": "<string>",
          "description": "<string>"
        }
      ]
    },
    "availableAuthenticationMethods": [
      {
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "enforcedAuthenticationMethods": [
      {
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "passwordPolicy": {
      "expirationLengthInDays": 123,
      "length": 123,
      "reuseDisallowed": true,
      "resetViaSelfServiceAllowed": true,
      "characters": [],
      "mfaRequirements": "Required",
      "policyMetadata": [
        {
          "id": "<string>",
          "name": "<string>",
          "namespace": "<string>",
          "value": {}
        }
      ]
    },
    "secondaryFactorRequirements": "Required",
    "ssoExclusions": [
      "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)"
    ]
  },
  "globalAuthorizedLocations": {
    "isInherited": true,
    "policy": {
      "allowAll": true,
      "authorizedLocations": [
        {
          "typeSpecificData": {
            "ipAddressExclusions": [
              "<string>"
            ],
            "ipAddressInclusions": [
              "<string>"
            ],
            "name": "<string>",
            "supplementaryInformation": {
              "geoLocation": {
                "latitude": 123,
                "longtitude": 123
              },
              "additionalLocationMetadata": [
                {
                  "id": "<string>",
                  "name": "<string>",
                  "namespace": "<string>",
                  "value": {}
                }
              ]
            }
          }
        }
      ]
    }
  },
  "globalCreatedBy": "<string>",
  "globalDirectoryEntryId": "<string>",
  "globalDirectoryProviderId": "<string>",
  "globalLastModifiedBy": "<string>",
  "globalObjectDirectoryContainerId": "<string>",
  "globalProfileMetadata": [
    {
      "id": "<string>",
      "name": "<string>",
      "namespace": "<string>",
      "value": {}
    }
  ],
  "enrichedDataClassifications": [
    {
      "compliance": [],
      "description": "<string>",
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "enrichedNormalizedEmail": "<string>",
  "analyticsAccessToResourceInstancesCount": 123,
  "analyticsActiveMemberCount": 123,
  "analyticsAssignedApplicationCount": 123,
  "analyticsAssignedRoleCount": 123,
  "analyticsDataLabelsCount": 123,
  "analyticsInactiveMemberCount": 123,
  "analyticsMemberAccountsCount": 123,
  "analyticsMemberCount": 123,
  "analyticsUtilizationPercentage": 123,
  "analyticsOwners": [
    "<string>"
  ],
  "analyticsOwnerCount": 123,
  "sorPrimaryStewardEmail": "<string>"
}

{
  "code": "BAD_REQUEST",
  "message": "The request was malformed."
}

{
  "code": "UNAUTHORIZED",
  "message": "Missing or invalid authentication token."
}

{
  "code": "FORBIDDEN",
  "message": "The token lacks the required scope."
}

{
  "code": "NOT_FOUND",
  "message": "No resource with the given id."
}

{
  "code": "TOO_MANY_REQUESTS",
  "message": "Rate limit exceeded. Retry after the specified interval."
}

{
  "code": "INTERNAL_ERROR",
  "message": "An unexpected error occurred."
}

GET

user-groups

{id}

Get

curl --request GET \
  --url https://devx.{environment}.oleria.io/v1/user-groups/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://devx.{environment}.oleria.io/v1/user-groups/{id}', 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://devx.{environment}.oleria.io/v1/user-groups/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://devx.{environment}.oleria.io/v1/user-groups/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://devx.{environment}.oleria.io/v1/user-groups/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "applicationGroupType": "EmailDistributionList",
  "id": "team:T_kgDOLL0doQ (GitHub), 37d284db-1d76-4587-aa78-5a33cfcc021f:member (SharePoint)",
  "name": "AI Maintainers",
  "objectMetadata": {
    "ApplicationInstanceId": "<string>",
    "GeneratedTime": "2023-11-07T05:31:56Z",
    "ObjectOrRelationshipType": "<string>"
  },
  "type": "Custom",
  "globalId": "<string>",
  "oleriaObjectMetadata": {
    "enrichmentVersion": "<string>",
    "generatedTime": "2023-11-07T05:31:56Z"
  },
  "authenticationRequirements": {
    "isMFAAuthority": true,
    "isSSOBasedMFARequired": false,
    "authenticationKeys": [
      "XD+NWux+oeqdAa1eUPtNC06g/HtrzM6AbNiZU2MhHSM="
    ],
    "adaptiveAuthenticationMethodSelectionPolicy": [
      {
        "policy": {
          "accountConditions": {
            "context": [
              {
                "id": "<string>",
                "name": "<string>",
                "namespace": "<string>",
                "value": {}
              }
            ],
            "overrides": [],
            "rootOperator": {
              "operator": {
                "isArrayGeneratingDynamicValue": true,
                "arrayOpKey": {
                  "keySpecification": {
                    "parameters": [
                      {
                        "id": "<string>",
                        "name": "<string>",
                        "namespace": "<string>",
                        "value": {}
                      }
                    ]
                  },
                  "value": "<string>"
                },
                "arrayOpValue": {
                  "values": [
                    {
                      "staticConditionValueData": {}
                    }
                  ]
                }
              }
            }
          },
          "assignedApplicationConditions": {
            "context": [
              {
                "id": "<string>",
                "name": "<string>",
                "namespace": "<string>",
                "value": {}
              }
            ],
            "overrides": [],
            "rootOperator": {
              "operator": {
                "isArrayGeneratingDynamicValue": true,
                "arrayOpKey": {
                  "keySpecification": {
                    "parameters": [
                      {
                        "id": "<string>",
                        "name": "<string>",
                        "namespace": "<string>",
                        "value": {}
                      }
                    ]
                  },
                  "value": "<string>"
                },
                "arrayOpValue": {
                  "values": [
                    {
                      "staticConditionValueData": {}
                    }
                  ]
                }
              }
            }
          },
          "authorizedLocations": {
            "isInherited": true,
            "policy": {
              "allowAll": true,
              "authorizedLocations": [
                {
                  "typeSpecificData": {
                    "ipAddressExclusions": [
                      "<string>"
                    ],
                    "ipAddressInclusions": [
                      "<string>"
                    ],
                    "name": "<string>",
                    "supplementaryInformation": {
                      "geoLocation": {
                        "latitude": 123,
                        "longtitude": 123
                      },
                      "additionalLocationMetadata": [
                        {
                          "id": "<string>",
                          "name": "<string>",
                          "namespace": "<string>",
                          "value": {}
                        }
                      ]
                    }
                  }
                }
              ]
            }
          },
          "excludedAuthenticationMethods": [
            {
              "type": "<string>",
              "description": "<string>"
            }
          ],
          "includedAuthenticationMethods": [
            {
              "type": "<string>",
              "description": "<string>"
            }
          ]
        }
      }
    ],
    "authenticationMethodSelectionPolicy": {
      "accountConditions": {
        "context": [
          {
            "id": "<string>",
            "name": "<string>",
            "namespace": "<string>",
            "value": {}
          }
        ],
        "overrides": [],
        "rootOperator": {
          "operator": {
            "isArrayGeneratingDynamicValue": true,
            "arrayOpKey": {
              "keySpecification": {
                "parameters": [
                  {
                    "id": "<string>",
                    "name": "<string>",
                    "namespace": "<string>",
                    "value": {}
                  }
                ]
              },
              "value": "<string>"
            },
            "arrayOpValue": {
              "values": [
                {
                  "staticConditionValueData": {}
                }
              ]
            }
          }
        }
      },
      "assignedApplicationConditions": {
        "context": [
          {
            "id": "<string>",
            "name": "<string>",
            "namespace": "<string>",
            "value": {}
          }
        ],
        "overrides": [],
        "rootOperator": {
          "operator": {
            "isArrayGeneratingDynamicValue": true,
            "arrayOpKey": {
              "keySpecification": {
                "parameters": [
                  {
                    "id": "<string>",
                    "name": "<string>",
                    "namespace": "<string>",
                    "value": {}
                  }
                ]
              },
              "value": "<string>"
            },
            "arrayOpValue": {
              "values": [
                {
                  "staticConditionValueData": {}
                }
              ]
            }
          }
        }
      },
      "authorizedLocations": {
        "isInherited": true,
        "policy": {
          "allowAll": true,
          "authorizedLocations": [
            {
              "typeSpecificData": {
                "ipAddressExclusions": [
                  "<string>"
                ],
                "ipAddressInclusions": [
                  "<string>"
                ],
                "name": "<string>",
                "supplementaryInformation": {
                  "geoLocation": {
                    "latitude": 123,
                    "longtitude": 123
                  },
                  "additionalLocationMetadata": [
                    {
                      "id": "<string>",
                      "name": "<string>",
                      "namespace": "<string>",
                      "value": {}
                    }
                  ]
                }
              }
            }
          ]
        }
      },
      "excludedAuthenticationMethods": [
        {
          "type": "<string>",
          "description": "<string>"
        }
      ],
      "includedAuthenticationMethods": [
        {
          "type": "<string>",
          "description": "<string>"
        }
      ]
    },
    "availableAuthenticationMethods": [
      {
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "enforcedAuthenticationMethods": [
      {
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "passwordPolicy": {
      "expirationLengthInDays": 123,
      "length": 123,
      "reuseDisallowed": true,
      "resetViaSelfServiceAllowed": true,
      "characters": [],
      "mfaRequirements": "Required",
      "policyMetadata": [
        {
          "id": "<string>",
          "name": "<string>",
          "namespace": "<string>",
          "value": {}
        }
      ]
    },
    "secondaryFactorRequirements": "Required",
    "ssoExclusions": [
      "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)"
    ]
  },
  "authorizedLocations": {
    "isInherited": true,
    "policy": {
      "allowAll": true,
      "authorizedLocations": [
        {
          "typeSpecificData": {
            "ipAddressExclusions": [
              "<string>"
            ],
            "ipAddressInclusions": [
              "<string>"
            ],
            "name": "<string>",
            "supplementaryInformation": {
              "geoLocation": {
                "latitude": 123,
                "longtitude": 123
              },
              "additionalLocationMetadata": [
                {
                  "id": "<string>",
                  "name": "<string>",
                  "namespace": "<string>",
                  "value": {}
                }
              ]
            }
          }
        }
      ]
    }
  },
  "createdBy": "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)",
  "createdByFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "createdDate": "2024-05-02T03:17:34.948Z",
  "description": "AI Maintainers",
  "directoryEntryFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "directoryEntryId": "<string>",
  "directoryProviderFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "directoryProviderId": "<string>",
  "email": "ai-maintainers@oleria.com",
  "labels": [
    {
      "id": "<string>",
      "name": "<string>",
      "namespace": "<string>",
      "value": {}
    }
  ],
  "lastModifiedBy": "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)",
  "lastModifiedByFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "lastModifiedDate": "2024-05-02T03:17:34.948Z",
  "objectDirectoryContainerFederation": {
    "isFederated": true,
    "authenticationKey": "<string>"
  },
  "objectDirectoryContainerId": "repo:R_kgDOLL0doQ (GitHub based on repository node identifier), 1BUxdX4M-H7X8GKRgTjprJS8fjY_Ij1giE82lQlny2kc (Google Drive based on file id)",
  "profileMetadata": [
    {
      "id": "<string>",
      "name": "<string>",
      "namespace": "<string>",
      "value": {}
    }
  ],
  "provisioning": [
    {
      "authenticationKey": "<string>",
      "entitySync": {
        "attributeControls": [
          {
            "attributeSync": [],
            "id": "<string>",
            "sourceAttributeName": "<string>",
            "sourceEntityType": "Account",
            "targetAttributeName": "<string>",
            "targetEntityType": "Account"
          }
        ],
        "protocolControls": []
      },
      "syncKey": "Oleria Repository Writers"
    }
  ],
  "sourceTag": "OrgTeams",
  "globalAuthenticationRequirements": {
    "isMFAAuthority": true,
    "isSSOBasedMFARequired": false,
    "authenticationKeys": [
      "XD+NWux+oeqdAa1eUPtNC06g/HtrzM6AbNiZU2MhHSM="
    ],
    "adaptiveAuthenticationMethodSelectionPolicy": [
      {
        "policy": {
          "accountConditions": {
            "context": [
              {
                "id": "<string>",
                "name": "<string>",
                "namespace": "<string>",
                "value": {}
              }
            ],
            "overrides": [],
            "rootOperator": {
              "operator": {
                "isArrayGeneratingDynamicValue": true,
                "arrayOpKey": {
                  "keySpecification": {
                    "parameters": [
                      {
                        "id": "<string>",
                        "name": "<string>",
                        "namespace": "<string>",
                        "value": {}
                      }
                    ]
                  },
                  "value": "<string>"
                },
                "arrayOpValue": {
                  "values": [
                    {
                      "staticConditionValueData": {}
                    }
                  ]
                }
              }
            }
          },
          "assignedApplicationConditions": {
            "context": [
              {
                "id": "<string>",
                "name": "<string>",
                "namespace": "<string>",
                "value": {}
              }
            ],
            "overrides": [],
            "rootOperator": {
              "operator": {
                "isArrayGeneratingDynamicValue": true,
                "arrayOpKey": {
                  "keySpecification": {
                    "parameters": [
                      {
                        "id": "<string>",
                        "name": "<string>",
                        "namespace": "<string>",
                        "value": {}
                      }
                    ]
                  },
                  "value": "<string>"
                },
                "arrayOpValue": {
                  "values": [
                    {
                      "staticConditionValueData": {}
                    }
                  ]
                }
              }
            }
          },
          "authorizedLocations": {
            "isInherited": true,
            "policy": {
              "allowAll": true,
              "authorizedLocations": [
                {
                  "typeSpecificData": {
                    "ipAddressExclusions": [
                      "<string>"
                    ],
                    "ipAddressInclusions": [
                      "<string>"
                    ],
                    "name": "<string>",
                    "supplementaryInformation": {
                      "geoLocation": {
                        "latitude": 123,
                        "longtitude": 123
                      },
                      "additionalLocationMetadata": [
                        {
                          "id": "<string>",
                          "name": "<string>",
                          "namespace": "<string>",
                          "value": {}
                        }
                      ]
                    }
                  }
                }
              ]
            }
          },
          "excludedAuthenticationMethods": [
            {
              "type": "<string>",
              "description": "<string>"
            }
          ],
          "includedAuthenticationMethods": [
            {
              "type": "<string>",
              "description": "<string>"
            }
          ]
        }
      }
    ],
    "authenticationMethodSelectionPolicy": {
      "accountConditions": {
        "context": [
          {
            "id": "<string>",
            "name": "<string>",
            "namespace": "<string>",
            "value": {}
          }
        ],
        "overrides": [],
        "rootOperator": {
          "operator": {
            "isArrayGeneratingDynamicValue": true,
            "arrayOpKey": {
              "keySpecification": {
                "parameters": [
                  {
                    "id": "<string>",
                    "name": "<string>",
                    "namespace": "<string>",
                    "value": {}
                  }
                ]
              },
              "value": "<string>"
            },
            "arrayOpValue": {
              "values": [
                {
                  "staticConditionValueData": {}
                }
              ]
            }
          }
        }
      },
      "assignedApplicationConditions": {
        "context": [
          {
            "id": "<string>",
            "name": "<string>",
            "namespace": "<string>",
            "value": {}
          }
        ],
        "overrides": [],
        "rootOperator": {
          "operator": {
            "isArrayGeneratingDynamicValue": true,
            "arrayOpKey": {
              "keySpecification": {
                "parameters": [
                  {
                    "id": "<string>",
                    "name": "<string>",
                    "namespace": "<string>",
                    "value": {}
                  }
                ]
              },
              "value": "<string>"
            },
            "arrayOpValue": {
              "values": [
                {
                  "staticConditionValueData": {}
                }
              ]
            }
          }
        }
      },
      "authorizedLocations": {
        "isInherited": true,
        "policy": {
          "allowAll": true,
          "authorizedLocations": [
            {
              "typeSpecificData": {
                "ipAddressExclusions": [
                  "<string>"
                ],
                "ipAddressInclusions": [
                  "<string>"
                ],
                "name": "<string>",
                "supplementaryInformation": {
                  "geoLocation": {
                    "latitude": 123,
                    "longtitude": 123
                  },
                  "additionalLocationMetadata": [
                    {
                      "id": "<string>",
                      "name": "<string>",
                      "namespace": "<string>",
                      "value": {}
                    }
                  ]
                }
              }
            }
          ]
        }
      },
      "excludedAuthenticationMethods": [
        {
          "type": "<string>",
          "description": "<string>"
        }
      ],
      "includedAuthenticationMethods": [
        {
          "type": "<string>",
          "description": "<string>"
        }
      ]
    },
    "availableAuthenticationMethods": [
      {
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "enforcedAuthenticationMethods": [
      {
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "passwordPolicy": {
      "expirationLengthInDays": 123,
      "length": 123,
      "reuseDisallowed": true,
      "resetViaSelfServiceAllowed": true,
      "characters": [],
      "mfaRequirements": "Required",
      "policyMetadata": [
        {
          "id": "<string>",
          "name": "<string>",
          "namespace": "<string>",
          "value": {}
        }
      ]
    },
    "secondaryFactorRequirements": "Required",
    "ssoExclusions": [
      "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)"
    ]
  },
  "globalAuthorizedLocations": {
    "isInherited": true,
    "policy": {
      "allowAll": true,
      "authorizedLocations": [
        {
          "typeSpecificData": {
            "ipAddressExclusions": [
              "<string>"
            ],
            "ipAddressInclusions": [
              "<string>"
            ],
            "name": "<string>",
            "supplementaryInformation": {
              "geoLocation": {
                "latitude": 123,
                "longtitude": 123
              },
              "additionalLocationMetadata": [
                {
                  "id": "<string>",
                  "name": "<string>",
                  "namespace": "<string>",
                  "value": {}
                }
              ]
            }
          }
        }
      ]
    }
  },
  "globalCreatedBy": "<string>",
  "globalDirectoryEntryId": "<string>",
  "globalDirectoryProviderId": "<string>",
  "globalLastModifiedBy": "<string>",
  "globalObjectDirectoryContainerId": "<string>",
  "globalProfileMetadata": [
    {
      "id": "<string>",
      "name": "<string>",
      "namespace": "<string>",
      "value": {}
    }
  ],
  "enrichedDataClassifications": [
    {
      "compliance": [],
      "description": "<string>",
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "enrichedNormalizedEmail": "<string>",
  "analyticsAccessToResourceInstancesCount": 123,
  "analyticsActiveMemberCount": 123,
  "analyticsAssignedApplicationCount": 123,
  "analyticsAssignedRoleCount": 123,
  "analyticsDataLabelsCount": 123,
  "analyticsInactiveMemberCount": 123,
  "analyticsMemberAccountsCount": 123,
  "analyticsMemberCount": 123,
  "analyticsUtilizationPercentage": 123,
  "analyticsOwners": [
    "<string>"
  ],
  "analyticsOwnerCount": 123,
  "sorPrimaryStewardEmail": "<string>"
}

{
  "code": "BAD_REQUEST",
  "message": "The request was malformed."
}

{
  "code": "UNAUTHORIZED",
  "message": "Missing or invalid authentication token."
}

{
  "code": "FORBIDDEN",
  "message": "The token lacks the required scope."
}

{
  "code": "NOT_FOUND",
  "message": "No resource with the given id."
}

{
  "code": "TOO_MANY_REQUESTS",
  "message": "Rate limit exceeded. Retry after the specified interval."
}

{
  "code": "INTERNAL_ERROR",
  "message": "An unexpected error occurred."
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client-credentials flow. Request an access token from the token endpoint and send it as Authorization: Bearer <token>.

Path Parameters

string

required

Global id of the user group.

Response

The user group.

An Oleria UserGroup object represents a group in an enterprise SaaS application, identity provider, or directory service e.g. Okta, PingOne, ActiveDirectory, GitHub, Salesforce, or ServiceNow

applicationGroupType

string

required

This is an application-specific string indicating the type of group being represented by the UserGroup object. Typically this is the information used to derive the UserGroupType specified in the UserGroup.type field

Example:

"EmailDistributionList"

string

required

An identifier (unique to the integrated or assigned application) for a UserGroup object represented in the Oleria system. Oleria converts these identifiers to global ids so they can be unique in the context of the global system graph. It is important for this identifier to be based on an underlying persistent and reusable application or identity provider id so connections to the object are robust to metadata changes and other relevant operations

Example:

"team:T_kgDOLL0doQ (GitHub), 37d284db-1d76-4587-aa78-5a33cfcc021f:member (SharePoint)"

name

string

required

The name (title) of the group which is typically informative of the group's purpose for granting access to resources (see also description)

Minimum string length: 1

Example:

"AI Maintainers"

objectMetadata

object

required

The ObjectMetadata structure defines metadata that applies to every object and relationship, and is usually managed by the system that receives the data

Show child attributes

type

enum<string>

required

The following group types are supported:

Built-in groups are used to represent system-defined groups that can be leveraged by the application administrator to give access to resources via roles and permissions assigned to the group. Account membership in built-in groups is typically explicit
Custom groups are created by administrators or users (with appropriate privilege) to give access to resources via roles and permissions assigned to the group. Account membership in custom groups is typically explicit
Dynamic groups are created by administrators or users (with appropriate privilege) where membership in the group is dynamic and based on a defined set of attributes evaluated either periodically or at access control evaluation
Modeled groups are an Oleria representation of an RBAC group like concept in the application typically used to represent concept like Everyone
Sync groups are synchronized between an identity provider and enterprise application (or directory)

Available options:

Built-in,

Custom,

Dynamic,

Modeled,

Sync

Example:

"Custom"

globalId

string

required

oleriaObjectMetadata

object

required

object metadata supersets object metadata with platform enrichment provenance — the enrichment version and the time the record was generated

Show child attributes

authenticationRequirements

object

AuthenticationRequirements are used to specify authentication requirement configuration for Oleria integrated applications as described by their corresponding IntegratedApplication object

Show child attributes

authorizedLocations

object

AuthorizedLocationPolicy is used to specify locations authorized for use by accounts, groups, roles, employees, departments, etc.

Show child attributes

createdBy

string

An identifier (unique to integrated application) for an Account object represented in the Oleria system. Oleria converts these identifiers to global ids so they can be unique in the context of the global system graph. It is important for this identifier to be based on an underlying persistent and reusable application or identity provider id so connections to the object are robust to metadata changes and other relevant operations

Example:

"user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)"

createdByFederation

object

Federation information used when specifying an EntityIdentifier

Show child attributes

createdDate

string<date-time>

The date the group was created

Example:

"2024-05-02T03:17:34.948Z"

description

string

The description of the group

Example:

"AI Maintainers"

directoryEntryFederation

object

Federation information used when specifying an EntityIdentifier

Show child attributes

directoryEntryId

string

The directoryEntryId is emitted when this UserGroup object is synced with an UserGroup object emitted by a directory. The id here should match the synced UserGroup.id

directoryProviderFederation

object

Federation information used when specifying an EntityIdentifier

Show child attributes

directoryProviderId

string

The directoryProviderId indicates the DirectoryProvider defining the directory sync relationship for this group

string<email>

The email address associated with the group

Example:

"ai-maintainers@oleria.com"

labels

object[]

Label tags associated with the group, particularly when used for data classification and sensitivity targeting

Show child attributes

lastModifiedBy

string

Example:

"user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)"

lastModifiedByFederation

object

Federation information used when specifying an EntityIdentifier

Show child attributes

lastModifiedDate

string<date-time>

The date the group was last modified

Example:

"2024-05-02T03:17:34.948Z"

objectDirectoryContainerFederation

object

Federation information used when specifying an EntityIdentifier

Show child attributes

objectDirectoryContainerId

string

An identifier (unique to the integrated application) for a ObjectDirectory object represented in the Oleria system. Oleria converts these identifiers to global ids so they can be unique in the context of the global system graph. It is important for this identifier to be based on an underlying persistent and reusable application or identity provider id so connections to the object are robust to metadata changes and other relevant operations

Example:

"repo:R_kgDOLL0doQ (GitHub based on repository node identifier), 1BUxdX4M-H7X8GKRgTjprJS8fjY_Ij1giE82lQlny2kc (Google Drive based on file id)"

profileMetadata

object[]

An array of profile key-value pairs extending the schema of the UserGroup object

Show child attributes

provisioning

object[]

An array detailing all participants in a provisioning relationship with this UserGroup

Show child attributes

sourceTag

string

An application-specific tag representing the group information data source

Example:

"OrgTeams"

globalAuthenticationRequirements

object

AuthenticationRequirements are used to specify authentication requirement configuration for Oleria integrated applications as described by their corresponding IntegratedApplication object

Show child attributes

globalAuthorizedLocations

object

AuthorizedLocationPolicy is used to specify locations authorized for use by accounts, groups, roles, employees, departments, etc.

Show child attributes

globalCreatedBy

string

globalDirectoryEntryId

string

globalDirectoryProviderId

string

globalLastModifiedBy

string

globalObjectDirectoryContainerId

string

globalProfileMetadata

object[]

Show child attributes

enrichedDataClassifications

object[]

Show child attributes

enrichedNormalizedEmail

string

Normalized version of the email found in UserGroup.Email

analyticsAccessToResourceInstancesCount

integer<int64> | null

Cached count of resource instances this user group can access, including nested (Contains) descendants. Values above 1000 may be approximate.

analyticsActiveMemberCount

integer<int32> | null

analyticsAssignedApplicationCount

integer<int32> | null

analyticsAssignedRoleCount

integer<int32> | null

analyticsDataLabelsCount

integer<int32> | null

analyticsInactiveMemberCount

integer<int32> | null

analyticsMemberAccountsCount

integer<int32> | null

analyticsMemberCount

integer<int32> | null

analyticsUtilizationPercentage

integer<int32> | null

analyticsOwners

string[]

analyticsOwnerCount

integer<int32> | null

sorPrimaryStewardEmail

string

⌘I

Getting Started

Inventory & Actions

Action jobs

TrustFusion

Downloads

Authorizations

Path Parameters

Response