Link two types
A link says how objects of two types relate, like a HubSpot deal and the Work it pays for. Once two objects are linked, actions can follow the link: an agent reading a deal can read its Work, and code can change the objects linked to the one it’s running on. If you’ve used other ontology tools, a link here is what they call a link type.
You need Manage types and links. Ask your Flowstate admin.
See your links
Open the Links tab. Each row reads as a sentence, like Work assignments is on Work, and shows:
- Made by: Built in, The app, A shared key, An agent or People.
- Linked and Not linked: how many objects have the link, and how many don’t yet.
- Status: Up to date, Working, or how many need you.
Flowstate’s own links and the relations an app already keeps are there from the start, and can’t be changed. To see your types and links as a picture, open the display menu and choose Map.
Add a link
- On the Links tab, select Add link.
- Choose the type it goes From, such as Deals.
- In Reads as, say how it reads, such as “pays for”.
- Choose the type it goes To, such as Work.
- Under Each one links to, choose One or Many. A deal pays for one piece of Work.
- Choose How objects are linked:
- A shared key: two properties hold the same value, like a company ID on a deal and on a company. Choose the From property and the property it Equals. Flowstate links matching objects as they change.
- An agent works it out: an action reads each object and finds what it belongs to, and asks when it’s unsure. Use this when nothing matches exactly, like deal names that only sometimes mention the project.
- By hand: people link objects themselves.
- Select Save.
For a link an agent works out, you also need an action that does the linking. In our example that’s the Common work attribution agent, allowed to Link deals. See Add an action.
For HubSpot and Attio deals, and Jira Cloud and Linear projects, a ready-made setup adds the link to Work and its agent for you when you add the type. See Make an app’s records a source of Work.
Delete a link
You can delete a link you added. Flowstate’s own links and those an app keeps can’t be deleted.
- On the Links tab, open the link.
- Select Delete link.
- Flowstate asks you to confirm. Select Delete.
Every connection it made between the two types’ objects is removed. The objects stay, and so do actions.
When an agent needs you
When an agent can’t tell what an object links to, it asks, and the link’s status shows how many need you. Open the link to see the list, then open each run to answer it. See Answer a run’s question.
If something’s not right
Most objects are Not linked. For a shared key, check both properties hold the same value. For an agent, check the action is on and look at its runs.
You can’t change a link. It’s built in or kept by the app, or you don’t have Manage types and links.