Your whole business, one API.

Read the records that run your business. Start work from code. Anything that sends, spends, signs, or publishes waits for your approval.

Read the API docsnpm i -g @amolfi/cli

RecordsGET /v1/tools/{tool}

WorkPOST /v1/runs

Approvals202 pending_approval

EventsPOST your-endpoint

Start from your terminal.

@amolfi/cli · zsh

npm i -g @amolfi/cli

added 1 package in 1.4s

@amolfi/cli 0.1.0-rc.4 · node ≥ 20 · zero runtime dependencies

amolfi login

To sign in, open:

https://amolfi.com/device?user_code=QHTZ-XKBD

and confirm the code QHTZ-XKBD

Pick the workspace in the browser. One token, one workspace.

signed in · workspace org_5c9a1e (credential in macOS Keychain)

amolfi ask "chase the invoices that went past due this week"

run 8f3c21d6-4b90-4e17-9a55-0c2f7be1d4aa

amo · routing to Finance

finance · reading invoices · 4 past due in the last 7 days

finance · 3 have a billing contact; 1 does not

revenue · no open deal is blocked by these invoices

finance · drafted 3 reminders · one per client, cash basis

finance · sending an email is a governed action

approval required · this waits for an owner, in the app

approve or deny at https://amolfi.com/chat?decision=dec_7b41f0

(the CLI has no approve verb; that is the contract, not a gap)

Work runs. You stay in control.

01The machine asksAPI token
POST/v1/runs
```
{
  "goal": "send invoice INV-1042",
  "idempotency_key": "a3f1…"
}
```
An agent, a cron job, a dashboard button. It carries a workspace token and nothing more.

02The gateOwner approval

202Accepted, and held.

{
  "status": "pending_approval",
  "decision_id": "dec_8f2c…",
  "approve_in": "the app"
}

# a 200 never comes back from here.
# no retry will ever produce one.

The action is real, described, and stopped. Nothing has left the workspace.

03The owner decidesIn the app
Send invoice INV-1042 ($4,200.00) to acme@example.com
Requested by
Workspace token · billing-bot
Action
finance.invoice.send
Decides
Jordan Reyes · Owner
Demonstration only. Nothing is sent.
Approved by Jordan Reyes. The invoice sends, the receipt is written, and the run continues.

See the contract answer.

Health, scopes, and OpenAPI are public. Run the real request before you mint a key.

Call the API from this page

These three routes are public and need no credentials. Run one and read what came back.

api.amolfi.com

shell

curl https://api.amolfi.com/v1/health

sample

sample response41 B

{
  "ok": true,
  "service": "amolfi-public-api"
}

This is a recorded sample. Press Run to make the real call from your browser, or copy the command and run it yourself.

Your systems know when work moves.

Signed events carry the change. Approval events carry the decision back to you.

POST https://your-endpoint31 events · 12 families

invoice.createdINV-1042 issued to Meridian, net 15signed
deal.updatedHarborline moved to Proposal. Stage moves ride this eventsigned
run.waiting_approvalA run paused for an owner decision. A card is waiting in the appsigned
booking.createdDiscovery call booked for Thursday, 10:00signed
contract.sentThe Ardent MSA reached both signerssigned
contact.createdNew contact on the Meridian accountsigned
run.completedOctober recap drafted from what actually shippedsigned
member.invitedA seat was offered. Access has not begunsigned
project.updatedBrand refresh moved to In reviewsigned
invoice.paidINV-1038 fully paid. Partial payments never fire thissigned
client.createdArdent Studio added as a clientsigned
apikey.createdKey minted. Scope count only, never the keysigned
deal.createdNorthwind retainer opened as an opportunitysigned
contract.signedAll signers completed the Harborline MSAsigned
booking.updatedKickoff moved to Friday. Reschedules ride this eventsigned
run.failedRun failed. The upstream provider timed outsigned
contact.updatedContact title and phone changedsigned
domain.verifiedsend.northwind.example passed DNS verificationsigned
project.createdQ4 site build opened under Meridiansigned
member.joinedInvite accepted. The moment access actually beginssigned
contract.declinedA signer declined the renewal addendumsigned
client.updatedPike & Co. archivedsigned
booking.cancelledStrategy review cancelledsigned
run.cancelledRun cancelled by the workspace ownersigned
apikey.revokedKey revoked. The event that closes an incidentsigned
contract.expiredSignature request expired before completionsigned
member.removedMember deactivated. The moment access endssigned
file.availablepricing-model.md passed scanning and is readysigned
file.heldUpload held. Content stays unavailable after the scan failedsigned
file.updatedWorkspace file metadata changedsigned
file.archivedWorkspace file archivedsigned
invoice.createdINV-1042 issued to Meridian, net 15signed
deal.updatedHarborline moved to Proposal. Stage moves ride this eventsigned
run.waiting_approvalA run paused for an owner decision. A card is waiting in the appsigned
booking.createdDiscovery call booked for Thursday, 10:00signed
contract.sentThe Ardent MSA reached both signerssigned
contact.createdNew contact on the Meridian accountsigned
run.completedOctober recap drafted from what actually shippedsigned
member.invitedA seat was offered. Access has not begunsigned
project.updatedBrand refresh moved to In reviewsigned
invoice.paidINV-1038 fully paid. Partial payments never fire thissigned
client.createdArdent Studio added as a clientsigned
apikey.createdKey minted. Scope count only, never the keysigned
deal.createdNorthwind retainer opened as an opportunitysigned
contract.signedAll signers completed the Harborline MSAsigned
booking.updatedKickoff moved to Friday. Reschedules ride this eventsigned
run.failedRun failed. The upstream provider timed outsigned
contact.updatedContact title and phone changedsigned
domain.verifiedsend.northwind.example passed DNS verificationsigned
project.createdQ4 site build opened under Meridiansigned
member.joinedInvite accepted. The moment access actually beginssigned
contract.declinedA signer declined the renewal addendumsigned
client.updatedPike & Co. archivedsigned
booking.cancelledStrategy review cancelledsigned
run.cancelledRun cancelled by the workspace ownersigned
apikey.revokedKey revoked. The event that closes an incidentsigned
contract.expiredSignature request expired before completionsigned
member.removedMember deactivated. The moment access endssigned
file.availablepricing-model.md passed scanning and is readysigned
file.heldUpload held. Content stays unavailable after the scan failedsigned
file.updatedWorkspace file metadata changedsigned
file.archivedWorkspace file archivedsigned

What ships now.

Open the docs

Public APILive at api.amolfi.com.Live

CLIInstall @amolfi/cli from npm.Live

Governed runsStart, follow, steer, and cancel work.Live

Approval cardsOutward actions wait for a named owner.Live

WebhooksSigned delivery across thirty-one events and twelve families.Live

MCP serverDirect workspace access for coding tools.Next