PUT api/v1/portals/{portalUid}/customer/candidates/{candidateGuid}/availability/{itemGuid}?overlap={overlap}

Updates the candidate availability in a customer portal.

Request Information

URI Parameters

Name	Description	Type	Additional information
portalUid	the customer portal	globally unique identifier	Required
candidateGuid	the candidate who owns this availability	globally unique identifier	Required
itemGuid	The item to update.	globally unique identifier	Required
overlap	Allow overlapping events	boolean	Default value is False

Body Parameters

The details to update

CandidateAvailability

Name	Description	Type	Additional information
DiaryType	The type of the diary.	globally unique identifier	Required
Summary	The diary summary.	string	Required String length: inclusive between 0 and 100
Description	The diary description.	string	String length: inclusive between 0 and 255
Start	The start date/time.	date	Required
End	The end date/time.	date	None.

Request Formats

application/json, text/json

Sample:

{
  "DiaryType": "7edf8462-67c3-4c3b-b6ed-c012e114cef8",
  "Summary": "sample string 2",
  "Description": "sample string 3",
  "Start": "2025-10-27T13:55:22.3377255+00:00",
  "End": "2025-10-27T13:55:22.3377255+00:00"
}

application/xml, text/xml

Sample:

<CandidateAvailability xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
  <Description>sample string 3</Description>
  <DiaryType>7edf8462-67c3-4c3b-b6ed-c012e114cef8</DiaryType>
  <End>2025-10-27T13:55:22.3377255+00:00</End>
  <Start>2025-10-27T13:55:22.3377255+00:00</Start>
  <Summary>sample string 2</Summary>
</CandidateAvailability>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Returns the updated candidate availability.

CandidateAvailabilityViewModel

Name	Description	Type	Additional information
Candidate	The candidate.	CandidateViewModel	None.
DiaryType	The type of the diary.	DiaryTypeViewModel	None.
Summary	The summary.	string	None.
Description	The description.	string	None.
Start	The start.	date	None.
End	The end.	date	None.
CandidateAvailabilityGuid	Unique, unchanging identifier representing this objct	globally unique identifier	None.
Uid	The GUID.	globally unique identifier	None.
Links	The links.	Collection of Link	None.
DateUpdated	Last time the record was updated	date	None.
UpdatedBy	Who updated the record last	string	None.

Response Formats

application/json, text/json

Sample:

