Opencast

UI Tasks REST Documentation

/admin-ng/tasks
Provides resources and operations related to the tasks

General Notes

Table of Contents

Read methods

Method / Path: GET /processing.json
Description: Returns all the data related to the processing tab in the new tasks modal as JSON
Path params: NONE
Optional (query) params: tags: A comma separated list of tags to filter the workflow definitions
Status codes: 200: OK, Returns all the data related to the tasks processing tab as JSON
Notes:
  • Return value description: All the data related to the tasks processing tab as JSON
Testing:
Sample: /processing.json?tags={tags}
Testing form (click to reveal)

Write methods

Method / Path: POST /new
Description: Creates a new task by the given metadata as JSON
Path params: NONE
Required (form) params: metadata: The metadata as JSON.

Example:

{
  "workflow":"republish-metadata",
  "configuration":{
    "ID-dual-stream-demo":{"workflowVar":"true"},
    "ID-about-opencast":{"workflowVar":"true"}
  }
}
Optional (form) params: NONE
Status codes: 201: Created, Task sucessfully added
404: Not Found, If the workflow definition is not found
400: Bad Request, If the metadata is not set or couldn't be parsed
Notes:
  • Return value description: The task identifiers
Testing:
Sample: /new
Testing form (click to reveal)