Documentation by ClonePartner

Start typing to search.

API Reference

Create a task

View Markdown
POST /api/tasks

Create a task

Operation IDcreateTask

Authentication

  • BearerAuth·http bearer·API key token (envoy_<hex>). Create keys from Settings → API Keys — see Using the API.

Request body

This request body is required.

Content typeapplication/json

requestobject
4 properties
namestringrequired
descriptionstring
yaml_contentstringrequired

Task definition in YAML format

connector_refsarray<string>
Array items
itemstring

Success response body

201Task created with current YAML content

Task created with current YAML content

Content typeapplication/json

responseobject
8 properties
idinteger
namestring
descriptionstring | null
Nullable
yes
current_versioninteger
statusstring
Allowed values
active, archived
created_atstring · date-time
updated_atstring · date-time
current_yamlstring | null
Nullable
yes

Error responses

400Validation error

Validation error

Content typeapplication/json

responseobject
2 properties
errorstring
Example
NOT_FOUND
messagestring
Example
Resource not found
Example response
{
  "error": "VALIDATION_ERROR",
  "message": "Invalid input"
}