Skip to main content
DELETE
Delete one motion asset
DELETE /v1/motions/{motion_id} permanently deletes a Motion. It can no longer be used in a Render. Returns 404 when the Motion does not exist or belongs to another account — the two cases are deliberately indistinguishable.

Request parameters

Response parameters

Returns 200 OK.

Examples

Authorizations

Authorization
string
header
required

Server-side SDK clients use a project API key. Remote MCP clients use an OAuth access token. Never expose a project API key in browser code.

Headers

X-Request-Id
string

Optional caller-supplied correlation ID, up to 128 characters. The service returns the effective value in the response header for tracing and support.

Required string length: 1 - 128
X-Viggle-Source
string

Optional source-channel label, up to 128 characters, used to attribute traffic to an SDK, integration, product surface, or internal workflow.

Required string length: 1 - 128

Path Parameters

motion_id
string
required

Public Motion ID returned by motion creation or listing. It normally begins with mot_ and must identify a Motion owned by the caller.

Minimum string length: 1

Response

The motion was deleted.

status
enum<string>
required

Deletion acknowledgement. The only successful value is deleted.

Available options:
deleted