Introduction

Accounts, Daaymail, Keeps, and organisations — one API for Daaysorn identity.

Daaysorn Account is the identity API behind Daaysorn. You create accounts, sign people in, give them a Daaymail address, let them save Keeps, and run organisations with teams — all through one REST surface.

Guides walk you through the product in plain language. The API tab is the full reference (with try-it-in-the-browser). The Changelog tab lists what shipped.

Replace BASE with your API origin (local: http://localhost:3000, staging: https://devact.daaysorn.com).

Who it’s for

You’re building a Daaysorn client — web, mobile, or another service — that needs real accounts:

• Username-first signup with a platform mailbox
• Sign-in with username, email, phone, or WhatsApp
• Profile updates that require a second check before sensitive changes
• Mail listing, sending, and forwarding
• Shared work through organisations and teams

If you only need OpenAPI shapes, skip ahead to the API tab.

What you get

Accounts and sessions

Create an account, sign in, and receive a session token plus a refresh token. Call GET /v1/api/user/profile for the current user. Rotate access with POST /v1/api/auth/session/refresh.

Daaymail

Each account gets one mailbox on daaymail.com. You can list folders, read messages, send mail, and set forwarding. System mail (codes, invites) is delivered for you.

Keeps

Save a link; enrichment fills title, summary, tags, and a preview when workers are running.

Organisations and teams

Create an organisation after recovery email is confirmed. Manage teams on /v1/api/teams/*.

How responses look

Every API response looks like this:

{
  "statusCode": 200,
  "statusType": "OK",
  "message": "…",
  "data": {}
}

Auth: send the session cookie from sign-in, or Authorization: Bearer <token>. Prefer GET /v1/api/user/profile for the session envelope.

Try it

1. GET BASE/health
2. Create an account
3. Sign in and store token + refreshToken
4. GET BASE/v1/api/user/profile with Authorization: Bearer <token>

Or open the API tab and use Try it against local or staging (your docs origin must be allowed by the API’s CORS settings).

Ask AI and MCP

Ask AI answers from these pages. Connect agents to:

https://docs.daaysorn.com/mcp

Setup: MCP & Ask AI.

Next steps