> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Restore an archived coupon list
> Marks the list as active again, retaining its metadata and stored coupon codes.
## OpenAPI
````json POST /couponList/restore
{
"openapi": "3.0.4",
"info": {
"title": "Engage public API",
"version": "1"
},
"servers": [
{
"url": "https://your-engage-domain.com/api/rest"
}
],
"tags": [
{
"name": "Address Attributes"
},
{
"name": "Async"
},
{
"name": "Audit Log"
},
{
"name": "Automation"
},
{
"name": "Blacklist"
},
{
"name": "CMS (legacy)"
},
{
"name": "CMS Blocks"
},
{
"name": "CMS Frameworks"
},
{
"name": "CMS Messages"
},
{
"name": "CMS Templates"
},
{
"name": "Contact"
},
{
"name": "Content"
},
{
"name": "Coupon"
},
{
"name": "Draft Message"
},
{
"name": "Ecommerce"
},
{
"name": "Group"
},
{
"name": "Group Attributes"
},
{
"name": "Landing Page"
},
{
"name": "Member Attributes"
},
{
"name": "Membership"
},
{
"name": "Message"
},
{
"name": "Meta"
},
{
"name": "Mobile Push"
},
{
"name": "Prepared Message"
},
{
"name": "Process"
},
{
"name": "Profile Attributes"
},
{
"name": "Related Data"
},
{
"name": "Segmentation"
},
{
"name": "System"
},
{
"name": "System User"
},
{
"name": "Usage Statistics"
},
{
"name": "User"
},
{
"name": "Whiteboard"
}
],
"paths": {
"/couponList/restore": {
"post": {
"tags": [
"Coupon"
],
"summary": "Restore an archived coupon list",
"description": "Marks the list as active again, retaining its metadata and stored coupon codes.",
"operationId": "restore",
"parameters": [
{
"name": "couponListName",
"in": "query",
"description": "List name in the authenticated customer; case-insensitive.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Coupon list restored successfully; no response body.",
"content": {
"application/json": {}
}
},
"400": {
"description": "InvalidParameterException / MISSING_PARAMETER: couponListName is omitted; INVALID_PARAMETER: name length must be 3-50 characters.
NoSuchObjectException / NO_SUCH_OBJECT: no list with this name exists in the authenticated customer.
UnexpectedErrorException / PERMISSION_DENIED: caller lacks edit access or the restore action denies permission.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceExceptionBean"
}
}
}
},
"500": {
"description": "UnexpectedErrorException / UNEXPECTED_ERROR: a backend operation failed; errorActor is SERVER.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceExceptionBean"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"ServiceExceptionBean": {
"type": "object",
"properties": {
"errorActor": {
"type": "string"
},
"errorCode": {
"type": "string"
},
"message": {
"type": "string"
}
},
"xml": {
"name": "ServiceException"
}
}
}
}
}
````