AskYourPDF API Documentation

Introducing the AskYourPDF API

AskYourPDF is a cutting-edge solution revolutionizing document interactions. Our API empowers developers with the ability to programmatically extract valuable information from PDF files and leverage it to create custom chatbots. By providing seamless access to the content within PDF documents, developers can build powerful applications that enable users to navigate, search, and engage with data effortlessly. This comprehensive guide will walk you through the API's features, pricing, authentication methods, and usage guidelines, opening up endless possibilities to enhance productivity and knowledge retrieval for your applications. Harness the potential of AskYourPDF API and embark on an innovative journey of intelligent document analysis and interactive experiences.

Uploading A Document

To upload a document, choose between generating a document ID on our website or using the API endpoint. We support various document formats, including '.pdf', '.txt', '.ppt', '.pptx', '.csv', '.epub', and '.rtf'. Additionally, you can upload PDFs using links. Moreover, the API enables interaction with any blog post or website by providing the link to the post.

Authentication

Authentication is required for all our API endpoints. To access them, you must generate API keys on your AskYourPDF account. These API keys need to be set in your request header as "x-api-key." It is essential to treat your API key as a secret and ensure its protection.

headers: {
    "x-api-key": "ask_xxxxx"
  }

1. Adding Document via URL

Download Pdf

get

Download a PDF file from a URL and save it to the database.

Args: user: The user who is uploading the file. url: The URL of the PDF file to download.

Returns: dict: The document ID of the downloaded file.

Authorizations

X-API-KeystringRequired

Query parameters

urlstringRequired

Responses

201

Successful Response

application/json

422

Validation Error

application/json

get

/v1/api/download_pdf

GET /v1/api/download_pdf?url=text HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "docId": "text"
}

Query Parameters:

url (required): The link to the document. It could be a link to a PDF or a post on a website

Response:

201 Successful Response
- doc_id (string): The document ID of the uploaded document.

{ "doc_id": "6e60e87c-6154-4dff-8e62-ff10d8ed16dd" }

Examples:

cURL

curl -X GET 
'https://api.askyourpdf.com/v1/api/download_pdf?url=https://www.example.com/document.pdf' 
-H 'x-api-key: YOUR_API_KEY'

Python

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

response = requests.get('https://api.askyourpdf.com/v1/api/download_pdf', 
headers=headers, 
params={'url': 'https://www.example.com/document.pdf'})

if response.status_code == 201:
    print(response.json())
else:
    print('Error:', response.status_code)

Javascript

const axios = require('axios');

const headers = {
    'x-api-key': 'YOUR_API_KEY'
};

axios.get('https://api.askyourpdf.com/v1/api/download_pdf', {
  headers: headers,
  params: {
    url: 'https://www.example.com/document.pdf'
  }
})
.then((response) => {
  if (response.status === 201) {
    console.log(response.data);
  } else {
    console.log('Error:', response.status);
  }
})
.catch((error) => {
  console.error(error);
});

2. Adding Document via File Upload.

Upload Pdf

post

Upload a PDF file and save it to the database.

Args: user: The user who is uploading the file. file: The PDF file to upload.

Returns: dict: The document ID of the uploaded file.

Authorizations

X-API-KeystringRequired

Body

filestring · binaryRequired

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/api/upload

POST /v1/api/upload HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

{
  "docId": "text"
}

Request body:

The request body should be sent as a form of data with the name file (see example).

file (required): The raw bytes of the file to be uploaded.

Response:

201 Successful Response
- doc_id (string): The document ID of the uploaded document.

{ "doc_id": "6e60e87c-6154-4dff-8e62-ff10d8ed16dd" }

Examples:

cURL

curl -X POST 
-H 'x-api-key: YOUR_API_KEY' 
-F "file=@/path/to/yourfile.pdf" https://api.askyourpdf.com/v1/api/upload

Python

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

file_data = open('/path/to/yourfile.pdf', 'rb')

response = requests.post('https://api.askyourpdf.com/v1/api/upload', headers=headers,
 files={'file': file_data})

if response.status_code == 201:
    print(response.json())
else:
    print('Error:', response.status_code)

Javascript

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const headers = {
    'x-api-key': 'YOUR_API_KEY'
};

let form = new FormData();
form.append('file', fs.createReadStream('/path/to/yourfile.pdf'));

axios.post('https://api.askyourpdf.com/v1/api/upload', form, {
  headers: {
    ...headers,
    ...form.getHeaders()
  }
})
.then((response) => {
  if (response.status === 201) {
    console.log(response.data);
  } else {
    console.log('Error:', response.status);
  }
})
.catch((error) => {
  console.error(error);
});

3. Chat Endpoint

Endpoint for initiating a chat with a document. This endpoint requires API Key Header authentication.

Chat With Doc Endpoint

post

Chat with a single document.

Args: doc_id: The document id. model_name: The model name. messages: The list of messages. cite_source: Whether to cite the source or not. temperature: The model temperature max value is 1.5 and min value is 0.1. language: The language to respond in. length: The length of the response stream: Whether to stream the response or not. agent_mode: Whether to use agent mode or not. user: The current user.

Returns: ChatSerializer: The chat response.

Authorizations

X-API-KeystringRequired

Path parameters

doc_idstringRequired

Query parameters

model_namestring · enumOptionalDefault: GPT5_2Possible values:

streambooleanOptionalDefault: false

cite_sourcebooleanOptionalDefault: false

temperaturenumberOptionalDefault: 0.7

languagestring · enumOptionalDefault: DEFAULTPossible values:

lengthany ofOptionalDefault: LONG

string · enumOptionalPossible values:

nullOptional

agent_modebooleanOptionalDefault: true

Bodyobject · ChatRequest[]

ChatRequest response schema.

senderstringRequired

messagestringRequired

Responses

200

Successful Response

application/json

createdstring · date-timeOptional

422

Validation Error

application/json

post

/v1/chat/{doc_id}

POST /v1/chat/{doc_id} HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 36

