Get project

Returns a single project by ID.

GET /v1/projects/{id}

Get project

cURL

curl --request GET \
  --url https://api.vly.ai/v1/projects/{id} \
  --header 'Authorization: Bearer <token>'

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"
}

Returns the full Project record. To list deployments for a project, use POST /v1/projects/{id}/deployments (the same endpoint also creates them).

Authorizations

Authorization · string · header · required

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

Path Parameters

id · string · required

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>