Skip to main content

System administration

Configure DAM system settings and run administrative operations such as index rebuilds and integration log review.

This area has 2 groups and 28 tools, 25 of them currently available.

How to read this page
  • Groups are the unit of access. An admin enables tool groups on a client registration, and a tool appears in an agent's tool list only when its group is enabled. See Tool Groups.
  • Needs. Enabling a group also enables every group it needs. Each group below lists them.
  • Read-only groups are intended for look-up access without the ability to change data.
  • Visibility is not authorization. Every tool call executes as the authenticated user, and a visible tool can still return an authorization error. See the MCP Tool Permission Map.
  • Destructive tools are labelled as such. They delete or irreversibly overwrite data, and will not act unless the call sets both confirmed and confirmedDestructive to true.
  • Not currently available tools are registered but are not offered in any tool list at this time.
  • Activity and Project labels vary by tenant. Where this page says Activity or Project, your tenant's own configured terminology is substituted at runtime.

Groups in this area​

GroupAccessNeedsTools
Configure DAM System SettingsCan change dataNone13
Administer & Monitor the DAM SystemCan change dataNone15

Configure DAM System Settings​

Can change data · 13 tools · Group ID configure-dam-system-settings

Needs: no other groups.

ToolWhat it does
create_setting_categoryCreates a new Aprimo setting category.
create_setting_definitionCreates a new Aprimo setting definition.
delete_setting_categoryDestructive. Permanently deletes an Aprimo setting category by id or by name.
delete_setting_definitionDestructive. Permanently deletes an Aprimo setting definition by id or by name.
get_settingGets one Aprimo setting's current value by its exact name (e.g. ".defaultRecordTitleField").
get_setting_categoryGets one Aprimo setting category's detail (labels, tag, dates) by id or by name.
get_setting_definitionGets one Aprimo setting definition's detail (data type, category, access flags, labels) by id or by name.
list_setting_categoriesLists the setting categories configured in Aprimo — named groupings used to organize related system settings for display (e.g. in Config Studio).
list_setting_definitionsLists the setting definitions configured in Aprimo — the schema (name, data type, category) of each system setting.
list_settingsLists Aprimo settings by name.
update_settingSets the value of an existing Aprimo setting by its exact name, at a specific scope (site/system/user/user group).
update_setting_categoryEdits an existing Aprimo setting category by id or by name.
update_setting_definitionEdits an existing Aprimo setting definition by id or by name.

create_setting_category​

Creates a new Aprimo setting category. This modifies data. Always confirm the name with the user before calling this tool.

Parameters:

ParameterTypeRequiredDescription
namestringYesThe name for the new setting category, exactly as the user stated it.
labelsobject (map of string)NoMulti-language labels for the name of this setting category: a map of languageId (GUID) to label value.
tagstringNoOptional free-form tag for this setting category. Must be valid XML if provided.

Returns:

FieldTypeDescription
idstring
namestring

create_setting_definition​

Creates a new Aprimo setting definition. This modifies data. Always confirm the name, data type, and category with the user before calling this tool. Confirmed live against the tenant: DAM rejects a name containing spaces or a leading decimal point, and a name with any non-alphanumeric character ("The name of a setting should only contain alphanumeric characters, should not start with a decimal point and spaces are not allowed.") -- use a PascalCase-style name with no spaces/ punctuation. DAM also rejects a definition with no access-control flag set at all ("you need to specify at least one access control") -- set at least one of allowAnonymousAccess/allowSystemSetting/allowSiteSetting/allowUserSetting to true.

Parameters:

