Documentation by ClonePartner

Start typing to search.

API Reference

Set a per-job task YAML override

View Markdown
PUT /api/jobs/{id}/tasks/{taskKey}/override

Stores a YAML override for the given DAG node key. The override wins over the pinned task version at run time for this job only. Validated with the same task parser/validator as the task library, plus bidirectional connector slot checks: every slot in the DAG node's connector_mapping must be declared in the override's connectors section, and the override may not introduce slots that the job has no mapping for. Admin only.

Operation IDsetJobTaskOverride

Authentication

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

Path parameters

idintegerrequired

Resource ID

taskKeystringrequired

Request body

This request body is required.

Content typeapplication/json

requestobject
1 property
yaml_contentstringrequired

Success response body

200Override stored

Override stored

Content typeapplication/json

responseobject
2 properties
okboolean
overridden_task_keysarray<string>
Array items
itemstring

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"
}

404Resource not found

Resource not found

Content typeapplication/json

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