roasOS
API referenceMemory

Pin a fact

Teach the agent one confirmed fact about this brand. Pin confirmed facts only, never speculation — the agent treats a pin as true. A category holds fifty pins; the oldest is dropped when the fifty-first arrives, and the marketing brief is never dropped that way. Free, and there is no quote.

POST
/v1/memory/pins

Teach the agent one confirmed fact about this brand.

Pin confirmed facts only, never speculation — the agent treats a pin as true. A category holds fifty pins; the oldest is dropped when the fifty-first arrives, and the marketing brief is never dropped that way.

Free, and there is no quote.

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/memory/pins" \  -H "Content-Type: application/json" \  -d '{    "category": "brand_voice",    "content": "string"  }'
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "category": "brand_voice",    "content": "string",    "metadata": {      "property1": null,      "property2": null    },    "created_at": "2019-08-24T14:15:22Z"  }}