Objects - Hermios Developers

Every object has a singular and a plural API name. REST and GraphQL use the plural for lists (/rest/companies, companies) and the singular for single-record operations (createCompany).

Find your workspace’s objects

GET https://api.hermios.app/rest/metadata/objects
The objects query on https://api.hermios.app/metadata
Your workspace’s OpenAPI document: GET https://api.hermios.app/rest/open-api/core with your API key
The MCP tool list_object_metadata_names
In the app: Settings → Data model, which shows each object’s API names

Standard objects

Object	API names	Notes
Company	`company` / `companies`	`domainName`, `employees`, `annualRecurringRevenue`, `accountOwner`, `people`, `opportunities`
Person	`person` / `people`	`name` (first/last), `emails`, `phones`, `jobTitle`, `company`
Opportunity	`opportunity` / `opportunities`	`amount` (micros + currency), `stage` (`NEW`, `SCREENING`, `MEETING`, `PROPOSAL`, `CUSTOMER`), `closeDate`, `company`, `pointOfContact`, `owner`
Task	`task` / `tasks`	`title`, `bodyV2`, `dueAt`, `status`, `assignee`, linked through `taskTargets`
Note	`note` / `notes`	`title`, `bodyV2`, linked through `noteTargets`
Workspace member	`workspaceMember` / `workspaceMembers`	The people in your organization

Emails and calendar events (message, messageThread, calendarEvent and their participants) come from connected accounts and follow each account’s sharing settings.

Hermios objects

Object	API names	Comes from
Vault item	`vaultItem` / `vaultItems`	Hermios. Secrets are not fields: see Vault.
Contract	`contract` / `contracts`	Documenso app: `status` is `DRAFT`, `SENT`, `VIEWED`, `SIGNED`, `DECLINED` or `EXPIRED`
Deal review	`dealReview` / `dealReviews`	Sales Insights: `summary`, `verdict`, `confidence` (`RATING_1`–`RATING_5`), `notes`, `opportunity`
Property, Inspection	`property` / `properties`, `inspection` / `inspections`	Real estate pack, only where installed

Field formats

Type	JSON
Currency	`{ "amountMicros": 1500000000, "currencyCode": "AUD" }` (1,500.00)
Full name	`{ "firstName": "Ada", "lastName": "Lovelace" }`
Emails	`{ "primaryEmail": "ada@acme.com", "additionalEmails": [] }`
Phones	`{ "primaryPhoneNumber": "…", "primaryPhoneCountryCode": "AU", "additionalPhones": [] }`
Links	`{ "primaryLinkUrl": "https://acme.com", "primaryLinkLabel": "", "secondaryLinks": [] }`
Select	The option value, for example `"PROPOSAL"`
Rating	`"RATING_1"` to `"RATING_5"`
Relation	Set the foreign key: `"companyId": "<id>"`
Date and time	ISO 8601 in UTC