Reopen task

Endpoint

This endpoint reopens a completed Tallyfy task, setting its status back usually to active or incomplete. The exact endpoint depends on the task type:

• Process Task: DELETE /organizations/{org_id}/runs/{run_id}/completed-tasks/{task_id}
• One-off Task: DELETE /organizations/{org_id}/completed-tasks/{task_id}

Replace {org_id}, {run_id} (if applicable), and {task_id} with the appropriate IDs.

Note

Notice the DELETE method is used on the completed-tasks endpoint, effectively deleting the “completion” record.

Request

Headers

• Authorization: Bearer {your_access_token}
• Accept: application/json
• X-Tallyfy-Client: APIClient

Body

No request body is needed for this DELETE request.

Code samples

Javascript

const accessToken = 'YOUR_PERSONAL_ACCESS_TOKEN';
const orgId = 'YOUR_ORGANIZATION_ID';
const runId = 'PROCESS_RUN_ID'; // Set to null or omit for one-off task
const taskId = 'TASK_ID_TO_REOPEN';

const apiUrl = runId
    ? `https://go.tallyfy.com/api/organizations/${orgId}/runs/${runId}/completed-tasks/${taskId}`
    : `https://go.tallyfy.com/api/organizations/${orgId}/completed-tasks/${taskId}`;

const headers = new Headers();
headers.append('Authorization', `Bearer ${accessToken}`);
headers.append('Accept', 'application/json');
headers.append('X-Tallyfy-Client', 'APIClient');

fetch(apiUrl, {
    method: 'DELETE', // Use DELETE method on completed-tasks endpoint
    headers: headers
})
.then(response => {
    return response.json().then(data => { // Attempt to parse JSON regardless of status
        if (!response.ok) { // Check for 200 OK on success
            console.error(`Failed to reopen task ${taskId}:`, data);
            throw new Error(`HTTP error! status: ${response.status}`);
        }
         console.log(`Successfully reopened task ${taskId}. Status: ${response.status}`);
        return data; // Reopen might return the updated task state
    });
})
.then(data => {
    if(data) {
      console.log('Reopened task details:');
      console.log(JSON.stringify(data, null, 2));
    }
})
.catch(error => {
    console.error(`Error reopening task ${taskId}:`, error.message);
});

Python

import requests
import json
import os

access_token = os.environ.get('TALLYFY_ACCESS_TOKEN', 'YOUR_PERSONAL_ACCESS_TOKEN')
org_id = os.environ.get('TALLYFY_ORG_ID', 'YOUR_ORGANIZATION_ID')
run_id = os.environ.get('TALLYFY_RUN_ID') # Get from env, might be None for one-off task
task_id = 'TASK_ID_TO_REOPEN'

if run_id:
    api_url = f'https://go.tallyfy.com/api/organizations/{org_id}/runs/{run_id}/completed-tasks/{task_id}'
else:
    api_url = f'https://go.tallyfy.com/api/organizations/{org_id}/completed-tasks/{task_id}'

headers = {
    'Authorization': f'Bearer {access_token}',
    'Accept': 'application/json',
    'X-Tallyfy-Client': 'APIClient'
}

response = None
try:
    response = requests.delete(api_url, headers=headers)
    response.raise_for_status() # Expect 200 OK, raises HTTPError for 4xx/5xx

    print(f'Successfully reopened task {task_id}. Status: {response.status_code}')
    try:
         # Attempt to parse JSON body if it exists
        if response.content:
            reopened_task = response.json()
            print('Reopened task details:')
            print(json.dumps(reopened_task, indent=4))
        else:
            print("(Response body empty)")
    except json.JSONDecodeError:
        print("(Could not parse response body as JSON)")
        print(f"Raw Response Text: {response.text}")

except requests.exceptions.HTTPError as http_err:
    print(f"HTTP error occurred reopening task {task_id}: {http_err}")
    if response is not None:
        print(f"Response Body: {response.text}")
