# BuildFace

Trains Media Server to recognize a face.

You can only run this action after creating a face (using the action NewFace) and adding suitable images (using the action AddFaceImages).

Type: asynchronous

Parameter | Description | Required
--- | --- | ---
`database` | The name of the database that contains the face. | Yes
`identifier` | The identifier of the face that you want to train Media Server to recognize. | Yes
`numparallel` | The maximum number of threads that the action can use (default 1). | No

## Example

    /action=BuildFace&database=politicians&identifier=JohnSmith

## Response

This action is asynchronous, so Media Server always returns success accompanied by a token:

    <autnresponse>
      <action>BUILDFACE</action>
      <response>SUCCESS</response>
      <responsedata>
        <token>MTAuMi4xMDQuNTQ6MTgwMDA6VFJBSU5GQUNFOjE0MjkyNzE0NjAwMDQ1Ni0xMzAyMzQ3MDI2</token>
      </responsedata>
    </autnresponse>

You can use this token with the QueueInfo action to retrieve the status of the action:

    <autnresponse>
      <action>QUEUEINFO</action>
      <response>SUCCESS</response>
      <responsedata>
        <actions>
          <action>
            <status>Finished</status>
            <queued_time>2015-Apr-17 12:51:00</queued_time>
            <time_in_queue>0</time_in_queue>
            <process_start_time>2015-Apr-17 12:51:00</process_start_time>
            <time_processing>1</time_processing>
            <process_end_time>2015-Apr-17 12:51:01</process_end_time>
            <database>politicians</database>
            <identifier>JohnSmith</identifier>
            <numImages>3</numImages>
            <numTrained>3</numTrained>
            <token>MTAuMi4xMDQuNTQ6MTgwMDA6VFJBSU5GQUNFOjE0MjkyNzE0NjAwMDQ1Ni0xMzAyMzQ3MDI2</token>
            <build>
              <image>
                <index>1</index>
                <label>image1</label>
                <status>trained</status>
              </image>
              <image>
                <index>2</index>
                <label>image2</label>
                <status>trained</status>
              </image>
              <image>
                <index>3</index>
                <label>image3</label>
                <status>trained</status>
              </image>
            </build>
          </action>
        </actions>
      </responsedata>
    </autnresponse>

_FT_HTML5_bannerTitle.htm