Serenities AI™

REST API

Access Serenities programmatically. All endpoints require authentication.

Get Started

Create an API key in your account settings to start making API requests.

Create API Key

Authentication

Include your API key in the Authorization header:

Authorization: Bearer mk_live_your_api_key

Base URL

https://app.serenitiesai.com/api/v1

Request Format

All endpoints use
POST
method with JSON body:
POST /api/v1/{router}/{procedure}
Content-Type: application/json
Authorization: Bearer mk_live_xxx

{
  "param1": "value1",
  "param2": "value2"
}

Example Request

curl -X POST https://app.serenitiesai.com/api/v1/tables/listDatabases \
  -H "Authorization: Bearer mk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{}'

Available Endpoints

Explore the available API endpoints organized by resource type.

Base & Tables

Bases, tables, fields, and records

Sites

Projects, pages, and components

Flows

Automation flows

Connectors (built-in)

Built-in connectors run by Serenities AI

Linked Records

Record linking

Sharing

Share links

Files

File management

AI Agents

Run agents, review approvals, manage skills

Account Functions

Cross-site functions, webhooks, and schedules

Marketplace

Browse and install templates and add-ons

Journeys

Multi-step journeys — enrol people and review runs

Social

Social channels and posts — compose, schedule, publish

Site Events

A site’s event log and catalog

Account Events

Account-wide events and the triggers they fire

Installed Apps

Internal apps installed for the account

Official Apps

Install, update, and remove the apps Serenities ships

Error Handling

200
Success
400
Bad Request - Invalid parameters
401
Unauthorized - Invalid or missing API key
403
Forbidden - No subscription or insufficient credits
404
Not Found - Endpoint or resource not found