[
  {
    "sender": "text",
    "message": "text"
  }
]

{
  "question": {
    "sender": "text",
    "message": "text",
    "type": "text"
  },
  "answer": {
    "sender": "text",
    "message": "text",
    "type": "text"
  },
  "sources": [
    {
      "id": 1,
      "doc_id": "text",
      "source_chunk": "text",
      "page_number": 1
    }
  ],
  "created": "2026-05-17T17:13:48.643Z"
}

Path Parameters:

doc_id (string, required): The ID of the document for the conversation.

Query Parameters:

stream (boolean, optional): Flag for streaming. Default is false
model_name (string, optional) : The model the user chooses to use, model choices includes GPT5_2, GPT5, GPT5_MINI, GPT5_NANO, GEMINI_FLASH, CLAUDE1, CLAUDE2, GPT4, GPT5, GEMINI_PRO, GPT4O_MINI. Default model is GPT5_2
agent_mode (boolean, optional) : Enabled by default. This flag determines whether the system uses our agent to answer your question. When set to True, responses may take slightly longer but are generally more accurate and higher quality than those generated in normal mode.
cite_source (boolean, optional) : Flag for cite_source. Default if false
temperature (float, optional) : Flag for temperature. Default is 0.7
language (string, optional) : The language the user chooses to chat with, language choices include ENGLISH, ARABIC, CHINESE, JAPANESE, FRENCH , GERMAN, SPANISH, KOREAN, PORTUGESE. Default language is ENGLISH.
length (string, optional) : This option allows you to choose the desired length of the response. Choices includes LONG and SHORT. Default value is SHORT

Request body:

sender (required): The sender of the chat message. The sender should be user or (systemIf you want to specify a custom system prompt)
message (required): The chat message content.

The request body to ask a single question.

// Example of a request asking a question along with a system prompt
[
  {
    "sender": "system",
    "message": "Reply to my question in json format"
  },
  {
    "sender": "user",
    "message": "What does this document say?"
  }
]

// Example of a request asking a question without a system prompt
[
  {
    "sender": "user",
    "message": "What does this document say?"
  }
]

To ask a follow-up question and provide the model with context you can send your previous questions and responses in the following format.

[
    {   
    "sender": "user",
    "message": "What does the document say?"
    },
    {
    "sender": "bot",
    "message": "The document consists of words in different languages expressing gratitude"
     },
   {
    "sender": "user",
    "message": "What is the word expressing gratitude in Spanish?"
    }
]

Response:

The response when the query parameter stream = False

200 Successful Response
- question: The question posed by the user, with sender, message, and type.
  - sender
  - message
  - type
- answer: The answer provided by the AI, with sender, message, and type.
  - sender
  - message
  - type
- created (string): The time the chat was created.

{
  "question": {
    "sender": "user",
    "message": "What does this document say?",
    "type": "question"
  },
  "answer": {
    "sender": "bot",
    "message": "This document talks about AI",
    "type": "response"
  },
  "created": "2023-07-20T11:14:55.928Z"
}

By setting the query parameter stream = True, you can receive the response as a stream of token. An example of the response can be seen below.

Chunk: This
Chunk: document
Chunk: talks
Chunk: about
Chunk: AI

Example when stream = False:

cURL

curl -X POST 
-H 'Content-Type: application/json' 
-H 'x-api-key: YOUR_API_KEY' 
-d '[{"sender": "User","message": "What does this document say?"}]'
 https://api.askyourpdf.com/v1/chat/{YOUR_DOC_ID}

Python

import requests
import json

headers = {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
}

data = [
    {
        "sender": "User",
        "message": "What does this document say?"
    }
]

response = requests.post('https://api.askyourpdf.com/v1/chat/{YOUR_DOC_ID}', 
headers=headers, data=json.dumps(data))

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

Javascript

const axios = require('axios');

const headers = {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
};

const data = [
    {
        "sender": "User",
        "message": "What does this document say?"
    }
];

axios.post('https://api.askyourpdf.com/v1/chat/{YOUR_DOC_ID}', data, {headers: headers})
.then((response) => {
    if (response.status === 200) {
        console.log(response.data);
    } else {
        console.log('Error:', response.status);
    }
})
.catch((error) => {
    console.error(error);
});

Example when stream = True:

Python

import requests
import json

headers = {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
}

data = [
    {
        "sender": "User",
        "message": "What does this document say?"
    }
]

try:
    response = requests.post(
        'https://api.askyourpdf.com/v1/chat/YOUR_DOC_ID?stream=True',
        headers=headers, data=json.dumps(data))
    response.raise_for_status()

    for chunk in response.iter_content(chunk_size=24):
        chunk_str = chunk.decode('utf-8')
        print("Chunk:", chunk_str)

except requests.exceptions.RequestException as error:
    print("Error:", error)

Javascript

const fetch = require('node-fetch');
const Readable = require('stream').Readable;


const headers = {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
}

const data = [
    {
        "sender": "User",
        "message": "What does this document say?"
    }
]

fetch('https://api.askyourpdf.com/v1/chat/YOUR_DOC_ID?stream=True', {
    method: 'POST',
    headers: headers,
    body: JSON.stringify(data)
})
    .then(response => {
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        return response.body;
    })
    .then(stream => {
        const reader = Readable.from(stream);
        reader.on('data', chunk => {
            console.log("Chunk:", chunk.toString('utf-8'));
        });
    })
    .catch(error => {
        console.log("Error:", error);
    });

4. Chat with multiple documents

This endpoint allows a user to chat with more than one document.

Deprecated

Chat With Multiple Documents

post

[DEPRECATED] Chat with multiple documents using knowledgebase Id. Please use /api/knowledge/{knowledge_base_id}/chat instead.

Chat with multiple document.

Args: knowledge_base: The knowledge base request payload containing the list of documents and messages. model_name: The model name. temperature: The model temperature max value is 1.5 and min value is 0.1. stream: Whether to stream the response or not. cite_source: Whether to cite the source or not. language: The language to respond in. length: The length of the response agent_mode: Whether to use agent mode or not. user: The current user.

