> ## Documentation Index
> Fetch the complete documentation index at: https://sitegpt.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Accept Transfer

> Accept a chatbot transfer addressed to you. Ownership moves now: you become the owner, and the previous owner is removed or kept at the role the sender chose. Refused with 410 when the transfer expired, and 409 when the chatbot changed owner, the sender can no longer transfer it, or a HIPAA agreement or the member seats block it. Needs an account-wide token and your own plan (a team plan does not cover it); the dashboard answers transfers on any plan.

Required scope: `chatbots:write`.

On success, `data` contains: `chatbot`.



## OpenAPI

````yaml https://sitegpt.ai/api/v2/openapi.json post /api/v2/transfers/{transferId}/accept
openapi: 3.1.0
info:
  title: SiteGPT Agent API
  version: 2.0.0
  description: >-
    Agent-facing API for managing SiteGPT chatbots, dashboard summaries,
    appearance media, knowledge, settings, conversations, leads, members,
    account profiles, usage, billing reads, and API tokens.
servers:
  - url: https://sitegpt.ai
security:
  - bearerAuth: []
tags:
  - name: Discovery
  - name: Onboarding
  - name: Account
  - name: Billing
  - name: Tokens
  - name: Chatbots
  - name: Knowledge
  - name: Knowledge Sync Jobs
  - name: Knowledge Sources
  - name: Custom Responses
  - name: Personas
  - name: Instructions
  - name: Settings
  - name: Conversation Starters
  - name: Conversation Followups
  - name: Members
  - name: Leads
  - name: Conversations
  - name: Messages
  - name: Tags
paths:
  /api/v2/transfers/{transferId}/accept:
    post:
      tags:
        - Chatbots
      summary: Accept Transfer
      description: >-
        Accept a chatbot transfer addressed to you. Ownership moves now: you
        become the owner, and the previous owner is removed or kept at the role
        the sender chose. Refused with 410 when the transfer expired, and 409
        when the chatbot changed owner, the sender can no longer transfer it, or
        a HIPAA agreement or the member seats block it. Needs an account-wide
        token and your own plan (a team plan does not cover it); the dashboard
        answers transfers on any plan.


        Required scope: `chatbots:write`.


        On success, `data` contains: `chatbot`.
      operationId: acceptTransfer
      parameters:
        - name: transferId
          in: path
          required: true
          description: transferId path parameter.
          schema:
            type: string
      responses:
        '200':
          description: Successful SiteGPT API v2 response.
          content:
            application/json:
              schema:
                type: object
                required:
                  - ok
                  - data
                  - meta
                properties:
                  ok:
                    type: boolean
                    const: true
                  data:
                    type: object
                    additionalProperties: true
                    properties:
                      chatbot:
                        type: object
                        additionalProperties: true
                        properties:
                          id:
                            type: string
                          title:
                            type: string
                          previousOwnerId:
                            type: string
                          previousOwnerEmail:
                            type: string
                          newOwnerId:
                            type: string
                          newOwnerEmail:
                            type: string
                          previousOwnerRemoved:
                            type: boolean
                          previousOwnerKeptAs:
                            type:
                              - string
                              - 'null'
                  meta:
                    $ref: '#/components/schemas/AgentResponseMeta'
                additionalProperties: false
              example:
                ok: true
                data:
                  chatbot:
                    id: chatbot_123
                    title: Support Bot
                    previousOwnerId: user_123
                    previousOwnerEmail: owner@example.com
                    newOwnerId: user_456
                    newOwnerEmail: new-owner@example.com
                    previousOwnerRemoved: true
                    previousOwnerKeptAs: null
                meta:
                  requestId: request-id
        '400':
          $ref: '#/components/responses/AgentError'
        '401':
          $ref: '#/components/responses/AgentError'
        '403':
          $ref: '#/components/responses/AgentError'
        '404':
          $ref: '#/components/responses/AgentError'
        '405':
          $ref: '#/components/responses/AgentError'
        '409':
          $ref: '#/components/responses/AgentError'
        '410':
          $ref: '#/components/responses/AgentError'
      security:
        - bearerAuth:
            - chatbots:write
components:
  schemas:
    AgentResponseMeta:
      type: object
      required:
        - requestId
      properties:
        requestId:
          type: string
        warnings:
          type: array
          items:
            type: string
        nextCursor:
          type:
            - string
            - 'null'
      additionalProperties: true
    AgentError:
      type: object
      required:
        - ok
        - error
        - meta
      properties:
        ok:
          type: boolean
          const: false
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
            details: {}
          additionalProperties: false
        meta:
          type: object
          required:
            - requestId
          properties:
            requestId:
              type: string
          additionalProperties: true
      additionalProperties: false
  responses:
    AgentError:
      description: SiteGPT agent API error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AgentError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: SiteGPT API token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.