Skip to main content
PUT
Update a product
Any member of the organization can update a product. Send only the fields you want to change: the ones you omit keep their current value. value is the price in centavos, so 15000 is R$ 150,00. Answers the product as it is after the change. status changes the product’s status too: ACTIVE brings a deactivated product back, and DEACTIVATED retires an active one. A product that still has active payment links can’t be deactivated: end those links first. Setting a status the product already has changes nothing.

Path Parameters

realmId
string<uuid>
required

ID of your realm.

Format: UUID

organizationId
string<uuid>
required

ID of the organization the product belongs to.

Format: UUID

productId
string<uuid>
required

ID of the product (id in the product list).

Format: UUID

Body

application/json
name
string

New name, 2 to 56 characters. Omit it to keep the current one.

Required string length: 2 - 56
Example:

"Consultoria em logística"

description
string

New description, up to 250 characters. Omit it to keep the current one; send an empty string to clear it.

Maximum string length: 250
Example:

"Hora técnica de consultoria em logística e roteirização."

value
number

New price in centavos: 15000 is R$ 150,00. Must be greater than zero. Omit it to keep the current one.

Required range: x > 0
Example:

15000

skuCode
string

New stock-keeping code. Omit it to keep the current one.

Example:

"CONS-LOG-001"

type
string

PRODUCT for a physical good or SERVICE for a service. Any other text is stored as sent, and the exports show it as a service. Omit it to keep the current one.

Example:

"SERVICE"

status
enum<string>

ACTIVE or DEACTIVATED. Omit it to keep the current status. Setting DEACTIVATED on an active product is refused while it still has active payment links.

Available options:
ACTIVE,
DEACTIVATED
Example:

"DEACTIVATED"

Response

Successful response

A product or service of the organization's catalog.

id
string
required

ID of the product.

Example:

"9b2f6c1e-3d4a-4f7b-8e21-5a6c7d8e9f01"

realmId
string<uuid>
required

ID of the realm the product belongs to.

Example:

"f495ff0c-ab54-4f99-8e92-ca8682e4de9b"

organizationId
string<uuid>
required

ID of the organization the product belongs to.

Example:

"c4bd3f21-dfbd-44e8-8055-68ba15bed410"

name
string
required

Name of the product or service.

Example:

"Consultoria em logística"

description
string
required

Free-text description. Empty when none was given.

Example:

"Hora técnica de consultoria em logística e roteirização."

value
number
required

Price in centavos: 15000 is R$ 150,00.

Example:

15000

type
string
required

PRODUCT for a physical good or SERVICE for a service. Any other text a client stored is kept as sent.

Example:

"SERVICE"

status
enum<string>
required

ACTIVE, or DEACTIVATED once the product was retired.

Available options:
ACTIVE,
DEACTIVATED
Example:

"ACTIVE"

skuCode
string | null

Your own stock-keeping code. Absent, or null, when none was given.

Example:

"CONS-LOG-001"

createdAt
string<date-time>

When the product was created.

Example:

"2026-10-02T14:03:11.000Z"

updatedAt
string<date-time>

When the product was last changed.

Example:

"2026-10-05T09:30:00.000Z"