Update a link - Tapper Documentation

Update a link

curl --request PUT \
  --url https://itlinks.to/v1/links/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "data": {
    "name": "<string>",
    "slug": "ExampleSlug",
    "rules": [
      {
        "url_ratios": [
          {
            "url": "<string>",
            "ratio": 123,
            "name": "<string>",
            "meta_title": "<string>",
            "meta_description": "<string>",
            "meta_media_url": "<string>",
            "mobile_app_os_id": 2,
            "scripts": [
              2
            ]
          }
        ],
        "name": "<string>",
        "active_from": "2023-11-07T05:31:56Z",
        "active_to": "2023-11-07T05:31:56Z",
        "locations": [
          {
            "type": "country",
            "id": "ISO 3166-1 alpha-3 country code, or one of: ['Africa', 'Antarctica', 'Asia', 'Australia', 'Europe', 'North America', 'Oceania', 'South America']"
          }
        ],
        "device_types": [
          "Desktop"
        ],
        "oses": [
          "Mac OS"
        ],
        "week_days": [
          "MONDAY"
        ],
        "day_time_ranges": [
          {
            "time_from": "22:00",
            "time_to": "23:00"
          }
        ]
      }
    ],
    "tags": [
      "<string>"
    ]
  }
}
EOF

{
  "meta": {}
}

PUT

links

{id}

Update a link

curl --request PUT \
  --url https://itlinks.to/v1/links/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "data": {
    "name": "<string>",
    "slug": "ExampleSlug",
    "rules": [
      {
        "url_ratios": [
          {
            "url": "<string>",
            "ratio": 123,
            "name": "<string>",
            "meta_title": "<string>",
            "meta_description": "<string>",
            "meta_media_url": "<string>",
            "mobile_app_os_id": 2,
            "scripts": [
              2
            ]
          }
        ],
        "name": "<string>",
        "active_from": "2023-11-07T05:31:56Z",
        "active_to": "2023-11-07T05:31:56Z",
        "locations": [
          {
            "type": "country",
            "id": "ISO 3166-1 alpha-3 country code, or one of: ['Africa', 'Antarctica', 'Asia', 'Australia', 'Europe', 'North America', 'Oceania', 'South America']"
          }
        ],
        "device_types": [
          "Desktop"
        ],
        "oses": [
          "Mac OS"
        ],
        "week_days": [
          "MONDAY"
        ],
        "day_time_ranges": [
          {
            "time_from": "22:00",
            "time_to": "23:00"
          }
        ]
      }
    ],
    "tags": [
      "<string>"
    ]
  }
}
EOF

{
  "meta": {}
}

Authorizations

Authorization

string

header

required

Path Parameters

number

required

The unique identifier of the link to update.

Required range: x >= 1

Body

application/json

data

object

required

Show child attributes

data.name

string

required

The name of the link to be updated.

Maximum string length: 320

data.slug

string

required

A URL-friendly identifier for the link.

Maximum string length: 320

Example:

"ExampleSlug"

data.rules

object[]

required

A list of rules associated with the link.

Show child attributes

data.rules.url_ratios

object[] | null

required

A list of URL ratios defining how different URLs should be distributed.

Show child attributes

data.rules.url_ratios.url

string<uri>

required

The actual URL.

data.rules.url_ratios.ratio

number

required

The ratio in which this URL should be used.

data.rules.url_ratios.name

string | null

The name of the URL ratio.

Maximum string length: 320

data.rules.url_ratios.meta_title

string | null

The meta title for the URL.

Maximum string length: 320

data.rules.url_ratios.meta_description

string | null

The meta description for the URL.

data.rules.url_ratios.meta_media_url

string<uri>

The media URL for the meta tag.

data.rules.url_ratios.mobile_app_os_id

number | null

The OS ID of the mobile app, if applicable.

Required range: x >= 1

data.rules.url_ratios.scripts

number[] | null

A list of script IDs associated with the link.

Required range: x >= 1

data.rules.name

string | null

The name of the rule.

Maximum string length: 320

data.rules.active_from

string<date-time> | null

The starting date from which the rule is active.

data.rules.active_to

string<date-time> | null

The ending date until which the rule is active.

data.rules.locations

object[] | null

A list of locations where the rule applies.

Show child attributes

data.rules.locations.type

enum<string>

The type of location targeted by the rule.

Available options:

country,

continent

data.rules.locations.id

string

The specific location targeted by the rule.

Example:

"ISO 3166-1 alpha-3 country code, or one of: ['Africa', 'Antarctica', 'Asia', 'Australia', 'Europe', 'North America', 'Oceania', 'South America']"

data.rules.device_types

enum<string>[] | null

The types of devices targeted by the rule.

Available options:

Desktop,

Mobile,

Tablet,

iPod,

SmartTV,

Console,

Wearable,

Embedded,

Curl,

Bot

data.rules.oses

enum<string>[] | null

The operating systems targeted by the rule.

Available options:

Mac OS,

iOS,

Android,

Windows,

Windows Mobile OS

data.rules.week_days

enum<string>[] | null

The days of the week when the rule is active.

Available options:

MONDAY,

TUESDAY,

WEDNESDAY,

THURSDAY,

FRIDAY,

SATURDAY,

SUNDAY

data.rules.day_time_ranges

object[] | null

The time ranges during the day when the rule is active.

Show child attributes

data.rules.day_time_ranges.time_from

string

Example:

"22:00"

data.rules.day_time_ranges.time_to

string

Example:

"23:00"

data.tags

string[]

A list of tags for categorizing the link.

Maximum string length: 320

Response

Link updated successfully.