Search tasks

curl --request POST \
  --url https://api.stardex.ai/v1/tasks/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "offset": 0,
  "limit": 100,
  "keywords": [
    "<string>"
  ],
  "task_types": [],
  "related_to": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_completed": true,
  "owner_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "due_date_start": "<string>",
  "due_date_end": "<string>",
  "sort_by": "created_at",
  "sort_order": "desc"
}
'

import requests

url = "https://api.stardex.ai/v1/tasks/search"

payload = {
    "offset": 0,
    "limit": 100,
    "keywords": ["<string>"],
    "task_types": [],
    "related_to": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "is_completed": True,
    "owner_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "due_date_start": "<string>",
    "due_date_end": "<string>",
    "sort_by": "created_at",
    "sort_order": "desc"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    offset: 0,
    limit: 100,
    keywords: ['<string>'],
    task_types: [],
    related_to: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    is_completed: true,
    owner_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    due_date_start: '<string>',
    due_date_end: '<string>',
    sort_by: 'created_at',
    sort_order: 'desc'
  })
};

fetch('https://api.stardex.ai/v1/tasks/search', 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://api.stardex.ai/v1/tasks/search",
  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([
    'offset' => 0,
    'limit' => 100,
    'keywords' => [
        '<string>'
    ],
    'task_types' => [
        
    ],
    'related_to' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'is_completed' => true,
    'owner_ids' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'due_date_start' => '<string>',
    'due_date_end' => '<string>',
    'sort_by' => 'created_at',
    'sort_order' => 'desc'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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://api.stardex.ai/v1/tasks/search"

	payload := strings.NewReader("{\n  \"offset\": 0,\n  \"limit\": 100,\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"task_types\": [],\n  \"related_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"is_completed\": true,\n  \"owner_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"due_date_start\": \"<string>\",\n  \"due_date_end\": \"<string>\",\n  \"sort_by\": \"created_at\",\n  \"sort_order\": \"desc\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.stardex.ai/v1/tasks/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"offset\": 0,\n  \"limit\": 100,\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"task_types\": [],\n  \"related_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"is_completed\": true,\n  \"owner_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"due_date_start\": \"<string>\",\n  \"due_date_end\": \"<string>\",\n  \"sort_by\": \"created_at\",\n  \"sort_order\": \"desc\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.stardex.ai/v1/tasks/search")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"offset\": 0,\n  \"limit\": 100,\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"task_types\": [],\n  \"related_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"is_completed\": true,\n  \"owner_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"due_date_start\": \"<string>\",\n  \"due_date_end\": \"<string>\",\n  \"sort_by\": \"created_at\",\n  \"sort_order\": \"desc\"\n}"

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

{
  "success": true,
  "data": [
    {
      "id": "aaa11111-bbbb-cccc-dddd-eeeeeeee1111",
      "content_text": "Follow up with candidate about interview availability",
      "task_type": "text",
      "due_date": "2024-02-15T17:00:00Z",
      "is_completed": false,
      "person_id": "123e4567-e89b-12d3-a456-426614174000",
      "deal_id": "234e5678-e90a-12b3-c456-789012345678",
      "client_id": "345e6789-e01b-23c4-d567-890123456789",
      "job_id": "456e7890-e12b-34d5-a678-901234567890",
      "created_at": "2024-02-01T10:00:00Z",
      "updated_at": "2024-02-01T10:00:00Z",
      "owners": [
        {
          "id": "567e8901-e23c-45d6-e789-012345678901",
          "first_name": "Jane",
          "last_name": "Smith"
        }
      ]
    }
  ],
  "meta": {
    "total": 42,
    "offset": 0,
    "limit": 100
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Tasks

Search tasks

Search and filter tasks with pagination and sorting.

Filters: keywords (full-text search on task content), task_types (array of enum values), related_to + related_record_type (entity association), is_completed (boolean), owner_ids (assigned team members), due_date_start / due_date_end (date range — tasks with no due date are excluded).

Sorting: sort_by — one of created_at (default), updated_at, due_date. sort_order — asc or desc (default).

Pagination: offset and limit (max 100).

POST

tasks

Search tasks

curl --request POST \
  --url https://api.stardex.ai/v1/tasks/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "offset": 0,
  "limit": 100,
  "keywords": [
    "<string>"
  ],
  "task_types": [],
  "related_to": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_completed": true,
  "owner_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "due_date_start": "<string>",
  "due_date_end": "<string>",
  "sort_by": "created_at",
  "sort_order": "desc"
}
'

import requests

url = "https://api.stardex.ai/v1/tasks/search"

payload = {
    "offset": 0,
    "limit": 100,
    "keywords": ["<string>"],
    "task_types": [],
    "related_to": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "is_completed": True,
    "owner_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "due_date_start": "<string>",
    "due_date_end": "<string>",
    "sort_by": "created_at",
    "sort_order": "desc"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    offset: 0,
    limit: 100,
    keywords: ['<string>'],
    task_types: [],
    related_to: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    is_completed: true,
    owner_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    due_date_start: '<string>',
    due_date_end: '<string>',
    sort_by: 'created_at',
    sort_order: 'desc'
  })
};

fetch('https://api.stardex.ai/v1/tasks/search', 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://api.stardex.ai/v1/tasks/search",
  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([
    'offset' => 0,
    'limit' => 100,
    'keywords' => [
        '<string>'
    ],
    'task_types' => [
        
    ],
    'related_to' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'is_completed' => true,
    'owner_ids' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'due_date_start' => '<string>',
    'due_date_end' => '<string>',
    'sort_by' => 'created_at',
    'sort_order' => 'desc'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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://api.stardex.ai/v1/tasks/search"

	payload := strings.NewReader("{\n  \"offset\": 0,\n  \"limit\": 100,\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"task_types\": [],\n  \"related_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"is_completed\": true,\n  \"owner_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"due_date_start\": \"<string>\",\n  \"due_date_end\": \"<string>\",\n  \"sort_by\": \"created_at\",\n  \"sort_order\": \"desc\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.stardex.ai/v1/tasks/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"offset\": 0,\n  \"limit\": 100,\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"task_types\": [],\n  \"related_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"is_completed\": true,\n  \"owner_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"due_date_start\": \"<string>\",\n  \"due_date_end\": \"<string>\",\n  \"sort_by\": \"created_at\",\n  \"sort_order\": \"desc\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.stardex.ai/v1/tasks/search")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"offset\": 0,\n  \"limit\": 100,\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"task_types\": [],\n  \"related_to\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"is_completed\": true,\n  \"owner_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"due_date_start\": \"<string>\",\n  \"due_date_end\": \"<string>\",\n  \"sort_by\": \"created_at\",\n  \"sort_order\": \"desc\"\n}"

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

{
  "success": true,
  "data": [
    {
      "id": "aaa11111-bbbb-cccc-dddd-eeeeeeee1111",
      "content_text": "Follow up with candidate about interview availability",
      "task_type": "text",
      "due_date": "2024-02-15T17:00:00Z",
      "is_completed": false,
      "person_id": "123e4567-e89b-12d3-a456-426614174000",
      "deal_id": "234e5678-e90a-12b3-c456-789012345678",
      "client_id": "345e6789-e01b-23c4-d567-890123456789",
      "job_id": "456e7890-e12b-34d5-a678-901234567890",
      "created_at": "2024-02-01T10:00:00Z",
      "updated_at": "2024-02-01T10:00:00Z",
      "owners": [
        {
          "id": "567e8901-e23c-45d6-e789-012345678901",
          "first_name": "Jane",
          "last_name": "Smith"
        }
      ]
    }
  ],
  "meta": {
    "total": 42,
    "offset": 0,
    "limit": 100
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Body

application/json

offset

integer | null

default:0

Records to skip for pagination. Defaults to 0.

Required range: x >= 0

limit

integer

default:100

Max records per page (1–100). Defaults to 100.

Required range: 1 <= x <= 100

keywords

string[]

Full-text search on task content. Uses PostgreSQL tsvector index for efficient matching.

task_types

enum<string>[]

Filter by one or more task types.

Available options:

text,

linkedin_message,

linkedin_connection,

call,

other

UUID of the related entity (person, deal, client, or job). Must be paired with related_record_type.

Type of the related entity. Must be paired with related_to.

Available options:

person,

deal,

client,

job

is_completed

boolean

Filter by completion status.

owner_ids

string<uuid>[]

Filter by assigned team member UUIDs. Returns tasks owned by any of these members. Get IDs from GET /v1/team-members.

due_date_start

string

ISO 8601 date — only include tasks due on or after this date. Tasks with no due date are excluded.

due_date_end

string

ISO 8601 date — only include tasks due on or before this date. Tasks with no due date are excluded.

sort_by

enum<string>

default:created_at

Column to sort by. One of: created_at (default), updated_at, due_date.

Available options:

created_at,

updated_at,

due_date

sort_order

enum<string>

default:desc

Sort direction. Defaults to desc.

Available options:

asc,

desc

Response

Tasks found

success

enum<boolean>

required

Available options:

true

data

object[]

required

Show child attributes

API Documentation

Activity Reports

Calendar Meetings

Candidates

Client Contacts

Companies

Company Activities

Company Insights

Custom Fields

Deal Activities

Deals

Job Activities

Jobs

Lists

Meeting Recordings

Person Activities

Persons

Scorecards

Tasks

Team Members

Webhooks

Search tasks

Authorizations

Body

Response