Returns: ChatSerializer: The chat response.

Authorizations

X-API-KeystringRequired

Query parameters

model_namestring · enumOptionalDefault: GPT5_MINIPossible values:

streambooleanOptionalDefault: false

cite_sourcebooleanOptionalDefault: false

temperaturenumberOptionalDefault: 0.7

languagestring · enumOptionalDefault: DEFAULTPossible values:

lengthany ofOptionalDefault: LONG

string · enumOptionalPossible values:

nullOptional

agent_modebooleanOptionalDefault: true

Body

KnowledgeChatRequest response schema.

documentsstring[]Required

Responses

200

Successful Response

application/json

createdstring · date-timeOptional

422

Validation Error

application/json

post

/v1/api/knowledge_base_chat

POST /v1/api/knowledge_base_chat HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 70

{
  "documents": [
    "text"
  ],
  "messages": [
    {
      "sender": "text",
      "message": "text"
    }
  ]
}

{
  "question": {
    "sender": "text",
    "message": "text",
    "type": "text"
  },
  "answer": {
    "sender": "text",
    "message": "text",
    "type": "text"
  },
  "sources": [
    {
      "id": 1,
      "doc_id": "text",
      "source_chunk": "text",
      "page_number": 1
    }
  ],
  "created": "2026-05-17T17:13:48.643Z"
}

Query paramters

stream (boolean, optional): Flag for streaming. Default is false
model_name (string, optional) : The model the user chooses to use, model choices includes GPT5_2, GPT5, GPT5_MINI, GPT5_NANO, GEMINI_FLASH, CLAUDE1, CLAUDE2, GPT4, GPT5, GEMINI_PRO, GPT4O_MINI. Default model is GPT5_2
agent_mode (boolean, optional) : Enabled by default. This flag determines whether the system uses our agent to answer your question. When set to True, responses may take slightly longer but are generally more accurate and higher quality than those generated in normal mode.
cite_source (boolean, optional) : Flag for cite_sources. Default if false
temperature (float, optional) : Flag for temperature. Default is 0.7
language (string, optional) : The language the user chooses to chat with, language choices include ENGLISH, ARABIC, CHINESE, JAPANESE, FRENCH , GERMAN, SPANISH, KOREAN, PORTUGESE. Default language is ENGLISH.
length (string, optional) : This option allows you to choose the desired length of the response. Choices includes LONG and SHORT. Default value is SHORT

Body

{
  "documents": [
    "3c06c3f8-be9f-4f43-ac00-b1a82fd25b30"
  ],
  "messages": [
    // Optional system prompt that can be sent (can be used to specify custom prompts) 
    {
      "sender": "system",
      "message": "Reply to my question in two sentences"
    },
    // Compulsory user message that must be sent in the request
    {
      "sender": "user",
      "message": "What are the documents all about?"
    }
  ]
}

Response:

200 : Successful Response
- question : A dict of information directed to the model
  - sender : The sender of the question,
  - message : The question asked
  - type : Has a value of "question"
- answer : A dict of response information from the model
  - sender : The sender of the response
  - message : The exact answer a user requested
  - type : Has a value of "response"

{
  "question": {
    "sender": "user",
    "message": "What is the document all about",
    "type": "question"
  },
  "answer": {
    "sender": "bot",
    "message": "The document simply describes the applications of motions",
    "type": "response"
  },
  "created": "2024-08-23T11:01:46.204541"
}

Examples

curl -X POST 'https://api.askyourpdf.com/v1/api/knowledge_base_chat?model_name=GPT4O_MINI&stream=false&length=LONG&language=ARABIC&temperature=0.7' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "documents": [
      "3c06c3f8-be9f-4f43-ac00-b1a82fd25b30"
    ],
    "messages": [
      {
        "sender": "user",
        "message": "What is the document all about"
      }
    ]
  }'

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

payload = {
  "documents": [
    "3c06c3f8-be9f-4f43-ac00-b1a82fd25b30"
  ],
  "messages": [
    {
      "sender": "user",code
      "message": "What is the document all about"
    }
  ]
}

params = {
"model_name":"GPT4O_MINI",
"stream":False,
"length":"LONG",
"language":"ARABIC",
"temperaature":0.7
}

response = requests.post('https://api.askyourpdf.com/v1/api/knowledge_base_chat', 
headers=headers, json=payload, params = params)

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

const axios = require('axios');

const headers = {
  'x-api-key': 'YOUR_API_KEY'
};

const payload = {
  "documents": [
    "3c06c3f8-be9f-4f43-ac00-b1a82fd25b30"
  ],
  "messages": [
    {
      "sender": "user",
      "message": "What is the document all about"
    }
  ]
};

const params = {
  "model_name": "GPT4O_MINI",
  "stream": false,
  "length": "LONG",
  "language": "ARABIC",
  "temperature": 0.7
};

axios.post('https://api.askyourpdf.com/v1/api/knowledge_base_chat', payload, {
  headers: headers,
  params: params
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error('Error:', error.response ? error.response.status : error.message);
  });

5. Documents Retrieval Endpoint

This endpoint allows users to retrieve a paginated list of their uploaded documents.

Fetch Documents

get

Fetch all documents for the current user.

Returns: dict: A list of documents.

Authorizations

X-API-KeystringRequired

Query parameters

pageinteger · min: 1OptionalDefault: 1

page_sizeinteger · min: 1 · max: 100OptionalDefault: 10

Responses

200

Successful Response

application/json

Serializer for paginated user documents meta data

total_pagesintegerOptionalDefault: 0

422

Validation Error

application/json

get

/v1/api/documents

GET /v1/api/documents HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "total_pages": 0,
  "documents": [
    {
      "name": "text",
      "doc_id": "text",
      "summary": "text",
      "language": "en",
      "pages": 0,
      "shareable": true,
      "date_time": "2026-05-17T17:13:48.643Z"
    }
  ]
}

