Skip to Content
kosemdocs
ReferenceAPIProjects

Create project

Creates a project in an organization. The caller becomes its owner.

POST
/v1/projects

Creates a project in an organization. The caller becomes its owner.

Authorization

bearer
headerAuthorizationBearer <token>

An access token, or an API key.

Request Body

application/json
  1. body
displayName?string

Name shown in user interfaces.

Lengthlength <= 100
parent*string

The organization to create the project in, organizations/{organization_id}.

Match^organizations/org_[0-7][0-9a-hjkmnp-tv-z]{25}$
slug*string

Globally unique, human-readable alias: 6 to 30 lowercase letters, digits or hyphens, starting with a letter. It never changes.

Match^[a-z][a-z0-9-]{4,28}[a-z0-9]$

Response Body

Created

application/json
  1. response
createTime*string

When the project was created.

Formatdate-time
deleteTime?string

When its deletion was requested; absent while it is active.

Formatdate-time
displayName*string

Name shown in user interfaces.

name*string

Resource name, projects/{project_id}. The ID is generated by the server and never changes.

parent*string

The organization the project belongs to, organizations/{organization_id}.

purgeTime?string

When kosem purges it, with everything in it, 30 days after its deletion was requested, unless it is undeleted first; absent while it is active.

Formatdate-time
slug*string

Globally unique, human-readable alias. It never changes, so that links to the project keep working.

state*string

Lifecycle state. Nothing in a project whose deletion was requested works but reading and restoring it, and it is purged at its purgeTime unless it is undeleted first.

Value in"ACTIVE""DELETE_REQUESTED"
updateTime*string

When the project was last updated.

Formatdate-time
Example Request
curl -X POST 'https://api.kosem.ai/v1/projects' \
  -H 'Content-Type: application/json' \
  -d '{
  "parent": "string",
  "slug": "string"
}'
Example Response
{
  "createTime": "2019-08-24T14:15:22Z",
  "deleteTime": "2019-08-24T14:15:22Z",
  "displayName": "string",
  "name": "string",
  "parent": "string",
  "purgeTime": "2019-08-24T14:15:22Z",
  "slug": "string",
  "state": "ACTIVE",
  "updateTime": "2019-08-24T14:15:22Z"
}