User:Bitmap/Relationship Editor Parameters

This page documents a list of parameters you can POST to the relationship editor to add/edit/remove relationships. The relationships don't have to be on the same release.

Requests are sent to: http://musicbrainz.org/relationship-editor

You'll receive a JSON response with a "message" key telling you OK, or that there were errors (stored in the "errors" key).

Relationships

All relationship data is prefixed with rel-editor.rels.n, where n is an integer unique to each relationship.

Boolean values are either "0" or "1".

action

Must be one of: "edit" (if changing an existing relationship), "add" (if adding a new relationship), or "remove" (if removing a relationship). Required.

id

The integer ID of the relationship. Required if action is "edit" or "remove".

link_type

The integer ID of the relationship type. Required.

entity.n.gid

The MBID of entity n in the relationship. Required.

n is either "0" or "1". The entities must be in the correct order for their link type (e.g. for an artist-recording relationship, the artist must be entity.0 and the recording must be entity.1). See http://musicbrainz.org/relationships for a list of relationship types and the direction of their entities.

entity.n.type

Must be one of: "artist", "label", "recording", "release", "release_group", or "work". Required.

period.begin_date.year

period.begin_date.month

period.begin_date.day

period.end_date.year

period.end_date.month

period.end_date.day

period.ended

Integer year/month/day, boolean ended. Optional.

attrs.foo

attrs.foo.n

Use the former syntax for boolean attributes (e.g. attrs.additional), and the latter for multi-valued attributes (e.g. attrs.vocal.0, attrs.vocal.1). Optional.

Other data

rel-editor.edit_note

Specify the contents of an edit note.

rel-editor.as_auto_editor

Whether to submit the edits with auto-editor privileges.

Example

{
    "rel-editor.rels.0.action":           "edit",
    "rel-editor.rels.0.attrs.additional": 0,
    "rel-editor.rels.0.attrs.translated": 0,
    "rel-editor.rels.0.entity.0.gid":     "ba550d0e-adac-4864-b88b-407cab5e76af",
    "rel-editor.rels.0.entity.0.type":    "artist",
    "rel-editor.rels.0.entity.1.gid":     "a8a158e3-0a0e-37e1-b5b5-9480a02d816e",
    "rel-editor.rels.0.entity.1.type":    "work",
    "rel-editor.rels.0.id":               15929,
    "rel-editor.rels.0.link_type":        169,
    "rel-editor.edit_note":               "removing all of the attributes because reasons"
}