The following example is from the official clipSchedule documentation found here.
# Query the clip index of the latest instance of handWave. Each instance
# of a clip received a unique clipIndex. The clip index is used to
# edit and query data for existing clips.
#
cmds.clipSchedule( 'armScheduler1', name='handWave1', query=True, ci=True )
This does not return the clip index of 'handWave1', and instead will always return the clip scheduled at index[1], due to the True statement in the clip index parameter.
This is not the described or desired behavior.
Here is additional code for testing on any character that has more than 1 animation scheduled.
character = mel.eval("currentCharacters")
scheduler = cmds.character(character, query=True, scheduler=True)
selection = cmds.ls(selection=True, long=True)
clipIndex = cmds.clipSchedule(scheduler, name=selection, query=True, ci=True)
# result = The name of the clip at index [1], not the index for the clip name that was given.
