Share dreams, get AI-powered interpretations, and connect with dreamers worldwide
The AI Dream Chat API is a RESTful service that enables users to share dreams, discuss them with others, and receive AI-powered interpretations. Most endpoints require JWT authentication.
Sign up, login, and manage user accounts
Create and manage dream posts
Create discussion groups and chat
Get AI-powered dream analysis
Authorization: Bearer <your_token_here>
Creates a new user account.
{
"username": "Princess",
"email": "adebisiqueen321@gmail.com",
"password": "Queen44zzi"
}
{
"status": "success",
"message": "Account created successfully",
"user": {
"id": 1,
"username": "Princess",
"email": "adebisiqueen321@gmail.com",
"created_at": "2025-10-10T14:30:00Z"
}
}
Authenticates a user and returns a JWT token.
{
"email": "adebisiqueen32@gmail.com",
"password": "Loveth55"
}
{
"status": "success",
"message": "Login successful",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"user": {
"id": 1,
"username": "Princess",
"email": "adebisiqueen32@gmail.com"
}
}
Initiates password recovery process by sending a reset link.
{
"email": "adebisiqueen@gmail.com"
}
Creates a new dream post.
{
"title": "I had a dream a book was handed over to me",
"content": "I think i might be a choosen one"
}
{
"status": "success",
"message": "Post created successfully",
"post": {
"id": 1,
"title": "I had a dream a book was handed over to me",
"content": "I think i might be a choosen one",
"author_id": 1,
"author_username": "Princess",
"created_at": "2025-10-10T14:35:00Z",
"comment_count": 0
}
}
Retrieves all posts along with their comments.
Retrieves details of a specific post.
Updates an existing post. Only the post author can edit.
Adds a comment to a specific post.
{
"comment": "funny it usually means you are madly in love"
}
Retrieves all comments for a specific post.
Creates a new discussion group.
{
"name": "The Seers"
}
{
"status": "success",
"message": "Group created successfully",
"group": {
"id": 1,
"name": "The Seers",
"invite_link": "c4b675d8-8104-4ed3-b8d8-c6e0d9169a9d",
"creator_id": 1,
"creator_username": "Princess",
"created_at": "2025-10-10T15:30:00Z",
"member_count": 1
}
}
Join an existing group using an invite link.
Deletes a group. Only the creator can delete.
Removes a member from a group. Creator only.
Sends a message to a group chat.
{
"content": "Hello everyone welcome as a member"
}
Retrieves all messages from a group chat.
Uses AI to interpret the meaning of a dream with cultural context.
{
"dream": "i had a dream i was given a book what does it mean in yoruba land"
}
{
"status": "success",
"interpretation": "In Yoruba culture, dreaming of receiving a book...",
"cultural_context": "Yoruba",
"dream_id": 1,
"interpreted_at": "2025-10-10T16:15:00Z"
}
| Status Code | Description |
|---|---|
| 200 | OK - Request successful |
| 201 | Created - Resource created successfully |
| 400 | Bad Request - Invalid input or missing fields |
| 401 | Unauthorized - Authentication required |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found - Resource doesn't exist |
| 500 | Internal Server Error |
| 503 | Service Unavailable |