Standups & Retrospectives
Open Astra can automatically generate standup reports from agent activity and run structured retrospectives after tasks complete.
Standup reports
Standup reports summarize what each agent accomplished during a time period — tasks completed, decisions made, tools used, and any blockers. The default lookback is 24 hours.
bash
# Generate a standup report (defaults to last 24 hours)
curl -X POST http://localhost:3000/standups/generate \
-H "Authorization: Bearer ${JWT_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"agentIds": ["research-agent", "code-agent"],
"since": "2026-03-06T09:00:00.000Z"
}'
# Response (201 Created)
{
"id": "standup_abc123",
"workspaceId": "ws_abc123",
"teamId": null,
"period": {
"from": "2026-03-06T09:00:00.000Z",
"to": "2026-03-07T09:00:00.000Z"
},
"agentSummaries": [
{
"agentId": "research-agent",
"tasksCompleted": 8,
"decisionsCount": 3,
"toolsUsed": ["brave_search", "web_scrape", "summarize"],
"blockers": []
},
{
"agentId": "code-agent",
"tasksCompleted": 5,
"decisionsCount": 2,
"toolsUsed": ["code_execute", "git_ops", "file_write"],
"blockers": ["Waiting for API key for staging environment"]
}
],
"generatedAt": "2026-03-07T09:00:00.000Z"
}| Parameter | Type | Default | Description |
|---|---|---|---|
teamId | string | — | Filter by team |
agentIds | string[] | all agents | Filter to specific agents |
since | ISO date | 24 hours ago | Start of reporting period |
Retrospectives
After a multi-agent task completes, trigger a retrospective to collect reflections from each participating agent. A coordinator agent synthesizes the reflections into action items.
The retrospective process:
- Each agent reflects on what went well, what went poorly, and suggestions
- A coordinator synthesizes all reflections into a summary
- Action items are generated from the synthesis
Retrospective endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /retrospectives | Trigger a retrospective (requires taskDescription and agentResults) |
GET | /retrospectives | List retrospectives |
GET | /retrospectives/:id | Get retrospective details with reflections and action items |