Getting Started with the Timeglass API

Create an API Key

Workspace admins create API keys in the Timeglass app under Settings, in the API keys section. Give the key a descriptive name and pick a scope: read for read-only access, or read_write to also manage clients, projects, and categories. The full key (starting with tg_live_) is shown exactly once at creation; store it in a secret manager and delete it from the same page if it leaks.

Make Your First Request

Send the key as a bearer token: curl "https://api.timeglass.ai/v1/workspace" -H "Authorization: Bearer $TIMEGLASS_API_KEY"

Pull Your First Data

List timesheets (one per member per day, with total time, review status, and nested activities): GET /v1/timesheets?start=2026-07-01&end=2026-08-01&limit=50. Follow next_cursor until it is null.

Introduction and conventions · Activities and timesheets reference