latestOpenAPI 3.1.02026-08-1760132235.9 KB

5e07b657706b

Teams

Assign an interviewer to teams

Assign this interviewer to one or more teams and return the resulting set of assigned teams. Every team ID is validated before anything is written, so an unknown ID assigns nothing and returns 400. Re-assigning a team the interviewer already belongs to is a no-op.

Note: assigning an interviewer to any team restricts dashboard visibility to members of those teams. An interviewer with no team is visible to the whole workspace.

post/api/v2/postings/{posting_id}/teams

Path parameters

posting_idstring required

Headers

X-API-KEYstring nullable

Authorizationstring nullable

X-Workspace-Idstring nullable

Request body

team_idsstring[] required

Team IDs to assign this interviewer to.

Example request

{
  "team_ids": [
    "team_abc123"
  ]
}

Response

Successful Response

Example response

{
  "data": [
    {
      "team_id": "team_abc123",
      "name": "Engineering"
    }
  ]
}