Create an enterprise-level note | Devin API Documentation

curl -X POST https://api.devin.ai/v3/enterprise/knowledge/notes \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "body": "This note provides detailed guidelines on enterprise data security protocols.",
  "name": "Enterprise Data Security Guidelines",
  "trigger": "data-security"
}'

{
  "access_type": "enterprise",
  "body": "This note provides detailed guidelines on enterprise data security protocols.",
  "created_at": 1685606400,
  "folder_id": "folder_98765",
  "folder_path": "/Enterprise/Policies/Security",
  "is_enabled": true,
  "macro": "SEC_POLICY_2024",
  "name": "Enterprise Data Security Guidelines",
  "note_id": "note_1234567890",
  "org_id": "org_54321",
  "pinned_repo": "enterprise-security-docs",
  "trigger": "data-security",
  "updated_at": 1685692800
}

Authentication

AuthorizationBearer

Personal API Key (apk_user_) or Service API Key (apk_)

Request

This endpoint expects an object.

bodystringRequired

namestringRequired

triggerstringRequired

pinned_repostring or nullOptional

Response

Successful Response

access_typeenum

Scope of the note: org or enterprise.

Allowed values:

bodystring

Markdown body content of the note.

created_atinteger

ISO 8601 timestamp when the note was created.

folder_idstring or null

ID of the folder containing this note.

folder_pathstring

Full path of the folder containing this note.

is_enabledboolean

Whether the note is active and will be injected into sessions.

macrostring or null

Shortcut macro for quick reference.

namestring

Display name of the knowledge note.

note_idstring

Unique identifier for the knowledge note (prefix note-).

org_idstring or null

Organization that owns this note (prefix org-).

pinned_repostring or null

Repository this note is pinned to, if any.

triggerstring

Describes when this note is automatically injected into sessions.

updated_atinteger

ISO 8601 timestamp of the last update.

Errors

422

Unprocessable Entity Error