ParameterTypeRequiredDescription
namestringYesThe name for the new setting definition. DAM requires alphanumeric characters only -- no spaces, no punctuation, and it must not start with a decimal point.
dataTypestringYesThe setting's data type. One of: text, boolean, numeric, datetime, xml, role, reference, encryptedtext.
categoryIdstringYesThe id (GUID) of the setting category this definition belongs to.
allowAnonymousAccessbooleanNoWhen true, this setting can be read without authentication. Defaults to false.
allowSystemSettingbooleanNoWhen true, this setting can be configured at the system level.
allowSiteSettingbooleanNoWhen true, this setting can be configured at the site level.
allowUserSettingbooleanNoWhen true, this setting can be configured per user.
roleRequiredForChangestringNoOptional name of the role required to change settings of this definition.
labelsobject (map of string)NoMulti-language labels for the name of this setting definition: a map of languageId (GUID) to label value.
tagstringNoOptional free-form tag for this setting definition. Must be valid XML if provided.
helpUrlstringNoOptional URL to help documentation for this setting definition.
userGroupSettingModestringNoOptional algorithm for computing the effective value across user-group settings. One of: None, MaximumValue, MinimumValue, Manual, FirstValue.
defaultValuestringNoOptional default value for this setting definition, as a plain string. For dataType 'boolean' provide "true"/"false"; for 'numeric' provide a whole number — both are sent to Aprimo as their native JSON type, not a quoted string. Every other dataType (including 'datetime', as an ISO-8601 string) is sent as-is.
regularExpressionstringNoOptional regular expression used to validate the value (text/encryptedtext data types).
rangestringNoOptional range of allowed values, e.g. "1-255" (numeric data type).
schemastringNoOptional schema used to validate the value (xml data type).

Returns:

FieldTypeDescription
idstring
namestring

delete_setting_category​

Destructive

Permanently deletes an Aprimo setting category by id or by name. This cannot be undone. Requires both confirmed=true and confirmedDestructive=true, after explicitly confirming the exact setting category with the user.

Parameters:

ParameterTypeRequiredDescription
settingCategoryIdstringNoThe setting category id (GUID) to delete. Provide this or name, not both.
namestringNoThe setting category's exact name (case-insensitive). Provide this or settingCategoryId, not both.
confirmedbooleanNoMust be true to proceed. Set to false (or omit) to get a confirmation gate error, then call again with confirmed=true after the user has explicitly confirmed the exact setting category.
confirmedDestructivebooleanNoMust also be true (in addition to confirmed) — deleting a setting category is permanent and cannot be undone. Set only after stating the exact setting category to the user and getting explicit go-ahead.

Returns:

FieldTypeDescription
idstring
namestring (optional)
deletedboolean
Destructive operation

This tool deletes or irreversibly overwrites data in the live tenant; the change cannot be rolled back through the API. It will not act unless the call sets both confirmed and confirmedDestructive to true.


delete_setting_definition​

Destructive

Permanently deletes an Aprimo setting definition by id or by name. This cannot be undone. Requires both confirmed=true and confirmedDestructive=true, after explicitly confirming the exact setting definition with the user.

Parameters:

ParameterTypeRequiredDescription
settingDefinitionIdstringNoThe setting definition id (GUID) to delete. Provide this or name, not both.
namestringNoThe setting definition's exact name (case-insensitive). Provide this or settingDefinitionId, not both.
confirmedbooleanNoMust be true to proceed. Set to false (or omit) to get a confirmation gate error, then call again with confirmed=true after the user has explicitly confirmed the exact setting definition.
confirmedDestructivebooleanNoMust also be true (in addition to confirmed) — deleting a setting definition is permanent and cannot be undone. Set only after stating the exact setting definition to the user and getting explicit go-ahead.

Returns:

FieldTypeDescription
idstring
namestring (optional)
deletedboolean
Destructive operation

This tool deletes or irreversibly overwrites data in the live tenant; the change cannot be rolled back through the API. It will not act unless the call sets both confirmed and confirmedDestructive to true.


get_setting​

Gets one Aprimo setting's current value by its exact name (e.g. ".defaultRecordTitleField"). Not its category (get_setting_category) or its definition/schema (get_setting_definition). Optionally reads it at a specific scope (site/system/user/user group) rather than the caller's own effective value.

Parameters:

ParameterTypeRequiredDescription
settingNamestringYesThe setting's exact name, e.g. ".defaultRecordTitleField".
scopestringNoOptional scope to read the setting at. One of: Site, System, User, UserGroup. Omit to read the caller's own effective value.
scopeIdstringNoThe id (GUID) of the entity the scope applies to (e.g. a user group id when scope is UserGroup). Required together with scope, when scope needs one.

Returns:

FieldTypeDescription
namestring
valuestring (optional)

get_setting_category​

Gets one Aprimo setting category's detail (labels, tag, dates) by id or by name. Use after list_setting_categories, or directly when the user names the category.

