Transfer Chatbot

curl --request POST \
  --url https://sitegpt.ai/api/v2/chatbots/{chatbotId}/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com",
  "userId": "<string>"
}
'

{
  "ok": true,
  "data": {
    "chatbot": {
      "id": "chatbot-id",
      "name": "Example chatbot",
      "createdAt": "2026-05-13T00:00:00.000Z"
    }
  },
  "meta": {
    "requestId": "request-id"
  }
}

Chatbots

Transfer chatbot

Transfer a chatbot to another user in the same brand (reassign ownership). Provide email or userId. If the recipient has no account in the brand yet, one is created. By default the previous owner is removed from the chatbot; pass keepSourceAs to keep them as a member at that role. Requires the chatbot_transfer permission, held by SUPER_ADMIN members (the chatbot creator is always a SUPER_ADMIN).

Required scope: chatbots:write, members:write, members:delete.

POST

api

chatbots

{chatbotId}

transfer

Transfer Chatbot

curl --request POST \
  --url https://sitegpt.ai/api/v2/chatbots/{chatbotId}/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com",
  "userId": "<string>"
}
'

{
  "ok": true,
  "data": {
    "chatbot": {
      "id": "chatbot-id",
      "name": "Example chatbot",
      "createdAt": "2026-05-13T00:00:00.000Z"
    }
  },
  "meta": {
    "requestId": "request-id"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

chatbotId

string

required

Body

application/json

Option 1
Option 2

string<email>

required

Email of the user to transfer ownership to. If no user with this email exists in the brand yet, an account is provisioned for them.

userId

string

User id of the recipient. Use instead of email, or to disambiguate. Must be a user in the same brand.

keepSourceAs

enum<string>

If set, keep the previous owner as a member at this role (ownership reassignment within a team). If omitted, the previous owner is removed from the chatbot (full transfer).

Available options:

AGENT,

MANAGER,

ADMIN,

SUPER_ADMIN

Response

Successful SiteGPT API v2 response.

boolean

required

data

object

required

Show child attributes

Documentation Index

Authorizations

Path Parameters

Body

Response