# Get Session Context — Hedy

> Retrieves full details for a single reusable Hedy session context by ID, including the title, content, and whether it is the default context. Session contexts are reusable custom AI instruction sets that guide Hedy's analysis across…

- Key: `hedy-get-session-context`
- 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-context
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/hedy/actions/get-session-context/get-session-context.mjs

## Description

Retrieves full details for a single reusable Hedy session context by ID, including the title, content, and whether it is the default context. Session contexts are reusable custom AI instruction sets that guide Hedy's analysis across multiple meetings. Use **Get Many Session Contexts** first to list available contexts and obtain a context ID. [See the documentation](https://app.swaggerhub.com/apis-docs/HedyAI/hedy-api/1.5.2#/Session%20Contexts/get_contexts__contextId_)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `contextId` | `string` | Yes | The unique identifier of the session context (e.g., ctx_456def). Use Get Many Session Contexts to list available context 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-context",
  arguments: {
    contextId: "Context 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-context",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    hedy: { authProvisionId: "apn_xxxxxxx" },
    contextId: "Context 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-context",
    "configured_props": {
      "hedy": { "authProvisionId": "apn_xxxxxxx" },
      "contextId": "Context ID"
    }
  }'
```

---

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