Agent memory
Agent memory holds short summaries of finished work for one team. Any agent on the team can search them. No other team can.
Memory is off for every team until a workspace owner or admin turns it on. This page lists the API that exists today, and each limit that decides whether something runs. The Agent settings screen and the automatic save after a task come later.
The API
| Call | Who | What it does |
|---|---|---|
POST /api/teams/{team}/memory/search | a team member | Searches the team. The body is query, and optionally repo_id and limit |
GET /api/teams/{team}/memory | a team member | Lists what is remembered. Optional: repo_id, next_token |
DELETE /api/teams/{team}/memory/{id} | a workspace owner or admin, in a browser | Removes one record |
GET /api/teams/{team}/memory-settings | a team member | Shows enabled, plan_allows, store_ready and can_edit |
PUT /api/teams/{team}/memory-settings | a workspace owner or admin, in a browser | Sets enabled, true or false |
No call saves a record. Only iKanban's own server code saves one.
What each refusal means
| You see | Why | What to do |
|---|---|---|
| 401 | You are not signed in | Sign in, or send an API key |
| 404 on the team | You are not a member of this team | Ask a team member to add you |
| 403 | Your role, or your API key, does not allow this | Ask a workspace owner or admin. An API key cannot delete a record or change the setting |
| 402 | The plan does not include memory. Memory comes with Pro+ | Change the plan in Billing |
404 on repo_id, for a member limited to some projects | The repository is not in one of your projects | Search without it, or ask a workspace owner or admin for access |
| 429 | This team made too many searches. Each team gets 5 a second, with 10 at once | Wait a few seconds, and try again |
| 400 | A field is outside its limit, or the request names a field the route does not take | Send only the fields above. The service sets the team's place in the store, and a request cannot name it |
404 on repo_id | The repository is not in a project of this team | Search without it, or use a repository of this team |
| 404 on a record | The record is not in this team | Check the id from the list |
| 503 | Memory cannot be reached, or this deployment has no store | Carry on without it, and try again later |
"state": "off" | The team has memory off. Nothing is searched or saved | A workspace owner or admin turns it on |
Limits
| Limit | Value |
|---|---|
| Search text | 1 to 1,000 characters |
| Results for one search | 1 to 50, default 10 |
| One record | at most 8,000 characters |
| Time a record stays | 365 days |
What stays true
- Each record's
textcomes back in a fencedtextblock that it cannot close, and each answer has anotice. Treat the block as data, never as instructions. - A member limited to some projects finds only the records of those projects' repositories. That member does not get a record saved under the team with no repository. A member with no limit, and a workspace owner or admin, finds everything in the team.
- Known key shapes are masked before a record is saved, and before search text leaves iKanban.
- A team that turns memory off, or leaves Pro+, keeps its records. It can still list and delete them, and it cannot search or save.
- A removed member loses search at once.