Create a task

post

https://expert.inskill.ai/public/apiv3/expertisetasks

Create a new task. The task is created empty (no steps).

To create a task with steps in one call, use POST /expertisetasks/import.

Required fields:

name
product_id

Forbidden fields (silently dropped):

account_id, guid, parent_guid, idx, dirty_record
mvn_indexed, mvn_version, mvn_info, mvn_ts
created_ts, modified_ts

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Editable fields accepted on POST /expertisetasks and PATCH /expertisetasks/{id}.

On PATCH, only dependencies, name, published, roles, and translations are honored. product_id and type cannot change after creation.

Use the translations field to push pre-translated task names. Translation rows are written with locked: 1 by default to prevent auto-translate from overwriting them.

name

string

Task name. Required on POST. Max 200 chars.

product_id

integer

Required on POST. Cannot change via PATCH.

published

integer

enum

Defaults to 1

Allowed:

type

integer

enum

Defaults to 0

Task type. Forbidden on POST/PATCH for public callers — only 0 (default) is reachable.
Type 1 (LINKED) is reserved for tasks auto-managed by feedback_config and is not
user-creatable.

Allowed:

roles

array of integers

Array of role IDs allowed to access this task.
Valid: 0=User, 1=Tech, 2=Tech2, 3=Tech3, 5=Expert, 7=User2, 8=User3.
If omitted on POST, defaults to all roles.

roles

dependencies

array | null

Dependency rules with nested AND/OR logic.
Root element is the operator ("AND" or "OR"), followed by an array of condition objects or nested groups.
Each condition: {variable, operator, targets, path}.

dependencies

translations

object

Per-language pre-translated overlays for the task. Keys are language codes.
Each value carries name (translated task name) and optionally locked (default 1).
Auto-translate will not overwrite locked rows.

Responses

200Task created successfully

400Invalid request parameters

401Authentication failed or missing

404Resource not found or access denied

422Filter validation error

500Internal server error