Update Column Type

Change the data type of an existing column with preview and conversion support.

PUT https://api.futureagi.com/model-hub/develops/{dataset_id}/update_column_type/{column_id}/

Authentication

X-Api-Key API Key Required

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

X-Secret-Key Secret Key Required

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

Path parameters

dataset_id UUID Required

The dataset ID.

column_id UUID Required

The column ID.

Request body

new_column_type string Required

Target data type for the column.

preview boolean Optional

When true, returns a conversion preview without applying changes.

force_update boolean Optional

When true, forces conversion even if some values are incompatible.

Response

200 OK

The response structure varies depending on whether the request is in preview mode or execution mode.

message string
Status message.
data object
Conversion preview data.
invalid_count integer
Number of values that cannot be converted.
invalid_values array
Sample values that cannot be converted.
valid_conversion_samples object
Mapping of original values to converted equivalents.
new_data_type string
Target data type evaluated.
column_id string
UUID of the column.
new_data_type string
Target data type.
status string
Conversion task status.

Errors

400 Bad Request Optional
Invalid request parameters.
401 Unauthorized Optional
Invalid or missing API credentials.
404 Not Found Optional
The specified column or dataset was not found, or does not belong to your organization.
500 Internal Server Error Optional
Unexpected server error.
GET /
Authentication
REQUEST
 
RESPONSE