Create a note | Ara Documentation

_{Scope: run}

Authentication

AuthorizationBearer

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path parameters

orgIdstringRequired

Organization id or slug. Resolve it with GET /v3/self.

Request

This endpoint expects an object.

namestringRequired

bodystringRequired

triggerstringOptional

scopestringOptional

repo_filterstringOptional

Response

Created.

note_idstring

namestring

triggerstring

When the agent should consult this note.

bodystring

scopestring or null

repo_filterstring or null

created_atdatetime

updated_atdatetime

Errors

400

Bad Request Error

$	curl -X POST https://api.ara.so/v3/organizations/orgId/knowledge/notes \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Deploy process",
>	"body": "Run `bun run release` and wait for the green check before merging.",
>	"trigger": "When deploying to production"
>	}'

1	{
2	"note_id": "string",
3	"name": "string",
4	"trigger": "string",
5	"body": "string",
6	"scope": "string",
7	"repo_filter": "string",
8	"created_at": "2024-01-15T09:30:00Z",
9	"updated_at": "2024-01-15T09:30:00Z"
10	}