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

AddUpdateVisitorRequestViewModel

Name	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

Sample:

{
  "VisitorRequestId": "abb0fc8c-a6cf-40c4-8e53-cd82ecbe904c",
  "GuestPersonId": "6ccca8eb-0ce7-45f9-8eaa-6521e64d1611",
  "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": "cf5fcf9a-b25d-44d2-9210-38fab5dc3e02",
  "HostPersonId": "0af86f15-8326-424e-bbb9-eda2168cdaee",
  "FacilityId": "9e4be777-d431-4555-a4a2-3fa624efc31e",
  "ACSystemId": "17ec5ba8-08d5-43fd-afa1-9eaeb61f927f",
  "Floors": [
    {
      "FloorId": "b2a8a420-86b9-4de9-82fd-c84cdff1091d",
      "Name": "sample string 2",
      "PhysicalSequence": 3,
      "Deleted": true
    },
    {
      "FloorId": "b2a8a420-86b9-4de9-82fd-c84cdff1091d",
      "Name": "sample string 2",
      "PhysicalSequence": 3,
      "Deleted": true
    }
  ],
  "RequestedAccessLevelId": 1,
  "Deleted": true
}

application/xml, text/xml

Sample:

<AddUpdateVisitorRequestViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <ACSystemId>17ec5ba8-08d5-43fd-afa1-9eaeb61f927f</ACSystemId>
  <Deleted>true</Deleted>
  <FacilityId>9e4be777-d431-4555-a4a2-3fa624efc31e</FacilityId>
  <Floors>
    <FloorsViewModel>
      <Deleted>true</Deleted>
      <FloorId>b2a8a420-86b9-4de9-82fd-c84cdff1091d</FloorId>
      <Name>sample string 2</Name>
      <PhysicalSequence>3</PhysicalSequence>
    </FloorsViewModel>
    <FloorsViewModel>
      <Deleted>true</Deleted>
      <FloorId>b2a8a420-86b9-4de9-82fd-c84cdff1091d</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>6ccca8eb-0ce7-45f9-8eaa-6521e64d1611</GuestPersonId>
  <GuestPhone>sample string 4</GuestPhone>
  <HostPersonId>0af86f15-8326-424e-bbb9-eda2168cdaee</HostPersonId>
  <Message>sample string 8</Message>
  <RequestedAccessLevelId>1</RequestedAccessLevelId>
  <VisitationPattern>sample string 7</VisitationPattern>
  <VisitorRequestId>abb0fc8c-a6cf-40c4-8e53-cd82ecbe904c</VisitorRequestId>
  <VisitorTypeId>cf5fcf9a-b25d-44d2-9210-38fab5dc3e02</VisitorTypeId>
</AddUpdateVisitorRequestViewModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

AddUpdateVisitorRequestResult

Name	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

Sample:

