API Reference

Complete REST API reference for PortEden calendar access, email access, and token management.

Base URL

https://api.porteden.com

All API requests require authentication via an Access Token passed as a Bearer token in the Authorization header. See Authentication to get started.

Getting Started

Authentication

Browser login flow, direct key generation, and API key usage

→

Token Management

List, revoke, and manage your access tokens

→

Token Configuration

Permissions

Access levels, visible fields, allowed operations, and timeframe restrictions

→

Access Rules

Per-contact and per-domain rules that override master access levels

→

Resource Links

Link calendars to tokens for data access

→

Calendar API

Overview & Calendars

Base URL, rate limits, access info, and list calendars

→

List & Search Events

Query events with filters, search, and pagination

→

Create, Update & Delete

CRUD operations and event invitation responses

→

Free/Busy & Contacts

Free/busy periods and events by contact lookup

→

Email API

Search & Read

Search messages, get emails, and view full threads

→

Send & Manage

Send, reply, forward, delete, and modify emails

→

Reference

Errors, Limits & Types

Error codes, HTTP statuses, rate limits, and data type reference

→

OpenClaw

PortEden + OpenClaw integration

→

Calendar Endpoints Overview

Method	Endpoint	Description
GET	/calendars	List all calendars
GET	/events	List/search events with filters
GET	/events/{eventId}	Get a single event
POST	/events	Create a new event
PATCH	/events/{eventId}	Update an existing event
DELETE	/events/{eventId}	Delete an event
POST	/events/{eventId}/respond	Respond to event invitation
GET	/freebusy	Get free/busy information
GET	/events/by-contact	Get events by contact

All calendar endpoints are prefixed with /api/access/calendar

Email Endpoints Overview

Method	Endpoint	Description
GET	/messages	Search/list emails
GET	/messages/{emailId}	Get a single email
GET	/threads/{threadId}	Get an email thread
POST	/messages/send	Send a new email
POST	/messages/{emailId}/reply	Reply to an email
POST	/messages/{emailId}/forward	Forward an email
DELETE	/messages/{emailId}	Delete an email
PATCH	/messages/{emailId}	Modify email labels/read status

All email endpoints are prefixed with /api/access/email