PUT api/v1/VisitorRequests/{id}
Updates a single VisitorRequest that is already in the system. Returns Success/Error code.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
id |
Represents the PK of an existing Visitor Request in BluSKY |
globally unique identifier |
Required |
Body Parameters
AddUpdateVisitorRequestViewModelName | Description | Type | Additional information |
---|---|---|---|
VisitorRequestId |
Conditional: Represents the PK of an existing Visitor Request in BluSKY if calling an Update method. Not used for Add methods |
globally unique identifier |
None. |
GuestPersonId |
Conditional: Represents the PK of an existing Visitor Request Guest in BluSKY if calling an Update method. Not used for Add methods |
globally unique identifier |
None. |
GuestFirstName |
Required: Represents the Guest's first/given name. Max Length = 60 |
string |
Max length: 60 |
GuestLastName |
Required: Represents the Guest's last name / surname. Max Length = 60 |
string |
Max length: 60 |
GuestEmail |
Optional: Represents the email address of the Guest |
string |
None. |
GuestPhone |
Optional: Represents the phone number of the Guest |
string |
None. |
GuestCompanyName |
Optional: Represents the name of the occupancy or vendor instance that the Guest belongs to |
string |
None. |
GroupHashTag |
Optional: Represents the group name that the Guest may belong to (if provided) |
string |
None. |
VisitationPattern |
Required: Represents the visitation pattern that has been requested for the Guest |
string |
None. |
Message |
Optional: Represents a supplemental message that will be viewable by Security/Reception when the Guest arrives |
string |
None. |
VisitorTypeId |
Required: Represents a supplemental message that will be viewable by Security/Reception when the Guest arrives. Retrieve possible values from /Visitor/GetAllVisitorTypes |
globally unique identifier |
None. |
HostPersonId |
Required: Represents the PK of an existing Visitor Request Host in BluSKY. Used for both Add and Update |
globally unique identifier |
None. |
FacilityId |
Required: Represents the PK of the facility that the Guest is expected at. Retrieve possible values from /Facility/GetAllFacilities |
globally unique identifier |
None. |
ACSystemId |
Required: Represents the PK of the Access Control System that the Host is located in. Retrieve possible values from /ACSystem/GetAllSystems |
globally unique identifier |
None. |
Floors |
Optional: Represents the list of floors that the Guest will be allowed to visit if Access Levels are not being used. |
Collection of FloorsViewModel |
None. |
RequestedAccessLevelId |
Optional: Represents an Access Level assignments requested by the Requestor for the Visitor. Retrieve possible values from /AccessLevel/GetAllAccessLevels |
integer |
None. |
Deleted |
Required: Represents whether the Visitor Request is deleted or not. Should be false for Add methods. |
boolean |
None. |
Request Formats
application/json, text/json
{ "VisitorRequestId": "4750ff68-0217-4a3f-b8e3-2fbae5f73903", "GuestPersonId": "7489196b-91c5-4945-97a3-43effa490e70", "GuestFirstName": "sample string 1", "GuestLastName": "sample string 2", "GuestEmail": "sample string 3", "GuestPhone": "sample string 4", "GuestCompanyName": "sample string 5", "GroupHashTag": "sample string 6", "VisitationPattern": "sample string 7", "Message": "sample string 8", "VisitorTypeId": "b90771ae-61ad-4a7f-b5bf-fff274bf0c65", "HostPersonId": "ec9b13c7-52de-4236-93b9-abed7882752d", "FacilityId": "de56e2a4-c92f-41e3-a4d2-eed21f16cf61", "ACSystemId": "261a93d4-3c50-47f2-9bc3-ccb8dfd44f65", "Floors": [ { "FloorId": "3174d016-61d3-4df7-bb8f-7ebc89ac0f1a", "Name": "sample string 2", "PhysicalSequence": 3, "Deleted": true }, { "FloorId": "3174d016-61d3-4df7-bb8f-7ebc89ac0f1a", "Name": "sample string 2", "PhysicalSequence": 3, "Deleted": true } ], "RequestedAccessLevelId": 1, "Deleted": true }
application/xml, text/xml
<AddUpdateVisitorRequestViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers"> <ACSystemId>261a93d4-3c50-47f2-9bc3-ccb8dfd44f65</ACSystemId> <Deleted>true</Deleted> <FacilityId>de56e2a4-c92f-41e3-a4d2-eed21f16cf61</FacilityId> <Floors> <FloorsViewModel> <Deleted>true</Deleted> <FloorId>3174d016-61d3-4df7-bb8f-7ebc89ac0f1a</FloorId> <Name>sample string 2</Name> <PhysicalSequence>3</PhysicalSequence> </FloorsViewModel> <FloorsViewModel> <Deleted>true</Deleted> <FloorId>3174d016-61d3-4df7-bb8f-7ebc89ac0f1a</FloorId> <Name>sample string 2</Name> <PhysicalSequence>3</PhysicalSequence> </FloorsViewModel> </Floors> <GroupHashTag>sample string 6</GroupHashTag> <GuestCompanyName>sample string 5</GuestCompanyName> <GuestEmail>sample string 3</GuestEmail> <GuestFirstName>sample string 1</GuestFirstName> <GuestLastName>sample string 2</GuestLastName> <GuestPersonId>7489196b-91c5-4945-97a3-43effa490e70</GuestPersonId> <GuestPhone>sample string 4</GuestPhone> <HostPersonId>ec9b13c7-52de-4236-93b9-abed7882752d</HostPersonId> <Message>sample string 8</Message> <RequestedAccessLevelId>1</RequestedAccessLevelId> <VisitationPattern>sample string 7</VisitationPattern> <VisitorRequestId>4750ff68-0217-4a3f-b8e3-2fbae5f73903</VisitorRequestId> <VisitorTypeId>b90771ae-61ad-4a7f-b5bf-fff274bf0c65</VisitorTypeId> </AddUpdateVisitorRequestViewModel>
application/x-www-form-urlencoded
Sample not available.
Response Information
Resource Description
AddUpdateVisitorRequestResultName | Description | Type | Additional information |
---|---|---|---|
GuestPersonId |
Represents a person ID of a visitor |
globally unique identifier |
None. |
VisitorRequestInstances |
Contains all existing future visitor request instances for a given request |
Collection of VisitorRequestInstanceViewModel |
None. |
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
{ "GuestPersonId": "cd35a935-b50d-4447-ae7f-f3c8afcb0cdf", "VisitorRequestInstances": [ { "VisitorRequestInstanceId": "91262650-07c3-469a-8409-b2c2a8fc0d25", "VisitorRequestId": "232ea403-cba6-4b6a-9bc0-b256e0697b2a", "DateExpected": "2025-07-26T09:44:56.2313592+00:00", "DateTimeArrived": "2025-07-26T09:44:56.2313592+00:00", "AssignedAccessLevelId": 1, "FirstName": "sample string 4", "LastName": "sample string 5", "MiddleInitial": "sample string 6", "GuestCompany": "sample string 7", "HostPersonId": "9f0aaae2-4068-4550-af8a-871ac9edc92c", "Message": "sample string 9", "sVisitorTypeId": "b739238f-3ae2-41a5-a2d1-b8a1b8c2044b", "GroupHashTag": "sample string 11", "VisitorStatus": 0, "Deleted": true, "Card": { "PersonCardId": "75dedd68-8490-48a9-b9ba-a9cc82eac46f", "CardName": "sample string 2", "CardId": "6d91659a-5bdf-4d05-9c36-0b1844a55a0e", "CardType": 4, "CardACSystemId": "a1be3877-356f-4dd6-bcca-5eca131e2fb9", "CardACSystemName": "sample string 6", "InternalCardNumber": 7, "ExternalCardNumber": "sample string 8", "CardSerialNumber": 1, "FacilityCode": 9, "IssueCode": 10, "PIN": "sample string 11", "Deleted": true, "HidInvitationCode": "sample string 13", "InvitationRedeemedDateTime": "2025-07-26T09:44:56.2313592+00:00", "DateInserted": "2025-07-26T09:44:56.2313592+00:00", "DateUpdated": "2025-07-26T09:44:56.2313592+00:00", "CardActivationStartDateTime": "2025-07-26T09:44:56.2313592+00:00", "CardDeactivationStartDateTime": "2025-07-26T09:44:56.2313592+00:00", "CardUserFlags": 1, "EncryptedMobileCredentials": [ { "MobileKeySetId": "2fc64236-6385-4e5c-af36-6c83c91373d6", "KeyIndex": 2, "EncryptedCredential": "sample string 3" }, { "MobileKeySetId": "2fc64236-6385-4e5c-af36-6c83c91373d6", "KeyIndex": 2, "EncryptedCredential": "sample string 3" } ], "CredentialType": 1 } }, { "VisitorRequestInstanceId": "91262650-07c3-469a-8409-b2c2a8fc0d25", "VisitorRequestId": "232ea403-cba6-4b6a-9bc0-b256e0697b2a", "DateExpected": "2025-07-26T09:44:56.2313592+00:00", "DateTimeArrived": "2025-07-26T09:44:56.2313592+00:00", "AssignedAccessLevelId": 1, "FirstName": "sample string 4", "LastName": "sample string 5", "MiddleInitial": "sample string 6", "GuestCompany": "sample string 7", "HostPersonId": "9f0aaae2-4068-4550-af8a-871ac9edc92c", "Message": "sample string 9", "sVisitorTypeId": "b739238f-3ae2-41a5-a2d1-b8a1b8c2044b", "GroupHashTag": "sample string 11", "VisitorStatus": 0, "Deleted": true, "Card": { "PersonCardId": "75dedd68-8490-48a9-b9ba-a9cc82eac46f", "CardName": "sample string 2", "CardId": "6d91659a-5bdf-4d05-9c36-0b1844a55a0e", "CardType": 4, "CardACSystemId": "a1be3877-356f-4dd6-bcca-5eca131e2fb9", "CardACSystemName": "sample string 6", "InternalCardNumber": 7, "ExternalCardNumber": "sample string 8", "CardSerialNumber": 1, "FacilityCode": 9, "IssueCode": 10, "PIN": "sample string 11", "Deleted": true, "HidInvitationCode": "sample string 13", "InvitationRedeemedDateTime": "2025-07-26T09:44:56.2313592+00:00", "DateInserted": "2025-07-26T09:44:56.2313592+00:00", "DateUpdated": "2025-07-26T09:44:56.2313592+00:00", "CardActivationStartDateTime": "2025-07-26T09:44:56.2313592+00:00", "CardDeactivationStartDateTime": "2025-07-26T09:44:56.2313592+00:00", "CardUserFlags": 1, "EncryptedMobileCredentials": [ { "MobileKeySetId": "2fc64236-6385-4e5c-af36-6c83c91373d6", "KeyIndex": 2, "EncryptedCredential": "sample string 3" }, { "MobileKeySetId": "2fc64236-6385-4e5c-af36-6c83c91373d6", "KeyIndex": 2, "EncryptedCredential": "sample string 3" } ], "CredentialType": 1 } } ], "Value": "87a4a93f-e4d2-4da9-9268-b011c539e867", "ResultCode": 3, "Description": "sample string 4" }
application/xml, text/xml
<AddUpdateVisitorRequestResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers"> <Description>sample string 4</Description> <HttpStatusCode>Continue</HttpStatusCode> <ResultCode>3</ResultCode> <Value>87a4a93f-e4d2-4da9-9268-b011c539e867</Value> <GuestPersonId>cd35a935-b50d-4447-ae7f-f3c8afcb0cdf</GuestPersonId> <VisitorRequestInstances> <VisitorRequestInstanceViewModel> <AssignedAccessLevelId>1</AssignedAccessLevelId> <Card> <CardACSystemId>a1be3877-356f-4dd6-bcca-5eca131e2fb9</CardACSystemId> <CardACSystemName>sample string 6</CardACSystemName> <CardActivationStartDateTime>2025-07-26T09:44:56.2313592+00:00</CardActivationStartDateTime> <CardDeactivationStartDateTime>2025-07-26T09:44:56.2313592+00:00</CardDeactivationStartDateTime> <CardId>6d91659a-5bdf-4d05-9c36-0b1844a55a0e</CardId> <CardName>sample string 2</CardName> <CardSerialNumber>1</CardSerialNumber> <CardType>4</CardType> <CardUserFlags>ActiveCardholderRecord</CardUserFlags> <CredentialType>Proximity</CredentialType> <DateInserted>2025-07-26T09:44:56.2313592+00:00</DateInserted> <DateUpdated>2025-07-26T09:44:56.2313592+00:00</DateUpdated> <EncryptedMobileCredentials> <EncryptedCredentialData> <EncryptedCredential>sample string 3</EncryptedCredential> <KeyIndex>2</KeyIndex> <MobileKeySetId>2fc64236-6385-4e5c-af36-6c83c91373d6</MobileKeySetId> </EncryptedCredentialData> <EncryptedCredentialData> <EncryptedCredential>sample string 3</EncryptedCredential> <KeyIndex>2</KeyIndex> <MobileKeySetId>2fc64236-6385-4e5c-af36-6c83c91373d6</MobileKeySetId> </EncryptedCredentialData> </EncryptedMobileCredentials> <ExternalCardNumber>sample string 8</ExternalCardNumber> <FacilityCode>9</FacilityCode> <HidInvitationCode>sample string 13</HidInvitationCode> <InternalCardNumber>7</InternalCardNumber> <InvitationRedeemedDateTime>2025-07-26T09:44:56.2313592+00:00</InvitationRedeemedDateTime> <IssueCode>10</IssueCode> <PIN>sample string 11</PIN> <PersonCardId>75dedd68-8490-48a9-b9ba-a9cc82eac46f</PersonCardId> </Card> <DateExpected>2025-07-26T09:44:56.2313592+00:00</DateExpected> <DateTimeArrived>2025-07-26T09:44:56.2313592+00:00</DateTimeArrived> <Deleted>true</Deleted> <FirstName>sample string 4</FirstName> <GroupHashTag>sample string 11</GroupHashTag> <GuestCompany>sample string 7</GuestCompany> <HostPersonId>9f0aaae2-4068-4550-af8a-871ac9edc92c</HostPersonId> <LastName>sample string 5</LastName> <Message>sample string 9</Message> <MiddleInitial>sample string 6</MiddleInitial> <VisitorRequestId>232ea403-cba6-4b6a-9bc0-b256e0697b2a</VisitorRequestId> <VisitorRequestInstanceId>91262650-07c3-469a-8409-b2c2a8fc0d25</VisitorRequestInstanceId> <VisitorStatus>NotCheckedIn</VisitorStatus> <sVisitorTypeId>b739238f-3ae2-41a5-a2d1-b8a1b8c2044b</sVisitorTypeId> </VisitorRequestInstanceViewModel> <VisitorRequestInstanceViewModel> <AssignedAccessLevelId>1</AssignedAccessLevelId> <Card> <CardACSystemId>a1be3877-356f-4dd6-bcca-5eca131e2fb9</CardACSystemId> <CardACSystemName>sample string 6</CardACSystemName> <CardActivationStartDateTime>2025-07-26T09:44:56.2313592+00:00</CardActivationStartDateTime> <CardDeactivationStartDateTime>2025-07-26T09:44:56.2313592+00:00</CardDeactivationStartDateTime> <CardId>6d91659a-5bdf-4d05-9c36-0b1844a55a0e</CardId> <CardName>sample string 2</CardName> <CardSerialNumber>1</CardSerialNumber> <CardType>4</CardType> <CardUserFlags>ActiveCardholderRecord</CardUserFlags> <CredentialType>Proximity</CredentialType> <DateInserted>2025-07-26T09:44:56.2313592+00:00</DateInserted> <DateUpdated>2025-07-26T09:44:56.2313592+00:00</DateUpdated> <EncryptedMobileCredentials> <EncryptedCredentialData> <EncryptedCredential>sample string 3</EncryptedCredential> <KeyIndex>2</KeyIndex> <MobileKeySetId>2fc64236-6385-4e5c-af36-6c83c91373d6</MobileKeySetId> </EncryptedCredentialData> <EncryptedCredentialData> <EncryptedCredential>sample string 3</EncryptedCredential> <KeyIndex>2</KeyIndex> <MobileKeySetId>2fc64236-6385-4e5c-af36-6c83c91373d6</MobileKeySetId> </EncryptedCredentialData> </EncryptedMobileCredentials> <ExternalCardNumber>sample string 8</ExternalCardNumber> <FacilityCode>9</FacilityCode> <HidInvitationCode>sample string 13</HidInvitationCode> <InternalCardNumber>7</InternalCardNumber> <InvitationRedeemedDateTime>2025-07-26T09:44:56.2313592+00:00</InvitationRedeemedDateTime> <IssueCode>10</IssueCode> <PIN>sample string 11</PIN> <PersonCardId>75dedd68-8490-48a9-b9ba-a9cc82eac46f</PersonCardId> </Card> <DateExpected>2025-07-26T09:44:56.2313592+00:00</DateExpected> <DateTimeArrived>2025-07-26T09:44:56.2313592+00:00</DateTimeArrived> <Deleted>true</Deleted> <FirstName>sample string 4</FirstName> <GroupHashTag>sample string 11</GroupHashTag> <GuestCompany>sample string 7</GuestCompany> <HostPersonId>9f0aaae2-4068-4550-af8a-871ac9edc92c</HostPersonId> <LastName>sample string 5</LastName> <Message>sample string 9</Message> <MiddleInitial>sample string 6</MiddleInitial> <VisitorRequestId>232ea403-cba6-4b6a-9bc0-b256e0697b2a</VisitorRequestId> <VisitorRequestInstanceId>91262650-07c3-469a-8409-b2c2a8fc0d25</VisitorRequestInstanceId> <VisitorStatus>NotCheckedIn</VisitorStatus> <sVisitorTypeId>b739238f-3ae2-41a5-a2d1-b8a1b8c2044b</sVisitorTypeId> </VisitorRequestInstanceViewModel> </VisitorRequestInstances> </AddUpdateVisitorRequestResult>