KastyDevelopers

Music Delivery

130

Errors

Music Delivery errors use stable codes across validation, authentication, uploads, catalog coordination, processing, publication and webhooks. Automation must branch on code, not message text.

Recovery model

First identify whether the response requires corrected data, renewed upload scope, elapsed time, a human agreement action or operator review. Only then decide whether a retry is appropriate.

HTTP and item issues

HTTP 401 and 403 protect authentication and scope boundaries. HTTP 428 identifies a required human agreement or publication-evidence action. HTTP 429 carries capacity guidance. Item issues remain attached to the exact batch entity and can coexist with work on other items.

Canonical index

The generated error pages and this index are built from KASTY_MUSIC_DELIVERY_ERROR_CODES.md. Use listMusicDeliveryIssues for a real batch and the example envelopes for safe integration fixtures.

Error ResponsesValidated JSON example
JSON
[
  {
    "code": "AGREEMENT_ACCEPTANCE_REQUIRED",
    "message": "A current Partner agreement must be accepted by an authorized representative.",
    "actionUrl": "https://agreements.kasty.uk/programs/music-partners"
  },
  {
    "code": "MUSIC_DELIVERY_UPLOAD_INTENT_EXPIRED",
    "message": "Renew the upload intent for the same asset scope.",
    "retryable": true
  }
]
Download exact JSON

Validation and manifest identity

CodeHTTPDefault retry
MUSIC_DELIVERY_MANIFEST_INVALID—No
MUSIC_DELIVERY_SCHEMA_INVALID—No
MUSIC_DELIVERY_MANIFEST_TOO_LARGE—No
MUSIC_DELIVERY_ITEM_LIMIT_EXCEEDED—No
MUSIC_DELIVERY_REF_DUPLICATE—No
MUSIC_DELIVERY_PARTY_REF_NOT_FOUND—No
MUSIC_DELIVERY_RECORDING_REF_NOT_FOUND—No
MUSIC_DELIVERY_RELEASE_REF_NOT_FOUND—No
MUSIC_DELIVERY_ASSET_REF_NOT_FOUND—No
MUSIC_DELIVERY_DEAL_REF_NOT_FOUND—No
MUSIC_DELIVERY_COVER_ASSET_REQUIRED—No
MUSIC_DELIVERY_RELEASE_SEQUENCE_DUPLICATE—No
MUSIC_DELIVERY_RELEASE_POSITION_DUPLICATE—No
MUSIC_DELIVERY_ISRC_INVALID—No
MUSIC_DELIVERY_DEAL_TARGET_MISSING—No
MUSIC_DELIVERY_DEAL_WINDOW_INVALID—No
MUSIC_DELIVERY_VIDEO_USE_POLICY_AMBIGUOUS—No
MUSIC_DELIVERY_VIDEO_USE_INVALID—No
MUSIC_DELIVERY_IDEMPOTENCY_PAYLOAD_MISMATCH—No
MUSIC_DELIVERY_BATCH_NOT_FOUND—No
MUSIC_DELIVERY_CURSOR_INVALID—No
MUSIC_DELIVERY_PAGE_LIMIT_INVALID—No

Authentication and authorization

CodeHTTPDefault retry
MUSIC_DELIVERY_AUTH_INVALID—After credentials change
MUSIC_DELIVERY_SCOPE_REQUIRED—After credentials change
MUSIC_DELIVERY_ACCOUNT_SCOPE_VIOLATION—No
MUSIC_DELIVERY_SENDER_NOT_ACTIVE—After account action
MUSIC_DELIVERY_RATE_LIMITED—Yes

Partner publication evidence

