niyra_memories + niyra_remember — memory access

niyramemories + niyraremember

Niyra runs a personal vector memory store, populated automatically from every conversation. These two tools let your code read from it and add to it.

niyramemories — search

| Method | Path | Auth | Scope |
| ------ | ---- | ---- | ----- |
| POST   | /v1/public/memories | Bearer token | niyra:memories:read |

Request

| Field | Type | Required | Notes |
| ----- | ---- | -------- | ----- |
| query | string | yes | Free-text search query. Embedded server-side. |
| limit | int | no | Max results, 1..50. Default 10. |

Response

Results are ordered by cosine similarity, descending. Anything below 0.5 similarity is usually noise.

niyraremember — add

| Method | Path | Auth | Scope |
| ------ | ---- | ---- | ----- |
| POST   | /v1/public/remember | Bearer token | niyra:memories:write |

Request

| Field | Type | Required | Notes |
| ----- | ---- | -------- | ----- |
| content | string | yes | The memory text. 5..2000 chars. |
| sourcehint | string | no | Optional context — surfaces in the memory's source field. |

Response

Code examples

curl

Python

Errors

| Status | Code | Meaning |
| ------ | ---- | ------- |
| 400 | invalidrequest | Missing query / content, or content out of length bounds |
| 401 | invalidtoken | Token revoked/expired/unknown |
| 403 | insufficientscope | Token lacks the relevant memory scope |
| 429 | ratelimitexceeded | Per-token budget exhausted |

Related

- niyraask — questions Niyra answers using these memories
- Scope catalog
- Rate limits