List by FullForms

FullForms · List

API access

Personal access tokens let your own scripts, tools, and workflows search your glossaries and add entries. It's the same API our Raycast and browser extensions run on.

Get a token

  1. Open Account settings on the web app and generate a token under API tokens.
  2. Copy it right away; the full token is shown once. It looks like ffl_….

Tokens are revocable at any time from the same page, and revoking one never affects your password or other tokens.

Make a request

Send the token as a bearer token in the Authorization header: 

curl -H "Authorization: Bearer ffl_YOUR_TOKEN" \
  "https://list.fullforms.com/api/v1/search?q=arr"

Responses are JSON.

What's available

  • GET /api/v1/search?q= · Search lists and entries, across all your workspaces or one.
  • GET /api/v1/workspaces · Your workspaces, with role and plan.
  • GET /api/v1/lists · Lists you can see, with your role, entry count, and tags.
  • GET /api/v1/favorites · Lists you have favorited.
  • GET /api/v1/recent · Entries you added recently, newest first.
  • POST /api/v1/entries · Create an entry on a list you can edit.
  • POST /api/v1/suggestions · Submit a suggestion to a list that accepts them.
  • POST · DELETE /api/v1/entries/:id/star · Star or unstar an entry.
  • POST · DELETE /api/v1/lists/:id/favorite · Favorite or unfavorite a list.
  • GET /api/v1/lists/:id/check-duplicates · Check whether an entry or definition already exists.

The API is in early access, so this summary can grow. Every endpoint enforces your account's permissions server-side: a token can never read or write anything your account couldn't.

Rate limits & errors

  • Requests are rate limited per token (60 per minute). Past the limit you get a 429; back off and retry.
  • Permission problems return 403, validation problems 400 with a short reason, and a revoked or invalid token 401.