Tasks

Resolve a task to a dashboard deep link

Resolve a task to a dashboard deep link

Required scopes: tasks:read

Returns { web_url, route, mode } for the supplied tsk_… id. Mode-partitioned: a live token requesting a test-mode task receives 404 not_found (never 403) to avoid leaking cross-partition existence. If the underlying resource the task references has been deleted, the response is 410 resource_gone. Survey and reviewer_evaluation tasks return URLs ending in ?token=auth; the private survey-completion token is never included in the response.

Example (curl):

curl https://api.yardstick.team/v1/tasks/tsk_abc123/actions/deep_link \
  -H 'Authorization: Bearer ys_sk_live_…'

Example (TypeScript):

await fetch(
  "https://api.yardstick.team/v1/tasks/tsk_abc123/actions/deep_link",
  { headers: { Authorization: `Bearer ${process.env.YS_API_KEY}` } },
).then((r) => r.json());
get/v1/tasks/{task_id}/actions/deep_link

Request

  • Base URL: https://api.yardstick.team
  • URL: https://api.yardstick.team/v1/tasks/{task_id}/actions/deep_link
  • Auth: HTTP bearer

Path parameters

task_idstring required

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.