# Feature FND-273 - Expose work_package categories in the API

Project: Stream workspace foundations
Status: needs review
URL: https://community.openproject.org/work_packages/FND-273

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 18.1.0 |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

| ID | Subject | Type | Status | Assignee | Target versions | Spent time |
| --- | --- | --- | --- | --- | --- | --- |
| FND-282 | Add categories to the work package representer, schema and form | Implementation | needs review |  | 18.1.0 |  |

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Feature Flag |  |
| Requires doc change | No |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers | Tom Hykel |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**As an** API client or an import tool  
**I want to** read and write several categories on a work package  
**so that** integrations and importers (for example Jira components) keep all values.

**Acceptance criteria**

*   The work package resource has a link array `_links.categories`.
    
*   The work package schema shows `categories` with the allowed values of the project.
    
*   When feature flag disabled:
    
    *   **category** still exists but marked as deprecated
        
    *   **categories** is a single value in an array
        
*   When the feature flag is enabled
    
    *   **category** is removed
        
    *   **categories** is multi value
        

**Technical notes**
