# world.ptah.version

> Published by [ptah.world](https://lexicon.garden/identity/did:plc:l45z35sxxjuobp5q65a5vu22)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:l45z35sxxjuobp5q65a5vu22/world.ptah.version)
- [Documentation](https://lexicon.garden/lexicon/did:plc:l45z35sxxjuobp5q65a5vu22/world.ptah.version/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:l45z35sxxjuobp5q65a5vu22/world.ptah.version/examples)

## Definitions

### `world.ptah.version`

**Type**: `record`

Edit history within a work. Tracks the evolution from draft to published to revised — every version, every change.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `status` | `string` | No | The status of this version |
| `createdAt` | `string` (datetime) | Yes | Timestamp when this version was created |
| `isCurrent` | `boolean` | No | Whether this is the current/active version |
| `creatorDID` | `string` (did) | Yes | The permanent identity of the version's creator |
| `versionLabel` | `string` | No | Label describing this version stage |
| `workReference` | `string` (at-uri) | Yes | Reference to the work this is a version of |
| `worldReference` | `string` (at-uri) | Yes | Reference to the world this version belongs to |
| `previousVersion` | `string` (at-uri) | No | Reference to the version this replaced (empty = first version) |
| `changeDescription` | `string` | No | What changed in this version |

## Raw Schema

```json
{
  "id": "world.ptah.version",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "creatorDID",
          "worldReference",
          "createdAt",
          "workReference"
        ],
        "properties": {
          "status": {
            "type": "string",
            "description": "The status of this version",
            "knownValues": [
              "active",
              "superseded",
              "retracted",
              "archived"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp when this version was created"
          },
          "isCurrent": {
            "type": "boolean",
            "description": "Whether this is the current/active version"
          },
          "creatorDID": {
            "type": "string",
            "format": "did",
            "description": "The permanent identity of the version's creator"
          },
          "versionLabel": {
            "type": "string",
            "maxLength": 640,
            "description": "Label describing this version stage",
            "knownValues": [
              "draft",
              "published",
              "revised",
              "corrected",
              "final"
            ],
            "maxGraphemes": 64
          },
          "workReference": {
            "type": "string",
            "format": "at-uri",
            "description": "Reference to the work this is a version of"
          },
          "worldReference": {
            "type": "string",
            "format": "at-uri",
            "description": "Reference to the world this version belongs to"
          },
          "previousVersion": {
            "type": "string",
            "format": "at-uri",
            "description": "Reference to the version this replaced (empty = first version)"
          },
          "changeDescription": {
            "type": "string",
            "maxLength": 10240,
            "description": "What changed in this version",
            "maxGraphemes": 1024
          }
        }
      },
      "description": "Edit history within a work. Tracks the evolution from draft to published to revised — every version, every change."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```