# Amolfi documentation

Source: https://amolfi.com/docs

# Amolfi documentation

Source: https://amolfi.com/docs#overview

## Your workspace.  
From first steps to API.

Learn how Amolfi works, build on its capabilities, and put your business in motion.

---

# What is Amolfi?

Source: https://amolfi.com/docs#get-started--what-is-amolfi

Amolfi is one workspace for running a whole operation — CRM, projects and delivery, finance, knowledge, and marketing — in one place, over one shared model of your business.

### One connected model, not a dozen tools

A client, a deal, a project, an invoice, and a document are the same connected records, not copies kept in rough sync across separate apps. Because everything is connected, the AI built into the product can reason across your whole business instead of one silo at a time.

- CRM, prospecting and leads
- Projects and delivery
- Finance
- Files and company knowledge
- Marketing — social and email
- Contracts and meetings

### Who Amolfi is for

Amolfi is built for small and growing service businesses — agencies, studios, consultancies, and trades — that are tired of stitching together a dozen tools and want to run the entire operation, from first lead to paid invoice, in one place with AI that can actually help.

These docs describe the Amolfi platform itself, not any one company running on it.

---

# Create your workspace

Source: https://amolfi.com/docs#get-started--create-your-workspace

Start by telling Amolfi about your business. The setup questions come before you create an account, so your workspace begins with context about the work you do.

### From setup to workspace

After the setup questions, create your account and continue the workspace setup. Plan selection comes after onboarding.

1. Tell Amolfi about your business.
2. Create your account with Google or email.
3. Continue the guided setup for your workspace.

