---
title: "Create New Project"
method: POST
path: "/api/v1/projects"
tags: ["Projects"]
---

# Create New Project

`POST /api/v1/projects`

## Request

- Base URL: `https://api.akkio.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.akkio.com/api/v1/projects`
- Auth: none declared

Creates a new project.

## Request body

- CreateProjectPayload
  - `_owner` string, required: Foreign key to the user this object belongs to.
  - `_org` string, required: Foreign key to the organization this object belongs to.
  - `name` string, required: The name of the flow.
  - `chatInstructions` string: How would you like Chat Explore to respond? For example: - Respond only in spanish - Provide short and concise answers only - Make sure to always include a chart
  - `chatContext` string: What would you like Chat Explore to know about this application to provide better responses? For example: - This dataset is customer engagement data - The units of the sales column are in millions - The data is messy and contains typos
  - `chatSuggestions` string: Customize the default chat suggestions by writing a list of suggestions separated by newlines. For example: - What is the average net media cost by campaign ID? - Make sure to always include a chart

## Response `200`

Successful Response

- GetProjectResponse
  - `id` string, required: The ID of this object.
  - `name` string: The name of the flow.
  - `chatInstructions` string: How would you like Chat Explore to respond? For example: - Respond only in spanish - Provide short and concise answers only - Make sure to always include a chart
  - `chatContext` string: What would you like Chat Explore to know about this application to provide better responses? For example: - This dataset is customer engagement data - The units of the sales column are in millions - The data is messy and contains typos
  - `chatSuggestions` string: Customize the default chat suggestions by writing a list of suggestions separated by newlines. For example: - What is the average net media cost by campaign ID? - Make sure to always include a chart

## Other responses

- `422`: Validation Error

---

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