This method allows authorized users to create a new project within their organization. Use this method to initialize workspaces for teams, departments, or specific goals.
The number in the URL path (/1/) is the organization identifier — referred to as account_id.
This value must match the account associated with the provided session_id.
This endpoint supports both:
GET https://api.doboard.com/42/project_add?name=Marketing&project_type=REGULAR&session_id=abc123xyz
In this example:
42 is the organization/account IDname=Marketing sets the title of the new projectproject_type=REGULAR sets it as a private/internal projectsession_id=abc123xyz is used for authenticationIf the account ID in the URL does not match the one tied to the session, the request will be rejected.
Required
The method is available to users with the following roles:
ADMINPROJECT_MANAGERGUEST and REGULAR users roles are not allowed.
Authentication is performed using a valid session_id.
Public access via token is not supported.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session_id |
string |
Yes | – | Authenticated user session ID |
name |
string |
Yes | – | Project name (max 128 characters) |
description |
string |
No | – | Optional project description (max 1024 characters) |
project_type |
string |
No | REGULAR |
Project type: REGULAR or PUBLIC |
auto_close_track |
int |
No | 1 |
Automatically closes boards inside the project when there are no open tasks (1 = enabled, 0 = disabled) |
status |
string |
No | ACTIVE |
Initial status: one of ACTIVE, ARCHIVE, TEMPLATE |
hostname |
string |
No | – | Optional domain name |
On success, the API returns the newly created project ID:
{
"data": {
"operation_status": "SUCCESS",
"project_id": 123
}
}
| HTTP Code | error_no |
Message | Description |
|---|---|---|---|
401 |
401 |
session_id Unknown |
Missing or invalid session_id |
200 |
3301 |
status must be in ('ACTIVE','ARCHIVE','TEMPLATE') |
Invalid status value provided |
200 |
3302 |
name is required |
Project name is missing or empty |
200 |
3303 |
project_type must be in ('REGULAR','PUBLIC') |
Invalid project_type value |
500 |
0 |
Internal API Error |
Internal error |
200 |
7 |
limit reached |
Too many session attempts from same IP |
| Role | Access |
|---|---|
ADMIN |
✅ Yes |
PROJECT_MANAGER |
✅ Yes |
REGULAR |
❌ No |
GUEST |
❌ No |