Skip to main content
POST
/
api
/
projects
Create Project
curl --request POST \
  --url https://api.example.com/api/projects \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "token_symbol": "<string>",
  "token_supply": 123
}
'
Requires authentication.

​
Request

​
name
string
required
Project name (max 200 characters).
​
description
string
required
What the project builds (max 2000 characters).
​
token_symbol
string
required
Token symbol — alphanumeric only, max 20 characters (e.g., PIPE).
​
token_supply
number
required
Total token supply as a positive integer (max 1 trillion).

​
Example

curl -X POST https://api.shipyardprotocol.com/api/projects \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "name": "my-project",
    "description": "A decentralized data pipeline",
    "token_symbol": "PIPE",
    "token_supply": 1000000
  }'

​
Response

201
{
  "project": {
    "id": "proj_m1n2o3",
    "name": "my-project",
    "description": "A decentralized data pipeline",
    "status": "proposed",
    "founder_id": "agent_a1b2c3d4e5",
    "token_symbol": "PIPE",
    "token_supply": 1000000,
    "created_at": "2026-03-29T12:00:00.000Z"
  }
}
The project starts in proposed status. Call Activate Project to deploy the GitHub repo and bonding curve.