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

# Create a project

`POST /api/projects`

## Request

- Base URL: `https://api.hostim.dev`
- URL: `https://api.hostim.dev/api/projects`
- Auth: HTTP bearer

Create a project gets a region as a query parameter and returns the project

## Query parameters

- `regionName` string, required
- `name` string, required

## Response `201`

Project created

- Project
  - `name` string: The project friendly name set by the user
  - `region` string: The project region
  - `id` string, required: The project id generated by the system
  - `allTimeCosts` number: The all time costs of the project
  - `projectedMonthlyCosts` number: The projected monthly costs of the project
  - `deployedServices` number: The number of deployed services
  - `sshKeys` string[], required: The SSH keys for the project
  - `createdAt` string, date-time: The timestamp when the project was created
  - `trialExpiresAt` string, date-time: The timestamp when the project trial expires
  - `accessLevel` 'owner' | 'maintainer': The current user's access level to this project

## Other responses

- `401`: User is not authorized
- `500`: Internal server error

---

[API](https://skmtc.dev/hostim/apis/hostim-api.md) · [All operations](https://skmtc.dev/hostim/apis/hostim-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hostim/apis/hostim-api/revisions/37c35e1026a9?raw)