Siro Sessions API
The Sessions API from Siro — 4 operation(s) for sessions.
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/siro-sessions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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:
version: 1.0.0
title: Swagger Sessions API
servers:
- url: https://api.siro.ai/
description: Siro API Gateway
tags:
- name: Sessions
paths:
/v1/sessions:
get:
summary: List past chat sessions for the authenticated user.
description: Returns session metadata (sessionId, title, createdAt, updatedAt, sourceSystem) ordered by most recent first. sourceSystem is AIF or AURORA -- Aurora conversations are read-only. Supports cursor-based pagination. Pass organizationId to scope results to a specific org (for org switchers).
parameters:
- schema:
type: string
required: false
name: cursor
in: query
- schema:
type: integer
minimum: 1
maximum: 100
default: 20
required: false
name: limit
in: query
- schema:
type: string
required: false
name: organizationId
in: query
responses:
'200':
description: List past chat sessions for the authenticated user.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
sessions:
type: array
items:
type: object
properties:
sessionId:
type: string
title:
type: string
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
sourceSystem:
type: string
enum:
- AIF
- AURORA
required:
- sessionId
- title
- createdAt
- updatedAt
- sourceSystem
nextCursor:
type: string
required:
- sessions
cursor:
anyOf:
- type: string
- type: number
- {}
pageSize:
type: number
limit:
type: number
total:
type:
- number
- 'null'
hasNextPage:
type: boolean
required:
- data
'400':
description: Bad Request - Invalid parameters
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Error message
required:
- error
'401':
description: Unauthorized - User not authenticated
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Authentication error message
required:
- error
'403':
description: Forbidden - User does not have access
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Authorization error message
required:
- error
'404':
description: Not Found - Resource not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Resource not found error message
required:
- error
'422':
description: Unprocessable Content - The request failed validation checks
content:
application/json:
schema:
type: object
properties:
issues:
type: array
items:
type: object
properties:
code:
type: string
expected:
type: string
received:
type: string
path:
type: array
items:
anyOf:
- type: string
- type: number
message:
type: string
required:
- code
- path
- message
name:
type: string
enum:
- ZodError
required:
- issues
- name
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Internal server error message
required:
- error
security:
- SiroAuthToken: []
tags:
- Sessions
/v1/sessions/{sessionId}:
get:
summary: Get full message history for a chat session.
description: Validates ownership, then returns the full ChatMessage history for the session as Q&A message pairs. Each model row includes invocationId (feedback key) and persisted feedback when set. sourceSystem indicates AIF vs AURORA (Aurora conversations are read-only).
responses:
'200':
description: Get full message history for a chat session.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
sessionId:
type: string
title:
type: string
messages:
type: array
items:
oneOf:
- type: object
properties:
role:
type: string
enum:
- user
parts:
type: array
items:
oneOf:
- type: object
properties:
kind:
type: string
enum:
- text
text:
type: string
required:
- kind
- text
- type: object
properties:
kind:
type: string
enum:
- tool
tool:
type: string
enum:
- show_chart
data: {}
required:
- kind
- tool
- type: object
properties:
kind:
type: string
enum:
- markdown-patch
patches:
type: array
items: {}
seq:
type: integer
minimum: 0
segment:
type: integer
minimum: 0
required:
- kind
- patches
- seq
- segment
- type: object
properties:
kind:
type: string
enum:
- markdown-tokens
tokens:
type: array
items: {}
segment:
type: integer
minimum: 0
intermediate:
type: boolean
required:
- kind
- tokens
- segment
- type: object
properties:
kind:
type: string
enum:
- segment-meta
segment:
type: integer
minimum: 0
intermediate:
type: boolean
required:
- kind
- segment
- intermediate
- type: object
properties:
kind:
type: string
enum:
- halftime-report
sections:
type: array
items:
type: object
properties:
id:
type: string
description: ID of the Halftime report topic
title:
type: string
description: Name of the Halftime report topic
guidance:
type: string
description: Guidance generated for Halftime report topic
required:
- id
- title
- guidance
required:
- kind
- sections
required:
- role
- parts
- type: object
properties:
role:
type: string
enum:
- model
parts:
type: array
items:
oneOf:
- type: object
properties:
kind:
type: string
enum:
- text
text:
type: string
required:
- kind
- text
- type: object
properties:
kind:
type: string
enum:
- tool
tool:
type: string
enum:
- show_chart
data: {}
required:
- kind
- tool
- type: object
properties:
kind:
type: string
enum:
- markdown-patch
patches:
type: array
items: {}
seq:
type: integer
minimum: 0
segment:
type: integer
minimum: 0
required:
- kind
- patches
- seq
- segment
- type: object
properties:
kind:
type: string
enum:
- markdown-tokens
tokens:
type: array
items: {}
segment:
type: integer
minimum: 0
intermediate:
type: boolean
required:
- kind
- tokens
- segment
- type: object
properties:
kind:
type: string
enum:
- segment-meta
segment:
type: integer
minimum: 0
intermediate:
type: boolean
required:
- kind
- segment
- intermediate
- type: object
properties:
kind:
type: string
enum:
- halftime-report
sections:
type: array
items:
type: object
properties:
id:
type: string
description: ID of the Halftime report topic
title:
type: string
description: Name of the Halftime report topic
guidance:
type: string
description: Guidance generated for Halftime report topic
required:
- id
- title
- guidance
required:
- kind
- sections
invocationId:
type: string
feedback:
type:
- string
- 'null'
enum:
- thumbs_up
- thumbs_down
feedbackText:
type: string
maxLength: 1000
required:
- role
- parts
- feedback
sourceSystem:
type: string
enum:
- AIF
- AURORA
required:
- sessionId
- title
- messages
- sourceSystem
cursor:
anyOf:
- type: string
- type: number
- {}
pageSize:
type: number
limit:
type: number
total:
type:
- number
- 'null'
hasNextPage:
type: boolean
required:
- data
'400':
description: Bad Request - Invalid parameters
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Error message
required:
- error
'401':
description: Unauthorized - User not authenticated
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Authentication error message
required:
- error
'403':
description: Forbidden - User does not have access
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Authorization error message
required:
- error
'404':
description: Not Found - Resource not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Resource not found error message
required:
- error
'422':
description: Unprocessable Content - The request failed validation checks
content:
application/json:
schema:
type: object
properties:
issues:
type: array
items:
type: object
properties:
code:
type: string
expected:
type: string
received:
type: string
path:
type: array
items:
anyOf:
- type: string
- type: number
message:
type: string
required:
- code
- path
- message
name:
type: string
enum:
- ZodError
required:
- issues
- name
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Internal server error message
required:
- error
security:
- SiroAuthToken: []
tags:
- Sessions
patch:
summary: Rename a chat session.
description: Updates the chat session title.
requestBody:
content:
application/json:
schema:
type: object
properties:
title:
type: string
minLength: 1
maxLength: 500
required:
- title
responses:
'200':
description: Rename a chat session.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
sessionId:
type: string
title:
type: string
required:
- sessionId
- title
cursor:
anyOf:
- type: string
- type: number
- {}
pageSize:
type: number
limit:
type: number
total:
type:
- number
- 'null'
hasNextPage:
type: boolean
required:
- data
'400':
description: Bad Request - Invalid parameters
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Error message
required:
- error
'401':
description: Unauthorized - User not authenticated
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Authentication error message
required:
- error
'403':
description: Forbidden - User does not have access
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Authorization error message
required:
- error
'404':
description: Not Found - Resource not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Resource not found error message
required:
- error
'422':
description: Unprocessable Content - The request failed validation checks
content:
application/json:
schema:
type: object
properties:
issues:
type: array
items:
type: object
properties:
code:
type: string
expected:
type: string
received:
type: string
path:
type: array
items:
anyOf:
- type: string
- type: number
message:
type: string
required:
- code
- path
- message
name:
type: string
enum:
- ZodError
required:
- issues
- name
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Internal server error message
required:
- error
security:
- SiroAuthToken: []
tags:
- Sessions
delete:
summary: Delete a chat session.
description: Soft-deletes the chat session.
responses:
'200':
description: Delete a chat session.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
sessionId:
type: string
required:
- sessionId
cursor:
anyOf:
- type: string
- type: number
- {}
pageSize:
type: number
limit:
type: number
total:
type:
- number
- 'null'
hasNextPage:
type: boolean
required:
- data
'400':
description: Bad Request - Invalid parameters
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Error message
required:
- error
'401':
description: Unauthorized - User not authenticated
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Authentication error message
required:
- error
'403':
description: Forbidden - User does not have access
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Authorization error message
required:
- error
'404':
description: Not Found - Resource not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Resource not found error message
required:
- error
'422':
description: Unprocessable Content - The request failed validation checks
content:
application/json:
schema:
type: object
properties:
issues:
type: array
items:
type: object
properties:
code:
type: string
expected:
type: string
received:
type: string
path:
type: array
items:
anyOf:
- type: string
- type: number
message:
type: string
required:
- code
- path
- message
name:
type: string
enum:
- ZodError
required:
- issues
- name
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Internal server error message
required:
- error
security:
- SiroAuthToken: []
tags:
- Sessions
/v1/sessions/{sessionId}/invocations/{invocationId}/feedback:
patch:
summary: Upsert thumbs feedback for an ADK turn (invocation).
description: Stores or replaces feedback for the given ADK invocation id within a session the caller owns.
requestBody:
content:
application/json:
schema:
type: object
properties:
feedback:
type:
- string
- 'null'
enum:
- thumbs_up
- thumbs_down
feedbackText:
type: string
maxLength: 1000
required:
- feedback
responses:
'200':
description: Upsert thumbs feedback for an ADK turn (invocation).
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
sessionId:
# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/siro/refs/heads/main/openapi/siro-sessions-api-openapi.yml