馃尶
Laurel APIs
  • Introduction
  • Guides
    • Authentication
    • Building A Connector
    • Public Api Endpoints
  • Services
    • Identity
      • Oauth
      • Users
    • Ingestion
      • Clients
      • Codes
      • Initiatives
      • Validation Rules
    • Time
      • Clients
      • Code Types
      • Codes
      • Entries
      • Initiatives
      • Validation Rules
Powered by GitBook
On this page
  1. Services
  2. Identity

Users

PreviousOauthNextIngestion

Last updated 3 months ago

returns all users for a customer, filtered by optional search parameter

get
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer's id

Query parameters
searchstringOptional

searches first & last names, nickname, & email using a query

integrationstring 路 enumRequiredPossible values:
Responses
200Success
application/json
Responseone of
or
get
GET /api/v1/customers/{customerId}/users?integration=cloud-assistant-cdr HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*
200Success
{
  "_id": "text",
  "createdAt": "2022-08-12T20:44:48Z",
  "isSuperDelegate": true,
  "email": "user@example.com",
  "firstName": "text",
  "jobTitle": "text",
  "lastName": "text",
  "nickname": "text",
  "updatedAt": "2022-08-12T20:44:48Z",
  "status": "active",
  "customer": {
    "_id": "text",
    "fullName": "text",
    "tenant": {
      "_id": "text",
      "description": "text",
      "name": "iad"
    },
    "customerSegment": "strategic",
    "vertical": "legal"
  },
  "delegators": [
    {
      "_id": "text",
      "firstName": "text",
      "lastName": "text",
      "identities": [
        {
          "type": "aderant",
          "value": "text",
          "customerId": "text"
        }
      ]
    }
  ],
  "delegates": [
    {
      "_id": "text",
      "firstName": "text",
      "lastName": "text"
    }
  ],
  "identities": [
    {
      "type": "aderant",
      "value": "text",
      "customerId": "text"
    }
  ],
  "roles": [
    {
      "_id": "text",
      "name": "text",
      "permissions": [
        {
          "_id": "text",
          "claim": "text",
          "description": "text"
        }
      ]
    }
  ]
}
get
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer's id

Responses
200Success
application/json
get
GET /api/v1/customers/{customerId}/users/lookup HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*
200Success
{
  "type": "aderant",
  "value": "text",
  "customerId": "text"
}

returns a user by its id

get
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer's id

userIdstring 路 objectidRequired

user's id

Responses
200Success
application/json
get
GET /api/v1/customers/{customerId}/users/{userId} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*
200Success
{
  "_id": "text",
  "createdAt": "2022-08-12T20:44:48Z",
  "isSuperDelegate": true,
  "email": "user@example.com",
  "firstName": "text",
  "jobTitle": "text",
  "lastName": "text",
  "nickname": "text",
  "updatedAt": "2022-08-12T20:44:48Z",
  "status": "active",
  "customer": {
    "_id": "text",
    "fullName": "text",
    "tenant": {
      "_id": "text",
      "description": "text",
      "name": "iad"
    },
    "customerSegment": "strategic",
    "vertical": "legal"
  },
  "delegators": [
    {
      "_id": "text",
      "firstName": "text",
      "lastName": "text",
      "identities": [
        {
          "type": "aderant",
          "value": "text",
          "customerId": "text"
        }
      ]
    }
  ],
  "delegates": [
    {
      "_id": "text",
      "firstName": "text",
      "lastName": "text"
    }
  ],
  "identities": [
    {
      "type": "aderant",
      "value": "text",
      "customerId": "text"
    }
  ],
  "roles": [
    {
      "_id": "text",
      "name": "text",
      "permissions": [
        {
          "_id": "text",
          "claim": "text",
          "description": "text"
        }
      ]
    }
  ]
}

deletes a user

delete
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer's id

userIdstring 路 objectidRequired

user's id

