> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-beta.getzep.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-beta.getzep.com/_mcp/server.

# Add Custom Instructions

POST https://api.getzep.com/api/v2/custom-instructions
Content-Type: application/json

Adds new custom instructions for graphs without removing existing ones. If user_ids or graph_ids is empty, adds to project-wide default instructions.

Reference: https://docs-beta.getzep.com/sdk-reference/graph/custom-instructions/add-custom-instructions

## Request

### Body (application/json)

This endpoint expects an apidata.AddCustomInstructionsRequest.

- `instructions` (list of apidata.CustomInstruction, required) — Instructions to add to the graph.
- `graph_ids` (list of string, optional) — Graph IDs to add the instructions to. If empty, the instructions are added to the project-wide default.
- `user_ids` (list of string, optional) — User IDs to add the instructions to. If empty, the instructions are added to the project-wide default.

## Response

### 200

Instructions added successfully

- `message` (string, optional)

## Errors

### 400 Bad Request Error

Bad Request

- `message` (string, optional)

### 404 Not Found Error

Not Found

- `message` (string, optional)

### 500 Internal Server Error

Internal Server Error

- `message` (string, optional)

## Types

### apidata.CustomInstruction

- `name` (string, required)
- `text` (string, required)

## Examples

**Request**

```json
{
  "instructions": [
    {
      "name": "Data Privacy Guidelines",
      "text": "Ensure all user data is anonymized before processing and never store sensitive information without encryption."
    }
  ]
}
```

**Response**

```json
{
  "message": "Custom instructions added successfully to the project-wide defaults."
}
```