# Matrix TimeCard API

> The Matrix TimeCard API lets a company system create, read and update the Jobs, Work Orders, Meet Points, Phase Codes, boundaries and equipment that crews clock in to. Each link below is a plain Markdown page.

The base URL has the form `https://<your-instance-host>/api/v1`. Ask the account administrator for the host. Every request needs an API key in the `X-API-Key` header.

## Agent skill

- [Matrix TimeCard API skill](https://matrixtimecard.com/docs/skill/SKILL.md): the rules and recipes an AI agent needs to call the API safely

## Start here

- [Overview](https://matrixtimecard.com/docs/README.md): What the API is, the base URL and the words it uses
- [Getting started](https://matrixtimecard.com/docs/getting-started.md): Get a key, make your first call, and write to a Job step by step
- [Authentication](https://matrixtimecard.com/docs/authentication.md): How to send your API key, key scopes, and how to keep a key safe
- [Errors](https://matrixtimecard.com/docs/errors.md): The error format, every error code, and when to retry
- [Conventions](https://matrixtimecard.com/docs/conventions.md): Responses, paging, codes, dates, locations, ownership and safe updates

## API reference

- [Activities](https://matrixtimecard.com/docs/reference/activities.md): Create, read, update and import Jobs, Work Orders and Meet Points
- [Phase Codes](https://matrixtimecard.com/docs/reference/phase-codes.md): Manage the Phase Codes on one Job, or on many Jobs at once
- [Boundaries](https://matrixtimecard.com/docs/reference/boundaries.md): Turn a job-site boundary off or on
- [Equipment](https://matrixtimecard.com/docs/reference/equipment.md): Create, read, update, deactivate and reactivate equipment
- [Proposed changes](https://matrixtimecard.com/docs/reference/proposed-changes.md): Send changes that an administrator approves before they go live
- [Reference lists](https://matrixtimecard.com/docs/reference/reference-lists.md): The fixed values that some fields accept

## More

- [Terms and limits](https://matrixtimecard.com/docs/terms-and-limits.md): Rate limits, size limits and terms of use
- [Use with AI agents](https://matrixtimecard.com/docs/ai-agents.md): Give an AI agent the skill file and the raw Markdown pages
- [Changelog](https://matrixtimecard.com/docs/changelog.md): What changed in the API, by date