## Move a custom field

`PUT https://getkollek.com/api/collection-types/{collectionType}/custom-fields/{customField}/order`

Move a field one step up or down among the fields of its group, or among the standalone fields of the type when it has no group. Use the update endpoint instead to set a position directly.

Moving a field that is already first up, or already last down, leaves the order untouched and still returns a 200 response. A field never crosses into another group this way.

**Permissions:** Owners and editors. Viewers get a 404 response.

### Path parameters

- `collectionType` (integer, required): The ID of the collection type the field belongs to.
- `customField` (integer, required): The ID of the custom field.

### Body parameters

- `direction` (string, required): The direction to move the field in. One of up or down.

**Returns:** The moved custom_field object, with its new position.

### Example request

```bash
curl https://getkollek.com/api/collection-types/1/custom-fields/2/order \
  -X PUT \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": "up"
}'
```

### Example response

`Status: 200`

```json
{
    "data": {
        "type": "custom_field",
        "id": "2",
        "attributes": {
            "name": "Grade",
            "field_type": "select",
            "options": [
                "NM",
                "VF",
                "FN"
            ],
            "position": 1,
            "group_id": null,
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/collection-types/1/custom-fields/2"
        }
    }
}
```