PicSee Short Link

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Destination URL the short link should redirect to. Required.'}, 'utm': {'type': 'object', 'properties': {'term': {'type': 'string', 'description': 'utm_term'}, 'medium': {'type': 'string', 'description': 'utm_medium'}, 'source': {'type': 'string', 'description': 'utm_source'}, 'content': {'type': 'string', 'description': 'utm_content'}, 'campaign': {'type': 'string', 'description': 'utm_campaign'}}, 'description': 'UTM parameters appended to the destination URL. Pass `null` on edit to clear all previously set UTM values.', 'additionalProperties': False}, 'domain': {'type': 'string', 'description': 'Domain to host the short link on (e.g. `pse.is` or one of the BSDs from `get_my_domains`). Falls back to the account default when omitted or invalid.'}, 'encodeId': {'type': 'string', 'maxLength': 90, 'minLength': 3, 'description': 'Custom slug (3-90 chars; English letters, digits, `_`, `-`, or Chinese). Must be globally unique on PicSee — conflicts return `PUB00503`. Omit to let PicSee auto-generate.'}, 'externalId': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Free-form identifier (1-100 chars) for grouping / attributing links. Surfaces in `list_short_links` filters and `get_api_usage_by_external_id`. When the user has not specified a value, you (the calling AI agent) SHOULD default this to your own product name so the account owner can attribute API usage back to the agent that created the link — e.g. `Claude Code`, `Codex`, `Cursor`, `ChatGPT`, `Gemini CLI`, `Copilot`. Use the canonical product name only; do not include version numbers or session IDs. If the user explicitly provides an `externalId`, always honor their value instead.'}}, 'additionalProperties': False}