except requests.exceptions.RequestException as req_err:
    print(f"Request failed reopening task {task_id}: {req_err}")
except Exception as err:
     print(f"An unexpected error occurred: {err}")

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.time.Duration;

public class ReopenTask {
    public static void main(String[] args) {
        String accessToken = System.getenv().getOrDefault("TALLYFY_ACCESS_TOKEN", "YOUR_PERSONAL_ACCESS_TOKEN");
        String orgId = System.getenv().getOrDefault("TALLYFY_ORG_ID", "YOUR_ORGANIZATION_ID");
        String runId = System.getenv("TALLYFY_RUN_ID"); // Get from env, might be null for one-off task
        String taskId = "TASK_ID_TO_REOPEN";

        String apiUrl;
         if (runId != null && !runId.isEmpty()) {
            apiUrl = String.format("https://go.tallyfy.com/api/organizations/%s/runs/%s/completed-tasks/%s", orgId, runId, taskId);
        } else {
             apiUrl = String.format("https://go.tallyfy.com/api/organizations/%s/completed-tasks/%s", orgId, taskId);
        }

        HttpClient client = HttpClient.newBuilder()
                .connectTimeout(Duration.ofSeconds(10))
                .build();

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(apiUrl))
                .header("Authorization", "Bearer " + accessToken)
                .header("Accept", "application/json")
                .header("X-Tallyfy-Client", "APIClient")
                .DELETE() // Use DELETE method
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) { // Expect 200 OK
                System.out.println("Successfully reopened task " + taskId + ". Status: 200 OK");
                 if (response.body() != null && !response.body().isEmpty()) {
                     System.out.println("Response Body (Reopened Task Details):");
                     System.out.println(response.body());
                     // TODO: Consider parsing JSON using Jackson/Gson
                 } else {
                      System.out.println("(Response body empty)");
                 }
            } else {
                System.err.println("Failed to reopen task " + taskId + ". Status: " + response.statusCode());
                System.err.println("Response Body: " + response.body());
            }
        } catch (IOException | InterruptedException e) {
            System.err.println("Request failed: " + e.getMessage());
            Thread.currentThread().interrupt();
        } catch (Exception e) {
             System.err.println("An unexpected error occurred: " + e.getMessage());
             e.printStackTrace();
        }
    }
}

Go

package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io/ioutil"
  "net/http"
  "os"
    "time"
)

func main() {
  accessToken := os.Getenv("TALLYFY_ACCESS_TOKEN")
    if accessToken == "" { accessToken = "YOUR_PERSONAL_ACCESS_TOKEN" }
  orgId := os.Getenv("TALLYFY_ORG_ID")
    if orgId == "" { orgId = "YOUR_ORGANIZATION_ID" }
    runId := os.Getenv("TALLYFY_RUN_ID") // Get from env, might be "" for one-off task
    taskId := "TASK_ID_TO_REOPEN"

    var apiUrl string
    if runId != "" {
        apiUrl = fmt.Sprintf("https://go.tallyfy.com/api/organizations/%s/runs/%s/completed-tasks/%s", orgId, runId, taskId)
    } else {
        apiUrl = fmt.Sprintf("https://go.tallyfy.com/api/organizations/%s/completed-tasks/%s", orgId, taskId)
    }

  client := &http.Client{Timeout: 15 * time.Second}
    // Create DELETE request
  req, err := http.NewRequest(http.MethodDelete, apiUrl, nil)
    if err != nil {
        fmt.Printf("Error creating reopen task request for task %s: %v\n", taskId, err)
        return
    }

  req.Header.Set("Authorization", "Bearer "+accessToken)
  req.Header.Set("Accept", "application/json")
  req.Header.Set("X-Tallyfy-Client", "APIClient")

  resp, err := client.Do(req)
    if err != nil {
        fmt.Printf("Error executing reopen task request for task %s: %v\n", taskId, err)
        return
    }
  defer resp.Body.Close()

  body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Printf("Error reading reopen task response body for task %s: %v\n", taskId, err)
        // Continue processing status code even if body read fails
    }

  if resp.StatusCode != http.StatusOK {
    fmt.Printf("Failed to reopen task %s. Status: %d\nBody: %s\n", taskId, resp.StatusCode, string(body))
    return
  }

  fmt.Printf("Successfully reopened task %s. Status: %d\n", taskId, resp.StatusCode)
    if len(body) > 0 {
        fmt.Println("Response Body (Reopened Task Details):")
        // Pretty print JSON response
        var prettyJSON bytes.Buffer
        if err := json.Indent(&prettyJSON, body, "", "  "); err == nil {
            fmt.Println(prettyJSON.String())
        } else {
            fmt.Println(string(body))
        }
        // TODO: Unmarshal JSON if needed
    } else {
         fmt.Println("(Response body empty)")
    }
}

