# Start or resume an Ask AI session

`POST https://api.cryptohopper.com/v1/user/askai/new`

Part of [Users](https://www.cryptohopper.com/api-documentation/api-reference/users.md) in the Cryptohopper API reference.

Returns the stored Ask AI conversation for a section, or suggested questions when there is none. Send new_session 1 to clear the stored conversation first.

OAuth scope: `read`, `user`

When a conversation is stored, data has a messages array (question, answer, id) instead of suggestions. Conversations are kept for one day.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Example request

```bash
curl -X POST "https://api.cryptohopper.com/v1/user/askai/new" \
  -H "access-token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"page":"dashboard","new_session":1}'
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "suggestions": {
            "42": {
                "id": "42",
                "question": "How do I start my bot?",
                "answer": "Open your bot's dashboard and switch it on."
            }
        }
    }
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.