curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": [
{
"id": "lnk-abc123def456",
"template_id": "tpl-abc123def456",
"mode": "use",
"last4": "x9Qa",
"uses": 3,
"max_uses": 10,
"expires_at": "2026-11-03T14:02:00Z",
"revoked_at": null,
"created_at": "2026-10-27T14:02:00Z"
}
]
}
Share links
List the Share Links of a Template
Lists the share links of a private template with their mode, uses, limit, expiry and revocation, without the tokens.
GET
/
v1
/
templates
/
{template_id}
/
share-links
curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": [
{
"id": "lnk-abc123def456",
"template_id": "tpl-abc123def456",
"mode": "use",
"last4": "x9Qa",
"uses": 3,
"max_uses": 10,
"expires_at": "2026-11-03T14:02:00Z",
"revoked_at": null,
"created_at": "2026-10-27T14:02:00Z"
}
]
}
This call lists every share link of a private template, including revoked and expired ones, so you can see how each is used. Tokens are never returned again: each link shows only the last 4 characters (
last4) to tell them apart.
Needs the templates:read scope when called with an API key. Only the owner of the template can list its links; a workspace member cannot.
string
required
The template ID.
string
If the template belongs to a workspace, the workspace’s ID.
curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
-H "Authorization: Bearer $VERTRA_API_KEY"
Response
object[]
The links.
Show Toggle object
Show Toggle object
string
The link ID.
string
The template the link belongs to.
string
use or full_copy.string
The last 4 characters of the token, to tell links apart.
integer
How many times the link was used.
integer | null
The maximum number of uses, or
null for no limit.string | null
When the link expires, or
null when it does not expire.string | null
When the author revoked the link, or
null.string
When the link was created.
{
"response": [
{
"id": "lnk-abc123def456",
"template_id": "tpl-abc123def456",
"mode": "use",
"last4": "x9Qa",
"uses": 3,
"max_uses": 10,
"expires_at": "2026-11-03T14:02:00Z",
"revoked_at": null,
"created_at": "2026-10-27T14:02:00Z"
}
]
}
Error Responses
string
The error code indicating the reason for the failure. Possible values:
API_KEY_SCOPE_DENIED: The API key does not have thetemplates:readscope (403).TEMPLATE_NOT_FOUND: The template does not exist or is not yours (404).WORKSPACE_OWNER_ONLY: Only the workspace owner lists the links of its templates.
{
"code": "TEMPLATE_NOT_FOUND"
}
Last modified on October 28, 2026