Revero Public APIpublic-api

Create Meeting

Create a meeting, idempotent within the OAuth client by external_id.

Authentication

AuthorizationBearer

Revero-owned OAuth 2.0 Client Credentials. Obtain tokens only from a backend; never place the client secret in browser code.

Request

This endpoint expects an object.
external_idstringRequired1-255 characters

Your own identifier for this meeting. Creation is idempotent on it: re-sending an identical request returns the same meeting with 200 instead of 201. Re-using it for a DIFFERENT request (other documents, another language) is a 409 external_id_conflict.

languagestringOptional2-10 charactersDefaults to no
Spoken language, for transcription and generation.
output_profileslist of stringsOptional

Which documents this meeting should produce, by stable profile key. Each becomes one output resource you fetch separately. The profile VERSION is pinned now: publishing a new version later never changes what this meeting produces. Defaults to the transcript alone.

locked_contextmap from strings to any or nullOptional

Your authoritative facts about this meeting — a case number, participants, a date. Stored encrypted, returned as its own field, and never rewritten by generation: your system stays authoritative for legal and business facts. Captured ONCE, on the request that creates the meeting, so a later call with the same external_id cannot restate it under documents already generated from it. At most 16384 bytes serialized.

Response

Idempotent replay — a meeting with this external_id already existed and the request matches it. The same resource is returned; nothing was created.

idstringformat: "uuid"
Revero's identifier for this meeting.
external_idstring
Your identifier, exactly as you sent it.
statusenum
Coarse state of the meeting as a whole.
languagestring
The language this meeting is processed in.
created_atdatetime
When the meeting was created.
updated_atdatetime
When this resource last changed.
recordingslist of objects
Audio uploaded for this meeting, as metadata.
outputslist of objects
The documents this meeting declared, as metadata. Fetch each one's content from its own resource.
locked_contextmap from strings to any or nullOptional

Exactly the facts you supplied at creation. Returned beside the generated documents rather than inside them, and never derived from one — a model cannot promote its own guess into this field.

Errors

401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
422
Unprocessable Entity Error
503
Service Unavailable Error