GET /api/users/:user_id/employees

list users for whom the user is the manager

Success Response Code: 200

Params

Param name Description
user_id
required

id of the user


Value: Must be a String
page
optional

page number to view (default=1)


Value: Must be a Integer
per_page
optional

number of users to be returned per page (default=20, max=500)


Value: Must be a Integer

Response Fields

users list of employee users (see #show for details) Array<User>

Example Curl Commands

curl -X GET -v --basic -u "emily@socialcast.com:demo" "https://demo.socialcast.com/api/users/31/employees.json"

Examples

GET /api/users/52/employees.json
200
{
  "users": [
    {
      "contact_info": {
        "email": "active'46@socialcast.com"
      },
      "manager": {
        "id": 52,
        "first_name": "J'øhn48",
        "last_name": "D'øe48",
        "name": "J'øhn48 D'øe48",
        "html_name": "J&#39;øhn48 D&#39;øe48",
        "url": "https://socialcast.socialcast.test/users/52-j%C3%B8hn48d%C3%B8e48",
        "avatars": {
          "is_system_default": false,
          "id": 4,
          "square16": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square16.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=ed43ae9e0f1e29a61a74ad4af415033286600531f1a93d01fda06a26c63dca74",
          "square30": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square30.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=ccb32c0a6ead9a65601a26d71dcd68eb5bd7c2e8ebbbdafb1bbdb7aef907ce09",
          "square45": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square45.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=f7467d9432685f76e04c6ffccf9a6da990a9b2a362ec919266e3ecc1600816b5",
          "square70": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square70.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=5184edd82c23f9d8ddca11b7bb3cb11e25a66dc3ab38cfafd9ea3ac8633315c7",
          "square140": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square140.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=f605b2db2b64471130b6c632849d683cffa02320531c25acb34f86984c13a26e",
          "original": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=d70eb1d7c11f83fb8169168634a34f836f52d533e36b6f4eb9411c5024bf6bf6"
        },
        "username": "Jøhn48Døe48",
        "active": true,
        "terminated": false,
        "inactive": false,
        "role": "member",
        "type": "User",
        "title": null,
        "out_of_office": false,
        "out_of_office_on": null,
        "back_in_office_on": null,
        "company_login": null
      },
      "custom_fields": [],
      "followable": false,
      "contact_id": null,
      "following_count": 0,
      "followers_count": 0,
      "status_message": null,
      "id": 50,
      "first_name": "J'øhn46",
      "last_name": "Aardvark",
      "name": "J'øhn46 Aardvark",
      "html_name": "J&#39;øhn46 Aardvark",
      "url": "https://socialcast.socialcast.test/users/50-j%C3%B8hn46aardvark",
      "avatars": {
        "is_system_default": false,
        "id": 4,
        "square16": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square16.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=ed43ae9e0f1e29a61a74ad4af415033286600531f1a93d01fda06a26c63dca74",
        "square30": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square30.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=ccb32c0a6ead9a65601a26d71dcd68eb5bd7c2e8ebbbdafb1bbdb7aef907ce09",
        "square45": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square45.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=f7467d9432685f76e04c6ffccf9a6da990a9b2a362ec919266e3ecc1600816b5",
        "square70": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square70.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=5184edd82c23f9d8ddca11b7bb3cb11e25a66dc3ab38cfafd9ea3ac8633315c7",
        "square140": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square140.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=f605b2db2b64471130b6c632849d683cffa02320531c25acb34f86984c13a26e",
        "original": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=d70eb1d7c11f83fb8169168634a34f836f52d533e36b6f4eb9411c5024bf6bf6"
      },
      "username": "Jøhn46Aardvark",
      "active": true,
      "terminated": false,
      "inactive": false,
      "role": "member",
      "type": "User",
      "title": null,
      "out_of_office": false,
      "out_of_office_on": null,
      "back_in_office_on": null,
      "company_login": null
    },
    {
      "contact_info": {
        "email": "active'49@socialcast.com"
      },
      "manager": {
        "id": 52,
        "first_name": "J'øhn48",
        "last_name": "D'øe48",
        "name": "J'øhn48 D'øe48",
        "html_name": "J&#39;øhn48 D&#39;øe48",
        "url": "https://socialcast.socialcast.test/users/52-j%C3%B8hn48d%C3%B8e48",
        "avatars": {
          "is_system_default": false,
          "id": 4,
          "square16": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square16.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=ed43ae9e0f1e29a61a74ad4af415033286600531f1a93d01fda06a26c63dca74",
          "square30": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square30.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=ccb32c0a6ead9a65601a26d71dcd68eb5bd7c2e8ebbbdafb1bbdb7aef907ce09",
          "square45": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square45.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=f7467d9432685f76e04c6ffccf9a6da990a9b2a362ec919266e3ecc1600816b5",
          "square70": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square70.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=5184edd82c23f9d8ddca11b7bb3cb11e25a66dc3ab38cfafd9ea3ac8633315c7",
          "square140": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square140.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=f605b2db2b64471130b6c632849d683cffa02320531c25acb34f86984c13a26e",
          "original": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=d70eb1d7c11f83fb8169168634a34f836f52d533e36b6f4eb9411c5024bf6bf6"
        },
        "username": "Jøhn48Døe48",
        "active": true,
        "terminated": false,
        "inactive": false,
        "role": "member",
        "type": "User",
        "title": null,
        "out_of_office": false,
        "out_of_office_on": null,
        "back_in_office_on": null,
        "company_login": null
      },
      "custom_fields": [],
      "followable": true,
      "contact_id": null,
      "following_count": 0,
      "followers_count": 0,
      "status_message": null,
      "id": 53,
      "first_name": "J'øhn49",
      "last_name": "Zebra",
      "name": "J'øhn49 Zebra",
      "html_name": "J&#39;øhn49 Zebra",
      "url": "https://socialcast.socialcast.test/users/53-j%C3%B8hn49zebra",
      "avatars": {
        "is_system_default": false,
        "id": 4,
        "square16": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square16.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=ed43ae9e0f1e29a61a74ad4af415033286600531f1a93d01fda06a26c63dca74",
        "square30": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square30.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=ccb32c0a6ead9a65601a26d71dcd68eb5bd7c2e8ebbbdafb1bbdb7aef907ce09",
        "square45": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square45.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=f7467d9432685f76e04c6ffccf9a6da990a9b2a362ec919266e3ecc1600816b5",
        "square70": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square70.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=5184edd82c23f9d8ddca11b7bb3cb11e25a66dc3ab38cfafd9ea3ac8633315c7",
        "square140": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails_square140.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=f605b2db2b64471130b6c632849d683cffa02320531c25acb34f86984c13a26e",
        "original": "https://s3.amazonaws.com/socialcast_test/tenants/1/profile_photos/4/rails.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20180921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20180921T234500Z&X-Amz-Expires=518400&X-Amz-SignedHeaders=host&X-Amz-Signature=d70eb1d7c11f83fb8169168634a34f836f52d533e36b6f4eb9411c5024bf6bf6"
      },
      "username": "Jøhn49Zebra",
      "active": true,
      "terminated": false,
      "inactive": false,
      "role": "member",
      "type": "User",
      "title": null,
      "out_of_office": false,
      "out_of_office_on": null,
      "back_in_office_on": null,
      "company_login": null
    }
  ]
}