> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# cuttly

> URL Shortener API

**Server path:** `/cuttly` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                              | Description                             |
| ------------------------------------------------- | --------------------------------------- |
| [`cuttly_delete_link`](#cuttly_delete_link)       | Delete a shortened link                 |
| [`cuttly_edit_link`](#cuttly_edit_link)           | Edit a shortened link                   |
| [`cuttly_get_link_stats`](#cuttly_get_link_stats) | Get link analytics and click statistics |
| [`cuttly_shorten_url`](#cuttly_shorten_url)       | Shorten a URL                           |

***

## cuttly\_delete\_link

Delete a shortened link

**Parameters:**

| Parameter | Type   | Required | Default | Description                              |
| --------- | ------ | -------- | ------- | ---------------------------------------- |
| `delete`  | string | Yes      | —       | The shortened URL to permanently delete. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "delete": {
        "type": "string",
        "description": "The shortened URL to permanently delete."
      }
    },
    "required": [
      "PCID",
      "delete"
    ]
  }
  ```
</Expandable>

***

## cuttly\_edit\_link

Edit a shortened link

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                                         |
| ---------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------- |
| `edit`           | string  | Yes      | —       | The shortened URL to edit.                                                                          |
| `name`           | string  | No       | —       | New custom alias for the link.                                                                      |
| `source`         | string  | No       | —       | New destination URL to redirect to.                                                                 |
| `title`          | string  | No       | —       | Custom title for the link.                                                                          |
| `tag`            | string  | No       | —       | Tag label to add to the link for organization.                                                      |
| `unique`         | string  | No       | —       | Unique click counting. 0=off, 1=on, 15-1440=time window in minutes for deduplication.               |
| `expire`         | integer | No       | —       | Expiration type. 0=expire by click count, 1=expire by date.                                         |
| `expireCond`     | string  | No       | —       | Expiration condition: a click count (when expire=0) or a date in YYYY-MM-DD format (when expire=1). |
| `expireRedirect` | string  | No       | —       | URL to redirect to after the link expires.                                                          |
| `password`       | string  | No       | —       | Password to protect the link. Visitors must enter this password to access the destination.          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "edit": {
        "type": "string",
        "description": "The shortened URL to edit."
      },
      "name": {
        "type": "string",
        "description": "New custom alias for the link."
      },
      "source": {
        "type": "string",
        "description": "New destination URL to redirect to."
      },
      "title": {
        "type": "string",
        "description": "Custom title for the link."
      },
      "tag": {
        "type": "string",
        "description": "Tag label to add to the link for organization."
      },
      "unique": {
        "type": "string",
        "description": "Unique click counting. 0=off, 1=on, 15-1440=time window in minutes for deduplication."
      },
      "expire": {
        "type": "integer",
        "description": "Expiration type. 0=expire by click count, 1=expire by date."
      },
      "expireCond": {
        "type": "string",
        "description": "Expiration condition: a click count (when expire=0) or a date in YYYY-MM-DD format (when expire=1)."
      },
      "expireRedirect": {
        "type": "string",
        "description": "URL to redirect to after the link expires."
      },
      "password": {
        "type": "string",
        "description": "Password to protect the link. Visitors must enter this password to access the destination."
      }
    },
    "required": [
      "PCID",
      "edit"
    ]
  }
  ```
</Expandable>

***

## cuttly\_get\_link\_stats

Get link analytics and click statistics

**Parameters:**

| Parameter   | Type   | Required | Default | Description                                                                 |
| ----------- | ------ | -------- | ------- | --------------------------------------------------------------------------- |
| `stats`     | string | Yes      | —       | The shortened URL to get statistics for.                                    |
| `date_from` | string | No       | —       | Start date for statistics period in YYYY-MM-DD format. Requires Team+ plan. |
| `date_to`   | string | No       | —       | End date for statistics period in YYYY-MM-DD format. Requires Team+ plan.   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "stats": {
        "type": "string",
        "description": "The shortened URL to get statistics for."
      },
      "date_from": {
        "type": "string",
        "description": "Start date for statistics period in YYYY-MM-DD format. Requires Team+ plan."
      },
      "date_to": {
        "type": "string",
        "description": "End date for statistics period in YYYY-MM-DD format. Requires Team+ plan."
      }
    },
    "required": [
      "PCID",
      "stats"
    ]
  }
  ```
</Expandable>

***

## cuttly\_shorten\_url

Shorten a URL

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                                      |
| ------------ | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------ |
| `short`      | string  | Yes      | —       | The URL to shorten. Must be a valid URL.                                                         |
| `name`       | string  | No       | —       | Custom alias (back-half) for the shortened URL. If the alias is already taken, returns status 3. |
| `userDomain` | integer | No       | —       | Set to 1 to use your branded/custom domain instead of cutt.ly.                                   |
| `public`     | integer | No       | —       | Set to 1 to make click statistics publicly visible. Requires Single+ plan.                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "short": {
        "type": "string",
        "description": "The URL to shorten. Must be a valid URL."
      },
      "name": {
        "type": "string",
        "description": "Custom alias (back-half) for the shortened URL. If the alias is already taken, returns status 3."
      },
      "userDomain": {
        "type": "integer",
        "description": "Set to 1 to use your branded/custom domain instead of cutt.ly."
      },
      "public": {
        "type": "integer",
        "description": "Set to 1 to make click statistics publicly visible. Requires Single+ plan."
      }
    },
    "required": [
      "PCID",
      "short"
    ]
  }
  ```
</Expandable>