Get knowledgebase document details

GET

/api/v1/knowledgebase_document/{knowledgebase_document_id}

const url = 'https://app.prefactorai.com/api/v1/knowledgebase_document/013xrzp12g3nqk8ns6jadrqmpgrjkeny';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.prefactorai.com/api/v1/knowledgebase_document/013xrzp12g3nqk8ns6jadrqmpgrjkeny \
  --header 'Authorization: Bearer <token>'

Authorizations

authorization

Parameters

Path Parameters

knowledgebase_document_id

required

KnowledgebaseDocument_Id

A valid knowledgebase document ID

string

Example

013xrzp12g3nqk8ns6jadrqmpgrjkeny

Query Parameters

idempotency_key

One of:

string
Null

Optional idempotency key for ensuring request idempotency

string

Responses

200

Success

application/json

object

details

required

KnowledgebaseDocument_Details

Full details of a knowledgebase document

object

content

required

Document content from the latest revision. Empty content is allowed

string

content_sha256

required

SHA-256 of the content, as lowercase hex

string

content_type

required

MIME type of the document

string

Allowed values: text/markdown text/plain application/json application/yaml text/csv

required

KnowledgebaseDocument_Id

A valid knowledgebase document ID

string

knowledgebase_id

required

Knowledgebase_Id

A valid knowledgebase ID

string

latest_revision_id

required

KnowledgebaseDocumentRevision_Id

A valid knowledgebase document revision ID

string

latest_revision_number

required

Revision number of the latest document revision

integer

>= 1

path

required

Document path, relative, with segments separated by /

string

size_bytes

required

Size of the content in bytes

integer

status

required

Whether this document is active or archived

string

Allowed values: active archived

type

required

Type of resource (always ‘knowledgebase_document’)

string

Allowed values: knowledgebase_document

status

required

Response status when the query succeeds

string

Allowed values: success

Example

{
  "details": {
    "content": "# Setup",
    "content_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "content_type": "text/markdown",
    "id": "013xrzp12g3nqk8ns6jadrqmpgrjkeny",
    "knowledgebase_id": "013xrzp12g3nqk8ns6jadrqmpgrjkeny",
    "latest_revision_id": "013xrzp12g3nqk8ns6jadrqmpgrjkeny",
    "latest_revision_number": 1,
    "path": "guides/setup.md",
    "size_bytes": 128,
    "status": "active",
    "type": "knowledgebase_document"
  },
  "status": "success"
}

default

Error

application/json

One of:

object

code

required

string

Allowed values: bad_request bad_authtoken not_authenticated not_permitted not_implemented unknown not_found unexpected_ref_type unexpected invalid_action invalid_state alert_unknown alert_already_cleared invalid_value required_value idempotency_key_already_used temporarily_unavailable conflict

message

required

string

status

required

string

Allowed values: error

Example

{
  "code": "bad_request",
  "status": "error"
}