---
title: "/review-cycles/:reviewCycleId/tasks"
method: GET
path: "/review-cycles/{reviewCycleId}/tasks"
---

# /review-cycles/:reviewCycleId/tasks

`GET /review-cycles/{reviewCycleId}/tasks`

## Request

- Base URL: `https://subdomain.workable.com/spi/v3`
- URL: `https://subdomain.workable.com/spi/v3/review-cycles/{reviewCycleId}/tasks`
- Auth: API key in header `Authorization`

Returns the caller's own review tasks in a cycle, split into preparation tasks (forms the caller must prepare as reviewing manager) and active tasks (reviews to write or view, and share/sign actions). Required scope: `r_reviews`. Requires a user token, or an account token with `member_id`; an account token without `member_id` gets `403`. The caller must be able to view review cycles: either the `View review cycles` permission (global or scoped), or `View employee directory` in an account with performance reviews enabled.

If the member has no linked employee record both arrays are empty.

## Path parameters

- `reviewCycleId` string, required

## Query parameters

- `member_id` string

## Response `200`

200

- object
  - `preparation_tasks` object[]: Tasks where the caller, as the reviewing manager, must prepare the review forms
    - `id` string: Review task (aggregate) SPI key
    - `status` 'ready' | 'draft' | 'not_ready': Form preparation status
    - `review_cycle` object
      - `id` string: Review cycle SPI key
      - `name` string
      - `state` 'draft' | 'scheduled' | 'in_preparation' | 'active' | 'ended'
      - `customization_start_date` string, date-time, nullable
      - `customization_end_date` string, date-time, nullable
    - `reviewee` object
      - `id` string: Employee SPI key
      - `name` string: Employee name, formatted as `Lastname, Firstname`
    - `reviews` object[]: Reviews whose forms the manager may customize
      - `id` string: Review SPI key
      - `type` 'self' | 'manager' | 'peer' | 'upwards': Review type
      - `status` 'ready' | 'draft': Form status: `ready` once the review's form has been finalized, otherwise `draft`
      - `master_template_id` string, nullable: Id of the master template configured for this review type in the cycle
      - `follower_template_id` string, nullable: Id of the follower (customized) template for this review, or `null` if the form has not been customized
      - `update_form_url` string: Relative URL of the form endpoint for this review (GET to read, PUT to customize)
  - `active_tasks` object[]: Tasks where the caller has a review to write or view, or a task-level action
    - `id` string: Review task (aggregate) SPI key
    - `state` 'not_started' | 'in_progress' | 'shared' | 'signed'
    - `review_cycle` object
      - `id` string: Review cycle SPI key
      - `name` string
      - `state` 'draft' | 'scheduled' | 'in_preparation' | 'active' | 'ended'
    - `reviewee` object
      - `id` string: Employee SPI key
      - `name` string: Employee name, formatted as `Lastname, Firstname`
    - `reviews` object[]: Reviews assigned to the caller as reviewer
      - `id` string: Review SPI key
      - `type` 'self' | 'manager' | 'peer' | 'upwards'
      - `state` 'not_started' | 'draft' | 'submitted'
      - `submit_deadline` string, date-time, nullable
      - `share_deadline` string, date-time, nullable
      - `actions` object
        - `view` object
          - `url` string: Relative URL
        - `write` object
          - `url` string: Relative URL
    - `actions` object: Task-level actions available to the caller; omitted when none
      - `view` object
        - `url` string: Relative URL
      - `share` object
        - `url` string: Relative URL
      - `sign` object
        - `url` string: Relative URL

## Other responses

- `400`: Validation error: an object keyed by the invalid parameter, each entry holding the Joi error `code` and `message`
- `401`: Missing token (plain-text body)
- `403`: Plain-text body: `Required scopes missing: ["r_reviews"]`, `Account tokens need a member_id for this operation` for an account token without `member_id`, or `Forbidden` when the member is not allowed to access the resource
- `404`: 404

## Changes

- **2026-11-03** `13ad2e8e2ee9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/workable/apis/account-root/changes/review-cycles/:reviewCycleId/tasks/get.md)

---

[API](https://skmtc.dev/workable/apis/account-root.md) - [All operations](https://skmtc.dev/workable/apis/account-root/llms.txt) - [OpenAPI document](https://skmtc.dev/workable/apis/account-root/revisions/13ad2e8e2ee9?raw)