Skip to main content
Your coworker hands part of a job to the coworker best equipped for it, then picks the result back up on its own.

A narrated tour, so turn your sound on. Sam, an assistant coworker, hands a renewal brief's research to Nora and its support tickets to Ivy, then puts their reports together.

What it does

Your coworkers are each good at something. Sam keeps your week on track. Nora does your research. Ivy knows your support queue. A renewal brief needs all three. Sam can hand a piece of the job to Nora, another coworker in the same agent. Nora gets a session of its own and works on it with its own instructions, tools and connected accounts. When Nora finishes, its report comes straight back to Sam, who carries on without you nudging it. You approve each handover, and you can open either side at any time.

When you’d use it

  • “Get the Northwind renewal brief ready for Thursday. @Nora can research their last quarter. Pull in their open support tickets too.”
  • “Before you draft the board update, ask Ivy what our biggest support issues were this month.”
  • “Get a company profile from the research coworker, then write the outreach email from it.”
  • “Ask the data coworker for last month’s numbers from your data warehouse, then write the summary.”
  • “Find out what Ivy has already told this customer, then write the follow-up.”
The common thread: part of the job belongs to another coworker, who has the tools, accounts or know-how for it.

Turning it on

There’s nothing to turn on. Every coworker can hand work to the other coworkers in its own agent, so the Capabilities tab doesn’t list it. Each handover still waits for your approval until you give standing permission.
The Work with coworkers row with its description, a blue icon and its switch on

Work with coworkers sits first under Collaboration. Switched on, its icon turns blue.

Only inside its agent. A coworker sees and hands work to the coworkers in its own agent, never another agent’s. Put coworkers that work together in the same agent. Every handover puts a second coworker to work, so it costs more than one coworker working alone.
You can stop a coworker handing work on from one channel, under Capabilities on this channel in the channel’s settings. See Channel settings.

How a handover works

Here’s one handover from start to finish. You ask Sam, your assistant coworker, to get the Northwind renewal brief ready for Thursday.

Ask, or let your coworker choose

Type @ in the chat box and your other coworkers appear at the top of the menu. Each shows its role and a delegate hint, and files you can mention follow below. Keep typing to narrow the list. Pick Nora and its name lands in your message. That tells Sam to hand Nora that part of the job.
The chat box with @ typed, and a menu offering Nora and Ivy first, each with its role and a delegate hint, then files you can mention

Type @ and your other coworkers come first, each with its role and a delegate hint. Files you can mention follow. Pick a coworker to have Sam hand that part to it.

You don’t have to name anyone. Sam can also choose for itself, based on what each coworker is equipped to do. In this example, your message never names Ivy, but Sam brings it in for the support tickets.
Coworkers show in the @ menu only while Work with coworkers is on. With it off, Sam can’t hand anything over, and the menu offers files alone.

Approve the handover

Before Sam hands anything over, it asks for your approval in the conversation.
An Approval needed card headed Ask Nora to research Northwind's last quarter, with the action's tag, a cost reason underneath, and Decline, Always allow and Approve buttons

Sam's first handover waits for you. The headline is Sam's own summary of what it's about to do.

  • The headline is Sam’s one-line summary, like “Ask Nora to research Northwind’s last quarter”.
  • The tag under it is the action’s name. The Always allow tooltip names the same action.
  • The reason tells you what approving costs:
    This starts a new session on another coworker, which will spend credits on that coworker too.
  • Three buttons. Decline stops the handover. Approve lets this one go ahead. Always allow lets this one go ahead and stops Sam asking next time. See Standing permission.
The card doesn’t list Sam’s full request. That appears on the next card, once you approve. If the headline isn’t clear enough, decline and ask Sam what it plans to send.

Follow it on the card

Once you approve, a card appears in Sam’s session. It stays there and updates as the work goes on.
A Delegated to Nora card marked Working, with an Open task link, the line Sam → Nora, Sam's request and a closed Detail toggle

The card in Sam's task, just after you approve. It shows who the work went to, what Sam asked for, and how it's going. Detail opens the rest.

  • Delegated to Nora, with a status: Working while Nora is on it.
  • Open session takes you straight to Nora’s side.
  • Sam → Nora, the chain of who handed the work to whom.
  • What Sam asked for, in Sam’s own words.
  • Detail opens the rest: Asked for, the result Sam wants back, and every message on the handover since. Once messages arrive, the toggle counts them, like 1 update.
Sam isn’t stuck waiting. It can keep working, or hand another part to someone else. Here, Ivy pulls Northwind’s open support tickets while Nora does the research. You chose Always allow on Nora’s card, so Sam hands Ivy its part without asking. Each handover gets its own card.

The other side

On Nora’s side, the handover is a normal session. It shows up in your session list, and Nora starts on it straight away. Its title is For Sam: and then Sam’s request: “Research Northwind’s last quarter: news, funding, hiring and product launches.”
Nora's task, titled For Sam and Sam's full request, opening with an Asked by Sam card, then a Started on its own row and Nora's first steps

