---
title: "PUT /repos/{repo_id}/invites"
method: PUT
path: "/repos/{repo_id}/invites"
tags: ["Collaborators"]
---

# PUT /repos/{repo_id}/invites

`PUT /repos/{repo_id}/invites`

## Request

- Base URL: `https://api.diversion.dev/v0`
- URL: `https://api.diversion.dev/v0/repos/{repo_id}/invites`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://auth.diversion.dev/oauth2/authorize`
    - Scopes: `coreapi/read`
  - OAuth 2
    - Implicit: `https://auth.diversion.dev/oauth2/authorize`
    - Scopes: `coreapi/write`
- TypeScript: <https://skmtc.dev/diversion/apis/diversion-core-api/docs/repos/:repo_id/invites/put.ts> (a function with typed inputs; its response is checked against the schema)

Invite a collaborator to a repository

## Request body

- CollaborationInviteRequest
  - `collaborator_handle` string, required: A user ID or email. User IDs are preferred, but an email can be used to invite a new collaborator who does not have an account or whose user ID is unknown.
  - `mode` 'READ' | 'WRITE' | 'ADMIN' | 'OWNER', required

## Response `204`

Request completed successfully

## Other responses

- `default`: An error occurred

---

[API](https://skmtc.dev/diversion/apis/diversion-core-api.md) - [All operations](https://skmtc.dev/diversion/apis/diversion-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/diversion/apis/diversion-core-api/revisions/38a18aba804b?raw)