Knowledge Base

Get all knowledge bases.

GEThttps://api.usepylon.com/knowledge-bases

Response

200

Body

application/json

dataarray of KnowledgeBase (object)

The data payload of the response.

errorsarray of string

The list of errors, if any.

paginationPagination (object)

request_idstring

The request ID for tracking.

Request

JavaScriptCurlPython

const response = await fetch('https://api.usepylon.com/knowledge-bases', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": "text",
      "slug": "text",
      "title": "text"
    }
  ],
  "errors": [
    "text"
  ],
  "pagination": {
    "cursor": "text",
    "has_next_page": false
  },
  "request_id": "text"
}

Get a knowledge base by its ID.

GEThttps://api.usepylon.com/knowledge-bases/{id}

Path parameters

id*string

The ID of the knowledge base.

Response

200

Body

application/json

dataKnowledgeBase (object)

errorsarray of string

The list of errors, if any.

paginationPagination (object)

request_idstring

The request ID for tracking.

Request

JavaScriptCurlPython

const response = await fetch('https://api.usepylon.com/knowledge-bases/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": {
    "id": "text",
    "slug": "text",
    "title": "text"
  },
  "errors": [
    "text"
  ],
  "pagination": {
    "cursor": "text",
    "has_next_page": false
  },
  "request_id": "text"
}

Create a new article.

POSThttps://api.usepylon.com/knowledge-bases/{id}/articles

Path parameters

id*string

The ID of the knowledge base the article is being added to.

Body

application/json

author_user_id*string

The ID of the user attributed as the author of the article.

body_html*string

The HTML body of the article.

collection_idstring

The id of the collection associated to the article

is_publishedboolean

Whether the article should be published. Defaults to false.

is_unlistedboolean

Whether the article can only be accessible only via direct link. Defaults to false.

slugstring

The slug of the article. Defaults to a slug based on the title.

title*string

The title of the article.

visibility_configVisibilityConfig (object)

Response

200

Body

application/json

dataArticle (object)

errorsarray of string

The list of errors, if any.

paginationPagination (object)

request_idstring

The request ID for tracking.

Request

JavaScriptCurlPython

const response = await fetch('https://api.usepylon.com/knowledge-bases/{id}/articles', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "author_user_id": "text",
      "body_html": "text",
      "title": "text"
    }),
});
const data = await response.json();

Response

200

{
  "data": {
    "id": "text",
    "identifier": "text",
    "slug": "text",
    "title": "text"
  },
  "errors": [
    "text"
  ],
  "pagination": {
    "cursor": "text",
    "has_next_page": false
  },
  "request_id": "text"
}

Create a new collection.

POSThttps://api.usepylon.com/knowledge-bases/{id}/collections

Path parameters

id*string

The ID of the knowledge base the article is being added to.

Body

application/json

descriptionstring

Description of the collection.

parent_collection_idstring

The id of the collection associated to the article

slugstring

The slug of the collection. Defaults to a slug based on the title.

title*string

The title of the collection.

Response

200

Body

application/json

dataCollection (object)

errorsarray of string

The list of errors, if any.

paginationPagination (object)

request_idstring

The request ID for tracking.

Request

JavaScriptCurlPython

const response = await fetch('https://api.usepylon.com/knowledge-bases/{id}/collections', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "title": "text"
    }),
});
const data = await response.json();

Response

200

{
  "data": {
    "created_at": "text",
    "description": "text",
    "id": "text",
    "parent_collection_id": "text",
    "slug": "text",
    "title": "text"
  },
  "errors": [
    "text"
  ],
  "pagination": {
    "cursor": "text",
    "has_next_page": false
  },
  "request_id": "text"
}

Create a new route redirect.

POSThttps://api.usepylon.com/knowledge-bases/{id}/route-redirects

Path parameters

id*string

The ID of the knowledge base the route redirect is being added to.

Body

application/json

from_path*string

The path to redirect from.

object_id*string

The ID of the object to redirect to.

object_type*string

The type of the object to redirect to. This must be "article".

Response

200

Body

application/json

dataRouteRedirect (object)

errorsarray of string

The list of errors, if any.

paginationPagination (object)

request_idstring

The request ID for tracking.

Request

JavaScriptCurlPython

const response = await fetch('https://api.usepylon.com/knowledge-bases/{id}/route-redirects', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "from_path": "text",
      "object_id": "text",
      "object_type": "text"
    }),
});
const data = await response.json();

Response

200

{
  "data": {
    "created_at": "text",
    "from_path": "text",
    "id": "text",
    "object_id": "text",
    "object_type": "text"
  },
  "errors": [
    "text"
  ],
  "pagination": {
    "cursor": "text",
    "has_next_page": false
  },
  "request_id": "text"
}