Aerion API
Aerion API
This document provides a full list of all Aerion APIs currently available, so you can start integrating Aerion with your tools.
Tags
Absence
Resource: Absence — CRUD endpoints
AbsenceRequest
Resource: AbsenceRequest — CRUD endpoints
AbsenceType
Resource: AbsenceType — CRUD endpoints
Account
Account — domain-specific endpoints
Analytics
Analytics — domain-specific endpoints
Approval
Approval — domain-specific endpoints
Client
Resource: Client — CRUD endpoints
ClientExternalIntegration
Resource: ClientExternalIntegration — CRUD endpoints
Color
Resource: Color — CRUD endpoints
Contact
Resource: Contact — CRUD endpoints
Document
Resource: Document — CRUD endpoints
Expense
Resource: Expense — CRUD endpoints
ExpenseCategory
Resource: ExpenseCategory — CRUD endpoints
File
File — domain-specific endpoints
Holiday
Resource: Holiday — CRUD endpoints
Deprecated. Public holidays are now managed via the PublicHoliday absence type. This read-only lookup is retained for backwards compatibility.
IntegrationService
Resource: IntegrationService — CRUD endpoints
IntegrationServiceType
Resource: IntegrationServiceType — CRUD endpoints
Invoice
Resource: Invoice — CRUD and model-specific endpoints
InvoiceExternalIntegration
Resource: InvoiceExternalIntegration — CRUD endpoints
OvertimeReduction
Resource: OvertimeReduction — CRUD and model-specific endpoints
PlannedInvoice
Resource: PlannedInvoice — CRUD and model-specific endpoints
Planner
Planner — domain-specific endpoints
PlannerAssignment
Resource: PlannerAssignment — CRUD endpoints
Project
Resource: Project — CRUD and model-specific endpoints
ProjectDay
Resource: ProjectDay — CRUD endpoints
Per-(project, day) approval state. An APPROVED ProjectDay closes that (project, day) to further time-entry creation by any user, and implies every existing WORK entry on that day is also APPROVED. Read-only via this resource — to approve or unapprove a project day, use the approval controller endpoints (
POST /v1/approval/bulk-approve). Direct create / update / destroy on /v1/project-days is not supported.ProjectMilestone
Resource: ProjectMilestone — CRUD endpoints
Reference
Resource: Reference — CRUD endpoints
ReferenceFamily
Resource: ReferenceFamily — CRUD endpoints
ReferenceFamilyAssignment
Resource: ReferenceFamilyAssignment — CRUD endpoints
Role
Resource: Role — CRUD endpoints
SkillAssignment
Resource: SkillAssignment — CRUD endpoints
Assigns a skill to a user, recording their proficiency. A user can hold each skill at most once. When a skill is removed from a user the assignment is archived (
status set to 0) rather than deleted, so the history is preserved.SkillSet
Resource: SkillSet — CRUD endpoints
A named collection of skills. Skills (Tag records with a
type) are added to a skill set via TagAssignment. Each skill set belongs to a SkillSetCategory. Skill sets are a convenience for bulk-applying skills to users — they are not permanently linked to users. Adding or removing a skill from a skill set does not change the skills already assigned to any user.SkillSetCategory
Resource: SkillSetCategory — CRUD endpoints
Groups skill sets.
Tag
Resource: Tag — CRUD endpoints
A label attached to other records. This model does double duty. When
type is null the row is a plain tag — a free-form label attached to clients, projects, tasks, users, and expense categories via TagAssignment. When type is set the row is a skill (part of Skill Management): 1 = skill, 2 = language, 3 = certificate. Skills require a category and are assigned to users via SkillAssignment. Which rows a GET returns depends on the type filter and the includeSkills query parameter.TagAssignment
Resource: TagAssignment — CRUD endpoints
Attaches a Tag to another record, identified by (
model, record). Used to tag entities such as clients, projects, tasks, users, and expense categories. To relate a skill (a skill-type Tag) to a user, use SkillAssignment instead — not this model.TagCategory
Resource: TagCategory — CRUD endpoints
Categorizes skills. Although the Tag model does double duty as both plain tags and skills, this object is currently used only to categorize skills (a skill must belong to a category). Categorizing plain tags is intended as a future feature.
Task
Resource: Task — CRUD endpoints
TaskAssignment
Resource: TaskAssignment — CRUD endpoints
Team
Resource: Team — CRUD endpoints
TeamAssignment
Resource: TeamAssignment — CRUD endpoints
TimeEntry
Resource: TimeEntry — CRUD and model-specific endpoints
The model serves three purposes distinguished by
trackingType. The three are independent in reporting: WORK totals are not affected by WORKTIME or BREAK.
Required fields depend on both trackingType and the account-level AccountSetting.timerMode:
- WORK (project time) —
projectandtaskare required. FollowstimerMode: inDURATION, provideduration+sorting(no times); inSTART_TIME_END_TIME, providestartTime+endTimeand omitsorting(omitendTimewhilerunning). - WORKTIME (clock in/out) —
projectandtaskmust be omitted. Always usesstartTime+endTime, regardless oftimerMode. - BREAK —
projectandtaskmust be omitted. FollowstimerModeonly when the account does not use worktime. When worktime is enabled, BREAK always usesstartTime+endTime(like WORKTIME), but may still includesorting.
User
Resource: User — CRUD and model-specific endpoints
UserAssignment
Resource: UserAssignment — CRUD endpoints
UserEmployment
Resource: UserEmployment — CRUD endpoints
UserIntegration
Resource: UserIntegration — CRUD endpoints
VacationBudget
Resource: VacationBudget — CRUD and model-specific endpoints
Security Schemes
OAuth2Password
OAuth 2.0 authorization
oauth2
BearerAuth
OAuth 2.0 access token issued by
POST /oauth2/token. Send as Authorization: Bearer <access_token>.http