Navigation :

Key Signature

A key_signature object specifies a music key signature.

Data Item	Type	Required/ Optional	Description
`tonic`	text	optional	The tonic of the scale. If omitted, the Composer selects the tonic automatically. See below for valid values
`quality`	text	optional	The scale quality. If omitted, the Composer selects the quality automatically. See below for valid values

Note: A particular descriptor typically supports only a subset of quality types. If a quality is provided which the descriptor for the active region does not support, it will be changed.

Values for tonic are a text representation of a musical note consisting of a letter and accidental.

Valid values for letter are:

Valid values for accidental are:

eses (double flat)
es (flat)
<empty string> (natural)
is (sharp)
isis (double sharp)

Examples:

Musical Note	`tonic` Value
C^♯	`cis`
D^𝄫	`deses`
E^♮	`e`
B^♭	`bes`

Valid values for quality are available form the entities endpoint under data.attributes.tags with a category key named scale_quality.

Example:

{
    "tonic": "bes",
    "quality": "major"
}