PUT api/v1/candidates/{candidateUid}/profile

Updates the candidate profile.

Request Information

URI Parameters

Name	Description	Type	Additional information
candidateUid	The candidate UID.	globally unique identifier	Required

Body Parameters

The candidate.

Candidate

Name	Description	Type	Additional information
Title	The candidate title.	string	String length: inclusive between 0 and 100
Forename	The candidate forename.	string	String length: inclusive between 0 and 100
Surname	The candidate surname.	string	String length: inclusive between 0 and 100
OtherNames	The candidates other names.	string	String length: inclusive between 0 and 100
AddressLine1	The address line1.	string	String length: inclusive between 0 and 100
AddressLine2	The address line2.	string	String length: inclusive between 0 and 100
AddressLine3	The address line3.	string	String length: inclusive between 0 and 100
AddressLine4	The address line4.	string	String length: inclusive between 0 and 100
PostCode	The post code.	string	String length: inclusive between 0 and 50
Country	The post code.	string	String length: inclusive between 0 and 100
Telephone	The candidate telephone.	string	String length: inclusive between 0 and 100
Mobile	The candidate mobile.	string	String length: inclusive between 0 and 100
Email	The candidate email.	string	String length: inclusive between 0 and 100
Position	The candidate employment type e.g. Permanent, Temporary, Contract.	string	String length: inclusive between 0 and 100
Term	The candidate employment term e.g. Full Time, Part Time.	string	String length: inclusive between 0 and 100
EarliestStartDate	The ealiest date a candidate can start work	date	None.
Company	The company.	globally unique identifier	None.
ReferenceNumber	The candidates reference number	string	None.
PrimaryIndustry	The candidates primary industry name	string	None.
PrimaryDiscipline	The candidates primary discipline	string	None.
PrimarySubDiscipline	The candidates sub discipline (if any)	string	None.
IsPrimaryIndustryDiscipline	The candidates primary industry and dicipline	string	None.
PersonalStatement	The candidates personal statement	string	None.
ReferralSource	The candidate referral source	string	None.
DateOfBirth	The candidates dob	date	None.
Nationality	The candidates nationality	string	None.
Gender	The candidates gender	string	None.
EmploymentSought	The employment sought	string	None.
MinAnnualSalary	The candidates min salary	decimal number	None.
MaxAnnualSalary	The candidates max salary	decimal number	None.
MinHourlyPayrate	The candidates min hourly payrate	decimal number	None.
MaxHourlyPayrate	The candidates max hourly payrate	decimal number	None.

Request Formats

application/json, text/json

Sample:

{
  "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-27T14:03:15.2620914+00:00",
  "Company": "2ac8d87d-9920-44b7-94a6-41292b2dcd54",
  "ReferenceNumber": "sample string 17",
  "PrimaryIndustry": "sample string 18",
  "PrimaryDiscipline": "sample string 19",
  "PrimarySubDiscipline": "sample string 20",
  "IsPrimaryIndustryDiscipline": "sample string 21",
  "PersonalStatement": "sample string 22",
  "ReferralSource": "sample string 23",
  "DateOfBirth": "2025-10-27T14:03:15.2620914+00:00",
  "Nationality": "sample string 24",
  "Gender": "sample string 25",
  "EmploymentSought": "sample string 26",
  "MinAnnualSalary": 27.1,
  "MaxAnnualSalary": 28.1,
  "MinHourlyPayrate": 29.1,
  "MaxHourlyPayrate": 30.1
}

application/xml, text/xml

Sample:

