v1

latestOpenAPI 3.1.02026-07-26167644759.4 KB
Tasks

List tasks

Returns a list of tasks. Uses cursor pagination.

get/tasks

Query parameters

limitinteger
Example:25

Number of tasks to return per page (min: 1, max: 50, default: 25).

cursorstring

Base64-encoded cursor for pagination. Use the nextCursor value from a previous response to fetch the next page. Omit for the first page.

modifiedSincestring date-time

Filter tasks modified on or after this date. Useful for incremental synchronization. Defaults to beginning of time if not provided.

modifiedUntilstring date-time

Filter tasks modified on or before this date. Useful for bounded synchronization snapshots. If omitted, no upper bound is applied.

candidateIdsstring[]

Filter tasks linked to any of these candidates. Provide 1 to 10 items.

[
  "candidate-123",
  "candidate-456"
]
clientContactIdsstring[]

Filter tasks linked to any of these client contacts. Provide 1 to 10 items.

[
  "client-contact-123",
  "client-contact-456"
]
vacancyIdsstring[]

Filter tasks linked to any of these jobs. Provide 1 to 10 items.

[
  "job-123",
  "job-456"
]
companyIdsstring[]

Filter tasks linked to any of these companies. Provide 1 to 10 items.

[
  "company-123",
  "company-456"
]
opportunityIdsstring[]

Filter tasks linked to any of these opportunities. Provide 1 to 10 items.

[
  "opportunity-123",
  "opportunity-456"
]
sourcesstring[]

Filter tasks by source. Provide 1 to 10 items.

[
  "MANUAL",
  "AUTOMATION"
]
labelIdsstring[]

Filter tasks that have any of the given label IDs. Provide 1 to 10 items.

[
  "label-123",
  "label-456"
]

Response

Successfully retrieved tasks. Returns items array with pagination info containing cursor for the next page.