api-quick-reference.md

API Quick Reference

Base URL

https://1707r6jcga.execute-api.us-east-1.amazonaws.com/dev

Endpoints

GET /tasks

List all tasks

curl https://1707r6jcga.execute-api.us-east-1.amazonaws.com/dev/tasks

POST /tasks

Create a new task

curl -X POST https://1707r6jcga.execute-api.us-east-1.amazonaws.com/dev/tasks \
  -H "Content-Type: application/json" \
  -d '{"title": "Task Title", "description": "Task Description"}'

DELETE /tasks/{id}

Delete a specific task

curl -X DELETE https://1707r6jcga.execute-api.us-east-1.amazonaws.com/dev/tasks/{task-id}

Request/Response Examples

Create Task

Request:

{
  "title": "Learn AWS Serverless",
  "description": "Build a serverless todo API"
}

Response:

{
  "task": {
    "id": "4ca1aee0-09cf-4486-82bb-a0710c08b426",
    "title": "Learn AWS Serverless",
    "description": "Build a serverless todo API",
    "completed": false,
    "created_at": "2025-08-23T11:05:09.335843",
    "updated_at": "2025-08-23T11:05:09.335843"
  }
}

List Tasks

Response:

{
  "tasks": [
    {
      "id": "4ca1aee0-09cf-4486-82bb-a0710c08b426",
      "title": "Learn AWS Serverless",
      "description": "Build a serverless todo API",
      "completed": false,
      "created_at": "2025-08-23T11:05:09.335843",
      "updated_at": "2025-08-23T11:05:09.335843"
    }
  ]
}

Delete Task

Response:

{
  "message": "Task deleted successfully"
}

Error Responses

400 Bad Request

{
  "error": "Title is required"
}

404 Not Found

{
  "error": "Task not found"
}

500 Internal Server Error

{
  "error": "Internal server error"
}

Status Codes

Code	Description
200	Success (GET, DELETE)
201	Created (POST)
400	Bad Request
404	Not Found
500	Internal Server Error

Headers

Request Headers

• Content-Type: application/json (required for POST)

Response Headers

• Content-Type: application/json
• Access-Control-Allow-Origin: *
• Access-Control-Allow-Headers: Content-Type
• Access-Control-Allow-Methods: GET,POST,DELETE,OPTIONS