[Tools](https://oods-foundry.com/tools) / design_versions

# `design_versions`

Read a composition's versions and accepted version.

Generated from @oods/foundry 0.11.0

One of the 26 tools your assistant sees by default.

Use it when inspecting saved lineage; use design_preview to render, edit, compare or accept. Returns version metadata, latest and acceptance summary. Supply compositionId. Starts no preview host and returns no running URL. Full schema: oods\://schemas/design_versions.input.json.

## Inputs

| Name | Type | Required | Description |
| - | - | - | - |
| `action` | `"versions"` | no | Choose versions. |
| `compositionId` | `string` | yes | An existing composition from design_compose; with no version, its latest version opens. |

## Outputs

| Name | Type | Required | Description |
| - | - | - | - |
| `status` | `"ok"` | yes | |
| `action` | `"versions"` | yes | |
| `compositionId` | `string` | yes | |
| `latest` | `integer \| null` | yes | |
| `versions` | `object[]` | yes | |
| `accepted` | `null \| object` | yes | The standing acceptance (the last one in accepted.json), or null when no version was accepted. |
| `durationMs` | `number` | yes | |

## A real call

Recorded by this site's `tools` run, step `design-versions`, with the published OODS Foundry 0.11.0.

Its input:

```
{
  "compositionId": "cmp-c49f93626dd7"
}
```

Its result:

```
{
  "status": "ok",
  "action": "versions",
  "compositionId": "cmp-c49f93626dd7",
  "latest": 1,
  "versions": [
    {
      "version": 1,
      "parentVersion": null,
      "operation": "compose",
      "createdAt": "2026-10-09T05:48:46.621Z",
      "schemaHash": "sha256:934f0ddf15a7b59cca66d7d70992ab750ecb457ef3f9b22d1879057e58c4d79d",
      "head": "74da4ff4cee8b8cb6857e24195f8ec3d1a63f130",
      "artifacts": []
    }
  ],
  "accepted": null,
  "durationMs": 0.5983340000000226
}
```

[The whole call, 1 KB of JSON](https://oods-foundry.com/tools/design-versions/call.json)