Skip to main content
GET
/
projects
List all projects
curl --request GET \
  --url https://versuno.ai/api/public/projects \
  --header 'Authorization: Bearer <token>'
[
  {
    "name": "Customer Support Prompts",
    "userId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "description": "All prompts used in our customer support workflows",
    "emoji": "📁",
    "parentProjectId": null,
    "teamId": null,
    "createdAt": "2026-01-10T09:00:00.000Z"
  }
]

Authorizations

​
Authorization
string
header
default:uk_live_your_api_key_here
required

Versuno API key. Format: uk_live_...

Query Parameters

​
teamId
string<uuid>

Filter projects belonging to a specific team.

​
projectIds
string

Comma-separated UUIDs to fetch (max 100).

Response

Array of project objects.

​
name
string
required

Display name of the project.

Example:

"Customer Support Prompts"

​
userId
string<uuid>
required

ID of the user who owns this project.

Example:

"b2c3d4e5-f6a7-8901-bcde-f12345678901"

​
id
string<uuid>

Unique identifier for the project.

Example:

"c3d4e5f6-a7b8-9012-cdef-123456789012"

​
description
string | null

Optional description of the project.

Example:

"All prompts used in our customer support workflows"

​
emoji
string | null

Single emoji icon for the project.

Example:

"📁"

​
parentProjectId
string<uuid> | null

ID of the parent project for nesting, or null for top-level.

Example:

null

​
teamId
string<uuid> | null

ID of the team workspace this project belongs to, or null for personal.

Example:

null

​
createdAt
string<date-time>

ISO 8601 timestamp when the project was created.

Example:

"2026-01-10T09:00:00.000Z"