Field Squared API Services

User

Represents a DTO for a user in a workspace. Calls without an ObjectId will retrieve an array of all user objects for the workspace.

The following routes are available for this service:
GET,POST,PUT,DELETE	/{Workspace}/User/{ObjectId}
GET	/{Workspace}/User

**User** Parameters:
Name	Parameter	Data Type	Required
Workspace	path	string	No
TimeZone	body	string	No
ObjectId	path	string	No
VersionId	body	string	No
Created	body	string	No
LastUpdated	body	string	No
BasedOn	body	string	No
ExternalId	body	string	No
Name	body	string	No
Initials	body	string	No
Phone	body	string	No
Email	body	string	No
Password	body	string	No
RequestUser	body	string	No
Location	body	Location	No
UserType	body	string	No
ProposedRoute	body	List<Location>	No
ActualRoute	body	List<Location>	No
Image	body	string	No
UserStatus	body	UserStatus	No
RecordStatus	body	string	No
Documents	body	List<string>	No
SubscribeToEmails	body	bool	No
Address	body	Address	No
SkillTags	body	List<string>	No
Enabled	body	bool	No
UIPrefTaskColumnsOff	body	List<string>	No
UIPrefTaskColumns	body	List<UIColumnPref>	No
Data	body	Dictionary<string, string>	No
Teams	body	List<string>	No
Events	body	List<EventItem>	No
Color	body	string	No
VehicleAsset	body	string	No
ExternalAuth	body	bool	No
CreatedBy	body	string	No
ServiceAccount	body	bool	No
Assets	body	List<string>	No
TfaRequired	body	bool	No
TfaPreference	body	string	No
WorkWeek	body	List<WorkDay>	No
CustomSchedulesEnabled	body	bool	No
CustomSchedules	body	List<CustomSchedule>	No
OverrideSso	body	bool	No

**Location** Parameters:
Name	Parameter	Data Type	Required	Description
y	form	double	No
x	form	double	No

**UserStatus** Enum:
NotStarted
Driving
InProgress
Complete
Blocked

**Address** Parameters:
Name	Parameter	Data Type	Required
Street	form	string	No
Unit	form	string	No
City	form	string	No
State	form	string	No
Zip	form	string	No
ContactTitle	form	string	No
ContactName	form	string	No
ContactPhone	form	string	No
ContactEmail	form	string	No
Location	form	Location	No
SiteName	form	string	No
GeocodeFailed	form	bool	No
Country	form	string	No

**UIColumnPref** Parameters:
Name	Parameter	Data Type	Required	Description
Name	form	string	No
Width	form	double	No

**EventItem** Parameters:
Name	Parameter	Data Type	Required
ObjectId	form	string	No
Date	form	string	No
Location	form	Location	No
Barcode	form	string	No
Details	form	string	No
Type	form	string	No
IsScan	form	bool	No
User	form	string	No
SelectedBy	form	string	No
Status	form	string	No
StatusType	form	string	No
DateCreated	form	string	No
Automatic	form	bool	No

**WorkDay** Parameters:
Name	Parameter	Data Type	Required
DayOfWeek	form	int	No
Start	form	int	No
End	form	int	No
Lunch	form	int	No

**CustomSchedule** Parameters:
Name	Parameter	Data Type	Required
Date	form	string	No
Start	form	int	No
End	form	int	No
Type	form	string	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /{Workspace}/User/{ObjectId} HTTP/1.1 
Host: dev.fieldsquared.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	Workspace: String,
	TimeZone: String,
	ObjectId: String,
	VersionId: String,
	Created: String,
	LastUpdated: String,
	BasedOn: String,
	ExternalId: String,
	Name: String,
	Initials: String,
	Phone: String,
	Email: String,
	Password: String,
	RequestUser: String,
	Location: 
	{
		y: 0,
		x: 0
	},
	UserType: String,
	ProposedRoute: 
	[
		{
			y: 0,
			x: 0
		}
	],
	ActualRoute: 
	[
		{
			y: 0,
			x: 0
		}
	],
	Image: String,
	UserStatus: NotStarted,
	RecordStatus: String,
	Documents: 
	[
		String
	],
	SubscribeToEmails: False,
	Address: 
	{
		Street: String,
		Unit: String,
		City: String,
		State: String,
		Zip: String,
		ContactTitle: String,
		ContactName: String,
		ContactPhone: String,
		ContactEmail: String,
		Location: 
		{
			y: 0,
			x: 0
		},
		SiteName: String,
		GeocodeFailed: False,
		Country: String
	},
	SkillTags: 
	[
		String
	],
	Enabled: False,
	UIPrefTaskColumnsOff: 
	[
		String
	],
	UIPrefTaskColumns: 
	[
		{
			Name: String,
			Width: 0
		}
	],
	Data: 
	{
		String: String
	},
	Teams: 
	[
		String
	],
	Events: 
	[
		{
			ObjectId: String,
			Date: String,
			Location: 
			{
				y: 0,
				x: 0
			},
			Barcode: String,
			Details: String,
			Type: String,
			IsScan: False,
			User: String,
			SelectedBy: String,
			Status: String,
			StatusType: String,
			DateCreated: String,
			Automatic: False
		}
	],
	Color: String,
	VehicleAsset: String,
	ExternalAuth: False,
	CreatedBy: String,
	ServiceAccount: False,
	Assets: 
	[
		String
	],
	TfaRequired: False,
	TfaPreference: String,
	WorkWeek: 
	[
		{
			DayOfWeek: 0,
			Start: 0,
			End: 0,
			Lunch: 0
		}
	],
	CustomSchedulesEnabled: False,
	CustomSchedules: 
	[
		{
			Date: String,
			Start: 0,
			End: 0,
			Type: String
		}
	],
	OverrideSso: False
}