---
title: "Create a custom table record link associated with a requirement"
method: PUT
path: "/requirements/{id}"
tags: ["Custom table record links"]
---

# Create a custom table record link associated with a requirement

`PUT /requirements/{id}`

Resources that can be linked to records from a custom table (called custom objects in the API) can be manipulated in a bulk ID-list format.
To use custom table record links you must first add a many-to-many custom field definition to the resource.
When you pass the IDs of custom table records to link to the feature, the existing list of links will be replaced.

Examples of linking custom objects to resources with a many-to-many `customer` field:

- [Products](/api/resources/custom_table_record_links/create_a_custom_table_record_link_associated_with_a_product)
- [Releases](/api/resources/custom_table_record_links/create_a_custom_table_record_link_associated_with_a_release)
- [Features](/api/resources/custom_table_record_links/create_a_custom_table_record_link_associated_with_a_feature)
- [Ideas](/api/resources/custom_table_record_links/create_a_custom_table_record_link_associated_with_an_idea)
- [Initiatives](/api/resources/custom_table_record_links/create_a_custom_table_record_link_associated_with_an_initiative)
- [Goals](/api/resources/custom_table_record_links/create_a_custom_table_record_link_associated_with_a_goal)
- [Organizations](/api/resources/custom_table_record_links/create_a_custom_table_record_link_associated_with_an_organization)

**[Custom tables](https://www.aha.io/support/roadmaps/strategic-roadmaps/customizations/custom-tables) are an Enterprise+ exclusive feature.**

## Path parameters

- `id` string, required

## Request body

- CustomtablerecordlinksPostRequest
  - `requirement` object
    - `custom_object_links` object
      - `customers` string[]

## Response `200`

Successful operation

## Changes

> 5 revisions in range; 3 could not be searched.

- **2026-07-26** `69bd8c9e8932` — 1 info
  - added the optional property `requirement/workflow_status/workflow_status_category` to the response with the `200` status

[Change history](https://skmtc.dev/aha/apis/aha-api/changes/requirements/:id/put.md)

---

[API](https://skmtc.dev/aha/apis/aha-api.md) · [All operations](https://skmtc.dev/aha/apis/aha-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aha/aha-api/revisions/f2725b45bcf3/schema)