{"slug":"folk-api","name":"folk API","host":"api.folk.app","site":"https://folk.app","category":"marketing","docsUrl":null,"sources":[{"kind":"changelog","url":"https://developer.folk.app/changelog"},{"kind":"openapi","url":"https://developer.folk.app/schemas/2025-06-09.json"}],"url":"https://www.okapi.bot/providers/folk-api/","json":"https://www.okapi.bot/api/v1/providers/folk-api.json","breakingChanges":[{"slug":"v1-reminders-stops-working","api":"folk-api","title":"/v1/reminders stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-08-13","effectiveAt":"2027-02-13","scope":null,"calls":["/v1/reminders"],"method":null,"path":"/v1/reminders","source":{"url":"https://developer.folk.app/changelog","kind":"archive"},"quote":"Reminders endpoints now return Deprecation / Sunset headers and will be removed on February 13, 2027.","migration":"Use the Tasks endpoints instead (GET and POST /v1/tasks), following folk's reminders-to-tasks migration guide.","migrationChange":null,"needsDecision":null,"text":{"summary":"On February 13, 2027, the /v1/reminders endpoint will be removed and calls to it will fail. The endpoint currently returns Deprecation and Sunset headers ahead of its shutdown. Any integration relying on this path will be affected after that date.","migration":"Use the Tasks endpoints instead, specifically GET and POST /v1/tasks, following folk's reminders-to-tasks migration guide.","by":"writer"},"publishedAt":"2026-10-23T10:15:42.620Z","updatedAt":"2026-10-23T14:23:38.576Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/folk-api/breaking-changes/v1-reminders-stops-working/"},{"slug":"v1-reminders-stops-working-2","api":"folk-api","title":"/v1/reminders/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-08-13","effectiveAt":"2027-02-13","scope":null,"calls":["/v1/reminders/{}"],"method":null,"path":"/v1/reminders/{}","source":{"url":"https://developer.folk.app/changelog","kind":"archive"},"quote":"Reminders endpoints now return Deprecation / Sunset headers and will be removed on February 13, 2027.","migration":"Use the Tasks endpoints instead (GET, PATCH and DELETE /v1/tasks/{taskId}), following folk's reminders-to-tasks migration guide.","migrationChange":null,"needsDecision":null,"text":{"summary":"On February 13, 2027, the /v1/reminders/{} endpoint will be removed and calls to it will fail. The folk API announced this change on August 13, 2026, noting that reminders endpoints now return Deprecation and Sunset headers ahead of their permanent shutdown.","migration":"Use the Tasks endpoints instead (GET, PATCH and DELETE /v1/tasks/{taskId}), following folk's reminders-to-tasks migration guide.","by":"writer"},"publishedAt":"2026-10-23T10:15:42.620Z","updatedAt":"2026-10-23T14:23:36.381Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/folk-api/breaking-changes/v1-reminders-stops-working-2/"},{"slug":"get-v1-interactions-past-stops-working","api":"folk-api","title":"GET /v1/interactions/past stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-09-29","effectiveAt":"2027-03-29","scope":null,"calls":["GET /v1/interactions/past"],"method":"GET","path":"/v1/interactions/past","source":{"url":"https://developer.folk.app/changelog","kind":"archive"},"quote":"List past interactions and List upcoming interactions are deprecated, now return Deprecation / Sunset headers and will be removed on March 29, 2027.","migration":"Call GET /v1/interactions with timeframe=past.","migrationChange":null,"needsDecision":null,"text":{"summary":"On March 29, 2027, the GET /v1/interactions/past endpoint will be removed and calls to it will fail. The endpoint has been deprecated alongside the upcoming interactions equivalent and currently returns deprecation headers. Requests sent to this route after the shutdown date will no longer work.","migration":"Call GET /v1/interactions with timeframe=past instead.","by":"writer"},"publishedAt":"2026-10-23T10:15:42.620Z","updatedAt":"2026-10-23T15:23:28.317Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/folk-api/breaking-changes/get-v1-interactions-past-stops-working/"},{"slug":"get-v1-interactions-upcoming-stops-working","api":"folk-api","title":"GET /v1/interactions/upcoming stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-09-29","effectiveAt":"2027-03-29","scope":null,"calls":["GET /v1/interactions/upcoming"],"method":"GET","path":"/v1/interactions/upcoming","source":{"url":"https://developer.folk.app/changelog","kind":"archive"},"quote":"List past interactions and List upcoming interactions are deprecated, now return Deprecation / Sunset headers and will be removed on March 29, 2027.","migration":"Call GET /v1/interactions with timeframe=upcoming.","migrationChange":null,"needsDecision":null,"text":{"summary":"On March 29, 2027, the folk API will remove the GET /v1/interactions/upcoming endpoint. Requests sent to this route after that date will fail. Calls to the endpoint currently return deprecation and sunset headers ahead of the shutdown.","migration":"Update requests to call GET /v1/interactions with timeframe=upcoming instead.","by":"writer"},"publishedAt":"2026-10-23T10:15:42.620Z","updatedAt":"2026-10-23T15:23:29.351Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/folk-api/breaking-changes/get-v1-interactions-upcoming-stops-working/"}]}