Preview changing a custom field’s type
Starts reading every value of the field as the new type: how many convert and how many don’t, with examples of each and why. Nothing changes until it’s converted. Replaces a preview that’s still open. 422 `custom_field_same_type`, `custom_field_archived`; 422 `custom_field_platform_type` when a connected store keeps the field as another type; 409 `custom_field_converting` while the type is being changed.
Starts reading every value of the field as the new type: how many convert and how many don’t, with examples of each and why. Nothing changes until it’s converted. Replaces a preview that’s still open. 422 custom_field_same_type, custom_field_archived; 422 custom_field_platform_type when a connected store keeps the field as another type; 409 custom_field_converting while the type is being changed.
apiKey writeAuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: write
id*stringuuididempotency-key?stringRun this write once: a retry with the same key gets the first answer (24 hours).
1 <= length <= 255application/json- body
type*string"text""number""boolean""date""list""json"Created
application/json- response
id*stringuuidfieldId*stringuuidfromType*string"text""number""boolean""date""list""json"toType*string"text""number""boolean""date""list""json"status*string"previewing""ready""converting""completed""failed"counts*converts*array<>removes*array<>reasons*array<>error*string|nullcreatedAt*stringdate-timereadyAt*|date-timestartedAt*|date-timecompletedAt*|date-timecurl -X POST 'https://api.postforge.dev/v1/custom-fields/497f6eca-6276-4993-bfeb-53cbbbba6f08/conversion-preview' \ -H 'Content-Type: application/json' \ -d '{ "type": "text"}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "fieldId": "84922011-b03d-4966-bc95-c5b49bc2e342", "fromType": "text", "toType": "text", "status": "previewing", "counts": { "values": 0, "checked": 0, "converts": 0, "removes": 0, "converted": 0, "removed": 0 }, "converts": [ { "before": "string", "after": "string" } ], "removes": [ { "value": "string", "reason": "string" } ], "reasons": [ { "reason": "string", "count": 0 } ], "error": "string", "createdAt": "2019-08-24T14:15:22Z", "readyAt": "2019-08-24T14:15:22Z", "startedAt": "2019-08-24T14:15:22Z", "completedAt": "2019-08-24T14:15:22Z"}List the values a custom field holds GET
The values profiles hold in a text or list field (a list’s items one by one), most used first, at most 20; `q` keeps those containing it. For suggestions while someone types a value.
Get a custom field’s type change GET
The field’s open type change (being previewed, waiting to convert or converting), else the last one; null when its type never changed.