C++

#include <iostream>
#include <string>
#include <optional>
#include <cpprest/http_client.h>
#include <cpprest/json.h>

using namespace web;
using namespace web::http;
using namespace web::http::client;
using namespace web::json;

pplx::task<void> ReopenTallyfyTask(const utility::string_t& taskId, std::optional<utility::string_t> runId = std::nullopt)
{
    utility::string_t accessToken = U("YOUR_PERSONAL_ACCESS_TOKEN");
    utility::string_t orgId = U("YOUR_ORGANIZATION_ID");

    utility::string_t apiUrlBase = U("https://go.tallyfy.com/api/organizations/") + orgId;
    utility::string_t apiUrl;

    if (runId) {
        apiUrl = apiUrlBase + U("/runs/") + runId.value() + U("/completed-tasks/") + taskId;
    } else {
        apiUrl = apiUrlBase + U("/completed-tasks/") + taskId;
    }

    http_client client(apiUrl);
    http_request request(methods::DEL); // Use DELETE method

    request.headers().add(U("Authorization"), U("Bearer ") + accessToken);
    request.headers().add(U("Accept"), U("application/json"));
    request.headers().add(U("X-Tallyfy-Client"), U("APIClient"));
    // No request body needed

    return client.request(request).then([taskId](http_response response)
    {
        utility::string_t taskIdW = taskId;
        status_code status = response.status_code();

        // Handle potential JSON or string response
        return response.extract_string().then([status, taskIdW, response](utility::string_t responseBody)
        {
             if (status == status_codes::OK) {
                 std::wcout << L"Successfully reopened task " << taskIdW << L". Status: " << status << std::endl;
                 if (!responseBody.empty()) {
                     std::wcout << L"Response Body (Reopened Task Details):\n" << responseBody << std::endl;
                     try {
                         value jsonVal = value::parse(responseBody);
                     } catch (const std::exception& jsonEx) {
                         std::wcerr << L"(Could not parse response body as JSON: " << jsonEx.what() << L")" << std::endl;
                     }
                 } else {
                     std::wcout << L"(Response body empty)" << std::endl;
                 }
             } else {
                 std::wcerr << L"Failed to reopen task " << taskIdW << L". Status: " << status << std::endl;
                 std::wcerr << L"Response Body: " << responseBody << std::endl;
                 throw std::runtime_error("Failed to reopen task");
             }
        });
    });
}

int main() {
    try {
        // Reopen a process task
        ReopenTallyfyTask(U("TASK_ID_TO_REOPEN"), U("RUN_ID")).wait();
        // Reopen a one-off task (runId is omitted/null)
        // ReopenTallyfyTask(U("ONEOFF_TASK_ID_TO_REOPEN")).wait();
    } catch (const std::exception &e) {
        std::cerr << "Error: " << e.what() << std::endl;
    }
    return 0;
}
// Requires C++ REST SDK (Casablanca)

C#

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using System.Text.Json;