Query Parameters:

page (integer, optional): The page to return. Defaults to 1.
page_size (integer, optional): The number of documents to return per page. Defaults to 10.

Response:

200 Successful Response
- total_pages (Integer): The total number of pages available for querying
- documents (Array): A list of document details belonging to the user.
  - name
  - doc_id
  - summary
  - language
  - pages
  - shareable
  - date_time

{
  "total_pages": 1,
  "documents": [
    {
      "name": "Nature.pdf",
      "doc_id": "6e60e87c-6154-4dff-8e62-ff10d8ed16dd",
      "summary": "This is a document about nature",
      "language": "en",
      "pages": 10,
      "shareable": true,
      "date_time": "2023-07-21T06:18:18.891Z"
    }
  ]
}

Examples:

cURL

curl -X GET 
-H 'x-api-key: YOUR_API_KEY' 
'https://api.askyourpdf.com/v1/api/documents?page=1&page_size=10'

Python

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

params = {
    'page': 1,
    'page_size': 10
}

response = requests.get('https://api.askyourpdf.com/v1/api/documents', 
headers=headers, params=params)

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

Javascript

const axios = require('axios');

const headers = {
    'x-api-key': 'YOUR_API_KEY'
};

const params = {
    'page': 1,
    'page_size': 10
};

axios.get('https://api.askyourpdf.com/v1/api/documents', 
{headers: headers, params: params})
.then((response) => {
  if (response.status === 200) {
    console.log(response.data);
  } else {
    console.log('Error:', response.status);
  }
})
.catch((error) => {
  console.error(error);
});

6. Single Document Retrieval Endpoint

This endpoint allows users to retrieve a single document.

Fetch Document

get

Fetch a user's documents using the doc_id.

Returns: dict: A single document.

Authorizations

X-API-KeystringRequired

Path parameters

doc_idstringRequired

Responses

200

Successful Response

application/json

namestringRequired

doc_idstringRequired

summaryany ofOptional

stringOptional

nullOptional

languagestringOptionalDefault: en

pagesintegerOptionalDefault: 0

shareablebooleanOptionalDefault: true

date_timestring · date-timeOptional

422

Validation Error

application/json

get

/v1/api/documents/{doc_id}

GET /v1/api/documents/{doc_id} HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "name": "text",
  "doc_id": "text",
  "summary": "text",
  "language": "en",
  "pages": 0,
  "shareable": true,
  "date_time": "2026-05-17T17:13:48.643Z"
}

Path Parameters:

doc_id (string, required): The ID of the document for the conversation.

Response:

200 Successful Response
- name
- doc_id
- summary
- language
- pages
- shareable
- date_time

  {
    "name": "Nature.pdf",
    "doc_id": "6e60e87c-6154-4dff-8e62-ff10d8ed16dd",
    "summary": "This is a document about nature",
    "language": "en",
    "pages": 10,
    "shareable": true,
    "date_time": "2023-07-21T06:18:18.891Z"
  }

Examples:

cURL

curl -X GET
 -H 'x-api-key: YOUR_API_KEY' 
 'https://api.askyourpdf.com/v1/api/documents/{YOUR_DOC_ID}'

Python

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

response = requests.get('https://api.askyourpdf.com/v1/api/documents/{YOUR_DOC_ID}',
 headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

Javascript

const axios = require('axios');

const headers = {
    'x-api-key': 'YOUR_API_KEY'
};

axios.get('https://api.askyourpdf.com/v1/api/documents/{YOUR_DOC_ID}',
 {headers: headers})
.then((response) => {
    if (response.status === 200) {
        console.log(response.data);
    } else {
        console.log('Error:', response.status);
    }
})
.catch((error) => {
    console.error(error);
});

7. Delete Document Endpoint

Allows users to delete a single document

Delete Document

delete

Delete a document belonging to the authenticated user.

Args: user: The user who is deleting the file. doc_id: The document ID to delete.

Returns: dict: A success message.

Authorizations

X-API-KeystringRequired

Path parameters

doc_idstringRequired

Responses

200

Successful Response

application/json

Other propertiesanyOptional

422

Validation Error

application/json

delete

/v1/api/documents/{doc_id}

DELETE /v1/api/documents/{doc_id} HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Path Parameters:

doc_id (string, required): The ID of the document to be deleted.

Response:

200 Successful Response

 {"message": "Document deleted successfully"}

Examples:

cURL

curl -X DELETE 
-H 'x-api-key: YOUR_API_KEY' 
'https://api.askyourpdf.com/v1/api/documents/DOC_ID'

Python

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

response = requests.delete('https://api.askyourpdf.com/v1/api/documents/DOC_ID', headers=headers)

if response.status_code == 200:
    print('Document deleted successfully')
else:
    print('Error:', response.status_code)

Javascript

const axios = require('axios');

const headers = {
    'x-api-key': 'YOUR_API_KEY'
};

axios.delete('https://api.askyourpdf.com/v1/api/documents/DOC_ID', {headers: headers})
.then((response) => {
    if (response.status === 200) {
        console.log('Document deleted successfully');
    } else {
        console.log('Error:', response.status);
    }
})
.catch((error) => {
    console.error(error);
});

KnowledgeBase Endpoints

Knowledgebase endpoints are used when a user wants to chat or interact with multiple documents

8. Get Knowledge Bases

This endpoint enables an authenticated user to retrieve paginated knowledgebases Returns: PaginatedKnowledgeBase: The response containing the updated knowledge base.

Query parameters

page (integer, optional)
page_size (integer, optional)
order (string optional)

Response

200 Successful Response
- total_pages (Integer): The total number of pages available for querying
- knowledge_bases : An array of knowledges bases being queried

{
  "total_pages": 0,
  "knowledge_bases": [
    {
      "knowledge_base_id": "b2cb7d2c-5922-4dad-94b5-65b657e02a9c",
      "name": "Johns knowledgebase",
      "document_details": [
        {
          "doc_id": "b2cb7d2c-5922-4dad-94b5-65b657e02a9c",
          "name": "new_docs.pdf"
        }
      ],
      "date_time": "2024-08-21T12:38:07.085Z"
    }
  ]
}

422 : Validation Error

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Examples

curl -H "x-api-key: YOUR_API_KEY"
     -X GET "https://api.askyourpdf.com/v1/api/knowledge"


import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

response = requests.get('https://api.askyourpdf.com/v1/api/knowledge', headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

const axios = require('axios');

const headers = {
    'x-api-key': 'YOUR_API_KEY'
};

axios.get('https://api.askyourpdf.com/v1/api/knowledge', { headers })
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error('Error:', error.response ? error.response.status : error.message);
    });

