For Agents
Shorten URLs and manage custom domains with Kutt: create short links, update or delete them, retrieve per-link click stats, and add custom domains.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Kutt API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Kutt API.
Create short links via POST /links with optional custom alias, password, and expiration date
Retrieve per-link click and referrer statistics through GET /links/{id}/stats
Update an existing short link's destination or settings via PATCH /links/{id}
GET STARTED
Use for: I need to create a short link for a marketing URL, I want to retrieve click statistics for one of my Kutt links, List all my short links, Delete a short link I no longer need
Not supported: Does not handle DNS hosting, SEO redirects at scale, or affiliate link tracking — use for URL shortening and basic click analytics only.
Jentic publishes the only available OpenAPI specification for Kutt API, keeping it validated and agent-ready. Kutt is an open-source URL shortener with custom domain support and built-in analytics. The v2 API exposes link creation, listing, updating, and deletion, per-link statistics, and custom domain management. Authentication is an X-API-Key header issued from the Kutt account dashboard, and the service can be self-hosted under MIT licence.
Permanently remove a short link with DELETE /links/{id}
Add a custom domain via POST /domains so links resolve under a branded host
List and paginate through all the user's links via GET /links
Patterns agents use Kutt API for, with concrete tasks.
★ Branded Short Links for Campaigns
Create branded short links for outbound marketing or social posts. POST /domains adds a custom domain to the account and POST /links creates a link under that domain. Per-link statistics from /links/{id}/stats feed back into the campaign analytics so each link's performance is attributable.
POST /domains for the custom host, then POST /links with the campaign destination URL and the custom domain so the resulting short link uses the brand host.
Self-Hosted Privacy-First Shortening
Run Kutt on private infrastructure to keep click data inside the company perimeter. Because Kutt is MIT-licensed and self-hostable, the same v2 API surface can be pointed at an internal base URL. Agents create and manage links the same way as on kutt.it, just against the internal host.
Configure the agent's Kutt API client against the internal base URL and POST /links for an internal documentation URL.
Click Analytics Pipeline
Pull click statistics for each tracked link into a BI warehouse. GET /links/{id}/stats returns per-link counters, which can be polled on a schedule and loaded as fact rows for a dashboard. Combined with /links pagination, the same job can refresh every active link in the workspace.
GET /links to enumerate active links, then GET /links/{id}/stats for each one and emit click counts as rows into the warehouse.
AI Agent Link-Sharing Helper
An assistant in a chat client shortens any long URL the user pastes and applies brand-consistent settings (password, expiration) drawn from policy. Through Jentic, the assistant calls Kutt by intent, with the X-API-Key never leaving the vault.
On a long URL paste, search Jentic for 'create a Kutt short link' and POST /links with the brand domain and 30-day expiration.
8 endpoints — jentic publishes the only available openapi specification for kutt api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/links
Create a short link
/links
List all short links
/links/{id}/stats
Get click statistics for a link
/links/{id}
Update an existing short link
/links/{id}
Delete a short link
/domains
Add a custom domain
/links
Create a short link
/links
List all short links
/links/{id}/stats
Get click statistics for a link
/links/{id}
Update an existing short link
/links/{id}
Delete a short link
Three things that make agents converge on Jentic-routed access.
Credential isolation
Kutt X-API-Key values are stored encrypted in the Jentic MAXsystem vault. The header is injected at execution time so the agent runtime never holds the raw key.
Intent-based discovery
Agents search by intent (e.g. 'shorten a URL' or 'get link click stats') and Jentic returns the matching Kutt operation with its input schema.
Time to first call
Direct integration: a few hours to wire up auth and the link CRUD model. Through Jentic: under 15 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Kutt API through Jentic.
Why is there no official OpenAPI spec for Kutt API?
Kutt does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Kutt API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Kutt API use?
Kutt API uses an API key passed in the X-API-Key header, generated from the Kutt account settings page. Through Jentic, the key is stored encrypted in the MAXsystem vault and injected at execution time.
Can I create a password-protected short link with the Kutt API?
Yes. POST /links accepts an optional password field; visitors are prompted for it before being redirected to the destination. The same endpoint accepts a custom alias and an expiration timestamp.
How do I get click statistics for a short link through Jentic?
Search Jentic for 'get Kutt link statistics'. Jentic returns GET /links/{id}/stats with its schema. Provide the link ID and Jentic executes the call using your stored API key.
Is Kutt free to use?
Yes. Kutt is an open-source project released under the MIT licence. The hosted service at kutt.it is free; you can also self-host the same v2 API stack on your own infrastructure with no licence cost.
Can I use a custom domain for my short links?
Yes. POST /domains adds a custom domain to your Kutt account, and DELETE /domains/{id} removes it. Once a domain is added, POST /links can issue short links on that host instead of kutt.it.
/domains
Add a custom domain