GET /api/v3/users
List Users

Returns all users associated with your company

Examples

[
  {
    "id": "integer",
    "email": "string",
    "first_name": "string",
    "last_name": "string",
    "created_at": "datetime",
    "activated_at": "datetime",
    "deleted_at": "datetime",
  },
  ...
]

Params

Param name Description
token
required

API token for your organization

Validations:

  • Must be a String


GET /api/v3/users/:id
Find User

Returns all of a Users attributes

Errors

Code Description
404 User not found

Examples

201 Response
{
  "id": "integer",
  "email": "string",
  "first_name": "string",
  "last_name": "string",
  "created_at": "datetime",
  "updated_at": "datetime",
  "activated_at": "datetime",
  "reset_code_at": "datetime",
  "state": "string",
  "deleted_at": "datetime",
  "login_count": "integer",
  "last_request_at": "datetime",
  "current_login_at": "datetime",
  "current_login_ip": "string",
  "last_login_ip": "string",
}

Params

Param name Description
token
required

API token for your organization

Validations:

  • Must be a String

id
required

ID of the user

Validations:

  • Must be a Integer


POST /api/v3/users
Create User

Creates a user

Errors

Code Description
300 Error creating user

Examples

201 Response
{
  "id": "integer",
  "email": "string",
  "first_name": "string",
  "last_name": "string",
  "created_at": "datetime",
  "updated_at": "datetime",
  "activated_at": "datetime",
  "reset_code_at": "datetime",
  "state": "string",
  "deleted_at": "datetime",
  "login_count": "integer",
  "last_request_at": "datetime",
  "current_login_at": "datetime",
  "current_login_ip": "string",
  "last_login_ip": "string",
}

300 Response
{
  "errors":{
    "email": ["should look like an email address.","required"],
    "password": ["is too short (minimum is 4 characters)"],
    "first_name": ["required"],
    "last_name": ["required"],
  }
}

Params

Param name Description
token
required

API token for your organization

Validations:

  • Must be a String

email
required

email address of the user

Validations:

  • Must be a String

first_name
required

first name of the user

Validations:

  • Must be a String

last_name
required

last name of the user

Validations:

  • Must be a String

password
required

User's password

Validations:

  • Must be a String


PATCH /api/v3/users/:id
Update User

Updates a user

Errors

Code Description
300 Error creating user
404 User not found

Examples

201 Response
{
  "id": "integer",
  "email": "string",
  "first_name": "string",
  "last_name": "string",
  "created_at": "datetime",
  "updated_at": "datetime",
  "activated_at": "datetime",
  "reset_code_at": "datetime",
  "state": "string",
  "deleted_at": "datetime",
  "login_count": "integer",
  "last_request_at": "datetime",
  "current_login_at": "datetime",
  "current_login_ip": "string",
  "last_login_ip": "string",
}

300 Response
{
  "errors":{
    "email": ["should look like an email address.","required"],
    "password": ["is too short (minimum is 4 characters)"],
    "first_name": ["required"],
    "last_name": ["required"],
  }
}

Params

Param name Description
token
required

API token for your organization

Validations:

  • Must be a String

id
required

ID of the user

Validations:

  • Must be a Integer

email
optional

email address of the user

Validations:

  • Must be a String

first_name
optional

first name of the user

Validations:

  • Must be a String

last_name
optional

last name of the user

Validations:

  • Must be a String

password
optional

User's password

Validations:

  • Must be a String


DELETE /api/v3/users/:id
Delete User

Soft deletes a user, login disabled

Errors

Code Description
404 User not found
501 Not Implemented

Examples

{
  "id": 18696,
}

Params

Param name Description
token
required

API token for your organization

Validations:

  • Must be a String

id
required

ID of the user

Validations:

  • Must be a Integer