Files

Delete an unused source file

Delete an uploaded source file before it has been attached to a quote or project.

DELETE/files/{fileId}

API key permission: files:write. Send a unique Idempotency-Key and reuse it only when retrying the same request.

Parameters

NameTypeDescription

fileIdstring · required

path parameter

Idempotency-Keystring · required

Unique operation key. Reuse it only with the same method, path, and request body.

Standard response headers

HeaderExampleDescription

Stepes-Request-Idb09de4aa-3874-4991-b85c-0bc86e780511

Server-generated request identifier for support and audit correlation.

Stepes-API-Version2.0.0

Effective Stepes API semantic version.

RateLimit-Policy120;w=60

Effective request limit and window for the authenticated key.

RateLimitlimit=120, remaining=119, reset=60

Current limit, remaining requests, and reset interval.

Idempotency-Replayedtrue

Present with value true when a stored mutation response is replayed.

Responses

204

File deleted

404

Resource was not found or is not available to this API key

409

Idempotency conflict or invalid lifecycle transition

422

Request validation failed

Request example

Production

curl --request DELETE \
  --url https://apis.stepes.com/v2/files/{fileId} \
  --header 'Authorization: Bearer stp_live_<your-api-key>' \
  --header 'Idempotency-Key: <unique-operation-key>'

Copy this example and replace the placeholder values with your own.

For security, this documentation site never sends requests using your API key.