Update Task

cURL

curl --request PATCH \
  --url https://recoup-api.vercel.app/api/tasks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "id": "aade2bce-55c7-468e-a606-c4e76fb2ea2a",
  "title": "Weekly Genre Pulse Check (Updated)",
  "prompt": "Execute this weekly genre analysis workflow and email a summary to the team.",
  "schedule": "0 10 * * 4",
  "account_id": "848cd58d-700f-4b38-ab4c-d9f52a1b2c3d",
  "artist_account_id": "1873859c-dd37-4e9a-9bac-80d35a1b2c3d",
  "enabled": true
}
'

import requests

url = "https://recoup-api.vercel.app/api/tasks"

payload = {
    "id": "aade2bce-55c7-468e-a606-c4e76fb2ea2a",
    "title": "Weekly Genre Pulse Check (Updated)",
    "prompt": "Execute this weekly genre analysis workflow and email a summary to the team.",
    "schedule": "0 10 * * 4",
    "account_id": "848cd58d-700f-4b38-ab4c-d9f52a1b2c3d",
    "artist_account_id": "1873859c-dd37-4e9a-9bac-80d35a1b2c3d",
    "enabled": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: 'aade2bce-55c7-468e-a606-c4e76fb2ea2a',
    title: 'Weekly Genre Pulse Check (Updated)',
    prompt: 'Execute this weekly genre analysis workflow and email a summary to the team.',
    schedule: '0 10 * * 4',
    account_id: '848cd58d-700f-4b38-ab4c-d9f52a1b2c3d',
    artist_account_id: '1873859c-dd37-4e9a-9bac-80d35a1b2c3d',
    enabled: true
  })
};

fetch('https://recoup-api.vercel.app/api/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://recoup-api.vercel.app/api/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 'aade2bce-55c7-468e-a606-c4e76fb2ea2a',
    'title' => 'Weekly Genre Pulse Check (Updated)',
    'prompt' => 'Execute this weekly genre analysis workflow and email a summary to the team.',
    'schedule' => '0 10 * * 4',
    'account_id' => '848cd58d-700f-4b38-ab4c-d9f52a1b2c3d',
    'artist_account_id' => '1873859c-dd37-4e9a-9bac-80d35a1b2c3d',
    'enabled' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://recoup-api.vercel.app/api/tasks"

	payload := strings.NewReader("{\n  \"id\": \"aade2bce-55c7-468e-a606-c4e76fb2ea2a\",\n  \"title\": \"Weekly Genre Pulse Check (Updated)\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 10 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\",\n  \"enabled\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://recoup-api.vercel.app/api/tasks")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": \"aade2bce-55c7-468e-a606-c4e76fb2ea2a\",\n  \"title\": \"Weekly Genre Pulse Check (Updated)\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 10 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\",\n  \"enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://recoup-api.vercel.app/api/tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": \"aade2bce-55c7-468e-a606-c4e76fb2ea2a\",\n  \"title\": \"Weekly Genre Pulse Check (Updated)\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 10 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\",\n  \"enabled\": true\n}"

response = http.request(request)
puts response.read_body

{
  "tasks": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "prompt": "<string>",
      "schedule": "<string>",
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "artist_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "enabled": true,
      "trigger_schedule_id": "<string>"
    }
  ],
  "error": "<string>"
}

{
  "error": 123,
  "message": "<string>"
}

PATCH

api

tasks

cURL

curl --request PATCH \
  --url https://recoup-api.vercel.app/api/tasks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "id": "aade2bce-55c7-468e-a606-c4e76fb2ea2a",
  "title": "Weekly Genre Pulse Check (Updated)",
  "prompt": "Execute this weekly genre analysis workflow and email a summary to the team.",
  "schedule": "0 10 * * 4",
  "account_id": "848cd58d-700f-4b38-ab4c-d9f52a1b2c3d",
  "artist_account_id": "1873859c-dd37-4e9a-9bac-80d35a1b2c3d",
  "enabled": true
}
'

import requests

url = "https://recoup-api.vercel.app/api/tasks"

