Siro

Siro Core API

The Core API from Siro — 23 operation(s) for core.

GitHub OpenAPI

Operations 138

GET /v1/core/recordings/{id} Get recording #
DELETE /v1/core/recordings/{id} Soft-delete a recording #
GET /v1/core/recordings Get recordings #
PUT /v1/core/recordings Create a new recording #
PATCH /v1/core/recordings Update a recording #
POST /v1/core/recordings Fetch a list of recordings by id #
GET /v1/core/recordings/{id}/summaries Get recording summaries #
GET /v1/core/users Get users #
POST /v1/core/users Create user #
GET /v1/core/users/{id} Get user #
PUT /v1/core/users/{id} Update user #
GET /v1/core/mobile-events Get mobile events for an org #
GET /v1/core/mobile-events/{id} Get mobile event by ID #
GET /v1/core/auth/caller-identity Get details about your current auth token #
GET /v1/core/auth/tokens/{id} Get a single authentication token by ID #
DELETE /v1/core/auth/tokens/{id} Delete a single authentication token by ID #
GET /v1/core/auth/tokens List all tokens for a given org #
POST /v1/core/auth/tokens Create a new authentication token for an organization #
GET /v1/core/oauth/apps/{clientId} Get a specific OAuth app #
DELETE /v1/core/oauth/apps/{clientId} Delete an OAuth application by id #
GET /v1/core/oauth/apps Get all OAuth apps for an organization #
POST /v1/core/oauth/apps Create a new OAuth application for an organization #
GET /v1/core/oauth/apps/{clientId}/access-token/{tokenId} Get a specific OAuth access token by id #
DELETE /v1/core/oauth/apps/{clientId}/access-token/{tokenId} Revoke an OAuth access token for a given OAuth app #
POST /v1/core/oauth/apps/{clientId}/access-token Create a new OAuth access token for a given OAuth app #
GET /v1/core/oauth/apps/{clientId}/access-token Get all OAuth access tokens for a given OAuth app #
GET /v1/core/organizations Get organizations #
POST /v1/core/organizations Create an organization #
GET /v1/core/organizations/{id} Get an organization #
PATCH /v1/core/organizations/{id} Update an organization #
GET /v1/core/integrations/connections Get all integration connections for a single org #
POST /v1/core/integrations/connections Create a new integration connection for a given org #
GET /v1/core/integrations/connections/{id} Get a single integration connection within a single org #
PATCH /v1/core/integrations/connections/{id} Update a single integration connection within a given org #
DELETE /v1/core/integrations/connections/{id} Delete a single integration connection within a single org #
PUT /v1/core/integrations/salesforce Upsert Salesforce integration authentication details #
GET /v1/core/organizations/{orgId}/teams Get all teams for an org #
POST /v1/core/organizations/{orgId}/teams Create a new team for an org #
GET /v1/core/organizations/{orgId}/teams/{teamId} Get a single team within a given org #
PATCH /v1/core/organizations/{orgId}/teams/{teamId} Update a single team within a single org #
DELETE /v1/core/organizations/{orgId}/teams/{teamId} Hard-delete a single team within a single org #
PUT /v1/core/recordings/{id}/viewed Mark a recording as viewed #
POST /v1/core/recordings/{id}/views Report a recording view duration #
PUT /v1/core/recordings/{id}/listen Report recording listening time #
GET /v1/core/recordings/{id}/utterances Get recording utterances #
POST /v1/core/recordings/{id}/chats Ask Siro GPT about a recording #
GET /v1/core/recordings/{id}/chats/available Check recording chat availability #
GET /v1/core/recordings/{id}/deep-link/{tenant} Get deep link for recording #
POST /v1/core/recordings/search Search recordings #
PATCH /v1/core/recordings/{id}/transcription-language Update the transcription language for a recording #
POST /v1/core/recordings/{id}/signedUrl Create signed URL for redacted recording audio (download) #
GET /v1/core/recordings/{id}/summary Get the summary for the recording provided #
GET /v1/core/folders Get all folders for a user #
POST /v1/core/folders Create a new folder #
DELETE /v1/core/folders Delete a folder #
GET /v1/core/folders/{id}/items Get folder items #
POST /v1/core/folders/{id}/items Add item to folder #
DELETE /v1/core/folders/{id}/items Delete folder item #
PATCH /v1/core/folders/{id} Update a folder #
GET /v1/core/comments Get all comments the user is a recipient on #
POST /v1/core/recordings/{id}/comments Create a new comment for a recording #
GET /v1/core/recordings/{id}/comments Get all comments for a recording #
GET /v1/core/recordings/{id}/threads Get all threads for a recording #
GET /v1/core/threads Get all threads for a user #
GET /v1/core/threads/unread Get all unread threads for a user #
GET /v1/core/recordings/{id}/comments/{commentId} Get a single comment #
PATCH /v1/core/recordings/{id}/comments/{commentId} Update a comment #
DELETE /v1/core/recordings/{id}/comments/{commentId} Delete a comment #
POST /v1/core/recordings/{id}/comments/{commentId}/rating Rate a Siro bot comment (thumbs up / thumbs down) #
PATCH /v1/core/recordings/{recording_id}/threads/{thread_id} Update thread privacy #
POST /v1/core/conversation-configurations Create a new conversation configuration #
GET /v1/core/conversation-configurations Get conversation configurations #
PATCH /v1/core/conversation-configurations/{id} Update conversation configuration #
GET /v1/core/summary-prompts/industry Get summary prompts for the caller organization industries #
GET /v1/core/conversation-configurations/{conversationTypeId}/summary-prompts Get summary prompts for a conversation configuration #
POST /v1/core/conversation-configurations/{conversationTypeId}/summary-prompts Create summary prompts for a conversation configuration #
PUT /v1/core/conversation-configurations/{conversationTypeId}/summary-prompts Replace summary prompts for a conversation configuration #
GET /v1/core/bookmark-configs Get bookmark configurations #
GET /v1/core/bookmark-groups Get bookmark groups #
GET /v1/core/bookmark-models Get bookmark models #
POST /v1/core/bookmark-models Create a bookmark model #
PATCH /v1/core/bookmark-models/{modelId} Update a bookmark model #
GET /v1/core/manual-labels Get manual labels #
POST /v1/core/manual-labels Create a manual label #
DELETE /v1/core/manual-labels/{manualLabelId} Delete a manual label #
PATCH /v1/core/manual-labels/{manualLabelId}/toggle Toggle a manual label #
GET /v1/core/bookmark-configs/{bookmarkConfigId}/labeled-recordings Get labeled recordings for a bookmark config #
GET /v1/core/organizations/{id}/users Get all users for an organization #
GET /v1/core/entities/extractions/{recordingId} Get entity extractions for a recording #
GET /v1/core/scorecards/scorecard-metrics/values Get scorecard metrics values #
GET /v1/core/scorecards/users/{userId}/weighted-score-history Get weighted scorecard score history #
GET /v1/core/scorecards/teams/{teamId}/weighted-score-history Get weighted scorecard score history for a team #
GET /v1/core/scorecards/scorecard-metrics/available Get available scorecard metrics #
GET /v1/core/scorecards/scorecard-metrics/{id} Get scorecard metric configuration data #
PATCH /v1/core/scorecards/scorecard-metrics/{id} Update scorecard metric prompt #
DELETE /v1/core/scorecards/scorecard-metrics/{id} Delete scorecard metric #
PUT /v1/core/scorecards/scorecard-metrics Create scorecard metric #
PUT /v1/core/scorecards/instances Create scorecard instance #
GET /v1/core/scorecards/instances Get scorecard instances #
PATCH /v1/core/scorecards/instances/{id} Update scorecard instance #
GET /v1/core/scorecards/instances/{id} Get scorecard instances #
GET /v1/core/scorecards/color-configurations Get active scorecard color configurations #
GET /v1/core/scorecards/instance-summaries Get scorecard instance summaries #
GET /v1/core/scorecards/evaluated-instances/{id} Get evaluated scorecard instance #
GET /v1/core/scorecards/evaluated-instances/{id}/populations Get evaluated scorecard instance for multiple populations #
GET /v1/core/scorecards/standardized-prompts Get scorecard standardized prompts #
GET /v1/core/followups Get followups #
PATCH /v1/core/followups/{id} Update a followup #
POST /v1/core/sdk-logging/siro-logs Submit SDK Siro log #
GET /v1/core/companion-call/settings Get companion call settings #
PUT /v1/core/companion-call/settings Update companion call settings #
GET /v1/core/halftime/recordings/{recordingId}/transcript Poll live halftime transcript #
GET /v1/core/outcomes/outcome-definitions Get outcome definitions for a user #
GET /v1/core/outcomes/outcome-definitions/{conversationConfigId} Get outcome definitions for conversation type #
POST /v1/core/outcomes/outcome-definitions/{conversationConfigId} Create or update outcome definition #
POST /v1/core/outcomes/set-multiple/{conversationConfigId} Set multiple outcomes #
GET /v1/core/recordings/{recordingId}/outcomes Get a recording’s possible and selected outcomes #
PATCH /v1/core/recordings/{recordingId}/outcomes Edit a recording’s selected outcomes #
POST /v2/core/recordings/search Search recordings #
POST /v2/core/recordings/search/slim Search recordings (slim) #
POST /v2/core/recordings/list-decorations Batch list decorations #
POST /v2/core/recordings/{id}/signed-url Create a signed URL for a recording #
POST /v2/core/recordings/users/{userId}/list List recordings for a user #
GET /v2/core/recordings/{id}/summary Get the summary for the recording provided #
GET /v2/core/bookmark-configs Get bookmark configurations (v2) #
PATCH /v2/core/bookmark-configs/{id} Update a bookmark configuration (v2) #
GET /v2/core/bookmark-groups Get bookmark groups (v2) #
POST /v2/core/bookmark-groups Create a bookmark group (v2) #
PATCH /v2/core/bookmark-groups/{id} Update a bookmark group (v2) #
GET /v2/core/industries Get industries (v2) #
POST /v2/core/industries Create an industry (v2) #
GET /v2/core/industries/{id} Get an industry (v2) #
PATCH /v2/core/industries/{id} Update an industry (v2) #
POST /v1/core/recordings/upload Create a recording from a phone call #
POST /v1/core/recordings/signed-urls Get a signed URL for uploading a recording #

Documentation

📖
Documentation
https://docs.siro.ai
📖
GettingStarted
https://docs.siro.ai/getting-started
📖
APIReference
https://docs.siro.ai/api-references/get-recordings
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/siro/refs/heads/main/authentication/siro-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/siro/refs/heads/main/rate-limits/siro-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/siro/refs/heads/main/openapi/siro-core-api-openapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/siro/refs/heads/main/asyncapi/siro-webhooks.json

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/siro-core-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

siro-core-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Siro Core API
  version: 1.0.0
  description: 'Operations tagged Core across 3 of this provider''s published API definitions: siro-external-api-openapi.json, siro-openapi-original.json, siro-platform-api-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://functions.siro.ai/api-externalApi
  description: Siro API external API endpoint
- url: https://api.siro.ai/
  description: Siro API Gateway
tags:


# --- truncated at 32 KB (1641 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/siro/refs/heads/main/openapi/siro-core-api-openapi.yml