Timo Documentation

Authentication

The Timo API uses API keys for authentication. This guide explains how to obtain and use your API key.

Getting Your API Key

  1. Log in to your Timo account
  2. Navigate to Settings > API Keys
  3. Click Generate New Key
  4. Copy the key and store it securely

:::warning Security Never share your API key or commit it to version control. Treat it like a password. :::

Using Your API Key

Include your API key in the Authorization header of all requests:

Authorization: Bearer YOUR_API_KEY

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.timo.app/v1/time-entries

API Key Permissions

API keys inherit the permissions of the user who created them:

  • Read: View time entries, projects, and reports
  • Write: Create and update time entries and projects
  • Admin: Full access including user management

Refreshing API Keys

API keys don't expire, but you can refresh them at any time:

  1. Go to Settings > API Keys
  2. Click Refresh next to your key
  3. Update your applications with the new key

Troubleshooting

Invalid API Key (401)

  • Verify the key is correct
  • Check for extra spaces or characters
  • Ensure the key hasn't been revoked

Insufficient Permissions (403)

  • Check your account permissions
  • Verify the API key has the required access level