diff --git a/persistence-service-v1/persistence-service-external-api-v2/src/main/resources/api/redactmanager.yaml b/persistence-service-v1/persistence-service-external-api-v2/src/main/resources/api/redactmanager.yaml
index 30da534ed..135dde0ed 100644
--- a/persistence-service-v1/persistence-service-external-api-v2/src/main/resources/api/redactmanager.yaml
+++ b/persistence-service-v1/persistence-service-external-api-v2/src/main/resources/api/redactmanager.yaml
@@ -747,7 +747,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/DownloadStatusList'
-          description: TODO
+          description: List of all downloads of the current users successfully retrieved.
         "400":
           $ref: '#/components/responses/400'
         "401":
@@ -774,7 +774,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/DownloadStatus'
-          description: TODO
+          description: Status of the download successfully retrieved.
         "400":
           $ref: '#/components/responses/400'
         "401":
@@ -824,7 +824,7 @@ paths:
         - $ref: '#/components/parameters/downloadId'
       responses:
         "200": # TODO: complete response
-          description: TODO
+          description: Successfully downloading the file. (TODO rephrase?)
         "400":
           $ref: '#/components/responses/400'
         "401":
@@ -851,7 +851,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/UserList'
-          description: TODO
+          description: List of users successfully retrieved.
         "400":
           $ref: '#/components/responses/400'
         "401":
@@ -876,7 +876,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/User'
-          description: TODO
+          description: User successfully retrieved.
         "400":
           $ref: '#/components/responses/400'
         "401":
@@ -925,12 +925,6 @@ paths:
           $ref: '#/components/responses/500'
 components:
   headers:
-    X-Tenant-ID:
-      description: Tenant identifier, also known as the *Workspace ID* in the application.
-      required: true
-      schema:
-        type: string
-        example: 'my-workspace'
     Authorization:
       description: JWT token for authorization. Format should be `Bearer {JWT_TOKEN}`.
       required: true