Skip to main content
PATCH
/
v2
/
resumes
/
{identifier}
Update a resume's data
curl --request PATCH \
  --url https://{region}.affinda.com/v2/resumes/{identifier} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": {
    "raw": "Tim A. Smith",
    "first": "Tim",
    "last": "Smith",
    "middle": "A.",
    "title": "Dr"
  },
  "phoneNumbers": [
    "(704) 996-9966",
    "+61412632636"
  ],
  "phoneNumberDetails": [
    {
      "rawText": "+61412632636",
      "formattedNumber": "+61 412 632 636",
      "countryCode": "AU",
      "internationalCountryCode": 61,
      "nationalNumber": "0412 632 636"
    }
  ],
  "websites": [
    "www.timsmith.com"
  ],
  "emails": [
    "timsmith@vt.edu"
  ],
  "dateOfBirth": "1992-01-01",
  "location": {
    "rawInput": "Blacksburg, VA"
  },
  "objective": "",
  "languages": [
    "English",
    "French",
    "Arabic"
  ],
  "summary": "",
  "totalYearsExperience": 13,
  "education": [
    {
      "id": 2,
      "organization": "Virginia Polytechnic Institute and State University (Virginia Tech)",
      "accreditation": {
        "education": "Bachelor of Science"
      },
      "grade": {
        "raw": "GPA : 3.35",
        "metric": "GPA",
        "value": "3.35"
      },
      "location": {
        "rawInput": "Blacksburg, VA"
      },
      "dates": {
        "completionDate": "2021-05-01",
        "isCurrent": true,
        "startDate": "2019-05-01",
        "rawText": "May-Aug '\''18"
      }
    }
  ],
  "workExperience": [
    {
      "id": 2,
      "jobTitle": "Sales and retail assistants",
      "organization": "General Motors",
      "location": {
        "rawInput": "Blacksburg, VA"
      },
      "jobDescription": "Interned with supercar Development from May 2017 to August 2017.",
      "dates": {
        "startDate": "2018-05-01",
        "endDate": "2018-08-01",
        "monthsInPosition": 1,
        "isCurrent": true,
        "rawText": "May-Aug '\''18"
      }
    }
  ],
  "skills": [
    {
      "id": 2,
      "name": "Applied Mechanics",
      "lastUsed": "2012-01-01",
      "numberOfMonths": 12
    }
  ],
  "certifications": [
    "Certificate in AWS"
  ],
  "publications": [
    "Tim Smith et al., Investigations of nanoparticles in the pathology of the human eye, Cell 2014"
  ],
  "referees": [
    {
      "name": "Stephen Smith",
      "text": "Stephen Smith, Team Member/Mentor, Company Power Generation: stephen.smith@company.com",
      "email": "stephen.smith@company.com",
      "number": "+61490667215",
      "position": "Principal"
    }
  ],
  "rawText": "Christopher Nolan 3210 fake street '\''... <rest of resume text>'\''",
  "redactedText": "**** Objective: To obtain a job '\''... <rest of resume text>'\''"
}'
{
  "name": {
    "raw": "Tim A. Smith",
    "first": "Tim",
    "last": "Smith",
    "middle": "A.",
    "title": "Dr"
  },
  "phoneNumbers": [
    "(704) 996-9966",
    "+61412632636"
  ],
  "phoneNumberDetails": [
    {
      "rawText": "+61412632636",
      "formattedNumber": "+61 412 632 636",
      "countryCode": "AU",
      "internationalCountryCode": 61,
      "nationalNumber": "0412 632 636"
    }
  ],
  "websites": [
    "www.timsmith.com"
  ],
  "emails": [
    "timsmith@vt.edu"
  ],
  "dateOfBirth": "1992-01-01",
  "location": {
    "formatted": "Blacksburg, VA, USA",
    "postalCode": "3124",
    "state": "Virginia",
    "stateCode": "TX",
    "country": "United States",
    "countryCode": "US",
    "rawInput": "Blacksburg, VA",
    "streetNumber": "1",
    "street": "Smith St",
    "apartmentNumber": "12",
    "city": "Blacksburg",
    "latitude": "67.0124",
    "longitude": "67.0124",
    "poBox": "P.O. Box 123"
  },
  "objective": "",
  "languages": [
    "English",
    "French",
    "Arabic"
  ],
  "languageCodes": [
    "en",
    "fr",
    "ar"
  ],
  "summary": "",
  "totalYearsExperience": 13,
  "headShot": "aSDinaTvuI8gbWludGxpZnk=",
  "education": [
    {
      "id": 2,
      "organization": "Virginia Polytechnic Institute and State University (Virginia Tech)",
      "accreditation": {
        "education": "Bachelor of Science",
        "inputStr": "Bachelor of Science, Mechanical Engineering, expected",
        "matchStr": "Bachelor of Science",
        "educationLevel": "bachelors"
      },
      "grade": {
        "raw": "GPA : 3.35",
        "metric": "GPA",
        "value": "3.35"
      },
      "location": {
        "formatted": "Blacksburg, VA, USA",
        "postalCode": "3124",
        "state": "Virginia",
        "stateCode": "TX",
        "country": "United States",
        "countryCode": "US",
        "rawInput": "Blacksburg, VA",
        "streetNumber": "1",
        "street": "Smith St",
        "apartmentNumber": "12",
        "city": "Blacksburg",
        "latitude": "67.0124",
        "longitude": "67.0124",
        "poBox": "P.O. Box 123"
      },
      "dates": {
        "completionDate": "2021-05-01",
        "isCurrent": true,
        "startDate": "2019-05-01",
        "rawText": "May-Aug '18"
      }
    }
  ],
  "profession": "Software Developer",
  "linkedin": "https://www.linkedin.com/in/user-name",
  "workExperience": [
    {
      "id": 2,
      "jobTitle": "Sales and retail assistants",
      "socCode": "7111",
      "socName": "Sales and retail assistants",
      "organization": "General Motors",
      "industry": "Automotive",
      "location": {
        "formatted": "Blacksburg, VA, USA",
        "postalCode": "3124",
        "state": "Virginia",
        "stateCode": "TX",
        "country": "United States",
        "countryCode": "US",
        "rawInput": "Blacksburg, VA",
        "streetNumber": "1",
        "street": "Smith St",
        "apartmentNumber": "12",
        "city": "Blacksburg",
        "latitude": "67.0124",
        "longitude": "67.0124",
        "poBox": "P.O. Box 123"
      },
      "jobDescription": "Interned with supercar Development from May 2017 to August 2017.",
      "dates": {
        "startDate": "2018-05-01",
        "endDate": "2018-08-01",
        "monthsInPosition": 1,
        "isCurrent": true,
        "rawText": "May-Aug '18"
      },
      "occupation": {
        "jobTitle": "Sr. Software Developer",
        "jobTitleNormalized": "Software Developer",
        "emsiId": "ETE2AD3A1C11B4EC9B",
        "managementLevel": "Low",
        "classification": {
          "title": "Book-keepers, payroll managers and wages clerks",
          "minorGroup": "Administrative Occupations: Finance",
          "subMajorGroup": "ADMINISTRATIVE OCCUPATIONS",
          "majorGroup": "ADMINISTRATIVE AND SECRETARIAL OCCUPATIONS",
          "socCode": 4122,
          "minorGroupCode": 4122,
          "subMajorGroupCode": 4122,
          "majorGroupCode": 4122
        }
      }
    }
  ],
  "skills": [
    {
      "id": 2,
      "emsiId": "KS1218W78FGVPVP2KXPX",
      "name": "Applied Mechanics",
      "lastUsed": "2012-01-01",
      "numberOfMonths": 12,
      "type": "hard_skill",
      "count": 10,
      "weighting": 0.057699221573302296,
      "sources": [
        {
          "section": "WorkExperience",
          "position": 0,
          "workExperienceId": 1234
        }
      ]
    }
  ],
  "certifications": [
    "Certificate in AWS"
  ],
  "publications": [
    "Tim Smith et al., Investigations of nanoparticles in the pathology of the human eye, Cell 2014"
  ],
  "referees": [
    {
      "name": "Stephen Smith",
      "text": "Stephen Smith, Team Member/Mentor, Company Power Generation: stephen.smith@company.com",
      "email": "stephen.smith@company.com",
      "number": "+61490667215",
      "position": "Principal"
    }
  ],
  "sections": [
    {
      "sectionType": "PersonalDetails",
      "bbox": [
        0,
        36.392,
        612,
        111.056
      ],
      "pageIndex": 0,
      "text": "<All text from the {sectionType} section>"
    }
  ],
  "isResumeProbability": 98,
  "rawText": "Christopher Nolan 3210 fake street '... <rest of resume text>'",
  "redactedText": "**** Objective: To obtain a job '... <rest of resume text>'"
}