{
  "GuestPersonId": "89f4dd39-ea21-45e2-a329-a23d594f08d1",
  "VisitorRequestInstances": [
    {
      "VisitorRequestInstanceId": "a37a7959-6c0c-4f70-b350-efa55647ddb3",
      "VisitorRequestId": "61de3f6a-663a-42cd-9e32-8b1bccb30d38",
      "DateExpected": "2025-05-09T17:38:14.792257+00:00",
      "DateTimeArrived": "2025-05-09T17:38:14.792257+00:00",
      "AssignedAccessLevelId": 1,
      "FirstName": "sample string 4",
      "LastName": "sample string 5",
      "MiddleInitial": "sample string 6",
      "GuestCompany": "sample string 7",
      "HostPersonId": "e4893524-be7d-4396-8a90-9f283eb64359",
      "Message": "sample string 9",
      "sVisitorTypeId": "784a3165-de0b-4dee-a0af-4c93764bb08e",
      "GroupHashTag": "sample string 11",
      "VisitorStatus": 0,
      "Deleted": true,
      "Card": {
        "PersonCardId": "ab79a071-404d-4412-9bdd-c011340b3ac1",
        "CardName": "sample string 2",
        "CardId": "e1930693-2f33-4884-bdbf-6feacb89cd7d",
        "CardType": 4,
        "CardACSystemId": "37ccf031-3a5f-4e5c-ad30-e08c8929cb5c",
        "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-05-09T17:38:14.792257+00:00",
        "DateInserted": "2025-05-09T17:38:14.792257+00:00",
        "DateUpdated": "2025-05-09T17:38:14.792257+00:00",
        "CardActivationStartDateTime": "2025-05-09T17:38:14.792257+00:00",
        "CardDeactivationStartDateTime": "2025-05-09T17:38:14.792257+00:00",
        "CardUserFlags": 1,
        "EncryptedMobileCredentials": [
          {
            "MobileKeySetId": "e26de70c-c20b-43d7-bb08-f96c5a7a1a07",
            "KeyIndex": 2,
            "EncryptedCredential": "sample string 3"
          },
          {
            "MobileKeySetId": "e26de70c-c20b-43d7-bb08-f96c5a7a1a07",
            "KeyIndex": 2,
            "EncryptedCredential": "sample string 3"
          }
        ],
        "CredentialType": 1
      }
    },
    {
      "VisitorRequestInstanceId": "a37a7959-6c0c-4f70-b350-efa55647ddb3",
      "VisitorRequestId": "61de3f6a-663a-42cd-9e32-8b1bccb30d38",
      "DateExpected": "2025-05-09T17:38:14.792257+00:00",
      "DateTimeArrived": "2025-05-09T17:38:14.792257+00:00",
      "AssignedAccessLevelId": 1,
      "FirstName": "sample string 4",
      "LastName": "sample string 5",
      "MiddleInitial": "sample string 6",
      "GuestCompany": "sample string 7",
      "HostPersonId": "e4893524-be7d-4396-8a90-9f283eb64359",
      "Message": "sample string 9",
      "sVisitorTypeId": "784a3165-de0b-4dee-a0af-4c93764bb08e",
      "GroupHashTag": "sample string 11",
      "VisitorStatus": 0,
      "Deleted": true,
      "Card": {
        "PersonCardId": "ab79a071-404d-4412-9bdd-c011340b3ac1",
        "CardName": "sample string 2",
        "CardId": "e1930693-2f33-4884-bdbf-6feacb89cd7d",
        "CardType": 4,
        "CardACSystemId": "37ccf031-3a5f-4e5c-ad30-e08c8929cb5c",
        "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-05-09T17:38:14.792257+00:00",
        "DateInserted": "2025-05-09T17:38:14.792257+00:00",
        "DateUpdated": "2025-05-09T17:38:14.792257+00:00",
        "CardActivationStartDateTime": "2025-05-09T17:38:14.792257+00:00",
        "CardDeactivationStartDateTime": "2025-05-09T17:38:14.792257+00:00",
        "CardUserFlags": 1,
        "EncryptedMobileCredentials": [
          {
            "MobileKeySetId": "e26de70c-c20b-43d7-bb08-f96c5a7a1a07",
            "KeyIndex": 2,
            "EncryptedCredential": "sample string 3"
          },
          {
            "MobileKeySetId": "e26de70c-c20b-43d7-bb08-f96c5a7a1a07",
            "KeyIndex": 2,
            "EncryptedCredential": "sample string 3"
          }
        ],
        "CredentialType": 1
      }
    }
  ],
  "Value": "23733461-d677-4b65-b7c4-b29ff2c28f24",
  "ResultCode": 3,
  "Description": "sample string 4"
}

application/xml, text/xml

Sample:

