Estilos de página

Un estilo de página reúne colores, fuentes, disposición y banner, compartidos por todas las páginas que lo siguen: modificarlo cambia esas páginas al instante. Los ajustes son los de la apariencia de una página; una página se vincula a un estilo con PATCH /v1/pages/{id}/style. Crear, modificar o duplicar un estilo depende del plan, como los componentes.

GET/v1/page-stylesListar los estilos
POST/v1/page-stylesCrear un estilo
GET/v1/page-styles/{id}Leer un estilo
PATCH/v1/page-styles/{id}Modificar un estilo
PUT/v1/page-styles/{id}/bannerCambiar el banner de un estilo
POST/v1/page-styles/{id}/bannerCambiar el banner de un estilo
DELETE/v1/page-styles/{id}/bannerCambiar el banner de un estilo
POST/v1/page-styles/{id}/duplicateDuplicar un estilo
DELETE/v1/page-styles/{id}Eliminar un estilo

Listar los estilos

GET/v1/page-styles

Primero los siete estilos proporcionados por TinyLink (builtin: true: default, light, dark, blue, cream, forest, plum), utilizables por todas las páginas pero no modificables, y luego los del espacio de trabajo, por orden alfabético. pages_count cuenta las páginas que siguen el estilo. Ámbito Lectura.

curl https://api.tinylink.fr/v1/page-styles \
  -H "Authorization: Bearer tl_tu_token"

