Most teams keep follow-up work on whiteboards, in spreadsheets and in people’s heads, so it gets lost or ends up belonging to nobody. In Threaded, every piece of follow-up work is an action in Improve. Anyone on the floor or in the office can add one when they spot a problem or have an idea, and each action has one owner, a status and a due date until it’s done or someone decides not to do it.
#What it is
- Action. One piece of work to do: fix a fixture, update a drawing, retrain a shift. It has a description, a status, a priority, one owner, an impact amount, a due date, tags, notes, media and comments. Each action gets an ID such as
MFG-0123. - Status. Where the work stands: To do, In progress, Blocked, Done or Canceled.
- Archive. Hides an action from the Actions list without changing its status. It’s separate from the status.
- Tag. A label that groups actions by project or topic, such as “Line 3 changeover”. Your organization keeps one shared list of tags.
- Improve has two tabs: Actions, the list itself, and Tags, your organization’s tags.
#Rules
#Who can do what
- Every role can see actions and their comments: Operator, View All, Editor and Owner.
- Operators, Editors and Owners can add, edit and delete any action, and comment on it. View All members can only read.
- You can edit or delete only your own comments. Operators can change or delete only the media they uploaded.
- Editors and Owners manage the list of tags. Anyone who can edit an action can apply tags to it.
- API tokens need the
actions:readcapability to read actions andactions:writeto change them.
#Statuses
- An action has one of five statuses: To do, In progress, Blocked, Done and Canceled. A new action starts as To do unless you pick another.
- To do, In progress and Blocked are open. Done and Canceled are closed.
- Done means the work was finished. Canceled means the team decided not to do it. Both stay in the list, so a decision not to do something is visible.
- Moving an action to Done or Canceled records its completion date. Moving it back to an open status clears the date.
- An action is overdue when it’s open, not archived, and past its due date. Done, Canceled and archived actions are never overdue.
#Archive
- Canceled means you decided not to do it. Archived means it’s hidden from the list.
- Archiving leaves the status and completion date as they are. Unarchiving brings the action back exactly as it was, so an archived Done action comes back as Done.
- Archived actions don’t show in the Actions list, under any filter, and don’t come up in search or @ mentions.
- You archive and unarchive actions from the CLI or the API. An archived action you open from a link shows its Archived date.
threaded actions:listhides archived actions by default, like the All filter.actions:list --archivedlists only archived actions.
#Tags
- Every organization starts with five tags: Design, Parts, Tooling, Process and People. They’re ordinary tags: rename, recolor or delete them like any other.
- An organization can have up to 200 tags, and an action up to 20.
- Tag names are unique in your organization, ignoring capitalization, so “Line 3” and “line 3” can’t both exist.
- Deleting a tag removes it from every action that has it. The actions stay.
#Notifications
- When someone makes you the owner of an action, you get an Action assigned notification in the app, as a push notification on the mobile app, and by email. Nothing else about an action sends a notification: there are no due-date reminders.
Your organization needs this feature turned on. See Feature Access and Billing.
#In the app
#Find an action
Open Improve in the sidebar. The Actions tab lists your organization’s actions, newest first. Each row shows the ID, Description, Tags, Status, Owner, Impact in dollars and Due date.
Use the filters to narrow the list:
- All: every action that isn’t archived.
- Mine: actions you own.
- Unassigned: actions with no owner.
- Overdue: open actions past their due date.
Search actions… searches descriptions. When a filter or search finds nothing, the list says No actions match (or Nothing overdue on Overdue). Filter by tag shows only actions with any of the tags you pick, and works together with the filter you’re on. The selected tags are kept in the page’s address, so you can bookmark or share the filtered list. If nothing matches, the list says so and offers Clear tag filter.
#Add an action
- Click New action.
- Describe the work. Type @ to mention a person, another action or a file.
- Set the Status, Priority, Owner, Tags, Impact Amount and Due Date as needed, and add notes.
- Click Create.
If your organization has no tags yet, the tag picker says No tags yet. Add some in Improve › Tags.
#Work an action
Click an action to open it. Change any field and it saves right away.
- Status: To do, In progress, Blocked, Done or Canceled.
- Priority: High, Medium, Low or None.
- Owner: one person is responsible. Search the list by name or email. Only members who can open the organization are listed. If the owner has lost access, they still show, marked Disabled, until you pick someone else or Unassigned.
- Tags: pick one or more from your organization’s list. New tags are added on Improve › Tags first.
- Media: attach photos and files.
- Comments: discuss the action with the team.
- Notes: keep working notes.
Click Delete action to remove an action. Deleting can’t be undone. To keep the record but hide it, archive it instead. Owners, Editors and Operators can archive it from the CLI or API (actions:update --archived true).
#Manage tags
Open Improve › Tags. The Action tags page lists your organization’s tags and how many actions use each one.
- Click Add tag, enter a name and pick a color.
- Use the edit button next to a tag to rename or recolor it. Every action with that tag shows the change right away.
- Use the delete button to remove a tag. Threaded tells you how many actions use it before you confirm.
- Click a tag’s action count to open the Actions list filtered to that tag.
Everyone else can see the list but can’t change it.
#Ask the AI
Click AI in the toolbar to open the AI panel. Ask it to find actions or to summarize your open actions. If you can add an action, you can ask it to raise one. Actions it raises land in the same list and are worked the same way.
#Troubleshooting
An action I know about isn’t in the list. It may be archived. Archived actions are hidden from every filter. An Owner, Editor or Operator can find it with actions:list --archived and unarchive it.
“We can’t open this action.” The action was deleted, or it belongs to an organization you’re not in. Check the link, or go back to Improve.
#From the CLI or API
The threaded CLI has actions:* commands for each task. Everything else goes through threaded api call with the operations below. The older issues:* command names still work.
threaded actions:list(operationv2_actions_organizations_actions_list): find actions. Filter by status, owner, tag, search text or overdue. Archived actions are left out by default;actions:list --archivedlists only archived actions, and works with--page. Through the API,exclude_archived=trueleaves them out.threaded actions:get(operationv2_actions_actions_retrieve): read one action.threaded actions:create(operationv2_actions_organizations_actions_create_create): add an action. Pass tags by UUID intag_uuids.threaded actions:update(operationv2_actions_actions_partial_update): work an action.actions:update --archived truearchives it and--archived falseunarchives it; through the API, send{"archived": true}or{"archived": false}.- Operation
v2_actions_actions_destroy: delete an action. threaded action-tags:list(operationv2_actions_organizations_action_tags_list): list your organization’s tags. Add, change and delete tags withv2_actions_organizations_action_tags_create_create,v2_actions_action_tags_partial_updateandv2_actions_action_tags_destroy.
Statuses:
not-started: To do.in-process: In progress.blocked: Blocked.done: Done.completion_dateis set.canceled: Canceled.completion_dateis set.- An archived action keeps its status and has an
archived_attime. Leavingarchived_atempty means it isn’t archived.
Common errors:
400An action can have at most 20 tags.: remove a tag before adding another.400One or more tags were not found in this organization.: a tag UUID is wrong or belongs to another organization. List your tags withaction-tags:list.400Owner is not a member of the organization: pick an owner from your organization’s members.400A tag with this name already exists in this organization.: names are unique ignoring capitalization. Use the existing tag, or pick another name.400This organization already has the maximum of 200 tags.: delete a tag to add another.403: you can read actions but not change them, or a token lacksactions:write.404: the action doesn’t exist or belongs to an organization you’re not in.
For example:
threaded api call --operation-id v2_actions_organizations_actions_list --path organization_uuid=<org_uuid> --query exclude_archived=true