---
title: "Assign an interviewer to teams"
method: POST
path: "/api/v2/postings/{posting_id}/teams"
tags: ["Teams"]
---

# Assign an interviewer to teams

`POST /api/v2/postings/{posting_id}/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.

## Path parameters

- `posting_id` string, required

## Headers

- `X-API-KEY` string, nullable
- `Authorization` string, nullable
- `X-Workspace-Id` string, nullable

## Request body

- AssignTeamsRequest — Request body for assigning an interviewer to teams.
  - `team_ids` string[], required — Team IDs to assign this interviewer to.

## Response `200`

Successful Response

- ListResponsePostingTeam
  - `data` PostingTeam[], required
    - `object` string — Object type identifier.
    - `team_id` string, required — Unique team identifier.
    - `name` string, nullable — Team name.
    - `description` string, nullable — Team description.
    - `assigned_at` number, nullable — Unix timestamp when the interviewer was assigned.
    - `assigned_by` string, nullable — Who created the assignment. For API-key callers this is 'api_key:<key name>'.
  - `pagination` PaginationMeta, required
    - `has_more` boolean, required — Whether more results exist beyond this page
    - `total_count` integer, nullable — Total number of results (if available)
    - `url` string, nullable — URL of this resource

## Other responses

- `400` — One or more team IDs are unknown for this workspace.
- `401` — Invalid or missing API key.
- `403` — Teams is not enabled for this workspace.
- `404` — Resource not found.
- `422` — Validation Error
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/heymilo/apis/heymilo-public-api.md) · [All operations](https://skmtc.net/heymilo/apis/heymilo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heymilo/heymilo-public-api/revisions/5e07b657706b/schema)