const response = await fetch('https://api.tinylink.fr/v1/page-styles', {
  headers: { Authorization: 'Bearer tl_tu_token' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/page-styles');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.get(
    'https://api.tinylink.fr/v1/page-styles',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "data": [
    {
      "id": "default",
      "name": "Default",
      "description": null,
      "builtin": true,
      "settings": {
        "header_layout": "classic",
        "logo_size": "medium",
        "header_text_size": "medium",
        "header_color": "#212121",
        "header_title_color": "#FFFFFF",
        "header_description_color": "#D8D8D8",
        "header_icon_color": "#FFFFFF",
        "header_title_font": "metroblack",
        "header_description_font": "robotoreg",
        "button_text_size": "medium",
        "button_color": "#FFFFFF",
        "button_title_color": "#212121",
        "button_description_color": "#888888",
        "button_title_font": "robotoreg",
        "button_description_font": "robotoreg",
        "button_radius": "rounded",
        "background_color": "#F0F0F0",
        "section_text_size": "medium",
        "section_title_color": "#212121",
        "section_title_font": "robotobold",
        "section_description_color": "#888888",
        "section_description_font": "robotoreg"
      },
      "banner": null,
      "pages_count": 0,
      "created_at": null
    },
    {
      "id": "light",
      "name": "Light",
      "description": null,
      "builtin": true,
      "settings": {
        "header_layout": "classic",
        "logo_size": "medium",
        "header_text_size": "medium",
        "header_color": "#FFFFFF",
        "header_title_color": "#212121",
        "header_description_color": "#646464",
        "header_icon_color": "#212121",
        "header_title_font": "metroblack",
        "header_description_font": "robotoreg",
        "button_text_size": "medium",
        "button_color": "#FFFFFF",
        "button_title_color": "#212121",
        "button_description_color": "#888888",
        "button_title_font": "robotoreg",
        "button_description_font": "robotoreg",
        "button_radius": "rounded",
        "background_color": "#F0F0F0",
        "section_text_size": "medium",
        "section_title_color": "#212121",
        "section_title_font": "robotobold",
        "section_description_color": "#888888",
        "section_description_font": "robotoreg"
      },
      "banner": null,
      "pages_count": 0,
      "created_at": null
    }
  ]
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Lectura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"read\" scope.",
    "details": {
      "required_scope": "read"
    }
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Crear un estilo

POST/v1/page-styles

name es obligatorio (100 caracteres como máximo). Los ajustes parten de los de una página nueva; settings cambia algunos. Con from_page (identificador o slug de una página), el estilo toma la apariencia de esa página, banner incluido; la página no queda vinculada por ello. Ámbito Escritura.

name: el nombre del estilo
description: 1000 caracteres como máximo
settings: ajustes de apariencia, ver Apariencia de una página
from_page: página cuya apariencia se copia

curl -X POST https://api.tinylink.fr/v1/page-styles \
  -H "Authorization: Bearer tl_tu_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Charte 2026",
    "description": "Couleurs de la marque",
    "settings": {
      "button_color": "#1E90FF",
      "button_title_color": "#FFFFFF",
      "button_radius": "circular"
    }
  }'

const response = await fetch('https://api.tinylink.fr/v1/page-styles', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tl_tu_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Charte 2026',
    description: 'Couleurs de la marque',
    settings: {
      button_color: '#1E90FF',
      button_title_color: '#FFFFFF',
      button_radius: 'circular',
    },
  }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/page-styles');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'name' => 'Charte 2026',
        'description' => 'Couleurs de la marque',
        'settings' => [
            'button_color' => '#1E90FF',
            'button_title_color' => '#FFFFFF',
            'button_radius' => 'circular',
        ],
    ]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.post(
    'https://api.tinylink.fr/v1/page-styles',
    headers={'Authorization': 'Bearer tl_tu_token'},
    json={
        'name': 'Charte 2026',
        'description': 'Couleurs de la marque',
        'settings': {
            'button_color': '#1E90FF',
            'button_title_color': '#FFFFFF',
            'button_radius': 'circular',
        },
    },
)
data = response.json()

Respuestas posibles

{
  "id": "PST6ad34a11d00877",
  "name": "Charte 2026",
  "description": "Couleurs de la marque",
  "builtin": false,
  "settings": {
    "header_layout": "classic",
    "logo_size": "medium",
    "header_text_size": "medium",
    "header_color": "#212121",
    "header_title_color": "#FFFFFF",
    "header_description_color": "#D8D8D8",
    "header_icon_color": "#FFFFFF",
    "header_title_font": "metroblack",
    "header_description_font": "robotoreg",
    "button_text_size": "medium",
    "button_color": "#1E90FF",
    "button_title_color": "#FFFFFF",
    "button_description_color": "#888888",
    "button_title_font": "robotoreg",
    "button_description_font": "robotoreg",
    "button_radius": "circular",
    "background_color": "#F0F0F0",
    "section_text_size": "medium",
    "section_title_color": "#212121",
    "section_title_font": "robotobold",
    "section_description_color": "#888888",
    "section_description_font": "robotoreg"
  },
  "banner": null,
  "pages_count": 0,
  "created_at": "2026-10-17T12:12:33+02:00",
  "pages": []
}

El cuerpo no es un objeto JSON

{
  "error": {
    "code": "invalid_json",
    "message": "The request body must be a JSON object."
  }
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

El plan del propietario no incluye los estilos de página

{
  "error": {
    "code": "plan_feature_unavailable",
    "message": "Page styles are not included in the plan of this environment's owner."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Escritura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"write\" scope.",
    "details": {
      "required_scope": "write"
    }
  }
}

Campo obligatorio ausente o vacío

{
  "error": {
    "code": "validation_failed",
    "message": "The \"name\" field is required.",
    "details": {
      "field": "name"
    }
  }
}

Ajuste de apariencia desconocido

{
  "error": {
    "code": "validation_failed",
    "message": "Unknown setting \"shadow\". Accepted: header_layout, logo_size, header_text_size, header_color, header_title_color, header_description_color, header_icon_color, header_title_font, header_description_font, button_text_size, button_color, button_title_color, button_description_color, button_title_font, button_description_font, button_radius, background_color, section_text_size, section_title_color, section_title_font, section_description_color, section_description_font.",
    "details": {
      "field": "settings.shadow"
    }
  }
}

Valor rechazado para un ajuste (color, fuente, lista)

{
  "error": {
    "code": "validation_failed",
    "message": "The \"button_color\" setting must be a hexadecimal colour such as #1E90FF.",
    "details": {
      "field": "settings.button_color"
    }
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Leer un estilo

GET/v1/page-styles/{id}

El estilo y las páginas que lo siguen. Un estilo proporcionado también se lee (/page-styles/dark). Ámbito Lectura.

curl https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877 \
  -H "Authorization: Bearer tl_tu_token"

const response = await fetch('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877', {
  headers: { Authorization: 'Bearer tl_tu_token' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.get(
    'https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "id": "PST6ad34a11d00877",
  "name": "Charte 2026",
  "description": "Couleurs de la marque",
  "builtin": false,
  "settings": {
    "header_layout": "classic",
    "logo_size": "medium",
    "header_text_size": "medium",
    "header_color": "#212121",
    "header_title_color": "#FFFFFF",
    "header_description_color": "#D8D8D8",
    "header_icon_color": "#FFFFFF",
    "header_title_font": "metroblack",
    "header_description_font": "robotoreg",
    "button_text_size": "medium",
    "button_color": "#1E90FF",
    "button_title_color": "#FFFFFF",
    "button_description_color": "#888888",
    "button_title_font": "robotoreg",
    "button_description_font": "robotoreg",
    "button_radius": "circular",
    "background_color": "#F0F0F0",
    "section_text_size": "medium",
    "section_title_color": "#212121",
    "section_title_font": "robotobold",
    "section_description_color": "#888888",
    "section_description_font": "robotoreg"
  },
  "banner": null,
  "pages_count": 1,
  "created_at": "2026-10-17T12:12:33+02:00",
  "pages": [
    {
      "id": "P6ad34a0e4fef09",
      "name": "Ma page",
      "url": "https://tnylnk.fr/ma-page"
    }
  ]
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Lectura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"read\" scope.",
    "details": {
      "required_scope": "read"
    }
  }
}

Ningún estilo de página con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Page style not found in this environment."
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Modificar un estilo

PATCH/v1/page-styles/{id}

name, description y, en settings, solo los ajustes que cambian. Todas las páginas que siguen el estilo cambian con él. Ámbito Escritura.

curl -X PATCH https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877 \
  -H "Authorization: Bearer tl_tu_token" \
  -H "Content-Type: application/json" \
  -d '{"settings":{"background_color":"#181818"}}'

const response = await fetch('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer tl_tu_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ settings: { background_color: '#181818' } }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode(['settings' => ['background_color' => '#181818']]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.patch(
    'https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877',
    headers={'Authorization': 'Bearer tl_tu_token'},
    json={'settings': {'background_color': '#181818'}},
)
data = response.json()

Respuestas posibles

{
  "id": "PST6ad34a11d00877",
  "name": "Charte 2026",
  "description": "Couleurs de la marque",
  "builtin": false,
  "settings": {
    "header_layout": "classic",
    "logo_size": "medium",
    "header_text_size": "medium",
    "header_color": "#212121",
    "header_title_color": "#FFFFFF",
    "header_description_color": "#D8D8D8",
    "header_icon_color": "#FFFFFF",
    "header_title_font": "metroblack",
    "header_description_font": "robotoreg",
    "button_text_size": "medium",
    "button_color": "#1E90FF",
    "button_title_color": "#FFFFFF",
    "button_description_color": "#888888",
    "button_title_font": "robotoreg",
    "button_description_font": "robotoreg",
    "button_radius": "circular",
    "background_color": "#181818",
    "section_text_size": "medium",
    "section_title_color": "#212121",
    "section_title_font": "robotobold",
    "section_description_color": "#888888",
    "section_description_font": "robotoreg"
  },
  "banner": null,
  "pages_count": 1,
  "created_at": "2026-10-17T12:12:33+02:00",
  "pages": [
    {
      "id": "P6ad34a0e4fef09",
      "name": "Ma page",
      "url": "https://tnylnk.fr/ma-page"
    }
  ]
}

El cuerpo no es un objeto JSON

{
  "error": {
    "code": "invalid_json",
    "message": "The request body must be a JSON object."
  }
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

Estilo proporcionado por TinyLink, de solo lectura

{
  "error": {
    "code": "builtin_style",
    "message": "Styles provided by TinyLink cannot be modified or deleted. Duplicate one to make it yours."
  }
}

El plan del propietario no incluye los estilos de página

{
  "error": {
    "code": "plan_feature_unavailable",
    "message": "Page styles are not included in the plan of this environment's owner."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Escritura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"write\" scope.",
    "details": {
      "required_scope": "write"
    }
  }
}

Ningún estilo de página con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Page style not found in this environment."
  }
}

Ningún campo modificable en el cuerpo

{
  "error": {
    "code": "validation_failed",
    "message": "Nothing to update. Accepted fields: name, description, settings."
  }
}

Ajuste de apariencia desconocido

{
  "error": {
    "code": "validation_failed",
    "message": "Unknown setting \"shadow\". Accepted: header_layout, logo_size, header_text_size, header_color, header_title_color, header_description_color, header_icon_color, header_title_font, header_description_font, button_text_size, button_color, button_title_color, button_description_color, button_title_font, button_description_font, button_radius, background_color, section_text_size, section_title_color, section_title_font, section_description_color, section_description_font.",
    "details": {
      "field": "settings.shadow"
    }
  }
}

Valor rechazado para un ajuste (color, fuente, lista)

{
  "error": {
    "code": "validation_failed",
    "message": "The \"button_color\" setting must be a hexadecimal colour such as #1E90FF.",
    "details": {
      "field": "settings.button_color"
    }
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Cambiar el banner de un estilo

PUT/v1/page-styles/{id}/banner

POST/v1/page-styles/{id}/banner

DELETE/v1/page-styles/{id}/banner

Mismo envío que el banner de una página (image, crop.classic, crop.wide); DELETE lo quita. Las páginas que siguen el estilo lo muestran al instante. Ámbito Escritura.

curl -X PUT https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877/banner \
  -H "Authorization: Bearer tl_tu_token" \
  -H "Content-Type: application/json" \
  -d '{"image":"https://ejemplo.es/banner.jpg"}'

const response = await fetch('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877/banner', {
  method: 'PUT',
  headers: {
    Authorization: 'Bearer tl_tu_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ image: 'https://ejemplo.es/banner.jpg' }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877/banner');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode(['image' => 'https://ejemplo.es/banner.jpg']),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.put(
    'https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877/banner',
    headers={'Authorization': 'Bearer tl_tu_token'},
    json={'image': 'https://ejemplo.es/banner.jpg'},
)
data = response.json()

Respuestas posibles

{
  "id": "PST6ad34a11d00877",
  "name": "Charte 2026",
  "description": "Couleurs de la marque",
  "builtin": false,
  "settings": {
    "header_layout": "classic",
    "logo_size": "medium",
    "header_text_size": "medium",
    "header_color": "#212121",
    "header_title_color": "#FFFFFF",
    "header_description_color": "#D8D8D8",
    "header_icon_color": "#FFFFFF",
    "header_title_font": "metroblack",
    "header_description_font": "robotoreg",
    "button_text_size": "medium",
    "button_color": "#1E90FF",
    "button_title_color": "#FFFFFF",
    "button_description_color": "#888888",
    "button_title_font": "robotoreg",
    "button_description_font": "robotoreg",
    "button_radius": "circular",
    "background_color": "#181818",
    "section_text_size": "medium",
    "section_title_color": "#212121",
    "section_title_font": "robotobold",
    "section_description_color": "#888888",
    "section_description_font": "robotoreg"
  },
  "banner": {
    "classic": "https://content.tinylink.fr/page-banner/banner_6ad34a1230b69.webp",
    "wide": "https://content.tinylink.fr/page-banner/wide_banner_6ad34a1230b69.webp"
  },
  "pages_count": 1,
  "created_at": "2026-10-17T12:12:33+02:00",
  "pages": [
    {
      "id": "P6ad34a0e4fef09",
      "name": "Ma page",
      "url": "https://tnylnk.fr/ma-page"
    }
  ]
}

El cuerpo no es un objeto JSON

{
  "error": {
    "code": "invalid_json",
    "message": "The request body must be a JSON object."
  }
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

Estilo proporcionado por TinyLink, de solo lectura

{
  "error": {
    "code": "builtin_style",
    "message": "Styles provided by TinyLink cannot be modified or deleted. Duplicate one to make it yours."
  }
}

El plan del propietario no incluye los banners

{
  "error": {
    "code": "plan_feature_unavailable",
    "message": "Banners are not included in the plan of this environment's owner."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Escritura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"write\" scope.",
    "details": {
      "required_scope": "write"
    }
  }
}

Ningún estilo de página con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Page style not found in this environment."
  }
}

Imagen ilegible, demasiado pesada o en un formato rechazado

{
  "error": {
    "code": "invalid_image",
    "message": "The image could not be used: send a JPEG, PNG or WebP image (5 MB and 6000 px per side at most) as a public address, a base64 data URI, or a file sent with POST as multipart/form-data.",
    "details": {
      "field": "image"
    }
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Duplicar un estilo

POST/v1/page-styles/{id}/duplicate

Copia el estilo, banner incluido, con el nombre name (por defecto: el nombre seguido de «(copy)»). Un estilo proporcionado también se duplica: la copia pertenece al espacio de trabajo y se puede modificar. Ámbito Escritura.

curl -X POST https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877/duplicate \
  -H "Authorization: Bearer tl_tu_token" \
  -H "Content-Type: application/json" \
  -d '{"name":"Charte 2026 (soldes)"}'

const response = await fetch('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877/duplicate', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tl_tu_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Charte 2026 (soldes)' }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877/duplicate');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode(['name' => 'Charte 2026 (soldes)']),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.post(
    'https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877/duplicate',
    headers={'Authorization': 'Bearer tl_tu_token'},
    json={'name': 'Charte 2026 (soldes)'},
)
data = response.json()

Respuestas posibles

{
  "id": "PST6ad34a13c32e24",
  "name": "Charte 2026 (soldes)",
  "description": "Couleurs de la marque",
  "builtin": false,
  "settings": {
    "header_layout": "classic",
    "logo_size": "medium",
    "header_text_size": "medium",
    "header_color": "#212121",
    "header_title_color": "#FFFFFF",
    "header_description_color": "#D8D8D8",
    "header_icon_color": "#FFFFFF",
    "header_title_font": "metroblack",
    "header_description_font": "robotoreg",
    "button_text_size": "medium",
    "button_color": "#1E90FF",
    "button_title_color": "#FFFFFF",
    "button_description_color": "#888888",
    "button_title_font": "robotoreg",
    "button_description_font": "robotoreg",
    "button_radius": "circular",
    "background_color": "#181818",
    "section_text_size": "medium",
    "section_title_color": "#212121",
    "section_title_font": "robotobold",
    "section_description_color": "#888888",
    "section_description_font": "robotoreg"
  },
  "banner": {
    "classic": "https://content.tinylink.fr/page-banner/banner_6ad34a13c31b2.webp",
    "wide": "https://content.tinylink.fr/page-banner/wide_banner_6ad34a13c31b2.webp"
  },
  "pages_count": 0,
  "created_at": "2026-10-17T12:12:35+02:00",
  "pages": []
}

El cuerpo no es un objeto JSON

{
  "error": {
    "code": "invalid_json",
    "message": "The request body must be a JSON object."
  }
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

El plan del propietario no incluye los estilos de página

{
  "error": {
    "code": "plan_feature_unavailable",
    "message": "Page styles are not included in the plan of this environment's owner."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Escritura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"write\" scope.",
    "details": {
      "required_scope": "write"
    }
  }
}

Ningún estilo de página con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Page style not found in this environment."
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Eliminar un estilo

DELETE/v1/page-styles/{id}

Elimina el estilo y su banner; las páginas que lo seguían recuperan sus propios ajustes. Ámbito Eliminación.

curl -X DELETE https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877 \
  -H "Authorization: Bearer tl_tu_token"

const response = await fetch('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877', {
  method: 'DELETE',
  headers: { Authorization: 'Bearer tl_tu_token' },
});
console.log(response.status); // 204

$ch = curl_init('https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token'],
]);
curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE); // 204
curl_close($ch);

import requests

response = requests.delete(
    'https://api.tinylink.fr/v1/page-styles/PST6ad34a11d00877',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
print(response.status_code)  # 204

Respuestas posibles

Sin contenido

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

Estilo proporcionado por TinyLink, de solo lectura

{
  "error": {
    "code": "builtin_style",
    "message": "Styles provided by TinyLink cannot be modified or deleted. Duplicate one to make it yours."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Eliminación

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"delete\" scope.",
    "details": {
      "required_scope": "delete"
    }
  }
}

Ningún estilo de página con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Page style not found in this environment."
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Listar los estilos

Crear un estilo

Leer un estilo

Modificar un estilo

Cambiar el banner de un estilo

Duplicar un estilo

Eliminar un estilo

¿No encuentras tu respuesta?