How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

API Samu

REST API for the Samu conversation-intelligence platform. Covers account users, meeting creation and update from externally recorded calls (audio/video URL plus optional transcription), meeting retrieval and transcription retrieval, date-ranged meeting listing with offset pagination, and the chat surface for WhatsApp/HubSpot/email conversation threads, their messages and their daily AI-generated interaction summaries. Authenticated with an account API key sent in the apiKey header. Sold as "API Out / API In" on the Enterprise plan.

This API exposes 10 operations across 9 paths, organized into 3 resource areas, and defines 12 schemas. It is described by OpenAPI 3.0.0, at version 1.0.1.

Requests are made against a single base URL, https://api.samu.ai.

10 operations 9 paths 12 schemas 8 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.1
Base URL
https://api.samu.ai
Authentication
API Key
Resource Areas
3

Authentication & Security 1

API Samu declares 1 security scheme for authenticating requests. An API key is passed in the header as apiKey (ApiKeyAuth).

  • ApiKeyAuth — API key de la cuenta

Paths & Operations 10

Across 9 paths, the API surfaces 10 operations — 8 GET, 1 POST, 1 PUT. They span 3 resource areas: Usuarios, Meetings, Threads. Each is listed below with its method, path, parameters, and response codes.

Usuarios 1
GET
/api/users
Obtiene la lista de usuarios para la cuenta
→ 200400
Meetings 5
POST
/api/meeting
Crea una nueva meeting a partir de la información de la llamada proporcionada. El video tardara unos minutos en ser subido. Se devuelve el id de la nueva meeting.
body → 200400
PUT
/api/meeting/{id}
Actualiza una meeting existente
1 param body → 200400
GET
/api/meeting/{id}
Obtiene la información de una meeting específica
1 param → 200400404
GET
/api/meeting/{id}/transcription
Obtiene la transcripción de una meeting específica
1 param → 200400
GET
/api/meetings
Obtiene un listado de meetings en un rango de fechas
4 params → 200400429
Threads 4

Conversaciones (threads/messages/interactions) de WhatsApp y otros providers

GET
/api/chat/threads
List threads (inbox)
6 params → 200
GET
/api/chat/threads/{threadId}
Get a single thread
1 param → 200
GET
/api/chat/threads/{threadId}/messages
List messages in a thread (paginated)
5 params → 200
GET
/api/chat/threads/{threadId}/interactions
Lista las interacciones diarias de un thread (con summary y extractor)
5 params → 200

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are Meeting (16 properties), ConversationThreadListItem (7 properties), ConversationMessageItem (6 properties), User (6 properties). Each schema is shown below with its type and property counts.

Provider
string
El origen de la llamada (meets, zoom, etc)
User
object
6 properties
Meeting
object
16 properties
Transcription
object
2 properties
MeetingTranscriptionLine
object
3 properties
ErrorResponse
object
2 properties
SuccessResponse
object
1 property
ChatProvider
string
ConversationThreadType
string
ConversationThreadListItem
object
Item del listado de conversaciones (threads)
7 properties
ConversationMessageItem
object
Mensaje en el shape público (import)
6 properties
ConversationInteractionItem
object
Interacción diaria de un thread (snapshot del día)
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

samu-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of API Samu, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.