Create Project Tier 3

POST/api/projectsCopied!

Creates a project in the workspace bound to the API key.

Example

SDK

const project = await client.projects.create({
  name: "Launch Campaign",
  deadline: "2026-06-30",
  description: "Social assets for Q4 launch",
  members: [
    {
      user: { id: "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff" },
      role: "PROJECT_MANAGER",
    },
  ],
  accessRange: "ALLOW_WORKSPACE_MEMBER",
});

CLI

youvico project create \
  --name "Launch Campaign" \
  --deadline 2026-06-30 \
  --description "Social assets for Q4 launch" \
  --access-range ALLOW_WORKSPACE_MEMBER \
  --member f6035d1a-29df-4d80-8d72-f1bbdddfb6ff:PROJECT_MANAGER

cURL

curl -X POST 'https://api.youvico.com/api/projects' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Launch Campaign", "deadline": "2026-06-30", "description": "Social assets for Q4 launch", "members": [{ "user": { "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff" }, "role": "PROJECT_MANAGER" }], "accessRange": "ALLOW_WORKSPACE_MEMBER" }'

{
  "data": {
    "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62"
  }
}

Request

Body

namestringrequired

2-255 characters

Project name

deadlinestringrequired

Deadline date in `YYYY-MM-DD` format

Example: 2026-06-30

descriptionstring

1-1000 characters

Project description

membersarray

Project members to add

members[].userobjectrequired

Project member user

members[].user.idstringrequired

User ID

Example: f6035d1a-29df-4d80-8d72-f1bbdddfb6ff

members[].rolestringrequired

Project role

Possible values: PROJECT_MANAGERPROJECT_MEMBERPROJECT_REVIEWERPROJECT_RESTRICTED_REVIEWER

Example: PROJECT_MANAGER

accessRangestringrequired

Project access range

Possible values: ONLY_PROJECT_MEMBERALLOW_WORKSPACE_MEMBER

Example: ALLOW_WORKSPACE_MEMBER

Response

Returns 201 Created.

dataobject

Created project

data.idstring

Created project ID

Example: bdbff5de-96d7-468f-9db0-85fe28bd6b62