public class TallyfyTaskReopener
{
    private static readonly HttpClient client = new HttpClient();

    // Use runId = null for one-off tasks
    public static async Task ReopenTaskAsync(string taskId, string runId = null)
    {
        var accessToken = Environment.GetEnvironmentVariable("TALLYFY_ACCESS_TOKEN") ?? "YOUR_PERSONAL_ACCESS_TOKEN";
        var orgId = Environment.GetEnvironmentVariable("TALLYFY_ORG_ID") ?? "YOUR_ORGANIZATION_ID";

        string apiUrl;
        if (!string.IsNullOrEmpty(runId)) {
            apiUrl = $"https://go.tallyfy.com/api/organizations/{orgId}/runs/{runId}/completed-tasks/{taskId}";
        } else {
            apiUrl = $"https://go.tallyfy.com/api/organizations/{orgId}/completed-tasks/{taskId}";
        }

        try
        {
            using var request = new HttpRequestMessage(HttpMethod.Delete, apiUrl);
            request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
            request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
            request.Headers.Add("X-Tallyfy-Client", "APIClient");
            // No request body needed for DELETE

            HttpResponseMessage response = await client.SendAsync(request);
            string responseBody = await response.Content.ReadAsStringAsync();

            if (response.IsSuccessStatusCode) // Expect 200 OK
            {
                Console.WriteLine($"Successfully reopened task {taskId}. Status: {response.StatusCode}");
                if (!string.IsNullOrWhiteSpace(responseBody))
                {
                    Console.WriteLine("Reopened task details:");
                    try {
                        using var doc = JsonDocument.Parse(responseBody);
                        Console.WriteLine(JsonSerializer.Serialize(doc.RootElement, new JsonSerializerOptions { WriteIndented = true }));
                    } catch (JsonException) {
                        Console.WriteLine(responseBody);
                    }
                } else {
                     Console.WriteLine("(Response body empty)");
                }
            }
            else
            {
                Console.WriteLine($"Failed to reopen task {taskId}. Status: {response.StatusCode}");
                Console.WriteLine($"Response: {responseBody}");
            }
        }
        catch (HttpRequestException e)
        {
            Console.WriteLine($"Request Exception reopening task {taskId}: {e.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"An unexpected error occurred: {ex.Message}");
        }
    }

    // Example Usage:
    // static async Task Main(string[] args)
    // {
    //     // Reopen a process task
    //     await ReopenTaskAsync("TASK_ID_TO_REOPEN", "RUN_ID");
    //     // Reopen a one-off task
    //     // await ReopenTaskAsync("ONE_OFF_TASK_ID_TO_REOPEN");
    // }
}

Response

A successful request returns a 200 OK status code. The response body typically contains the details of the task, now back in an active (or incomplete) state.

{
  "data": {
    "id": "TASK_ID_TO_REOPEN",
    "title": "Review Proposal",
    "status": "active", // Status is no longer 'completed'
    "completed_at": null, // Completion timestamp is removed
    "completer_id": null,
    // ... other task properties ...
  }
}

If the task was not previously completed or the ID is invalid, an error status will be returned.

---

Related articles

Tasks > Complete task

This documentation explains how to mark Tallyfy tasks as complete using POST requests to different endpoints for process tasks versus one-off tasks with options to include approval status and final form field updates in the request payload.

Tasks > Delete task

A DELETE endpoint permanently removes standalone tasks while preserving process-related tasks that can only be deleted through their parent process run deletion.

Tasks > Archive task

A DELETE endpoint that archives standalone tasks by hiding them from default views while preserving data for potential future restoration through authenticated API requests and returns 200 or 204 status codes upon success.

Processes > Activate process

This endpoint uses a PUT request to restore a previously archived Tallyfy process instance back to its active state by removing the archived timestamp and updating its status through authenticated API calls with organization and run identifiers.

Was this helpful?

YesNo