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

# Agent Skill Versions

> SDK methods to list, retrieve, and manage versions of agent skills in TrueFoundry.

## Methods

<Accordion title="get">
  Parameters

  #### Parameters

  <ParamField body="agent_skill_version_id" type="str" required />

  #### Returns

  <ResponseField name="GetAgentSkillVersionResponse" type="GetAgentSkillVersionResponse">
    [🔗 GetAgentSkillVersionResponse](/docs/truefoundry_sdk/types#getagentskillversionresponse)

    Successful Response
  </ResponseField>

  #### Usage

  ```python lines theme={"dark"}
  from truefoundry import TrueFoundry

  client = TrueFoundry(
      api_key="YOUR_API_KEY",
      base_url="https://yourhost.com/path/to/api",
  )

  client.agent_skill_versions.get(
      agent_skill_version_id="value",
  )
  ```
</Accordion>

<Accordion title="delete">
  Parameters

  #### Parameters

  <ParamField body="agent_skill_version_id" type="str" required />

  #### Returns

  <ResponseField name="EmptyResponse" type="EmptyResponse">
    [🔗 EmptyResponse](/docs/truefoundry_sdk/types#emptyresponse)

    Successful Response
  </ResponseField>

  #### Usage

  ```python lines theme={"dark"}
  from truefoundry import TrueFoundry

  client = TrueFoundry(
      api_key="YOUR_API_KEY",
      base_url="https://yourhost.com/path/to/api",
  )

  client.agent_skill_versions.delete(
      agent_skill_version_id="value",
  )
  ```
</Accordion>

<Accordion title="list">
  List agent skill versions. Each manifest has `source.type` `blob-storage` and `description` only; use GET for full SKILL.md content.

  #### Parameters

  <ParamField body="fqn" type="typing.Optional[str]">
    FQN filter for agent skill versions
  </ParamField>

  <ParamField body="agent_skill_id" type="typing.Optional[str]">
    Parent agent skill artifact ID
  </ParamField>

  <ParamField body="ml_repo_id" type="typing.Optional[str]">
    ML Repo ID filter
  </ParamField>

  <ParamField body="name" type="typing.Optional[str]">
    Agent skill name filter
  </ParamField>

  <ParamField body="version" type="typing.Optional[int]">
    Version number or 'latest'
  </ParamField>

  <ParamField body="offset" type="typing.Optional[int]">
    Pagination offset
  </ParamField>

  <ParamField body="limit" type="typing.Optional[int]">
    Page size
  </ParamField>

  #### Returns

  <ResponseField name="SyncPager[AgentSkillVersion, ListAgentSkillVersionsResponse]" type="SyncPager[AgentSkillVersion, ListAgentSkillVersionsResponse]">
    [🔗 ListAgentSkillVersionsResponse](/docs/truefoundry_sdk/types#listagentskillversionsresponse)

    Successful Response
  </ResponseField>

  #### Usage

  ```python lines theme={"dark"}
  from truefoundry import TrueFoundry

  client = TrueFoundry(
      api_key="YOUR_API_KEY",
      base_url="https://yourhost.com/path/to/api",
  )

  client.agent_skill_versions.list(
      fqn="value",
      agent_skill_id="value",
      ml_repo_id="value",
      name="value",
      version="value",
      offset=10,
      limit=10,
  )

  # Iterate through results
  for item in response:
      print(item.name)

  # Or paginate page by page
  for page in response.iter_pages():
      for item in page:
          print(item.name)
  ```
</Accordion>