Browse docslist_introductions
list_introductions
Lists introductions under way between you and other members, those waiting on you first.
Annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false
When to use it#
For "what needs me in Gravity?", "is anyone waiting on me?", or a regular check-in on the member's introductions. It covers both sides: requests a member asked you to make, offers a member made you, and the ones you're waiting on. Introductions on ended goals, and declined ones, aren't listed.
Answering happens in Gravity. For each one with needsYou, say who wants an introduction to whom and for which goal, and give its link. Don't claim anyone is willing, and don't contact anyone.
Inputs#
No inputs.
Returns#
{ "introductions": [...] }, those waiting on you first, then newest first. Each introduction has:
| Field | Type | Description |
|---|---|---|
id | string | Introduction ID |
role | string | connector when you were asked to introduce someone you know, requester when you asked or were offered |
state | string | intro_waiting (asked, waiting on the connector), intro_offered (offered, waiting on the requester), or intro_ask_sent (the connector sent their note to the person) |
needsYou | boolean | Waiting on your answer |
contactName | string | The person the introduction is to |
requesterName, connectorName | string | The two members |
goal | object | { id, text }, the goal the introduction is for |
group | object | { name }, where the conversation is |
requestedAt | string | ISO 8601 timestamp of the request or offer |
decidedAt | string or null | When the connector sent their note, if they have |
link | string, optional | Opens this introduction's card in Gravity |
Example#
{}
Result (synthetic data):
{
"introductions": [
{
"id": "00000000-0000-4000-a000-000000000002",
"role": "connector",
"state": "intro_waiting",
"needsYou": true,
"contactName": "Synthetic candidate",
"requesterName": "Synthetic member",
"connectorName": "Synthetic connector",
"goal": { "id": "00000000-0000-4000-a000-000000000001", "text": "Find design partners" },
"group": { "name": "Synthetic founders" },
"requestedAt": "2026-10-09T00:00:00.000Z",
"decidedAt": null,
"link": "https://www.meetgravity.ai/dashboard/agent?request=00000000-0000-4000-a000-000000000002"
}
]
}
Related#
list_goal_matchesreads the matches for one of your goals, including whether an introduction was requested or offered.list_goalslists your active goals.