Get a specific knowledge base

GET

/knowledge/{id}

curl --request GET \
  --url https://api.amitysolutions.com/api/v1/knowledge/1 \
  --header 'x-api-key: <x-api-key>'

• ASAP API Endpoint

Authorizations

• apiKey

Parameters

Path Parameters

id

required

number

Knowledge Base ID

Responses

200

Knowledge base with specified ID

Media typeapplication/json

object

id

Numeric ID of the knowledge

number

name

The name of the knowledge

string

source

Type of knowledge base. internal will search the content from uploaded files and external will send a request to target endpoint for search.

string

Allowed values: internal external

supportedLanguages

List of supported languages for the knowledge. Files uploaded to this knowledge will have a copy of the document with each supported language translated.

Array<string>

Allowed values: en th

target

Search endpoint for external knowledge bases

string

enableSemanticSearch

If set to true, search will use semantic search on top of full-text search.

boolean

createdAt

Timestamp of creation for knowledge

string format: ISOString

updatedAt

Last updated timestamp for knowledge

string format: ISOString

Example

{
  "source": "internal",
  "supportedLanguages": [
    "en"
  ],
  "createdAt": "2023-11-09T00:00:00.000Z",
  "updatedAt": "2023-11-09T00:00:00.000Z"
}

401

Unauthorized Error. ASAP will return this error when there is either no api key, invalid api key or the client`s IP address is not whitelisted.

Media typeapplication/json

object

name

string

code

number

status

number

message

string

errors

Array<object>

object

Example

{
  "name": "UnauthorizedException",
  "code": 401001,
  "status": 401,
  "message": "Unauthorized",
  "errors": []
}

404

Knowledge base not found

Media typeapplication/json

object

name

Name of the error

string

code

ASAP platform specific error code

number

status

HTTP status code

number

message

Error message details

string

errors

Array<object>

object

Example

{
  "name": "NotFoundException",
  "code": 404001,
  "status": 404,
  "message": "Knowledge base with specified ID not found.",
  "errors": []
}

422

Validation Error

Media typeapplication/json

object

name

Name of the error

string

code

ASAP platform specific error code

number

status

HTTP status code

number

message

Error message details

string

errors

Array<object>

object

type

required

Type of error

string

field

required

Name of the field having the error

string

value

Input value

string

message

required

Error message

string

Example

{
  "name": "UnprocessableEntityException",
  "code": 422001,
  "status": 422,
  "message": "request payload validation failed",
  "errors": [
    {
      "type": "isNotEmpty",
      "field": "name",
      "message": "name must not be empty"
    },
    {
      "type": "min",
      "field": "limit",
      "value": -1,
      "message": "limit must not be less than 1"
    }
  ]
}

429

Too Many Requests

Media typeapplication/json

object

name

Name of the error

string

code

ASAP platform specific error code

number

status

HTTP status code

number

message

Error message details

string

errors

Array<object>

object

Example

{
  "name": "RateLimitExceededException",
  "code": 429001,
  "status": 429,
  "message": "Rate limit exceeded",
  "errors": []
}