# Armature Operators

`bpy.ops.armature.``align`()

  Align selected bones to the active bone (or to their parent)

`bpy.ops.armature.``armature_layers`(layers=(False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False))

  Change the visible armature layers

  Parameters: | layers (boolean array of 32 items, (optional)) – Layer, Armature layers to make visible

`bpy.ops.armature.``autoside_names`(type='XAXIS')

  Automatically renames the selected bones according to which side of the target axis they fall on

  Parameters: | type (enum in [‘XAXIS’, ‘YAXIS’, ‘ZAXIS’], (optional)) – Axis, Axis tag names with `XAXIS` X-Axis, Left/Right. `YAXIS` Y-Axis, Front/Back. `ZAXIS` Z-Axis, Top/Bottom.

`bpy.ops.armature.``bone_layers`(layers=(False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False))

  Change the layers that the selected bones belong to

  Parameters: | layers (boolean array of 32 items, (optional)) – Layer, Armature layers that bone belongs to

`bpy.ops.armature.``bone_primitive_add`(name="Bone")

  Add a new bone located at the 3D-Cursor

  Parameters: | name (string, (optional, never None)) – Name, Name of the newly created bone

`bpy.ops.armature.``calculate_roll`(type='POS_X', axis_flip=False, axis_only=False)

  Automatically fix alignment of select bones’ axes

  Parameters: | type (enum in [‘POS_X’, ‘POS_Z’, ‘GLOBAL_POS_X’, ‘GLOBAL_POS_Y’, ‘GLOBAL_POS_Z’, ‘NEG_X’, ‘NEG_Z’, ‘GLOBAL_NEG_X’, ‘GLOBAL_NEG_Y’, ‘GLOBAL_NEG_Z’, ‘ACTIVE’, ‘VIEW’, ‘CURSOR’], (optional)) – Type axis_flip (boolean, (optional)) – Flip Axis, Negate the alignment axis axis_only (boolean, (optional)) – Shortest Rotation, Ignore the axis direction, use the shortest rotation to align

`bpy.ops.armature.``click_extrude`()

  Create a new bone going from the last selected joint to the mouse position

`bpy.ops.armature.``delete`()

  Remove selected bones from the armature

`bpy.ops.armature.``dissolve`()

  Dissolve selected bones from the armature

`bpy.ops.armature.``duplicate`()

  Make copies of the selected bones within the same armature

`bpy.ops.armature.``duplicate_move`(ARMATURE_OT_duplicate=None, TRANSFORM_OT_translate=None)

  Make copies of the selected bones within the same armature and move them

  Parameters: | ARMATURE_OT_duplicate (`ARMATURE_OT_duplicate`, (optional)) – Duplicate Selected Bone(s), Make copies of the selected bones within the same armature TRANSFORM_OT_translate (`TRANSFORM_OT_translate`, (optional)) – Translate, Translate (move) selected items

`bpy.ops.armature.``extrude`(forked=False)

  Create new bones from the selected joints

  Parameters: | forked (boolean, (optional)) – Forked

`bpy.ops.armature.``extrude_forked`(ARMATURE_OT_extrude=None, TRANSFORM_OT_translate=None)

  Create new bones from the selected joints and move them

  Parameters: | ARMATURE_OT_extrude (`ARMATURE_OT_extrude`, (optional)) – Extrude, Create new bones from the selected joints TRANSFORM_OT_translate (`TRANSFORM_OT_translate`, (optional)) – Translate, Translate (move) selected items

`bpy.ops.armature.``extrude_move`(ARMATURE_OT_extrude=None, TRANSFORM_OT_translate=None)

  Create new bones from the selected joints and move them

  Parameters: | ARMATURE_OT_extrude (`ARMATURE_OT_extrude`, (optional)) – Extrude, Create new bones from the selected joints TRANSFORM_OT_translate (`TRANSFORM_OT_translate`, (optional)) – Translate, Translate (move) selected items

