API Documentation

Read and edit principles programmatically.

Read Principles

Fetch a user's principles by their alias.

Request

GET /api/users/{alias}

Response

{
  "alias": "youmin",
  "principles": [
    "Build for people who are overlooked by default.",
    "Practical usefulness matters more than elegant theory.",
    "..."
  ]
}

Example

curl https://principles.bio/api/users/youmin

Edit Principles

Update a user's principles. Requires the token received during account creation.

Request

PUT /api/users/{alias}
Content-Type: application/json

{
  "token": "your-secret-token",
  "principles": [
    "First principle.",
    "Second principle.",
    "Third principle."
  ]
}

Response

{
  "success": true
}

Example

curl -X PUT https://principles.bio/api/users/youmin \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your-secret-token",
    "principles": ["New principle."]
  }'

Errors

401 — Token is missing or invalid

404 — User not found

400 — Invalid request body