{"openapi":"3.1.0","info":{"title":"Personal Lifecycle Tracker API","description":"Production REST API for Personal Lifecycle Tracker. Manages Renewals, Maintenance, and Warranties for independent users and shared groups, including action summaries and scheduled daily morning email digests.","version":"1.0.0"},"paths":{"/health":{"get":{"tags":["health"],"summary":"Get Health","operationId":"get_health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthStatus"}}}}}}},"/api/v1/auth/signup":{"post":{"tags":["auth"],"summary":"Signup","operationId":"signup_api_v1_auth_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/login":{"post":{"tags":["auth"],"summary":"Login","operationId":"login_api_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/me":{"get":{"tags":["auth"],"summary":"Get Me","operationId":"get_me_api_v1_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","operationId":"logout_api_v1_auth_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}}}}},"/api/v1/users":{"get":{"tags":["users"],"summary":"List Users","operationId":"list_users_api_v1_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/User"},"type":"array","title":"Response List Users Api V1 Users Get"}}}}}}},"/api/v1/users/{userId}":{"delete":{"tags":["users"],"summary":"Delete User","operationId":"delete_user_api_v1_users__userId__delete","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","title":"Userid"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/items":{"get":{"tags":["items"],"summary":"List Items","operationId":"list_items_api_v1_items_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"groupId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by groupId ('null' for personal items)","title":"Groupid"},"description":"Filter by groupId ('null' for personal items)"},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/LifecycleType"},{"type":"null"}],"description":"Filter by lifecycle type","title":"Type"},"description":"Filter by lifecycle type"},{"name":"searchQuery","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search query string","title":"Searchquery"},"description":"Search query string"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LifecycleItem"},"title":"Response List Items Api V1 Items Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["items"],"summary":"Create Item","operationId":"create_item_api_v1_items_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateItemDTO"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifecycleItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/items/{id}":{"get":{"tags":["items"],"summary":"Get Item","operationId":"get_item_api_v1_items__id__get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifecycleItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["items"],"summary":"Update Item","operationId":"update_item_api_v1_items__id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateItemDTO"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifecycleItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["items"],"summary":"Delete Item","operationId":"delete_item_api_v1_items__id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/items/{id}/complete":{"post":{"tags":["items"],"summary":"Toggle Complete","operationId":"toggle_complete_api_v1_items__id__complete_post","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifecycleItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/groups":{"get":{"tags":["groups"],"summary":"List Groups","operationId":"list_groups_api_v1_groups_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Group"},"type":"array","title":"Response List Groups Api V1 Groups Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["groups"],"summary":"Create Group","operationId":"create_group_api_v1_groups_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGroupRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Group"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/groups/{id}":{"get":{"tags":["groups"],"summary":"Get Group","operationId":"get_group_api_v1_groups__id__get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Group"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["groups"],"summary":"Delete Group","operationId":"delete_group_api_v1_groups__id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/groups/{groupId}/members":{"post":{"tags":["groups"],"summary":"Add Member","operationId":"add_member_api_v1_groups__groupId__members_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","title":"Groupid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddMemberRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Group"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/groups/{groupId}/members/{memberEmail}":{"delete":{"tags":["groups"],"summary":"Remove Member","operationId":"remove_member_api_v1_groups__groupId__members__memberEmail__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","title":"Groupid"}},{"name":"memberEmail","in":"path","required":true,"schema":{"type":"string","title":"Memberemail"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Group"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/groups/{groupId}/leave":{"post":{"tags":["groups"],"summary":"Leave Group","operationId":"leave_group_api_v1_groups__groupId__leave_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","title":"Groupid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/reminders/summary":{"get":{"tags":["reminders"],"summary":"Get Summary","operationId":"get_summary_api_v1_reminders_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemindersSummary"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/reminders/digest/config":{"get":{"tags":["reminders"],"summary":"Get Digest Config","operationId":"get_digest_config_api_v1_reminders_digest_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyDigestConfig"}}}}}},"patch":{"tags":["reminders"],"summary":"Update Digest Config","operationId":"update_digest_config_api_v1_reminders_digest_config_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDigestConfigRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyDigestConfig"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/reminders/digest/generate":{"post":{"tags":["reminders"],"summary":"Generate Digest","operationId":"generate_digest_api_v1_reminders_digest_generate_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/GenerateDigestRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyDigestEmail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/reminders/digest/history":{"get":{"tags":["reminders"],"summary":"Get Digest History","operationId":"get_digest_history_api_v1_reminders_digest_history_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DailyDigestEmail"},"type":"array","title":"Response Get Digest History Api V1 Reminders Digest History Get"}}}}}}},"/api/v1/dev/seed":{"post":{"tags":["dev"],"summary":"Reset Seed","operationId":"reset_seed_api_v1_dev_seed_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}}}}}},"components":{"schemas":{"AddMemberRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"AddMemberRequest"},"AuthResponse":{"properties":{"user":{"$ref":"#/components/schemas/User"},"token":{"type":"string","title":"Token"}},"type":"object","required":["user","token"],"title":"AuthResponse"},"CreateGroupRequest":{"properties":{"name":{"type":"string","title":"Name"}},"type":"object","required":["name"],"title":"CreateGroupRequest"},"CreateItemDTO":{"properties":{"name":{"type":"string","title":"Name"},"lifecycleType":{"$ref":"#/components/schemas/LifecycleType"},"dueDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duedate"},"status":{"anyOf":[{"$ref":"#/components/schemas/ItemStatus"},{"type":"null"}],"default":"active"},"groupId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groupid"}},"type":"object","required":["name","lifecycleType"],"title":"CreateItemDTO"},"DailyDigestConfig":{"properties":{"timeZone":{"type":"string","title":"Timezone","default":"UTC"},"deliveryTime":{"$ref":"#/components/schemas/DigestDeliveryTime","default":"08:00"},"enabled":{"type":"boolean","title":"Enabled","default":true}},"type":"object","title":"DailyDigestConfig"},"DailyDigestEmail":{"properties":{"id":{"type":"string","title":"Id"},"recipientEmail":{"type":"string","format":"email","title":"Recipientemail"},"recipientName":{"type":"string","title":"Recipientname"},"generatedAt":{"type":"string","title":"Generatedat"},"deliveryTime":{"$ref":"#/components/schemas/DigestDeliveryTime"},"timeZone":{"type":"string","title":"Timezone"},"subject":{"type":"string","title":"Subject"},"overdueCount":{"type":"integer","title":"Overduecount"},"upcomingCount":{"type":"integer","title":"Upcomingcount"},"overdueItems":{"items":{"$ref":"#/components/schemas/LifecycleItem"},"type":"array","title":"Overdueitems"},"upcomingItems":{"items":{"$ref":"#/components/schemas/LifecycleItem"},"type":"array","title":"Upcomingitems"},"htmlContent":{"type":"string","title":"Htmlcontent"},"textContent":{"type":"string","title":"Textcontent"}},"type":"object","required":["id","recipientEmail","recipientName","generatedAt","deliveryTime","timeZone","subject","overdueCount","upcomingCount","overdueItems","upcomingItems","htmlContent","textContent"],"title":"DailyDigestEmail"},"DigestDeliveryTime":{"type":"string","enum":["06:00","08:00","09:00","12:00"],"title":"DigestDeliveryTime"},"GenerateDigestRequest":{"properties":{"recipientEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Recipientemail"}},"type":"object","title":"GenerateDigestRequest"},"Group":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"ownerId":{"type":"string","title":"Ownerid"},"ownerEmail":{"type":"string","format":"email","title":"Owneremail"},"memberEmails":{"items":{"type":"string","format":"email"},"type":"array","title":"Memberemails"},"createdAt":{"type":"string","title":"Createdat"}},"type":"object","required":["id","name","ownerId","ownerEmail","memberEmails","createdAt"],"title":"Group"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthStatus":{"properties":{"status":{"type":"string","title":"Status","default":"healthy"},"database":{"type":"string","title":"Database","default":"connected"},"version":{"type":"string","title":"Version","default":"1.0.0"}},"type":"object","title":"HealthStatus"},"ItemStatus":{"type":"string","enum":["active","completed"],"title":"ItemStatus"},"LifecycleItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"lifecycleType":{"$ref":"#/components/schemas/LifecycleType"},"dueDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duedate"},"status":{"$ref":"#/components/schemas/ItemStatus"},"ownerId":{"type":"string","title":"Ownerid"},"ownerEmail":{"type":"string","format":"email","title":"Owneremail"},"groupId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groupid"},"groupName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groupname"},"createdAt":{"type":"string","title":"Createdat"},"updatedAt":{"type":"string","title":"Updatedat"}},"type":"object","required":["id","name","lifecycleType","status","ownerId","ownerEmail","createdAt","updatedAt"],"title":"LifecycleItem"},"LifecycleType":{"type":"string","enum":["renewal","maintenance","warranty"],"title":"LifecycleType"},"LoginRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"LoginRequest"},"MessageResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"MessageResponse"},"RemindersSummary":{"properties":{"overdue":{"items":{"$ref":"#/components/schemas/LifecycleItem"},"type":"array","title":"Overdue"},"upcoming":{"items":{"$ref":"#/components/schemas/LifecycleItem"},"type":"array","title":"Upcoming"},"totalActiveReminders":{"type":"integer","title":"Totalactivereminders"}},"type":"object","required":["overdue","upcoming","totalActiveReminders"],"title":"RemindersSummary"},"SignupRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","minLength":6,"title":"Password"},"name":{"type":"string","title":"Name"}},"type":"object","required":["email","password","name"],"title":"SignupRequest"},"UpdateDigestConfigRequest":{"properties":{"timeZone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"deliveryTime":{"anyOf":[{"$ref":"#/components/schemas/DigestDeliveryTime"},{"type":"null"}]},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"}},"type":"object","title":"UpdateDigestConfigRequest"},"UpdateItemDTO":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"lifecycleType":{"anyOf":[{"$ref":"#/components/schemas/LifecycleType"},{"type":"null"}]},"dueDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duedate"},"status":{"anyOf":[{"$ref":"#/components/schemas/ItemStatus"},{"type":"null"}]},"groupId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groupid"}},"type":"object","title":"UpdateItemDTO"},"User":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","format":"email","title":"Email"},"name":{"type":"string","title":"Name"},"createdAt":{"type":"string","title":"Createdat"}},"type":"object","required":["id","email","name","createdAt"],"title":"User"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}