# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Mapp Engage public Meta API version: 1.0.0 extends: openapi/mapp-meta-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 13 - target: $.paths['/meta/activateAttributeDefinitions'].post update: x-apievangelist-phrasing: intent: Reactivate archived custom attributes effect: write questions: - How do I bring an archived custom attribute back so it shows in the personalization builder? - Can archived attributes be reactivated by name? instructions: - text: Reactivate the archived custom attribute named loyaltyTier. - text: Restore these archived attributes so they can be used in personalization. method: generated generated: '2026-09-26' - target: $.paths['/meta/archiveAttributeDefinitions'].post update: x-apievangelist-phrasing: intent: Archive custom attributes effect: write questions: - Can I hide a custom attribute from message creation without deleting its data? - Do archived attributes still work in existing messages and sendouts? instructions: - text: Archive the custom attribute named legacyScore. - text: Archive these custom user attributes so editors stop using them. method: generated generated: '2026-09-26' - target: $.paths['/meta/attachTags'].post update: x-apievangelist-phrasing: intent: Attach tags to an entity effect: write questions: - How do I tag a message or other entity in Mapp Engage? - Can I add several tags to one entity at once? instructions: - text: Attach tags to {entityType} {entityId}. slots: entityType: query.entityType entityId: query.entityId - text: Tag {entityType} {entityId} with spring-campaign. slots: entityType: query.entityType entityId: query.entityId method: generated generated: '2026-09-26' - target: $.paths['/meta/createAttributeDefinitions'].post update: x-apievangelist-phrasing: intent: Create custom user attributes effect: write questions: - How do I add a new custom data field to store information about users? - Is there a limit on how many custom attributes I can create? instructions: - text: Create a custom user attribute called favoriteStore of type string. - text: Define new custom attributes for storing profile data. method: generated generated: '2026-09-26' - target: $.paths['/meta/createLinkCategories'].post update: x-apievangelist-phrasing: intent: Create link categories effect: write questions: - Can I group links for reporting by matching them with a regex pattern? - Which call sets up new link categories that can trigger automations on click? instructions: - text: Create a link category Promotions matching links containing /promo/. - text: Add new link categories with their regex patterns. method: generated generated: '2026-09-26' - target: $.paths['/meta/deleteLinkCategory'].post update: x-apievangelist-phrasing: intent: Delete a link category effect: destructive questions: - How do I remove a link category I no longer need? - Can a link category be deleted once created? instructions: - text: Delete the Promotions link category. - text: Remove this link category from the system. method: generated generated: '2026-09-26' - target: $.paths['/meta/detachTags'].post update: x-apievangelist-phrasing: intent: Remove tags from an entity effect: write questions: - Can I take specific tags off an entity without touching the others? - Which call untags a message? instructions: - text: Detach tags {tags} from {entityType} {entityId}. slots: tags: query.tags entityType: query.entityType entityId: query.entityId - text: Remove the spring-campaign tag from {entityType} {entityId}. slots: entityType: query.entityType entityId: query.entityId method: generated generated: '2026-09-26' - target: $.paths['/meta/findByTags'].post update: x-apievangelist-phrasing: intent: Find entities by tag effect: read questions: - Which entities carry a given tag? - Can I filter tagged items by entity type? instructions: - text: Find all {entityType} entities tagged {tags}. slots: entityType: query.entityType tags: query.tags - text: Search for anything tagged {tags}. slots: tags: query.tags method: generated generated: '2026-09-26' - target: $.paths['/meta/getAttributeDefinitions'].get update: x-apievangelist-phrasing: intent: List active custom user attributes effect: read questions: - What custom attributes are currently active for users? - Does the attribute definition list include archived or system attributes? instructions: - text: List all active custom user attributes. - text: Show me the custom attribute definitions in use. method: generated generated: '2026-09-26' - target: $.paths['/meta/getLinkCategories'].get update: x-apievangelist-phrasing: intent: List link categories effect: read questions: - What link categories are set up for click reporting? - Can I see the patterns behind each link category? instructions: - text: List all link categories. - text: Show the link categories and their patterns. method: generated generated: '2026-09-26' - target: $.paths['/meta/getTags'].get update: x-apievangelist-phrasing: intent: List tags on an entity effect: read questions: - What tags are attached to a particular message? - Where can I see every tag on an entity? instructions: - text: Get the tags on {entityType} {entityId}. slots: entityType: query.entityType entityId: query.entityId - text: Show which tags entity {entityId} has. slots: entityId: query.entityId method: generated generated: '2026-09-26' - target: $.paths['/meta/mergeAttributeDefinitions'].post update: x-apievangelist-phrasing: intent: Sync the full custom attribute list effect: write questions: - Can I archive, activate and create custom attributes in one full-list update? - What happens to custom attributes I leave out of a merge? instructions: - text: Merge this complete custom attribute list, deactivating any attribute not included. - text: Sync all custom attribute definitions to match my list. method: generated generated: '2026-09-26' - target: $.paths['/meta/updateLinkCategory'].post update: x-apievangelist-phrasing: intent: Update a link category effect: write questions: - Can I change the name or regex pattern of an existing link category? - Which call edits a link category after it's created? instructions: - text: Update the Promotions link category to match /offers/ instead. - text: Change the pattern on this existing link category. method: generated generated: '2026-09-26'