---
title: "GET /portfolio/{portfolioId}/field_options"
method: GET
path: "/portfolio/{portfolioId}/field_options"
tags: ["Portfolios"]
---

# GET /portfolio/{portfolioId}/field_options

`GET /portfolio/{portfolioId}/field_options`

## Request

- Base URL: `https://api.craft.io`
- URL: `https://api.craft.io/portfolio/{portfolioId}/field_options`
- Auth: API key in header `x-api-key`

Get every Importance configured in the portfolio

Includes options no initiative is set to yet, in the order the app lists them, top first.
Portfolio and workspace importances are separate lists.

## Path parameters

- `portfolioId` string, required

## Response `200`

The portfolio’s importances

- FieldOptions: Every option configured for the native fields, including options no item uses.
  - `importances` FieldOption[]: In the order the app lists them, top first.
    - `id` string, required
    - `name` string, required
    - `isDefault` boolean: Present, and true, on what a new item gets when the field is left out.
    - `startDate` string, nullable
    - `endDate` string, nullable
    - `closed` boolean: Present, and true, on a sprint that has been closed. It can still be assigned.
    - `current` boolean: Present, and true, on the sprint or quarter that is running today.
  - `quarters` FieldOption[]: Workspace only.
    - `id` string, required
    - `name` string, required
    - `isDefault` boolean: Present, and true, on what a new item gets when the field is left out.
    - `startDate` string, nullable
    - `endDate` string, nullable
    - `closed` boolean: Present, and true, on a sprint that has been closed. It can still be assigned.
    - `current` boolean: Present, and true, on the sprint or quarter that is running today.
  - `sprints` FieldOption[]: Workspace only.
    - `id` string, required
    - `name` string, required
    - `isDefault` boolean: Present, and true, on what a new item gets when the field is left out.
    - `startDate` string, nullable
    - `endDate` string, nullable
    - `closed` boolean: Present, and true, on a sprint that has been closed. It can still be assigned.
    - `current` boolean: Present, and true, on the sprint or quarter that is running today.
  - `personas` FieldOption[]: Workspace only.
    - `id` string, required
    - `name` string, required
    - `isDefault` boolean: Present, and true, on what a new item gets when the field is left out.
    - `startDate` string, nullable
    - `endDate` string, nullable
    - `closed` boolean: Present, and true, on a sprint that has been closed. It can still be assigned.
    - `current` boolean: Present, and true, on the sprint or quarter that is running today.
  - `counts` object: Workspace only: how many of each exist, whatever the filter.
    - `personas` number, double, required
    - `sprints` number, double, required
    - `quarters` number, double, required
    - `importances` number, double, required

## Other responses

- `400`: Invalid portfolio ID
- `401`: No access to portfolio
- `403`: Access denied
- `404`: Portfolio not found

## Changes

- **2026-11-12** `e5d353b25c4b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/craft/apis/craft-io-public-api/changes/portfolio/:portfolioId/field_options/get.md)

---

[API](https://skmtc.dev/craft/apis/craft-io-public-api.md) - [All operations](https://skmtc.dev/craft/apis/craft-io-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/craft/apis/craft-io-public-api/revisions/e5d353b25c4b?raw)
