Create project
POST/v2/orgs/:org_id/teams/:team_id/projects
Projects are essentially folders of boards with the option to manage user access for a smaller group of people within a team. Projects are here to help you organize your boards and make them easier to find and share. In other words, a project is a group of boards that you can share with your teammates all at once. For more information, see our Help Center page on Projects.
This API creates a new project in an existing team of an organization.
Required scope
projects:writeRate limiting
Level 1Enterprise only
This API is available only for Enterprise plan users. You can only use this endpoint if you have the role of a Company Admin. You can request temporary access to Enterprise APIs using this form.
Request
Path Parameters
The ID of the organization within which you you want to create a project.
The ID of the team within which you you want to create a project.
- application/json
Body
required
Project name
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 429
Contains information about the project, such as the project name.
- application/json
- Schema
- Example (from schema)
Schema
Project ID.
Name of the project.
Default value: project
Type of the object returned.
{
"id": "3074457345618265000",
"name": "Product Guild project",
"type": "project"
}
Malformed request
- application/json
- Schema
- Example (from schema)
Schema
Default value: 400
HTTP status code.
Default value: invalidParameters
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 400,
"code": "invalidParameters",
"message": "string",
"type": "error"
}
Invalid authentication credentials
- application/json
- Schema
- Example (from schema)
Schema
Default value: 401
HTTP status code.
Default value: tokenNotProvided
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 401,
"code": "tokenNotProvided",
"message": "string",
"type": "error"
}
Invalid access
- application/json
- Schema
- Example (from schema)
Schema
Default value: 403
HTTP status code.
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 403,
"code": "forbiddenAccess",
"message": "string",
"type": "error"
}
Not found
- application/json
- Schema
- Example (from schema)
Schema
Default value: 404
HTTP status code.
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 404,
"code": "notFound",
"message": "string",
"type": "error"
}
Conflict
- application/json
- Schema
- Example (from schema)
Schema
Default value: 409
HTTP status code.
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 409,
"code": "conflict",
"message": "string",
"type": "error"
}
Too many requests
- application/json
- Schema
- Example (from schema)
Schema
Default value: 429
HTTP status code.
Description of the status code.
Explanation of the error.
Default value: error
{
"status": 429,
"code": "tooManyRequests",
"message": "string",
"type": "error"
}