Project

An organization has one project, created by cow init. It is what releases hang off, and the reason a working directory only needs an organization id to know where it deploys.

GET /v1/project

Get the organization’s project

Auth: Clerk session token, or an org deploy key.

Response 200

{
  "data": {
    "id": "string",
    "orgId": "string",
    "name": "string",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  },
  "meta": {
    "requestId": "string",
    "nextCursor": "string",
    "hasMore": true
  }
}

Field	Type	Required	Constraints
data	object	yes
data.id	string	yes
data.orgId	string	yes
data.name	string	yes
data.createdAt	string (date-time)	yes
data.updatedAt	string (date-time)	yes
meta	object	no
meta.requestId	string	no
meta.nextCursor	string | null	no
meta.hasMore	boolean	no

Errors follow the shared envelope and code table.

POST /v1/project

Create the organization’s project

Auth: Clerk session token, or an org deploy key.

Request body

{
  "data": {
    "name": "string"
  }
}

Field	Type	Required	Constraints
data	object	yes
data.name	string	yes	length 1–200

Response 201

{
  "data": {
    "id": "string",
    "orgId": "string",
    "name": "string",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  },
  "meta": {
    "requestId": "string",
    "nextCursor": "string",
    "hasMore": true
  }
}

Field	Type	Required	Constraints
data	object	yes
data.id	string	yes
data.orgId	string	yes
data.name	string	yes
data.createdAt	string (date-time)	yes
data.updatedAt	string (date-time)	yes
meta	object	no
meta.requestId	string	no
meta.nextCursor	string | null	no
meta.hasMore	boolean	no

Errors follow the shared envelope and code table.