Delete a bundled file

Delete a bundled file from a skill. Removes the file from both cloud storage and the database.

Note: SKILL.md cannot be deleted via this endpoint — use PUT /skills/manage to replace it.

DELETE /skills/files

Delete a bundled file

cURL

curl --request DELETE \
  --url https://asteragents.com/api/skills/files \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "message": "<string>"
}

Authorizations

Authorization · string · header · required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Query Parameters

fileId · integer · required

The file ID to delete (the database record ID, not the UUID)

Response

200

application/json

File deleted successfully

success · boolean

message · string