Delete Task

curl --request DELETE \
  --url https://api.dataraven.io/v1/teams/{team_id}/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Tasks

Delete Task

Permanently delete a task.

Required Role: ADMIN or OWNER

⚠️ WARNING: Tasks with execution history CANNOT be deleted!

Important:

Tasks with execution history return 400 Bad Request
Use archive instead to preserve audit trail: POST /tasks/{task_id}/archive
Only tasks with NO executions can be deleted
Deletion cascades to remove notifications (if task never ran)

Why this restriction: Execution history contains immutable audit records required for compliance. Deleting executions would destroy historical usage metrics and transfer logs.

Deleting a task:

Permanently removes the task definition
Cascades to delete notifications (if any)
CANNOT be undone

Validation:

Task must exist and belong to the team
Task must NOT have any execution history (enforced)

Recommendation: Use archive instead of delete to preserve history.

DELETE

teams

{team_id}

tasks

{task_id}

Delete Task

curl --request DELETE \
  --url https://api.dataraven.io/v1/teams/{team_id}/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

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

Path Parameters

task_id

string<uuid>

required

team_id

string<uuid>

required

Response

Successful Response

Update Task

Enable Task

Documentation Index

Authorizations

Path Parameters

Response