Follow

User Provisioning API (beta)

 

*COMING SOON*

The initial usage of Jostle’s User Provisioning API will be oriented only for integration with Okta.

Jostle's User Provisioning API helps you manage user accounts automatically, saving time and effort and ensuring that your users are up to date. User Provisioning API features include the ability to create, read, update (including disable) and delete users in Jostle.

 

SCIM API

Jostle's User Provisioning API is based on the System for Cross-domain Identity Management (SCIM) 2.0 standard

The content-type for POST, PUT and PATCH operations should be: application/scim+json.

Caller should specify in the Accept header that it accepts application/json.

 

API Calls

The following API calls from the SCIM standard are supported:

OPERATION

PATH

HTTP

METHOD

DESCRIPTION

Get Service Provider Configuration

/ServiceProviderConfig

GET

Metadata service that returns information on details about what part of SCIM is support by our API.

Get Resource Types

/ResourceTypes

GET

Metadata service that returns resource type information for resources that are supported by our API. We only support User and not Group.

Get Resource Type for

/ResourceTypes/User

GET

Metadata service that returns resource type information for User.

Get Schemas

/Schemas

GET

Metadata service that returns schema information for schemas that are supported by our API. We support the SCIM Core User schema and our own User extension schema.

Get Schema for SCIM Core User Type

/Schemas/urn:ietf:

params:scim:schemas:

core:2.0:User

GET

Metadata service that returns schema information for SCIM Core User schema that we support. We currently support a limited number of fields as mentioned later on.

Get Schema for Jostle User Type Extension

/Schemas/urn:ietf:

params:scim:schemas:

extension:jostle:

2.0:User

GET

Metadata service that returns schema information for our User schema extension. Currently this consists of alternateEmail1Label and alternalteEmail2Label

Get User by Id

/Users/{id}

GET

Get User for specified id. The id in our case is the id of the User in login server

Get Users with GET

/Users

GET

Get Users. We don’t support sorting. The only filtering we support is on username with equality operation. We support paging when filtering is not specified.

Get Users with POST

/Users/.search

POST

Get Users. We don’t support sorting. The only filtering we support is on username with equality operation. We support paging when filtering is not specified.

Create User

/Users

POST

Create a User

Delete User

/Users/{id}

DELETE

Delete a User

Update User with PUT

/Users/{id}

PUT

Update User with PUT. This requires that ALL information about the User has to be provided as part of the PUT as all of the User gets updated.

Update User with PATCH

/Users/{id}

PATCH

Update User with PATCH. This allows for updating only the specified fields of a User. The operations supported for fields are “add”, “replace”, and “remove”.

Bulk Operation

/Bulk

POST

Allows for multiple operations to be supported in one request. There can be mixed operations in one request. There is a limit of 50 items per request and a total request size limit of 20MB.

Get on Self

/Me

GET

Get information on the User who owns the key which is used for the request.

Delete Self

/Me

DELETE

Delete the User who owns the key which is used for the request.

Update Self with PUT

/Me

PUT

Update the entire User who owns the key which is used for the request.

Update Self with PATCH

/Me

PATCH

Update the specified fields in User who owns the key which is used for the request.

 

User Resource

The fields that are supported in the initial release of Jostle's User Provisioning API are as follows:

  • username
  • first name
  • last name
  • disabled
  • work email
  • personal email
  • alternate email 1 label
  • alternate email 1
  • alternate email 2 label
  • alternate email 2
  • preferred email type (email designated as primary in SCIM)
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.