--- title: "Changes to List projects" method: GET path: "/v1/projects" --- # Changes to List projects `GET /v1/projects` > Every recorded change to this operation, newest first. ## Timeline Changed in 10 of 30 revisions. - **2026-11-05** `247d08b1bc5b`: 3 info - **2026-09-18** `a83f0776a896`: 1 warning, 2 info - **2026-09-17** `63e95b862209`: 3 breaking, 1 info - **2026-09-16** `1eba97261efb`: 5 breaking, 2 warning, 3 info - **2026-09-15** `82dda6df74b8`: 46 breaking, 13 warning, 50 info - **2026-09-14** `8539cafd5cb6`: 4 warning, 7 info - **2026-09-11** `b19e0179b77a`: 1 info - **2026-09-11** `c7f67a5564ac`: 12 warning, 2 info - **2026-09-08** `365d100cf29a`: 1 info - **2026-09-01** `f80fa99514e8`: 1 warning, 1 info ## Changes - **2026-11-05** `247d08b1bc5b`: 3 info - added the new optional `query` request parameter `folder_id` - added the new optional `query` request parameter `is_in_folder` - added the required property `data/items/folder_id` to the response with the `200` status - **2026-09-18** `a83f0776a896`: 1 warning, 2 info - deleted the `query` request parameter `type` - for the `header` request parameter `Lovable-Version`, the format was generalized from `date` to no format - added the non-success response with the status `503` - **2026-09-17** `63e95b862209`: 3 breaking, 1 info - removed the enum value `false` from the `query` request parameter `is_published` - removed the enum value `true` from the `query` request parameter `is_published` - for the `query` request parameter `is_published`, the type changed from `string` to `boolean` - added the non-success response with the status `404` - **2026-09-16** `1eba97261efb`: 5 breaking, 2 warning, 3 info - for the `query` request parameter `workspace_id`, the minItems was increased from `0` to `1` - for the `query` request parameter `visibility`, the type changed from `string` to `array, null` - removed the required property `data/items/creation_status` from the response with the `200` status - removed the required property `data/items/folder_id` from the response with the `200` status - removed the required property `data/items/og_image_url` from the response with the `200` status - deleted the `query` request parameter `folder_id` - deleted the `query` request parameter `publish_status` - added the new optional `query` request parameter `is_published` - added the new optional `query` request parameter `publish_audience` - for the `query` request parameter `workspace_id`, the type was generalized from `string` to `array` - **2026-09-15** `82dda6df74b8`: 46 breaking, 13 warning, 50 info - removed the enum value `` from the `query` request parameter `type` - removed the enum value `all` from the `query` request parameter `type` - removed the enum value `all` from the `query` request parameter `visibility` - removed the enum value `any` from the `query` request parameter `publish_status` - removed the enum value `external` from the `query` request parameter `publish_status` - removed the enum value `internal` from the `query` request parameter `publish_status` - removed the enum value `personal` from the `query` request parameter `visibility` - removed the enum value `public` from the `query` request parameter `visibility` - removed the enum value `workspace` from the `query` request parameter `visibility` - the response property `data/items/created_at` became nullable for the status `200` - the response property `data/items/description` became nullable for the status `200` - the response property `data/items/folder_id` became nullable for the status `200` - the response property `data/items/last_edited_at` became nullable for the status `200` - the response property `data/items/latest_screenshot_url` became nullable for the status `200` - the response property `data/items/name` became nullable for the status `200` - the response property `data/items/og_image_url` became nullable for the status `200` - the response property `data/items/publish_audience` became nullable for the status `200` - the response property `data/items/visibility` became nullable for the status `200` - the response property `detail` became nullable for the status `400` - the response property `detail` became nullable for the status `401` - the response property `detail` became nullable for the status `402` - the response property `detail` became nullable for the status `403` - the response property `detail` became nullable for the status `406` - the response property `detail` became nullable for the status `429` - the response property `detail` became nullable for the status `default` - the response property `errors` became nullable for the status `400` - the response property `errors` became nullable for the status `401` - the response property `errors` became nullable for the status `402` - the response property `errors` became nullable for the status `403` - the response property `errors` became nullable for the status `406` - the response property `errors` became nullable for the status `429` - the response property `errors` became nullable for the status `default` - the response property `errors/items/location` became nullable for the status `400` - the response property `errors/items/location` became nullable for the status `401` - the response property `errors/items/location` became nullable for the status `402` - the response property `errors/items/location` became nullable for the status `403` - the response property `errors/items/location` became nullable for the status `406` - the response property `errors/items/location` became nullable for the status `429` - the response property `errors/items/location` became nullable for the status `default` - the response property `props` became nullable for the status `400` - …69 more - **2026-09-14** `8539cafd5cb6`: 4 warning, 7 info - deleted the `query` request parameter `folder_ids` - deleted the `query` request parameter `search_fields` - removed the optional property `data/items/tech_stack` from the response with the `200` status - removed the optional property `data/items/updated_at` from the response with the `200` status - the endpoint scheme security `BearerAuth` was added to the API - the endpoint scheme security `LovableAPIKey` was added to the API - added the new enum value `public` to the `query` request parameter `publish_status` - added the new enum value `workspace` to the `query` request parameter `publish_status` - added the non-success response with the status `400` - added the optional property `data/items/publish_audience` to the response with the `200` status - response property `data/items/publish_visibility` deprecated - **2026-09-11** `b19e0179b77a`: 1 info - api operation id `get-v1-projects` removed and replaced with `listProjects` - **2026-09-11** `c7f67a5564ac`: 12 warning, 2 info - added the new `completed` enum value to the `data/items/status` response property for the response status `200` - added the new `draft` enum value to the `data/items/visibility` response property for the response status `200` - added the new `failed` enum value to the `data/items/status` response property for the response status `200` - added the new `in_progress` enum value to the `data/items/status` response property for the response status `200` - added the new `library` enum value to the `data/items/project_type` response property for the response status `200` - added the new `private` enum value to the `data/items/publish_visibility` response property for the response status `200` - added the new `private` enum value to the `data/items/visibility` response property for the response status `200` - added the new `project` enum value to the `data/items/project_type` response property for the response status `200` - added the new `public` enum value to the `data/items/publish_visibility` response property for the response status `200` - added the new `public` enum value to the `data/items/visibility` response property for the response status `200` - added the new `workspace_only` enum value to the `data/items/publish_visibility` response property for the response status `200` - added the new `workspace_view` enum value to the `data/items/visibility` response property for the response status `200` - added the new optional `header` request parameter `Lovable-Beta` - added the new optional `header` request parameter `Lovable-Version` - **2026-09-08** `365d100cf29a`: 1 info - added the non-success response with the status `402` - **2026-09-01** `f80fa99514e8`: 1 warning, 1 info - deleted the `query` request parameter `q` - added the new optional `query` request parameter `query` --- [Operation](https://skmtc.dev/lovable/apis/lovable-api/docs/v1/projects/get.md) - [API](https://skmtc.dev/lovable/apis/lovable-api.md) - [Page](https://skmtc.dev/lovable/apis/lovable-api/changes/v1/projects/get)