Tektona Docs

Create a project. Any organization member can create projects. The creator becomes project admin.

Authorization

apiKey

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

Lengthlength <= 500

display_name*string

Human-readable project name

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://api-dev.tektona.ai/v1/orgs/string/projects" \  -H "Content-Type: application/json" \  -d '{    "display_name": "My Project",    "name": "my-project"  }'

{  "$schema": "https://api-dev.tektona.ai/schemas/ProjectResponse.json",  "created_at": "string",  "description": "A short description of the project",  "display_name": "My Project",  "effective_role": "none",  "id": "string",  "name": "my-project",  "owner": {    "org": {      "id": "string",      "name": "string"    },    "type": "org"  },  "updated_at": "string"}

{  "$schema": "https://api-dev.tektona.ai/schemas/ErrorModel.json",  "detail": "Property foo is required but is missing.",  "errors": [    {      "location": "string",      "message": "string",      "value": null    }  ],  "instance": "https://example.com/error-log/abc123",  "status": 400,  "title": "Bad Request",  "type": "https://example.com/errors/example"}

Create a project