Responses
200Success
application/json
delete
DELETE /api/v1/customers/{customerId}/users/{userId} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*
200Success
{
  "_id": "text",
  "createdAt": "2022-08-12T20:44:48Z",
  "isSuperDelegate": true,
  "email": "user@example.com",
  "firstName": "text",
  "jobTitle": "text",
  "lastName": "text",
  "nickname": "text",
  "updatedAt": "2022-08-12T20:44:48Z",
  "status": "active",
  "customer": {
    "_id": "text",
    "fullName": "text",
    "tenant": {
      "_id": "text",
      "description": "text",
      "name": "iad"
    },
    "customerSegment": "strategic",
    "vertical": "legal"
  },
  "delegators": [
    {
      "_id": "text",
      "firstName": "text",
      "lastName": "text",
      "identities": [
        {
          "type": "aderant",
          "value": "text",
          "customerId": "text"
        }
      ]
    }
  ],
  "delegates": [
    {
      "_id": "text",
      "firstName": "text",
      "lastName": "text"
    }
  ],
  "identities": [
    {
      "type": "aderant",
      "value": "text",
      "customerId": "text"
    }
  ],
  "roles": [
    {
      "_id": "text",
      "name": "text",
      "permissions": [
        {
          "_id": "text",
          "claim": "text",
          "description": "text"
        }
      ]
    }
  ]
}
  • GETreturns all users for a customer, filtered by optional search parameter
  • GET/api/v1/customers/{customerId}/users/lookup
  • GETreturns a user by its id
  • PATCHupdates a user
  • DELETEdeletes a user

updates a user

patch
Authorizations
Path parameters
customerIdstring 路 objectidRequired

customer's id

userIdstring 路 objectidRequired

user's id

Body
delegateIdsstring 路 objectid[]Optional

if set, will update users who delegate their work to this user

firstNamestringOptional

if set, will update user's first name

emailstring 路 emailOptional

if set, will update user's email

Example: user@example.com
jobTitlestringOptional

if set, will update user's job title

lastNamestringOptional

if set, will update user's last name

nicknamestringOptional

if set, will update user's nickname, can be empty

roleIdsstring 路 objectid[]Optional

if set, will update roles that are assigned to the user

Responses
200Success
application/json
patch
PATCH /api/v1/customers/{customerId}/users/{userId} HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 212

{
  "delegateIds": [
    "text"
  ],
  "firstName": "text",
  "email": "user@example.com",
  "jobTitle": "text",
  "lastName": "text",
  "nickname": "text",
  "roleIds": [
    "text"
  ],
  "identities": [
    {
      "type": "aderant",
      "value": "text",
      "customerId": "text"
    }
  ]
}
200Success
{
  "_id": "text",
  "createdAt": "2022-08-12T20:44:48Z",
  "isSuperDelegate": true,
  "email": "user@example.com",
  "firstName": "text",
  "jobTitle": "text",
  "lastName": "text",
  "nickname": "text",
  "updatedAt": "2022-08-12T20:44:48Z",
  "status": "active",
  "customer": {
    "_id": "text",
    "fullName": "text",
    "tenant": {
      "_id": "text",
      "description": "text",
      "name": "iad"
    },
    "customerSegment": "strategic",
    "vertical": "legal"
  },
  "delegators": [
    {
      "_id": "text",
      "firstName": "text",
      "lastName": "text",
      "identities": [
        {
          "type": "aderant",
          "value": "text",
          "customerId": "text"
        }
      ]
    }
  ],
  "delegates": [
    {
      "_id": "text",
      "firstName": "text",
      "lastName": "text"
    }
  ],
  "identities": [
    {
      "type": "aderant",
      "value": "text",
      "customerId": "text"
    }
  ],
  "roles": [
    {
      "_id": "text",
      "name": "text",
      "permissions": [
        {
          "_id": "text",
          "claim": "text",
          "description": "text"
        }
      ]
    }
  ]
}