{
  "Candidate": {
    "Title": "sample string 1",
    "Forename": "sample string 2",
    "Surname": "sample string 3",
    "OtherNames": "sample string 4",
    "AddressLine1": "sample string 5",
    "AddressLine2": "sample string 6",
    "AddressLine3": "sample string 7",
    "AddressLine4": "sample string 8",
    "PostCode": "sample string 9",
    "Country": "sample string 10",
    "Telephone": "sample string 11",
    "Mobile": "sample string 12",
    "Email": "sample string 13",
    "Position": "sample string 14",
    "Term": "sample string 15",
    "EarliestStartDate": "2025-10-27T13:55:22.3377255+00:00",
    "Company": {
      "Name": "sample string 1",
      "AddressLine1": "sample string 2",
      "AddressLine2": "sample string 3",
      "AddressLine3": "sample string 4",
      "AddressLine4": "sample string 5",
      "PostCode": "sample string 6",
      "Country": {
        "Iso3Code": "sample string 1",
        "Name": "sample string 2",
        "Portal": {
          "Name": "sample string 1",
          "Uid": "0624b309-5c3d-4a56-9ecc-14ca2eae32e3",
          "Links": [
            {
              "Href": "http://webapihelppage1.com",
              "Method": "sample string 2",
              "Rel": "sample string 3",
              "Title": "sample string 4",
              "Type": "sample string 5"
            },
            {
              "Href": "http://webapihelppage1.com",
              "Method": "sample string 2",
              "Rel": "sample string 3",
              "Title": "sample string 4",
              "Type": "sample string 5"
            }
          ],
          "DateUpdated": "2025-10-27T13:55:22.3377255+00:00",
          "UpdatedBy": "sample string 3"
        },
        "CountryGuid": "3ce1f98b-19e5-4c51-b049-1615f2fed26c",
        "Uid": "950e3e76-b89e-48ec-93ce-f0f80e8ad3df",
        "Links": [
          {
            "Href": "http://webapihelppage1.com",
            "Method": "sample string 2",
            "Rel": "sample string 3",
            "Title": "sample string 4",
            "Type": "sample string 5"
          },
          {
            "Href": "http://webapihelppage1.com",
            "Method": "sample string 2",
            "Rel": "sample string 3",
            "Title": "sample string 4",
            "Type": "sample string 5"
          }
        ],
        "DateUpdated": "2025-10-27T13:55:22.3377255+00:00",
        "UpdatedBy": "sample string 5"
      },
      "Latitude": "sample string 7",
      "Longitude": "sample string 8",
      "PortalUid": "9e9c0816-283c-46a8-8026-1cbc69524bc6",
      "PortalGuid": "e5ba4bb3-94cb-414d-a849-d0703332b829",
      "CompanyGuid": "efda2897-801f-41ca-a580-77f1b516b276",
      "Uid": "51411bf9-0af9-4a33-9f79-134d17f2a07b",
      "Links": [
        {
          "Href": "http://webapihelppage1.com",
          "Method": "sample string 2",
          "Rel": "sample string 3",
          "Title": "sample string 4",
          "Type": "sample string 5"
        },
        {
          "Href": "http://webapihelppage1.com",
          "Method": "sample string 2",
          "Rel": "sample string 3",
          "Title": "sample string 4",
          "Type": "sample string 5"
        }
      ],
      "DateUpdated": "2025-10-27T13:55:22.3377255+00:00",
      "UpdatedBy": "sample string 13"
    },
    "ReferenceNumber": "sample string 16",
    "PrimaryIndustry": "sample string 17",
    "PrimaryDiscipline": "sample string 18",
    "PrimarySubDiscipline": "sample string 19",
    "IsPrimaryIndustryDiscipline": true,
    "PersonalStatement": "sample string 21",
    "Latitude": 1.1,
    "Longitude": 1.1,
    "ReferralSource": "sample string 22",
    "Gender": "sample string 23",
    "Location": "sample string 24",
    "Area": "sample string 25",
    "Region": "sample string 26",
    "EclipseStatus": "sample string 27",
    "EclipseLastUpdated": "2025-10-27T13:55:22.3377255+00:00",
    "ComplianceExpires": "2025-10-27T13:55:22.3377255+00:00",
    "CandidateGuid": "86d1c471-57d5-4049-9f56-9668a54b01b8",
    "DateOfBirth": "2025-10-27T13:55:22.3377255+00:00",
    "Nationality": "sample string 29",
    "EmploymentSought": "sample string 30",
    "MinAnnualSalary": 31.1,
    "MaxAnnualSalary": 32.1,
    "MinHourlyPayrate": 33.1,
    "MaxHourlyPayrate": 34.1,
    "Uid": "1c435d20-3584-4198-b137-7aea956af58e",
    "Links": [
      {
        "Href": "http://webapihelppage1.com",
        "Method": "sample string 2",
        "Rel": "sample string 3",
        "Title": "sample string 4",
        "Type": "sample string 5"
      },
      {
        "Href": "http://webapihelppage1.com",
        "Method": "sample string 2",
        "Rel": "sample string 3",
        "Title": "sample string 4",
        "Type": "sample string 5"
      }
    ],
    "DateUpdated": "2025-10-27T13:55:22.3377255+00:00",
    "UpdatedBy": "sample string 36"
  },
  "DiaryType": {
    "Name": "sample string 1",
    "DiaryTypeGuid": "9e4abfa2-7424-4e2f-a6f7-64f80309539d",
    "Category": {
      "Name": "sample string 1",
      "IsAvailable": true,
      "Uid": "9e5eb71c-eaf4-44b8-815f-54c00f9f7c97",
      "Links": [
        {
          "Href": "http://webapihelppage1.com",
          "Method": "sample string 2",
          "Rel": "sample string 3",
          "Title": "sample string 4",
          "Type": "sample string 5"
        },
        {
          "Href": "http://webapihelppage1.com",
          "Method": "sample string 2",
          "Rel": "sample string 3",
          "Title": "sample string 4",
          "Type": "sample string 5"
        }
      ],
      "DateUpdated": "2025-10-27T13:55:22.3377255+00:00",
      "UpdatedBy": "sample string 4"
    },
    "Uid": "62160914-2dc8-4f95-bd88-a52808e55521",
    "Links": [
      {
        "Href": "http://webapihelppage1.com",
        "Method": "sample string 2",
        "Rel": "sample string 3",
        "Title": "sample string 4",
        "Type": "sample string 5"
      },
      {
        "Href": "http://webapihelppage1.com",
        "Method": "sample string 2",
        "Rel": "sample string 3",
        "Title": "sample string 4",
        "Type": "sample string 5"
      }
    ],
    "DateUpdated": "2025-10-27T13:55:22.3377255+00:00",
    "UpdatedBy": "sample string 4"
  },
  "Summary": "sample string 1",
  "Description": "sample string 2",
  "Start": "2025-10-27T13:55:22.3377255+00:00",
  "End": "2025-10-27T13:55:22.3377255+00:00",
  "CandidateAvailabilityGuid": "d640c698-d9b9-4b7f-87a3-669aa0f3b277",
  "Uid": "031d25f1-c5e4-42e1-8362-30ba37d6329c",
  "Links": [
    {
      "Href": "http://webapihelppage1.com",
      "Method": "sample string 2",
      "Rel": "sample string 3",
      "Title": "sample string 4",
      "Type": "sample string 5"
    },
    {
      "Href": "http://webapihelppage1.com",
      "Method": "sample string 2",
      "Rel": "sample string 3",
      "Title": "sample string 4",
      "Type": "sample string 5"
    }
  ],
  "DateUpdated": "2025-10-27T13:55:22.3377255+00:00",
  "UpdatedBy": "sample string 7"
}

