프로젝트 생성 Tier 3

POST/api/projectsCopied!

API 키에 바인딩된 워크스페이스에 프로젝트를 생성합니다.

예시

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

요청

본문

namestringrequired

2-255 characters

프로젝트 이름

deadlinestringrequired

`YYYY-MM-DD` 형식의 마감일

Example: 2026-06-30

descriptionstring

1-1000 characters

프로젝트 설명

membersarray

추가할 프로젝트 멤버

members[].userobjectrequired

프로젝트 멤버 사용자

members[].user.idstringrequired

사용자 ID

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

members[].rolestringrequired

프로젝트 역할

Possible values: PROJECT_MANAGERPROJECT_MEMBERPROJECT_REVIEWERPROJECT_RESTRICTED_REVIEWER

Example: PROJECT_MANAGER

accessRangestringrequired

프로젝트 접근 범위

Possible values: ONLY_PROJECT_MEMBERALLOW_WORKSPACE_MEMBER

Example: ALLOW_WORKSPACE_MEMBER

응답

201 Created를 반환합니다.

dataobject

생성된 프로젝트

data.idstring

생성된 프로젝트 ID

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