Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
getList ShortlinksgetGet ShortlinkpostCreate ShortlinkputUpdate ShortlinkdelDelete ShortlinkgetGet Shortlink ClicksgetGet Shortlink Clicks CountgetGet Top Shortlinks
Shortlinks

Update Shortlink

Updates a short link's destination, domain, or path. Omitted fields stay as they are. A new domain has to be verified and have short links turned on.

PUT
/projects/{projectId}/shortlinks/{shortlinkId}

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project that owns the short link.

shortlinkIdrequiredstring

ID of the short link to update.

Request Body

application/json

changesrequiredobject

Fields to change. Omitted fields stay as they are.

domainIdstring

ID of the domain that hosts the short link.

shortLinkDomainstring

Hostname of the short link, for example go.example.com.

shortLinkPathstring

Path on that hostname, without a leading slash.

destinationURLstring

URL visitors are sent to. Omit to leave unchanged.

Format: uri

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://www.saasco.com/api/v2/projects/string/shortlinks/string" \  -H "Content-Type: application/json" \  -d '{    "changes": {}  }'
{
  "id": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "destinationURL": "http://example.com",
  "shortLinkDomain": "string",
  "shortLinkPath": "string",
  "projectId": "string",
  "domainId": "string"
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Create Shortlink

Creates a short link on a domain that already belongs to the project. The domain has to be verified and have short links turned on.

Delete Shortlink

Deletes a short link. The hostname and path stop resolving. Click history already recorded stays in analytics.