application/xml, text/xml

Sample:

<CandidateAvailabilityViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.ViewModels">
  <DateUpdated>2025-10-27T13:55:22.3377255+00:00</DateUpdated>
  <Links xmlns:d2p1="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
    <d2p1:Link>
      <d2p1:Href>http://webapihelppage1.com/</d2p1:Href>
      <d2p1:Method>sample string 2</d2p1:Method>
      <d2p1:Rel>sample string 3</d2p1:Rel>
      <d2p1:Title>sample string 4</d2p1:Title>
      <d2p1:Type>sample string 5</d2p1:Type>
    </d2p1:Link>
    <d2p1:Link>
      <d2p1:Href>http://webapihelppage1.com/</d2p1:Href>
      <d2p1:Method>sample string 2</d2p1:Method>
      <d2p1:Rel>sample string 3</d2p1:Rel>
      <d2p1:Title>sample string 4</d2p1:Title>
      <d2p1:Type>sample string 5</d2p1:Type>
    </d2p1:Link>
  </Links>
  <Uid>031d25f1-c5e4-42e1-8362-30ba37d6329c</Uid>
  <UpdatedBy>sample string 7</UpdatedBy>
  <Candidate>
    <DateUpdated>2025-10-27T13:55:22.3377255+00:00</DateUpdated>
    <Links xmlns:d3p1="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
      <d3p1:Link>
        <d3p1:Href>http://webapihelppage1.com/</d3p1:Href>
        <d3p1:Method>sample string 2</d3p1:Method>
        <d3p1:Rel>sample string 3</d3p1:Rel>
        <d3p1:Title>sample string 4</d3p1:Title>
        <d3p1:Type>sample string 5</d3p1:Type>
      </d3p1:Link>
      <d3p1:Link>
        <d3p1:Href>http://webapihelppage1.com/</d3p1:Href>
        <d3p1:Method>sample string 2</d3p1:Method>
        <d3p1:Rel>sample string 3</d3p1:Rel>
        <d3p1:Title>sample string 4</d3p1:Title>
        <d3p1:Type>sample string 5</d3p1:Type>
      </d3p1:Link>
    </Links>
    <Uid>1c435d20-3584-4198-b137-7aea956af58e</Uid>
    <UpdatedBy>sample string 36</UpdatedBy>
    <AddressLine1>sample string 5</AddressLine1>
    <AddressLine2>sample string 6</AddressLine2>
    <AddressLine3>sample string 7</AddressLine3>
    <AddressLine4>sample string 8</AddressLine4>
    <Area>sample string 25</Area>
    <CandidateGuid>86d1c471-57d5-4049-9f56-9668a54b01b8</CandidateGuid>
    <Company>
      <DateUpdated>2025-10-27T13:55:22.3377255+00:00</DateUpdated>
      <Links xmlns:d4p1="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
        <d4p1:Link>
          <d4p1:Href>http://webapihelppage1.com/</d4p1:Href>
          <d4p1:Method>sample string 2</d4p1:Method>
          <d4p1:Rel>sample string 3</d4p1:Rel>
          <d4p1:Title>sample string 4</d4p1:Title>
          <d4p1:Type>sample string 5</d4p1:Type>
        </d4p1:Link>
        <d4p1:Link>
          <d4p1:Href>http://webapihelppage1.com/</d4p1:Href>
          <d4p1:Method>sample string 2</d4p1:Method>
          <d4p1:Rel>sample string 3</d4p1:Rel>
          <d4p1:Title>sample string 4</d4p1:Title>
          <d4p1:Type>sample string 5</d4p1:Type>
        </d4p1:Link>
      </Links>
      <Uid>51411bf9-0af9-4a33-9f79-134d17f2a07b</Uid>
      <UpdatedBy>sample string 13</UpdatedBy>
      <AddressLine1>sample string 2</AddressLine1>
      <AddressLine2>sample string 3</AddressLine2>
      <AddressLine3>sample string 4</AddressLine3>
      <AddressLine4>sample string 5</AddressLine4>
      <CompanyGuid>efda2897-801f-41ca-a580-77f1b516b276</CompanyGuid>
      <Country>
        <DateUpdated>2025-10-27T13:55:22.3377255+00:00</DateUpdated>
        <Links xmlns:d5p1="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
          <d5p1:Link>
            <d5p1:Href>http://webapihelppage1.com/</d5p1:Href>
            <d5p1:Method>sample string 2</d5p1:Method>
            <d5p1:Rel>sample string 3</d5p1:Rel>
            <d5p1:Title>sample string 4</d5p1:Title>
            <d5p1:Type>sample string 5</d5p1:Type>
          </d5p1:Link>
          <d5p1:Link>
            <d5p1:Href>http://webapihelppage1.com/</d5p1:Href>
            <d5p1:Method>sample string 2</d5p1:Method>
            <d5p1:Rel>sample string 3</d5p1:Rel>
            <d5p1:Title>sample string 4</d5p1:Title>
            <d5p1:Type>sample string 5</d5p1:Type>
          </d5p1:Link>
        </Links>
        <Uid>950e3e76-b89e-48ec-93ce-f0f80e8ad3df</Uid>
        <UpdatedBy>sample string 5</UpdatedBy>
        <CountryGuid>3ce1f98b-19e5-4c51-b049-1615f2fed26c</CountryGuid>
        <Iso3Code>sample string 1</Iso3Code>
        <Name>sample string 2</Name>
        <Portal>
          <DateUpdated>2025-10-27T13:55:22.3377255+00:00</DateUpdated>
          <Links xmlns:d6p1="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
            <d6p1:Link>
              <d6p1:Href>http://webapihelppage1.com/</d6p1:Href>
              <d6p1:Method>sample string 2</d6p1:Method>
              <d6p1:Rel>sample string 3</d6p1:Rel>
              <d6p1:Title>sample string 4</d6p1:Title>
              <d6p1:Type>sample string 5</d6p1:Type>
            </d6p1:Link>
            <d6p1:Link>
              <d6p1:Href>http://webapihelppage1.com/</d6p1:Href>
              <d6p1:Method>sample string 2</d6p1:Method>
              <d6p1:Rel>sample string 3</d6p1:Rel>
              <d6p1:Title>sample string 4</d6p1:Title>
              <d6p1:Type>sample string 5</d6p1:Type>
            </d6p1:Link>
          </Links>
          <Uid>0624b309-5c3d-4a56-9ecc-14ca2eae32e3</Uid>
          <UpdatedBy>sample string 3</UpdatedBy>
          <Name>sample string 1</Name>
        </Portal>
      </Country>
      <Latitude>sample string 7</Latitude>
      <Longitude>sample string 8</Longitude>
      <Name>sample string 1</Name>
      <PortalGuid>e5ba4bb3-94cb-414d-a849-d0703332b829</PortalGuid>
      <PortalUid>9e9c0816-283c-46a8-8026-1cbc69524bc6</PortalUid>
      <PostCode>sample string 6</PostCode>
    </Company>
    <ComplianceExpires>2025-10-27T13:55:22.3377255+00:00</ComplianceExpires>
    <Country>sample string 10</Country>
    <DateOfBirth>2025-10-27T13:55:22.3377255+00:00</DateOfBirth>
    <EarliestStartDate>2025-10-27T13:55:22.3377255+00:00</EarliestStartDate>
    <EclipseLastUpdated>2025-10-27T13:55:22.3377255+00:00</EclipseLastUpdated>
    <EclipseStatus>sample string 27</EclipseStatus>
    <Email>sample string 13</Email>
    <EmploymentSought>sample string 30</EmploymentSought>
    <Forename>sample string 2</Forename>
    <Gender>sample string 23</Gender>
    <IsPrimaryIndustryDiscipline>true</IsPrimaryIndustryDiscipline>
    <Latitude>1.1</Latitude>
    <Location>sample string 24</Location>
    <Longitude>1.1</Longitude>
    <MaxAnnualSalary>32.1</MaxAnnualSalary>
    <MaxHourlyPayrate>34.1</MaxHourlyPayrate>
    <MinAnnualSalary>31.1</MinAnnualSalary>
    <MinHourlyPayrate>33.1</MinHourlyPayrate>
    <Mobile>sample string 12</Mobile>
    <Nationality>sample string 29</Nationality>
    <OtherNames>sample string 4</OtherNames>
    <PersonalStatement>sample string 21</PersonalStatement>
    <Position>sample string 14</Position>
    <PostCode>sample string 9</PostCode>
    <PrimaryDiscipline>sample string 18</PrimaryDiscipline>
    <PrimaryIndustry>sample string 17</PrimaryIndustry>
    <PrimarySubDiscipline>sample string 19</PrimarySubDiscipline>
    <ReferenceNumber>sample string 16</ReferenceNumber>
    <ReferralSource>sample string 22</ReferralSource>
    <Region>sample string 26</Region>
    <Surname>sample string 3</Surname>
    <Telephone>sample string 11</Telephone>
    <Term>sample string 15</Term>
    <Title>sample string 1</Title>
  </Candidate>
  <CandidateAvailabilityGuid>d640c698-d9b9-4b7f-87a3-669aa0f3b277</CandidateAvailabilityGuid>
  <Description>sample string 2</Description>
  <DiaryType>
    <DateUpdated>2025-10-27T13:55:22.3377255+00:00</DateUpdated>
    <Links xmlns:d3p1="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
      <d3p1:Link>
        <d3p1:Href>http://webapihelppage1.com/</d3p1:Href>
        <d3p1:Method>sample string 2</d3p1:Method>
        <d3p1:Rel>sample string 3</d3p1:Rel>
        <d3p1:Title>sample string 4</d3p1:Title>
        <d3p1:Type>sample string 5</d3p1:Type>
      </d3p1:Link>
      <d3p1:Link>
        <d3p1:Href>http://webapihelppage1.com/</d3p1:Href>
        <d3p1:Method>sample string 2</d3p1:Method>
        <d3p1:Rel>sample string 3</d3p1:Rel>
        <d3p1:Title>sample string 4</d3p1:Title>
        <d3p1:Type>sample string 5</d3p1:Type>
      </d3p1:Link>
    </Links>
    <Uid>62160914-2dc8-4f95-bd88-a52808e55521</Uid>
    <UpdatedBy>sample string 4</UpdatedBy>
    <Category>
      <DateUpdated>2025-10-27T13:55:22.3377255+00:00</DateUpdated>
      <Links xmlns:d4p1="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
        <d4p1:Link>
          <d4p1:Href>http://webapihelppage1.com/</d4p1:Href>
          <d4p1:Method>sample string 2</d4p1:Method>
          <d4p1:Rel>sample string 3</d4p1:Rel>
          <d4p1:Title>sample string 4</d4p1:Title>
          <d4p1:Type>sample string 5</d4p1:Type>
        </d4p1:Link>
        <d4p1:Link>
          <d4p1:Href>http://webapihelppage1.com/</d4p1:Href>
          <d4p1:Method>sample string 2</d4p1:Method>
          <d4p1:Rel>sample string 3</d4p1:Rel>
          <d4p1:Title>sample string 4</d4p1:Title>
          <d4p1:Type>sample string 5</d4p1:Type>
        </d4p1:Link>
      </Links>
      <Uid>9e5eb71c-eaf4-44b8-815f-54c00f9f7c97</Uid>
      <UpdatedBy>sample string 4</UpdatedBy>
      <IsAvailable>true</IsAvailable>
      <Name>sample string 1</Name>
    </Category>
    <DiaryTypeGuid>9e4abfa2-7424-4e2f-a6f7-64f80309539d</DiaryTypeGuid>
    <Name>sample string 1</Name>
  </DiaryType>
  <End>2025-10-27T13:55:22.3377255+00:00</End>
  <Start>2025-10-27T13:55:22.3377255+00:00</Start>
  <Summary>sample string 1</Summary>
</CandidateAvailabilityViewModel>

text/iCal

Sample:

BEGIN:VCALENDAR
VERSION:2.0
BEGIN:VEVENT
UID:031d25f1-c5e4-42e1-8362-30ba37d6329c
DTSTART:20251027T135522Z
DTEND:20251027T135522Z
SUMMARY:sample string 1
END:VEVENT
END:VCALENDAR