Until recently, the Eyeson API was only designed to create and use meeting rooms immediately. When you make a POST request to /rooms, a meeting room is created instantly, and the link provided is valid only for that session. If no one joins the meeting room, it will automatically shut down, and the link will expire shortly thereafter.
Many developers requested a feature that allows them to share a meeting link ahead of time, even before the meeting starts. Eyeson listened and delivered.
With the Permalink API, you can pre-define your meeting room using all the necessary settings. In advance, share the guest link through WhatsApp, Email, Calendar, or others. When the time comes, you can start the meeting using your personal GUI host link, ensuring everything is ready and accessible at the agreed time.
POST /permalink
HEADERS Authorization
user[name]=<host-user-name>
# options[exit_url] and many more options
{
//...
"links": {
"gui": "https://app.eyeson.team/permalink/?9clgjJXl1NzbcmF5vfXWhAVJ",
"guest_join": "https://app.eyeson.team/permalink/?guest=R2SdUxiqKhpBoUu0oi0pZZkZ"
}
}
The links generated through Eyeson's Permalink API come with a prebuilt UI, ensuring that everything works seamlessly out of the box - no additional setup is required! But we didn't stop there. Understanding the need for greater flexibility, we’ve added enhanced features to give you more control over how you use the Permalink API.
The Permalink API offers various endpoints to enhance your control and integration options. You can gather meeting information, check the current running state, start the meeting using a permalink user token, and register a guest user. These features, among many others, simplify integrating the Permalink API with your custom UI.
The process:
For easier integration, we have added functions in EyesonJS.
If needed, after creating the permalink, you may want to update the settings.
In addition to updating, you can register multiple host users to a permalink. This enables any registered host to start the meeting at the scheduled time.
You can also delete a permalink at any time. Once deleted, all associated links and tokens will become invalid immediately.
Dive deeper into our Documentation, read more interesting articles in our Tech Blog, and create a GitHub ticket if you have any questions.