Update Tenant Source by RoyaltySource ID
Updates a tenant source association by the RoyaltySource ID.
Description
Required Permissions
sources:update
Important: ID Parameter
Theid parameter represents the RoyaltySource ID, not the TenantSource association ID.
This endpoint updates the tenant’s source association WHERE RoyaltySourceId = id AND TenantId = authenticated_tenant.
Business Rules
- Can only update own tenant’s associations
- Updates only
settingsandreplacementsfields
Side Effects
- Triggers regeneration of tenant’s sales data query cache
- Updates tenant-specific BigQuery query configurations
- Required role:
adminor higher
Code Examples
Authorizations
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Path Parameters
RoyaltySource ID (not TenantSource ID)
"src-1"
Body
Response
Tenant source updated successfully
Association between a tenant and a royalty source. Note: The composite key is (TenantId, RoyaltySourceId).
Tenant ID (automatically set from authenticated user)
1
Royalty source ID
"src-1"
Whether this source association is active for the tenant
true
Tenant-specific settings for this source
Tenant-specific field replacements/mappings
Number of files processed for this tenant-source association
42
Timestamp of the most recently processed file
"2026-03-04T14:30:00.000Z"
ID of the most recently processed file
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
When tenant-specific settings were last modified
TenantUserId who last updated the settings