Create Task

cURL

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

import requests

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

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

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

print(response.text)

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

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Weekly Genre Pulse Check',
    'prompt' => 'Execute this weekly genre analysis workflow and email a summary to the team.',
    'schedule' => '0 9 * * 4',
    'account_id' => '848cd58d-700f-4b38-ab4c-d9f52a1b2c3d',
    'artist_account_id' => '1873859c-dd37-4e9a-9bac-80d35a1b2c3d'
  ]),
  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  \"title\": \"Weekly Genre Pulse Check\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 9 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\"\n}")

	req, _ := http.NewRequest("POST", 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.post("https://recoup-api.vercel.app/api/tasks")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Weekly Genre Pulse Check\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 9 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\"\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::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Weekly Genre Pulse Check\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 9 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\"\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>"
}

POST

api

tasks

cURL

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

import requests

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

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

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

print(response.text)

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

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Weekly Genre Pulse Check',
    'prompt' => 'Execute this weekly genre analysis workflow and email a summary to the team.',
    'schedule' => '0 9 * * 4',
    'account_id' => '848cd58d-700f-4b38-ab4c-d9f52a1b2c3d',
    'artist_account_id' => '1873859c-dd37-4e9a-9bac-80d35a1b2c3d'
  ]),
  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  \"title\": \"Weekly Genre Pulse Check\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 9 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\"\n}")

	req, _ := http.NewRequest("POST", 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.post("https://recoup-api.vercel.app/api/tasks")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Weekly Genre Pulse Check\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 9 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\"\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::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Weekly Genre Pulse Check\",\n  \"prompt\": \"Execute this weekly genre analysis workflow and email a summary to the team.\",\n  \"schedule\": \"0 9 * * 4\",\n  \"account_id\": \"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d\",\n  \"artist_account_id\": \"1873859c-dd37-4e9a-9bac-80d35a1b2c3d\"\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 to create

title

string

required

Descriptive title of the task

Example:

"Weekly Genre Pulse Check"

prompt

string

required

Instruction/prompt executed by the task

Example:

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

schedule

string

required

Cron expression defining when the task runs (e.g., '0 9 * * 4' for Thursdays at 9 AM)

Example:

"0 9 * * 4"

account_id

string<uuid>

required

UUID of the associated account

Example:

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

artist_account_id

string<uuid>

required

UUID of the associated artist account

Example:

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

Response

Task created 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)

Get Tasks Update 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