# Get Session — Hedy

> Retrieves full details for a single Hedy meeting session by ID, including the complete transcript, meeting minutes, recap, session notes, highlights array, and action items (todos). Use Get Many Sessions first to list sessions and obtain a…

- Key: `hedy-get-session`
- Type: Action (Read-only)
- Version: 0.0.2
- App: Hedy (`hedy`) — https://pipedream.com/apps/hedy.md
- This page (HTML): https://pipedream.com/apps/hedy/actions/get-session
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/hedy/actions/get-session/get-session.mjs

## Description

Retrieves full details for a single Hedy meeting session by ID, including the complete transcript, meeting minutes, recap, session notes, highlights array, and action items (todos). Use **Get Many Sessions** first to list sessions and obtain a session ID. [See the documentation](https://app.swaggerhub.com/apis-docs/HedyAI/hedy-api/1.5.2#/Sessions/get_sessions__sessionId_)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `sessionId` | `string` | Yes | The unique identifier of the meeting session (e.g., ses_0123abcd). Use Get Many Sessions to list available session IDs. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "hedy",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "hedy-get-session",
  arguments: {
    sessionId: "Session ID",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "hedy-get-session",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    hedy: { authProvisionId: "apn_xxxxxxx" },
    sessionId: "Session ID",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "hedy-get-session",
    "configured_props": {
      "hedy": { "authProvisionId": "apn_xxxxxxx" },
      "sessionId": "Session ID"
    }
  }'
```

---

- App: https://pipedream.com/apps/hedy.md · All apps: https://pipedream.com/apps