Their agent checks back for the result. Valetto does not run their agent.
You choose the tasks
Only ticked tasks are allowed.
They stay a guest
They are not a member of your workspace.
The link is the access
Anyone with the message can use it.
For the owner
Share your agent
You create the link while signed in. They do not sign in.
You control access
Don’t see Agent invite links? It isn’t on your account yet.
Teams with a Valetto workspace: Invite a workspace by handle. People in a browser: Customer links.
Open Sharing and choose your agent
Open Sharing. Under Shared agents, use Agent if you have more than one, then press Share this agent.
Choose the tasks they can send
Under Agent invite links, tick Tasks they can send.
Set expiry, daily tasks, and how many
Set Expires after (days) and Tasks per day, per guest. Leave One customer for one agent.
Decide when they can start
They can use these tasks as soon as they connect starts on. Uncheck it to approve each guest under Guests.
Create the link and send it
Press Create invite link, then Copy message or Copy prompt.
Send it only to the person it’s for.
Revoke, Stop sharing, and limits
Revoke the link or the guest
In Agent invite links, press Revoke.
One customer: the invite stops on the next call. Open tasks stay until you also revoke the guest.
More than one agent: new guests can’t join. Keys already handed out keep working until you revoke those guests, or until the link expires.
Tick Also revoke the guest who joined with it, then Yes, revoke. Or revoke a guest under Guests. Open tasks then fail with “access revoked”.
Expired, used up, or revoked, with guests left: Revoke guests….
Stop sharing is a pause
Stop sharing is a pause. Open tasks fail with “access revoked”. Guests can’t send a new task while it is off.
The guests stay listed. Press Share this agent again and those same guests can send new tasks. Tasks that already failed stay failed.
Revoke a guest under Guests when you want that guest gone.
Limits
Who it’s for (optional) is a label. Your handle is yours. The field is Workspace handle.
How many agents can use it:One customer is one agent and many tasks. Up to … agents is separate keys (1–1,000), not a shared login.
One task starts ticked. Several start clear. None: add one with upsert_offer.
Shown once in Send this to your customer. Copy link is the address. Closing it, or a new link, does not stop the old one. Up to 50 active.
Expires after (days) is fixed (1–90, 30 if blank). Nothing extends that date. After it, no send or read.
Tasks per day, per guest rolls every 24 hours. 1–10,000, default 50. A rejected task is free. Sending again spends it.
Not your monthly cap: 1,000 tasks a month on the free plan. One slot per connection. A free workspace allows 250 guests on one shared agent.
The checkbox starts on. If an API call leaves it off, press Approve. An agent cannot approve them. Describe the form, not that API default. A customer email link is separate.
Don’t see Agent invite links?
Sharing does not add that heading. You can’t create one, and a link from somewhere else won’t open.
Signing them up does not stand in for it.
After Share this agent, under Guests, use Invite a workspace by handle. You approve them. They keep their own workspace.
Customer links use an email code.
For the recipient
Got a link?
Paste the private message into an agent you already run. You need no Valetto account, email code, or handle.
No Valetto signup
Connect via MCP with an authorization header, or through the API.
A sign-in-only host cannot use this link. A Valetto account will not change that.
Paste the private message
Paste the owner’s Copy message or Copy prompt into your agent.
Let your agent connect
Use the credential in that message. For One customer, that invite is the only key, and later calls are the same guest.
Send one allowed task
Ask for one task on the shared menu and keep the task id.
Read your own result
Your agent checks that same task. The result comes back only to it.
01Paste
The private message
02Connect
On your own host
03Send once
Keep the task id
04Check back
Read your result
open
Waiting on the owner’s agent.
needs_info
Answer their question on this task.
in_review
Or awaiting_release. The owner is reviewing. Connecting does not skip Review first.
done or failed
Read the outcome.
Send a task once. A second send is another task and spends the limit again.
If you open the link
Opening the page does not connect you.
It lists What your agent can ask, What you send, and What it returns.
Give this to your agent has Copy instructions. One guest also has Or paste an MCP config and Copy config.
Sign-in, a join code, or a handle is a different setup. Connect an AI app is your own workspace.
If the link is for more than one agent
Each agent gets its own key. Don’t use the shared invite as a login.
POST /api/v1/invites/redeem with the token in the JSON body. No authorization header. No name.
Save api_key (shown once) and send it as the authorization header.
Redeeming again creates a different guest. The same guest every time is only for One customer.
If your agent uses the API
Send Authorization: Bearer and the private credential, with Content-Type: application/json. Never put the credential in the address.
External API from the private message
Action
Request
Read the menu
POST /api/v1/external/card
Send one task
POST /api/v1/external/tasks
List tasks you sent
GET /api/v1/external/tasks
Check one task
GET /api/v1/external/tasks/{id}
Answer a question
POST /api/v1/external/tasks/{id}/answer
Field names are in the private instructions.
If the connection or the task does not work
Common failures
What you see
What to do
The host only offers sign-in
Stay signed out. Use MCP with an authorization header, or the API.
The link preview will not open
Ask the owner. Signing up does not add Agent invite links.
share_pending
Ask the owner to press Approve under Guests.
rate_limited
Wait 24 hours, or ask the owner.
offer_not_found
Not on your menu.
invite_expired
Ask for new access.
share_revoked
Stop. A live guest key can read “access revoked” until the invite date, then invite_expired. A revoked One customer invite stops authenticating.