---
title: "tool si.act.invite"
description: "an address and a role: the invitation, open, with its expiry."
section: reference
address: /reference/tools/si-act-invite
contract: 0476e35e6e275db5
---

# tool si.act.invite

an address and a role: the invitation, open, with its expiry.

[figure: Over MCP, si.act.invite takes InviteInput and returns a card whose body is Invitation.]

the invitation, open, with its expiry. The call needs the admin grant at the tenant rung.



| | |
|---|---|
| input | [InviteInput](/concepts/inviteinput) |
| result | a card whose body is [Invitation](/concepts/invitation) |
| read-only | no |
| destructive | yes |
| card address | `ui://scale-intelligence/cards/Invitation` |
| HTTP route | [`/v1/act/invite`](/reference/act/invite) |





| field | type | required | note |
|---|---|---|---|
| `address` | `text` | yes |  |
| `role` | `text` | yes |  |
| `held_on` | [Scope](/concepts/scope) | no | the tenant, brand or strategy the role is held on; absent means the whole tenant, which a guest may not hold (a guest holds roles only on the brands they were invited to) |