Teams

Assign an interviewer to teams

Changed on

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

Request

  • Base URL
    https://api.heymilo.ai
  • URL
    https://api.heymilo.ai/api/v2/postings/{posting_id}/teams
  • Auth
    API key in header X-API-KEY

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"
    }
  ]
}

Changes