---
title: "Bulk Invite Collaborators"
method: POST
path: "/api/v1/rankings/{ranking_id}/collaborators/bulk"
tags: ["Collaborators"]
---

# Bulk Invite Collaborators

`POST /api/v1/rankings/{ranking_id}/collaborators/bulk`

## Request

- Base URL: `https://app.aimrank.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aimrank.io/api/v1/rankings/{ranking_id}/collaborators/bulk`
- Auth: none declared

Invite many users at once. Atomic per-user — failures don't block the rest.

Used for onboarding an org's coaching staff or judging panel in one shot.
The caller must have at least 'moderate' permission on the ranking, and
moderators may only invite contributors (same rule as single-invite).

## Path parameters

- `ranking_id` string, required

## Request body

- BulkInviteRequest: Invite many users at once. Used by org owners onboarding a coaching staff.
  - `invitees` string[], required
  - `role` string

## Response `200`

Successful Response

- BulkInviteResult
  - `invited` integer, required
  - `already_active` integer, required
  - `not_found` string[], required
  - `skipped_self_or_owner` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aimrank/apis/aimrank-api.md) · [All operations](https://skmtc.dev/aimrank/apis/aimrank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aimrank/apis/aimrank-api/revisions/3574d0aff459?raw)