Revial API FAQ

The Revial API lets another system fetch your organisation's meeting data from Revial automatically. For example, a reporting tool can pull every meeting summary from the past week without anyone copying them by hand.

The basicsCopy Anchor Link

What is an API?

A way for one program to request data from another. Instead of a person opening Revial and copying information, a program asks Revial for it directly.

Do I need technical skills?

Not to create a key. Connecting the data to another tool usually needs your IT team, an integration partner, or an automation tool such as Zapier or Make.

Where do technical people find instructions?

In the Revial API reference. See also For developers below.

API keysCopy Anchor Link

What is an API key?

A password that lets another program access your organisation's Revial data. Treat it like a password.

Where do I create a key?

Go to Settings → Organisation → API Keys and select Create key. Give the key a name that says what it is used for, for example "Data warehouse export".

I can't see API Keys in the settings.

Only the organisation owner can see and create API keys. Ask your owner to create the key. See User roles.

Why is the key shown only once?

Revial does not store the key itself, only a fingerprint of it, so it cannot be shown again. Copy it as soon as it is created. If you lose it, create a new key and revoke the old one.

Why can I have several keys?

So that each tool gets its own key. When you stop using one tool, you revoke only its key and the others keep working.

What happens when a key is revoked?

It stops working immediately. A revoked key cannot be restored, but you can create a new one at any time.

Does a key expire?

No. A key works until it is revoked.

What data can a key access?

The same meetings the person who created the key can see in Revial. If that person is removed from Revial, their keys stop working.

Where should I keep the key?

In a password manager or your system's secret store. Not in email, chat or shared documents.

What the API coversCopy Anchor Link

You can:

• fetch meeting summaries
• fetch meeting transcripts
• filter meetings by seller, attendee or company
• fetch only meetings that are new or changed since your last sync
• update a meeting's custom fields
• request a new summary for a meeting

The API does not cover:

• meetings that do not have a summary yet
• audio and video recordings
• CRM data, analytics or calendar data
• creating or deleting meetings
• notifications when data changes (webhooks)
• keys with limited permissions, such as read-only keys

Need something that is not listed? Contact support@revial.ai and tell us what you are trying to achieve.

For developersCopy Anchor Link

Send the key as a bearer token on every request:

Authorization: Bearer rvl_live_...

• Pagination: list endpoints return next_cursor. Pass it back as cursor until it is null.
• Incremental sync: pass updated_after with the time of your last sync to fetch only changed meetings.
• Rate limit: 120 requests per minute per key. Over the limit, the API answers 429 with a Retry-After header giving the seconds to wait.
• Specification: the OpenAPI document is at https://api.revial.ai/v1/openapi.json and can be fed to a client generator.

When something does not workCopy Anchor Link

The key does not work.

Check that the whole key was copied and that it has not been revoked. If the person who created it has been removed from Revial, create a new key.

I get an error about too many requests.

Each key can make 120 requests per minute. Wait for the time given in the Retry-After header and try again.

Something else?

Contact support@revial.ai. Tell us what you tried to do and the error message you got.