Create WorkflowTask

POST

https://{tenant_name}.benchling.com/api/v3/workflow-task

POST

/api/v3/workflow-task

curl -X POST https://{tenant_name}.benchling.com/api/v3/workflow-task \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "workflowTaskGroupId": "workflowTaskGroupId"
}'

{
  "__typename": "__typename",
  "archiveReason": "archiveReason",
  "archived": true,
  "assignee": {
    "__typename": "__typename",
    "id": "id"
  },
  "childTasks": "childTasks",
  "clonedFrom": {
    "__typename": "__typename",
    "id": "id"
  },
  "createdAt": "createdAt",
  "creator": {
    "__typename": "__typename",
    "id": "id"
  },
  "displayId": "displayId",
  "executionEntry": {
    "__typename": "__typename",
    "id": "id"
  },
  "executionType": "DIRECT",
  "id": "id",
  "modifiedAt": "modifiedAt",
  "name": "name",
  "rootWorkflowTasks": "rootWorkflowTasks",
  "scheduledOn": "2023-01-15",
  "schema": {
    "__typename": "__typename",
    "id": "id"
  },
  "schemaFields": [
    {
      "__typename": "__typename",
      "id": "id",
      "linkedEntityId": "linkedEntityId"
    }
  ],
  "status": "PENDING",
  "workflowOutputs": "workflowOutputs",
  "workflowTaskGroup": {
    "__typename": "__typename",
    "id": "id"
  }
}

Create WorkflowTask.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

workflowTaskGroupIdstringRequired

The ID of the workflow task group to create the task in.

assigneeIdstringOptional

The ID of the user to assign this task to.

scheduledOndateOptional

The date on which the task is scheduled to be executed.

schemaFieldsmap from strings to objectsOptional

Schema field values for the task, keyed by field name.

studyIdslist of stringsOptional

IDs of studies to associate with this task.

Response

Created

__typenamestringOptional

archiveReasonstring or nullOptional

archivedbooleanOptional

assigneeobject or nullOptional

The assignee of this task

childTasksstring or nullOptionalformat: "uri"

All descendants of a root task in a flowchart. This will be empty if this task is not a root task.

clonedFromobject or nullOptional

The task that this task was cloned from

createdAtstringOptional

creatorobjectOptional

displayIdstring or nullOptional

User-friendly ID of the workflow task

executionEntryobject or nullOptional

The entry that this task is executed in. This is only non-null for tasks with an ENTRY execution type.

executionTypeenumOptional

The method by which the task of the workflow is executed

idstringOptional

modifiedAtstringOptional

namestringOptional

rootWorkflowTasksstring or nullOptionalformat: "uri"

All root tasks of the flowchart(s) that this task is a part of. A task may be associated with more than one root task when branches rooted at different flowchart tasks are pooled together.

scheduledOndate or nullOptional

The date on which the task is scheduled to be executed

schemaobjectOptional

schemaFieldslist of objects or nullOptional

statusenumOptional

The status of this task

workflowOutputsstring or nullOptionalformat: "uri"

The outputs of this task

workflowTaskGroupobjectOptional

The task group that this task is a part of

Errors

400

Workflow Task Create Request Bad Request Error

403

Workflow Task Create Request Forbidden Error

404

Workflow Task Create Request Not Found Error

409

Workflow Task Create Request Conflict Error

429

Workflow Task Create Request Too Many Requests Error

500

Workflow Task Create Request Internal Server Error