CodeHTTPDefault retry
AGREEMENT_ACCEPTANCE_REQUIRED428After human action
PARTNER_AGREEMENT_ACCEPTANCE_REQUIRED428After human action
PARTNER_PAYMENT_ACKNOWLEDGEMENT_REQUIRED428After human action
DELIVERY_RIGHTS_ATTESTATION_REQUIRED428After declaration
DELIVERY_RIGHTS_ATTESTATION_INVALID400No
DELIVERY_ATTESTATION_MANIFEST_MISMATCH400No
DELIVERY_RIGHTS_SCOPE_INSUFFICIENT400No
MUSIC_DELIVERY_IDEMPOTENCY_EVIDENCE_MISMATCH409No
MUSIC_DELIVERY_ACCEPTED_EVIDENCE_REQUIRED409No
MUSIC_DELIVERY_DDEX_MAPPING_REQUIRED409After bilateral activation

Account quotas and capacity

CodeHTTPDefault retry
MUSIC_DELIVERY_QUOTA_MANIFEST_BYTES_EXCEEDED—No
MUSIC_DELIVERY_QUOTA_ITEMS_EXCEEDED—No
MUSIC_DELIVERY_QUOTA_BATCH_ASSET_BYTES_EXCEEDED—No
MUSIC_DELIVERY_QUOTA_STORAGE_BYTES_EXCEEDED—Yes, after capacity changes
MUSIC_DELIVERY_QUOTA_MASTER_BYTES_EXCEEDED—No
MUSIC_DELIVERY_QUOTA_CONCURRENT_UPLOADS_EXCEEDED—Yes
MUSIC_DELIVERY_QUOTA_ACTIVE_JOBS_EXCEEDED—Yes
MUSIC_DELIVERY_QUOTA_REQUEST_RATE_EXCEEDED—Yes
MUSIC_DELIVERY_QUOTA_WEBHOOK_DESTINATIONS_EXCEEDED—After configuration change
MUSIC_DELIVERY_QUOTA_PROCESSOR_BUDGET_EXCEEDED—Yes, after UTC window/capacity changes

Direct asset upload

CodeHTTPDefault retry
MUSIC_DELIVERY_ASSET_NOT_DECLARED—No
MUSIC_DELIVERY_ASSET_ROLE_AMBIGUOUS—No
MUSIC_DELIVERY_ASSET_CHECKSUM_INVALID—No
MUSIC_DELIVERY_ASSET_DECLARATION_MISMATCH—No
MUSIC_DELIVERY_ASSET_TOO_LARGE—No
MUSIC_DELIVERY_CATALOG_NOT_READY—After state change
MUSIC_DELIVERY_UPLOAD_INTENT_NOT_FOUND—No
MUSIC_DELIVERY_UPLOAD_INTENT_EXPIRED—After renewal
MUSIC_DELIVERY_UPLOAD_ALREADY_COMPLETED—No
MUSIC_DELIVERY_UPLOAD_OBJECT_NOT_FOUND—Yes
MUSIC_DELIVERY_UPLOAD_OBJECT_SCOPE_MISMATCH—No
MUSIC_DELIVERY_UPLOAD_SIZE_MISMATCH—No
MUSIC_DELIVERY_UPLOAD_CONTENT_TYPE_MISMATCH—No
MUSIC_DELIVERY_UPLOAD_CHECKSUM_MISMATCH—No
MUSIC_DELIVERY_UPLOAD_ETAG_MISSING—Yes

Audio, asset generations, and jobs

CodeHTTPDefault retry
PROCESSOR_FAILURE—According to job attempt
MUSIC_V2_ASSET_GENERATION_NOT_READY—After state change
MUSIC_V2_ASSET_GENERATION_CONFLICT—No
MUSIC_CATALOG_JOB_LEASE_MISMATCH—Yes, by a fresh claimant
MUSIC_CATALOG_JOB_RESULT_CONTEXT_MISMATCH—No
MAX_ATTEMPTS_EXHAUSTED—No automatic retry
MUSIC_DELIVERY_COORDINATOR_MANIFEST_INVALID—No
MUSIC_DELIVERY_COORDINATOR_CONTEXT_MISMATCH—No
MUSIC_DELIVERY_COORDINATOR_ITEM_MISSING—No

Rights and policy

