{"info":{"_postman_id":"84adb019-50c7-4286-8381-0d28ddbc7b29","name":"Journal api","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"44518762","collectionId":"84adb019-50c7-4286-8381-0d28ddbc7b29","publishedId":"2sB34kDyiT","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-07-19T18:10:13.000Z"},"item":[{"name":"signup","id":"d1d535b4-04f2-47fc-b3b8-9ba34f7e1a1e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"hey@gmail.com\",\r\n \"username\": \"user3\",\r\n \"password\": \"Password123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cozypages.onrender.com/signup/","description":"\n

This endpoint allows users to create a new account by providing their email, username, and password.

Request

Method: POST
\n
URL: https://cozypages.onrender.com/signup/
\n
Content-Type: application/json
\n

Request Body Parameters

email (string): The email address of the user. This will be used for account verification and communication.
\n
username (string): The desired username for the account. This should be unique to the user.
\n
password (string): The password for the account. It should meet security requirements.
\n

Expected Response

On a successful account creation, the server will respond with a status code of 201 and a JSON object containing a confirmation message indicating that the signup was successful. The response will have the following format:

{\n  \"message\": \"User created successfully\"\n}\n\n

Notes

Ensure that all parameters are provided correctly to avoid errors during the signup process. The email must be valid, the username should not be taken, and the password should adhere to the security guidelines.

\n","urlObject":{"protocol":"https","path":["signup",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d1d535b4-04f2-47fc-b3b8-9ba34f7e1a1e"},{"name":"sign in","id":"838623ac-a2af-4335-9576-47be43fa934e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"username\": \"user1\",\r\n \"password\": \"Password123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cozypages.onrender.com/signin/","description":"\n

This endpoint is used to authenticate a user by signing them into the application. It verifies the provided credentials (username and password) and returns a response indicating the success or failure of the authentication process.

Request

Method: POST
\n
URL: https://cozypages.onrender.com/signin/
\n

Request Body

The request body must be in JSON format and should include the following parameters:

username (string): The username of the user attempting to sign in. This is required to identify the user in the system.
\n
password (string): The password associated with the provided username. This is required for authentication.
\n

Example Request Body:

{\n  \"username\": \"user1\",\n  \"password\": \"Password123\"\n}\n\n

Response

The response will indicate whether the sign-in attempt was successful or not. The format of the response may vary based on the outcome of the authentication process.

Expected Response Format

On successful authentication, the response will include:
\n
- access (string): A token that grants access to the user's account and can be used for subsequent requests.
  \n
- refresh (string): A token that can be used to obtain a new access token once the current one expires.
  \n
\n
On failure, the response may include:
\n
- An error message detailing the reason for the failure (e.g., invalid credentials).
\n

Additional Notes

Ensure that the request body is correctly formatted and all required fields are included to receive the desired response. Proper handling of the tokens received in response is essential for maintaining user sessions and security.

\n","urlObject":{"protocol":"https","path":["signin",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"838623ac-a2af-4335-9576-47be43fa934e"},{"name":"create a new journal","id":"6bf464d3-4d09-4e7f-972e-1be14b73cc7f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"title\":\"My last entry\",\r\n \"content\": \"Today i saw a cute dog, he wassss soooo cute but i was sacred of him funny huh ;0 \"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cozypages.onrender.com/journals/","description":"

Create Journal Entry

This endpoint allows users to create a new journal entry. By sending a POST request to the /journals/ endpoint, users can submit their journal data, which includes a title and content for the entry.

Request

Method

POST

URL

https://cozypages.onrender.com/journals/

Request Body

The request body must be in JSON format and should include the following parameters:

title (string): The title of the journal entry.
\n
content (string): The main content or body of the journal entry.
\n

Example Request Body:

{\n  \"title\": \"My last entry\",\n  \"content\": \"Today I saw a cute dog, he was ...\"\n}\n\n

Response

Upon successful creation of a journal entry, the API will respond with a status code of 201 Created. The response will contain the following structure:

message (string): A message indicating the result of the operation (may be empty).
\n
data (object): An object containing details of the created journal entry:
\n
- id (integer): The unique identifier for the journal entry.
  \n
- title (string): The title of the journal entry as provided in the request.
  \n
- content (string): The content of the journal entry as provided in the request.
  \n
- created_at (string): Timestamp indicating when the journal entry was created.
  \n
- updated_at (string): Timestamp indicating when the journal entry was last updated.
  \n
\n

Example Response:

{\n  \"message\": \"\",\n  \"data\": {\n    \"id\": 0,\n    \"title\": \"My last entry\",\n    \"content\": \"Today i saw a cute dog, he wassss soooo cute but i was sacred of him funny huh ;0\",\n    \"created_at\": \"2025-08-09T07:47:46.318274Z\",\n    \"updated_at\": \"2025-08-09T07:47:46.318303Z\"\n  }\n}\n\n

Summary

This endpoint is essential for users looking to document their thoughts and experiences through journal entries. By providing a title and content, users can create personalized entries that are stored and retrievable for future reference.

\n","urlObject":{"protocol":"https","path":["journals",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"6bf464d3-4d09-4e7f-972e-1be14b73cc7f"},{"name":"list all your journals","id":"4133a73c-f421-46f1-b58a-1e1b75f26c36","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://cozypages.onrender.com/journals/","description":"

Get Journals

This endpoint retrieves a list of journals from the CozyPages application. It is a simple HTTP GET request that does not require any request parameters.

Request

Method: GET
\n
URL: https://cozypages.onrender.com/journals/
\n

Response

Upon a successful request, the API will return a JSON object with the following structure:

Status Code: 200
\n
Content-Type: application/json
\n
Response Body:
\n
- message: A string that may contain any additional information or status messages (currently empty).
  \n
- data: An array of journal objects, each containing:
  \n
  - id: A unique identifier for the journal.
    \n
  - title: The title of the journal.
    \n
  - content: The content of the journal.
    \n
  - created_at: The timestamp when the journal was created.
    \n
  - updated_at: The timestamp when the journal was last updated.
    \n
  \n
\n

Notes

The data array may contain multiple journal objects, depending on the entries available in the system.
\n
If there are no journals available, the data array will be empty.
\n
Ensure that the request is made to the correct endpoint to receive the expected response.
\n

\n","urlObject":{"protocol":"https","path":["journals",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"4133a73c-f421-46f1-b58a-1e1b75f26c36"},{"name":"retrieve one journal by ID","id":"0ae72547-079f-4f83-a57d-a19bf6c885ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://cozypages.onrender.com/journals/1","description":"

Get Journal Entry by ID

This endpoint retrieves a specific journal entry based on the provided ID. It is useful for fetching detailed information about a journal entry, including its title, content, and timestamps.

Request

Method: GET
\n
Endpoint: https://cozypages.onrender.com/journals/{id}
\n

Path Parameters

id (integer): The unique identifier of the journal entry you wish to retrieve. In this example, the ID is 1.

Response

Upon a successful request, the server responds with a status code of 200 and a JSON object containing the journal entry details.

Response Structure

{\n  \"message\": \"\",\n  \"data\": {\n    \"id\": 0,\n    \"title\": \"\",\n    \"content\": \"\",\n    \"created_at\": \"\",\n    \"updated_at\": \"\"\n  }\n}\n\n

Fields in Response

message (string): A message from the server, which may be empty if the request is successful.
\n
data (object): Contains the details of the journal entry.
\n
- id (integer): The unique identifier of the journal entry.
  \n
- title (string): The title of the journal entry.
  \n
- content (string): The content of the journal entry.
  \n
- created_at (string): The timestamp when the journal entry was created.
  \n
- updated_at (string): The timestamp when the journal entry was last updated.
  \n
\n

Example

Request

GET https://cozypages.onrender.com/journals/1\n\n

Response

{\n  \"message\": \"\",\n  \"data\": {\n    \"id\": 1,\n    \"title\": \"My First Journal Entry\",\n    \"content\": \"This is the content of my first journal entry.\",\n    \"created_at\": \"2023-01-01T12:00:00Z\",\n    \"updated_at\": \"2023-01-02T12:00:00Z\"\n  }\n}\n\n

Notes

Ensure that the ID provided in the request corresponds to an existing journal entry to receive a valid response.
\n
If the journal entry does not exist, the server may return a different status code and message indicating the error.
\n

\n","urlObject":{"protocol":"https","path":["journals","1"],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"0ae72547-079f-4f83-a57d-a19bf6c885ea"},{"name":"update a journal by ID","id":"569388fb-72f8-443e-8fb1-63c3346c9c2a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"title\": \"updated title\",\r\n \"content\": \"updated content\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cozypages.onrender.com/journals/5/update/","description":"

Update Journal Entry

This endpoint allows you to update an existing journal entry by providing the journal's ID in the URL. The request must include the updated title and content of the journal entry.

Request

Method: PUT
URL: https://cozypages.onrender.com/journals/{id}/update/
Replace {id} with the ID of the journal entry you wish to update.

Request Body

The request body must be in JSON format and include the following parameters:

title (string): The new title for the journal entry.
\n
content (string): The updated content of the journal entry.
\n

Example Request Body

{\n  \"title\": \"updated title\",\n  \"content\": \"updated content\"\n}\n\n

Response

On a successful update, the API returns a response with a status code of 200 and the following structure:

message (string): A message indicating the result of the request (may be empty).
\n
data (object): An object containing the updated journal entry details:
\n
id (integer): The ID of the updated journal entry.
\n
title (string): The updated title of the journal entry.
\n
content (string): The updated content of the journal entry.
\n
created_at (string): The timestamp of when the journal entry was created.
\n
updated_at (string): The timestamp of when the journal entry was last updated.
\n

Example Response

{\n  \"message\": \"\",\n  \"data\": {\n    \"id\": 0,\n    \"title\": \"\",\n    \"content\": \"\",\n    \"created_at\": \"\",\n    \"updated_at\": \"\"\n  }\n}\n\n

Notes

Ensure that the journal ID in the URL corresponds to an existing journal entry.
\n
The title and content fields should not be empty.
\n
This endpoint is intended for updating existing entries only; to create a new journal entry, use the appropriate POST endpoint.
\n

\n","urlObject":{"protocol":"https","path":["journals","5","update",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"569388fb-72f8-443e-8fb1-63c3346c9c2a"},{"name":"delete a journal by ID","id":"ea19e29b-3eeb-423d-808b-4c146dd66d72","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[],"url":"https://cozypages.onrender.com/journals/5/delete/","description":"

DELETE Journal Entry

This endpoint allows users to delete a specific journal entry identified by its unique ID. By sending a DELETE request to this endpoint, the user can remove the journal entry from the system permanently.

Request

Method: DELETE
\n
URL: https://cozypages.onrender.com/journals/{id}/delete/
\n

Path Parameter:

id (required): The unique identifier of the journal entry that you wish to delete. This should be a valid integer corresponding to the journal entry you want to remove.

Response

Upon successful deletion of the journal entry, the API will return a response indicating the outcome of the operation. The structure of the response includes:

status: A message indicating the success of the delete operation.(204 No Content)
\n
If it fails
\n

{ \"detail\": \"No Journals matches the given query.\"}

\n","urlObject":{"protocol":"https","path":["journals","5","delete",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"ea19e29b-3eeb-423d-808b-4c146dd66d72"},{"name":"Refresh Access Token","id":"e49b58d7-21ce-4ba0-8faa-e54bc280f52a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"refresh\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTc1NDgxMzM3NSwiaWF0IjoxNzU0NzI2OTc1LCJqdGkiOiJiNjk4OWMyYTFlZDQ0ZTQ4OWZjZmMxMjM4OGM3NDVkZiIsInVzZXJfaWQiOjF9.IOmA0XYZChiii_D5nQAozlgJjTFUBbzKVd6Tl1corUY\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cozypages.onrender.com/token/refresh/","description":"

Refresh Token Endpoint

This endpoint is used to refresh an existing access token using a valid refresh token. It allows clients to obtain a new access token without requiring the user to log in again, thereby enhancing user experience and maintaining session continuity.

Request

Method: POST
\n
Endpoint: https://cozypages.onrender.com/token/refresh/
\n

Request Body

The request must include a JSON payload with the following parameter:

refresh (string): The refresh token that is used to generate a new access token. This token must be valid and not expired.

Example Request Body:

{\n  \"refresh\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6Ik ...\"\n}\n\n

Response

Upon successful processing of the request, the server will respond with a status of 200 and the expected response format is typically JSON, containing the following keys:

access (string): The newly generated access token.
\n
refresh (string): The refresh token that can be used for future requests.
\n

Example Response:

{\n  \"access\": \"\",\n  \"refresh\": \"\"\n}\n\n

Notes

Ensure that the refresh token is valid and has not expired to receive a new access token.
\n
The response will only include the new access token and refresh token if the refresh token is valid.
\n

\n","urlObject":{"protocol":"https","path":["token","refresh",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"e49b58d7-21ce-4ba0-8faa-e54bc280f52a"},{"name":"journal search","id":"e657a58a-5769-420a-b82a-dcd58d21049d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://cozypages.onrender.com/journals/search/last/","description":"

Endpoint Description

This endpoint retrieves the most recent journal entries from the CozyPages application. It is designed to provide users with quick access to the latest journal content, facilitating easy tracking of updates and new entries.

Request

Method: GET
\n
URL: https://cozypages.onrender.com/journals/search/last/
\n

Response

Status Code: 200 OK
\n
Content-Type: application/json
\n

Response Structure

The response will return a JSON object containing the following fields:

message: A string that may contain any additional information or error messages (currently empty).
\n
data: An array of journal entries, where each entry includes:
\n
- id: A unique identifier for the journal entry (integer).
  \n
- title: The title of the journal entry (string).
  \n
- content: The content of the journal entry (string).
  \n
- created_at: The timestamp indicating when the journal entry was created (string).
  \n
- updated_at: The timestamp indicating when the journal entry was last updated (string).
  \n
\n

Example Response

{\n  \"message\": \"\",\n  \"data\": [\n    {\n      \"id\": 0,\n      \"title\": \"\",\n      \"content\": \"\",\n      \"created_at\": \"\",\n      \"updated_at\": \"\"\n    }\n  ]\n}\n\n

This structure allows clients to easily parse and utilize the latest journal entries for display or further processing.

\n","urlObject":{"protocol":"https","path":["journals","search","last",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"e657a58a-5769-420a-b82a-dcd58d21049d"},{"name":"Journals summary","id":"b68fa4bc-ad70-43da-a4b8-d57a4c7f73c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"text\": \"Today I walked in the park and reflected on my week. It was peaceful. Oh and i met this cute dog he is so cuteeeeeeeeeeee\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://cozypages.onrender.com/journals/summary/","description":"

Endpoint Description

This endpoint allows users to generate a summary of a provided text input. By sending a POST request to https://cozypages.onrender.com/journals/summary/, users can receive a concise summary of their text.

Request

Method: POST
\n
URL: https://cozypages.onrender.com/journals/summary/
\n
Request Body Format: The request must include a JSON object with the following structure:
\n

{\n  \"text\": \"string\"\n}\n\n

Parameters:
\n
- text (string): The text that you want to summarize. This should be a descriptive passage or content that you wish to condense.
\n

Response

Status Code: 200
\n
Content-Type: application/json
\n
Response Structure: The response will be a JSON object that includes the summary of the provided text in the following format:
\n

{\n  \"summary\": \"string\"\n}\n\n

Parameters:
\n
- summary (string): This field contains the generated summary of the input text. If the summarization process does not yield a result, this field may be empty.
\n

Example

Request:

{\n  \"text\": \"Today I walked in the park and ...\"\n}\n\n

Response:

{\n  \"summary\": \"\"\n}\n\n

This endpoint is useful for users looking to quickly distill longer texts into shorter summaries for easier consumption or review.

\n","urlObject":{"protocol":"https","path":["journals","summary",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b68fa4bc-ad70-43da-a4b8-d57a4c7f73c0"},{"name":"logout(Blacklist Refresh Token)","id":"110adf16-dbb8-4b9f-8d76-d8359b04f9b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"refresh\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTc1NDgxMzk2OSwiaWF0IjoxNzU0NzI3NTY5LCJqdGkiOiJlN2IxMDdlNWM3MjM0YTY5YWE4YzI1NWUwNjU4ODExZSIsInVzZXJfaWQiOjF9.p3xqmuEW_W74u9_SrrgnJ9usbygEuPXt8ZmGD5nRgs8\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://cozypages.onrender.com/logout/","description":"

Logout Endpoint

This endpoint allows users to log out of their session by invalidating their refresh token.

Request

Method: POST
\n
URL: https://cozypages.onrender.com/logout/
\n
Request Body: The request must include a JSON payload with the following parameter:
\n
- refresh (string): The refresh token used to authenticate the session that is to be terminated.
\n

Example Request Body

{\n  \"refresh\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6Ik ...\"\n}\n\n

Response

Status Code: 205 (Reset Content)
\n
Content-Type: application/json
\n
Response Body: The response will contain a JSON object with a message key:
\n
- message (string): This will be an empty string indicating that the logout action was successful.
  \n
- {
  \"message\": \"Logged out successfully\"
  }
  \n
\n

Notes

Ensure that the refresh token provided is valid; otherwise, the logout may not be processed correctly.
\n
A successful logout will invalidate the refresh token, and the user will need to log in again to obtain a new token.
\n

\n","urlObject":{"protocol":"https","path":["logout",""],"host":["cozypages","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"110adf16-dbb8-4b9f-8d76-d8359b04f9b9"}]}

Signup Endpoint

Request

Request Body Parameters

Expected Response

Notes

Sign In API

Request

Request Body

Response

Expected Response Format

Additional Notes

Create Journal Entry

Request

Method

URL

Request Body

Response

Summary

Get Journals

Request

Response

Notes

Get Journal Entry by ID

Request

Path Parameters

Response

Response Structure

Fields in Response

Example

Request

Response

Notes

Update Journal Entry

Request

Request Body

Example Request Body

Response

Example Response

Notes

DELETE Journal Entry

Request

Response

Refresh Token Endpoint

Request

Request Body

Response

Notes

Endpoint Description

Request

Response

Response Structure

Example Response

Endpoint Description

Request

Response

Example

Logout Endpoint

Request

Example Request Body

Response

Notes