SaaSFlow
DevelopersAPIReferenceproducts

Update product

Update a product. Only the fields you send change. Renaming is safe for reporting: subscription events reference the product by id, so past revenue follows the new name.

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.
PUT
/companies/{companyId}/products/{productId}

Authorization

Authorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

In: header

Path Parameters

companyId*string
Length1 <= length
productId*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X PUT "https://example.com/companies/string/products/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",  "name": "string",  "productGroupId": "c416ccc2-c7d5-4733-9136-58a3b93937ed",  "order": -8388608,  "createdTime": "2019-08-24T14:15:22Z",  "createdUserId": "string",  "lastUpdatedTime": "2019-08-24T14:15:22Z",  "lastUpdatedUserId": "string",  "externalIds": [    "string"  ]}

Delete product

Delete a product. Check `eventCount` on the list endpoint first: a product still referenced by subscription events is load-bearing for MRR-by-product reporting, and removing it strips that breakdown from the history.

Change group

Move one product into a different product group, or send `productGroupId: null` to take it out of every group. Use `/products/reorder` instead when you also need to set the position inside the target group. Fails with 404 if the product or the group does not exist.