9. Create Knowledge Base

This endpoint enables a user to create a knowlege base from the list of document IDs

Create Knowledge Base

post

Create a knowledge base from a list of document IDs.

Args: knowledge_base: The knowledge base to create. user: The user making the request.

Returns: KnowledgeBaseResponse: The response containing the knowledge base ID.

Authorizations

X-API-KeystringRequired

Body

namestringRequired

document_idsstring[]Required

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/api/knowledge

POST /v1/api/knowledge HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "name": "text",
  "document_ids": [
    "text"
  ]
}

{
  "knowledge_base_id": "text"
}

Body

name * (string, required) : The name of the knowledgebase
document_ids * (array, required) : The documents Ids to be included in the knowledgebase

{
  "name": "Johns knowledgebase",
  "document_ids": [
    "b2cb7d2c-5922-4dad-94b5-65b657e02a9c"
  ]
}

POST /api/knowledge

Authorization

API Key

Response

201 : Successful Response
- KnowlegeBaseResponse : A dictionary of knowledge_base_id created

{
  "knowledge_base_id": "b2cb7d2c-5922-4dad-94b5-65b657e02a9c"
}

422: Validation Error

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Examples

curl -X POST 'https://api.askyourpdf.com/v1/api/knowledge' -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' -d '{ "name": "string", "document_ids": [ "string" ] }'

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

payload = {
  "name": "string",
  "document_ids": [
    "string"
  ]
}
response = requests.post('https://api.askyourpdf.com/v1/api/knowledge', json=payload, headers=headers)

if response.status_code == 201:
    print(response.json())
else:
    print('Error:', response.status_code)

const axios = require('axios');

const headers = {
  'x-api-key': 'YOUR_API_KEY'
};

const payload = {
  "name": "string",
  "document_ids": [
    "string"
  ]
};

axios.post('https://api.askyourpdf.com/v1/api/knowledge', payload, { headers })
  .then(response => {
    if (response.status === 201) {
      console.log(response.data);
    } else {
      console.log('Error:', response.status);
    }
  })
  .catch(error => {
    console.error('Error:', error.response ? error.response.status : error.message);
  });

14. Chat With Documents Using Knowledge Base ID

This endpoint enables a user converse with multiple documents by using a single knowledgebase id

Chat With Knowledgebase

post

Chat with multiple documents using knowledgebase Id.

Args: knowledge_base_chat_request : The knowledge base chat request payload containing the messages. knowledge_base_id: The knowledge id is id of the knowledgebase documents you want to chat with. model_name: The model name. temperature: The model temperature max value is 1.5 and min value is 0.1. stream: Whether to stream the response or not. cite_source: Whether to cite the source or not. language: The language to respond in. length: The length of the response agent_mode: Whether to use agent mode or not. user: The current user.

Returns: ChatSerializer: The chat response.

Authorizations

X-API-KeystringRequired

Path parameters

knowledge_base_idstringRequired

Query parameters

model_namestring · enumOptionalDefault: GPT5_2Possible values:

streambooleanOptionalDefault: false

temperaturenumberOptionalDefault: 0.7

languagestring · enumOptionalDefault: DEFAULTPossible values:

lengthany ofOptionalDefault: LONG

string · enumOptionalPossible values:

nullOptional

cite_sourcebooleanOptionalDefault: false

agent_modebooleanOptionalDefault: true

Body

KnowledgeBaseIDChatRequest response schema.

Responses

200

Successful Response

application/json

createdstring · date-timeOptional

422

Validation Error

application/json

post

/v1/api/knowledge/{knowledge_base_id}/chat

POST /v1/api/knowledge/{knowledge_base_id}/chat HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "messages": [
    {
      "sender": "text",
      "message": "text"
    }
  ]
}

{
  "question": {
    "sender": "text",
    "message": "text",
    "type": "text"
  },
  "answer": {
    "sender": "text",
    "message": "text",
    "type": "text"
  },
  "sources": [
    {
      "id": 1,
      "doc_id": "text",
      "source_chunk": "text",
      "page_number": 1
    }
  ],
  "created": "2026-05-17T17:13:48.643Z"
}

Query parameters

stream (boolean, optional): Flag for streaming. Default is false
model_name (string, optional) : The model the user chooses to use, model choices includes GPT4O_MINI, GEMINI_FLASH, CLAUDE1, CLAUDE2, GPT4, GPT5_NANO, GPT5, GEMINI_PRO. Default model is GPT4O_MINI
cite_source (boolean, optional) : Flag for cite_sources. Default if false
temperature (float, optional) : Flag for temperature. Default is 0.7
language (string, optional) : The language the user chooses to chat with, language choices include ENGLISH, ARABIC, CHINESE, JAPANESE, FRENCH , GERMAN, SPANISH, KOREAN, PORTUGESE. Default language is ENGLISH.
length (string, optional) : This option allows you to choose the desired length of the response. Choices includes LONG and SHORT. Default value is SHORT

Request body:

messages: A list of dictionaries with key value of
- sender (required): The sender should be user or (systemIf you want to specify a custom system prompt)
- message (required): The chat message content.

The request body to ask a single question.

