---
search:
  tags:
    - Sessions
    - DELETE
seo:
  description: >-
    Drop files from a session, in one transaction for the request. Reference for
    the DELETE /v1/sessions/id/{session_id}/files endpoint in the Roboto REST
    API.
sidebar:
  label: Remove files
  badge: DELETE
title: Remove files
type: openapi-operation
---
Drop files from a session, in one transaction for the request.

Answers 200 once the request has been processed: the response carries one element per named file, in request
order, holding the file's id when the session held it and a not-found error when it did not, and every file the
session held is removed. A malformed request answers 400 before any removal runs. A session deleted after the
request loaded it answers 404, and a failure the platform did not anticipate, such as the request's deadline,
fails the request; either way none of the files is removed.

A client on an API version before 2026-10-05 receives the session's record, and a file the session does not
hold is skipped.

### Access control
 - Restricted tokens need the API scope `api.everything_else`

`DELETE /v1/sessions/id/{session_id}/files`