A unit of work (Task) is added onto a project queue by posting a piece of data to a Project resource. Tasks can be created synchronously (on request) or asynchronously (enqueued on request to be created later).
Some types of projects require asynchronous task creation, such as image annotation projects that use images originally hosted on external servers. These images located on external servers need to be copied to Sama's own secure storage before the task is created. For other types of projects asynchronous task creation is optional.
Sama recommends that all assets required for image annotation projects be hosted in our own secure storage to ensure agent productivity. You can arrange a workflow with your Sama Project Manager to have your images copied to our storage manually in advance, or this step can be done for you automatically on task creation. If images are going to be copied to Sama's storage on task creation, asynchronous task creation is required.
Your Sama Project Manager is available to discuss a task creation workflow best suited to your project.
The body of the post will contain the data for the task encoded in JSON. The schema of the data must match the schema that was configured during the project setup step. You can also use the task creation schema API to get a JSON schema of the data.
There is a Copy Asset to Sama Platform storage during API create option on Input settings in the Sama Platform. When enabled by a Sama project manager, during task creation, the Sama Platform will make a copy of the asset from the given client URL to Sama's own storage. This client URL can instruct Sama to request the asset using Basic authentication over HTTPS (for encrypted requests) by using the following format: