Add users and assign seats for a self-hosted organization
curl --request PUT \
--url https://api.coderabbit.ai/v1/users \
--header 'Content-Type: application/json' \
--header 'x-coderabbitai-api-key: <api-key>' \
--data '
{
"users": [
{
"user_id": "<string>",
"user_name": "<string>",
"email": "jsmith@example.com",
"name": "<string>"
}
]
}
'import requests
url = "https://api.coderabbit.ai/v1/users"
payload = { "users": [
{
"user_id": "<string>",
"user_name": "<string>",
"email": "jsmith@example.com",
"name": "<string>"
}
] }
headers = {
"x-coderabbitai-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-coderabbitai-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
users: [
{
user_id: '<string>',
user_name: '<string>',
email: 'jsmith@example.com',
name: '<string>'
}
]
})
};
fetch('https://api.coderabbit.ai/v1/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "success",
"succeeded": [
"<string>"
],
"failed": [
{
"user_id": "<string>",
"code": "<string>"
}
]
}Add users and assign seats for a self-hosted organization
Add up to 500 provider-identified users to a self-hosted organization and assign seats. Requires an Enterprise plan and administrator access; self-hosted organization keys retain their existing administrator exemption. SSO-managed workspaces are unsupported; use POST /v1/users/seats with workspace member identities instead. If seats are unavailable, the operation can reclaim seats from users inactive for at least 30 days. Duplicate user_id values are processed once, keeping the first entry. HTTP 200 can contain partial success or failure; inspect status and failed for per-user results.
PUT
/
v1
/
users
Add users and assign seats for a self-hosted organization
curl --request PUT \
--url https://api.coderabbit.ai/v1/users \
--header 'Content-Type: application/json' \
--header 'x-coderabbitai-api-key: <api-key>' \
--data '
{
"users": [
{
"user_id": "<string>",
"user_name": "<string>",
"email": "jsmith@example.com",
"name": "<string>"
}
]
}
'import requests
url = "https://api.coderabbit.ai/v1/users"
payload = { "users": [
{
"user_id": "<string>",
"user_name": "<string>",
"email": "jsmith@example.com",
"name": "<string>"
}
] }
headers = {
"x-coderabbitai-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-coderabbitai-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
users: [
{
user_id: '<string>',
user_name: '<string>',
email: 'jsmith@example.com',
name: '<string>'
}
]
})
};
fetch('https://api.coderabbit.ai/v1/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "success",
"succeeded": [
"<string>"
],
"failed": [
{
"user_id": "<string>",
"code": "<string>"
}
]
}- CLI Tool
- MCP Server
coderabbit api request -X PUT /users --input request.json
This operation isn’t a tool on the CodeRabbit MCP server. Call it over REST or from the CLI.
Authorizations
See Authentication for the key types and where to create a key.
Body
application/json
Was this page helpful?