---
title: "Create a project"
method: POST
path: "/api/preview/projects"
tags: ["project"]
---

# Create a project

`POST /api/preview/projects`

## Request body

- object
  - `color` string, nullable — Display color, six-digit hex (e.g. #a1b2c3).
  - `description` string — Optional long-form project description.
  - `name` string, required — Human-readable project name.
  - `organization_id` string, nullable — UUID v4 string
  - `slug` string — URL-safe lowercase slug
  - `visibility` 'self' | 'org_view' | 'org_edit' — Sharing scope. `self`=private, `org_*`=shared in workspace.

## Response `201`

Successful response

- object
  - `capsule_count` integer
  - `capsules` object[]
  - `color` string, nullable
  - `content_bytes` integer, nullable
  - `created_at` string
  - `defaulted_type_count` integer
  - `description` string, nullable
  - `id` string, required — UUID v4 string
  - `name` string
  - `organization_id` string, nullable
  - `slug` string
  - `types` object[]
  - `updated_at` string
  - `user_id` string
  - `visibility` string
  - `workspace_id` string, nullable

---

[API](https://skmtc.net/symbol/apis/symbol-api.md) · [All operations](https://skmtc.net/symbol/apis/symbol-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/symbol/symbol-api/revisions/c690ac22ae04/schema)