Identity Provider Users

Get list of identity provider users

GET/Owners/{ownerAccountId}/IdentityProviders/{ipId}/Users

Get a list of all registered users of the specified identity provider.

Scope

read:ip:users

Parameters

Name Type Location Description
ownerAccountId string path The owner account's ID.
ipId string path The identity provider ID as generated during the registration process.

Response

200 OK
[
  {
    "id": "1",
    "ipId": "1",
    "ipUserId": "abc",
    "email": null,
    "status": "Normal"
  },
  {
    "id": "2",
    "ipId": "1",
    "ipUserId": "def",
    "email": null,
    "status": "Normal"
  }
]

Get user by Tapkey user ID

GET/Owners/{ownerAccountId}/IdentityProviders/{ipId}/Users/{id}

Get a registered user of the specified identity provider by Tapkey user ID.

Scope

read:ip:users

Parameters

Name Type Location Description
ownerAccountId string path The owner account's ID.
ipId string path The identity provider ID as generated during the registration process.
id string path The user ID as generated by Tapkey.

Response

200 OK
{
  "id": "1",
  "ipId": "1",
  "ipUserId": "abc",
  "email": null,
  "status": "Normal"
}

Get user by identity provider user ID

GET/Owners/{ownerAccountId}/IdentityProviders/{ipId}/Users?ipUserId={ipUserId}

Get a registered user of the specified identity provider by identity provider user ID.

Scope

read:ip:users

Parameters

Name Type Location Description
ownerAccountId string path The owner account's ID.
ipId string path The identity provider ID as generated during the registration process.
ipUserId string query The user ID coming from the external identity provider.

Response

200 OK
{
  "id": "1",
  "ipId": "1",
  "ipUserId": "abc",
  "email": null,
  "status": "Normal"
}

Create identity provider user

PUT/Owners/{ownerAccountId}/IdentityProviders/{ipId}/Users

Create a new user for the specified identity provider.

Scope

write:ip:users

Parameters

Name Type Location Description
ownerAccountId string path The owner account's ID.
ipId string path The identity provider ID as generated during the registration process.

Body

{
  "ipId": "1",
  "ipUserId": "abc"
}

Response

200 OK
{
  "id": "1",
  "ipId": "1",
  "ipUserId": "abc",
  "email": null,
  "status": "Normal"
}

Info

The ipId in the post body is optional. If specified, it must match the one in the path parameter.

Warning

This operation will fail with 400 - User already exists when calling again with the same parameters and body.