Delete Resource

DELETE/api/v2/filesystem/resources/{resourceRid}

Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Move the given resource to the trash. Following this operation, the resource can be restored, using the restore operation, or permanently deleted using the permanentlyDelete operation.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:filesystem-write.

Path parameters

resourceRid

string

The unique resource identifier (RID) of a Resource.

Query parameters

preview

boolean

optional

Enables the use of preview functionality.

Examples

Request

Copied!

curl -X DELETE \
	-H "Authorization: Bearer $TOKEN" \
	"https://$HOSTNAME/api/v2/filesystem/resources/ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da?preview=true"

Error responses

Error Name
`DeleteResourcePermissionDenied`	Error Code	`PERMISSION_DENIED`
	Status Code	403
	Description	Could not delete the Resource.
	Parameters	`resourceRid`

See Errors for a general overview of errors in the platform.