Create knowledge entry

POST

https://api.devin.ai/v1/knowledge

POST

/v1/knowledge

curl -X POST https://api.devin.ai/v1/knowledge \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "body": "This knowledge entry explains the process for onboarding new employees, including required documentation and training schedules.",
  "name": "Employee Onboarding Process",
  "trigger_description": "Triggered when a new employee joins the organization."
}'

{
  "body": "This knowledge entry explains the process for onboarding new employees, including required documentation and training schedules.",
  "created_at": "2024-01-15T09:30:00Z",
  "id": "knowledge_9876543210",
  "name": "Employee Onboarding Process",
  "trigger_description": "Triggered when a new employee joins the organization.",
  "created_by": {
    "full_name": "Jane Doe",
    "id": "user_1234567890",
    "image_url": "https://example.com/images/jane_doe.png"
  },
  "macro": "onboarding_macro_v1",
  "parent_folder_id": "folder_1122334455",
  "pinned_repo": "employee-handbook"
}

Create a new knowledge entry for the organization.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

bodystringRequired

namestringRequired

trigger_descriptionstringRequired

macrostring or nullOptional

parent_folder_idstring or nullOptional

pinned_repostring or nullOptional

Response

Successful Response

bodystring

created_atdatetime

idstring

namestring

trigger_descriptionstring

created_byobject or nullOptional

Information about who created a knowledge entry.

macrostring or nullOptional

parent_folder_idstring or nullOptional

pinned_repostring or nullOptional

Errors

422

Unprocessable Entity Error