# Create an API project

**Category:** [API Hub](https://help.totalctrl.app/hc/totalctrl/totalctrl-help-center/en-US/categories/apidocs)
**Updated:** 2026-08-19

## Start a new project

A project represents a single API product. From the API Hub project list, click **New Project** and fill in:

- **Name** (required) — used everywhere and turned into a URL slug automatically.
- **Description** — a short summary shown on the portal home page.
- **Visibility** — toggle **Public** to make the developer portal reachable at `/apihub/<slug>/`. Leave it off to keep the project private to your team.
- **Primary color** — the brand accent color for your portal (defaults to a blue).

When you save, API Hub generates a globally unique slug from the name (so portal URLs are unambiguous across all tenants) and takes you to the project detail page.
## Editing later

You can change any of these fields at any time from **Edit** or from the project **Settings** page. Note that renaming a project re-derives its slug, which changes its public URL.
## Next steps

An empty project has nothing to show yet. The next thing to do is add a version and attach a spec — see [Add a version and upload a spec](add-a-version-and-upload-a-spec). Once a version has a spec you can [generate SDKs](generate-client-sdks) and [publish your portal](publish-a-developer-portal).
## Deleting a project

Deleting a project removes all of its versions, specs, and SDK builds. This cannot be undone, so deprecate versions instead if you only want to retire them.

---

## Related Articles

- [API Hub overview](https://help.totalctrl.app/en-US/articles/api-hub-overview)
- [Generate client SDKs](https://help.totalctrl.app/en-US/articles/generate-client-sdks)
- [Add a version and upload a spec](https://help.totalctrl.app/en-US/articles/add-a-version-and-upload-a-spec)
- [Publish a developer portal](https://help.totalctrl.app/en-US/articles/publish-a-developer-portal)
- [Sync a spec from GitHub](https://help.totalctrl.app/en-US/articles/sync-a-spec-from-github)

---
[← Back to TotalCtrl Help Center](https://help.totalctrl.app/en-US/)