docs: Improve Swagger JSDoc

server/api/controllers/access-tokens/exchange-with-oidc.js

@@ -11,6 +11,7 @@
  *     description: Exchanges an OIDC authorization code for an access token. Creates a user if they do not exist.
  *     tags:
  *       - Access Tokens
+ *     operationId: exchangeForAccessTokenWithOidc
  *     requestBody:
  *       required: true
  *       content:
@@ -49,6 +50,12 @@
  *                   type: string
  *                   description: Access token for API authentication
  *                   example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ4...
+ *         headers:
+ *           Set-Cookie:
+ *             description: HTTP-only authentication cookie (if withHttpOnlyToken is true)
+ *             schema:
+ *               type: string
+ *               example: httpOnlyToken=29aa3e38-8d24-4029-9743-9cbcf0a0dd5c; HttpOnly; Secure; SameSite=Strict
  *       400:
  *         $ref: '#/components/responses/ValidationError'
  *       401:
@@ -151,6 +158,7 @@
  *                   type: string
  *                   description: Error message
  *                   example: Invalid OIDC configuration
+ *     security: []
  */
 
 const { getRemoteAddress } = require('../../../utils/remote-address');