The MergeTags API from Knak — 2 operation(s) for mergetags.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/knak-mergetags-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Knak Enterprise Merge Tags API
version: V1
x-logo:
url: https://s3.amazonaws.com/assets.knak.io/img/Knak-Logo-Medium.png
contact:
email: support@knak.com
description: '# Overview
Welcome to the developer documentation for the Knak Enterprise API.'
servers:
- url: https://enterprise.knak.io/api/published/v1
description: production
tags:
- name: MergeTags
paths:
/merge-tags:
get:
description: Retrieve all merge tags for your company.
summary: List all merge tags
parameters:
- name: page
in: query
required: false
description: Page number
example: 1
schema:
type: integer
- name: per_page
in: query
required: false
description: Number of items per page
example: 10
schema:
type: integer
- name: filter[name]
in: query
description: Filter by name. Exact match filter.
required: false
example: City
schema:
type: string
- name: filter[platform_id]
in: query
description: Filter by platform ID. Exact match filter.
required: false
example: marketo
schema:
type: string
tags:
- MergeTags
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/MergeTagList'
'401':
description: Unauthenticated
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Unauthenticated.
detail: Authenticate before continuing.
'403':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Forbidden.
detail: This user is not authorized to perform this action. Please adjust permissions before continuing.
operationId: getMergeTags
x-operation-id-source: derived
post:
description: Create a merge tag. Requires permission to manage merge tags.
summary: Create a merge tag
tags:
- MergeTags
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- platform_id
- merge_tag_value
properties:
name:
type: string
example: Lead First Name
platform_id:
type: string
example: marketo
merge_tag_value:
type: string
example: '{{lead.firstName}}'
description:
type: string
example: The first name of the lead in Marketo
is_special_link:
type: boolean
example: false
velocity_script_token:
type: string
example: ${lead.firstName}
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/MergeTag'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Validation error for name.
detail: The name field is required.
'401':
description: Unauthenticated
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Unauthenticated.
detail: Authenticate before continuing.
'403':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Forbidden.
detail: This user is not authorized to perform this action. Please adjust permissions before continuing.
operationId: postMergeTags
x-operation-id-source: derived
/merge-tags/{merge_tag_id}:
get:
description: Retrieve a specific merge tag via their ID.
summary: Retrieve a merge tag
parameters:
- in: path
required: true
name: id
description: ID of merge tag to get
example: 609d7ce223411
schema:
type: string
tags:
- MergeTags
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/MergeTag'
'401':
description: Unauthenticated
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Unauthenticated.
detail: Authenticate before continuing.
'403':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Forbidden.
detail: This user is not authorized to perform this action. Please adjust permissions before continuing.
operationId: getMergeTagsByMergeTagId
x-operation-id-source: derived
patch:
description: Update a specific merge tag via their ID (if user has manage merge tags permission). This endpoint allows partial updates - only the fields provided in the request body will be updated.
summary: Update a merge tag
parameters:
- in: path
required: true
name: id
description: ID of merge tag to update
example: 609d7ce223411
schema:
type: string
requestBody:
description: Merge tag update data
content:
application/json:
schema:
type: object
properties:
description:
type: string
description: The description of the merge tag
example: Updated description for the merge tag
merge_tag_value:
type: string
description: The merge tag value/mapped name
example: '{{lead.UpdatedField}}'
velocity_script_token:
type: string
description: The velocity script token
example: ${lead.UpdatedField}
is_special_link:
type: boolean
description: Whether the merge tag is a special link (only applicable for Marketo platform).
example: false
tags:
- MergeTags
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/MergeTag'
'401':
description: Unauthenticated
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Unauthenticated.
detail: Authenticate before continuing.
'403':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Forbidden.
detail: This user is not authorized to perform this action. Please adjust permissions before continuing.
operationId: patchMergeTagsByMergeTagId
x-operation-id-source: derived
delete:
description: Delete a merge tag via their ID (if user has manage merge tags permission).
summary: Delete a merge tag
parameters:
- in: path
required: true
name: id
description: ID of merge tag to delete
example: 609d7ce223411
schema:
type: string
tags:
- MergeTags
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
example:
message: Merge Tag deleted.
'401':
description: Unauthenticated
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Unauthenticated.
detail: Authenticate before continuing.
'403':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- title: Forbidden.
detail: This user is not authorized to perform this action. Please adjust permissions before continuing.
operationId: deleteMergeTagsByMergeTagId
x-operation-id-source: derived
components:
schemas:
MergeTagList:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/MergeTag'
links:
type: object
properties:
first:
type: string
example: https://enterprise.knak.io/api/published/v1/merge-tags?page=1
last:
type: string
example: https://enterprise.knak.io/api/published/v1/merge-tags?page=3
prev:
type: string
nullable: true
example: https://enterprise.knak.io/api/published/v1/merge-tags?page=1
next:
type: string
nullable: true
example: https://enterprise.knak.io/api/published/v1/merge-tags?page=3
meta:
type: object
properties:
current_page:
type: integer
example: 2
from:
type: integer
example: 1
last_page:
type: integer
example: 3
links:
type: array
items:
type: object
properties:
url:
type: string
nullable: true
example: https://enterprise.knak.io/api/published/v1/merge-tags?page=2
label:
type: string
example: Next
active:
type: boolean
example: true
path:
type: string
example: https://enterprise.knak.io/api/published/v1/merge-tags?page=2
per_page:
type: integer
example: 10
to:
type: integer
example: 3
total:
type: integer
example: 3
MergeTagAttributes:
type: object
properties:
id:
type: string
example: 609d7ce223411
name:
type: string
example: City
description:
type: string
example: The target city of the marketing campaign
is_special_link:
type: boolean
example: false
platform_id:
type: string
example: marketo
merge_tag_value:
type: string
example: '{{lead.City}}'
velocity_script_token:
type:
- 'null'
- string
example: ${lead.City}
knak_tag:
type: string
description: A paste-ready merge-tag token you can embed directly in asset content. Knak resolves it to the correct platform merge tag when the asset is synced. See the [Merge Tag Model](#tag/merge_tag) for the content syntax.
example: '{{!City.knakTagId:609d7ce223411!}}'
MergeTag:
type: object
properties:
type:
type: string
example: merge-tag
id:
type: string
example: 609d7ce223411
attributes:
$ref: '#/components/schemas/MergeTagAttributes'
Error:
type: object
properties:
errors:
type: array
items:
type: object
properties:
status:
type: string
description: HTTP status code as a string. Returned by endpoints that use the JSON:API error shape.
example: '409'
title:
type: string
detail:
type: string
meta:
type: object
description: Additional context for the error. Returned by endpoints that use the JSON:API error shape.
additionalProperties: true
Response:
type: object
properties:
message:
type: string
example: This is the response message to the request made.
x-tagGroups:
- name: User Management
tags:
- Users
- name: Assets
tags:
- Assets
- Project Management
- name: Themes
tags:
- Themes
- name: Modules
tags:
- Modules
- name: Brands
tags:
- Brands
- name: Asset Folders
tags:
- AssetFolders
- name: Assets Custom Fieldsets
tags:
- Asset Custom Fieldsets
- name: Available Platforms
tags:
- AvailablePlatforms
- name: Merge Tags
tags:
- MergeTags
- name: Integrations
tags:
- Integrations
- name: Sync
tags:
- SyncStatuses
- MarketingPlatformSyncs
- name: Translation Requests
tags:
- TranslationRequests
- name: Events
tags:
- asset.created
- asset.sync_requested
- asset.sync_confirmation_responded
- asset.approval_status_updated
- asset.translation_requested
- translation_request.created
- name: Models
tags:
- user_model
- asset_model
- theme_model
- module_model
- brand_model
- asset_folder_model
- asset_custom_fieldset
- available_platform
- merge_tag
- sync_status
- integration
- marketing_platform_sync
- translation_request
- project_management_link