Api Key

Wetrocloud

API Reference

Dashboard

Support

To get started with Wetrocloud’s API, follow these steps to create your API key

How to Access Your API Key

Welcome 👋 to the Wetrocloud Developer Documentation. Here you'll learn how to easily integrate Retrieval Augmented Generation (RAG) into your applications using the Wetrocloud API.

Introduction

Learn how to create collections, insert resources, and query them using cURL in just a few minutes.

Quickstart

Learn how to create collections using the Wetrocloud API

Create a Collection

This API endpoint displays a list of all your existing collections.

List collections

Learn how to insert resources using the Wetrocloud API

Insert a Resource

Learn how to query your collections in WetroCloud for both free text and structured responses.

Query your Resources

Learn how to query resources using the Wetrocloud API

Structured Output

Learn how to classify and structure resources using WetroCloud.

Categorize your Resources

Learn how to delete a collection using the Wetrocloud API when they are no longer needed.

Delete a Collection

Token optimization

Learn how to easily integrate Retrieval Augmented Generation (RAG) into your applications.

Understand the structure of JSON request bodies and responses, including key details for success, tokens, and identifiers.

Request and Response Formats

Learn about the resources wetrocloud API supports

Supported Resource Types

Explore the available WetroCloud API endpoints for creating, inserting, querying, and categorizing resources, with detailed response formats.

API Endpoints

This endpoint allows you to create a new collection_id.

#### Request Body

- No request body parameters required.
    

#### Response

The response will be a JSON object with the following properties:

- `collection_id` (string): The ID of the created item.
    
- `success` (boolean): Indicates whether the item creation was successful.

Create Collection

This endpoint allows you to list all your existing collections.
<Note> This list has a pagination of up to <b>20</b> items per request. `Next` and `Previous` urls will be provided on every response </Note>
#### Request Body
- No request body parameters required.
    

#### Response

The response will be a JSON object with the following properties:

- `count` (number): Total number of collections. - `next` (string): URL for the next pagination item. - `previous` (string): URL for the previous pagination item. - `results` (list): A list of all available collections.

List all Collections


This endpoint allows you to add data to a collection using an HTTP POST request.

#### Request Body

- `collection_id` (text): The ID of the collection to which the data will be added.
    
- `resource` (text): The resource to be added to the collection.
    
- `type` (text): The type of the resource being added.
    

#### Response

Upon successful addition, the response will include:

- `success` (boolean): Indicates whether the operation was successful.
    
- `tokens` (number): The number of tokens generated.
    

Insert Resource

This endpoint allows the user to make an HTTP POST request to submit a query to the specified collection.

### Request Body

- `collection_id` (text): The ID of the collection to which the query is being submitted.
    
- `request_query` (text): The query being submitted to the collection.
    
- `json_schema` (text): The JSON schema for the query response.
    
- `json_schema_rules` (text): Rules for the JSON schema.
    

### Response

The response for this request is a JSON schema with the following structure:
- `response` (object): The JSON schema for the query response.
    
- `tokens` (number): The number of tokens.
    
- `success` (boolean): Indicates whether the request was successful.

Query Resource



This endpoint allows you to create a new category by providing the necessary details in the request body.

#### Request Body

- `resource` (text): Description of the resource.
    
- `type` (text): Type of the category.
    
- `json_schema` (text): JSON schema for the category.
    
- `json_schema_rules` (text): Rules for the JSON schema.
    

#### Response

The response is a JSON object with the following properties:

- `label`: The label of the response.
    
- `tokens`: The number of tokens.
    
- `success`: Indicates the success status of the request.
    

Categorize Resource

This endpoint is used to delete a collection.

#### Request Body

- `collection_id` (text) - The ID of the collection to be deleted.
    

#### Response

- `message` - A message indicating the result of the deletion.
    
- `success` - Indicates whether the deletion was successful.