EIGENN.
docsguidesapichangelogpricingsign in
EIGENN.

Tracker Projects API

Create, filter, update, categorize, and remove team-scoped time tracking projects through public API v1.

Tracker projects group time entries, billing defaults, customers, categories, and assigned users. Eigenn scopes every operation to the authenticated team.

Endpoints

MethodEndpointScopePurpose
GET/tracker-projectstracker-projects.readList and filter projects
POST/tracker-projectstracker-projects.writeCreate a project
GET/tracker-projects/{id}tracker-projects.readRetrieve one project
PATCH/tracker-projects/{id}tracker-projects.writeUpdate the fields that you send
DELETE/tracker-projects/{id}tracker-projects.writeDelete a project and its time entries

Prefix each endpoint with the environment base URL, such as https://api.eigenn.io/v1.

Create a Project

POST /tracker-projects needs name. All other fields are optional.

FieldTypeRules
namestring1–255 characters after the whitespace trim
descriptionstring or nullUp to 2,000 characters
estimateinteger or nullNon-negative estimated hours
billableboolean or nullDefaults to false when omitted
ratenumber or nullNon-negative hourly rate
currencystring or nullThree uppercase ISO 4217 letters, such as USD
statusenumin_progress or completed
customerIdUUID or nullCustomer must belong to the authenticated team
tagsarray or nullUp to 50 team tags that already exist, each with id and value
curl --request POST \
  --url https://api.eigenn.io/v1/tracker-projects \
  --header "Authorization: Bearer $EIGENN_API_TOKEN" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: project-website-redesign" \
  --data '{
    "name": "Website redesign",
    "description": "Customer portal and billing experience",
    "billable": true,
    "rate": 175,
    "currency": "USD",
    "estimate": 120,
    "status": "in_progress"
  }'

Creation returns 201 with the complete project.

Project Response

Project responses include:

  • identity, name, description, status, and creation timestamp
  • billing defaults: billable, rate, and currency
  • estimate, totalDuration in seconds, and calculated totalAmount
  • customerId and the linked customer summary
  • reusable category tags as { id, name }
  • assigned users as { id, fullName, avatarUrl }

customer, nullable customer fields, and user avatar URLs can be null. Do not assume a customer or profile image is always present.

List and Filter Projects

GET /tracker-projects accepts:

ParameterRules
cursorOpaque offset cursor returned by the prior page
pageSizeInteger from 1 to 100
qProject name or description search
start, endYYYY-MM-DD creation-date bounds
statusin_progress or completed
customersUp to 100 customer UUIDs
tagsUp to 100 tag UUIDs. Eigenn returns the projects that match at least one tag
sortTwo-item tuple: supported field and asc or desc

Supported sort fields are time, amount, assigned, customer, tags, created_at, and name.

The response has data and pagination metadata with hasNextPage and hasPreviousPage. Keep the same filters and the same sort when you follow a cursor.

Update a Project

PATCH /tracker-projects/{id} accepts any non-empty subset of the create fields. Omitted fields keep their current values. Send null only for the fields that permit it in the schema. Send it only when you want to clear the field.

When you replace tags, you replace the project's complete category set. To manage one assignment at a time, use the Tracker Categories API.

Delete a Project

A delete operation removes the project permanently. Tracker entries reference projects with cascade deletion. Thus Eigenn also removes the related time entries. Export or reassign the necessary time records before you delete the project.

Common Errors

StatusCause
401Missing or invalid bearer token
403Missing tracker project scope
404Project, customer, or category is outside the team or no longer exists
409Duplicate or idempotency conflict
422Invalid UUID, date, currency, field length, or request shape

Related Pages

  • Tracker Entries and Timers
  • Tracker Categories
  • Authentication
  • Errors and Safe Retries

Tracker Entries and Timers API

Record work, import entries, and control active timers with team-scoped public API v1 operations.

Transactions API

List, create, categorize, update, attach, and remove eligible transactions through public API v1.

On this page

EndpointsCreate a ProjectProject ResponseList and Filter ProjectsUpdate a ProjectDelete a ProjectCommon ErrorsRelated Pages

Eigenn docs

current product

Overview
Overview
OverviewAccount PreferencesAssistant AutomationAssistant Command CenterBank ConnectionsBilling and UsageBudgets and ForecastCommand CenterCustomer LifecycleCustomer RecordsCustomersDeveloper PlatformDocument Processing and ExtractionDocument VaultFinancial Analytics and ReportsFinancial OverviewInvoice InsightsInvoice ProductsInvoicesMarketplace IntegrationsNotifications and BrandingOnboarding and SupportOverviewReceivablesReceivables AnalyticsReceivables ControlsSecurity and AccessSettings OverviewStress TestsTeams and OrganizationsTone Profiles and ExperimentsTransaction Categories and RulesTransactionsWeekly Finance RitualWorkflow ExecutionsWorkflow PausesWorkflowsWorkspace Inbox and Approvals
OverviewBuild and Review a ForecastBuild Your First WorkflowConfigure Assistant OperationsConfigure Notifications and BrandingConfigure Receivables ControlsConnect Transaction RecordsCreate and Manage CustomersCreate and Send InvoicesDeveloper API SetupFirst Cash ReviewInvoice Collection WorkflowMaintain Transaction RulesManage Security and BillingManage Team AccessManage the Invoice LifecycleMCP WorkflowsMonitor and Recover WorkflowsOrganize and Share DocumentsProcess Inbox ItemsReconcile and Categorize TransactionsReview a Customer Finance RecordRun a Finance Operating ReviewRun a Receivables Tone ExperimentRun a Runway Stress TestRun Your First Command Center ReviewSet Up a WorkspaceTroubleshoot Account AccessWebhook DeliveryWeekly CFO Review
OverviewIntegrationsMCPSDKsWebhooks
OverviewAuthenticationBank Accounts APICustomers APIErrorsForecasts and Stress Tests APIInvoice Payments APIInvoices APIPaginationRate LimitsRemote Tracker API StatusTracker Categories APITracker Entries and Timers APITracker Projects APITransactions APIWebhooks API StatusWorkflows API Status
Overview
Overview