Frequently asked questions

A credit is one API operation. Writing a memory costs one credit. Reading a memory costs one credit. Searching memories costs one credit. Checking your balance and creating namespaces are free.

You receive 100 free credits when you register. Top up whenever you need more.

No. Credits you purchase never expire. Use them at whatever pace your project demands.

Any request that costs a credit returns a 402 status with the message "Insufficient credits". Your stored memories are safe and remain intact. Top up at any time to resume.

Use GET /credits to check your balance from inside your agent. It never costs a credit to check.

No. AgentRAM is a plain HTTP API. Any language or framework that can make a web request works. No SDK, no library, no configuration file.

All of them. AgentRAM uses plain HTTP with JSON. If your agent can make a web request, it works with AgentRAM. This includes all orchestration tools, custom agents, and any language with an HTTP library.

Any text up to 5,000 characters per value. User preferences, conversation context, task state, instructions, summaries, or any plain text your agent needs to remember. Values are stored exactly as written.

The value is updated in place. No duplicate is created. This is the default behaviour for all writes, which keeps memory clean without any management on your side.

When writing a memory, include an optional ttl_days field with the number of days until it should expire. After that point, any read of that key returns 404 and the memory is excluded from lists and searches. No background job or cleanup code is needed on your side.

Memories without a TTL never expire unless you delete them manually.

Yes. Use GET /memories?agent_id=your_agent to retrieve all stored memories as plain JSON. You can paginate through them with the limit parameter and store the output wherever you need.

Standard memory is scoped to one agent ID. Shared memory lives in a namespace that multiple agents can all read from and write to.

Use it when you have a team of agents that need to coordinate — for example a researcher agent, a writer agent, and a reviewer agent that all need to share the same context pool. Create a namespace once, share the namespace_key with each agent, and they can all access the same memory space.

No. Credits are deducted only on success. If a request fails for any reason including a memory not found, a server error, or a namespace that does not exist, the credit is returned to your balance automatically.

A one-time payment of $249 that gives you 500,000 operations immediately and a 20% discount on every credit top-up you ever make, for as long as your account is active.

The discount is a percentage of the standard rate at the time of each top-up. If standard prices rise, your saving grows in real terms. If we restructure pricing, founding members receive 45 days notice before any change applies to their account. The fee is non-refundable.

Only if you explicitly say yes during the application. There is a clear toggle in the founding member form — off by default. If you leave it off, your name will never appear anywhere on the site.

If you consent and later change your mind, email hello@agentram.dev and we will remove you immediately.

The form before payment is how we get to know who we are building for. It takes about 30 seconds. We ask your name, email, what you are building (optional), and whether you would like to be listed publicly.

Your email on the form must match the email you register your API account with after payment. That is how the 500,000 operations and 20% discount get linked to your account automatically.