`bpy.ops.armature.``fill`()

  Add bone between selected joint(s) and/or 3D-Cursor

`bpy.ops.armature.``flip_names`()

  Flips (and corrects) the axis suffixes of the names of selected bones

`bpy.ops.armature.``hide`(unselected=False)

  Tag selected bones to not be visible in Edit Mode

  Parameters: | unselected (boolean, (optional)) – Unselected, Hide unselected rather than selected

`bpy.ops.armature.``layers_show_all`(all=True)

  Make all armature layers visible

  Parameters: | all (boolean, (optional)) – All Layers, Enable all layers or just the first 16 (top row)

`bpy.ops.armature.``merge`(type='WITHIN_CHAIN')

  Merge continuous chains of selected bones

  Parameters: | type (enum in [‘WITHIN_CHAIN’], (optional)) – Type

`bpy.ops.armature.``parent_clear`(type='CLEAR')

  Remove the parent-child relationship between selected bones and their parents

  Parameters: | type (enum in [‘CLEAR’, ‘DISCONNECT’], (optional)) – ClearType, What way to clear parenting

`bpy.ops.armature.``parent_set`(type='CONNECTED')

  Set the active bone as the parent of the selected bones

  Parameters: | type (enum in [‘CONNECTED’, ‘OFFSET’], (optional)) – ParentType, Type of parenting

`bpy.ops.armature.``reveal`()

  Unhide all bones that have been tagged to be hidden in Edit Mode

`bpy.ops.armature.``select_all`(action='TOGGLE')

  Toggle selection status of all bones

  Parameters: | action (enum in [‘TOGGLE’, ‘SELECT’, ‘DESELECT’, ‘INVERT’], (optional)) – Action, Selection action to execute `TOGGLE` Toggle, Toggle selection for all elements. `SELECT` Select, Select all elements. `DESELECT` Deselect, Deselect all elements. `INVERT` Invert, Invert selection of all elements.

`bpy.ops.armature.``select_hierarchy`(direction='PARENT', extend=False)

  Select immediate parent/children of selected bones

  Parameters: | direction (enum in [‘PARENT’, ‘CHILD’], (optional)) – Direction extend (boolean, (optional)) – Extend, Extend the selection

`bpy.ops.armature.``select_less`()

  Deselect those bones at the boundary of each selection region

`bpy.ops.armature.``select_linked`(extend=False)

  Select bones related to selected ones by parent/child relationships

  Parameters: | extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first

`bpy.ops.armature.``select_mirror`(only_active=False, extend=False)

  Mirror the bone selection

  Parameters: | only_active (boolean, (optional)) – Active Only, Only operate on the active bone extend (boolean, (optional)) – Extend, Extend the selection

`bpy.ops.armature.``select_more`()

  Select those bones connected to the initial selection

`bpy.ops.armature.``select_similar`(type='LENGTH', threshold=0.1)

  Select similar bones by property types

  Parameters: | type (enum in [‘LENGTH’, ‘DIRECTION’, ‘PREFIX’, ‘SUFFIX’, ‘LAYER’], (optional)) – Type threshold (float in [0, 1], (optional)) – Threshold

`bpy.ops.armature.``separate`()

  Isolate selected bones into a separate armature

`bpy.ops.armature.``shortest_path_pick`()

  Select shortest path between two bones

`bpy.ops.armature.``split`()

  Split off selected bones from connected unselected bones

`bpy.ops.armature.``subdivide`(number_cuts=1)

  Break selected bones into chains of smaller bones

  Parameters: | number_cuts (int in [1, 1000], (optional)) – Number of Cuts

`bpy.ops.armature.``switch_direction`()

  Change the direction that a chain of bones points in (head <-> tail swap)

`bpy.ops.armature.``symmetrize`(direction='NEGATIVE_X')

  Enforce symmetry, make copies of the selection or use existing

  Parameters: | direction (enum in [‘NEGATIVE_X’, ‘POSITIVE_X’], (optional)) – Direction, Which sides to copy from and to (when both are selected)