> ## 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.

# tinyurl

> TinyURL API

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

## Tools

| Tool                                                              | Description                    |
| ----------------------------------------------------------------- | ------------------------------ |
| [`tinyurl_archive_tiny_url`](#tinyurl_archive_tiny_url)           | Archive or unarchive a TinyURL |
| [`tinyurl_bulk_create_tiny_urls`](#tinyurl_bulk_create_tiny_urls) | Bulk create TinyURLs           |
| [`tinyurl_change_destination`](#tinyurl_change_destination)       | Change destination URL         |
| [`tinyurl_create_tiny_url`](#tinyurl_create_tiny_url)             | Create a new TinyURL           |
| [`tinyurl_delete_tiny_url`](#tinyurl_delete_tiny_url)             | Delete a TinyURL               |
| [`tinyurl_list_archived_urls`](#tinyurl_list_archived_urls)       | List archived TinyURLs         |
| [`tinyurl_list_urls`](#tinyurl_list_urls)                         | List all TinyURLs              |
| [`tinyurl_update_tiny_url`](#tinyurl_update_tiny_url)             | Update a TinyURL               |

***

## tinyurl\_archive\_tiny\_url

Archive or unarchive a TinyURL

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                    |
| ------------- | ------- | -------- | ------- | ---------------------------------------------- |
| `alias`       | string  | Yes      | —       | The alias of the TinyURL to archive/unarchive  |
| `domain`      | string  | Yes      | —       | The domain of the TinyURL to archive/unarchive |
| `is_archived` | boolean | No       | —       | Set to true to archive, false to unarchive     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "alias": {
        "type": "string",
        "description": "The alias of the TinyURL to archive/unarchive"
      },
      "domain": {
        "type": "string",
        "description": "The domain of the TinyURL to archive/unarchive"
      },
      "is_archived": {
        "type": "boolean",
        "description": "Set to true to archive, false to unarchive"
      }
    },
    "required": [
      "PCID",
      "alias",
      "domain"
    ]
  }
  ```
</Expandable>

***

## tinyurl\_bulk\_create\_tiny\_urls

Bulk create TinyURLs

**Parameters:**

| Parameter | Type      | Required | Default | Description                     |
| --------- | --------- | -------- | ------- | ------------------------------- |
| `urls`    | object\[] | Yes      | —       | Array of URL objects to shorten |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "urls": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "description": "The long URL to shorten"
            },
            "domain": {
              "type": "string",
              "description": "Custom domain to use"
            },
            "alias": {
              "type": "string",
              "description": "Custom alias for the short URL"
            },
            "tags": {
              "type": "string",
              "description": "Comma-separated tags"
            }
          },
          "required": [
            "url"
          ]
        },
        "description": "Array of URL objects to shorten"
      }
    },
    "required": [
      "PCID",
      "urls"
    ]
  }
  ```
</Expandable>

***

## tinyurl\_change\_destination

Change destination URL

**Parameters:**

| Parameter | Type   | Required | Default | Description                         |
| --------- | ------ | -------- | ------- | ----------------------------------- |
| `alias`   | string | Yes      | —       | The alias of the TinyURL to change  |
| `domain`  | string | Yes      | —       | The domain of the TinyURL to change |
| `url`     | string | Yes      | —       | The new destination URL             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "alias": {
        "type": "string",
        "description": "The alias of the TinyURL to change"
      },
      "domain": {
        "type": "string",
        "description": "The domain of the TinyURL to change"
      },
      "url": {
        "type": "string",
        "description": "The new destination URL"
      }
    },
    "required": [
      "PCID",
      "alias",
      "domain",
      "url"
    ]
  }
  ```
</Expandable>

***

## tinyurl\_create\_tiny\_url

Create a new TinyURL

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                                                          |
| ------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------ |
| `alias`       | string | No       | —       | Custom alias for the short URL (e.g., 'my-link' creates tinyurl.com/my-link)         |
| `description` | string | No       | —       | Description or note for the URL                                                      |
| `domain`      | string | No       | —       | Custom domain to use (e.g., tinyurl.com, roturl.com). Defaults to tinyurl.com        |
| `expires_at`  | string | No       | —       | Expiration date in ISO 8601 format (e.g., 2025-12-31T23:59:59Z). Requires paid plan. |
| `tags`        | string | No       | —       | Comma-separated tags for organizing the URL                                          |
| `url`         | string | Yes      | —       | The long URL to shorten                                                              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "alias": {
        "type": "string",
        "description": "Custom alias for the short URL (e.g., 'my-link' creates tinyurl.com/my-link)"
      },
      "description": {
        "type": "string",
        "description": "Description or note for the URL"
      },
      "domain": {
        "type": "string",
        "description": "Custom domain to use (e.g., tinyurl.com, roturl.com). Defaults to tinyurl.com"
      },
      "expires_at": {
        "type": "string",
        "description": "Expiration date in ISO 8601 format (e.g., 2025-12-31T23:59:59Z). Requires paid plan."
      },
      "tags": {
        "type": "string",
        "description": "Comma-separated tags for organizing the URL"
      },
      "url": {
        "type": "string",
        "description": "The long URL to shorten"
      }
    },
    "required": [
      "PCID",
      "url"
    ]
  }
  ```
</Expandable>

***

## tinyurl\_delete\_tiny\_url

Delete a TinyURL

**Parameters:**

| Parameter | Type   | Required | Default | Description                         |
| --------- | ------ | -------- | ------- | ----------------------------------- |
| `alias`   | string | Yes      | —       | The alias of the TinyURL to delete  |
| `domain`  | string | Yes      | —       | The domain of the TinyURL to delete |

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

***

## tinyurl\_list\_archived\_urls

List archived TinyURLs

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

***

## tinyurl\_list\_urls

List all TinyURLs

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

***

## tinyurl\_update\_tiny\_url

Update a TinyURL

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                |
| ------------- | ------ | -------- | ------- | ------------------------------------------ |
| `alias`       | string | Yes      | —       | The current alias of the TinyURL to update |
| `description` | string | No       | —       | Updated description                        |
| `domain`      | string | Yes      | —       | The domain of the TinyURL to update        |
| `new_alias`   | string | No       | —       | New alias to assign                        |
| `tags`        | string | No       | —       | Updated comma-separated tags               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "alias": {
        "type": "string",
        "description": "The current alias of the TinyURL to update"
      },
      "description": {
        "type": "string",
        "description": "Updated description"
      },
      "domain": {
        "type": "string",
        "description": "The domain of the TinyURL to update"
      },
      "new_alias": {
        "type": "string",
        "description": "New alias to assign"
      },
      "tags": {
        "type": "string",
        "description": "Updated comma-separated tags"
      }
    },
    "required": [
      "PCID",
      "alias",
      "domain"
    ]
  }
  ```
</Expandable>