Multiple Loads in a Job

The Bulk API allows you to include multiple imports in a single job (up to a limit of 20). This is useful for sync-based integrations where several data types need to be synced between an external system and Cornerstone. For example, if you are building an integration between an HRIS and Cornerstone, you can include all your OU imports and the employee import in a single job. Here's an example with employee and division load.

POST /services/api/x/bulk-api/v1/jobs
curl -X POST \
  https://{corpname}.csod.com/services/api/x/bulk-api/v1/jobs \
  -H 'Authorization: Bearer ZWRnZQ:c735e413581745786128827e5e0caeecee75c657130e112da8c247e4628dd188' \
  -H 'Content-Type: application/json' \
  -d '{
    "label":"HRIS Sync",
    "callback":"https://www.acme.com/csod-bulkApi/Callback",
    "imports":[
      {
        "type":"ou.division",
        "label":"HRIS Division Load",
        "settings":{
          "datetime_culture":"en-US",
          "number_culture":"en-US",
          "AllowInactiveOuAndUser":true,
          "use_default_when_missing":true,
          "default_culture":"en-US"
        }
      },
      {
        "type":"chr.employee",
        "label":"HRIS Employee Load",
        "settings":{
          "datetime_culture":"en-US",
          "number_culture":"en-US",
          "LoadPrimaryKey":0,
          "ReconcileUsers":false,
          "AllowInactiveOus":true,
          "AllowInactiveUsers":true,
          "use_default_when_missing":true,
          "default_culture":"en-US"
        }
      }
    ]
  }'

This not only makes it easy to manage the integration, but it also lets you take advantage of a feature in Bulk APIs called 'dependency resolution'. With dependency resolution, Bulk APIs are able to resolve any inter load dependencies provided the loads are in a single job. For example, if your employee load has references to OUs that haven't been loaded to Cornerstone yet but are present in an associated OU load, the Bulk API will figure that out and load those records successfully (provided there are no other errors).