# client.projects.pinned_versions

> client.projects.pinned_versions — the projects.pinnedVersions operations.

`client.projects.pinned_versions` — the `projects.pinnedVersions` operations.

On `AsyncKindgi` every method is the same, awaited.

## `client.projects.pinned_versions.list()`

```python signature
list(
    project_id: str | UUID,
    /,
    *,
    limit: int | None = None,
    cursor: str | None = None,
    timeout: float | None = None,
) -> ProjectPinnedVersionPage
```

List the pinned versions that cover a project. `GET /v1/projects/{projectId}/pinned-versions`

Every agent's pinned versions that cover the project: the workspace's, the project's org's, the project's own and its segments', ordered by agent id, then scope. A run in the project takes the most specific one that covers it, else its agent's latest version. For readers of the project (`read`), and only the pins of agents and versions the caller can read, as `GET /v1/agents/{agentId}/pinned-versions` shows them. A page can hold fewer pins than `limit`, or none, with `hasMore` true: page on `nextCursor`, not the count. 501 `pinned-versions-not-supported` from a runtime that can't list them.