Regenerate Store Facebook Catalog Feed Token (v1)

Method & Path

POST /api/v1/workspace/:workspaceId/storefront/store/facebook-catalog/regenerate-feed-token

Actual backend path: POST /v1/workspace/:workspaceId/storefront/store/facebook-catalog/regenerate-feed-token

Description

Rotates the secret used for the public Meta CSV feed URL. Returns the new plaintext token and, when the request Host / PUBLIC_API_BASE_URL allows, a ready-to-paste feedUrl.

Authentication

Required — JWT workspace token and staff context.

Required Permissions: store.manage

Personas: Workspace Owner and Staff with store.manage.

Headers

Header	Required	Description
Authorization	Yes	Bearer <token>
Content-Type	Yes	application/json (body may be empty {})
X-Staff-Id	If applicable	Staff member performing the action

Path Parameters

Parameter	Type	Required	Description
workspaceId	string	Yes	Workspace id

Query Parameters

None

Request Body

Empty JSON object {} is accepted.

Response 200 OK

{
  "plainFeedToken": "new-secret-token",
  "feedUrl": "https://api.example.com/v1/public/storefront/stores/my-store/catalog-feed.csv?token=...",
  "store": { }
}

feedUrl may be null if the server cannot determine the public API base URL (client can build the URL from VITE_MAIN_API_URL + slug + token).

Common Errors

• 400 Bad Request: Feed not enabled
• 401 Unauthorized: Missing/invalid token
• 403 Forbidden: Missing store.manage
• 404 Not Found: Store not created
• 500 Internal Server Error: Server error