> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List private links

> Lists private scheduling links for an event type.

`calcom.listPrivateLinks` lists private scheduling links for an event type.

```ts automations/list-private-links.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { calcom } from "automate.ax/calcom"

export default automation("List private links", () => {
  markSignificant(calcom.listPrivateLinks({ eventTypeId: 23 }))
})
```

## Input

Pass these fields:

| Field         | Type      | Required | Description             |
| ------------- | --------- | -------- | ----------------------- |
| `eventTypeId` | `integer` | Yes      | Must be greater than 0. |

## Output

Returns an array containing time-based and usage-based links. Both variants include:

| Field         | Type           | Required | Description                    |
| ------------- | -------------- | -------- | ------------------------------ |
| `linkId`      | `string`       | Yes      | Private link identifier.       |
| `eventTypeId` | `number`       | Yes      | Event type that owns the link. |
| `isExpired`   | `boolean`      | Yes      | Whether the link has expired.  |
| `bookingUrl`  | `string (uri)` | Yes      | Full private booking URL.      |

A time-based link also has required `expiresAt: string`. A usage-based link instead has required `maxUsageCount: number` and `usageCount: number`.

Cal.com enforces account role, plan, and availability requirements. Provider rejections surface as structured action failures with the HTTP status and any `Retry-After` delay.