addCustomObjectFieldToRequest | Atomicwork

Add a Custom Object relationship field to Requests.

Creates a RELATIONSHIP field on Requests that links to a specific custom object type. For example, add a “Contract” field to requests so agents can link requests to contracts.

Parameters

Name	Type	Required	Description
`workspaceId`	integer	Yes	The workspace ID where the field should be added.
`entity_type`	string	No	Entity type (ASSET, REQUEST, CUSTOM_OBJECT). Set automatically based on endpoint.
`type`	string (enum, 18 values)	Yes	The field type. Valid values: SHORT_TEXT, LONG_TEXT, RICH_TEXT, NUMBER, DECIMAL,
`display_name`	string	Yes	Human-readable field label (e.g., “Visa Number”, “Assigned Agent”)
`reference_key`	string	No	Machine-readable key. Auto-generated if not provided.
`required_field`	boolean	No	Whether this field is required when creating instances. Default: `False`.
`hint`	string	No	Placeholder/help text shown in the form input
`order`	integer	No	Display order in the form. Auto-assigned if not provided.
`options`	object[]	No	For DROPDOWN/MULTI_DROPDOWN only. Valid option values.
`relationship`	object	No	For RELATIONSHIP fields only. Target entity configuration.
`request_types`	`SERVICE_REQUEST` \| `INCIDENT` \| `PROBLEM`[]	No	For adding fields to Requests only. Scopes which request types the field applies to.
`asset_settings`	object	No	For adding fields to Assets only. Specifies which asset types the field applies to.