Skip to main content
POST
/
projects
Create a project
curl --request POST \
  --url https://versuno.ai/api/public/projects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'
{
  "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_...

Body

application/json
​
name
string
required
​
description
string | null
​
emoji
string | null
​
parentProjectId
string<uuid> | null
​
teamId
string<uuid> | null

Response

Created project object.

A folder for organising assets and team workspaces.

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