Skip to main content
DELETE
Remove Tenant Source by RoyaltySource ID
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

Required Role

  • admin or owner role within the tenant

Important: ID Parameter

The id parameter represents the RoyaltySource ID, not the TenantSource association ID. This endpoint deletes the tenant’s source association WHERE RoyaltySourceId = id AND TenantId = authenticated_tenant.

Business Rules

  • Can only remove own tenant’s associations
  • Permanently removes the association (does not just deactivate)
  • Does NOT delete the underlying RoyaltySource record

Side Effects

  • Triggers regeneration of tenant’s sales data query cache
  • Updates tenant-specific BigQuery query configurations

Alternative: Deactivate Instead

If you want to temporarily disable a source without removing it, use the POST /sources/{id}/deactivate endpoint instead. This preserves the association and settings for potential reactivation later. Authorization:
  • Required role: admin or higher

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string
required

RoyaltySource ID (not TenantSource ID)

Example:

"src-1"

Response

Source removed successfully

message
string
Example:

"Source removed successfully"