1
Get an access token
The REST API authenticates with a session access token. Log in with an AmDital user’s email and password (note: this path has no Copy
/api prefix):accessToken from the response. It is valid for 15 minutes; send refreshToken to POST /v1/auth-next/refresh to get a new one. See Authentication for details.API keys (
sk_...) from Settings → Developer work only on the MCP endpoint. The REST API rejects them with 401.2
Make your first API call
Send the token as a bearer token:List endpoints return
{ "docs": [...], "totalDocs": n, "page": n, "totalPages": n }. Every path and its parameters are in the OpenAPI spec.3
Invite your team (optional)
Workspace Owners and Admins can invite people in the app: go to Settings → Team Members, click Invite Member, enter the email address, choose a role, and click Send Invite.
Next steps
Explore the API Reference
Download the OpenAPI spec for every REST endpoint.
Set up webhooks
Get signed HTTP callbacks when records change.
Connect AI agents via MCP
Let AI tools read and write workspace data.
Rate limits & pagination
Limits per route and the list response envelope.