Tenant Customization

Update Tenant Information

POST /tenant/{tenantId}/update-info

Updates tenant business information, contact details, content blocks, and configuration.

Path Parameters

tenantId

integer

required

The tenant ID to update

Body Parameters

business_name

string

Business name

slogan

string

Business slogan or tagline

phone

string

Primary phone number

whatsapp_sales

string

WhatsApp number for sales inquiries

whatsapp_support

string

WhatsApp number for support

string

Contact email address

address

string

Physical address

city

string

City location

description

string

Business description

is_open

boolean

Current open/closed status

show_hours_indicator

boolean

Enable business hours indicator feature

closed_message

string

Message displayed when business is closed

contact_maps_url

string

Google Maps embed URL (Plan 2+ only)

contact_title

string

Contact section title

contact_subtitle

string

Contact section subtitle

content_blocks

object

Section-specific content configuration

Show nested fields

content_blocks.hero

object

Hero section content

title (string, max 100): Hero title
subtitle (string, max 200): Hero subtitle

content_blocks.products

object

Products section content

title (string, max 80): Section title
subtitle (string, max 200): Section subtitle

content_blocks.services

object

Services section content

title (string, max 80): Section title
subtitle (string, max 200): Section subtitle

content_blocks.about

object

About section content

title (string, max 80): Section title

content_blocks.testimonials

object

Testimonials section content

title (string, max 80): Section title
eyebrow (string, max 60): Section eyebrow text

content_blocks.faq

object

FAQ section content

title (string, max 80): Section title
eyebrow (string, max 60): Section eyebrow text

content_blocks.contact

object

Contact section content

title (string, max 80): Section title

content_blocks.payment_methods

object

Payment methods section content

title (string, max 80): Section title

content_blocks.branches

object

Branches section content (Plan 3 only)

title (string, max 80): Section title
eyebrow (string, max 60): Section eyebrow text

about_text

string

About section long-form text content

Response

success

boolean

Operation success status

message

string

Result message

{
  "success": true,
  "message": "Información actualizada"
}

Update Theme

POST /tenant/{tenantId}/update-theme

Updates the tenant’s Preline theme. Available themes depend on the subscription plan.

Path Parameters

tenantId

integer

required

The tenant ID

Body Parameters

theme_slug

string

required

Theme slug to apply. Must be allowed for the tenant’s plan.Plan 1 (Oportunidad): default, slate, gray, zinc, neutral, stonePlan 2 (Crecimiento): All Plan 1 themes plus red, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink, rosePlan 3 (Visión): All themes plus custom (for custom color palette)

Response

success

boolean

Operation success status

message

string

Result message

theme_slug

string

Applied theme slug

{
  "success": true,
  "message": "Tema actualizado correctamente",
  "theme_slug": "slate"
}

Error Response

{
  "success": false,
  "message": "Tema no válido para tu plan",
  "errors": {
    "theme_slug": ["The selected theme slug is invalid."]
  }
}

Update Palette (Legacy)

POST /tenant/{tenantId}/update-palette

Deprecated: Use /update-theme instead. This endpoint exists for backward compatibility. Updates the color palette using the legacy parameter name.

Path Parameters

tenantId

integer

required

The tenant ID

Body Parameters

theme

string

required

Theme slug (same values as theme_slug in /update-theme)

Response

success

boolean

Operation success status

message

string

Result message

theme_slug

string

Applied theme slug

Update PIN

POST /tenant/{tenantId}/update-pin

Updates the tenant’s 4-digit PIN used for dashboard access.

Path Parameters

tenantId

integer

required

The tenant ID

Body Parameters

current_pin

string

required

Current 4-digit PIN. Must match the tenant’s stored PIN hash.Format: Exactly 4 numeric digits (e.g., “1234”)

new_pin

string

required

New 4-digit PIN to set.Format: Exactly 4 numeric digits (e.g., “5678”)

new_pin_confirmation

string

required

Confirmation of new PIN. Must match new_pin.

Response

success

boolean

Operation success status

message

string

Result message

{
  "success": true,
  "message": "PIN actualizado correctamente"
}

Error Responses

Invalid current PIN:

{
  "success": false,
  "message": "El PIN actual es incorrecto"
}

Validation error:

{
  "success": false,
  "message": "Error al actualizar PIN: validation error details"
}

Update Custom Palette (Plan 3)

POST /tenant/{tenantId}/dashboard/save-custom-palette

Saves a custom primary color for Plan 3 (Visión) tenants. Automatically sets theme_slug to "custom".

Path Parameters

tenantId

integer

required

The tenant ID (must have Plan 3)

Body Parameters

primary

string

required

Primary brand color in hex format (e.g., #3B82F6)

Response

success

boolean

Operation success status

message

string

Result message

{
  "success": true,
  "message": "Paleta personalizada guardada"
}

Error Response

Plan restriction:

{
  "success": false,
  "message": "La paleta personalizada solo está disponible en el Plan Visión (plan_id=2)"
}

Update Header Message (Plan 2+)

POST /tenant/{tenantId}/update-header-message

Updates the promotional header message displayed at the top of the landing page. Available for Plan 2 (Crecimiento) and Plan 3 (Visión) only.

Path Parameters

tenantId

integer

required

The tenant ID

Body Parameters

header_message

string

Promotional message text. Set to empty string or null to remove.

Response

success

boolean

Operation success status

message

string

Result message

{
  "success": true,
  "message": "Mensaje actualizado"
}

Authentication

Tenants

Products & Services

Food Menu

Orders

Analytics

Utilities

Tenant Customization

Update Tenant Information

Path Parameters

Body Parameters

Response

Update Theme

Path Parameters

Body Parameters

Response

Error Response

Update Palette (Legacy)

Path Parameters

Body Parameters

Response

Update PIN

Path Parameters

Body Parameters

Response

Error Responses

Update Custom Palette (Plan 3)

Path Parameters

Body Parameters

Response

Error Response

Update Header Message (Plan 2+)

Path Parameters

Body Parameters

Response

Build docs developers (and LLMs) love

Authentication

Tenants

Products & Services

Food Menu

Orders

Analytics

Utilities

​Update Tenant Information

​Path Parameters

​Body Parameters

​Response

​Update Theme

​Path Parameters

​Body Parameters

​Response

​Error Response

​Update Palette (Legacy)

​Path Parameters

​Body Parameters

​Response

​Update PIN

​Path Parameters

​Body Parameters

​Response

​Error Responses

​Update Custom Palette (Plan 3)

​Path Parameters

​Body Parameters

​Response

​Error Response

​Update Header Message (Plan 2+)

​Path Parameters

​Body Parameters

​Response

Build docs developers (and LLMs) love

Update Tenant Information

Path Parameters

Body Parameters

Response

Update Theme

Path Parameters

Body Parameters

Response

Error Response

Update Palette (Legacy)

Path Parameters

Body Parameters

Response

Update PIN

Path Parameters

Body Parameters

Response

Error Responses

Update Custom Palette (Plan 3)

Path Parameters

Body Parameters

Response

Error Response

Update Header Message (Plan 2+)

Path Parameters

Body Parameters

Response