// REST API
ENDPOINT REFERENCE
All endpoints are under https://your-domain.com/api/public/v1. Use API keys with granular scopes to authenticate each request.
AUTH HEADER
x-api-key or Authorization: Bearer
SUPPORTED METHODS
GET, POST, OPTIONS
VERSION
v1
FORMAT
JSON
API Root
API version, auth model, scopes, and endpoint catalog.
GETpublic (no scope)
/api/public/v1
curl -s "https://your-domain.com/api/public/v1" \ -H "x-api-key: YOUR_API_KEY"
Get Current User Context
Returns actor profile, API key metadata, and organization memberships.
GETdailystand.profile:read
/api/public/v1/me
curl -s "https://your-domain.com/api/public/v1/me" \ -H "x-api-key: YOUR_API_KEY"
List Organization Teams
List teams for an organization with isMember and memberCount fields.
GETdailystand.teams:read
/api/public/v1/teams?orgId=<optional>
curl -s "https://your-domain.com/api/public/v1/teams?orgId=<optional>" \ -H "x-api-key: YOUR_API_KEY"
List My Teams
Returns only teams the token owner belongs to in the selected organization.
GETdailystand.teams:read
/api/public/v1/teams/mine?orgId=<optional>
curl -s "https://your-domain.com/api/public/v1/teams/mine?orgId=<optional>" \ -H "x-api-key: YOUR_API_KEY"
Get Team Standups (Day)
Read standups for one day; optional team scope includes global entries fallback.
GETdailystand.standups:read
/api/public/v1/standups/day?date=2026-02-16&orgId=<optional>&teamId=<optional>
curl -s "https://your-domain.com/api/public/v1/standups/day?date=2026-02-16&orgId=<optional>&teamId=<optional>" \ -H "x-api-key: YOUR_API_KEY"
Get Team Standups (History)
Read historical standups by date range with optional team scope.
GETdailystand.standups:read
/api/public/v1/standups/history?startDate=2026-02-01&endDate=2026-02-16&orgId=<optional>&teamId=<optional>
curl -s "https://your-domain.com/api/public/v1/standups/history?startDate=2026-02-01&endDate=2026-02-16&orgId=<optional>&teamId=<optional>" \ -H "x-api-key: YOUR_API_KEY"
Submit Standup
Create or replace your standup for a date/team scope. Empty entries clears that scope for the day.
POSTdailystand.standups:write
/api/public/v1/standups
curl -s -X POST "https://your-domain.com/api/public/v1/standups" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"orgId": "ORG_ID",
"date": "2026-02-16",
"teamId": "TEAM_ID",
"entries": [
{
"type": "completed",
"content": "Shipped mobile timeline fix"
},
{
"type": "planned",
"content": "Review team analytics outliers"
},
{
"type": "blocker",
"content": "Waiting on staging access"
}
]
}'Get Analytics
Aggregated stats for standups across selected range and optional team.
GETdailystand.analytics:read
/api/public/v1/analytics?rangeDays=30&orgId=<optional>&teamId=<optional>
curl -s "https://your-domain.com/api/public/v1/analytics?rangeDays=30&orgId=<optional>&teamId=<optional>" \ -H "x-api-key: YOUR_API_KEY"