<Candidate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
  <AddressLine1>sample string 5</AddressLine1>
  <AddressLine2>sample string 6</AddressLine2>
  <AddressLine3>sample string 7</AddressLine3>
  <AddressLine4>sample string 8</AddressLine4>
  <Company>2ac8d87d-9920-44b7-94a6-41292b2dcd54</Company>
  <Country>sample string 10</Country>
  <DateOfBirth>2025-10-27T14:03:15.2620914+00:00</DateOfBirth>
  <EarliestStartDate>2025-10-27T14:03:15.2620914+00:00</EarliestStartDate>
  <Email>sample string 13</Email>
  <EmploymentSought>sample string 26</EmploymentSought>
  <Forename>sample string 2</Forename>
  <Gender>sample string 25</Gender>
  <IsPrimaryIndustryDiscipline>sample string 21</IsPrimaryIndustryDiscipline>
  <MaxAnnualSalary>28.1</MaxAnnualSalary>
  <MaxHourlyPayrate>30.1</MaxHourlyPayrate>
  <MinAnnualSalary>27.1</MinAnnualSalary>
  <MinHourlyPayrate>29.1</MinHourlyPayrate>
  <Mobile>sample string 12</Mobile>
  <Nationality>sample string 24</Nationality>
  <OtherNames>sample string 4</OtherNames>
  <PersonalStatement>sample string 22</PersonalStatement>
  <Position>sample string 14</Position>
  <PostCode>sample string 9</PostCode>
  <PrimaryDiscipline>sample string 19</PrimaryDiscipline>
  <PrimaryIndustry>sample string 18</PrimaryIndustry>
  <PrimarySubDiscipline>sample string 20</PrimarySubDiscipline>
  <ReferenceNumber>sample string 17</ReferenceNumber>
  <ReferralSource>sample string 23</ReferralSource>
  <Surname>sample string 3</Surname>
  <Telephone>sample string 11</Telephone>
  <Term>sample string 15</Term>
  <Title>sample string 1</Title>
</Candidate>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Updates candidate profile.

CandidateViewModel

Name	Description	Type	Additional information
Title	The candidate title.	string	None.
Forename	The candidate forename.	string	None.
Surname	The candidate surname.	string	None.
OtherNames	The candidate other names.	string	None.
AddressLine1	The candidate address line1.	string	None.
AddressLine2	The candidate address line2.	string	None.
AddressLine3	The candidate address line3.	string	String length: inclusive between 0 and 100
AddressLine4	The candidate address line4.	string	None.
PostCode	The candidate post code.	string	None.
Country	The candidate post code.	string	None.
Telephone	The candidate telephone number.	string	None.
Mobile	The candidate mobile telephone number.	string	None.
Email	The candidate email address.	string	None.
Position	The candidate employment position.	string	None.
Term	The candidate employment term.	string	None.
EarliestStartDate	The earliest date a candidate can start work	date	None.
Company	The company to which the candidate is assigned to.	CompanyViewModel	None.
ReferenceNumber	The candidate reference number.	string	None.
PrimaryIndustry	The candidates primary industry (readonly)	string	None.
PrimaryDiscipline	The candidates primary discipline	string	None.
PrimarySubDiscipline	The candidates sub-discipline	string	None.
IsPrimaryIndustryDiscipline	The candidates primary industry discipline	boolean	None.
PersonalStatement	The candidates personal statement	string	None.
Latitude	The candidates latitude	decimal number	None.
Longitude	The candidates longitude	decimal number	None.
ReferralSource	The original referral source of the candidate	string	None.
Gender	The candidates gender recorded in eclipse	string	None.
Location	The candidates current location	string	None.
Area	The candidates area	string	None.
Region	The candidates region	string	None.
EclipseStatus	The candidates status in Eclispe	string	None.
EclipseLastUpdated	The last date/time the candidate was updated in Eclipse	date	None.
ComplianceExpires	The next date that the candidates compliance expires	date	None.
CandidateGuid	The candidate unique identifier	globally unique identifier	None.
DateOfBirth	The candidates date of birth	date	None.
Nationality	The candidates nationality	string	None.
EmploymentSought	The employment sought	string	None.
MinAnnualSalary	The candidates min salary	decimal number	None.
MaxAnnualSalary	The candidates max salary	decimal number	None.
MinHourlyPayrate	The candidates min hourly payrate	decimal number	None.
MaxHourlyPayrate	The candidates max hourly payrate	decimal number	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:

