sitegpt-ai Personas API
The Personas API from sitegpt-ai — 3 operation(s) for personas.
The Personas API from sitegpt-ai — 3 operation(s) for personas.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/sitegpt-ai:sitegpt-ai-personas-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SiteGPT Agent Personas 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: Personas
paths:
/api/v2/chatbots/{chatbotId}/personas:
get:
operationId: listPersonas
summary: List personas
description: 'List chatbot personas.
Required scope: `personas:read`.
On success, `data` contains: `personas`, `activePersonaId`.'
tags:
- Personas
security:
- bearerAuth:
- personas:read
x-sitegpt-auth: bearer
x-sitegpt-scopes:
- personas:read
x-mint:
title: List personas
description: List chatbot personas.
parameters:
- name: chatbotId
in: path
required: true
description: Chatbot ID.
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:
personas:
type: array
items:
$ref: '#/components/schemas/Persona'
activePersonaId:
type:
- string
- 'null'
description: ID of the currently active persona; null when default.
meta:
$ref: '#/components/schemas/AgentResponseMeta'
additionalProperties: false
example:
ok: true
data:
personas:
- id: persona-id
title: Product expert
activePersonaId: persona-id
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'
post:
operationId: createPersona
summary: Create persona
description: 'Create a chatbot persona.
Required scope: `personas:write`.
On success, `data` contains: `persona`, `activePersonaId`.'
tags:
- Personas
security:
- bearerAuth:
- personas:write
x-sitegpt-auth: bearer
x-sitegpt-scopes:
- personas:write
x-mint:
title: Create persona
description: Create a chatbot persona.
parameters:
- name: chatbotId
in: path
required: true
description: Chatbot ID.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- title
- instructions
additionalProperties: false
properties:
title:
type: string
minLength: 1
description:
type: string
instructions:
type: string
minLength: 1
example:
title: Friendly support
description: Warm, concise support tone.
instructions: Be friendly, direct, and helpful.
responses:
'201':
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:
persona:
$ref: '#/components/schemas/Persona'
activePersonaId:
type:
- string
- 'null'
description: ID of the currently active persona; null when default.
meta:
$ref: '#/components/schemas/AgentResponseMeta'
additionalProperties: false
example:
ok: true
data:
persona:
id: persona-id
name: Example persona
createdAt: '2026-05-13T00:00:00.000Z'
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'
/api/v2/chatbots/{chatbotId}/personas/{personaId}:
get:
operationId: getPersona
summary: Get persona
description: 'Get one chatbot persona.
Required scope: `personas:read`.
On success, `data` contains: `persona`, `activePersonaId`.'
tags:
- Personas
security:
- bearerAuth:
- personas:read
x-sitegpt-auth: bearer
x-sitegpt-scopes:
- personas:read
x-mint:
title: Get persona
description: Get one chatbot persona.
parameters:
- name: chatbotId
in: path
required: true
description: Chatbot ID.
schema:
type: string
- name: personaId
in: path
required: true
description: Persona ID.
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:
persona:
$ref: '#/components/schemas/Persona'
activePersonaId:
type:
- string
- 'null'
description: ID of the currently active persona; null when default.
meta:
$ref: '#/components/schemas/AgentResponseMeta'
additionalProperties: false
example:
ok: true
data:
persona:
id: persona-id
name: Example persona
createdAt: '2026-05-13T00:00:00.000Z'
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'
patch:
operationId: updatePersona
summary: Update persona
description: 'Update a custom chatbot persona.
Required scope: `personas:write`.
On success, `data` contains: `persona`, `activePersonaId`.'
tags:
- Personas
security:
- bearerAuth:
- personas:write
x-sitegpt-auth: bearer
x-sitegpt-scopes:
- personas:write
x-mint:
title: Update persona
description: Update a custom chatbot persona.
parameters:
- name: chatbotId
in: path
required: true
description: Chatbot ID.
schema:
type: string
- name: personaId
in: path
required: true
description: Persona ID.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
title:
type: string
minLength: 1
description:
type: string
instructions:
type: string
minLength: 1
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:
persona:
$ref: '#/components/schemas/Persona'
activePersonaId:
type:
- string
- 'null'
description: ID of the currently active persona; null when default.
meta:
$ref: '#/components/schemas/AgentResponseMeta'
additionalProperties: false
example:
ok: true
data:
persona:
id: persona-id
name: Example persona
createdAt: '2026-05-13T00:00:00.000Z'
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'
delete:
operationId: deletePersona
summary: Delete persona
description: 'Delete a custom chatbot persona. Requires confirm=true.
Required scope: `personas:delete`.
On success, `data` contains: `deletedPersona`.'
tags:
- Personas
security:
- bearerAuth:
- personas:delete
x-sitegpt-auth: bearer
x-sitegpt-scopes:
- personas:delete
x-mint:
title: Delete persona
description: Delete a custom chatbot persona. Requires confirm=true.
parameters:
- name: chatbotId
in: path
required: true
description: Chatbot ID.
schema:
type: string
- name: personaId
in: path
required: true
description: Persona ID.
schema:
type: string
- name: confirm
in: query
required: false
description: Required true for destructive actions.
schema:
type: boolean
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:
deletedPersona:
type: object
additionalProperties: true
properties:
id:
type: string
title:
type: string
meta:
$ref: '#/components/schemas/AgentResponseMeta'
additionalProperties: false
example:
ok: true
data:
deletedPersona:
id: persona-id
name: Example persona
createdAt: '2026-05-13T00:00:00.000Z'
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'
/api/v2/chatbots/{chatbotId}/personas/{personaId}/use:
post:
operationId: usePersona
summary: Use persona
description: 'Make a persona active for a chatbot.
Required scope: `personas:write`.
On success, `data` contains: `persona`, `activePersonaId`.'
tags:
- Personas
security:
- bearerAuth:
- personas:write
x-sitegpt-auth: bearer
x-sitegpt-scopes:
- personas:write
x-mint:
title: Use persona
description: Make a persona active for a chatbot.
parameters:
- name: chatbotId
in: path
required: true
description: Chatbot ID.
schema:
type: string
- name: personaId
in: path
required: true
description: Persona ID.
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:
persona:
$ref: '#/components/schemas/Persona'
activePersonaId:
type:
- string
- 'null'
description: ID of the currently active persona; null when default.
meta:
$ref: '#/components/schemas/AgentResponseMeta'
additionalProperties: false
example:
ok: true
data:
persona:
id: persona-id
name: Example persona
createdAt: '2026-05-13T00:00:00.000Z'
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'
components:
schemas:
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
AgentResponseMeta:
type: object
required:
- requestId
properties:
requestId:
type: string
warnings:
type: array
items:
type: string
nextCursor:
type:
- string
- 'null'
additionalProperties: true
Persona:
type: object
description: A chatbot persona (built-in or custom).
additionalProperties: true
properties:
id:
type: string
title:
type: string
description:
type: string
instructions:
type: string
source:
type: string
enum:
- BUILT_IN
- CUSTOM
isActive:
type: boolean
isEditable:
type: boolean
isDeletable:
type: boolean
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