For AI agents: markdown of this page — /docs-content-en/bots/chats/set-owner.md documentation index — /llms.txt

Assign an owner

POST /v1/bots/:botId/chats/:dialogId/owner

Transfers chat ownership to another user. The bot must be the current chat owner.

Parameters

Parameter Type Required Description
botId (path) number yes Bot ID. List: GET /v1/bots
dialogId (path) string yes Group chat ID in the form chatXXX. Returned in the data.chat.dialogId field of POST /v1/bots/:botId/chats and in the chat.dialogId field of bot events

Request fields (body)

Parameter Type Required Description
userId number yes ID of the new owner

Examples

curl — personal key

Terminal 
curl -X POST https://vibecode.bitrix24.com/v1/bots/42/chats/chat456/owner \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "userId": 5 }'

curl — OAuth application

Terminal 
curl -X POST https://vibecode.bitrix24.com/v1/bots/42/chats/chat456/owner \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "userId": 5 }'

JavaScript — personal key

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/bots/42/chats/chat456/owner', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ userId: 5 }),
})

const { success, data } = await res.json()

JavaScript — OAuth application

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/bots/42/chats/chat456/owner', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ userId: 5 }),
})

const { success, data } = await res.json()

Response fields

Field Type Description
success boolean Always true on success
data object Result of the ownership transfer
data.result boolean true if ownership was transferred successfully

Response example

JSON 
{
  "success": true,
  "data": {
    "result": true
  }
}

Error response example

403 — the bot is not the chat owner:

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ACCESS_DENIED",
    "message": "Access denied"
  }
}

Errors

HTTP Code Description
400 INVALID_BOT_ID botId is not a number
404 BOT_NOT_FOUND No bot found with this ID
403 BOT_ACCESS_DENIED The bot belongs to another API key
403 BITRIX_ACCESS_DENIED The bot is not a participant of the chat or is not its owner
422 BITRIX_ERROR Another Bitrix24 error, text in message
403 SCOPE_DENIED The API key does not have the imbot scope
403 WRITE_BLOCKED_READONLY_KEY The key is read-only — see access rights
410 BOT_DISABLED The bot is disabled and does not process API calls. How to restore it — Bot disabled
401 TOKEN_MISSING The API key has no configured tokens

Full list of common API errors — Errors.

See also