<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>23733461-d677-4b65-b7c4-b29ff2c28f24</Value>
  <GuestPersonId>89f4dd39-ea21-45e2-a329-a23d594f08d1</GuestPersonId>
  <VisitorRequestInstances>
    <VisitorRequestInstanceViewModel>
      <AssignedAccessLevelId>1</AssignedAccessLevelId>
      <Card>
        <CardACSystemId>37ccf031-3a5f-4e5c-ad30-e08c8929cb5c</CardACSystemId>
        <CardACSystemName>sample string 6</CardACSystemName>
        <CardActivationStartDateTime>2025-05-09T17:38:14.792257+00:00</CardActivationStartDateTime>
        <CardDeactivationStartDateTime>2025-05-09T17:38:14.792257+00:00</CardDeactivationStartDateTime>
        <CardId>e1930693-2f33-4884-bdbf-6feacb89cd7d</CardId>
        <CardName>sample string 2</CardName>
        <CardSerialNumber>1</CardSerialNumber>
        <CardType>4</CardType>
        <CardUserFlags>ActiveCardholderRecord</CardUserFlags>
        <CredentialType>Proximity</CredentialType>
        <DateInserted>2025-05-09T17:38:14.792257+00:00</DateInserted>
        <DateUpdated>2025-05-09T17:38:14.792257+00:00</DateUpdated>
        <EncryptedMobileCredentials>
          <EncryptedCredentialData>
            <EncryptedCredential>sample string 3</EncryptedCredential>
            <KeyIndex>2</KeyIndex>
            <MobileKeySetId>e26de70c-c20b-43d7-bb08-f96c5a7a1a07</MobileKeySetId>
          </EncryptedCredentialData>
          <EncryptedCredentialData>
            <EncryptedCredential>sample string 3</EncryptedCredential>
            <KeyIndex>2</KeyIndex>
            <MobileKeySetId>e26de70c-c20b-43d7-bb08-f96c5a7a1a07</MobileKeySetId>
          </EncryptedCredentialData>
        </EncryptedMobileCredentials>
        <ExternalCardNumber>sample string 8</ExternalCardNumber>
        <FacilityCode>9</FacilityCode>
        <HidInvitationCode>sample string 13</HidInvitationCode>
        <InternalCardNumber>7</InternalCardNumber>
        <InvitationRedeemedDateTime>2025-05-09T17:38:14.792257+00:00</InvitationRedeemedDateTime>
        <IssueCode>10</IssueCode>
        <PIN>sample string 11</PIN>
        <PersonCardId>ab79a071-404d-4412-9bdd-c011340b3ac1</PersonCardId>
      </Card>
      <DateExpected>2025-05-09T17:38:14.792257+00:00</DateExpected>
      <DateTimeArrived>2025-05-09T17:38:14.792257+00:00</DateTimeArrived>
      <Deleted>true</Deleted>
      <FirstName>sample string 4</FirstName>
      <GroupHashTag>sample string 11</GroupHashTag>
      <GuestCompany>sample string 7</GuestCompany>
      <HostPersonId>e4893524-be7d-4396-8a90-9f283eb64359</HostPersonId>
      <LastName>sample string 5</LastName>
      <Message>sample string 9</Message>
      <MiddleInitial>sample string 6</MiddleInitial>
      <VisitorRequestId>61de3f6a-663a-42cd-9e32-8b1bccb30d38</VisitorRequestId>
      <VisitorRequestInstanceId>a37a7959-6c0c-4f70-b350-efa55647ddb3</VisitorRequestInstanceId>
      <VisitorStatus>NotCheckedIn</VisitorStatus>
      <sVisitorTypeId>784a3165-de0b-4dee-a0af-4c93764bb08e</sVisitorTypeId>
    </VisitorRequestInstanceViewModel>
    <VisitorRequestInstanceViewModel>
      <AssignedAccessLevelId>1</AssignedAccessLevelId>
      <Card>
        <CardACSystemId>37ccf031-3a5f-4e5c-ad30-e08c8929cb5c</CardACSystemId>
        <CardACSystemName>sample string 6</CardACSystemName>
        <CardActivationStartDateTime>2025-05-09T17:38:14.792257+00:00</CardActivationStartDateTime>
        <CardDeactivationStartDateTime>2025-05-09T17:38:14.792257+00:00</CardDeactivationStartDateTime>
        <CardId>e1930693-2f33-4884-bdbf-6feacb89cd7d</CardId>
        <CardName>sample string 2</CardName>
        <CardSerialNumber>1</CardSerialNumber>
        <CardType>4</CardType>
        <CardUserFlags>ActiveCardholderRecord</CardUserFlags>
        <CredentialType>Proximity</CredentialType>
        <DateInserted>2025-05-09T17:38:14.792257+00:00</DateInserted>
        <DateUpdated>2025-05-09T17:38:14.792257+00:00</DateUpdated>
        <EncryptedMobileCredentials>
          <EncryptedCredentialData>
            <EncryptedCredential>sample string 3</EncryptedCredential>
            <KeyIndex>2</KeyIndex>
            <MobileKeySetId>e26de70c-c20b-43d7-bb08-f96c5a7a1a07</MobileKeySetId>
          </EncryptedCredentialData>
          <EncryptedCredentialData>
            <EncryptedCredential>sample string 3</EncryptedCredential>
            <KeyIndex>2</KeyIndex>
            <MobileKeySetId>e26de70c-c20b-43d7-bb08-f96c5a7a1a07</MobileKeySetId>
          </EncryptedCredentialData>
        </EncryptedMobileCredentials>
        <ExternalCardNumber>sample string 8</ExternalCardNumber>
        <FacilityCode>9</FacilityCode>
        <HidInvitationCode>sample string 13</HidInvitationCode>
        <InternalCardNumber>7</InternalCardNumber>
        <InvitationRedeemedDateTime>2025-05-09T17:38:14.792257+00:00</InvitationRedeemedDateTime>
        <IssueCode>10</IssueCode>
        <PIN>sample string 11</PIN>
        <PersonCardId>ab79a071-404d-4412-9bdd-c011340b3ac1</PersonCardId>
      </Card>
      <DateExpected>2025-05-09T17:38:14.792257+00:00</DateExpected>
      <DateTimeArrived>2025-05-09T17:38:14.792257+00:00</DateTimeArrived>
      <Deleted>true</Deleted>
      <FirstName>sample string 4</FirstName>
      <GroupHashTag>sample string 11</GroupHashTag>
      <GuestCompany>sample string 7</GuestCompany>
      <HostPersonId>e4893524-be7d-4396-8a90-9f283eb64359</HostPersonId>
      <LastName>sample string 5</LastName>
      <Message>sample string 9</Message>
      <MiddleInitial>sample string 6</MiddleInitial>
      <VisitorRequestId>61de3f6a-663a-42cd-9e32-8b1bccb30d38</VisitorRequestId>
      <VisitorRequestInstanceId>a37a7959-6c0c-4f70-b350-efa55647ddb3</VisitorRequestInstanceId>
      <VisitorStatus>NotCheckedIn</VisitorStatus>
      <sVisitorTypeId>784a3165-de0b-4dee-a0af-4c93764bb08e</sVisitorTypeId>
    </VisitorRequestInstanceViewModel>
  </VisitorRequestInstances>
</AddUpdateVisitorRequestResult>