{
  "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-27T14:03:15.2620914+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": "f5af4089-0683-4ef3-9fde-8fee9b4bfca0",
        "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-27T14:03:15.2620914+00:00",
        "UpdatedBy": "sample string 3"
      },
      "CountryGuid": "66f97f5e-2a32-4097-a66b-070790d9d09a",
      "Uid": "525f1296-6d25-4643-916c-89dcb0c60fb3",
      "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-27T14:03:15.2620914+00:00",
      "UpdatedBy": "sample string 5"
    },
    "Latitude": "sample string 7",
    "Longitude": "sample string 8",
    "PortalUid": "b8128cf6-4b83-4c4a-abe5-873062909f9a",
    "PortalGuid": "66917f18-d68c-40f3-89e2-3acf78aaa215",
    "CompanyGuid": "042ce926-e835-4b1e-a6a5-2032f70c2929",
    "Uid": "667f4bd9-b0a9-4943-a78e-189da0bc31b1",
    "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-27T14:03:15.2620914+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-27T14:03:15.2620914+00:00",
  "ComplianceExpires": "2025-10-27T14:03:15.2620914+00:00",
  "CandidateGuid": "f527c0cd-f0ca-4254-a76e-494c68830a19",
  "DateOfBirth": "2025-10-27T14:03:15.2620914+00:00",
  "Nationality": "sample string 29",
  "EmploymentSought": "sample string 30",
  "MinAnnualSalary": 31.1,
  "MaxAnnualSalary": 32.1,
  "MinHourlyPayrate": 33.1,
  "MaxHourlyPayrate": 34.1,
  "Uid": "5edea249-0ac0-4dfa-ac5b-1dbee522c740",
  "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-27T14:03:15.2620914+00:00",
  "UpdatedBy": "sample string 36"
}

application/xml, text/xml

Sample:

<CandidateViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.ViewModels">
  <DateUpdated>2025-10-27T14:03:15.2620914+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>5edea249-0ac0-4dfa-ac5b-1dbee522c740</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>f527c0cd-f0ca-4254-a76e-494c68830a19</CandidateGuid>
  <Company>
    <DateUpdated>2025-10-27T14:03:15.2620914+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>667f4bd9-b0a9-4943-a78e-189da0bc31b1</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>042ce926-e835-4b1e-a6a5-2032f70c2929</CompanyGuid>
    <Country>
      <DateUpdated>2025-10-27T14:03:15.2620914+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>525f1296-6d25-4643-916c-89dcb0c60fb3</Uid>
      <UpdatedBy>sample string 5</UpdatedBy>
      <CountryGuid>66f97f5e-2a32-4097-a66b-070790d9d09a</CountryGuid>
      <Iso3Code>sample string 1</Iso3Code>
      <Name>sample string 2</Name>
      <Portal>
        <DateUpdated>2025-10-27T14:03:15.2620914+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>f5af4089-0683-4ef3-9fde-8fee9b4bfca0</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>66917f18-d68c-40f3-89e2-3acf78aaa215</PortalGuid>
    <PortalUid>b8128cf6-4b83-4c4a-abe5-873062909f9a</PortalUid>
    <PostCode>sample string 6</PostCode>
  </Company>
  <ComplianceExpires>2025-10-27T14:03:15.2620914+00:00</ComplianceExpires>
  <Country>sample string 10</Country>
  <DateOfBirth>2025-10-27T14:03:15.2620914+00:00</DateOfBirth>
  <EarliestStartDate>2025-10-27T14:03:15.2620914+00:00</EarliestStartDate>
  <EclipseLastUpdated>2025-10-27T14:03:15.2620914+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>
</CandidateViewModel>