{
 "messages":[
  // Optional system prompt that can be sent (can be used to specify custom prompts) 
    {
      "sender": "system",
      "message": "Reply to my question in five sentences"
    },
    // Compulsor user message that must be sent in the request
    {
      "sender": "user",
      "message": "What do the documents in the knowledgebase talk about?"
    }
  ]
}

To ask a follow-up question and provide the model with context you can send your previous questions and responses in the following format.

[
    {   
    "sender": "user",
    "message": "What does the document say?"
    },
    {
    "sender": "bot",
    "message": "The document consists of words in different languages expressing gratitude"
     },
   {
    "sender": "user",
    "message": "What is the word expressing gratitude in Spanish?"
    }
]

Response

200 : Successful Response

{
  "question": {
    "sender": "user",
    "message": "What is the document all about",
    "type": "question"
  },
  "answer": {
    "sender": "bot",
    "message": "The document simply describes the applications of motions",
    "type": "response"
  },
  "created": "2024-08-23T11:01:46.204541"
}

422 : Validation Error

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

curl -X POST "https://api.askyourpdf.com/v1/api/knowledge/{knowledge_base_id}/chat" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "messages": [
    {
      "sender": "user",
      "message": "What is the document all about"
    }
  ]
}' \
--data-urlencode "model_name=GPT4O_MINI" \
--data-urlencode "stream=False" \
--data-urlencode "length=LONG" \
--data-urlencode "language=ARABIC" \
--data-urlencode "temperaature=0.7"

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

payload = {
  "messages": [
    {
      "sender": "user",
      "message": "What is the document all about"
    }
  ]
}

params = {
"model_name":"GPT3",
"stream":False,
"length":"LONG",
"language":"ARABIC",
"temperaature":0.7
}

response = requests.post('https://api.askyourpdf.com/v1/api/knowledge/{knowledge_base_id}/chat', 
headers=headers, json=payload, params = params)

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

const axios = require('axios');

const headers = {
  'x-api-key': 'YOUR_API_KEY',
  'Content-Type': 'application/json'
};

const payload = {
  messages: [
    {
      sender: "user",
      message: "What is the document all about"
    }
  ]
};

const params = {
  model_name: "GPT3",
  stream: false,
  length: "LONG",
  language: "ARABIC",
  temperaature: 0.7
};

axios.post('https://api.askyourpdf.com/v1/api/knowledge/{knowledge_base_id}/chat', payload, {
  headers: headers,
  params: params
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Error:', error.response.status);
});

10. Get KnowledgeBase

This endpoint enables a user to retrieve a single knowledge base

Get Knowledge Base

get

Get knowledge base

Args: knowledge_base_id: The ID of the knowledge base to retrieve. user: The user making the request.

Returns: KnowledgeDetailedResponse: The response containing the updated knowledge base.

Authorizations

X-API-KeystringRequired

Path parameters

knowledge_base_idstringRequired

Responses

200

Successful Response

application/json

knowledge_base_idstringRequired

namestringRequired

date_timestring · date-timeOptional

422

Validation Error

application/json

get

/v1/api/knowledge/{knowledge_base_id}

GET /v1/api/knowledge/{knowledge_base_id} HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "knowledge_base_id": "text",
  "name": "text",
  "document_details": [
    {
      "doc_id": "text",
      "name": "text"
    }
  ],
  "date_time": "2026-05-17T17:13:48.643Z"
}

Path parameter

knowledge_base_id * (string, required)

GET /api/knowledge/{knowledge_base_id}

Authorization

API Key

Response

200 : Succesful Response

{
  "knowledge_base_id": "b2cb7d2c-5922-4dad-94b5-65b657e02a9c",
  "name": "askyourpdf",
  "document_details": [
    {
      "doc_id": "b2cb7d2c-5922-4dad-94b5-65b657e02a9c",
      "name": "docs_name.pdf"
    }
  ],
  "date_time": "2024-08-22T15:41:56.723Z"
}

422 : Validator Error

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Examples

curl -X GET 'https://api.askyourpdf.com/v1/api/knowledge/YOUR_KNOWLEDGE_BASE_ID' -H 'x-api-key: YOUR_API_KEY'

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

response = requests.get('https://api.askyourpdf.com/v1/api/knowledge/{knowledge_base_id}', headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

const axios = require('axios');

const headers = {
  'x-api-key': 'YOUR_API_KEY'
};

const knowledgeBaseId = 'YOUR_KNOWLEDGE_BASE_ID';

axios.get(`https://api.askyourpdf.com/v1/api/knowledge/${knowledgeBaseId}`, { headers })
  .then(response => {
    if (response.status === 200) {
      console.log(response.data);
    } else {
      console.log('Error:', response.status);
    }
  })
  .catch(error => {
    console.error('Error:', error.response ? error.response.status : error.message);
  });

11. Update Knowledge Base

This endpoint enables a user to update a knowledge base

Update Knowledge Base

put

Update a knowledge base from a list of document IDs.

Args: knowledge_base_id: The ID of the knowledge base to update. knowledge_base: The items to update in the knowledge base. user: The user making the request.

Returns: KnowledgeDetailedResponse: The response containing the updated knowledge base.

Authorizations

X-API-KeystringRequired

Path parameters

knowledge_base_idstringRequired

Body

nameany ofOptional

stringOptional

nullOptional

document_idsstring[]Required

Responses

200

Successful Response

application/json

knowledge_base_idstringRequired

namestringRequired

date_timestring · date-timeOptional

422

Validation Error

application/json

put

/v1/api/knowledge/{knowledge_base_id}

PUT /v1/api/knowledge/{knowledge_base_id} HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "name": "text",
  "document_ids": [
    "text"
  ]
}

{
  "knowledge_base_id": "text",
  "name": "text",
  "document_details": [
    {
      "doc_id": "text",
      "name": "text"
    }
  ],
  "date_time": "2026-05-17T17:13:48.643Z"
}

Path parameter

knowledge_base_id* (string, required)

Body

name (string) : A new name for your knowledge base
document_ids: (string) An array of documents IDs you wish to update your knowledgebase with

