Excluir Tarefa
DELETE/external/v1/tasks/:idExclui uma tarefa permanentemente, com suas subtarefas, comentários e anexos. Excluir uma etapa de uma execução de playbook a remove da execução: a contagem de etapas da execução diminui e, se todas as etapas restantes estiverem concluídas, a execução passa a completed.
Autenticação
Requer permissão tasks:delete. A tarefa precisa estar visível para o usuário que criou a chave.
Parâmetros de Caminho
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | Identificador da tarefa (UUID) |
Requisição
bash
curl --request DELETE \
--url "https://app.getraze.com/external/v1/tasks/7b1e4c52-9a0d-4f1e-8c35-2d6f0a9b3e11" \
--header "X-API-Key: YOUR_API_KEY"javascript
const axios = require('axios');
const taskId = '7b1e4c52-9a0d-4f1e-8c35-2d6f0a9b3e11';
const response = await axios.delete(
`https://app.getraze.com/external/v1/tasks/${taskId}`,
{ headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
console.log(response.data);python
import requests
task_id = '7b1e4c52-9a0d-4f1e-8c35-2d6f0a9b3e11'
response = requests.delete(
f'https://app.getraze.com/external/v1/tasks/{task_id}',
headers={'X-API-Key': 'YOUR_API_KEY'}
)
print(response.json())Resposta
json
{
"success": true,
"message": "Task deleted successfully"
}Erros
| Status | Código | Descrição |
|---|---|---|
| 403 | INSUFFICIENT_PERMISSIONS | A chave não tem tasks:delete |
| 404 | NOT_FOUND | Tarefa não encontrada, ou não visível para o criador da chave |