Nora's side: a task of its own, titled with Sam's request in full. Nora starts on it straight away, with its own tools.

  • Asked by Sam heads Nora’s session, with the same status as Sam’s card. Its Open their session link goes back to Sam’s side.
  • A Started on its own row comes next, carrying Sam’s request: “Sam, another coworker in this workspace, started this session to hand you some work.” Open it to read the whole request.
  • Nora uses its own setup. It works with its own instructions, memory, tools, connected accounts and permission rules. When one of its actions needs your approval, Nora asks you in its own session.
  • Nora sees only what Sam wrote. Sam’s conversation with you stays on Sam’s side. So Sam writes its request to stand on its own.
Below them, Nora’s own steps appear as it works, like searching the news and reading Northwind’s newsroom. Every handover opens a new session of its own, even if Nora is busy with other work.

Follow-ups and checking the work

Sam can follow up while the work goes on. Say Sam also wants to know whether Northwind is hiring for support roles. The follow-up lands in Nora’s same session, and it asks for your approval too:
This sends work into another coworker’s session, which will make them take another turn.
Approve it, and Sam’s card counts it: 1 update. If Nora is mid-session, it sees the follow-up at its next step, and Nora’s session shows it as a row headed From Sam. If Nora is between turns, the follow-up starts it again. Sam can also join a session Nora already has open on related work, instead of starting a fresh one. And it can read Nora’s session to see what Nora actually did, without asking you, because reading changes nothing. You can do the same any time with Open session.

The report comes back

When Nora finishes, its report goes straight back to Sam. You don’t need to pass anything along.
Sam's card for Nora marked Reported back, with Nora's five sourced points, the detail open on Asked for, Sam's follow-up and a Full report line, and Sam's Started on its own row further down

Sam's card once Nora reports back: the five-point report, then the detail with what Sam asked for, Sam's follow-up and the Full report line. Further down, Sam starts again on its own.

  • The card turns to Reported back, with Nora reported and Nora’s own words. Here, that’s five points, each with its source, like “Raised a Series C in August (northwind.example/news)”.
  • A usage figure now sits next to Open session. It counts only Nora’s latest turn, not the whole handover.
  • The detail shows Asked for, then every update since, like Sam’s follow-up. While it’s open, the toggle reads Hide detail.
  • The report is also saved as a file in Sam’s session files, in the delegations folder, with what Sam asked for and when. The card’s Full report line opens it.
  • Sam picks up on its own. Further down Sam’s session, a row appears: Started on its own · “Nora finished the work you delegated.”
A report is Nora’s own account of its work. Before building on it, Sam can read Nora’s session to check. Then it carries on. Here, it puts Nora’s research and Ivy’s tickets into one brief, saved in the session’s files. If Nora needs something from Sam, Nora’s report is a question. Sam answers with a follow-up, and Nora’s next report takes its place on the card.

Other endings

Not every handover ends with a report. The card’s status tells you where things stand. On Needs a look, the detail shows an entry from Platform saying what happened. It shows Nora’s last message, or a line like “Nora is waiting on a person”, “Nora was stopped” or “They ran out of steps before finishing.” Sam picks up on its own here too, and decides what to do next. A follow-up puts the card back to Working. Needs a look doesn’t always mean Nora stopped. If Nora has turns left, it carries on, and the card keeps reading Needs a look until its report comes back. If Nora is waiting on a person, it’s usually you. Open Nora’s session, which shows needs you, and answer there. If a card reads Working for longer than you’d expect, open the session and see where it is.

Standing permission

Approving every handover gets old once you trust how Sam uses it. Click Always allow on the approval card, and Sam stops asking before it hands work off. Its tooltip reads:
Runs it now and saves an allow rule for delegate_to_coworker in this coworker’s permissions, so it stops asking.
Here’s exactly what that covers:
  • Sam’s handovers, to every coworker. The rule is saved in Sam’s own permissions, so it covers handing work to Nora, Ivy or anyone else.
  • Not Sam’s follow-ups or stops. Those ask separately, each with its own Always allow.
  • In every session with Sam. That includes sessions other people in your workspace start with Sam.
  • Not your other coworkers. If Ivy can hand work on too, Ivy still asks until you allow its handovers.
You still see every handover, as a card in Sam’s session. To withdraw it, open Sam’s Files tab and open the file labelled Permissions. Delete the rule that matches the action the tooltip named. Every Always allow rule has the same reason, “Always allowed by the owner from the approval card”, so check the action, not the reason. Coworker handovers in detail shows what the rule looks like. If the file has a mistake, it’s ignored whole and every handover asks again. The editor says when a change takes effect:
Rules apply from the next turn. Actions no rule matches keep the default: sends, changes, and deletions pause for your approval.
For writing rules by hand, see Permission rules. One broader rule can cover handovers, follow-ups and stops together. Coworker handovers in detail shows how.

Sharing files

