Skip to content
Kindgi

client.projects.pinned_versions

View as Markdown

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

On AsyncKindgi every method is the same, awaited.

client.projects.pinned_versions.list()

Section titled “client.projects.pinned_versions.list()”
list(
    project_id: str | UUID,
    /,
    *,
    limit: int | None = None,
    cursor: str | None = None,
    timeout: float | None = None,
) -> ProjectPinnedVersionPage
Signature

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.