Copy Catalog Product To Company List
POST/api/v1/catalog-products/:catalogProductId/copy
Copy a global catalog product into the company's product list, with local overrides. Requires scope crm:write and the Products add_edit permission. Create-only - when the company already has a local product linked to that catalog uuid (through an earlier copy or a catalog link), the call is refused with 409 PRODUCT_ALREADY_IN_LIST naming the existing product; edit that product through PATCH /api/v1/products/{id} instead.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 429
- 500
- 503
Success
Canonical personal-token bad request, including PUBLIC_POSITION_REQUIRED or PUBLIC_ACTOR_OVERRIDE_NOT_ALLOWED.
The Bearer personal token is missing, malformed, inactive, expired, revoked, or CIDR-blocked. Personal-token 401 responses include the Bearer challenge. Temporary validation outages return 503 instead.
Response Headers
Canonical personal-token authorization denial, including unavailable or unauthorized position selection.
Catalog product not found.
This catalog product is already in the company's product list (PRODUCT_ALREADY_IN_LIST, with product_id and product_uuid).
Rate limit exceeded
Response Headers
Active public API plan applied to the request. Free and Kickstarter are blocked before rate buckets are consumed.
Rate-limit bucket used for the request. List-style POST endpoints are counted as reads; mutation endpoints are counted as writes.
Maximum number of requests allowed for the active bucket in the current one-second rate-limit window.
Maximum read requests allowed per second for the active plan. Pro is 100; Unlimited is 500.
Maximum write requests allowed per second for the active plan. Pro is 25; Unlimited is 125.
Number of requests remaining for the active bucket in the current one-second rate-limit window.
Unix timestamp, in seconds, when the current rate-limit window resets.
HTTP date when the current limit resets. Present on 429 responses.
Internal Server Error
Personal access token validation is temporarily unavailable.