Tasks

List the authenticated principal's tasks

List the authenticated principal's tasks

Required scopes: tasks:read

Returns the open and recently-completed tasks assigned to the token principal's email, scoped to the token's organization and mode. The principal is resolved server-side from api_tokens.created_by; if the creator is no longer an org member, the request returns 422 token_principal_not_resolvable and an admin must re-issue the token under a current member. See the Token principal lifecycle section in docs/api/tasks-api.md. Cursor-paginated via starting_after=<tsk_…> keyed on (due_date, created_at, id). Review tasks include stack_key and job_id for grouping within the current organization and mode. Survey-token metadata is never returned; survey deep-links carry the ?token=auth sentinel so the dashboard re-authenticates the viewer.

Example (curl):

curl 'https://api.yardstick.team/v1/tasks?limit=20&status=in_progress' \
  -H 'Authorization: Bearer ys_sk_live_…'

Example (TypeScript):

await fetch(
  "https://api.yardstick.team/v1/tasks?limit=20&status=in_progress",
  { headers: { Authorization: `Bearer ${process.env.YS_API_KEY}` } },
).then((r) => r.json());
get/v1/tasks

Request

  • Base URL: https://api.yardstick.team
  • URL: https://api.yardstick.team/v1/tasks
  • Auth: HTTP bearer

Query parameters

limitinteger

Page size (1-100, default 20).

starting_afterstring

Cursor: id of the last record from the previous page.

task_typestring

Filter by user_tasks.task_type (e.g. application_interview, interview_session, survey_schedule).

statusstring

Filter by task status (e.g. pending, in_progress, completed).

due_beforestring date-time

ISO-8601 UTC; only tasks due on or before this time.

due_afterstring date-time

ISO-8601 UTC; only tasks due on or after this time.

Headers

X-Request-Idstring

Optional caller-supplied request identifier. Values must match ^[A-Za-z0-9_-]{1,128}$; a valid value is echoed in the response X-Request-Id header, otherwise the API generates one.

Response

Success

object required

Changes

No recorded changes to this operation across all 1 revision of this API.