Skip to main content
POST
/
v1
/
tasks
/
search
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": [
    "text"
  ],
  "related_to": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "related_record_type": "person",
  "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"
}
'
{
  "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
  }
}

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
​
related_to
string<uuid>

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

​
related_record_type
enum<string>

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
​
meta
object
required