v1

latestOpenAPI 3.1.02026-08-0456127224.3 KB
Interviews

Set interview metadata

Set or update metadata for a specific interview. Up to 50 keys, each key max 40 chars, each value max 500 chars. All values must be strings.

post/api/v2/interviews/{interview_id}/metadata

Path parameters

interview_idstring required

Headers

X-API-KEYstring nullable
Authorizationstring nullable
X-Workspace-Idstring nullable

Request body

metadataobject required

Key-value pairs to set. Up to 50 keys, each key max 40 chars, each value max 500 chars. All values must be strings.

Example request

{
  "metadata": {
    "external_id": "ats_12345",
    "source": "workday"
  }
}

Response

Successful Response

metaobject nullable

Optional metadata. Shape varies by endpoint.

Example response

{
  "data": {
    "object": "metadata",
    "metadata": {
      "external_id": "ats_12345",
      "source": "workday"
    }
  }
}