Create a family

POST/families

Creates a new family owned by the authenticated user and returns the created resource. The creator is added as the first member with the `owner` role.

Auth:Bearer

Request body

name

stringrequired

Response

id

Unique identifier for this resource.

uuid

name

Human-readable display name.

string

created_at

RFC 3339 timestamp of when the resource was created.

datetime

Request

bash

curl -sS -X POST "https://phosra-api-sandbox-production.up.railway.app/api/v1/families" \
  -H "Authorization: Bearer $PHOSRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "The Chen Family"
}'

Response

json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "string",
  "created_at": "2025-01-15T09:30:00Z"
}