# Polish, optimize to 160 characters & localize SMS copy
URL: /docs/api-reference/ai-copy-assistant/polishSmsCopy

## POST `/api/v1/public/ai-copy/polish`

**Summary:** Polish, optimize to 160 characters & localize SMS copy
**Operation ID:** `polishSmsCopy`

Uses AI to trim marketing or transactional copy down to fit within a single 160-character GSM-7 segment, optimize tone, or localize into African languages.

**Authentication:** `X-Api-Key: sk_live_...` or `Authorization: Bearer sk_live_...`

### Request Body (`application/json`)

```json
{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "example": "Hello our esteemed customer, we are pleased to inform you that our annual clearance mega sale has begun today with up to 50% discount on all items."
    },
    "mode": {
      "type": "string",
      "enum": [
        "FIT_TO_160",
        "URGENT_MARKETING",
        "PROFESSIONAL_FORMAL",
        "WARM_CELEBRATORY",
        "LOCALIZE_PIDGIN",
        "LOCALIZE_FRENCH",
        "LOCALIZE_TWI",
        "LOCALIZE_YORUBA",
        "GSM7_CLEANSE"
      ],
      "default": "FIT_TO_160"
    }
  }
}
```

### Responses

- **`200`**: Polished text with character count and savings

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "example": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "polishedText": {
          "type": "string",
          "example": "Mega Sale is live! Enjoy up to 50% off all items today only. Shop now: bit.ly/sale26"
        },
        "originalLength": {
          "type": "integer",
          "example": 164
        },
        "polishedLength": {
          "type": "integer",
          "example": 83
        },
        "segments": {
          "type": "integer",
          "example": 1
        }
      }
    }
  }
}
```
- **`401`**: Authentication failed or API key missing