Create / update / delete / set-default an organization custom field preset.
Required: action ('create' | 'update' | 'delete' | 'set_default'), space_id. Create: name, optional description, custom_field_ids (list of WorkspaceCustomField public_ids; order is positional), is_default. Update / delete / set_default: preset_id. set_default sets the preset as the default *for this space*.
URL
- User APIhttps://productivity.mattering.io/api/user/v1/custom-field-presets/manage/
- Service tierhttps://productivity.mattering.io/api/internal/custom-field-presets/manage/
Body keys (JSON)
| Key | Required | Default |
|---|---|---|
action | optional or conditional | none |
custom_field_ids | optional or conditional | none |
description | optional or conditional | none |
is_default | optional or conditional | none |
name | optional or conditional | none |
preset_id | optional or conditional | none |
space_id | optional or conditional | none |
user_id | optional or conditional | none |
Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Responses
200 bare JSON object (no envelope)
{
"success": true,
"custom_field_preset": {
"public_id": "...",
"name": "...",
"description": "...",
"is_default_for_space": true,
"fields": [
{
"id": "...",
"custom_field_id": "...",
"name": "...",
"field_type": "...",
"order": 0
}
],
"field_count": "...",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z"
}
}
200 bare JSON object (no envelope)
{
"success": true,
"message": "..."
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 400 | duplicate_name |
| 400 | invalid_action |
| 400 | name_required |
| 400 | preset_id_required |
| 401 | missing_actor |
| 401 | unauthorized |
| 403 | forbidden |
| 404 | preset_not_found |
| 404 | space_not_found |
Example
curl -X POST "https://productivity.mattering.io/api/user/v1/custom-field-presets/manage/" \
-H "Authorization: Bearer $MATTERING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"action": "...",
"custom_field_ids": "...",
"description": "...",
"is_default": "...",
"name": "...",
"preset_id": "...",
"space_id": "...",
"user_id": "..."
}'curl -X POST "https://productivity.mattering.io/api/internal/custom-field-presets/manage/" \
-H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \
-H "X-Internal-Org-Id: $ORG_ID" \
-H "X-Internal-User-Email: you@example.com" \
-H "Content-Type: application/json" \
-d '{
"action": "...",
"custom_field_ids": "...",
"description": "...",
"is_default": "...",
"name": "...",
"preset_id": "...",
"space_id": "...",
"user_id": "..."
}'
Source: MatteringPMCore/internal_api.py (internal_api.internal_manage_custom_field_preset)