Superinterface
Product
Pricing
Examples
Docs
Blog
GitHub
Discord
Book a demo
Sign in
Menu
Getting started
AI Provider Setup
OpenAI
Anthropic
Azure OpenAI
FAQ
Assistants
Create assistant
Functions
API Request
Client tool
Firecrawl
Multi-agents
Interfaces
Create interface
Interaction Modes
Realtime Voice Chat
Text-to-Speech Voice Chat
AI Builder
Publish interface
Components
Annotations
Concepts
Why Superinterface
How it works
API reference
React
Installation
Components
Hooks
JavaScript
REST
Assistants
GET
List assistants
POST
Create assistant
GET
Get an assistant
PATCH
Update assistant
DELETE
Delete assistant
Initial messages
AI providers
API keys
Messages
Get an assistant
Get the details of an existing assistant.
Request
GET
https
:
//superinterface.ai/api/cloud/assistants/{assistantId}?publicApiKey={publicApiKey}
Query Parameters
Parameter
Type
Description
publicApiKey
string
Public API key
Path Parameters
Parameter
Type
Description
assistantId
string
The ID of an existing assistant
Example request
curl
-
X
GET
"
https://superinterface.ai/api/cloud/assistants/00cfe680-fee5-49b9-b386-6a7097eb8497?publicApiKey=40cfe680-fee5-49b9-b386-6a7097eb8497
"
\
-
H
"
Content-Type: application/json
"
Response
Parameter
Type
Description
assistant
PublicAssistant
Existing assistant
Example response
{
"
assistant
"
:
{
"
id
"
:
"
00cfe680-fee5-49b9-b386-6a7097eb8497
"
,
"
name
"
:
"
AI builder
"
,
"
description
"
:
"
Builds applications
"
,
"
theme
"
:
{
"
accentColor
"
:
"
blue
"
,
"
grayColor
"
:
"
gray
"
,
"
appearance
"
:
"
light
"
,
"
radius
"
:
"
medium
"
,
"
scaling
"
:
"
100%
"
,
"
panelBackground
"
:
"
solid
"
}
,
"
avatar
"
:
{
"
type
"
:
"
ICON
"
,
"
imageAvatar
"
:
null
,
"
iconAvatar
"
:
{
"
name
"
:
"
LIGHTNING_BOLT
"
}
}
}
}
Errors
The endpoint may return the following errors:
401 Unauthorized
This error occurs if the API key is invalid or missing.
{
"
error
"
:
"
Unauthorized
"
,
"
message
"
:
"
Invalid or missing API key
"
}
Status
Changelog
Terms of service
Privacy policy