By default, only words travel. Nora gets Sam’s written request, starts with none of Sam’s session files, and sends back a written report. A file Nora makes in its session stays in Nora’s own session. When the job involves files, Sam can share its workspace with Nora instead. Then both work in the same session files: Nora can read Sam’s draft, and Sam can see what Nora saves. The card shows a shared workspace marker, with the tooltip “Both coworkers are working in the same files”.
  • Only the session files are shared. Nora’s own saved files, like its instructions and skills, stay with Nora.
  • Nothing locks a file. If both edit the same file at once, one can overwrite the other. Give each coworker different files to work on.
  • Workspace files are shared anyway. A file in Workspace files is open to every coworker, so Sam and Nora both see it with no sharing at all. Sam can point Nora at it in the request, as @files/ and its path. There too nothing locks a file, but a change that crosses another is saved beside it as a conflicted copy rather than overwriting it.
To make sure files are shared, say so when you ask, like “Share the draft with Nora so it can check the figures.”

Limits

  • Three handovers in a row, at most. Sam can hand work to Nora, Nora can pass part of it on, and that coworker can pass it on once more.
  • Inside one agent. A coworker hands work only to the coworkers in its own agent.
  • No loops. A handover never goes back to anyone already in its chain. Nora can’t hand Sam’s work back to Sam.
  • Not to itself. A coworker can’t hand work to itself.
  • Retired coworkers take no new work. A retired coworker can’t take on a handover. Sam picks someone else or does the work itself.
  • Eight waiting at once. One session can owe replies to at most eight others at a time.
  • Eight turns by default. A turn is one stretch of work. Each handover runs for up to eight turns until it finishes. Sam can allow up to 25 for a genuinely long job. When Nora’s turns run out, the card reads Needs a look. A follow-up from Sam gives Nora up to eight more.

Costs

Your workspace pays for both coworkers’ work. Nora’s research costs what any of its sessions would, on top of Sam’s. Sam also takes a turn each time news comes back. That’s why each handover asks first. The card’s usage figure counts only the other coworker’s latest turn, not the whole handover. Don’t read it as the handover’s total cost.

How it differs from dynamic workflows and custom helpers

A handover goes to a coworker you hired. A custom helper is a specialist inside one coworker. A dynamic workflow puts temporary helpers on one big job, and coworkers don’t run them for now. See how the three compare. None of this builds a workflow. For a fixed sequence of steps that runs on a trigger, see Cowork vs Workflows vs Conversation flows.

Under the hood

Each handover is a small set of actions your coworker can take: list coworkers, hand over, follow up, read, and stop. You don’t need any of it to use this. For the actions, the saved reports and the permission rules in full, see Coworker handovers in detail.

Good to know

Give each coworker a clear role. Sam picks who to ask by what each coworker is equipped to do, like its tools and connected apps. A research coworker without web search can’t research, however well Sam asks.
Name the coworker when you know who should do it. “@Nora can research their last quarter” is quicker and surer than hoping Sam picks Nora.
Reports can arrive together. If Nora and Ivy finish at almost the same moment, Sam may get one turn for both. Each report is still on its own card and in the delegations folder, and Sam is reminded to check it.
The saved reports live in the session’s files. Like all session files, they go when the session’s private workspace does. Ask Sam to save anything you want to keep.

Common questions

Not from you. Both sessions are yours, so you can open either one and read it in full. Nora sees only what Sam wrote to it, not Sam’s conversation with you. Sam can read any of your sessions with the other coworkers in its agent, not just the ones it handed over. Following up on one or stopping it asks you first, unless you’ve allowed it. Other people in your workspace don’t see your sessions.
Sam’s card turns to Needs a look and Sam picks up on its own. If Nora is waiting on a person, open Nora’s session and answer there. A follow-up from Sam would count as a new message and turn down the question or approval Nora is waiting on. Otherwise Sam can send a follow-up, read what Nora has done, or take the work back.
Yes. Open the other coworker’s session with Open session and stop it like any session. Sam’s card usually turns to Needs a look. That stops Nora’s work, not the handover: Sam is told, and may follow up if it still needs the work. Or ask Sam to call it off. That asks for your approval, then the card reads Ended. Stopping Sam’s own session doesn’t stop Nora, and Nora’s report still starts Sam again.
Yes. Your workspace pays for the other coworker’s work as well as your own coworker’s. It’s worth it when the second coworker is genuinely better at its part. That’s why every handover asks you first, unless you’ve chosen Always allow.
Not as new handovers. A handover never goes back to anyone already in its chain, and a chain stops at three handovers. Follow-ups aren’t counted, though: two coworkers in the same agent can keep messaging each other’s sessions. Each message asks for your approval unless you’ve allowed it.

Next steps

Coworker handovers in detail

The actions, saved reports and rules behind a handover.

Permission rules

Decide once what needs your yes.

Dynamic workflows

Off for coworkers for now: what a run was and what is kept.

The ready-made five

Specialists worth handing work to.