Managers

This page documents on how to:

Fetch a list of managers
Fetch one manager
Create one manager
Update one manager
Assign one manager to one unit
Unassign one manager from one unit
Destroy one manager

Fetch managers

Fetch a list of managers accounts.

Scope

managers_read

Endpoint

GET /managers

Open in Postman

The payload in this endpoint is paginated. Information will be provided in the headers.

Consult the guide for pagination

Accepted params

All parameters should be in the querystring.

Param	Type	Example Value	Default	Description
`keywords`	`String`	`"Foo Bar"`	`null`	Search from keywords in `first_name`, `last_name` and `email` fields
`order`	`String`	`"created_at"`	`"created_at"`	Chosen field for ordering the data. Available values: [`"created_at"`]
`sort`	`String`	`"desc"`	`"desc"`	Way of sorting the data. Available values: [`"asc"`,`"desc"`]
`page`	`Integer`	`1`	`1`	Page to fetch
`per_page`	`Integer`	`50`	`50`	Quantity of data by page (max value is 50)

Examples

Find the second page of the managers result.

GET https://api.talentview.fr/v2/managers?page=2

View response example

Fetch manager

Fetch one specific Manager account from its id or email address.

Scope

managers_read

Endpoint

GET /managers/:id

Open in Postman

Accepted params

Param	Type	Example Value	Default	Description
`id`	`Integer` or `String`	`1`	-	In the path, `id` or `email` of the `Manager` to fetch.
`embed`	`String`	`units`	`null`	In the querystring, wanted embedded data, separated with comas. Available values: [`units`]

Embedded data

In this endpoint, embedded data can be requested:

units: Manager's Units

Examples

Retrieve all the data of a manager whose id 845.

GET https://api.talentview.fr/v2/managers/845?embed=units

View response example

Create manager

Create a Manager account.

Scope

managers_write

Endpoint

POST /managers

Open in Postman

Accepted params

All parameters should be in the request's body.

Param	Type	Example value	Required	Description
`manager`	`Object`	-	✓	`Manager` data
`manager["email"]`	`String`	`"jane_doe@email.com"`	✓	Email address
`manager["first_name"]`	`String`	`"Jane"`	✗	First name
`manager["last_name"]`	`String`	`"Doe"`	✗	Last name
`manager["locale"]`	`String`	`"fr"`	✗	`Manager`'s language. Available values: [`"fr"`, `"en"`]
`manager["phone_code"]`	`String`	`"33"`	✗	Phone country code
`manager["phone_number"]`	`String`	`"642424242"`	✗	Phone number without country code
`manager["avatar_url"]`	`String`	`"https://foo.bar/url"`	✗	Picture url
`manager["credentials"]`	`Integer`	`1`	✗	Credentials for this account. Avalaible values: [`1`,`2`,`3`,`4`]. See description of the values in managers#credentials.
`manager["is_verified"]`	`Boolean`	`false`	✗	Is the `Manager` verified. Only verified `Manager` can connect to the ATS.
`manager["unit_ids"]`	`Array` of `Integers`	`[1,2]`	✗	`Units` in which this `Manager` belongs.

Examples

Create a manager with basic details

POST https://api.talentview.fr/v2/managers

BODY:

json

{
    "manager":{
        "email":            "jane_doe@email.com",
        "first_name":       "Jane",
        "last_name":        "Doe",
        "locale":           "fr",
        "phone_code":       "33",
        "phone_number":     "601020304",
        "avatar_url":       "https://foo.bar/url",
        "credentials":      1,
        "is_verified":      false,
        "unit_ids":         [1,2]
    }
}

View response example

Update manager

Update one specific Manager account from its id or email address.

Scope

managers_write

Endpoint

PATCH /managers/:id

Open in Postman

Accepted params (in path)

Param	Type	Example value	Required	Description
`id`	`Integer` or `String`	`1`	✓	`id` or `email` of the `Manager` to fetch.

Accepted params (in body)

