Sign in

v1

latestOpenAPI 3.1.02026-07-26167644759.4 KB
Attachments

Assign temporary attachments to records

Step 2 of the two-step upload flow: assigns temporary attachments previously created via POST /attachments/temporary to one or more records (candidate, company, or vacancy), making them permanent. The attachment's type is intended to be set here — each attachment specifies a type, either a predefined type ({ name }) or a custom, tenant-defined type ({ id }), and can optionally be renamed. At least one of candidateId, companyId, or vacancyId must be provided. The type must be allowed for all records the attachment is linked to: the predefined CV type can only be assigned to attachments linked to a candidate, and custom types define which record types they support.

post/attachments/temporary/assign

Request body

candidateIdsstring[]

IDs of the candidates to link the attachments to. Fully replaces the existing candidate links. At least one of candidateIds, companyIds, or vacancyIds must be provided.

companyIdsstring[]

IDs of the companies to link the attachments to. Fully replaces the existing company links. At least one of candidateIds, companyIds, or vacancyIds must be provided.

vacancyIdsstring[]

IDs of the vacancies/jobs to link the attachments to. Fully replaces the existing vacancy links. At least one of candidateIds, companyIds, or vacancyIds must be provided.

candidateIdstring

[DEPRECATED] Use candidateIds instead. ID of a single candidate to link the attachments to; merged into candidateIds.

companyIdstring

[DEPRECATED] Use companyIds instead. ID of a single company to link the attachments to; merged into companyIds.

vacancyIdstring

[DEPRECATED] Use vacancyIds instead. ID of a single vacancy/job to link the attachments to; merged into vacancyIds.

Example request

{
  "attachments": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "name": "John_Doe_CV_2026.pdf"
    }
  ],
  "candidateId": "550e8400-e29b-41d4-a716-446655440000",
  "companyId": "550e8400-e29b-41d4-a716-446655440001",
  "vacancyId": "550e8400-e29b-41d4-a716-446655440002"
}

Response

Attachments assigned successfully