Organizations and ProjectsProjects

Create a project

Create a project. Organization owners and admins can create projects. A member can create one when the organization setting allow_member_project_creation is true (the default). A service account key cannot create one. The creator becomes project admin, and that grant skips the check on key creators.

POST
/v1/orgs/{org}/projects
AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

org*string

Organization name

Match^[a-z0-9][a-z0-9-]*[a-z0-9]$
Length2 <= length <= 64

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

description?string

Project description

Match^[^\x00-\x08\x0b\x0c\x0e-\x1f\x7f-\x9f‪-‮⁦-⁩]*$
Lengthlength <= 500
display_name*string

Human-readable project name

Match^[^\x00-\x08\x0a-\x1f\x7f-\x9f‪-‮⁦-⁩]*$
Length1 <= length <= 100
name*string

URL-safe project identifier

Match^[a-z0-9][a-z0-9-]*[a-z0-9]$
Length2 <= length <= 64

Response Body

application/json

application/problem+json

curl -X POST "https://example.com/v1/orgs/string/projects" \  -H "Content-Type: application/json" \  -d '{    "display_name": "My Project",    "name": "my-project"  }'
{  "created_at": "string",  "description": "A short description of the project",  "display_name": "My Project",  "effective_role": "none",  "id": "string",  "name": "my-project",  "owner": {    "org": {      "display_name": "Acme Corp",      "id": "string",      "name": "acme-corp"    },    "type": "org"  },  "updated_at": "string"}