Parameters:

ParameterTypeRequiredDescription
settingCategoryIdstringNoThe setting category id (GUID). Provide this or name, not both.
namestringNoThe setting category's exact name (case-insensitive). Provide this or settingCategoryId, not both.

Returns:

FieldTypeDescription
idstring
namestring
labelsarray of SettingLabelPayload
labels[].valuestring (optional)
labels[].languageIdstring
tagstring (optional)
createdOnstring (optional)
modifiedOnstring (optional)

get_setting_definition​

Gets one Aprimo setting definition's detail (data type, category, access flags, labels) by id or by name. Use after list_setting_definitions, or directly when the user names the definition.

Parameters:

ParameterTypeRequiredDescription
settingDefinitionIdstringNoThe setting definition id (GUID). Provide this or name, not both.
namestringNoThe setting definition's exact name (case-insensitive). Provide this or settingDefinitionId, not both.

Returns:

FieldTypeDescription
idstring
namestring
dataTypestring (optional)
categoryIdstring (optional)
helpUrlstring (optional)
userGroupSettingModestring (optional)
labelsarray of SettingLabelPayload
labels[].valuestring (optional)
labels[].languageIdstring
allowSystemSettingboolean (optional)
allowUserSettingboolean (optional)
roleRequiredForChangestring (optional)
defaultValueobject (optional)
createdOnstring (optional)
modifiedOnstring (optional)

list_setting_categories​

Lists the setting categories configured in Aprimo — named groupings used to organize related system settings for display (e.g. in Config Studio). Use when the user asks what setting categories exist, or to look up a category's id/exact name before calling get_setting_category, update_setting_category, or delete_setting_category by name.

Parameters:

ParameterTypeRequiredDescription
filterstringNoOptional filter expression (DAM query syntax), e.g. "ModifiedOn in today". Omit to list every setting category.
sortstringNoOptional sort expression, e.g. "createdOn". Omit for the endpoint's default order.
skipintegerNoNumber of items to skip, for paging. Defaults to 0.
takeintegerNoMaximum number of items to return. Omit for the endpoint's default page size.

Returns:

FieldTypeDescription
countinteger
itemsarray of SettingCategoryPayload
items[].idstring
items[].namestring
items[].labelsarray of SettingLabelPayload
items[].labels[].valuestring (optional)
items[].labels[].languageIdstring
items[].tagstring (optional)
items[].createdOnstring (optional)
items[].modifiedOnstring (optional)

list_setting_definitions​

Lists the setting definitions configured in Aprimo — the schema (name, data type, category) of each system setting. Use when the user asks what setting definitions exist, or to look up a definition's id/exact name before calling get_setting_definition, update_setting_definition, or delete_setting_definition by name.

Parameters:

ParameterTypeRequiredDescription
filterstringNoOptional filter expression (DAM query syntax), e.g. "ModifiedOn in today". Omit to list every setting definition.
sortstringNoOptional sort expression, e.g. "createdOn". Omit for the endpoint's default order.
skipintegerNoNumber of items to skip, for paging. Defaults to 0.
takeintegerNoMaximum number of items to return. Omit for the endpoint's default page size.

Returns:

FieldTypeDescription
countinteger
itemsarray of SettingDefinitionPayload
items[].idstring
items[].namestring
items[].dataTypestring (optional)
items[].categoryIdstring (optional)
items[].helpUrlstring (optional)
items[].userGroupSettingModestring (optional)
items[].labelsarray of SettingLabelPayload
items[].labels[].valuestring (optional)
items[].labels[].languageIdstring
items[].allowSystemSettingboolean (optional)
items[].allowUserSettingboolean (optional)
items[].roleRequiredForChangestring (optional)
items[].defaultValueobject (optional)
items[].createdOnstring (optional)
items[].modifiedOnstring (optional)

list_settings​

