Skip to navigation

Create Knowledge

Authentication

AuthorizationBearer

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

Headers

X-Islo-Api-VersionstringRequired

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.

bodystringOptional>=0 charactersDefaults to
Text knowledge content. Upload image, video, audio, and HTML files through the multipart upload endpoint.
discoverablebooleanOptionalDefaults to true
Whether the item appears in lists, search, and tag suggestions. Hidden items remain accessible by identifier with the same permissions.
formatstringOptional<=32 charactersDefaults to markdown
levelenum or nullOptional
metadatamap from strings to anyOptional
typeenum or nullOptional

Response

Successful Response
bodystring

Text content; empty for image, video, audio, and HTML resources. Use the content endpoint for files.

created_atdatetime
formatstring
idstringformat: "uuid"
levelenum
metadatamap from strings to any
slugstringformat: "^[a-z0-9][a-z0-9\-]*$"1-255 characters

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

statusenum
Allowed values:
typeenum
updated_atdatetime
byte_sizeinteger or nullOptional
discoverablebooleanOptionalDefaults to true
Whether the item appears in lists, search, and tag suggestions. Hidden items remain accessible by identifier with the same permissions.
version_idstring or nullOptionalformat: "uuid"
version_numberinteger or nullOptional

Errors

422
Unprocessable Entity Error