Update project

Update a project’s name or visibility. Returns the updated Project record.

PATCH /v1/projects/{id}

Update project

cURL

curl --request PATCH \
  --url https://api.vly.ai/v1/projects/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

200

{
  "id": "prj_01JFA8N3Z1B6Y2K7Q3X4M5R8",
  "name": "Tasks for teams",
  "agent": "claude-code",
  "visibility": "private",
  "created_at": "2023-11-07T05:31:56Z",
  "prompt": "<string>",
  "url": "https://tasks-for-teams.vly.app",
  "updated_at": "2023-11-07T05:31:56Z"
}

Partial update — pass only the fields you want to change.

Visibility changes take effect immediately. Setting visibility to public exposes the live preview URL to anyone with the link.

Authorizations

Authorization · string · header · required

Workspace-scoped API key. Generate from Workspace settings → API keys.

Path Parameters

id · string · required

Body

application/json

name · string

visibility · enum<string>

Available options: private, unlisted, public

Response

200 - application/json

OK

id · string · required

Example:

"prj_01JFA8N3Z1B6Y2K7Q3X4M5R8"

name · string · required

Example:

"Tasks for teams"

agent · enum<string> · required

Available options: claude-code, openai-codex, gemini-cli

visibility · enum<string> · required

Available options: private, unlisted, public

created_at · string<date-time> · required

prompt · string

url · string<uri>

Example:

"https://tasks-for-teams.vly.app"

updated_at · string<date-time>