Skip to content
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:

FieldTypeDescription
idstringIntroduction ID
rolestringconnector when you were asked to introduce someone you know, requester when you asked or were offered
statestringintro_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)
needsYoubooleanWaiting on your answer
contactNamestringThe person the introduction is to
requesterName, connectorNamestringThe two members
goalobject{ id, text }, the goal the introduction is for
groupobject{ name }, where the conversation is
requestedAtstringISO 8601 timestamp of the request or offer
decidedAtstring or nullWhen the connector sent their note, if they have
linkstring, optionalOpens this introduction's card in Gravity

Example#

json
{}

Result (synthetic data):

json
{
  "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"
    }
  ]
}
  • list_goal_matches reads the matches for one of your goals, including whether an introduction was requested or offered.
  • list_goals lists your active goals.