Param	Type	Example value	Required	Description
`manager`	`Object`	-	✓	`Manager` data
`manager["email"]`	`String`	`"jane_doe@email.com"`	✓	Email address
`manager["first_name"]`	`String`	`"Jane"`	✗	First name
`manager["last_name"]`	`String`	`"Doe"`	✗	Last name
`manager["locale"]`	`String`	`"fr"`	✗	`Manager`'s language. Available values: [`"fr"`, `"en"`]
`manager["phone_code"]`	`String`	`"33"`	✗	Phone country code
`manager["phone_number"]`	`String`	`"642424242"`	✗	Phone number without country code
`manager["avatar_url"]`	`String`	`"https://foo.bar/url"`	✗	Picture url
`manager["credentials"]`	`Integer`	`1`	✗	Credentials for this account. Avalaible values: [`1`,`2`,`3`,`4`]. See description of the values in managers#credentials.
`manager["is_active"]`	`Boolean`	`true`	✗	Is the `Manager` active. Only active and verified `Manager` can connect to the ATS.
`manager["is_verified"]`	`Boolean`	`false`	✗	Is the `Manager` verified. Only active and verified `Manager` can connect to the ATS.

Examples

Retrieve the manager whose email address is "foo@bar.com" and update their name.

URL:

PATCH https://api.talentview.fr/v2/managers/foo@bar.com

BODY:

json

{
    "manager":{
        "first_name":       "John",
        "last_name":        "Cena",
    }
}

View response example

Assign manager to unit

Add an existing Manager account to an existing Unit.

Scope

managers_write

Endpoint

POST /managers/:manager_id/units/:unit_id

Open in Postman

Accepted params

All parameters should be in the path.

Param	Type	Example value	Required	Description
`manager_id`	`Integer` or `String`	1	✓	`id` or `email` of the `Manager` to assign
`unit_id`	`Integer`	1	✓	`id` of the `Unit` in which to assign the `Manager`

Examples

Assign manager with email "perret.amaranthe@example.org" to unit with id 4708

POST https://api.talentview.fr/v2/managers/perret.amaranthe@example.org/units/4708

View response example

Unassign manager from unit

Remove an existing Manager account from an existing Unit.

Scope

managers_write

Endpoint

DELETE /managers/:manager_id/units/:unit_id

Open in Postman

Accepted params

All parameters should be in the path.

Param	Type	Example value	Required	Description
`manager_id`	`Integer` or `String`	1	✓	`id` or `email` of the `Manager` to remove
`unit_id`	`Integer`	1	✓	`id` of the `Unit` from which to remove the `Manager`

Examples

Unassign manager with id 1 from unit with id 2

DELETE https://api.talentview.fr/v2/managers/1/units/2

View response example

Destroy manager

Permanently destroy a Manager account from its id or email address.

Scope

managers_write

Endpoint

DELETE /managers/:id

Open in Postman

INFO

Please note that the deletion is executed asynchronously

Accepted params

Param	Type	Example value	Required	Description
`id`	`Integer` or `String`	`1`	✓	In the path, `id` or `email` of the `Manager` to fetch.

Examples

Delete a manager with id 42

DELETE https://api.talentview.fr/v2/managers/42

View response example

Managers #

Fetch managers #

Scope #

Endpoint #

Accepted params #

Examples #

Fetch manager #

Scope #

Endpoint #

Accepted params #

Embedded data #

Examples #

Create manager #

Scope #

Endpoint #

Accepted params #

Examples #

Update manager #

Scope #

Endpoint #

Accepted params (in path) #

Accepted params (in body) #

Examples #

Assign manager to unit #

Scope #

Endpoint #

Accepted params #

Examples #

Unassign manager from unit #

Scope #

Endpoint #

Accepted params #

Examples #

Destroy manager #

Scope #

Endpoint #

Accepted params #

Examples #

Managers

Fetch managers

Scope

Endpoint

Accepted params

Examples

Fetch manager

Scope

Endpoint

Accepted params

Embedded data

Examples

Create manager

Scope

Endpoint

Accepted params

Examples

Update manager

Scope

Endpoint

Accepted params (in path)

Accepted params (in body)

Examples

Assign manager to unit

Scope

Endpoint

Accepted params

Examples

Unassign manager from unit

Scope

Endpoint

Accepted params

Examples

Destroy manager

Scope

Endpoint

Accepted params

Examples