CodeHTTPDefault retry
MUSIC_V2_RIGHTS_PROVENANCE_INVALID—No
MUSIC_V2_RIGHTS_SOURCE_REQUIRED—No
MUSIC_V2_RIGHTS_REVISION_EMPTY—No
MUSIC_V2_SOUND_NOT_LICENSED—After rights change
MUSIC_V2_SOUND_VIDEO_USE_DISABLED—After explicit policy change
MUSIC_V2_SOUND_POLICY_STALE—After grant renewal
MUSIC_V2_SOUND_SOURCE_POLICY_MISMATCH—After rebuild
MUSIC_V2_SOUND_SOURCE_NOT_READY—Yes
MUSIC_V2_SOUND_RANGE_INVALID—No
MUSIC_V2_SOUND_GRANT_NOT_CONSUMABLE—No

Publication blockers

CodeHTTPDefault retry
MUSIC_V2_PUBLICATION_AUTHORITY_MISSING—After rights change
MUSIC_V2_PUBLICATION_RIGHTS_CONFLICT—After rights review
MUSIC_V2_PUBLICATION_LISTENING_DEAL_MISSING—After deal change
MUSIC_V2_PUBLICATION_TERRITORY_EMPTY—After deal change
MUSIC_V2_PUBLICATION_RECORDING_NOT_READY—Yes
MUSIC_V2_PUBLICATION_ASSET_GENERATION_NOT_READY—Yes
MUSIC_V2_PUBLICATION_COVER_NOT_READY—Yes
MUSIC_V2_PUBLICATION_TRACKS_MISSING—No
MUSIC_V2_PUBLICATION_VIDEO_USE_UNDECIDED—After policy/channel correction
MUSIC_V2_PUBLICATION_VIDEO_USE_ASSET_NOT_READY—Yes
MUSIC_V2_RELEASE_REVISION_CONFLICT—No
MUSIC_V2_RELEASE_NOT_PROMOTABLE—After blocker resolution

Webhook delivery

CodeHTTPDefault retry
MUSIC_DELIVERY_WEBHOOK_NETWORK_ERROR—Yes
MUSIC_DELIVERY_WEBHOOK_CONNECT_TIMEOUT—Yes
MUSIC_DELIVERY_WEBHOOK_RESPONSE_TIMEOUT—Yes
MUSIC_DELIVERY_WEBHOOK_RESPONSE_TOO_LARGE—Yes
MUSIC_DELIVERY_WEBHOOK_RETRYABLE_STATUS—Yes
MUSIC_DELIVERY_WEBHOOK_SERVER_ERROR—Yes
MUSIC_DELIVERY_WEBHOOK_CLIENT_ERROR—No
MUSIC_DELIVERY_WEBHOOK_REDIRECT_FORBIDDEN—No
MUSIC_DELIVERY_WEBHOOK_URL_INVALID—No
MUSIC_DELIVERY_WEBHOOK_DESTINATION_INVALID—No
MUSIC_DELIVERY_WEBHOOK_SIGNING_KEY_INVALID—No
MUSIC_DELIVERY_WEBHOOK_SIGNING_KEY_DECRYPT_FAILED—No
MUSIC_DELIVERY_WEBHOOK_PAYLOAD_INVALID—No

Operations and reconciliation

CodeHTTPDefault retry
MUSIC_RECONCILIATION_PREFIX_INVALID—No
MUSIC_RECONCILIATION_CURSOR_INVALID—After reader fix/restart
MUSIC_RECONCILIATION_LIMIT_INVALID—No
MUSIC_RECONCILIATION_PAGE_LIMIT_EXCEEDED—After bounded reconfiguration
MUSIC_METRIC_NAME_INVALID—No
MUSIC_METRIC_LABELS_INVALID—No
MUSIC_METRIC_KIND_INVALID—No
MUSIC_METRIC_VALUE_INVALID—No
MUSIC_LOG_EVENT_INVALID—No
MUSIC_CATALOG_USAGE_EVENT_INVALID—No