immaerpBy IMMA Technologies

API of this draft

There is no public base URL. A call uses the host serving this draft. Opening this panel does not create a token.

A session is the imma_session cookie or an Authorization Bearer session token. Agent bearer tokens are refused on customer and inventory writes. Health checks need no session.

The organization comes from the session. An organization id sent by the client is ignored.

A cookie session that writes must send the header x-imma-request with the value 1. A bearer session does not use that header. GET does not require it.

GET customers needs customers.read. POST customers needs customers.write. POST inventory needs inventory.adjust, held only by owner and admin. Library routes need a session. Agent capabilities need an agent token and return scopes only.

POST /api/v1/inventory repeats a count when the same idempotencyKey and the same content are sent again. A reused key with different content returns 409. Customer creation has no idempotency key.

Recovery allows 3 requests an hour for an address and does not say if it exists. Agent jobs stop at 30 an hour for that token. Other mounted routes have no HTTP rate limit.

One mounted route receives callbacks: the Stripe billing webhook. It accepts only events whose signature verifies over the raw body; every other callback is rejected.

Issuing a service token and revoking one require an authenticated owner or admin and stay inside that organization. This header does not issue, show, or revoke a token. Rotation is not implemented.

POST /api/v1/agent/jobs is mounted for an agent token with jobs.write. The example bearer is synthetic and is not a live key. This panel does not create a token.

GET /api/health · Database check. No session. No connection string.
GET /api/v1/health · Database check and disabled flags. No session.
GET /api/v1/openapi · Machine document. Incomplete. See the gap above.
GET /api/v1/customers · Lists customers of the session organization.
POST /api/v1/customers · Creates a customer. Fields code and name. organizationId in the body is ignored.
POST /api/v1/inventory · Count adjustment. Fields warehouseId, productId, countedQty, date, idempotencyKey. Example values below are synthetic.
GET /api/v1/library/search · Query q. Offline library. Not an operative statute.
GET /api/v1/library/citation · Query q and optional locale. A miss returns the error code.
GET /api/v1/library/coverage · Coverage counts. Not a legal clearance.
GET /api/v1/agent/capabilities · Returns the scopes of the calling agent token. It does not mint one.
GET /api/v1/agent/jobs · Enqueue a local job for an agent token with jobs.write. Quota is 30 an hour. A session token is refused.
POST /api/v1/agent/jobs · Enqueue a local job for an agent token with jobs.write. Quota is 30 an hour. A session token is refused.
POST /api/knowledge/upload · Uploads a document to your company's knowledge board. Session required.
GET /api/knowledge/[id] · Downloads the original file of a knowledge document of your company. Session required.
POST /api/billing/checkout · Opens a Stripe Checkout session for the organization plan. Session and billing.manage; without the owner keys it answers not connected.
POST /api/billing/portal · Opens the Stripe customer portal for the organization. Session and billing.manage.
POST /api/billing/webhook · Receives Stripe billing events. No session: the signature over the raw body decides, and a duplicate is answered without reprocessing.

Synthetic example. Not a live credential.

SYNTHETIC
Authorization: Bearer imma_sess_EXAMPLE
x-imma-request: 1
{"code":"C-EXAMPLE","name":"Example","organizationId":"ignored"}
{"warehouseId":"00000000-0000-0000-0000-000000000000","productId":"00000000-0000-0000-0000-000000000000","countedQty":"1","date":"2026-11-08","idempotencyKey":"example-count-1"}

imma erp

By IMMA Technologies

Your whole company, one system.

imma erp runs sales, purchasing, inventory, manufacturing, assets, banking and accounting periods in 14 languages — with Ask IMMA, a built-in assistant that answers from your own company's data.

Sign in Explore the legal library

0
languages: 0
Modules: 0
official texts in the legal library

Live dashboards, charts and maps

DEMO · example data

imma erp

Sales$42.6K+23%

Purchasing$24.9K+16%

Banks$86.4K+24%

SalesPurchasing

Banks

Activity map

Product view. The figures are sample data.

Every area of the company, in modules

01HomeGuided setup and your company at a glance

02SalesQuotes, orders, invoices and payments

03PurchasingPurchase orders, receipts and supplier bills

04InventoryStock, warehouses and movements

05ManufacturingProduction orders and materials

06AssetsFixed assets and depreciation

07BanksAccounts, statement imports and reconciliation

08PeriodsAccounting periods, closing and reopening

09AgencyClient projects and publishing

10AgentsAPI agents, tokens and automated jobs

11LibraryOfficial legal texts and coverage

12SecurityAccess, sessions and incidents

13AdministrationOrganization, users and roles

Ask IMMA

Ask IMMA, built in

Ask questions about the system and your company's work, and get answers in your working language. Ask IMMA comes on automatically with IMMA's platform account, and connecting your own model provider is optional.