Airia Assistants API
The Assistants API from Airia — 2 operation(s) for assistants.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/airia:airia-assistants-api"
All apis
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.
Get an API 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 Specification
openapi: 3.2.0
info:
title: Airia Web Assistants API
version: 1.0.0
servers:
- url: https://api.airia.ai
tags:
- name: Assistants
paths:
/v1/Assistants/{id}:
get:
tags:
- Assistants
operationId: Assistants_GetById
parameters:
- name: id
in: path
required: true
schema:
type: string
format: guid
x-position: 1
- name: x-correlation-id
in: header
schema:
type: string
responses:
200:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/GetAssistantResponse'
404:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
500:
description: ''
401:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
403:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
default:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
summary: Assistants get by id
x-summary-source: derived
put:
tags:
- Assistants
operationId: Assistants_Update
parameters:
- name: id
in: path
required: true
schema:
type: string
format: guid
x-position: 1
- name: x-correlation-id
in: header
schema:
type: string
requestBody:
x-name: request
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateAssistantRequest'
required: true
x-position: 2
responses:
500:
description: ''
400:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
200:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateAssistantResponse'
404:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
409:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
403:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
401:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
default:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
summary: Assistants update
x-summary-source: derived
delete:
tags:
- Assistants
operationId: Assistants_DeleteAssistant
parameters:
- name: id
in: path
required: true
schema:
type: string
format: guid
x-position: 1
- name: x-correlation-id
in: header
schema:
type: string
responses:
200:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAssistantResponse'
404:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
500:
description: ''
403:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
401:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
default:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
summary: Assistants delete assistant
x-summary-source: derived
/v1/Assistants:
post:
tags:
- Assistants
operationId: Assistants_Create
parameters:
- name: x-correlation-id
in: header
schema:
type: string
requestBody:
x-name: request
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAssistantRequest'
required: true
x-position: 1
responses:
201:
description: ''
500:
description: ''
400:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
409:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
403:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
401:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
default:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
summary: Assistants create
x-summary-source: derived
components:
schemas:
PromptParametersResponse:
type: object
additionalProperties: false
required:
- prompt
properties:
personality:
oneOf:
- $ref: '#/components/schemas/PersonalityParameters'
output:
oneOf:
- $ref: '#/components/schemas/OutputParameters'
prompt:
type: string
DeleteAssistantResponse:
type: object
additionalProperties: false
properties:
promptDeleted:
type: boolean
deploymentDeleted:
type: boolean
pipelineDeleted:
type: boolean
modelDeleted:
type: boolean
PromptParameters:
type: object
additionalProperties: false
required:
- prompt
properties:
personality:
oneOf:
- $ref: '#/components/schemas/PersonalityParameters'
output:
oneOf:
- $ref: '#/components/schemas/OutputParameters'
prompt:
type: string
OutputStructureTypes:
type: string
description: ''
x-enumNames:
- Custom
- BulletPoints
- Paragraph
- Outline
- Slides
- SingleSentence
- Character
enum:
- Custom
- BulletPoints
- Paragraph
- Outline
- Slides
- SingleSentence
- Character
BaseCreateOrUpdateResponse:
type: object
additionalProperties: false
properties:
id:
type: string
format: guid
assistantVersion:
type: string
createdAt:
type: string
format: date-time
name:
type: string
description:
type:
- string
- 'null'
deploymentId:
type:
- string
- 'null'
format: guid
OutputParameters:
type: object
additionalProperties: false
properties:
outputStructure:
oneOf:
- $ref: '#/components/schemas/OutputStructureTypes'
customOutputStructure:
type:
- string
- 'null'
characterCount:
type:
- integer
- 'null'
format: int32
maximum: 2147483647
minimum: 1
ModelParameters:
type: object
additionalProperties: false
properties:
libraryModelId:
type:
- string
- 'null'
format: guid
modelIsAvailableInProject:
type:
- boolean
- 'null'
temperature:
type: number
format: decimal
projectModelId:
type:
- string
- 'null'
format: guid
modelIdentifierType:
$ref: '#/components/schemas/ModelIdentifierType2'
inputType:
oneOf:
- $ref: '#/components/schemas/InputType'
outputSchema:
oneOf:
- $ref: '#/components/schemas/JsonNode'
ModelParametersResponse:
type: object
additionalProperties: false
properties:
temperature:
type: number
format: decimal
UpdateAssistantResponse:
allOf:
- $ref: '#/components/schemas/BaseCreateOrUpdateResponse'
- type: object
additionalProperties: false
properties:
updatedAt:
type: string
format: date-time
modelParameters:
oneOf:
- $ref: '#/components/schemas/ModelParametersResponse'
promptParameters:
oneOf:
- $ref: '#/components/schemas/PromptParametersResponse'
CreateAssistantRequest:
type: object
additionalProperties: false
required:
- name
- promptParameters
properties:
name:
type: string
description:
type:
- string
- 'null'
maxLength: 2000
minLength: 0
agentIconId:
type:
- string
- 'null'
format: guid
agentUnicodeIcon:
type:
- string
- 'null'
promptParameters:
$ref: '#/components/schemas/PromptParameters'
modelParameters:
$ref: '#/components/schemas/ModelParameters'
dataStoreParameters:
$ref: '#/components/schemas/DataStoreParameters'
deploymentParameters:
$ref: '#/components/schemas/DeploymentParameters'
DataStoreParameters:
type: object
additionalProperties: false
properties:
useDataStore:
type: boolean
topK:
type: integer
format: int32
relevanceThreshold:
type: integer
format: int32
neighboringChunksCount:
type: integer
format: int32
hybridSearchAlpha:
type:
- number
- 'null'
format: float
GetAssistantResponse:
type: object
additionalProperties: false
properties:
id:
type: string
format: guid
name:
type: string
description:
type:
- string
- 'null'
isActiveVersion:
type: boolean
agentIconId:
type:
- string
- 'null'
format: guid
agentUnicodeIcon:
type:
- string
- 'null'
promptParameters:
oneOf:
- $ref: '#/components/schemas/PromptParameters'
modelParameters:
oneOf:
- $ref: '#/components/schemas/ModelParameters'
dataStoreParameters:
oneOf:
- $ref: '#/components/schemas/DataStoreParameters'
deploymentParameters:
oneOf:
- $ref: '#/components/schemas/DeploymentParameters'
PersonalityParameters:
type: object
additionalProperties: false
properties:
personalityType:
oneOf:
- $ref: '#/components/schemas/PersonalityTypes'
customPersonality:
type:
- string
- 'null'
PersonalityTypes:
type: string
description: ''
x-enumNames:
- Custom
- Neutral
- Inspiring
- Empathetic
- Direct
- Formal
enum:
- Custom
- Neutral
- Inspiring
- Empathetic
- Direct
- Formal
JsonNodeOptions:
type: object
additionalProperties: false
properties:
propertyNameCaseInsensitive:
type: boolean
DeploymentParameters:
type: object
additionalProperties: false
properties:
deployToChat:
type: boolean
UpdateAssistantRequest:
type: object
additionalProperties: false
properties:
name:
type:
- string
- 'null'
description:
type:
- string
- 'null'
isActiveVersion:
type:
- boolean
- 'null'
agentIconId:
type:
- string
- 'null'
format: guid
agentUnicodeIcon:
type:
- string
- 'null'
promptParameters:
oneOf:
- $ref: '#/components/schemas/PromptParameters'
modelParameters:
oneOf:
- $ref: '#/components/schemas/ModelParameters'
dataStoreParameters:
oneOf:
- $ref: '#/components/schemas/DataStoreParameters'
deploymentParameters:
oneOf:
- $ref: '#/components/schemas/DeploymentParameters'
InputType:
type: string
description: ''
x-enumNames:
- Text
- Image
- Audio
- Video
enum:
- text
- image
- audio
- video
JsonNode:
type: object
x-abstract: true
additionalProperties: false
properties:
underlyingElement: {}
options:
oneOf:
- $ref: '#/components/schemas/JsonNodeOptions'
parent:
oneOf:
- $ref: '#/components/schemas/JsonNode'
root:
$ref: '#/components/schemas/JsonNode'
ModelIdentifierType2:
type: string
description: ''
x-enumNames:
- None
- Library
- Project
enum:
- None
- Library
- Project
ProblemDetails:
type: object
additionalProperties: {}
properties:
type:
type:
- string
- 'null'
title:
type:
- string
- 'null'
status:
type:
- integer
- 'null'
format: int32
detail:
type:
- string
- 'null'
instance:
type:
- string
- 'null'
securitySchemes:
ApiKey:
type: apiKey
description: API Key Authentication
name: X-API-Key
in: header
Cookies:
type: apiKey
description: Cookie based Authentication
name: Cookie
in: header
x-generator: NSwag v14.7.1.0 (NJsonSchema v11.6.1.0 (Newtonsoft.Json v13.0.0.0))