Skip to main content
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 /api prefix):
Copy 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.
If the response contains "mfaRequired": true, the user has two-factor authentication on. The token is MFA-pending: it expires in 5 minutes (expiresIn is 300) and every call returns 401. Send the 6-digit authenticator code to POST /v1/auth-next/mfa/complete-login with the pending token as the bearer token and the login refreshToken in the body:
Use the accessToken in that response. For backup codes and error responses, see API Reference.
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.