Update Project

Updates a project’s details. Only the fields you include in the request body will be changed — all other fields remain untouched.

Endpoint

PUT /api/v1/projects/{slug}

Authentication

string

required

Bearer token with your API key. Requires read_write permission.

Path Parameters

string

required

The project’s URL-friendly slug identifier.

Body Parameters

All fields are optional. Only provided fields are updated.

General Settings

string

Project name. Maximum 100 characters.

string

Short project description.

string

Longer description shown on the pricing page header.

string

Currency code (e.g. "USD", "EUR", "GBP").

number

Discount for annual billing as a decimal (e.g. 0.2 for 20% off).

boolean

Enable or disable the annual billing toggle.

boolean

Activate or deactivate the project.

Redirect URLs

These are the Redirects fields in the builder. Each must be a full https:// or http:// address; send null or "" to clear one. See Redirect URLs.

string

Sent to your checkout link as success_url: where your checkout sends the buyer after a successful payment. Defaults to your Cuprice share page.

string

Sent to your checkout link as cancel_url: where your checkout sends the buyer if they leave. Defaults to your Cuprice share page.

string

Saved with the project. The checkout handoff does not use it.

string

Saved with the project. The checkout handoff does not use it.

The checkout link itself (Integration > Payment) can only be set in the builder.

Theme Settings

object

Visual customization settings for the pricing widget.

Show Theme properties

string

Font family for the pricing widget (e.g. "Inter", "Roboto").

string

Primary accent color as a hex code (e.g. "var(--color-emerald-600)").

string

Button hover color as a hex code.

string

Text color inside buttons as a hex code.

string

Border radius for cards and buttons (e.g. "8px", "12px").

string

Background color of the pricing cards.

string

Border color of the pricing cards.

string

Custom CSS to inject into the pricing widget. Overrides default styles.

boolean

Show or hide the project name in the pricing header.

boolean

Show or hide the pricing page header section.

string

Alignment of the header text ("left", "center", "right").

string

Alignment of the description text ("left", "center", "right").

string

Alignment of the monthly/annual toggle ("left", "center", "right").

string

Position of the “Popular” badge on plan cards ("top", "inline").

Response

Returns the full updated project object.

Example — Update Basic Settings

curl -X PUT https://app.cuprice.io/api/v1/projects/my-saas-app \
  -H "Authorization: Bearer cpk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My SaaS App Pro",
    "annualDiscount": 0.25,
    "annualDiscountEnabled": true,
    "checkoutSuccessUrl": "https://myapp.com/welcome",
    "checkoutCancelUrl": "https://myapp.com/pricing"
  }'

Example — Update Theme with Custom CSS

curl -X PUT https://app.cuprice.io/api/v1/projects/my-saas-app \
  -H "Authorization: Bearer cpk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "theme": {
      "fontFamily": "Roboto",
      "primaryColor": "#4F46E5",
      "hoverColor": "#4338CA",
      "buttonTextColor": "#FFFFFF",
      "borderRadius": "12px",
      "pricingBackgroundColor": "#F9FAFB",
      "pricingBorderColor": "#E5E7EB",
      "showProjectName": true,
      "showPricingHeader": true,
      "headerAlign": "center",
      "descriptionAlign": "center",
      "toggleAlign": "center",
      "popularBadgePosition": "top",
      "customCSS": ".cuprice-card { box-shadow: 0 4px 12px rgba(0,0,0,0.08); } .cuprice-card:hover { transform: translateY(-2px); transition: transform 0.2s ease; }"
    }
  }'

{
  "id": 42,
  "name": "My SaaS App Pro",
  "slug": "my-saas-app",
  "description": "AI-powered project management tool",
  "pricingPageDescription": "Simple, transparent pricing for teams of all sizes.",
  "shareId": "YOUR_SHARE_ID",
  "currency": "USD",
  "annualDiscount": 0.25,
  "annualDiscountEnabled": true,
  "isActive": true,
  "checkoutSuccessUrl": "https://myapp.com/welcome",
  "checkoutCancelUrl": "https://myapp.com/pricing",
  "checkoutTestSuccessUrl": null,
  "checkoutTestCancelUrl": null,
  "themeSettings": {
    "fontFamily": "Roboto",
    "primaryColor": "#4F46E5",
    "hoverColor": "#4338CA",
    "buttonTextColor": "#FFFFFF",
    "borderRadius": "12px",
    "pricingBackgroundColor": "#F9FAFB",
    "pricingBorderColor": "#E5E7EB",
    "customCSS": ".cuprice-card { box-shadow: 0 4px 12px rgba(0,0,0,0.08); } .cuprice-card:hover { transform: translateY(-2px); transition: transform 0.2s ease; }",
    "showProjectName": true,
    "showPricingHeader": true,
    "headerAlign": "center",
    "descriptionAlign": "center",
    "toggleAlign": "center",
    "popularBadgePosition": "top"
  },
  "createdAt": "2025-09-15T10:30:00.000Z",
  "updatedAt": "2025-12-05T16:00:00.000Z"
}

Errors

Status	Description
`400`	Invalid field value (e.g. name exceeds 100 characters)
`401`	Invalid or missing API key
`403`	API key does not have `read_write` permission
`404`	Project with the given slug not found

Overview

Public Endpoints

API v1 — Projects

API v1 — Features

API v1 — Plans

API v1 — Plan Features

API v1 — Subscriptions

Endpoint

Authentication

Path Parameters

Body Parameters

General Settings

Redirect URLs

Theme Settings

Response

Example — Update Basic Settings

Example — Update Theme with Custom CSS

Errors

​Endpoint

​Authentication

​Path Parameters

​Body Parameters

​General Settings

​Redirect URLs

​Theme Settings

​Response

​Example — Update Basic Settings

​Example — Update Theme with Custom CSS

​Errors

Endpoint

Authentication

Path Parameters

Body Parameters

General Settings

Redirect URLs

Theme Settings

Response

Example — Update Basic Settings

Example — Update Theme with Custom CSS

Errors