Update project
You can update a Lovable project's name or sharing settings programmatically through the REST API. This feature requires a Business plan or higher and does not let you edit the AI-generated project description.
Workspace administrators on a Business plan or higher who need to automate project renaming or sharing settings.
Do this, in order
- 1
Create an API key with the projects:write scope in your workspace settings at lovable.dev/settings/api-keys.
This endpoint requires write permissions for projects or it will reject the request with a permission error.
- 2
Send an HTTP PATCH request to https://api.lovable.dev/v1/projects/prj_01jw3k9m2xq8r5v0c7d4e6f2gh with your API key in the Authorization header and your updated name or sharing settings in the JSON body.
Any fields you omit will keep their existing values, updating only what you provide.
- 3
Confirm you receive an HTTP 200 OK response containing the updated project object.
This verifies that your project updates have been accepted and applied.
Paste this into your project
Create an admin tool component with an input field to update a Lovable project name by sending an HTTP PATCH request to https://api.lovable.dev/v1/projects/prj_01jw3k9m2xq8r5v0c7d4e6f2gh with the Authorization header and a JSON body containing the new name.
Words decoded
- PATCH
- A web request method used to change specific details of an existing item without overwriting the whole thing.
- Scope
- A specific permission attached to an API key that dictates what actions it is allowed to perform.
- Endpoint
- A specific web address where an API receives requests and performs actions.
Where people get stuck
- Do not attempt to update the project description here; it is automatically created by the AI agent and cannot be edited via this endpoint.
- Do not use this endpoint to modify access to your published application; you must use the separate publish endpoint for that.
- Changes may not show up immediately in project listings because read operations are eventually consistent.
The short version, steps, decoder and prompt on this page are written automatically from Lovable's own documentation and can lag or misread it. The official page is always the authority.