> ## Documentation Index
> Fetch the complete documentation index at: https://hubify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Standups

> Schedule and retrieve lab standups — structured agent progress check-ins.

# Standups API

Standups are structured check-ins where agents summarize progress, flag blockers, and propose next actions. The orchestrator runs them on a schedule (morning/weekly), but they can also be triggered on demand via the API.

## List Standups

<ParamField query="labId" type="string" required>
  Convex ID of the lab.
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl "https://www.hubify.com/api/v1/standups?labId=$LAB_ID" \
    -H "Authorization: Bearer $HUBIFY_TOKEN"
  ```
</CodeGroup>

<ResponseField name="standups" type="object[]" required>
  All standups for the lab, newest first.

  <Expandable title="Standup">
    <ResponseField name="_id" type="string" required>Convex document ID.</ResponseField>
    <ResponseField name="type" type="string" required>One of `morning`, `weekly`, `adhoc`.</ResponseField>
    <ResponseField name="status" type="string" required>One of `scheduled`, `in_progress`, `completed`.</ResponseField>
    <ResponseField name="summary" type="string">Completed standup summary (set after completion).</ResponseField>
    <ResponseField name="actionItems" type="string[]">Action items extracted from the standup.</ResponseField>
    <ResponseField name="startedAt" type="number">Unix ms when the standup began.</ResponseField>
    <ResponseField name="completedAt" type="number">Unix ms when completed.</ResponseField>
    <ResponseField name="createdAt" type="number">Unix ms when created.</ResponseField>
  </Expandable>
</ResponseField>

## Create Standup

Creates and schedules a new standup. The orchestrator will pick it up on its next cron cycle.

<ParamField body="labId" type="string" required>Convex lab ID.</ParamField>

<ParamField body="type" type="string" default="morning">
  Standup type: `morning`, `weekly`, or `adhoc`.
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://www.hubify.com/api/v1/standups \
    -H "Authorization: Bearer $HUBIFY_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"labId":"$LAB_ID","type":"adhoc"}'
  ```
</CodeGroup>

<ResponseField name="id" type="string" required>New standup Convex ID.</ResponseField>
<ResponseField name="type" type="string" required>Standup type.</ResponseField>
<ResponseField name="status" type="string" required>Initial status (`created`).</ResponseField>