payload = {
    "id": "aade2bce-55c7-468e-a606-c4e76fb2ea2a",
    "title": "Weekly Genre Pulse Check (Updated)",
    "prompt": "Execute this weekly genre analysis workflow and email a summary to the team.",
    "schedule": "0 10 * * 4",
    "account_id": "848cd58d-700f-4b38-ab4c-d9f52a1b2c3d",
    "artist_account_id": "1873859c-dd37-4e9a-9bac-80d35a1b2c3d",
    "enabled": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: 'aade2bce-55c7-468e-a606-c4e76fb2ea2a',
    title: 'Weekly Genre Pulse Check (Updated)',
    prompt: 'Execute this weekly genre analysis workflow and email a summary to the team.',
    schedule: '0 10 * * 4',
    account_id: '848cd58d-700f-4b38-ab4c-d9f52a1b2c3d',
    artist_account_id: '1873859c-dd37-4e9a-9bac-80d35a1b2c3d',
    enabled: true
  })
};

fetch('https://recoup-api.vercel.app/api/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://recoup-api.vercel.app/api/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 'aade2bce-55c7-468e-a606-c4e76fb2ea2a',
    'title' => 'Weekly Genre Pulse Check (Updated)',
    'prompt' => 'Execute this weekly genre analysis workflow and email a summary to the team.',
    'schedule' => '0 10 * * 4',
    'account_id' => '848cd58d-700f-4b38-ab4c-d9f52a1b2c3d',
    'artist_account_id' => '1873859c-dd37-4e9a-9bac-80d35a1b2c3d',
    'enabled' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://recoup-api.vercel.app/api/tasks"

	payload := strings.NewReader("{\n  \"id\": \"aade2bce-55c7-468e-a606-c4e76fb2ea2a\",\n  \"title\": \"Weekly Genre Pulse Check (Updated)\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 10 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\",\n  \"enabled\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://recoup-api.vercel.app/api/tasks")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": \"aade2bce-55c7-468e-a606-c4e76fb2ea2a\",\n  \"title\": \"Weekly Genre Pulse Check (Updated)\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 10 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\",\n  \"enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://recoup-api.vercel.app/api/tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": \"aade2bce-55c7-468e-a606-c4e76fb2ea2a\",\n  \"title\": \"Weekly Genre Pulse Check (Updated)\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 10 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\",\n  \"enabled\": true\n}"

response = http.request(request)
puts response.read_body

{
  "tasks": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "prompt": "<string>",
      "schedule": "<string>",
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "artist_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "enabled": true,
      "trigger_schedule_id": "<string>"
    }
  ],
  "error": "<string>"
}

{
  "error": 123,
  "message": "<string>"
}

Authorizations

x-api-key

string

header

required

Your Recoup API key. Learn more.

Body

application/json

Task fields to update

string<uuid>

required

UUID of the task to update

Example:

"aade2bce-55c7-468e-a606-c4e76fb2ea2a"

title

string

New descriptive title of the task

Example:

"Weekly Genre Pulse Check (Updated)"

prompt

string

New instruction/prompt executed by the task

Example:

"Execute this weekly genre analysis workflow and email a summary to the team."

schedule

string

New cron expression defining when the task runs

Example:

"0 10 * * 4"

account_id

string<uuid>

New UUID of the associated account

Example:

"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d"

artist_account_id

string<uuid>

New UUID of the associated artist account

Example:

"1873859c-dd37-4e9a-9bac-80d35a1b2c3d"

enabled

boolean | null

Whether the task is enabled. Can be true, false, or null.

Example:

true

Response

Task updated successfully

status

enum<string>

required

Status of the request

Available options:

success,

error

tasks

object[]

required

Array of task objects

Show child attributes

error

string

Error message (only present if status is error)

Create Task Delete Task

API documentation

Chat

Tasks

Accounts

Artists

Segment

Fans

Posts

Post

Comments

Organizations

Spotify

Instagram

X (Twitter)

Social

Image

Transcribe

Songs & Catalogs

Subscriptions

Apify

Authorizations

Body

Response