Create Knowledge

curl -X POST https://api.islo.dev/knowledge \
     -H "Authorization: Bearer <api_key>" \
     -H "Content-Type: application/json" \
     -d '{
  "slug": "machine-learning-basics",
  "level": "declarative",
  "body": "Machine learning is a subset of artificial intelligence that focuses on building systems that learn from data to improve their performance on tasks without being explicitly programmed."
}'

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "slug": "machine-learning-basics",
  "level": "declarative",
  "format": "markdown",
  "body": "Machine learning is a subset of artificial intelligence that focuses on building systems that learn from data to improve their performance on tasks without being explicitly programmed.",
  "metadata": {},
  "status": "active",
  "links": [
    {
      "link_type": "repository",
      "value": "https://github.com/example/ml-intro"
    }
  ],
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

slugstringRequiredformat: "^[a-z0-9][a-z0-9\-]*$"1-255 characters

Unique lowercase identifier (letters, digits, hyphens). Set at creation and cannot be changed.

levelenumRequired

bodystringRequired>=1 character

formatstringOptional<=32 charactersDefaults to markdown

metadatamap from strings to anyOptional

linkslist of objectsOptional

Response

Successful Response

idstringformat: "uuid"

slugstringformat: "^[a-z0-9][a-z0-9\-]*$"1-255 characters

Unique lowercase identifier (letters, digits, hyphens). Set at creation and cannot be changed.

levelenum

formatstring

bodystring

metadatamap from strings to any

statusenum

linkslist of objects

created_atdatetime

updated_atdatetime

Errors

422

Unprocessable Entity Error