{
"name": "new knowledgbebase name",
  "document_ids": [
    "b2cb7d2c-5922-4dad-94b5-65b657e02a9c"
  ]
}

PUT /api/knowledge/{knowledge_base_id}

Authorization

API Key

Response

200 : Successful Response

{
  "knowledge_base_id": "d2cb3e2c-5922-4dad-94b5-65b657e12a9c",
  "name": "KB1",
  "document_details": [
    {
      "doc_id": "b2cb7d2c-5922-4dad-94b5-65b657e02a9c",
      "name": "wolf_of_wallstreet.pdf"
    }
  ],
  "date_time": "2024-08-22T17:50:12.964Z"
}

422 : Validator Error

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Examples

curl -X PUT 'https://api.askyourpdf.com/v1/api/knowledge/YOUR_KNOWLEDGE_BASE_ID' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
  "name": "string",
  "document_ids": [
    "string"
  ]
}'

import requests

headers = {
    'x-api-key': 'YOUR_API_KEY'
}

payload  = {
  "name": "string",
  "document_ids": [
    "string"
  ]
}

response = requests.put('https://api.askyourpdf.com/v1/api/knowledge/{knowledge_base_id}', json = payload, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

const axios = require('axios');

const headers = {
  'x-api-key': 'YOUR_API_KEY'
};

const payload = {
  "name": "string",
  "document_ids": [
    "string"
  ]
};

const knowledgeBaseId = 'YOUR_KNOWLEDGE_BASE_ID';

axios.put(`https://api.askyourpdf.com/v1/api/knowledge/${knowledgeBaseId}`, payload, { headers })
  .then(response => {
    if (response.status === 200) {
      console.log(response.data);
    } else {
      console.log('Error:', response.status);
    }
  })
  .catch(error => {
    console.error('Error:', error.response ? error.response.status : error.message);
  });

12. Delete Knowledge Base

This endpoint enables a user to delete a knowledge base

Delete Knowledge Base

delete

Delete knowledge base

Args: knowledge_base_id: The ID of the knowledge base to delete. user: The user making the request.

Returns: dict: The response containing a success message

Authorizations

X-API-KeystringRequired

Path parameters

knowledge_base_idstringRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

delete

/v1/api/knowledge/{knowledge_base_id}

DELETE /v1/api/knowledge/{knowledge_base_id} HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

No content

Args: knowledge_base_id: The ID of the knowledge base to delete

Returns: dict: The response containing a success message

Path parameter

knowledge_base_id* (string, required)

DELETE /api/knowledge/{knowledge_base_id}

Authorization

API Key

Response

200 : Successful Response

{"message": "Knowledge base deleted successfully"}

Examples

curl -X DELETE 'https://api.askyourpdf.com/v1/api/knowledge/YOUR_KNOWLEDGE_BASE_ID' -H 'x-api-key: YOUR_API_KEY'

import requests

headers = {
'x-api-key': 'YOUR_API_KEY'
}

response = requests.delete('https://api.askyourpdf.com/v1/api/knowledge/{knowledge_base_id}', headers=headers)
if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

const axios = require('axios');

const headers = {
  'x-api-key': 'YOUR_API_KEY'
};

const knowledgeBaseId = 'YOUR_KNOWLEDGE_BASE_ID';

axios.delete(`https://api.askyourpdf.com/v1/api/knowledge/${knowledgeBaseId}`, { headers })
  .then(response => {
    if (response.status === 200) {
      console.log(response.data);
    } else {
      console.log('Error:', response.status);
    }
  })
  .catch(error => {
    console.error('Error:', error.response ? error.response.status : error.message);
  });

13. Search Knowledge Base

This endpoint retrieves a list of knowledgebases based on a user's query

Search Knowledge Bases

get

Search knowledge bases

Args: query: The search query user: The user making the request.

Returns: PaginatedKnowledgeBase: The response containing the updated knowledge base.

Authorizations

X-API-KeystringRequired

Query parameters

querystringRequired

Responses

200

Successful Response

application/json

knowledge_base_idstringRequired

namestringRequired

date_timestring · date-timeOptional

422

Validation Error

application/json

get

/v1/api/search/knowledge

GET /v1/api/search/knowledge?query=text HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

[
  {
    "knowledge_base_id": "text",
    "name": "text",
    "document_details": [
      {
        "doc_id": "text",
        "name": "text"
      }
    ],
    "date_time": "2026-05-17T17:13:48.643Z"
  }
]

Args: query: The search query is used to filter knowledgebases by name

Returns: KnowledgeBase: A list of knowledges matching the query

Query parameter

query* (string, required)

GET /api/search/knowledge

Authorization

API Key

Response

200 : Successful Response

[
  {
    "knowledge_base_id": "string",
    "name": "string",
    "document_details": [
      {
        "doc_id": "string",
        "name": "string"
      }
    ],
    "date_time": "2024-08-22T19:27:28.485Z"
  }
]

422 : Validator Error

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Examples

curl -X GET 'https://api.askyourpdf.com/v1/api/search/knowledge?query=YOUR_QUERY' -H 'x-api-key: YOUR_API_KEY'

import requests

headers = {
'x-api-key': 'YOUR_API_KEY'
}

response = requests.get('https://api.askyourpdf.com/v1/api/search/knowledge?query={QUERY}', headers=headers)
if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

const axios = require('axios');

const headers = {
  'x-api-key': 'YOUR_API_KEY'
};

const query = 'YOUR_QUERY';

axios.get(`https://api.askyourpdf.com/v1/api/search/knowledge?query=${query}`, { headers })
  .then(response => {
    if (response.status === 200) {
      console.log(response.data);
    } else {
      console.log('Error:', response.status);
    }
  })
  .catch(error => {
    console.error('Error:', error.response ? error.response.status : error.message);
  });

Models

15. Get Models

This endpoint returns the list of all available models we support on the AskYourPDF API

Get Models

get

Authorizations

X-API-KeystringRequired

Responses

200

Successful Response

application/json

nameany ofOptional

stringOptional

nullOptional

max_tokensany ofOptional

integerOptional

nullOptional

is_paid_modelany ofOptional

booleanOptional

nullOptional

model_provider_nameany ofOptional

stringOptional

nullOptional

get

/v1/api/models

GET /v1/api/models HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

200

Successful Response

[
  {
    "name": "text",
    "max_tokens": 1,
    "is_paid_model": true,
    "model_provider_name": "text"
  }
]

Returns:

A list of all available models each containing

name
max_tokens
is_paid_model
model_provider_name

Response

200: Successful Response

[
  {
    "name": "GPT4",
    "max_tokens": 3600,
    "is_paid_model": true,
    "model_provider_name": "gpt-4"
  },
  {
    "name": "Claude 1",
    "max_tokens": 4096,
    "is_paid_model": true,
    "model_provider_name": "claude-sonnet-4-5"
  },
  {
    "name": "Claude 2",
    "max_tokens": 4096,
    "is_paid_model": true,
    "model_provider_name": "claude-opus-4-1"
  },
  {
    "name": "GPT4O_MINI",
    "max_tokens": 3600,
    "is_paid_model": false,
    "model_provider_name": "gpt-4o-mini"
  },
  {
    "name": "GEMINI 2.5 PRO",
    "max_tokens": 15000,
    "is_paid_model": true,
    "model_provider_name": "gemini-2.5-pro"
  },
  {
    "name": "GEMINI 2.5 FLASH",
    "max_tokens": 15000,
    "is_paid_model": false,
    "model_provider_name": "gemini-2.5-flash"
  },
  {
    "name": "GPT5",
    "max_tokens": 3600,
    "is_paid_model": true,
    "model_provider_name": "gpt-5"
  },
  {
    "name": "GPT5_NANO",
    "max_tokens": 3600,
    "is_paid_model": false,
    "model_provider_name": "gpt-5-nano"
  }
]

curl -X POST "https://api.askyourpdf.com/v1/api/models" -H "x-api-key: YOUR_API_KEY"

NextHow to Install and Use AskYourPDF Plugin for ChatGPT✍🏻

Last updated 3 months ago

hashtagIntroducing the AskYourPDF API

hashtagUploading A Document

hashtagAuthentication

hashtag

hashtag1. Adding Document via URL

hashtagDownload Pdf

hashtagQuery Parameters:

hashtagResponse:

hashtagExamples:

hashtag

hashtag2. Adding Document via File Upload.

hashtagUpload Pdf

hashtagRequest body:

hashtagResponse:

hashtagExamples:

hashtag

hashtag3. Chat Endpoint

hashtagChat With Doc Endpoint

hashtagPath Parameters:

hashtagQuery Parameters:

hashtagRequest body:

hashtagResponse:

hashtagExample when stream = False:

hashtagExample when stream = True:

hashtag4. Chat with multiple documents

hashtagChat With Multiple Documents

hashtagQuery paramters

hashtagBody

hashtagResponse:

hashtagExamples

hashtag5. Documents Retrieval Endpoint

hashtagFetch Documents

hashtagQuery Parameters:

hashtagResponse:

hashtagExamples:

hashtag

hashtag6. Single Document Retrieval Endpoint

hashtagFetch Document

hashtagPath Parameters:

hashtagResponse:

hashtagExamples:

hashtag

hashtag7. Delete Document Endpoint

hashtagDelete Document

hashtagPath Parameters:

hashtagResponse:

hashtagExamples:

hashtagKnowledgeBase Endpoints

hashtag8. Get Knowledge Bases

hashtagQuery parameters

hashtagResponse

hashtagExamples

hashtag9. Create Knowledge Base

hashtagCreate Knowledge Base

hashtagBody

hashtagResponse

hashtagExamples

hashtag14. Chat With Documents Using Knowledge Base ID

hashtagChat With Knowledgebase

hashtagQuery parameters

hashtagRequest body:

hashtagResponse

hashtag10. Get KnowledgeBase

hashtagGet Knowledge Base

hashtagPath parameter

hashtagResponse

hashtagExamples

hashtag11. Update Knowledge Base

hashtagUpdate Knowledge Base

hashtagPath parameter

hashtagBody

hashtagResponse

hashtagExamples

hashtag12. Delete Knowledge Base

hashtagDelete Knowledge Base

hashtagPath parameter

hashtagResponse

hashtagExamples

hashtag13. Search Knowledge Base

hashtagSearch Knowledge Bases

Introducing the AskYourPDF API

Uploading A Document

Authentication

1. Adding Document via URL

Download Pdf

Query Parameters:

Response:

Examples:

2. Adding Document via File Upload.

Upload Pdf

Request body:

Response:

Examples:

3. Chat Endpoint

Chat With Doc Endpoint

Path Parameters:

Query Parameters:

Request body:

Response:

Example when stream = False:

Example when stream = True:

4. Chat with multiple documents

Chat With Multiple Documents

Query paramters

Body

Response:

Examples

5. Documents Retrieval Endpoint

Fetch Documents

Query Parameters:

Response:

Examples:

6. Single Document Retrieval Endpoint

Fetch Document

Path Parameters:

Response:

Examples:

7. Delete Document Endpoint

Delete Document

Path Parameters:

Response:

Examples:

KnowledgeBase Endpoints

8. Get Knowledge Bases

Query parameters

Response

Examples

9. Create Knowledge Base

Create Knowledge Base

Body

Response

Examples

14. Chat With Documents Using Knowledge Base ID

Chat With Knowledgebase

Query parameters

Request body:

Response

10. Get KnowledgeBase

Get Knowledge Base

Path parameter

Response

Examples

11. Update Knowledge Base

Update Knowledge Base

Path parameter

Body

Response

Examples

12. Delete Knowledge Base

Delete Knowledge Base

Path parameter

Response

Examples

13. Search Knowledge Base

Search Knowledge Bases

Query parameter

Response

Examples

Models

15. Get Models