> For the complete documentation index, see [llms.txt](https://docs.aios.foundation/aios-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aios.foundation/aios-docs/aios-agent-sdk/memory-api/create_memory.md).

# create\_memory

Create Memory

**Function**: `create_memory()`\
**Purpose**: Store new memory with optional metadata\
**Parameters**:

* `agent_name`: Namespace identifier (required)
* `content`: Memory text (required)
* `metadata`: Optional key-value pairs (tags, priority, etc.)
* `base_url`: API endpoint (default: configured kernel URL)

**Example**:

```python
metadata = {
    "tags": ["project-planning", "urgent"],
    "context": "Q4 strategy meeting"
}
response = create_memory(
    agent_name="project_bot",
    content="Decided to accelerate feature rollout timeline by 2 weeks",
    metadata=metadata
)
```

**Response Structure** (MemoryResponse):

```json
{
    "success": true,
    "memory_id": "mem_abc123",
    "content": null,
    "metadata": null,
    "error": null
}
```