# API

Mindplug follows a REST API architecture which can be universally used in any language for any application.

Using the raw API ensures the fastest updates for new and existing endpoints. All the endpoints are listed in this documentation and use axios for making the call requests to Mindplug servers.

The documentation architecture:

## Setup

[**API Setup - Base**](/api/api-setup-text.md)

* Base instance for axios used to interact with text storage and web.

[**API Setup - PDFs**](/api/api-setup-pdfs.md)

* Base instance for axios used to interact with PDF files

[**API Setup - Audio**](/api/api-setup-audio.md)

* Base instance for axios used to interact with audio

## Storing Data

[**Store basic text**](/api/storing-data.md)

* Store basic text content given a string value.

[**Store PDF files**](/api/store-pdf.md)

* To store files, you need a form instance for axios to pass formData.

[**Store webpage**](/api/store-web.md)

* Pass in a URL for mindplug to crawl and read.

## Query Data

[**Query - semantic search**](/api/query.md)

* To semantic search on stored data. Seach by meaning of text.

[**Query by vector ids**](/api/query-by-ids.md)

* Search specific vectors by their ids

[**Query by collection**](/api/query-by-collection.md)

* Returns the recent 10 vectors from a given collection

## Delete Data

[**Delete by vector ids**](/api/delete-by-ids.md)

* Delete specific data based on vector ids

[**Delete collection**](/api/delete-collection.md)

* Delete an entire collection, including all stored vectors within.

[**Delete Project**](/api/delete-project.md)

* Delete an entire project, including all collections and vectors within.

## List Data

[**List projects**](/api/list-projects.md)

* List all the projects you have on Mindplug

[**List collections**](/api/list-collections.md)

* List all the collections you have on Mindplug

## Smart

[**Web search**](/api/search-web.md)

* Returns the top 3 google results from select resources

###


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mindplug.io/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