Authorizations

​
Authorization
string
header
required

Basic authentication using an API key, e.g. {Authorization: Bearer 75z0bb4fbdf97b7e4111ff6c0015471094155f91}. You can find your API key within the Settings page of the Affinda web app. You can obtain an API key by signing up for a free trial.

Path Parameters

​
identifier
string
required

Resume identifier

Body

application/json

Resume data to update

A JSON-encoded string of the ResumeData object.

​
name
object | null
​
phoneNumbers
string[]
Example:
["(704) 996-9966", "+61412632636"]
​
phoneNumberDetails
object[]
​
websites
string[]
Example:
["www.timsmith.com"]
​
emails
string<email>[]
Example:
["timsmith@vt.edu"]
​
dateOfBirth
string | null
Example:

"1992-01-01"

​
location
object | null
​
objective
string | null
default:""
​
languages
enum<string>[]
Example:
["English", "French", "Arabic"]
​
summary
string | null
default:""
​
totalYearsExperience
integer | null
Required range: x >= 0
Example:

13

​
education
object[]
​
workExperience
object[]
​
skills
object[]
​
certifications
string[]
Example:
["Certificate in AWS"]
​
publications
string[]
Example:
[
  "Tim Smith et al., Investigations of nanoparticles in the pathology of the human eye, Cell 2014"
]
​
referees
object[]
​
rawText
string

