MEmetorial
Skill Files

Delete skill file

Deletes the file at a path. Directories that were created automatically and become empty are removed. The root SKILL.md cannot be deleted.

delete/skills/{skill_id}/files

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Path parameters

skill_idstring required

Unique identifier of the skill.

Query parameters

pathstring required
Example:/SKILL.md

Path of the file inside the skill. A leading "/" is optional. Paths may contain letters, numbers, spaces and the characters . _ - ( ) $.

if_matchstring

Only apply the change if the file still has this etag. Omit to skip the check.

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Response

Successful response

object'skill.file_change' required

String representing the object's type

type'put' | 'delete' | 'move' required

The kind of change that was applied.

pathstring required

The resulting path of the file. For moves, this is the new path.

previous_pathstring nullable required

The path the file was moved from. Only set for moves.

Example response

{
  "file": {
    "path": "/SKILL.md"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.