POST api/v1/Occupancies

Adds a single Occupancy to the system. Returns Success/Error code plus primary key of Occupancy added.

Request Information

URI Parameters

None.

Body Parameters

Name	Description	Type	Additional information
OccupancyId	Represents the PK of the Occupancy	globally unique identifier	None.
Name	Required: Represents the name of the Occupancy. Max Length = 200	string	None.
FacilityId	Required: Represents the PK of the Facility the Occupancy is located in. Retrieve possible values by calling /Facility/GetAllFacilities	globally unique identifier	None.
CompanyId	Conditional: Represents the PK of the global company that the Occupancy is an instance of, if not passed in POST method, then the company is created on the Fly.	globally unique identifier	None.
StreetAddress1	Represents the primary street address of the Occupancy	string	None.
StreetAddress2	Represents the secondary street address of the Occupancy	string	None.
City	Represents the city of the Occupancy	string	None.
RegionId	Represents the PK of the region (State, Province, County, etc) of the Occupancy. Retrieve possible values by calling /Region/GetAllRegionsByCountryId	globally unique identifier	None.
CountryId	Represents the PK of the country of the Occupancy. Retrieve possible values by calling /Country/GetAllCountries	globally unique identifier	None.
PostalCode	Represents the Postal Code/Zip Code of the Occupancy	string	None.
Website	Represents the URL of the website associated with the Occupancy	string	None.
Phone	Represents the primary phone number of the Occupancy	string	None.
DefaultBadgeTemplateId	Represents the PK of the default Badge Template for the Occupancy	globally unique identifier	None.
Deleted	Represents the deleted status of the Occupancy. Should be false for an Add action,	boolean	None.
EmailAddressDomainFormula	Represents the email address of the Occupancy.	string	None.
sAvailableEmailAddressFormulaTemplateId	Represents the email address formula template id of the Occupancy.	AvailableEmailAddressFormulaTemplateEnum	None.

Request Formats

application/json, text/json

Sample:

{
  "OccupancyId": "489ce2cf-1c24-4a17-a4a8-11b86cf0dd59",
  "Name": "sample string 2",
  "FacilityId": "a8e026c5-4806-4b2a-8bf7-2d988451b8e2",
  "CompanyId": "3f5555f0-5229-4e5e-a8f7-08e7be2eecd8",
  "StreetAddress1": "sample string 4",
  "StreetAddress2": "sample string 5",
  "City": "sample string 6",
  "RegionId": "350b1a45-40b0-4179-8494-9e08c1ea6b1d",
  "CountryId": "a18c4cc2-736f-4d63-b38a-fd09cfbc5f61",
  "PostalCode": "sample string 9",
  "Website": "sample string 10",
  "Phone": "sample string 11",
  "DefaultBadgeTemplateId": "87246b5a-9347-4ee0-8d9f-f80866819493",
  "Deleted": true,
  "EmailAddressDomainFormula": "sample string 13",
  "sAvailableEmailAddressFormulaTemplateId": 0
}

application/xml, text/xml

Sample:

<AddUpdateOccupancyViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <City>sample string 6</City>
  <CompanyId>3f5555f0-5229-4e5e-a8f7-08e7be2eecd8</CompanyId>
  <CountryId>a18c4cc2-736f-4d63-b38a-fd09cfbc5f61</CountryId>
  <DefaultBadgeTemplateId>87246b5a-9347-4ee0-8d9f-f80866819493</DefaultBadgeTemplateId>
  <Deleted>true</Deleted>
  <EmailAddressDomainFormula>sample string 13</EmailAddressDomainFormula>
  <FacilityId>a8e026c5-4806-4b2a-8bf7-2d988451b8e2</FacilityId>
  <Name>sample string 2</Name>
  <OccupancyId>489ce2cf-1c24-4a17-a4a8-11b86cf0dd59</OccupancyId>
  <Phone>sample string 11</Phone>
  <PostalCode>sample string 9</PostalCode>
  <RegionId>350b1a45-40b0-4179-8494-9e08c1ea6b1d</RegionId>
  <StreetAddress1>sample string 4</StreetAddress1>
  <StreetAddress2>sample string 5</StreetAddress2>
  <Website>sample string 10</Website>
  <sAvailableEmailAddressFormulaTemplateId>Custom</sAvailableEmailAddressFormulaTemplateId>
</AddUpdateOccupancyViewModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ResultWithGuid

Name	Description	Type	Additional information
Value	Represents the PK value that was created as a result of an add	globally unique identifier	None.
ResultCode	Represents the result code	integer	None.
Description	Represents a description of the result code	string	None.

Response Formats

application/json, text/json

Sample:

{
  "Value": "b1b26905-6a33-4d84-a62e-ca331f7ed6d2",
  "ResultCode": 2,
  "Description": "sample string 3"
}

application/xml, text/xml

Sample:

<ResultWithGuid xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <Description>sample string 3</Description>
  <HttpStatusCode>Continue</HttpStatusCode>
  <ResultCode>2</ResultCode>
  <Value>b1b26905-6a33-4d84-a62e-ca331f7ed6d2</Value>
</ResultWithGuid>