relations

Manage record relations between CRM objects using the Frontline CLI.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/api-evangelist/frontline --skill relations-api-evangelist
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: relations
Source: https://github.com/api-evangelist/frontline/tree/main/skills/vendor/relations
Command: npx skills add https://github.com/api-evangelist/frontline --skill relations-api-evangelist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Linking and querying related records across CRM objects (like People, Companies, and Deals) requires knowing relation field types, numeric IDs, and the correct CLI commands, which is error-prone without guidance. ## Core Features & Use Cases - Relation Field Creation: Create relation fields linking objects to objects and prismaRelation fields linking records to platform users, with modes, display columns, and activity merging. - Link and Unlink Records: Connect or disconnect records through named relations with idempotent link operations, including rules for the People-to-Company email-domain auto-link behavior. - Forward and Reverse Lookups: Retrieve related records for a source record or find all records pointing to a target with paginated results. - Use Case: Transfer a Person between Companies by listing current links, unlinking the old Company, linking the new one, and verifying the result. ## Quick Start Use the relations skill to link person record 6625abc123def456 to company 6625def789abc012 and then list all people linked to that company.

Frequently Asked Questions about relations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I link a record to another record with the Frontline CLI?▼

Use frontline object relation link with the object name, source record ID, relation name, and target record ID. The operation is idempotent, so linking the same target twice does not create duplicates.

How do I find all records related to a company in Frontline?▼

Run frontline object relation find-by with the object, relation name, and target ID for a reverse lookup. It returns paginated results with rows, total count, total pages, and current page, and supports --page and --page-size flags.

Should I manually link a Person to a Company in Frontline?▼

Usually no, because People are auto-linked to Companies by email domain when the domain is not generic like gmail or outlook. Only link manually when the email is missing or generic, when overriding the auto-linked Company, or when an explicit verified company differs.

What is the difference between relation and prismaRelation field types?▼

A relation field links records between two objects using relatedTableId and displayColumn, while prismaRelation links records to platform users using prismaModel User and displayField fullName. Both support single and multi modes.

How do I discover available relation names on a Frontline object?▼

Run frontline object schema with the object name and inspect the relations array in the output. Each entry provides a name, target object, mode, and display field, and the name value is used as the relation argument in CLI commands.