Attach documents to a candidate

This endpoint lets you attach new documents for a given candidate_reference.

This endpoint requires documents_rw, and my_candidtates_rw or candidates_rw scope.

documents to a candidate

POST https://www.welcomekit.co/api/v1/external/documents

Query Parameters

NameTypeDescription

candidate_reference*

string

Candidate reference

remote_file_urls*

array

Array of files

[
  {
    "id": 20,
    "job_reference": "WTTJ_KmqkD1Y",
    "candidate_reference": "wttj-d655345409a6097309156b05",
    "filename": "example",
    "file_url": "http://example.com/resume.pdf",
    "size": 433994,
    "content_type": "application/pdf",
    "created_at": "2018-01-08T11:46:02.990+01:00"
  },
  ...
]

Request example

curl -X POST "https://www.welcomekit.co/api/v1/external/documents" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer WK_API_KEY" \
    -d @- <<EOF
{
  "candidate_reference": "wttj-d655345409a6097309156b05",
  "remote_file_urls": [
    {"filename": "resume", "url": "http://example.com/resume.pdf"},
    {"filename": "portfolio", "url": "http://example.com/portfolio.pdf"}
  ]
}
EOF

Last updated