SCIM Users API

BigPanda is happy to release an improved version of our SCIM Users API to enable you to better provision and manage user accounts and roles.

🚧

Beta Feature

This feature is available through a limited release and is not generally available. If you would like early access to participate in the beta release, please contact [email protected]

The SCIM Users API allows you to manage users in the BigPanda system, enabling you to bulk manage even large and complex userbases. SCIM specifications allow you to leverage an existing Lightweight Directory Access Protocol (LDAP), external directories, or SSO integrations.

The SCIM Users API is based on the open standard System for Cross-domain Identity Management (SCIM): Protocol 1.1. SCIM is an open standard used for automating the exchange of user identity information between identity domains or IT systems. Its purpose is to facilitate and ease the management of user identities in cloud based applications. BigPanda uses JSON-based formats for SCIM.

Key Improvements from the previous Users API

  • Improved Authentication through the User API Key
  • Bug fixes
  • Performance & Scale improvements
  • More convenient way of interacting with Users Resource

📘

The "V2" in our Public API URL indicates the latest version of our BigPanda API and not the version of the supported SCIM protocol. This API leverages SCIM 1.1

Available Actions

Use the SCIM Users API to perform these actions:

Action

Definition

Description

Retrieve Configuration

GET
/resources/v2.0/scim/ServiceProviderConfigs

Retrieves the service provider configuration details of BigPanda's SCIM API

Retrive User Schema

GET
/resources/v2.0/scim/Schemas/urn:scim:schemas:core:1.0:User

Retrieves the User Schema details for the SCIM API

Retrieve All Schemas

GET
/resources/v2.0/scim/schemas

Retrieves all schemas associated with the SCIM API

Retrieve User by ID

GET
/resources/v2.0/scim/Users/{id}

Retrieves a specific user schema

Retrieve Users

GET
/resources/v2.0/scim/Users

Retrieves a list of all users within the organization

Create Users

POST
/resources/v2.0/scim/Users

Creates a new user

Update User

PATCH
/resources/v2.0/scim/Users{id}

Updates field values for a user

Delete User

DELETE
/resources/v2.0/scim/Users/{id}

Deactivates a user account in the system

Migration

For users who were leveraging the previous BigPanda Users API, Migrating to the improved SCIM Users API takes a few simple steps:

  • Update the call base URL to <https://api.bigpanda.io/resources/v2.0/scim/>.
  • Validate the Authentication Type - the new API requires a User API Key.
  • Validate body fields or values - we don't expect you to need to make changes, but it is always best practice to test payloads.
  • Set Pagination settings for GET Users calls. The improved API uses pagination to improve response times and reliability. If your organization has more than 1000 users (active or inactive), you'll need to add Pagination Rules for your calls.

👍

Use the Filter options to retrieve only Active users within the system, narrowing your results to only current users.