People resources - HearstCorp/rover-wiki GitHub Wiki

People

https://{domain}/v2/people

Properties

Name	Type	Description	Sortable
id	UUID4	Unique resource identifier	yes
title	String	Title	no
first_name	String	First name	yes
middle_name	String	Middle name	no
last_name	String	Last name	yes
suffix	String	Suffix	no
job_title	String	Suffix	yes
default_profile	Integer	Profile id	no
user	Object	User object	no
photo	String	Url to photo	no
site_profiles	Array	Array of associated Profile ids

https://{domain}/v2/people/{personid}/photo

Accepts a POST request with a multipart form with the key of upload

https://{domain}/v2/authors

Properties

Name	Type	Description	Sortable
id	UUID4	Unique resource identifier	yes
created_at	Date	Creation timestamp	no
updated_at	Date	Last update timestamp	no
person	Object	Person object	yes
site	Object	[[Site	Brand resources#sites]] object
profile	Object	Profile object	yes

https://{domain}/v2/profiles

Properties

Name	Type	Description	Sortable
id	UUID4	Unique resource identifier	yes
created_at	Date	Creation timestamp	no
updated_at	Date	Last update timestamp	no
title	String	Title	yes
first_name	String	First name	yes
middle_name	String	Middle name	no
last_name	String	Last name	yes
display_name	String	Name for display	yes
suffix	String	Name suffix	no
job_title	String	Job title	no
bio	String	Profile bio	no
public_email	String	Email address	yes
facebook_username	String	Facebook username	no
twitter_username	String	Twitter username	no
instagram_username	String	Instagram username	no
pinterest_username	String	Instagram username	no
google_author_id	String	Google author id	no
subhead	String	Profile subhead	no
photo	String	Url to photo	no
add_to_new_sites_in	Object	JSON array of brand, unit, and pool UUIDs	no
metadata	Object	Metadata is a JSON object	no

https://{domain}/v2/profiles/{profileid}/photo

Accepts a POST request with a multipart form with the key of upload

https://{domain}/v2/users

Properties

Name	Type	Description	Sortable
id	UUID4	Unique resource identifier	yes
email	String	Unique email address	yes
is_active	Boolean	Designates whether user can login	no
is_staff	Boolean	Gives user active to admin	no
is_superuser	Boolean	Gives user superuser access	no
last_login	Date	Last login date of user	no
person	Object/UUID	Person object	yes
metadata	Object	Metadata is a JSON object	no
date_joined	Date	Date joined timestamp	no
legacy_id	Integer	Legacy identifier	no
preferred_language	Object/UUID	Legacy identifier	yes
add_roles_to_new_sites_in	Object	JSON object mapping role UUIDs to arrays of brand, unit, and pool UUIDs	no
roles	Array	Array of Roles the user has	yes

https://{domain}/v2/roles

Properties

Name	Type	Description	Sortable
id	UUID4	Unique resource identifier	yes
created_at	Date	Creation timestamp	no
updated_at	Date	Last update timestamp	no
name	String	Role name	yes
metadata	Object	Metadata is a JSON object	no
sites	Array	Array of [[Sites	Brand resources#sites]] that are a part of this role

https://{domain}/v2/user-roles

Properties

Name	Type	Description	Sortable
id	UUID4	Unique resource identifier	yes
created_at	Date	Creation timestamp	no
updated_at	Date	Last update timestamp	no
last_seen	Date	Last time seen on this site	no
metadata	Object	Metadata is a JSON object	no
user	Object	User object	yes
site	Integer	[[Site	Brand resources#sites]] id
role	Integer	Role id	yes

https://{domain}/v2/legacy-maps

Properties

Name	Type	Description	Sortable
id	UUID4	Unique resource identifier	yes
created_at	Date	Creation timestamp	no
updated_at	Date	Last update timestamp	no
legacy_id	Integer	Legacy ID	yes
user	Object/UUID	User	yes
person	Object/UUID	Person	yes
profile	Object/UUID	Profile	yes
authors	Array	Array of associated Profile resources	yes