Users

List Users

Retrieve a list of users in the authorized scope.

List Users

GET https://ident.provide.services/api/v1/users

Returns a list of users within the authorized scope; requires elevated permissions and will return 403 Forbidden to any user without sufficient permissions.

Headers

NameTypeDescription

authorization

string

bearer scoped to an

Application

,

Organization

or

User

[
    {
        "id": "15679071-4a5e-41e3-a495-5d93b478257b",
        "created_at": "2021-03-24T09:37:55.995881Z",
        "name": "John Young",
        "first_name": "John",
        "last_name": "Young",
        "email": "jyoung@provide.local",
        "permissions": 415,
        "privacy_policy_agreed_at": "2021-02-09T14:37:33.384Z",
        "terms_of_service_agreed_at": "2021-02-09T14:37:33.384Z"
    },
    {
        "id": "45a64d9f-3996-4ab0-9de6-2e8b44ef119c",
        "created_at": "2021-02-09T14:37:28.610184Z",
        "name": Bob Crippen,
        "first_name": "Bob",
        "last_name": "Crippen",
        "email": "bcrippen@provide.local",
        "permissions": 415,
        "privacy_policy_agreed_at": "2021-02-09T14:37:33.384Z",
        "terms_of_service_agreed_at": "2021-02-09T14:37:34.601Z"
    }
]
curl -i \
     -H 'authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7fSwiZXhwIjpudWxsLCJpYXQiOjE1NTk4Nzg1NzQsImp0aSI6IjYzYTJkY2QzLWI5OTgtNDZjNC1hNzFkLTQ5MjU4YTBhYmEyMyIsInN1YiI6ImFwcGxpY2F0aW9uOmNiMjAzN2Y3LTc5ZmMtNDBmNC05NzIwLWFkYTYzNmRhNDE4MyJ9.0LsVj7oTF0KjwbcUhg9a-fQRWB7cGzKJxLIANeX2cWE' \
     https://ident.provide.services/api/v1/users
HTTP/2 200

Create User

Create a new user.

Create User

POST https://ident.provide.services/api/v1/users

Creates a new user.

Authorization is not required to create a user. To create a virtual user, omit the password parameter and include an Application scoped bearer token as authorization with the request.

Headers

NameTypeDescription

authorization

string

bearer ofApplication if a

virtual user is being created

Request Body

NameTypeDescription

email*

string

email address of the User

to be created

password

string

password of the user to be created. If null and an application scoped bearer token is passed, the resulting User will be a virtual user

first_name*

string

first name of the User

to be created

last_name*

string

last name of the User

to be created

{
    "id": "49a02f33-33f2-4d69-a301-ffb1933e77cc",
    "created_at": "2021-02-09T14:37:33.384Z",
    "name": "John Young",
    "first_name": "John",
    "last_name": "Young",
    "email": "johnyoung@provide.local",
    "permissions": 415,
    "privacy_policy_agreed_at": "2021-02-09T14:37:33.384Z",
    "terms_of_service_agreed_at": "2021-02-09T14:37:33.384Z"
}
curl --location --request POST 'https://ident.provide.services/api/v1/users' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "Shanie_Jaskolski@yahoo.com",
    "first_name": "Shanie",
    "last_name": "Jaskolski",
    "password": "pass4testuser$"
}'

Get User Details

Retrieve details for a user.

Get User Detail

GET https://ident.provide.services/api/v1/users/:id

Returns details for a specified user

Path Parameters

NameTypeDescription

id

string

id of the target

User

Headers

NameTypeDescription

authorization

string

bearer scoped to an

Application

,

Organization

or

User

{
    "id": "15679071-4a5e-41e3-a495-5d93b478257b",
    "created_at": "2021-03-24T09:37:55.995881Z",
    "name": "John Young",
    "first_name": "John",
    "last_name": "Young",
    "email": "jyoung@provide.local",
    "permissions": 415,
    "privacy_policy_agreed_at": "2021-02-09T14:37:33.384Z",
    "terms_of_service_agreed_at": "2021-02-09T14:37:33.384Z"
    "metadata": {
        "user_id": "15679071-4a5e-41e3-a495-5d93b478257b",
        "name": "John Young",
        "email": "jyoung@provide.local",
        "email_verified": false,
        "app_metadata": {
            "ident_user_id": "15679071-4a5e-41e3-a495-5d93b478257b"
        },
        "user_metadata": {}
    }
}
curl -i \
     -H 'authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7fSwiZXhwIjpudWxsLCJpYXQiOjE1NTk4Nzg1NzQsImp0aSI6IjYzYTJkY2QzLWI5OTgtNDZjNC1hNzFkLTQ5MjU4YTBhYmEyMyIsInN1YiI6ImFwcGxpY2F0aW9uOmNiMjAzN2Y3LTc5ZmMtNDBmNC05NzIwLWFkYTYzNmRhNDE4MyJ9.0LsVj7oTF0KjwbcUhg9a-fQRWB7cGzKJxLIANeX2cWE' \
     https://ident.provide.services/api/v1/users/efef1044-4958-43bc-903b-28f2bb938037
HTTP/2 200

URL Parameters

ParameterDescription

id

id of the User

Update User

Update a user.

Update User

PUT https://ident.provide.services/api/v1/users/:id

Updates a specified user

Path Parameters

NameTypeDescription

user_id

string

id of the

User

to be updated

Headers

NameTypeDescription

authorization

string

bearer scoped to an

Application, Organization

or User

Request Body

NameTypeDescription

email

string

email of User

to be updated

first_name

string

first name of User

to be updated

last_name

string

last name of User

to be updated

[]
curl -XPUT -i \
     -H 'content-type: application/json' \
     -H 'authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7fSwiZXhwIjpudWxsLCJpYXQiOjE1NTk4Nzg1NzQsImp0aSI6IjYzYTJkY2QzLWI5OTgtNDZjNC1hNzFkLTQ5MjU4YTBhYmEyMyIsInN1YiI6ImFwcGxpY2F0aW9uOmNiMjAzN2Y3LTc5ZmMtNDBmNC05NzIwLWFkYTYzNmRhNDE4MyJ9.0LsVj7oTF0KjwbcUhg9a-fQRWB7cGzKJxLIANeX2cWE' \
     https://ident.provide.services/api/v1/users/efef1044-4958-43bc-903b-28f2bb938037 \
     -d '{}'
HTTP/2 204

URL Parameters

ParameterDescription

id

id of the User

Delete User

Delete a user.

curl -XDELETE -i \
     -H 'content-type: application/json' \
     -H 'authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7fSwiZXhwIjpudWxsLCJpYXQiOjE1NTk4Nzg1NzQsImp0aSI6IjYzYTJkY2QzLWI5OTgtNDZjNC1hNzFkLTQ5MjU4YTBhYmEyMyIsInN1YiI6ImFwcGxpY2F0aW9uOmNiMjAzN2Y3LTc5ZmMtNDBmNC05NzIwLWFkYTYzNmRhNDE4MyJ9.0LsVj7oTF0KjwbcUhg9a-fQRWB7cGzKJxLIANeX2cWE' \
     https://ident.provide.services/api/v1/users/efef1044-4958-43bc-903b-28f2bb938037 \
HTTP/2 204
PreviousTokensNextAuthorization

Last updated