Skip to main content
PUT

Authorizations

Authorization
string
header
required

User-principal OAuth 2.0 Bearer authentication. Send a user-scoped Auth0 access token (audience = the app API audience) as Authorization: Bearer <jwt>. The request resolves to the user's identity and is authorized by their Role on the {companyId} in the path — the same role-based permissions the web app enforces. This is the path the MCP connector uses to act on a user's behalf; endpoints that accept it list both BearerAuth and ApiKeyAuth.

Path Parameters

companyId
string<uuid>
required

Company identifier

presetId
string<uuid>
required

Export preset identifier

Body

application/json
name
string
required

The preset's new name. Surrounding spaces are trimmed.

Required string length: 1 - 255
fieldKeys
string[]
required

The preset's new columns, in column order. Each key must be offered by the company's export surface for the preset's entity type and rowSource, and no key may repeat.

Minimum array length: 1
Minimum string length: 1
rowSource
string | null
required

The Object List field whose items become the preset's rows, or null for one row per record.

Minimum string length: 1

Response

The preset as replaced.

A company member's saved export preset.

id
string<uuid>
required
ownerUserId
string<uuid>
required

The member who owns the preset

entityType
enum<string>
required

The export screen the preset belongs to, or bordereau for the Export Bordereau screen.

Available options:
event,
exposure,
quote,
submission,
person,
organization,
policy,
bordereau
name
string
required
visibility
enum<string>
required

private presets are seen only by their owner; shared presets are offered to every member of the company.

Available options:
private,
shared
isDefault
boolean
required

Whether this is the owner's default preset for its entity type.

rowSource
string | null
required

The Object List field the preset exports one row per item of, or null for one row per record.

fieldKeys
string[]
required

The preset's columns, in column order

createdAt
string<date-time>
required
updatedAt
string<date-time>
required