Timesheets API

A timesheet collects a user's time entries for one time period and carries them through submission and approval. Use this API to open timesheets, attach entries, and drive their review lifecycle.

Open a timesheet

A timesheet ties a user_id to a period_id from the Time Periods API. Create it with POST /time-sheets, then read what it contains with GET /time-sheets/{id}/entries and GET /time-sheets/{id}/summary.

curl https://algapsa.com/api/v1/time-sheets \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "usr_5b21",
    "period_id": "tp_2026_06",
    "notes": "June first half"
  }'

Attach entries

Move time onto a sheet with POST /time-sheets/{id}/add-entry and pull it back off with DELETE /time-sheets/{id}/remove-entry. The entries themselves are created through the Time Entries API.

Submit and review

A user submits with POST /time-sheets/{id}/submit. A reviewer then calls POST /time-sheets/{id}/approve, POST /time-sheets/{id}/reject, or POST /time-sheets/{id}/request-changes. An approval can be undone with POST /time-sheets/{id}/reverse-approval.

Endpoints

Every endpoint links through to its full parameters, request and response schemas, and code samples.