# world.ptah.trace

> 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.trace)
- [Documentation](https://lexicon.garden/lexicon/did:plc:l45z35sxxjuobp5q65a5vu22/world.ptah.trace/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:l45z35sxxjuobp5q65a5vu22/world.ptah.trace/examples)

## Definitions

### `world.ptah.trace`

**Type**: `record`

Tracks lineage between works. The paper trail from one work to another — cover, remix, adaptation, translation, sample, and more.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `createdAt` | `string` (datetime) | Yes | Timestamp when this trace was created |
| `creatorDID` | `string` (did) | Yes | The permanent identity of the trace record's creator |
| `sourceWork` | `string` (at-uri) | Yes | Reference to the original work |
| `derivedWork` | `string` (at-uri) | Yes | Reference to the work that came from the source |
| `description` | `string` | No | Context about the relationship |
| `relationship` | `string` | Yes | The type of relationship between the works |
| `worldReference` | `string` (at-uri) | Yes | Reference to the world this trace belongs to |
| `clearanceStatus` | `string` | No | Whether rights clearance has been obtained |

## Raw Schema

```json
{
  "id": "world.ptah.trace",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "creatorDID",
          "worldReference",
          "createdAt",
          "sourceWork",
          "derivedWork",
          "relationship"
        ],
        "properties": {
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp when this trace was created"
          },
          "creatorDID": {
            "type": "string",
            "format": "did",
            "description": "The permanent identity of the trace record's creator"
          },
          "sourceWork": {
            "type": "string",
            "format": "at-uri",
            "description": "Reference to the original work"
          },
          "derivedWork": {
            "type": "string",
            "format": "at-uri",
            "description": "Reference to the work that came from the source"
          },
          "description": {
            "type": "string",
            "maxLength": 10240,
            "description": "Context about the relationship",
            "maxGraphemes": 1024
          },
          "relationship": {
            "type": "string",
            "description": "The type of relationship between the works",
            "knownValues": [
              "cover",
              "remix",
              "adaptation",
              "translation",
              "sample",
              "interpolation",
              "response",
              "sequel",
              "spinoff",
              "excerpt",
              "remake",
              "fork"
            ]
          },
          "worldReference": {
            "type": "string",
            "format": "at-uri",
            "description": "Reference to the world this trace belongs to"
          },
          "clearanceStatus": {
            "type": "string",
            "description": "Whether rights clearance has been obtained",
            "knownValues": [
              "cleared",
              "pending",
              "disputed",
              "notRequired"
            ]
          }
        }
      },
      "description": "Tracks lineage between works. The paper trail from one work to another — cover, remix, adaptation, translation, sample, and more."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```