# at.atmosynth.part

> Published by [atmosynth.at](https://lexicon.garden/identity/did:plc:fzjkahpwapmoqxybwdjb6ysf)

✓ This is the authoritative definition for this NSID.

## Description

Tracks written for somebody else's arrangement, held in the repository of whoever wrote them. Nobody can write into another account's repository, so a contribution is offered rather than added: it names the arrangement it is for, and becomes part of that arrangement only when the arrangement's creator includes it by address. It stays its writer's, under their name, and what they change in it changes what the arrangement plays.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:fzjkahpwapmoqxybwdjb6ysf/at.atmosynth.part)
- [Documentation](https://lexicon.garden/lexicon/did:plc:fzjkahpwapmoqxybwdjb6ysf/at.atmosynth.part/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:fzjkahpwapmoqxybwdjb6ysf/at.atmosynth.part/examples)

## Definitions

### `at.atmosynth.part`

**Type**: `record`

A part, held in its writer's own repository.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `createdAt` | `string` (datetime) | Yes |  |
| `description` | `string` | No |  |
| `for` | `ref` → `com.atproto.repo.strongRef` | Yes | The arrangement this part is for, and the version of it the part was played against, so its creator can see whether the arrangement has changed since. |
| `license` | `ref` → `at.atmosynth.defs#license` | No |  |
| `lineage` | `array` | No |  |
| `name` | `string` | No |  |
| `tracks` | `array` | Yes | The part's instrument and audio tracks, never a bus: the busses are the arrangement's. Their ids are unique within the part and do not collide with the arrangement's own, and their `to`, sends and sidechains may name the arrangement's busses and tracks. Their ticks are the arrangement's. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A part, held in its writer's own repository.",
      "key": "tid",
      "record": {
        "properties": {
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "maxLength": 3000,
            "type": "string"
          },
          "for": {
            "description": "The arrangement this part is for, and the version of it the part was played against, so its creator can see whether the arrangement has changed since.",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "license": {
            "ref": "at.atmosynth.defs#license",
            "type": "ref"
          },
          "lineage": {
            "items": {
              "ref": "at.atmosynth.defs#lineage",
              "type": "ref"
            },
            "maxLength": 64,
            "type": "array"
          },
          "name": {
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "tracks": {
            "description": "The part's instrument and audio tracks, never a bus: the busses are the arrangement's. Their ids are unique within the part and do not collide with the arrangement's own, and their `to`, sends and sidechains may name the arrangement's busses and tracks. Their ticks are the arrangement's.",
            "items": {
              "ref": "at.atmosynth.defs#track",
              "type": "ref"
            },
            "maxLength": 32,
            "minLength": 1,
            "type": "array"
          }
        },
        "required": [
          "for",
          "tracks",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "Tracks written for somebody else's arrangement, held in the repository of whoever wrote them. Nobody can write into another account's repository, so a contribution is offered rather than added: it names the arrangement it is for, and becomes part of that arrangement only when the arrangement's creator includes it by address. It stays its writer's, under their name, and what they change in it changes what the arrangement plays.",
  "id": "at.atmosynth.part",
  "lexicon": 1
}
```
