# Authentication Method

## Authentication Documentation

### Introduction

This document provides guidelines for authenticating requests to the PAAL AI API. Authentication is required for creating, modifying, and deleting project data, but it is not required for retrieving project data.

### Authentication Header

To authenticate requests, include an HTTP header with the following structure:

* **Header Name**: `Bearer`
* **Header Value**: Your authentication token

#### Example Header

```http
Bearer: your-authentication-token
```

### Example Usage

#### Including Authentication Header in Requests

When making requests to the API endpoints that require authentication, ensure you include the `Bearer` token in the headers.

#### Using cURL

```sh
curl -X POST 'https://paal-ecosystem-backend.onrender.com/project/new' \
-H 'Content-Type: application/json' \
-H 'Bearer: your-authentication-token' \
-d '{
  "name": "Project Alpha",
  "about": "This project focuses on AI development.",
  "growth": "20%"
}'
```

#### Using JavaScript (Fetch API)

```javascript
fetch('https://paal-ecosystem-backend.onrender.com/project/new', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Bearer': 'your-authentication-token'
  },
  body: JSON.stringify({
    name: 'Project Alpha',
    about: 'This project focuses on AI development.',
    growth: '20%'
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
```

#### Using Postman

1. Open Postman and create a new request.
2. Select the request method (e.g., POST).
3. Enter the request URL (e.g., [`https://api.example.com`](https://paal-ai.onrender.com)`/project/new`).
4. Go to the **Headers** tab.
5. Add another header:
   * **Key**: `Bearer`
   * **Value**: `your-authentication-token`
6. Go to the **Body** tab, select **raw** and set the type to **JSON**.
7. Enter the request payload in JSON format.
8. Send the request.

#### Using Axios (JavaScript)

```javascript
const axios = require('axios');

axios.post('https://paal-ecosystem-backend.onrender.com/project/new', {
  name: 'Project Alpha',
  about: 'This project focuses on AI development.',
  growth: '20%'
}, {
  headers: {
    'Content-Type': 'application/json',
    'Bearer': 'your-authentication-token'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error('Error:', error));
```

### Summary

By including the `Bearer` token in the request headers, you can authenticate your requests to the PAAL AI API. Ensure your token is valid and correctly included in the headers to access the protected endpoints for creating, modifying, and deleting data.


---

# 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://coat.gitbook.io/paal-ai-apis/paal-ai-api-docs/authentication-method.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.