Skip to main content
POST
/
v3
/
documents
/
{identifier}
/
update_data
Update a document's data
curl --request POST \
  --url https://{region}.affinda.com/v3/documents/{identifier}/update_data \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "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": [
    "[email protected]"
  ],
  "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: [email protected]",
      "email": "[email protected]",
      "number": "+61490667215",
      "position": "Principal"
    }
  ],
  "rawText": "Christopher Nolan 3210 fake street '... <rest of resume text>'",
  "redactedText": "**** Objective: To obtain a job '... <rest of resume text>'"
}
EOF
{
  "extractor": "<string>",
  "meta": {
    "identifier": "<string>",
    "pages": [
      {
        "id": 2,
        "pageIndex": 0,
        "image": "https://affinda-api.s3.amazonaws.com/media/pages/Page.png?AWSAccessKeyId=KEY&Signature=SIG&Expires=1663302062",
        "height": 700,
        "width": 500,
        "rotation": 90,
        "imageTranslated": "https://affinda-api.s3.amazonaws.com/media/pages/PageTranslated.png?AWSAccessKeyId=KEY&Signature=SIG&Expires=1663302062"
      }
    ],
    "workspace": {
      "identifier": "mEFayXdO",
      "name": "<string>"
    },
    "customIdentifier": "46ab8b02-0e5b-420c-877c-8b678d46a834",
    "fileName": "Document.pdf",
    "ready": true,
    "readyDt": "2020-12-10T01:43:32.276724Z",
    "failed": false,
    "expiryTime": "2023-11-07T05:31:56Z",
    "language": "en",
    "pdf": "https://affinda-api.s3.amazonaws.com/media/documents/Document.pdf?AWSAccessKeyId=KEY&Signature=SIG&Expires=1663302062",
    "parentDocument": {
      "identifier": "<string>",
      "customIdentifier": "46ab8b02-0e5b-420c-877c-8b678d46a834"
    },
    "childDocuments": [
      {
        "identifier": "<string>",
        "customIdentifier": "46ab8b02-0e5b-420c-877c-8b678d46a834"
      }
    ],
    "isOcrd": true,
    "ocrConfidence": 123,
    "reviewUrl": "<string>",
    "documentType": "<string>",
    "collection": {
      "identifier": "mEFayXdO",
      "name": "<string>",
      "extractor": {
        "identifier": "resume",
        "name": "<string>",
        "baseExtractor": "<string>",
        "validatable": true
      },
      "validationRules": [
        {
          "slug": "supplier_name_is_alphanumeric",
          "dataPoints": [
            "<string>"
          ]
        }
      ],
      "autoRefreshValidationResults": true
    },
    "archivedDt": "2023-11-07T05:31:56Z",
    "isArchived": true,
    "skipParse": true,
    "confirmedDt": "2023-11-07T05:31:56Z",
    "confirmedBy": {
      "id": 1,
      "name": "Carl Johnson",
      "username": "carljohnson",
      "email": "[email protected]",
      "avatar": "https://affinda-api.s3.amazonaws.com/media/user-avatar.png?AWSAccessKeyId=KEY&Signature=SIG"
    },
    "isConfirmed": true,
    "rejectedDt": "2023-11-07T05:31:56Z",
    "rejectedBy": {
      "id": 1,
      "name": "Carl Johnson",
      "username": "carljohnson",
      "email": "[email protected]",
      "avatar": "https://affinda-api.s3.amazonaws.com/media/user-avatar.png?AWSAccessKeyId=KEY&Signature=SIG"
    },
    "archivedBy": {
      "id": 1,
      "name": "Carl Johnson",
      "username": "carljohnson",
      "email": "[email protected]",
      "avatar": "https://affinda-api.s3.amazonaws.com/media/user-avatar.png?AWSAccessKeyId=KEY&Signature=SIG"
    },
    "isRejected": true,
    "createdDt": "2023-11-07T05:31:56Z",
    "errorCode": "document_conversion_failed",
    "errorDetail": "Unable to convert word document",
    "file": "<string>",
    "html": "<string>",
    "llmHint": "<string>",
    "tags": [
      {
        "id": 1,
        "name": "<string>",
        "workspace": "mEFayXdO",
        "documentCount": 1
      }
    ],
    "createdBy": {
      "id": 1,
      "name": "Carl Johnson",
      "username": "carljohnson",
      "email": "[email protected]",
      "avatar": "https://affinda-api.s3.amazonaws.com/media/user-avatar.png?AWSAccessKeyId=KEY&Signature=SIG"
    },
    "sourceEmail": "<string>",
    "sourceEmailAddress": "<string>",
    "regionBias": {
      "country": "<string>",
      "countries": [
        "<string>"
      ],
      "squareCoordinates": [
        123
      ],
      "strict": true
    }
  },
  "data": {},
  "error": {
    "errorCode": "document_conversion_failed",
    "errorDetail": "Unable to convert word document"
  },
  "warnings": [
    {
      "warningCode": "too_many_pages",
      "warningDetail": "File exceeds maximum number of pages allowed, parsing the first 10 pages only."
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic authentication using an API key, e.g. {Authorization: Bearer aff_0bb4fbdf97b7e4111ff6c0015471094155f91}. 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 or Job Description identifier A random string that uniquely identify the resource.

Body

application/json

Resume data to update

A JSON-encoded string of the ResumeData object.

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

"1992-01-01"

​
location
object
​
objective
string | null
default:""
​
languages
enum<string>[]
Available options:
Ainu,
Akan,
Akkadian,
Amharic,
Anam,
Arabic,
Aramaic,
Arem,
Armenian,
Awadhi,
Aymara,
Azari,
Bagheli,
Bagri,
Bahasa,
Bahasa Indonesian,
Bambara,
Bangala,
Bardi,
Bassa,
Batak,
Belarusian,
Bemba,
Benga,
Bengali,
Berber,
Bhojpuri,
Bislama,
Brahui,
Bulgarian,
Bunu,
Cambodian,
Carew,
Carib,
Catalan,
Cebuano,
Chakma,
Chamorro,
Chango,
Chewa,
Croatian,
Czech,
Dagbani,
Danish,
Dari,
Dayi,
Dhatki,
Dhivehi,
Dinka,
Dogri,
Duala,
Dutch,
English,
Esperanto,
Estonian,
Ewondo,
Faroese,
Filipino,
Finnish,
Formula,
French,
Frisian,
Friulian,
Fula,
Gaelic,
Galo,
Garhwali,
Garifuna,
German,
Gikuyu,
Gujarati,
Gujerati,
Gwere,
Hawaiian,
Haya,
Hebrew,
Hindi,
Hmu,
Hokkien,
Hopi,
Hungarian,
Hup,
Ibanag,
Igbo,
Ilokano,
Indonesian,
Intermediate,
Irish,
Italian,
Japanese,
Jiba,
Kachin,
Kalenjin,
Kamayo,
Kannada,
Kaonde,
Kayan,
Khandeshi,
Khmer,
Kikuyu,
Kodava,
Koma,
Kongo,
Konkani,
Korean,
Korwa,
Kreyol,
Krio,
Kumaoni,
Kurdish,
Kurukh,
Kwa,
Ladino,
Lango,
Latvian,
Lawa,
Lingala,
Lithuanian,
Lule,
Luxembourgish,
Magahi,
Maithili,
Malay,
Malayalam,
Malaysian,
Malvi,
Maninka,
Manipuri,
Manx,
Marathi,
Mayan,
Medumba,
Memoni,
Mewari,
Mizo,
Montenegrin,
Mwan,
Mwanga,
Ndebele,
Nepali,
Nimadi,
Oriya,
Oromo,
Ovambo,
Pamona,
Pangasinan,
Pashto,
Phoenician,
Polish,
Portuguese,
Pulaar,
Pular,
Punjabi,
Quecha,
Rajasthani,
Romanian,
Russian,
Sakha,
Sango,
Santhali,
Saraiki,
Seim,
Shading,
Shama,
Shan,
Shona,
Silesian,
Sindhi,
Slovak,
Slovene,
Soga,
Sogdian,
Sotho,
Spanish,
Sudanese,
Sumerian,
Surajpuri,
Surigaonon,
Swati,
Swazi,
Swedish,
Tagalog,
Tamil,
Tausug,
Telugu,
Tetum,
Tharu,
Tibetan,
Tigrinya,
Tripuri,
Tswana,
Tulu,
Turkish,
Tuwali,
Ubi,
Ukrainian,
Urdu,
Veps,
Vietnamese,
Wagdi,
Waziri,
Xhosa,
Yiddish,
Yoruba
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

​
extractor
string
required
​
meta
object
required
​
data
object
​
error
object
​
warnings
object[]