Delete All Assets from Segment

Deletes all assets attached to a specific segment. All asset files are permanently removed from the project's reference material folder.

URL

(DELETE) /api/resources/assets/{segmentid}

PARAMETERS

Parameter	Type	Required	Description
segmentid (URL)	int	Mandatory	The unique segment identifier to delete all assets from
scope (Query)	string	Mandatory	The scope parameter that defines the project or job context. Formats: `pr{projectid}` (e.g., `pr7214`), `jbs{jobid}` for standard jobs, `jbc{jobid}` for Codyt jobs

ACCESS RIGHTS

The user must have access rights to the project's reference material with delete permissions. The system checks project-level permissions to ensure the user can delete assets from the specified scope.

EXAMPLE REQUEST

CODE

curl --location --request DELETE '{{URL}}/api/resources/assets/27665601?scope=pr7214' \
--header 'X-Auth-Token: {{AUTH_TOKEN}}' \
--header 'X-Auth-AccountId: {{ACCOUNT_ID}}'

RESULTS

The response returns an HTTP status code without a response body:

Status Code	Description
200 OK	All assets successfully deleted from the segment

Response Body: Empty

USAGE NOTES

All assets in the segment are permanently deleted and cannot be recovered
This includes assets in all locales (language-specific subfolders)
The entire asset folder structure for the segment is removed
If no assets exist in the segment, the operation still returns 200 OK (idempotent behavior)
All references to the deleted assets (such as cached download URLs) become invalid
This operation is irreversible - use with caution

ENDPOINT VARIATIONS

The same endpoint supports two deletion modes based on the presence of the filename parameter:

Parameters	Action
`scope` only	Delete all assets from the segment
`scope` + `filename` (+ optional `locale`)	Delete specific asset from the segment