app.rocksky.event.music Documentation (EN)

Marks a community.lexicon.calendar.event as a music event (concert, festival, club night...) and links it to the artists performing. The calendar event carries the name, dates and venue; this record carries what is specific to music. Rocksky only indexes calendar events that have one of these attached.

main record

Record Key tid Timestamp-based ID

Properties

artists array of ref app.rocksky.event.music#artist Required

The lineup, in billing order.

createdAt string datetime Required

Client-declared timestamp when this record was created.

externalIds ref app.rocksky.event.music#externalIds Optional

Identifiers of the same event on ticketing and event-listing services.

genre string Optional

The main genre of the event.

maxLength: 128 bytes

imageUrl string uri Optional

Poster or banner image of the event.

kind string Optional

What sort of music event this is.

maxLength: 64 bytes

Known values: concert, festival, club-night, dj-set, livestream, release-party, listening-party

subject ref com.atproto.repo.strongRef Required

Strong reference (AT-URI + CID) to the community.lexicon.calendar.event record this annotates.

tags array of string Optional

Free-form tags (sub-genres, scene, tour name...).

ticketsUrl string uri Optional

Where tickets can be bought.

View raw schema

{
  "description": "Marks a community.lexicon.calendar.event as a music event (concert, festival, club night...) and links it to the artists performing. The calendar event carries the name, dates and venue; this record carries what is specific to music. Rocksky only indexes calendar events that have one of these attached.",
  "key": "tid",
  "record": {
    "properties": {
      "artists": {
        "description": "The lineup, in billing order.",
        "items": {
          "ref": "app.rocksky.event.music#artist",
          "type": "ref"
        },
        "type": "array"
      },
      "createdAt": {
        "description": "Client-declared timestamp when this record was created.",
        "format": "datetime",
        "type": "string"
      },
      "externalIds": {
        "description": "Identifiers of the same event on ticketing and event-listing services.",
        "ref": "app.rocksky.event.music#externalIds",
        "type": "ref"
      },
      "genre": {
        "description": "The main genre of the event.",
        "maxLength": 128,
        "type": "string"
      },
      "imageUrl": {
        "description": "Poster or banner image of the event.",
        "format": "uri",
        "type": "string"
      },
      "kind": {
        "description": "What sort of music event this is.",
        "knownValues": [
          "concert",
          "festival",
          "club-night",
          "dj-set",
          "livestream",
          "release-party",
          "listening-party"
        ],
        "maxLength": 64,
        "type": "string"
      },
      "subject": {
        "description": "Strong reference (AT-URI + CID) to the community.lexicon.calendar.event record this annotates.",
        "ref": "com.atproto.repo.strongRef",
        "type": "ref"
      },
      "tags": {
        "description": "Free-form tags (sub-genres, scene, tour name...).",
        "items": {
          "maxLength": 128,
          "type": "string"
        },
        "type": "array"
      },
      "ticketsUrl": {
        "description": "Where tickets can be bought.",
        "format": "uri",
        "type": "string"
      }
    },
    "required": [
      "subject",
      "artists",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}

artist object

An artist on the lineup.

Properties

mbid string Optional

MusicBrainz artist id.

name string Required

The artist name as billed.

maxLength: 256 bytesminLength: 1 bytes

role string Optional

The artist's billing on this event.

maxLength: 64 bytes

Known values: headliner, support, opener, dj, special-guest, performer

stage string Optional

The stage the artist plays on, for multi-stage events such as festivals.

maxLength: 256 bytes

startsAt string datetime Optional

When this artist's set starts.

uri string at-uri Optional

AT-URI of the app.rocksky.artist record, when the artist is known to Rocksky.

View raw schema

{
  "description": "An artist on the lineup.",
  "properties": {
    "mbid": {
      "description": "MusicBrainz artist id.",
      "type": "string"
    },
    "name": {
      "description": "The artist name as billed.",
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "role": {
      "description": "The artist's billing on this event.",
      "knownValues": [
        "headliner",
        "support",
        "opener",
        "dj",
        "special-guest",
        "performer"
      ],
      "maxLength": 64,
      "type": "string"
    },
    "stage": {
      "description": "The stage the artist plays on, for multi-stage events such as festivals.",
      "maxLength": 256,
      "type": "string"
    },
    "startsAt": {
      "description": "When this artist's set starts.",
      "format": "datetime",
      "type": "string"
    },
    "uri": {
      "description": "AT-URI of the app.rocksky.artist record, when the artist is known to Rocksky.",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

externalIds object

Identifiers of the event on other services.

Properties

bandsintown string Optional

No description available.

dice string Optional

No description available.

eventbrite string Optional

No description available.

residentAdvisor string Optional

No description available.

setlistfm string Optional

No description available.

songkick string Optional

No description available.

ticketmaster string Optional

No description available.

View raw schema

{
  "description": "Identifiers of the event on other services.",
  "properties": {
    "bandsintown": {
      "type": "string"
    },
    "dice": {
      "type": "string"
    },
    "eventbrite": {
      "type": "string"
    },
    "residentAdvisor": {
      "type": "string"
    },
    "setlistfm": {
      "type": "string"
    },
    "songkick": {
      "type": "string"
    },
    "ticketmaster": {
      "type": "string"
    }
  },
  "type": "object"
}