v4

latestOpenAPI 3.1.02026-08-01139149645.9 KB

Candidate

Create Candidate Attachment

Uploads an attachment for a given candidate.

post/api/ats/v1/candidates/{candidate_id}/attachments

Path parameters

candidate_idstring required

Headers

x-connector-tokenstring required

Request body

file_namestring nullable

The name of the file attached.

file_urlstring uri nullable

The URL where the file is stored and can be retrieved.

attachment_type'RESUME' | 'COVER_LETTER' | 'OFFER_LETTER' | 'OTHER' | '-' nullable

The type of attachment. If the value is not one of the defined enum values, the original value passed through will be returned.

file_contentstring nullable

File in base64 format

content_typestring nullable

The MIME type of the file (e.g., 'application/pdf', 'image/png').

candidatestring uuid nullable

The candidate to whom the attachment belongs.

remote_user_idstring uuid nullable

The id of user using the integration

Example request

{
  "file_name": "resume.pdf",
  "file_url": "https://example.com/path/to/resume.pdf",
  "attachment_type": "RESUME",
  "file_content": "SGVsbG8sIFdvcmxkIQ==",
  "content_type": "application/pdf",
  "candidate": "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
  "remote_user_id": "018b4bfb-5ece-70b1-ad5e-862a9433aa65"
}

Response

Successful Response

{"stackTrail":"paths:/api/ats/v1/candidates/{candidate_id}/attachments:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}