[Get started](https://amolfi.ai/start)[Log in to an existing account](https://amolfi.ai/login)

### Where you land

Sign in to the app at amolfi.ai. In your workspace, use Chat to talk to Amo and open the other workspace surfaces to find your records, work, and settings.

---

# Map your business

Source: https://amolfi.com/docs#get-started--map-your-business

Amolfi works best when it’s grounded on your real business. Setup means mapping your org — your clients, your services, and your team — so Amo can answer about your business instead of answering generically.

### Why mapping matters

An assistant that only knows general facts about your industry gives generic answers. An assistant that knows your actual clients, your actual services, and your actual team gives answers grounded in your business.

- Your clients and the relationships between them
- The services you offer
- Your team and how work is organized

### Built for this stage

The Starter plan is built for exactly this stage — setting Amolfi up on your business, before you’re running day-to-day work through it.

---

# Plans & usage

Source: https://amolfi.com/docs#get-started--plans-and-usage

Amolfi has six plans: **Starter**, **Pro**, **Max**, **Ultra**, **Business** and **Enterprise**. Start with how many people need to work in the workspace and how much work you want to delegate.

### Choosing a plan

Starter, Pro, Max and Ultra are single-member workspaces. Starter is where you set Amolfi up on your business and run your first real work through it, and it comes with a 14-day trial that takes a card. Pro is one person running a real business on Amolfi, with 3× Starter’s usage. Max is one person with the biggest engine: 8× Starter’s usage, Moonshot and the bigger machine, with Social linking included. Ultra is the most Amolfi sells one person: 30× Starter’s usage and Ultrawork. Business is priced by the person, two people minimum: each person holds a Team seat, with Pro’s usage and computer, or a Team+ seat, with Max’s, and you can mix the two. Every plan runs every model; the plans differ in how much work they carry and how far it can go. Enterprise is for a contracted envelope, custom security and terms, procurement, or invoicing. If you’re between two plans, start lower — moving up keeps everything you’ve already set up. An owner or admin can open Settings, choose Billing & Usage, and change plan. Enterprise and changes between monthly and yearly billing go through the team.

### What each plan includes

- Starter — the whole Amolfi workspace: agentic chat on every model, effort through High, 30 minutes a day on its own computer for each Amo, one machine awake at once, pictures and clips up to 5 seconds, bank linking, one member. Social linking is not part of Starter.
- Pro — everything in Starter at 3× the usage, 2 hours a day on its own computer for each Amo, two machines awake at once, clips up to 10 seconds, and API keys for outside agents, the CLI and MCP clients. Social linking is available as a $49-a-month add-on. One member.
- Max — everything in Pro at 8× Starter’s usage, plus Moonshot, the bigger machine, 4 hours a day on its own computer for each Amo, three machines awake at once, the longest clips the provider makes, and Social linking included. One member.
- Ultra — everything in Max at 30× Starter’s usage, plus Ultrawork and 8 hours a day on its own computer for each Amo, five machines awake at once. One member.
- Business — priced by the person, two people minimum, on any mix of two seats. Team ($100 a month) gives that person everything in Pro: 3× Starter’s usage and 2 hours a day on its own computer for each Amo, two machines for each person awake at once. Team+ ($250 a month) gives them everything in Max, Moonshot included: 8× Starter’s usage and 4 hours a day on its own computer for each Amo, three machines for each person awake at once. Every seat carries Social linking, team roles and permissions, approvals and review flows, and a shared company memory and knowledge base.
- Enterprise — every feature, Ultrawork included, plus expert-designed agents, advanced security and admin controls, white-glove onboarding, agent deployment planning, procurement, invoicing and net terms, custom terms, and a dedicated support line. Every contract carries an agreed usage envelope.

Each plan also includes storage and a monthly download allowance. They are shown beside the usage bar in Billing & Usage, and set out in the Terms (§11.3).

### Members and usage

Only Business charges per member: a Team seat is $100 a month and a Team+ seat is $250, and each seat brings that person the weekly usage of the plan it mirrors. Each person’s usage is their own by default; an owner can choose to share it across the team. Starter, Pro, Max and Ultra are single-member workspaces — one active membership, of any role. Enterprise is written into the contract.

---

# Talking to Amo

Source: https://amolfi.com/docs#amo--talking-to-amo

Amo is the AI inside Amolfi. Open Chat in your workspace to start or continue a conversation.

### Ask in your own words

You don’t need to learn a command syntax or memorize where a feature lives. Ask Amo in your own words, and it works from the context of your workspace to answer or act.

Amo works from the workspace context and records it is permitted to read. That lets it reason across CRM, projects, finance, knowledge, and marketing in the same conversation.

For anything outside the product — questions, a demo, partnerships — use the contact page rather than chat.

---

# Delegating work

Source: https://amolfi.com/docs#amo--delegating-work

Amo doesn’t just answer questions — it can own real work: research a lead, draft a campaign, update a record, or summarize a meeting.

### Choose a working style

**Ask** means Amo does the work and pauses only when your judgment would materially improve the result. **Auto** is the default: Amo assumes you may walk away, makes reasonable judgment calls, keeps durable work moving, and returns with a useful result.

Working style never grants approval. Money, outbound sends, signing, publishing, destructive actions, and other consequential work still stop at the same permission, risk, cost, and named-owner controls. A request for missing input is separate from an approval card; replying can resume the run, but it cannot approve an action.

Agents re-enter the same action handlers a person would click in the UI, running as the person who asked. That means an agent can never do something the person delegating couldn’t do themselves — same permissions, same scope.

### Every run leaves a receipt

Every run leaves an attributable record: who asked, what ran, and what it touched. Nothing runs anonymously.

---

# Approvals & governance

Source: https://amolfi.com/docs#amo--approvals-and-governance

Anything touching money or leaving your workspace waits for a named owner to approve it. An agent can prepare the action, but it cannot approve its own work.

### The rule that never bends

Money and anything outbound — a client email, a public post, or a contract sent for signature — always becomes an approval card that a workspace owner has to approve before it runs. The agent cannot self-approve, no matter how routine the action looks.

### Bounded by design

- Each agent is bounded — a hard risk ceiling and a kill switch, so one agent can never borrow another’s authority.
- Agents run as the person who asked, with that person’s own permissions — never more.
- Sensitive actions append to an audit log as they happen, so there’s a written record of what happened and who approved it.

The result is an assistant that moves fast on the low-risk parts of the work and stops, visibly, at the parts that need a human decision.

---

# Attachments & files

Source: https://amolfi.com/docs#amo--attachments-and-files

You can attach supported documents and images directly in a conversation, and Amo reads them as part of the work you delegate — a short PDF to review, a screenshot to explain, or a CSV export to summarize.

### Where files live

A file you attach stays with the conversation it was shared in, so it’s still available to download when you return. Attachments are not added to Cloud automatically.

If a document should be somewhere the whole team works from it, add it in Cloud — chat attachments stay with the thread.

Each chat upload can be up to 25 MB. For an Amo reply, the current reader takes from the message that starts the reply: at most two supported documents up to 60 KB each — PDF, plain text, Markdown, CSV, or JSON — and four supported images up to 4 MB each — JPEG, PNG, GIF, or WebP. Larger or unsupported files remain attached but are not read into the reply. Export a spreadsheet to CSV before attaching it.

---

# Members & roles

Source: https://amolfi.com/docs#workspace--members-and-roles

Amolfi has six workspace roles, from Owner to Guest. Each person sees exactly the work they need — no more.

### The six roles

- Owner — the workspace’s final authority: roles, settings, and everything below.
- Admin — manages setup, members, and module configuration.
- Member — runs the day-to-day work across the modules they’re given.
- Viewer — read-only visibility, sees the work without touching it.
- Hire — scoped onboarding access while a new person ramps up.
- Guest — sees only the items shared with them, not the whole module.

### Finer-grained control

On top of the six roles, access can be refined per module, and a guest can be scoped down to a single item rather than an entire module.

---

# Invites & member limits

Source: https://amolfi.com/docs#workspace--invites-and-member-limits

Starter, Pro, Max and Ultra are single-member workspaces — one active membership, of any role. Business is priced by the person, two people minimum: each member holds a Team or a Team+ seat. Enterprise is written into the contract.

### What a member costs, and what they bring

On Business, a Team seat is $100 a month and a Team+ seat is $250. Each seat brings that person the usage and computer of the plan it mirrors, so what the workspace gets grows with the team rather than being divided by it.

The meter itself still counts work rather than headcount: what you spend inside the envelope scales with how much work Amolfi does for you, not with how many people are looking at it.

Adding a second person needs Business — Starter, Pro, Max and Ultra are capped at one active membership, of any role, so a viewer occupies it too. An owner or admin can open Settings, choose Billing & Usage, and use Change plan to upgrade. The upgrade takes effect immediately, Stripe invoices the prorated difference, and nothing you’ve already set up is lost.

---

# CRM

Source: https://amolfi.com/docs#platform--crm

A standalone CRM sees a pipeline: the deal, the stage, the next follow-up — and almost nothing about what happens after someone says yes. Amolfi’s CRM is rebuilt around the whole customer, not just the sale.

### One record, not one more silo

Clients, contacts, deals, notes, files, and activity history live as a single customer record. The same record the pipeline runs on is the record the project and the invoice run on, because in Amolfi they’re the same connected records.

- Clients, contacts, deals, notes, files, and history in one record.
- The CRM sees the invoice and the project because they’re the same records.
- Update the customer once — the pipeline, the project, and the invoice all see it.

The pipeline is where a customer starts. It isn’t the only thing your CRM remembers about them.

---

# Projects & delivery

Source: https://amolfi.com/docs#platform--projects-and-delivery

A request becomes tracked work the moment it lands: intake, tasks, deliverables, approvals, and timelines all live on the same board.

### One board, start to finish

Nothing has to be copied into a second tool to become real, and nothing disappears in a handoff between tools — because there is no handoff between tools.

- Intake becomes tracked work automatically — no re-entry.
- Tasks, deliverables, approvals, and timelines share one surface.
- Delivery sits beside the client record and the invoice it belongs to.

### Delivery in context

Delivery lives in the same workspace as the client and the invoice, so the work carries its own context — who it’s for, and what it’s worth — instead of floating in a generic project tool that only knows about tasks.

---

# Finance

Source: https://amolfi.com/docs#platform--finance

Amolfi’s books of record are **cash basis by default** — money is recorded when it actually moves, the way most owners already keep score in their head.

### Cash basis by default

Cash-basis books match the way a small team watches cash: income and expenses are recorded when money moves. You do not need to maintain accrual entries or a general ledger inside Amolfi.

- Cash basis by default — recorded when money moves, not when it’s promised.
- One set of books, with no accrual bookkeeping to maintain.
- Bank data via Plaid, so the books match the account.

Bank connections come in through Plaid, so the money that actually landed is grounded in the account it landed in — not a number someone re-typed from a statement.

---

# Cloud

Source: https://amolfi.com/docs#platform--files

Cloud is where every document, contract, receipt, and asset the business keeps lives — one governed home for the whole workspace.

### The Company Brain

The Company Brain renders your whole business as one explorable graph — the same graph your team browses and your AI agents reason over.

### Grounded authoring, not generic drafts

Amolfi’s doc suite is one editor for docs, slides, and sheets. Its AI drafts from the records already in your workspace — the real client, the real deal, the real invoice — instead of a generic model reaching for something that fits.

When it states a number, it pulls it from the record it came from and cites the source so you can click back to it. When it can’t find the record, it says so instead of filling the gap.

### A person still decides

The AI drafts; a person still edits and decides. Grounding gives you sources to check, and you should review the numbers before using the result.

---

# Social media

Source: https://amolfi.com/docs#platform--social-media

Plan and draft posts for your connected social accounts in one place. Write an idea once, and AI drafts per-platform variants from it.

A workspace connects one business — a single social profile, with one account per network inside it. Connecting a different business means disconnecting the current one. Social linking is included on Max, Ultra and Business, and available on Pro as a $49-a-month add-on. One business per workspace: additional brands are not sold.

### Approval before anything posts

Publishing is approval-gated — a draft waits for a person to approve it. Nothing posts on its own.

### Planning the week

A planner view lays the week out, so you can see what’s drafted and what’s scheduled across your accounts at a glance.

---

# Contracts & signing

Source: https://amolfi.com/docs#platform--contracts-and-signing

Prepare a contract from a template, send it for signature, and track its status — all in the same workspace as the client it belongs to.

### From template to signed

1. Prepare the contract from a template.
2. Send it for signature.
3. Track its status alongside the client record.

### Signing

Signers receive a branded email and sign electronically.

---

# How usage works

Source: https://amolfi.com/docs#billing--how-usage-works

Two words that never mix. **Usage** is what the plan gives you: an amount each week, shown as a percentage with the date it resets. **Crowns** are what you buy when you want more than the plan gives, at 400 to the dollar.

### The week

A usage week belongs to your workspace. It starts the first time the workspace runs work after the last week ended and lasts seven days, so it follows how you work rather than a calendar or your billing date. Usage does not carry over: a week you did not use is not banked.

On a team, every member has their own weekly amount by default, inside the workspace’s week, with the workspace total above it. An owner or admin can switch to sharing the workspace’s usage across the team instead.

### What counts as usage

Usage is measured by the work Amolfi actually does for you — AI, meetings, research, communications, document processing, automations, and agent tasks — so you never have to reason about raw model tokens.

### Tracking your usage

Your workspace shows how much of the week’s usage is spent, when it resets, and your Crowns balance beside it with the date the soonest-expiring Crowns run out. The plan’s usage is spent first; Crowns are spent after it, if you have any and the switch is on.

### Storage and downloads

Storage and the downloads included each month are shown beside the usage bar. Those two allocations are still monthly — it is plan usage that is weekly. Past either allocation you pay from your Crowns — 12 Crowns per GB a month for storage, 45 Crowns per GB for downloads — and Amolfi tells you what comes next before you get there rather than stopping you at it.

---

# Running out of usage

Source: https://amolfi.com/docs#billing--running-out-of-usage

Your workspace stays active. What happens next depends on one switch: **Use my Crowns when plan usage runs out**. It is on whenever your Crowns balance is positive, so work carries on and draws from the balance. Turn it off and the plan is a hard stop until the week resets.

### If the balance is empty

Amolfi offers you Crowns before anything refuses. New metered work pauses before provider spend rather than running first and billing afterward.

### What can pause metered work today

Amolfi may pace an unusually heavy burst so that one runaway job cannot spend a shared workspace’s week in an afternoon. Pacing bounds how fast usage is spent, not how much the plan includes.

Your records, completed results, approvals, and billing remain available if a protective limit pauses new metered work.

### If we give you a usage reset

Amolfi sometimes gives a workspace a promotional usage reset — after an incident, or as a goodwill gesture. Using one starts a new usage week straight away, so your usage reads as unused and the next reset moves seven days out. An owner or admin uses it from Settings. A reset expires if it is not used, has no cash value, and changes nothing except your usage week.

### If your plan lapses

Crowns you have bought are held rather than burned, and their 12-month clock stops until you come back. It starts again on your next successful charge.

---

# Annual billing

Source: https://amolfi.com/docs#billing--annual-billing

Annual billing changes what you pay and when, not how Amolfi attributes usage.

### The same usage model

Usage is still weekly, and it still resets on your workspace’s own week rather than on your billing date. What annual changes is the price and the invoice.

### The annual price

Paying annually shows a discounted monthly rate compared to paying month to month, billed as one annual charge.

---

# Upgrading your plan

Source: https://amolfi.com/docs#billing--upgrading-your-plan

If you’re between two plans, start lower. Moving up keeps everything you’ve already set up.

### Change plan in Settings

1. Open **Settings**.
2. Choose **Billing & Usage**.
3. Under **Change plan**, choose Starter, Pro, Max, Ultra or Business.

Upgrades take effect immediately and Stripe invoices the prorated difference. Your records, configuration, and history stay with the workspace.

Self-serve plan changes keep your current billing interval. Moving up applies immediately, re-anchors your billing cycle to that moment, and credits the proration — the confirm screen says so before you agree to it. Moving to a lower plan uses the same Change plan control and takes effect at the end of your current billing period, with no mid-cycle refund and nothing you have set up removed. Changing between monthly and yearly billing, or moving into or out of Enterprise, is handled with the team.

[Open Billing & Usage](https://amolfi.ai/settings?tab=billing)[Contact the team](https://amolfi.com/contact)

---

# How Amolfi protects your data

Source: https://amolfi.com/docs#security--how-amolfi-protects-your-data

Amolfi processes workspace data to provide AI assistance, maintain safety controls, create work receipts, debug errors, and improve product quality. It does not sell personal information or share it for cross-context behavioral advertising. The Privacy Policy describes these uses and your rights.

### Grounded, not generic

The AI is grounded on your own records — that’s what makes an answer about your business instead of a generic one. Your workspace is isolated from every other organization at the database layer, not just in the interface.

### Agents propose, owners approve

Agents propose rather than act: anything that moves money or leaves your workspace waits for a named owner to approve it, and sensitive server actions append to an audit log as they happen.

Service credentials are kept server-side. Access to bank items, billing, audit logs, and signing requests goes through server endpoints that enforce their own checks.

### Isolation

Your workspace is a sealed room. CRM, projects, finance, legal, and marketing run natively inside one boundary — not stitched across six vendors’ clouds. Every read and write is gated by membership at the database layer; deactivate a member and their access ends with them.

### Governed AI

AI with a gate, not a free hand. Agents draft from the records they’re permitted to read; risk tiers and review gates sit before anything a client could see; approved actions leave receipts — sensitive fields stripped first.

### Audit log

If it mattered, it’s in the log. Sensitive server actions append to an audit log as they happen — history is added to, not edited — with redaction at write time.

### Roles and access

Six roles, drawn precisely. From owner to guest, each person sees exactly the work they need — with per-module overrides and item-level guest scoping on top.

[Members & roles](https://amolfi.com/docs/workspace/members-and-roles)

### Server-only secrets

Service credentials stay on the server. Workspace API keys are shown once when you create them; store them securely. Requests for sensitive records go through server endpoints that enforce their own checks.

### Scoped links

One link, one job. Client intake forms, approvals, document signing, booking, creator delivery, and portal views — each link does the one thing it was made for, nothing else.

### Transport and files

Hosting sends HSTS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, and a report-only Content Security Policy on live responses. File download endpoints re-check workspace or conversation access and return short-lived signed URLs.

### Integrations

Connections that prove themselves. Inbound webhooks verify provider signatures or HMAC tokens before anything is processed; outbound OAuth uses single-use, HMAC-bound state. Bank connections run through Plaid Link — credentials are entered with Plaid, never in Amolfi.

### Reporting a vulnerability

Found something? Email security@amolfi.com directly.

### Where to read more

The commitments above are contractual in the privacy policy and the terms:

[Privacy policy](https://amolfi.com/privacy)[Terms of service](https://amolfi.com/terms)

---

# API overview

Source: https://amolfi.com/docs#api

Amolfi has a public API at `https://api.amolfi.com`. It is a door into **your** workspace — the same records, the same permissions, and the same approval gate you see in the app — not a model API you send prompts to.

API keys, the CLI and MCP clients are part of Pro and up. On Starter a key is refused with `402 API_KEYS_NOT_ON_PLAN` before any work runs. The `ultrawork` effort is part of Ultra and Enterprise, and the Moonshot working style is part of Max and Ultra, a Team+ seat, and Enterprise; a plan that names one it does not carry is refused with `402` and the door it opens on, never quietly run at a smaller setting.

### Not a model API

Nothing on this surface is a new data path. Every operation resolves to a tool the product already runs, which already carries a permission, a risk class, and a receipt. A machine caller reaches your business the same way a person clicking in the app does, and it is held to the same rules.

### Two shapes

**Call a governed tool.** Your own agent or script decides what to do and calls one capability — list clients, read invoices, draft a post. You get a result and a receipt.

```
POST /v1/tools/{tool_name}
Authorization: Bearer amolfi_sk_…

{ "…": "the tool's own input" }
```

**Hand over a goal.** You describe an outcome and Amolfi decides how to do it — Amo routes the work to the right specialists, runs it against your real workspace, and files an approval card the moment something needs a human. Your side does no reasoning about \*how\*.

```
POST /v1/runs
{
  "goal": "draft the october email from what actually shipped",
  "working_style": "autonomous",
  "effort": "normal"
}
```

Both shapes use one contract, one permission model, and one approval gate.

### Look before you authenticate

Three routes need no credentials at all, so you can read the contract before you mint anything. These are runnable right now:

```
curl https://api.amolfi.com/v1/health
curl https://api.amolfi.com/v1/scopes
curl https://api.amolfi.com/v1/openapi.json
```

- `/v1/health` — liveness.
- `/v1/scopes` — every scope, the tools behind it, and which roles may be granted it.
- `/v1/openapi.json` — the whole contract as OpenAPI 3.1, generated from the same catalog the API routes from, so the spec cannot drift from the surface.

### What a machine caller cannot do

It cannot send, spend, sign, or publish. Those actions return an approval card instead of a result, and a workspace owner approves them in the app. This is not a setting — the strongest scope available for an outward action is `propose`, and no `send`, `pay`, or `post` scope exists to grant.

### Requests and errors

Requests and responses are JSON. Every response carries `x-amolfi-request-id` — quote it if you ever need to ask about one — and `x-amolfi-api-version`. Errors share one envelope, so you can branch on `code` rather than on prose.

```
{ "error": { "code": "SCOPE_REQUIRED", "message": "…" } }
```

- **401** — the token is missing, invalid, expired, or revoked. Every failure looks identical, so a probe learns nothing.
- **403** — `SCOPE_REQUIRED` when the token lacks the scope, `FORBIDDEN` when the permission check refuses. Nothing ran.
- **404** — `NOT_FOUND`, which also covers anything outside your workspace. That is deliberate: a 403 would confirm the thing exists.
- **409** — an `Idempotency-Key` conflict (see below).

### Retrying safely

Send an `Idempotency-Key` header on anything that writes or proposes. An identical replay returns the stored response and does no new work; the same key with a different body is refused with `IDEMPOTENCY_CONFLICT` rather than quietly doing something else. Keys are remembered for 24 hours.

[Authentication](https://amolfi.com/docs/api/authentication)[Runs](https://amolfi.com/docs/api/runs)[API + CLI](https://amolfi.com/model/api)

```
curl https://api.amolfi.com/v1/tools/finance_list_invoices \
  -H "Authorization: Bearer $AMOLFI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"status":"open","limit":3}'
```

200 OK · example data.invoices

```
[
  {
    "id": "11111111-1111-4111-8111-111111111111",
    "invoice_number": "INV-1042",
    "customer_name": "Acme Studio",
    "currency": "USD",
    "status": "sent",
    "total_cents": 420000,
    "outstanding_cents": 420000
  }
]
```

Illustrative invoice fields. The full result includes status, data.receipt and meta; check meta.truncated.

---

# Authentication

Source: https://amolfi.com/docs#api--authentication

There are two ways to authenticate, and which one you want depends on whether a human is present. Automation carries a workspace token. A person at a terminal signs in through the browser.

### Workspace tokens

A workspace token is minted in the app — **Settings → API keys** — and looks like `amolfi_sk_…`. It is shown **once**, at mint time. Amolfi stores only its hash, so nobody, including Amolfi, can read it back to you later. Lose it and you mint a new one.

The token names its workspace inside itself, so there is no workspace header to set and nothing in a request can widen its reach. One token, one workspace.

```
Authorization: Bearer amolfi_sk_…
```

### A token is a delegation, not a new identity

Every request is checked against the **live** permissions of the member who minted the token, re-resolved on each call. Narrow that person’s access and the token narrows with it on the very next request. Revoke the token, or deactivate the member, and it stops working immediately.

Scopes are the second gate. A token carries scopes from the public catalog, and the effective authority of any call is the intersection of the token’s scopes, the minter’s live permissions, and the tool’s own permission requirement. Read `/v1/scopes` to see the whole table before you mint anything.

There is no verb anywhere on this surface to mint or revoke a key. A token that can mint tokens defeats its own revocation, so key management lives in the app only — even though the events are published (see Webhooks).

### Signing in from a terminal

For a person, pasting a long-lived secret into a shell is the wrong shape. `amolfi login` runs the OAuth 2.1 Device Authorization Grant (RFC 8628) instead: the terminal opens the server-issued authorization page in your default browser, where the existing Amolfi login and 2FA policy apply, and you pick the workspace **there** rather than in the terminal. An existing browser session is reused. Headless, manual, and opener-failure paths print the URL and short code as a fallback.

```
POST /v1/auth/device/code    → device_code, user_code, verification_uri_complete, interval, expires_in

  # open the returned verification_uri_complete, confirm the code, and pick a workspace

POST /v1/auth/device/token   → 428 authorization_pending  (keep polling)
                             → 429 slow_down             (poll slower)
                             → 200 access_token, refresh_token, org_id, scopes
```

Both device routes are **form-encoded** (`application/x-www-form-urlencoded`), as RFC 8628 requires — a JSON body is refused. Poll no faster than the `interval` the server returns, and back off when it says to.

Sign-in returns a short-lived access credential — under an hour — plus a rotating refresh credential. Refreshing consumes the old one; reusing a spent refresh credential revokes the whole grant, because reuse is what a stolen credential looks like. The grant is also bound to the permissions you held when you approved it: change them and the grant closes rather than quietly widening.

The CLI stores these in the operating system’s own credential store — macOS Keychain or Linux Secret Service. If that store is unavailable it fails rather than writing a secret to a file.

### Which one to use

- **Workspace token** — n8n, CI, cron, anything unattended. Export it as `AMOLFI_TOKEN`.
- **Device sign-in** — a person working in a terminal. Run `amolfi login`.
- **Neither** — `/v1/health`, `/v1/scopes`, and `/v1/openapi.json` need no credential at all.

[Open API keys](https://amolfi.ai/settings/api-keys)[The CLI](https://amolfi.com/docs/api/the-cli)

```
curl https://api.amolfi.com/v1/tools/finance_list_invoices \
  -H "Authorization: Bearer $AMOLFI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"status":"open","limit":3}'
```

Response headers

```
Content-Type: application/json
X-Amolfi-Request-Id: <request-id>
X-Amolfi-Api-Version: 2026-08-12
```

Set AMOLFI\_API\_KEY in your server environment. This example requires finance.invoices.read.

---

# API schema

Source: https://amolfi.com/docs#api--discovery

The public OpenAPI document describes available tools, their inputs, responses and authentication requirements. Use it to build an integration against the current contract.

`/v1/openapi.json`GET · public

The machine-readable OpenAPI 3.1 document.

`/v1/scopes`GET · public

Discover scopes, associated tools, actions and roles.

`/v1/health`GET · public

Check that the API is reachable.

These discovery endpoints do not require a key. Authenticated workspace requests belong on your server.

[Open the live schema ](https://api.amolfi.com/v1/openapi.json)

```
curl https://api.amolfi.com/v1/openapi.json
```

200 OK · schema excerpt

```
{
  "openapi": "3.1.0",
  "paths": {
    "/v1/tools/finance_list_invoices": {
      "post": { "operationId": "finance_list_invoices" }
    }
  }
}
```

Excerpt only. The live schema includes request bodies, responses and security requirements.

---

# Read workspace data

Source: https://amolfi.com/docs#api--invoices

Bring workspace records into your internal tools. Call a named tool with its JSON input and receive a structured result.

POST`/v1/tools/finance_list_invoices`

This example fetches up to three open invoices. It requires `finance.invoices.read`.

`status`string · optional

Filter by invoice status. This example uses open.

`limit`integer · optional

Maximum number of invoices to return. This example uses 3.

### Read the result

Invoice records appear in `data.invoices`. Amounts such as `total_cents` use minor currency units. The result also includes a receipt and envelope metadata.

Check `meta.truncated` before treating a result as complete.

```
curl https://api.amolfi.com/v1/tools/finance_list_invoices \
  -H "Authorization: Bearer $AMOLFI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"status":"open","limit":3}'
```

200 OK · example data.invoices

```
[
  {
    "id": "11111111-1111-4111-8111-111111111111",
    "invoice_number": "INV-1042",
    "customer_name": "Acme Studio",
    "currency": "USD",
    "status": "sent",
    "total_cents": 420000,
    "outstanding_cents": 420000
  }
]
```

Illustrative invoice fields. The full result includes status, data.receipt and meta; check meta.truncated.

---

# Runs

Source: https://amolfi.com/docs#api--runs

A run is the second shape: you hand Amolfi a goal instead of a tool call. Amo triages it, delegates to the specialists that own the work, and follows it against your real workspace — the same work you would watch happen in chat.

### Start one

Starting a run returns **202**, never 200. A run is asynchronous by nature, and a run id must never read as finished work.

```
POST /v1/runs
{
  "goal": "draft the october email from what actually shipped",
  "working_style": "autonomous",
  "effort": "normal"
}

202 { "status": "queued", "run_id": "…", "working_style": "autonomous", "effort": "normal" }
```

### Choose how involved to be

- `collaborative` — **Ask**. Amo does the work and pauses only when your judgment would materially improve the result.
- `autonomous` — **Auto**. The default. Amo assumes you may be away, makes reasonable judgment calls, and continues as durable background work.

Working style changes collaboration, not authority. It never changes a tool’s permission, risk class, cost ceiling, or approval requirement. Omit it and the server uses `autonomous`; unknown write values are refused rather than silently mapped.

### Choose the reasoning effort

- `low` — **Fast**. Speed first.
- `normal` — **Normal**. The default for everyday work.
- `high` — **High**. The kernel routes the run through the heavy reasoning model.
- `ultrawork` — **Ultrawork**. The kernel uses its separately configurable Ultrawork route.

Effort is durable run state, not terminal decoration. Start, list, status, and receipts carry it, and each execution iteration uses its model route. Effort never changes permission or approval authority.

### Find durable work

```
GET /v1/runs   → up to 25 recent goal-directed runs, current work first
```

Run history lives on the server, not in one terminal process. The CLI stores only one non-secret selected-run pointer per API origin and workspace so another terminal can use `amolfi runs status` or `amolfi runs watch` without inventing local history.

### Follow it

```
GET  /v1/runs/{run_id}           → status, style, effort, specialists, activity, input or approval
POST /v1/runs/{run_id}/guidance  → steer it, or answer a needs_input checkpoint
POST /v1/runs/{run_id}/cancel    → stop it
```

Poll the run rather than holding a connection open. Each snapshot carries the run’s status, the specialists working on it, and the recent activity lines.

### The status vocabulary

A run reports one of seven statuses. This is a deliberately narrow public vocabulary — the internal lifecycle is richer, and it stays internal so it can change without breaking you.

- `queued` — accepted, not started.
- `working` — in progress.
- `needs_input` — parked on one work question. Send guidance to answer it and wake the same run.
- `pending_approval` — stopped, waiting on a person. Not an error.
- `completed` · `failed` · `cancelled` — terminal.

Activity lines are also a projection, not raw internals: they read as `amo:…`, `specialist:…`, `tool:…`, `approval:…`, or `run:…`. A tool line can carry the hostname it called. Render that as plain text and never as a link — it is influenced by whatever the tool was pointed at.

### When a run needs an owner

`needs_input` and `pending_approval` are intentionally different. Guidance may answer a work question. It may never settle an approval.

A run that reaches something outward — sending, spending, signing, publishing — does not execute it and does not fail. It files an approval card and waits. The run surfaces as `pending_approval` with the decision’s id, and a workspace owner approves or declines in the app.

> Machines propose. Owners approve. A run is a goal, not an authorisation.

There is deliberately **no** approve endpoint. Guidance is guidance — it maps to steering a run that is already yours to steer — and adding an approve verb would be the bypass this whole design exists to prevent, wearing a different noun. The scope vocabulary makes it unrepresentable: `propose` is the ceiling.

### What bounds a run

A run’s reach is bounded by the token’s scopes, not by the goal’s ambition. A goal that needs a capability the token lacks stops with a 403 rather than returning a partial result and calling it done. Running a goal needs `runs.runs.write`; polling one needs `runs.runs.read`.

Subscribe to the `run.*` webhooks if you would rather be told than poll — `run.waiting_approval` is the moment your systems learn a human decision is needed.

[Webhooks](https://amolfi.com/docs/api/webhooks)[Approvals & governance](https://amolfi.com/docs/amo/approvals-and-governance)

```
curl https://api.amolfi.com/v1/runs \
  -H "Authorization: Bearer $AMOLFI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_ID" \
  --data '{"goal":"Draft the October email from what shipped","working_style":"autonomous","effort":"normal"}'
```

202 Accepted · documented response

```
{
  "status": "queued",
  "run_id": "…",
  "working_style": "autonomous",
  "effort": "normal"
}
```

Set REQUEST\_ID to a unique value for a new run. Reuse it only when retrying the same request. Poll the returned run ID for progress.

---

# Files API

Source: https://amolfi.com/docs#api--files

The Files API lets a workspace token read and write the same Cloud the app shows. A workspace’s documents, sheets, decks, and uploads are Artifacts: one record with a type, a revision history, and provenance you can trace. There is no second machine content service.

### Scopes

```
files.artifacts.read     list, read, search, and trace Artifacts and their revisions
files.artifacts.write    create and edit Artifacts, move, archive, restore, refresh, export
files.records.read       read workspace records and the governed Business Brief
files.records.write      record an inert Business Brief edit proposal
```

`files.artifacts.read` is a full workspace-content read credential, like granting a Drive or Dropbox integration access to workspace files. Scope it narrowly and revoke it when the integration no longer needs it.

### Read and edit a document

```
POST /v1/tools/artifact_search   { "query": "pricing model" }
POST /v1/tools/artifact_get      { "artifact_id": "…" }
POST /v1/tools/artifact_apply_operation
POST /v1/tools/artifact_export   { "artifact_id": "…", "format": "pdf" }
```

An edit is an operation against a revision, not a file overwrite, so every change keeps its history and its author. `artifact_export` renders a format — a PDF of a document, a workbook of a sheet — without leaving the record it came from.

Byte transfer is not open to machine tokens yet. A token can list, read, search, create, and edit an Artifact; uploading and downloading raw bytes stays first-party while the public-link rules are settled. Ask us if you need it — the answer is a date, not a workaround.

### Contracts and the security boundary

The Cloud includes user-uploaded contracts. A category label is editable, so using `contracts` as an access-control boundary would not protect anything. Separately managed signed-provider documents remain excluded because they live behind signing-specific tables and actions.

### Uploads and scanning

Anything a person uploads still goes through the same presign, storage, finalize, and malware-scan path the app uses. Only an explicit clean verdict makes content available. Subscribe to `file.available` and `file.held` if your system should be told instead of polling.

[Authentication](https://amolfi.com/docs/api/authentication)[Webhooks](https://amolfi.com/docs/api/webhooks)[The CLI](https://amolfi.com/docs/api/the-cli)

```
curl https://api.amolfi.com/v1/tools/artifact_search \
  -H "Authorization: Bearer $AMOLFI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"query":"pricing model"}'
```

Requires files.artifacts.read. Read the live OpenAPI schema for the current response contract.

---

# Agent sessions

Source: https://amolfi.com/docs#api--sessions

A session is a durable conversation in your workspace. The same sessions you see in the app are readable and startable by a workspace token, so an outside agent works in the conversation rather than beside it.

### Scopes

```
sessions.sessions.read    list sessions, read one, page its events
sessions.sessions.write   start a turn, rename, pin, archive, fork
```

A token acts for the member who minted it. A session your token starts is owned by that person, appears in their rail in the app, and is visible to owners and admins exactly like one they started themselves. A token is not a new member and never becomes one.

### Start a turn and follow it

```
POST /v1/tools/agent_session_turn_start   { "message": "close the books for July" }
  -> { "session_id": "…", "run_id": "…", "seq": "2" }

POST /v1/tools/agent_session_events_list  { "session_id": "…", "after_seq": "2" }
```

Events arrive in ascending sequence with a `next_after_seq` cursor. Poll from the last sequence you stored. A turn started this way is a cloud turn: it keeps running after your process exits, and anything that sends, spends, signs, or publishes still stops at an approval card.

### What a session read withholds

Session events are projected field by field before they leave the workspace, so a read gives you the conversation without becoming a side door into everything the conversation touched.

- Assistant and user text, tool names, run status, and route arrive in full.
- A tool result arrives only when its result policy is `durable_summary`. A private or opaque result arrives as coordinates with `content_withheld`, the same content the API refuses to return if you call that tool directly.
- Reasoning summaries and model protocol state do not cross. They arrive as coordinates with `payload_withheld`.

An event kind that does not have a published projection yet arrives as coordinates rather than as its raw payload. Absence in a payload always means withheld, never empty.

### What has no machine verb

Approvals settle in the app. There is no endpoint that approves a card, and no scope that could be granted to do it.

Local turns are also first-party. A local turn runs a model on your own machine and reports its progress from that client, so a workspace token cannot start one or append to one. Ask for a cloud turn and the workspace runs it for you.

### Use the CLI

```
amolfi sessions                       # the rail, pinned first
amolfi sessions get <session_id>
amolfi sessions events <session_id> --after 12
amolfi sessions start "close the books for July"
amolfi sessions start "and now August" --session <session_id>
amolfi sessions rename <session_id> "July close"
amolfi sessions pin <session_id>
amolfi sessions fork <session_id> 42 --title "What if we delay"
```

Forking copies a session up to a sequence you choose. Both sessions continue independently from there, which is how you try a second approach without losing the first.

[Runs](https://amolfi.com/docs/api/runs)[Authentication](https://amolfi.com/docs/api/authentication)[The CLI](https://amolfi.com/docs/api/the-cli)

### Continue a conversation

The `message` input is required for a new task or follow-up. Include the optional `session_id` to continue an existing conversation; omit it to start a new session.

```
curl https://api.amolfi.com/v1/tools/agent_session_turn_start \
  -H "Authorization: Bearer $AMOLFI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_ID" \
  --data '{"message":"Summarize my open invoices."}'
```

200 OK · example data excerpt

```
{
  "session_id": "11111111-1111-4111-8111-111111111111",
  "run_id": "22222222-2222-4222-8222-222222222222",
  "seq": "1",
  "route": "cloud",
  "replayed": false
}
```

Set REQUEST\_ID to a unique value for each new request. Reuse it only when retrying that same request.

---

# Webhooks

Source: https://amolfi.com/docs#api--webhooks

Register an endpoint in **Settings → Webhooks** and Amolfi POSTs you a signed JSON body when the business moves. Thirty-one events exist, in twelve families, and every one of them fires from real code — registration rejects any name that does not.

### The catalog

```
deal · contact · client · project    created / updated
invoice                             created / paid
contract                            sent / signed / declined / expired
run                                 waiting_approval / completed / failed / cancelled
booking                             created / updated / cancelled
member                              invited / joined / removed
domain                              verified
apikey                              created / revoked
file                                available / held / updated / archived
```

Some absences are deliberate, so you do not sit waiting for them. There is no `invoice.overdue`: overdue is derived at read time from an invoice’s due date and status, so there is no moment to fire on — compute it from the payloads you already get. Imports and backfills never fire events, so nobody floods your endpoint by loading history. And `invoice.paid` fires only on the terminal transition to fully paid, never on a partial payment.

### The envelope

```
{ "event": "invoice.paid", "timestamp": "<ISO-8601>", "data": { "id": "…" } }
```

CRM-family payloads carry the entity’s fields. Every other family is an explicit allow-list projection — thin identity and state, chosen field by field, so internals never leave the workspace by accident.

- **invoice** — numbers, status, currency, amounts, client, dates. No notes, no metadata.
- **contract** — identity and state only. No signer names or emails; fetch detail through the API.
- **run** — id, status, title, summary, and the decision id when one is waiting.
- **booking** — identity and the time window. No attendees, description, or location.
- **member** — ids, status, and role. **No email address, in any form** — not plaintext, not hashed. Resolve identity with an authenticated roster read, where your own permissions apply.
- **domain** — the domain, its purpose, and when it verified.
- **apikey** — the key’s public id and status. **Never the key, its hash, or any prefix bytes.**
- **file** — identity, lifecycle status, content type, byte size, rights state, and scan verdict. Never names, descriptions, tags, content, storage coordinates, or scanner threat names.

### Delivery is at-least-once

Retries ride a queue, and every attempt is ledgered with a dedupe check taken \*before\* the POST, so an acknowledged delivery is not re-sent. Even so, treat your handler as idempotent: dedupe on the `X-Amolfi-Delivery` header for exact retries, and on `(event, data.id)` if your handler must act strictly once per business moment.

### Verifying the signature — read this part carefully

Every delivery carries three headers: `X-Amolfi-Event`, `X-Amolfi-Delivery`, and the signature.

```
X-Amolfi-Signature: sha256=<hex hmac>
```

**The HMAC key is not your raw \`whsec\_…\` secret.** Amolfi never stores that secret — you are shown it once and only its SHA-256 is kept — so the key both sides share is the hex digest of your secret, and that is what you must HMAC with. Every subscriber that skips this step sees valid deliveries as forgeries.

```
signing_key = sha256_hex(raw_whsec_secret)      // the hex digest STRING
expected    = "sha256=" + hmac_sha256_hex(signing_key, raw_request_body)
valid       = timing_safe_equal(expected, X-Amolfi-Signature)
```

In Node:

```
import { createHash, createHmac, timingSafeEqual } from 'node:crypto';

function verify(rawBody, header, whsecSecret) {
  const signingKey = createHash('sha256').update(whsecSecret).digest('hex');
  const expected = `sha256=${createHmac('sha256', signingKey).update(rawBody).digest('hex')}`;
  const a = Buffer.from(expected);
  const b = Buffer.from(header || '');
  return a.length === b.length && timingSafeEqual(a, b);
}
```

Three rules that go with it: HMAC the **raw request bytes**, not an object you re-serialized — re-serializing changes them. Always compare in constant time. And reject anything unsigned or mis-signed; a delivery that fails this check is not from Amolfi.

Your secret is shown once when you add the endpoint, the same way an API key is. Store it where you store other secrets.

[Open Webhooks](https://amolfi.ai/settings/webhooks)

Inspect existing subscriptions with `admin_webhooks_list` and the `workspace.webhooks.read` scope.

```
curl https://api.amolfi.com/v1/tools/admin_webhooks_list \
  -H "Authorization: Bearer $AMOLFI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{}'
```

Incoming delivery · illustrative event

```
{
  "event": "invoice.paid",
  "timestamp": "2026-09-22T12:00:00.000Z",
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "invoice_number": "INV-1042",
    "status": "paid",
    "currency": "USD",
    "total_cents": 420000,
    "paid_cents": 420000
  }
}
```

The delivery above arrives at your registered endpoint; it is not the response to the subscriptions request.

---

# Errors & retries

Source: https://amolfi.com/docs#api--errors

Use HTTP status and the JSON error code to decide what to do next. Save `X-Amolfi-Request-Id` when investigating a failed request.

`401`unauthorized

Check whether the key is missing, invalid, expired or revoked.

`403`forbidden

Check the required scope and the member’s workspace permissions.

`404`not found

The resource is unavailable in this workspace.

`409`conflict

An idempotency key was reused for a different request.

`429`throttled

Retry with exponential backoff and jitter.

### Retry without repeating a write

Send an `Idempotency-Key` on write and proposal requests. Reuse the same key and request body when retrying; matching requests replay the stored result for 24 hours.

Handle throttling with backoff. There are no rate-limit remaining or reset headers to rely on.

```
curl https://api.amolfi.com/v1/tools/finance_list_invoices \
  -H "Authorization: Bearer $AMOLFI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"status":"open","limit":3}'
```

403 · example error

```
{
  "error": {
    "code": "SCOPE_REQUIRED",
    "message": "Required scope: finance.invoices.read"
  }
}
```

Illustrative error message. Branch on the error code, and retain the request ID for troubleshooting.

---

# CLI

Source: https://amolfi.com/docs#api--cli

The Amolfi CLI is the terminal client of the API. It reads your workspace, hands Amo goals, and follows runs. Anything that sends, spends, signs, publishes, or otherwise needs an owner still stops for approval.

The CLI is part of Pro and up: signing in mints an API key, and API keys start at Pro. `--effort ultrawork` is part of Ultra and Enterprise.

```
npm install -g @amolfi/cli
```

It needs Node 20 or newer and has no runtime dependencies. It is proprietary software, licensed for use with the Amolfi service.

### Sign in

```
amolfi login             # opens the dedicated browser authorization page
amolfi login --manual    # print the fallback URL and one-time code
amolfi logout            # clear the stored credential
```

The credential lives in your operating system’s credential store, never in a dotfile. For unattended use — CI, cron, a scheduler — skip sign-in and export a workspace token instead:

```
export AMOLFI_TOKEN=amolfi_sk_…       # minted in Settings → API keys
export AMOLFI_API_URL=https://…       # optional; defaults to https://api.amolfi.com
```

### The verbs

```
amolfi health                          # liveness — no credential needed
amolfi scopes                          # the public scope catalog

amolfi team                            # roster and roles — who can approve
amolfi webhooks                        # registered endpoints
amolfi audit 50                        # the workspace audit log

amolfi sessions                        # the session rail, pinned first
amolfi sessions start "close the books for July"
amolfi sessions events <session_id> --after 12
amolfi sessions fork <session_id> 42 --title "What if we delay"

amolfi ask "draft the october email from what actually shipped"   # Auto + Normal
amolfi ask --style collaborative "shape the launch with me"      # Ask
amolfi ask --effort ultrawork "audit the launch and finish it"
amolfi runs                            # recent durable work, current first
amolfi runs start --style collaborative --effort high "<goal>"
amolfi runs select <run_id>            # share the selection across terminals
amolfi runs status                     # inspect the selected run
amolfi runs watch [run_id]             # follow selected or explicit work
amolfi runs guidance <run_id> "shorter, warmer"
amolfi runs cancel [run_id]
amolfi runs clear
```

Add `--json` to any read for the raw payload. `ask` is the everyday verb and starts an Auto run at Normal effort by default. In the interactive shell, Shift+Tab or `/style` opens **Ask** and **Auto**; `/effort` opens **Fast**, **Normal**, **High**, and **Ultrawork**. Auto returns the run id and lets Amo continue in the background; Ask follows the run and pauses only when your judgment would materially improve the result. The shell session is only the terminal view; working style and effort remain durable server-side state and can be read from another terminal.

Each read needs its catalog scope: for example, `team` needs `workspace.team.read`, while run discovery and status need `runs.runs.read`. A missing scope returns `SCOPE_REQUIRED` rather than an empty result that looks like an empty workspace.

### What the CLI deliberately cannot do

There is no verb to mint or revoke a key, invite or change a member, or connect a provider — and no approve verb. A pending approval prints the exact approval URL and **never opens a browser**; you go and read the card yourself. The scope that would let a terminal approve does not exist, which is the design, not a gap.

### Exit codes

- `0` — fine, **including a run that is waiting on an owner**. Waiting is the designed outcome, not a failure.
- `1` — an API or network error.
- `2` — a usage or configuration mistake.

Scripting against it? Branch on the exit code, and use `--json` rather than parsing the human output — the wire shape is the contract, the printed text is not.

[Authentication](https://amolfi.com/docs/api/authentication)[Runs](https://amolfi.com/docs/api/runs)

```
npm install -g @amolfi/cli

amolfi login
amolfi health
amolfi scopes
```

Node.js 20 or later. Follow the device sign-in instructions shown by amolfi login.

---

# Privacy Policy

Source: https://amolfi.com/docs#privacy

v1.5 · Effective September 21, 2026

This Privacy Policy explains how Amolfi, Inc. collects, uses, shares, retains, and protects information when you use the website, public pages, app, integrations, AI features, and support channels.

## 1. Information we collect

Amolfi collects information directly from you, automatically through your use of the platform, and from third parties when you or your workspace authorize an integration.

### 1.1 Account, authentication, and profile information

When you create or use an Amolfi account, we collect information such as name, email address, authentication identifiers, sign-in provider details, organization membership, role, profile settings, and workspace preferences. Authentication currently uses Firebase Authentication and may support Google Sign-In or other sign-in methods.

### 1.2 Workspace and operations data

We collect the information you and your users create, import, sync, upload, or receive in a workspace. This can include clients, contacts, leads, projects, tasks, forms, intake responses, finance records, quotes, invoices, budgets, retainers, receipts, connected-account metadata, knowledge documents, files, approvals, contracts, calendar records, email records, social planning data, automations, AI conversations, audit logs, and public client-surface submissions.

### 1.3 AI prompts, outputs, and tool context

When you use AI-assisted features, Amolfi may process prompts, outputs, workspace context, selected records, tool results, citations, review decisions, and related metadata. AI features may use providers such as Anthropic, OpenAI, or AWS AI services depending on the feature. We process this information to provide AI assistance, maintain safety controls, create work receipts, debug errors, and improve product quality.

### 1.4 Financial and bank data through Plaid

When you connect a bank or financial account through Plaid, Amolfi receives the information you authorize Plaid to share for the enabled financial workflows. Depending on the connection and feature, this may include institution metadata, account names, masked account numbers, account type, balances, transactions, transaction metadata, connection status, and consent or revocation records. Amolfi does not receive or store your bank login credentials.

### 1.5 Payment, billing, and metered-usage data

We use Stripe for Amolfi's own subscription billing, for members and add-ons, and for Crown purchases. You enter card details on Stripe's own pages, not Amolfi's, and Amolfi never receives or stores a full card number or CVV code. Amolfi may receive billing contact details, customer identifiers, subscription status, invoice metadata, payment status, plan information, tax information, card brand, and last four digits. Amolfi does not currently provide Stripe Connect or process payments on invoices issued from customer workspaces.

Stripe also gives Amolfi a fingerprint of the card — an identifier that stands for the card without being the card number. Amolfi uses it for one purpose only: stopping the same card from taking repeated trials or from working around purchase limits. For the same purpose, and no other, Amolfi derives a normalized form of your email address so that one trial and one pre-purchase workspace can be counted per person. Neither is used for marketing, profiling, or advertising.

Amolfi records the metered usage a workspace is billed on: the work it runs, how much storage it holds, and the size of the files you download or share, which is counted against your plan's monthly download amount. Plan usage itself is measured in a weekly window, and Amolfi records when that window started for your workspace. Metering records the size, time, and workspace of a transfer, not the contents of the file.

Where Amolfi gives a workspace a promotional usage reset, it keeps a record of it as part of the billing history: which workspace it was for, who gave it and who used it, the reason written with it, when it expires, and whether it was used, revoked or left to expire. A reset addressed to a workspace is addressed by the owner's email address or by the workspace's identifier, and the reason is written by Amolfi rather than collected from you.

### 1.6 Optional integrations

If your workspace uses an available third-party connection, we process the information required for that workflow. Currently available workflows use Plaid for bank connections, BoldSign for document signing, and Ayrshare with supported social platforms for social publishing. QuickBooks and Xero are supported through manual CSV exports rather than live connected accounts. Other services process workspace data only when a specific connection is enabled for your workspace, and availability may change as integrations are added or retired.

### 1.7 Website, device, and usage information

We collect technical and usage information such as IP address, browser type, device type, operating system, approximate region, referring page, pages and features used, timestamps, event logs, error reports, performance information, and security signals. We use this information to operate, secure, debug, measure, and improve Amolfi.

### 1.8 Communications and support

If you contact Amolfi, submit a form, request support, join a waitlist, schedule a call, respond to an email, or otherwise communicate with us, we collect your contact details and the content of that communication. If you opt into product or marketing updates, we retain the information needed to send and manage those communications until you unsubscribe or request deletion.

### 1.9 Text messaging

When you opt in to the Amolfi text messaging program, we use your mobile number to send phone verification codes, customer-care replies, and workspace messages you request. Message frequency varies. Message and data rates may apply. Consent to text messaging is optional and is not a condition of purchase. Reply **HELP** for help or **STOP** to opt out. You can also contact [support@amolfi.com](mailto:support@amolfi.com) for help.

Mobile information and opt-in consent are not shared with third parties or affiliates for marketing or promotional purposes. Service providers may process this information only to deliver and support the messaging service.

## 2. How we use information

Amolfi uses information for the purposes below.

- **Provide the service.** Create and manage accounts, operate workspaces, display and sync records, run workflows, deliver AI assistance, process files, support public links, send transactional messages, and connect authorized third-party services.
- **Secure Amolfi.** Authenticate users, enforce permissions, maintain audit logs, detect suspicious activity, prevent abuse, protect tenant boundaries, and investigate security incidents.
- **Support customers.** Respond to questions, debug problems, manage onboarding, troubleshoot integrations, and communicate about service, billing, security, or product changes.
- **Process Amolfi billing and subscriptions.** Manage Amolfi plan charges, subscription invoices, renewals, tax, account status, failed payments, refunds, and billing communications.
- **Improve the platform.** Measure feature use, diagnose errors, evaluate performance, develop new features, and improve reliability. We may use aggregated or de-identified information for product and business analysis.
- **Comply with law and enforce agreements.** Meet tax, accounting, security, privacy, payment, abuse-prevention, and legal obligations, respond to lawful requests, and enforce Amolfi agreements.

### What we do not do

- We do not sell personal information.
- We do not share personal information for cross-context behavioral advertising.
- We do not use third-party advertising trackers on Amolfi's product surfaces.
- We do not use workspace data to advertise to your clients or end customers.

## 3. Plaid and financial connections

Amolfi integrates with [Plaid Inc.](https://plaid.com/legal/end-user-privacy-policy) to support customer-authorized financial connections.

### 3.1 How the connection works

When you choose to connect a financial account, Amolfi presents Plaid Link, which is operated by Plaid. You enter credentials into Plaid's interface, not Amolfi. Plaid returns a scoped token to Amolfi after a successful authorization, and Amolfi stores sensitive Plaid tokens server-side.

### 3.2 What Amolfi receives

Amolfi receives only the data authorized through the Plaid consent flow and required for the enabled financial features. This may include institution details, account metadata, masked account identifiers, balances, transactions, transaction descriptions, dates, categories, and connection status. We do not receive full bank account credentials or bank login passwords.

### 3.3 Consent, revocation, and audit records

Amolfi records consent and revocation events for security, audit, and support purposes. Workspace members with finance management permission can revoke a Plaid connection under Finance › Accounts & import. When a connection is revoked, Amolfi calls Plaid's removal endpoint where applicable, deletes the stored access token, and marks the connection and its linked accounts revoked so no further data is retrieved through that connection. Financial records already imported into your workspace ledger remain workspace business records; you can request their deletion using the contact route in this policy.

### 3.4 Plaid's privacy practices

Plaid separately processes information you provide directly to Plaid. Plaid's privacy practices are described in Plaid's End User Privacy Policy at [plaid.com/legal/end-user-privacy-policy](https://plaid.com/legal/end-user-privacy-policy).

## 4. Service providers and how we share information

Amolfi shares information with service providers only as needed to operate, secure, support, and improve the platform, or when you authorize an integration. We also may disclose information where required by law, to enforce agreements, to protect rights or safety, or as part of a corporate transaction.

| Provider | Purpose | Typical information processed |
| --- | --- | --- |
| Amazon Web Services | Primary application data platform, database, compute, eventing, real-time services, storage, logging, and security infrastructure. | Workspace data, operational records, financial records, files, logs, and service metadata. |
| Google Cloud and Firebase | Authentication, hosting, identity sync, signed browser-to-backend bridge, selected legacy functions, and operational logging. | Account identifiers, authentication metadata, hosting logs, bridge metadata, and selected public or legacy records. |
| Anthropic | AI assistant, analysis, drafting, tool-use, computer-use, and vision-enabled workflows where enabled. | Prompts, selected workspace context, uploaded or referenced content, outputs, and AI metadata. |
| OpenAI | AI transcription or other AI processing features where enabled. | Audio, text, prompts, outputs, and related metadata for the specific feature used. |
| Stripe | Amolfi subscription billing, renewals, taxes, and related payment and account status. | Billing contact details, customer identifiers, invoice and subscription metadata, payment status, and limited card metadata. |
| Plaid | Bank and financial-account connection flow. | Financial account metadata, balances, transactions, consent records, revocation status, and Plaid connection metadata. |
| SendGrid or email providers | Transactional email, operational email, email ingestion, and customer-enabled email workflows. | Email addresses, message metadata, message content, delivery events, unsubscribe records, and suppression records. |
| BoldSign | Document signing and template preparation where enabled. | Signer details, document metadata, documents, signing status, and signature-event metadata. |
| Ayrshare and social platforms | Social account connection, scheduling, publishing, analytics, and related workflows where enabled. | Connected social account metadata, scheduled content, media, publish status, analytics, and webhook events. |
| Google Workspace | Internal Amolfi email, identity, and support operations. | Business contact information and support communications. |

Optional integrations process information only when you or your workspace enable them. If you connect a third-party service, that third party's own terms and privacy policy also apply.

We do not sell personal information, and we do not share personal information for cross-context behavioral advertising as those terms are commonly used under California privacy law.

## 5. Data retention and deletion

We keep information only as long as needed for the purposes described in this Policy, unless a longer period is required or permitted by law, security, audit, billing, backup, tax, dispute, or abuse-prevention needs.

- **Workspace and account data** is generally retained while the workspace or account is active. Closing a workspace does not itself schedule automatic deletion from primary systems. To request deletion of a closed workspace, contact [security@amolfi.com](mailto:security@amolfi.com). We verify identity and workspace authority, determine the scope of the request, and process it subject to applicable legal, security, audit, billing, tax, dispute, backup, and contractual retention requirements.
- **Stored files in a workspace with no plan** are deleted automatically. A workspace that has had no active paid plan for 90 consecutive days has its stored files deleted, and a workspace that never bought a plan becomes read-only 30 days after it is created and has its stored files deleted 90 days after it is created. Billing records, receipts, and audit records are retained on the separate schedules in this section. The [Terms of Service](https://amolfi.com/terms) state the same two clocks.
- **Plaid-sourced consumer financial data** stops being retrieved after authorization is revoked and the stored access token is deleted. Financial records already imported into your workspace ledger remain workspace business records and are handled through the same verified deletion-request process described above.
- **Plaid consent, revocation, and security audit records** may be retained for up to 7 years where needed for legal, audit, security, or compliance purposes.
- **Application audit logs** may be retained for up to 7 years where needed for security, abuse prevention, compliance, or internal review.
- **Operational logs** in Amolfi's production AWS application data spine are configured for six months. Logs held by other providers may follow their applicable operational schedules, and logs may be retained longer when required for incident response, investigation, security, or law.
- **Backups** rotate on operational schedules. Deletion from backups may lag primary-system deletion until the relevant backup expires.
- **Marketing communications data** is retained until you unsubscribe or request deletion, except for suppression records needed to honor opt-outs.

To request deletion, export, correction, or access, contact [security@amolfi.com](mailto:security@amolfi.com). We may need to verify your identity or workspace authority before acting on a request.

## 6. Your privacy rights

Depending on where you live and how you use Amolfi, you may have rights to request access to your information, correction, deletion, portability, restriction, objection, withdrawal of consent, or more information about how personal information is collected, used, retained, disclosed, or shared.

California residents may have rights under the CCPA/CPRA, including the rights to know, delete, correct, opt out of sale or sharing, limit certain uses of sensitive personal information, and non-discrimination for exercising privacy rights. Amolfi does not sell personal information or share it for cross-context behavioral advertising.

Individuals in the European Economic Area, United Kingdom, or similar jurisdictions may have rights under applicable data-protection laws, including access, correction, deletion, portability, restriction, objection, and complaint rights with a supervisory authority. Where Amolfi relies on consent, you may withdraw that consent at any time.

To make a request, email [security@amolfi.com](mailto:security@amolfi.com). We will verify and respond within the timeline required by applicable law. If your information is controlled by a customer workspace, we may direct the request to that customer or assist the customer in responding.

## 7. Security

Amolfi uses administrative, technical, and organizational safeguards designed to protect customer data. Controls include workspace membership checks, role-based access, server-side action handlers, signed bridge requests, encrypted storage where supported by infrastructure providers, secret management, audit logs, least-privilege access patterns, rate limits, and review gates for higher-risk AI and automation workflows.

No online service can guarantee perfect security. You are responsible for protecting credentials, using appropriate access controls, reviewing workspace membership, managing connected services, and notifying us promptly about suspected compromise.

Report security or privacy concerns to [security@amolfi.com](mailto:security@amolfi.com).

## 8. Cookies and tracking

Amolfi uses cookies, local storage, and similar technologies for authentication, session management, security, preferences, product functionality, and basic site performance. We do not use third-party advertising trackers on Amolfi product surfaces.

Your browser may let you block or delete cookies. Some Amolfi functionality may not work correctly without authentication or session cookies.

## 9. Children

Amolfi is a business operations platform and is not directed to children under 16. We do not knowingly collect personal information from children under 16. If you believe a child has provided personal information to Amolfi, contact [security@amolfi.com](mailto:security@amolfi.com).

## 10. International data transfers

Amolfi is based in the United States, and information may be processed in the United States and other countries where Amolfi or its service providers operate. Those countries may have data-protection laws that differ from the laws where you live. Where required, Amolfi uses appropriate transfer safeguards.

## 11. Changes to this policy

We may update this Privacy Policy as Amolfi, our vendors, or legal requirements change. When we make material changes, we will update the effective date and provide notice where required or appropriate. The version and date above identify the current public policy.

## 12. Contact us

For privacy, deletion, export, access, correction, or security requests, contact:

[security@amolfi.com](mailto:security@amolfi.com)[support@amolfi.com](mailto:support@amolfi.com)

If your request relates to a workspace controlled by an Amolfi customer, include enough information for us to identify the relevant workspace and account.

---

# Terms of Service

Source: https://amolfi.com/docs#terms

v1.4 · Effective September 21, 2026

These Terms of Service govern access to Amolfi, Inc.'s business operations platform, including workspaces, client records, projects, finance tools, knowledge, integrations, automations, and AI-assisted features.

## 1. Agreement to these Terms

These Terms of Service ("Terms") are a legal agreement between Amolfi, Inc. ("Amolfi," "we," "us," or "our") and the person, company, organization, or other legal entity accessing or using Amolfi ("Customer," "you," or "your"). By creating an account, using a workspace, connecting an integration, submitting data, or otherwise using Amolfi, you agree to these Terms.

If you use Amolfi on behalf of a company or other organization, you represent that you are authorized to accept these Terms on that organization's behalf. In that case, "you" and "your" refer to that organization.

If a signed order form, design-partner agreement, data processing agreement, or other written agreement between you and Amolfi says that a different term applies, the signed written agreement controls for that customer and that conflict only.

## 2. Who may use Amolfi

Amolfi is intended for business use. You must be at least 18 years old and legally able to enter into these Terms. You agree to provide accurate account, billing, and workspace information and to keep that information current.

You are responsible for keeping login credentials, devices, and authentication methods secure. Notify Amolfi promptly if you believe an account, workspace, integration, or credential has been compromised.

## 3. Workspaces, admins, and users

Amolfi workspaces are controlled by workspace owners and administrators. Administrators may invite users, assign roles, connect third-party services, configure public links, manage billing, export data, and remove access.

You are responsible for the acts and omissions of users you invite into your workspace and for ensuring that each user has only the access they should have. You are also responsible for configuring roles, permissions, and connected services in a way that matches your own business obligations.

If ownership of a workspace is disputed, Amolfi may rely on available account, billing, domain, and administrator records to decide who controls the workspace, or may suspend administrative changes until the dispute is resolved.

## 4. Workspace content and data

### 4.1 You own your workspace content

"Workspace Content" means the information, records, files, prompts, messages, client details, project data, financial data, knowledge materials, automations, forms, public-link submissions, and other content that you or your users submit to Amolfi.

As between you and Amolfi, you own your Workspace Content. You grant Amolfi a limited, non-exclusive, worldwide license to host, store, copy, display, transmit, process, and otherwise use Workspace Content only as needed to provide, secure, support, maintain, and improve Amolfi and related services.

### 4.2 Your responsibilities

- You are responsible for the accuracy, legality, and quality of your Workspace Content.
- You must have the rights, permissions, and notices required to submit Workspace Content to Amolfi and to connect any third-party service.
- You are responsible for deciding whether Amolfi is appropriate for information subject to specialized laws or contractual obligations that apply to your business.
- You must not submit secrets, credentials, regulated records, or highly sensitive information unless the relevant Amolfi feature is designed for that use and you have configured it correctly.

### 4.3 Data handling

Amolfi handles Workspace Content as described in our [Privacy Policy](https://amolfi.com/privacy). The Privacy Policy explains what information we collect, how we use it, what service providers process it for us, how bank connections through Plaid work, and how to request access, export, correction, or deletion.

## 5. AI, automation, and outputs

Amolfi includes AI-assisted and automated features that may summarize records, draft communications, prepare recommendations, route work, flag risks, generate artifacts, or help users operate across their workspace.

- AI outputs may be incomplete, inaccurate, outdated, or unsuitable for your specific business context.
- You are responsible for reviewing AI outputs before relying on them or sending them to clients, vendors, employees, regulators, or the public.
- AI and automation features are tools for assistance. They do not replace professional, legal, tax, accounting, financial, HR, compliance, or other expert advice.
- You are responsible for the instructions, approvals, integrations, and workspace data that influence AI and automation behavior.
- Amolfi may apply safety systems, usage limits, review gates, rate limits, and abuse-prevention controls to AI and automated workflows.

You may not use Amolfi's AI or automation features to generate unlawful content, impersonate others, mislead recipients, make decisions that require a human review by law without that review, bypass third-party platform rules, or automate abusive activity.

## 6. Acceptable use

You agree not to misuse Amolfi or help anyone else do so. Prohibited conduct includes:

- Using Amolfi for unlawful, fraudulent, deceptive, harmful, harassing, discriminatory, or exploitative activity.
- Sending spam, unsolicited bulk messages, malware, phishing attempts, or misleading communications.
- Uploading or distributing content that infringes intellectual property, privacy, publicity, or other rights.
- Attempting to probe, scan, bypass, disable, or compromise Amolfi's security, authentication, rate limits, audit systems, or tenant boundaries.
- Reverse engineering, scraping, copying, reselling, or using Amolfi to build a competing service except where law allows that activity despite this restriction.
- Using Amolfi in a way that overloads infrastructure, degrades service for other customers, or evades plan limits.
- Connecting third-party accounts, payment processors, calendars, inboxes, social accounts, or financial accounts without authority.

Amolfi may investigate suspected violations and may suspend or restrict accounts, workspaces, integrations, public links, automations, or AI features when needed to protect customers, third parties, or the platform.

## 7. Third-party services and integrations

Third-party services used with currently available Amolfi workflows include Plaid for bank linking, BoldSign for document signing, and Ayrshare with supported social platforms for social publishing. QuickBooks and Xero are supported through manual CSV exports rather than live accounting-system connections. Stripe processes charges for Amolfi subscriptions, add-ons, members and Crown purchases; Amolfi does not currently provide Stripe Connect or payment processing for invoices issued from customer workspaces. Additional email, calendar, collaboration, webhook, or other integrations apply only if and when Amolfi makes a specific connection available to your workspace.

Where a connection is available, it is optional and must be authorized by a workspace member with the required permission. Amolfi may add, change, or retire integrations over time.

When you connect a third-party service, you authorize Amolfi to access, receive, process, store, and transmit information from that service as needed to provide the integration. Third-party services are governed by their own terms and privacy policies. Amolfi is not responsible for third-party services, their data practices, their availability, or changes they make to their APIs or rules.

You are responsible for having the rights and consents required to connect each third-party account and for complying with the rules of those third-party services. Amolfi may disable or limit an integration if it creates security, legal, platform, abuse, or operational risk.

### Text messaging

When you opt in to the Amolfi text messaging program, we use your mobile number to send phone verification codes, customer-care replies, and workspace messages you request. Message frequency varies. Message and data rates may apply. Consent to text messaging is optional and is not a condition of purchase. Reply **HELP** for help or **STOP** to opt out. You can also contact [support@amolfi.com](mailto:support@amolfi.com) for help.

Mobile information and opt-in consent are not shared with third parties or affiliates for marketing or promotional purposes. Service providers may process this information only to deliver and support the messaging service. Carriers are not liable for delayed or undelivered messages.

## 8. Plans, fees, billing, and taxes

### 8.1 The plans

Amolfi is sold as five plans — Starter, Pro, Max, Ultra and Business — and as Enterprise, which is quoted and contracted rather than bought on the website. What each plan costs and what it includes are shown on the pricing page and restated on the checkout screen before you pay; the storage and downloading each plan includes are set out in §11.3. Unless a written agreement says otherwise, a plan renews automatically until it is cancelled and is billed through Stripe or another payment processor Amolfi designates.

### 8.2 Monthly or yearly

Every plan is sold monthly or yearly. A yearly plan is billed up front, as one payment for the year, and the amount it saves against twelve monthly payments is shown at checkout before you pay. A monthly plan renews monthly and a yearly plan renews yearly, each on the date you bought it.

### 8.3 Members and add-ons

Business is priced by the person. Each member of a Business workspace holds one seat: a Team seat, which carries the Pro plan's usage and computer for that person, at $100 a person a month, or $85 a person a month on a yearly plan; or a Team+ seat, which carries the Max plan's usage and computer for that person, at $250 a person a month, or $210 a person a month on a yearly plan. A Business workspace holds at least two seats, in any mix. A seat added part-way through a period is charged for the remainder of that period.

Social linking is included on Max, Ultra and Business, and is available on Pro as a $49 a month add-on. It links the workspace's own business accounts: one business per workspace. Because it consumes capacity Amolfi buys from its publishing provider, it is only sold when that capacity is available; otherwise the request is refused or waitlisted rather than charged. Additional brands are not sold; that option was withdrawn on 23 September 2026.

### 8.4 Changing plans

An upgrade takes effect immediately, and the days you have already paid for on the plan you are leaving are credited against the new one. The confirmation screen shows that credit and the amount you will be charged before you accept it. A downgrade takes effect at the end of the period you have already paid for, so you keep what you bought until it runs out.

### 8.5 Payments, failures, and refunds

- You authorize Amolfi and its payment processor to charge your payment method for plan fees, members, add-ons, Crown purchases, metered usage, renewals, and applicable taxes.
- A subscription period that has already started is not refunded, except where the law requires otherwise or a written agreement with Amolfi says otherwise. Cancelling stops the next renewal; it does not refund the period you are in.
- If a payment fails, Amolfi may retry the charge, ask for updated payment information, restrict features, suspend service, or end access after notice where that is practical.
- A chargeback or dispute on a plan payment suspends metered work in the workspace until the dispute is resolved. Your records, results, approvals and billing history stay available while it is open.
- Plan names, features, usage amounts, storage, limits, add-on prices and support levels may change going forward. A price change on a plan you are already on applies from your next renewal, not part-way through a period.

### 8.6 Taxes

Prices are shown without tax. Where sales tax, VAT, GST or a similar tax applies to your purchase, it is calculated at checkout and added to the amount charged. You are responsible for taxes, duties, and similar assessments other than taxes based on Amolfi's net income.

## 9. Crowns

Amolfi meters two things, and they are not the same. Your plan gives you an amount of usage each week, described in §11. Crowns are what you buy when you want more than the plan gives, or to pay for storage and downloading past what the plan includes.

Crowns are sold at 400 Crowns for every dollar, in fixed packs or as an amount you choose, and are credited to the workspace's Crowns balance rather than to a person. A workspace can buy Crowns once it has settled its first plan invoice. Purchase limits apply per workspace, per card and per verified identity, and rise as an account establishes a payment history; the limits are applied both when a purchase starts and when it settles.

- Crowns bought on the web are good for 12 months from the date of purchase. Where Amolfi offers Crowns through the App Store, Crowns bought that way do not expire. Spending draws on the balance that expires soonest first, and the receipt prints the date.
- Crowns can be spent while the workspace is on an active paid plan. If a plan lapses, the balance is held rather than lost and the 12-month clock stops; it becomes spendable again, with the same time left on it, on the next successful plan payment.
- A Crown purchase can be refunded while the Crowns it bought are unspent, for the amount paid. Crowns that have been spent are not refundable.
- If a purchase is refunded, reversed or disputed, the Crowns it bought are removed. That can leave a balance below zero, which stops further spending from Crowns; it never removes your access to your workspace or your records.
- Crowns are a unit of metered work, not money. They are not a deposit, cannot be moved between workspaces, cannot be cashed out, and have no value outside Amolfi.

Whether a workspace spends its Crowns once the plan's usage for the week is gone is a setting its owner controls. Turn it off and the plan's weekly amount is where metered work stops until the week resets; your records, results, approvals and billing stay available either way.

## 10. Trials, and workspaces without a plan

### 10.1 The Starter trial

Amolfi offers a 14-day trial on the Starter plan. A payment card is required to start one, and one trial is available per card and per verified identity.

A single usage cap applies for the whole trial rather than a weekly amount, and it is smaller than what the plan gives. Bank linking is limited to one connection during a trial, and publishing to social accounts and sending documents for signature are off.

When the 14 days end, the plan begins and the card is charged, unless you cancel before then; Amolfi emails a reminder before that first charge. You can also choose to start your plan straight away, which settles the first invoice immediately and ends the trial at that point.

### 10.2 A workspace that has not bought a plan

A workspace can be created and looked at before anything is bought. It carries a one-time allowance of usage rather than a weekly one, one member, a small amount of storage, and no outward sending. One such workspace is available per person; to create another, put a plan on the first one or accept an invitation to somebody else's workspace.

A workspace that has not bought a plan becomes read-only 30 days after it is created, and its stored files are deleted 90 days after it is created.

Any workspace that has had no active paid plan for 90 consecutive days has its stored files deleted. This is stated here because it is automatic rather than discretionary. Billing records, receipts and audit records are retained separately, as described in the [Privacy Policy](https://amolfi.com/privacy).

## 11. Usage, fair use, and beta features

### 11.1 What your plan gives you

Your plan's usage is a weekly amount. A usage week belongs to your workspace: it starts the first time the workspace runs metered work after the previous week ended, and it lasts seven days — so it follows when you work rather than a calendar or your billing date. Usage does not carry over: an amount you did not use in a week is not banked, not refunded and not added to the next week. The product shows how much of it you have used and when it resets.

On a plan with more than one member, each member has their own weekly amount inside the workspace's week and the workspace has a total above it. An owner or admin can choose to share the workspace's usage across the team instead, in which case the workspace total is the only limit. Usage is never moved between people or between workspaces.

Amolfi may pace unusually heavy bursts, so that one runaway job cannot spend a shared workspace's week in an afternoon. Pacing bounds how fast usage is spent, not how much the plan includes.

### 11.2 Promotional usage resets

Amolfi may give a workspace a promotional usage reset — after an incident, as a goodwill gesture, or as an announcement to every eligible workspace. Using one starts a new usage week for the workspace straight away: the plan's usage reads as unused, and the next reset moves to seven days later. An owner or admin uses it, and it applies to the workspace rather than to a person.

- A promotional usage reset is a grant, not a purchase. It has no cash value, is not Crowns and not a balance, is not refundable, and cannot be sold, transferred or exchanged for money or for Crowns.
- It expires on the date shown with it. An unused reset is not banked past that date, and nothing carries over from it.
- Amolfi may revoke a promotional usage reset that has not been used, and may decline to apply one to a workspace with an unpaid, held or disputed charge, or to a workspace in a trial or without a plan.
- It changes your usage week and nothing else: not your plan, not your Crowns balance, not your storage or downloading allowances, and not your bill.
- Promotional usage resets are offered at Amolfi's discretion. Nothing in these Terms promises one, and using one does not entitle a workspace to another.

### 11.3 Storage and downloading

Each plan includes an amount of storage, and an amount of downloading and sharing each month: Starter 10 GB of storage and 20 GB of downloading a month; Pro 100 GB of storage and 100 GB of downloading a month; Max 250 GB of storage and 100 GB of downloading a month; Ultra 250 GB of storage and 100 GB of downloading a month; Business 250 GB of storage and 100 GB of downloading a month. Past the included storage, a workspace pays 12 Crowns per GB a month from its Crowns balance. Past the included downloading, it pays 45 Crowns per GB. Both are charged as their own lines on the work receipt, and the current rates are shown in the product beside the meter before anything is charged.

Storage past the allocation is charged rather than blocked. Uploads are refused only well above it, at five times the plan's storage allocation, which is an abuse control rather than a price.

### 11.4 Fair use

Amolfi may apply fair-use limits to storage, file processing, usage, automation runs, public links, webhooks, API calls, connected accounts, members, and other shared resources, and applies a monthly count limit to publishing as an abuse control rather than a price. We may throttle, queue, restrict, or ask for a plan change if usage materially exceeds reasonable levels for the plan, threatens service reliability, or creates unexpected cost or security risk.

### 11.5 Beta features

Amolfi may offer preview, beta, experimental, research, labs, or early-access features. These features may change, be limited, produce errors, or be discontinued at any time. They may be subject to extra usage limits, eligibility requirements, review gates, or separate written terms.

## 12. Security and availability

Amolfi maintains administrative, technical, and organizational safeguards designed to protect the service and customer data. Security is shared: you are responsible for configuring roles, protecting credentials, reviewing access, managing connected services, and promptly reporting suspected compromise.

We work to keep Amolfi available, but no service is uninterrupted or error-free. Planned maintenance, urgent security work, vendor outages, internet failures, cloud-provider incidents, third-party API changes, and events outside Amolfi's reasonable control may affect availability. Public status information is informational unless a separate written agreement states a service-level commitment.

## 13. Suspension and termination

You may stop using Amolfi or cancel a paid plan according to the plan, account, or written agreement that applies to you. Cancellation does not relieve you of fees already incurred.

Amolfi may suspend or terminate access to all or part of the service if we reasonably believe that you or your users violated these Terms, created security or legal risk, failed to pay amounts due, used the service abusively, or caused harm to Amolfi, customers, third parties, or infrastructure.

After termination or workspace closure, Amolfi may retain, export, delete, or archive data according to the Privacy Policy, applicable law, security needs, billing obligations, backup schedules, and any written agreement with you.

## 14. Deleting your account

You can delete your Amolfi account from inside the product on every client Amolfi ships — the web app, the Mac app and the iPhone app. Deletion asks you to type a confirmation, and then runs after a 30-day window in which you can reverse it by signing back in. After that window the account and the personal data attached to it are deleted, subject to the retention that law, security, billing, tax, audit and backup schedules require, as described in the [Privacy Policy](https://amolfi.com/privacy).

Deleting an account is not the same as closing a workspace, and it does not by itself cancel a plan or delete a workspace's business records. If you own a workspace that other people use, hand ownership to another member or close the workspace as well; §10.2 and the Privacy Policy describe what happens to a workspace's stored files after that.

## 15. Amolfi intellectual property

Amolfi and its licensors own the service, software, interface, documentation, visual design, workflows, templates, systems, models of interaction, brand assets, trademarks, and other intellectual property in Amolfi, except for Workspace Content and third-party materials.

These Terms do not grant you ownership of Amolfi intellectual property. You may use Amolfi only as permitted by these Terms and any written agreement with us.

If you send Amolfi feedback, ideas, requests, or suggestions, you grant Amolfi a perpetual, irrevocable, worldwide, royalty-free license to use them without restriction or compensation, provided we do not publicly identify you as the source without permission.

## 16. Disclaimers and limitation of liability

To the maximum extent permitted by law, Amolfi is provided "as is" and "as available." We disclaim all warranties, whether express, implied, statutory, or otherwise, including warranties of merchantability, fitness for a particular purpose, title, non-infringement, uninterrupted operation, accuracy, and error-free performance.

To the maximum extent permitted by law, Amolfi will not be liable for indirect, incidental, special, consequential, exemplary, punitive, or lost-profit damages, or for loss of revenue, goodwill, data, business opportunity, or business interruption, even if we knew such damages were possible.

To the maximum extent permitted by law, Amolfi's total liability for all claims related to the service or these Terms will not exceed the greater of (a) the amount you paid Amolfi for the service giving rise to the claim in the 12 months before the event giving rise to liability, or (b) 100 US dollars if you have not paid Amolfi for the service.

Some jurisdictions do not allow certain limitations. In those jurisdictions, the limitations apply only to the maximum extent permitted by law.

## 17. Changes, disputes, and contact

### 17.1 Changes

Amolfi may update these Terms from time to time. When we make material changes, we will update the effective date and provide notice where required or appropriate. Continued use of Amolfi after updated Terms take effect means you accept the updated Terms.

### 17.2 Governing law and venue

These Terms are governed by the laws of the State of Delaware, without regard to conflict-of-laws rules. Unless a written agreement says otherwise, disputes relating to these Terms or Amolfi will be resolved in the state or federal courts located in Delaware, and each party consents to those courts' jurisdiction and venue.

### 17.3 Contact

For questions about these Terms, paid agreements, account ownership, or contract requests, contact [support@amolfi.com](mailto:support@amolfi.com). For security or privacy matters, contact [security@amolfi.com](mailto:security@amolfi.com).