Lists Aprimo settings by name. Only settings the caller may see are returned (DAM's own allowlist/whitelist mechanism silently omits the rest — this never fails with an error for that reason). Provide exact setting names (e.g. ".defaultRecordTitleField") — there is no browse-all or partial-match query for settings.

Parameters:

ParameterTypeRequiredDescription
names. Required — the endpoint has no browse-all for settings and 400s if this is omitted or empty.")] List<string>YesExact setting names to fetch, e.g. [".recordFieldViewList", ".userFieldViewList"]. Required — the endpoint has no browse-all for settings and 400s if this is omitted or empty.
skipintegerNoNumber of items to skip, for paging. Defaults to 0.
takeintegerNoMaximum number of items to return. Omit for the endpoint's default page size.

Returns:

FieldTypeDescription
countinteger
itemsarray of SettingPayload
items[].namestring
items[].valuestring (optional)

update_setting​

Sets the value of an existing Aprimo setting by its exact name, at a specific scope (site/system/user/user group). This modifies data. Always confirm the exact setting name, scope, and new value with the user before calling this tool.

Parameters:

ParameterTypeRequiredDescription
settingNamestringYesThe setting's exact name to update, e.g. ".defaultRecordTitleField".
valuestringYesThe new value for this setting, exactly as the user stated it.
scopestringYesScope to set the setting at. One of: Site, System, User, UserGroup. Required -- the endpoint has no caller-default scope and 400s with "The setting's scope property should be set." if this is omitted.
scopeIdstringNoThe id (GUID) of the entity the scope applies to (e.g. a user group id when scope is UserGroup). Required together with scope, when scope needs one.

Returns:

FieldTypeDescription
namestring
valuestring
scopestring (optional)
scopeIdstring (optional)

update_setting_category​

Edits an existing Aprimo setting category by id or by name. Only the fields provided are changed — omitted fields keep their current value. This modifies data. Always confirm the exact setting category and the new values with the user before calling this tool.

Parameters:

ParameterTypeRequiredDescription
settingCategoryIdstringNoThe setting category id (GUID) to edit. Provide this or name, not both.
namestringNoThe setting category's current name (case-insensitive), used to look it up. Provide this or settingCategoryId, not both.
newNamestringNoNew name for the setting category. Omit to leave the name unchanged.
labelsobject (map of string)NoLabel values to set: a map of languageId (GUID) to label value. Only the languages provided are changed.
tagstringNoNew free-form tag. Must be valid XML if provided. Omit to leave it unchanged.

Returns:

FieldTypeDescription
idstring
namestring (optional)

update_setting_definition​

Edits an existing Aprimo setting definition by id or by name. Only the fields provided are changed — omitted fields keep their current value. This modifies data. Always confirm the exact setting definition and the new values with the user before calling this tool. Note: the data type cannot be changed after creation.

Parameters:

ParameterTypeRequiredDescription
settingDefinitionIdstringNoThe setting definition id (GUID) to edit. Provide this or name, not both.
namestringNoThe setting definition's current name (case-insensitive), used to look it up. Provide this or settingDefinitionId, not both.
newNamestringNoNew name for the setting definition. Omit to leave the name unchanged.
categoryIdstringNoNew setting category id (GUID). Omit to leave it unchanged.
defaultValuestringNoNew default value (as a plain string). Omit to leave it unchanged.
regularExpressionstringNoNew regular expression used to validate the value. Omit to leave it unchanged.
rangestringNoNew range of allowed values, e.g. "1-255". Omit to leave it unchanged.
schemastringNoNew schema used to validate the value. Omit to leave it unchanged.
labelsobject (map of string)NoLabel values to set: a map of languageId (GUID) to label value. Only the languages provided are changed.
allowSystemSettingbooleanNoNew value for whether this setting can be configured at the system level. Omit to leave it unchanged.
allowUserSettingbooleanNoNew value for whether this setting can be configured per user. Omit to leave it unchanged.
roleRequiredForChangestringNoNew name of the role required to change settings of this definition. Omit to leave it unchanged.
userGroupSettingModestringNoNew algorithm for computing the effective value across user-group settings. One of: None, MaximumValue, MinimumValue, Manual, FirstValue. Omit to leave it unchanged.
helpUrlstringNoNew URL to help documentation. Omit to leave it unchanged.
tagstringNoNew free-form tag. Must be valid XML if provided. Omit to leave it unchanged.

Returns:

FieldTypeDescription
idstring
namestring (optional)

Administer & Monitor the DAM System​

Can change data · 15 tools (12 currently available) · Group ID administer-monitor-the-dam-system

Needs: no other groups.

ToolWhat it does
fill_fda_formNot currently available. Fills the FDA 2253 form from submitted field data in Aprimo Marketing Operations.
get_content_security_policyGets the Content Security Policy domain allowlist for this Aprimo DAM location.
get_dam_version_infoNot currently available. Gets the currently active Aprimo DAM release/version number.
get_integration_logReturns a single integration log by its integer ID in Aprimo Marketing Operations.
get_search_index_statusGets the status of Aprimo's record/classification search index: whether a rebuild is required/currently scheduled, indexed record/classification counts, pending changes, and the last rebuild time.
get_supported_versionNot currently available. Gets detail (documentation URI) for one supported Aprimo API version, by its exact version number.
get_unique_key_index_statusGets the status of Aprimo's unique-key index (enforces uniqueness for fields configured as unique keys across records and classifications): processed record/classification counts, whether reindexing is running, whether duplicates were found, and whether a rebuild is required.
list_countersLists every named counter configured in Aprimo (persistent, atomically-incrementing integer sequences typically used to generate unique values, e.g. an invoice number or SKU, for a custom field): name and current value.
list_integration_logsLists integration logs in Aprimo Marketing Operations, paged and sortable.
list_solution_setsLists the solution sets (licensed solution modules) installed for the current tenant in Aprimo Marketing Operations.
list_supported_versionsLists every API version Aprimo currently supports (version number + documentation URI).
rebuild_search_indexTriggers a rebuild of Aprimo's record/classification search index.
rebuild_unique_key_indexTriggers a rebuild of Aprimo's unique-key index.
search_integration_logsSearches integration logs in Aprimo Marketing Operations with a JSON query body, paged and sortable.
update_counterDestructive. Sets an Aprimo counter's value, by its exact name -- DAM upserts, so a name that doesn't already exist gets created with this value.

fill_fda_form​

Not currently available

Fills the FDA 2253 form from submitted field data in Aprimo Marketing Operations. Read-only despite the POST verb -- filling/generating a form from submitted data is a query/transform operation, no PM resource is created, updated, or deleted as a side effect (same precedent as retrieve_digital_asset_dam_mapping). The request body is a raw, undocumented map of form-field names to arrays-of-arrays of values -- pass it through verbatim as a JSON object; PM declares no typed schema for this data. PM's response has no documented schema either -- the real API almost certainly streams back a filled PDF binary, which this tool cannot surface as text; it reports success and the response's byte length instead.

Parameters:

ParameterTypeRequiredDescription
bodystringYesJSON object mapping form-field names to arrays-of-arrays of values -- opaque, undocumented FDA form-field data (PM wire names). Pass through verbatim.
flattenbooleanNoWhether to flatten the resulting form (bakes filled-in field values into the page content so they can no longer be edited). Default false.

Returns:

FieldTypeDescription
flattenboolean
succeededboolean
responseByteLengthintegerLength, in utf-8 bytes, of the raw response body PM returned. A non-zero value alongside Succeeded=true typically indicates a filled PDF was streamed back.

get_content_security_policy​

Gets the Content Security Policy domain allowlist for this Aprimo DAM location. Tenant-wide singleton -- no parameters.

Parameters: none.

Returns:

FieldTypeDescription
domainsarray of string

get_dam_version_info​

Not currently available

Gets the currently active Aprimo DAM release/version number. Tenant-wide singleton -- no parameters.

Parameters: none.

Returns:

FieldTypeDescription
releaseNumberstring (optional)

get_integration_log​

Returns a single integration log by its integer ID in Aprimo Marketing Operations.

Response format: the response carries a pre-rendered markdown block intended to be displayed verbatim.

Parameters:

ParameterTypeRequiredDescription
idstringYesThe integration log's integer ID.

Returns:

FieldTypeDescription
idstring (optional)
namestring (optional)
rawobject (optional)The complete wire object, verbatim, for full fidelity beyond the defensively-extracted fields above.

get_search_index_status​

Gets the status of Aprimo's record/classification search index: whether a rebuild is required/currently scheduled, indexed record/classification counts, pending changes, and the last rebuild time. Tenant-wide singleton -- no parameters. Use before deciding whether to call rebuild_search_index.

Parameters: none.

Returns:

FieldTypeDescription
rebuildRequiredboolean
rebuildScheduledboolean
indexedRecordsinteger
indexedClassificationsinteger
pendingChangesinteger
lastChangeIdinteger
lastChangeDateTimestring (optional)
lastIndexRebuildstring (optional)

get_supported_version​

Not currently available

Gets detail (documentation URI) for one supported Aprimo API version, by its exact version number. Use after list_supported_versions.

Parameters:

ParameterTypeRequiredDescription
versionstringYesThe API version number to look up, e.g. "1", from list_supported_versions.

Returns:

FieldTypeDescription
versionstring (optional)
documentationUristring (optional)

get_unique_key_index_status​

Gets the status of Aprimo's unique-key index (enforces uniqueness for fields configured as unique keys across records and classifications): processed record/classification counts, whether reindexing is running, whether duplicates were found, and whether a rebuild is required. Tenant-wide singleton -- no parameters. Use before deciding whether to call rebuild_unique_key_index.

Parameters: none.

Returns:

FieldTypeDescription
totalProcessedRecordsinteger
totalProcessedClassificationsinteger
isReindexingboolean
hasDuplicatesboolean
indexBuildRequiredboolean
lastTimeIndexedstring (optional)

list_counters​

Lists every named counter configured in Aprimo (persistent, atomically-incrementing integer sequences typically used to generate unique values, e.g. an invoice number or SKU, for a custom field): name and current value. Use to look up a counter's exact name before calling update_counter.

Parameters: none.

Returns:

FieldTypeDescription
countinteger
itemsarray of CounterPayload
items[].namestring (optional)
items[].valueinteger

list_integration_logs​

Lists integration logs in Aprimo Marketing Operations, paged and sortable.

Response format: the response carries pre-rendered markdown blocks intended to be displayed verbatim.

Parameters:

ParameterTypeRequiredDescription
limitintegerNoMaximum number of results to return (1–50, default 20).
offsetintegerNoNumber of results to skip for pagination (default 0).
sortFieldstringNoOptional field name to sort by. Omit for default ordering.
sortAscendingbooleanNoSort direction. true = ascending (default), false = descending.

Returns:

FieldTypeDescription
collectionNamestring (optional)Resource-name key the wire's _embedded used (e.g. "Activity", "Project"). Informational; may be null when the response isn't HAL-shaped.
totalRecordsintegerTotal record count across all pages — from the wire's _total.
countintegerNumber of items returned in this response (i.e. Items.Count; precomputed for the llm).
offsetintegerThe offset that was used to produce this page (echoes the caller's offset, clamped to ≥0).
hasMorebooleanTrue when there are more results past this page. Tools should prompt the llm to ask the user about fetching the next page.
nextOffsetinteger (optional)Offset to pass on the next request to continue. Null when is false.
itemsarray of IntegrationLogProjectionThe items returned in this response.
items[].idstring (optional)
items[].namestring (optional)
items[].rawobject (optional)The complete wire object, verbatim, for full fidelity beyond the defensively-extracted fields above.

list_solution_sets​

Lists the solution sets (licensed solution modules) installed for the current tenant in Aprimo Marketing Operations.

Response format: the response carries pre-rendered markdown blocks intended to be displayed verbatim.

Parameters: none.

Returns:

FieldTypeDescription
collectionNamestring (optional)Resource-name key the wire's _embedded used (e.g. "Activity", "Project"). Informational; may be null when the response isn't HAL-shaped.
totalRecordsintegerTotal record count across all pages — from the wire's _total.
countintegerNumber of items returned in this response (i.e. Items.Count; precomputed for the llm).
offsetintegerThe offset that was used to produce this page (echoes the caller's offset, clamped to ≥0).
hasMorebooleanTrue when there are more results past this page. Tools should prompt the llm to ask the user about fetching the next page.
nextOffsetinteger (optional)Offset to pass on the next request to continue. Null when is false.
itemsarray of SolutionSetProjectionThe items returned in this response.
items[].idstring (optional)
items[].namestring (optional)
items[].rawobject (optional)The complete wire object, verbatim, for full fidelity beyond the defensively-extracted fields above.

list_supported_versions​

Lists every API version Aprimo currently supports (version number + documentation URI). Use to look up a version's exact number before calling get_supported_version.

Parameters: none.

Returns:

FieldTypeDescription
countinteger
itemsarray of SupportedVersionPayload
items[].versionstring (optional)
items[].documentationUristring (optional)

rebuild_search_index​

Triggers a rebuild of Aprimo's record/classification search index. This modifies data (queues a resource-intensive reindex). Requires confirmed=true after confirming with the user.

Parameters:

ParameterTypeRequiredDescription
rebuildScheduledbooleanNoWhether to schedule the rebuild instead of running it immediately. Required -- DAM has no default for this.
rebuildTargetstringNoWhich resource type to rebuild the index for: "Classification" or "Record". Omit to rebuild DAM's default target.
confirmedbooleanNoMust be true to proceed. Set to false (or omit) to get a confirmation gate error, then call again with confirmed=true after the user has explicitly confirmed.

Returns:

FieldTypeDescription
triggeredboolean
rebuildScheduledboolean (optional)
rebuildTargetstring (optional)

rebuild_unique_key_index​

Triggers a rebuild of Aprimo's unique-key index. This modifies data (queues a resource-intensive reindex). Requires confirmed=true after confirming with the user.

Parameters:

ParameterTypeRequiredDescription
confirmedbooleanNoMust be true to proceed. Set to false (or omit) to get a confirmation gate error, then call again with confirmed=true after the user has explicitly confirmed.

Returns:

FieldTypeDescription
triggeredboolean

search_integration_logs​

Searches integration logs in Aprimo Marketing Operations with a JSON query body, paged and sortable. No resource is created or changed by this call.

Response format: the response carries pre-rendered markdown blocks intended to be displayed verbatim.

Parameters:

ParameterTypeRequiredDescription
querystringYesJSON object with the search query PM expects (PM query DSL). Pass "{}" for an unfiltered search.
limitintegerNoMaximum number of results to return (1–50, default 20).
offsetintegerNoNumber of results to skip for pagination (default 0).
sortFieldstringNoOptional field name to sort by. Omit for default ordering.
sortAscendingbooleanNoSort direction. true = ascending (default), false = descending.

Returns:

FieldTypeDescription
collectionNamestring (optional)Resource-name key the wire's _embedded used (e.g. "Activity", "Project"). Informational; may be null when the response isn't HAL-shaped.
totalRecordsintegerTotal record count across all pages — from the wire's _total.
countintegerNumber of items returned in this response (i.e. Items.Count; precomputed for the llm).
offsetintegerThe offset that was used to produce this page (echoes the caller's offset, clamped to ≥0).
hasMorebooleanTrue when there are more results past this page. Tools should prompt the llm to ask the user about fetching the next page.
nextOffsetinteger (optional)Offset to pass on the next request to continue. Null when is false.
itemsarray of IntegrationLogProjectionThe items returned in this response.
items[].idstring (optional)
items[].namestring (optional)
items[].rawobject (optional)The complete wire object, verbatim, for full fidelity beyond the defensively-extracted fields above.

update_counter​

Destructive

Sets an Aprimo counter's value, by its exact name -- DAM upserts, so a name that doesn't already exist gets created with this value. This modifies data and there is no way to delete a counter afterward. Requires both confirmed=true and confirmedDestructive=true, after explicitly confirming the exact counter name and new value with the user.

Parameters:

ParameterTypeRequiredDescription
counterNamestringYesThe counter's exact name, from list_counters.
valueintegerYesThe new value for the counter.
confirmedbooleanNoMust be true to proceed. Set to false (or omit) to get a confirmation gate error, then call again with confirmed=true after the user has explicitly confirmed the exact counter name and value.
confirmedDestructivebooleanNoMust also be true (in addition to confirmed) -- this can create a brand-new counter with no way to delete it afterward, and overwriting an existing one's value cannot be undone. Set only after stating the exact counter name and value to the user and getting explicit go-ahead.

Returns:

FieldTypeDescription
namestring
valueinteger
Destructive operation

This tool deletes or irreversibly overwrites data in the live tenant; the change cannot be rolled back through the API. It will not act unless the call sets both confirmed and confirmedDestructive to true.