All of the raw text of the parsed resume, example is shortened for readability

Example:

"Christopher Nolan 3210 fake street '... <rest of resume text>'"

​
redactedText
string

Redacted version of the text in the resume, removing PII.

Example:

"**** Objective: To obtain a job '... <rest of resume text>'"

​
{key}

For custom fields. E.g. 'isAvailable': true

Response

Successfully updated resume data

A JSON-encoded string of the ResumeData object.

​
name
object | null
​
phoneNumbers
string[]
Example:
["(704) 996-9966", "+61412632636"]
​
phoneNumberDetails
object[]
​
websites
string[]
Example:
["www.timsmith.com"]
​
emails
string<email>[]
Example:
["timsmith@vt.edu"]
​
dateOfBirth
string | null
Example:

"1992-01-01"

​
location
object | null
​
objective
string | null
default:""
​
languages
enum<string>[]
Example:
["English", "French", "Arabic"]
​
languageCodes
string[]
Example:
["en", "fr", "ar"]
​
summary
string | null
default:""
​
totalYearsExperience
integer | null
Required range: x >= 0
Example:

13

​
headShot
string<byte> | null

base64 encoded string

​
education
object[]
​
profession
string | null

Prediction of the candidate's profession based on recent work experience

Example:

"Software Developer"

​
linkedin
string | null

Linkedin account associated with the candidate

Example:

"https://www.linkedin.com/in/user-name"

​
workExperience
object[]
​
skills
object[]
​
certifications
string[]
Example:
["Certificate in AWS"]
​
publications
string[]
Example:
[
  "Tim Smith et al., Investigations of nanoparticles in the pathology of the human eye, Cell 2014"
]
​
referees
object[]
​
sections
object[]
​
isResumeProbability
integer | null

Probability that the given document is a resume. Values below 30 suggest that the document is not a resume.

Required range: 0 <= x <= 100
Example:

98

​
rawText
string

All of the raw text of the parsed resume, example is shortened for readability

Example:

"Christopher Nolan 3210 fake street '... <rest of resume text>'"

​
redactedText
string

Redacted version of the text in the resume, removing PII.

Example:

"**** Objective: To obtain a job '... <rest of resume text>'"

​
{key}

For custom fields. E.g. 'isAvailable': true