Skip to content

Commit

Permalink
docs-util: add exceptions for routes with custom auth middleware
Browse files Browse the repository at this point in the history
  • Loading branch information
shahednasser committed Mar 6, 2025
1 parent ecc3deb commit f266eb0
Show file tree
Hide file tree
Showing 20 changed files with 228 additions and 58 deletions.
60 changes: 49 additions & 11 deletions www/apps/api-reference/specs/admin/openapi.full.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -17443,7 +17443,7 @@ paths:
operationId: GetInvites
summary: List Invites
description: Retrieve a list of invites. The invites can be filtered by fields such as `id`. The invites can also be sorted or paginated.
x-authenticated: false
x-authenticated: true
parameters:
- name: fields
in: query
Expand Down Expand Up @@ -17950,11 +17950,15 @@ paths:
$ref: '#/components/responses/invalid_request_error'
'500':
$ref: '#/components/responses/500_error'
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
post:
operationId: PostInvites
summary: Create Invite
description: Create a invite.
x-authenticated: false
x-authenticated: true
parameters:
- name: fields
in: query
Expand Down Expand Up @@ -18014,14 +18018,18 @@ paths:
'500':
$ref: '#/components/responses/500_error'
x-workflow: createInvitesWorkflow
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
/admin/invites/accept:
post:
operationId: PostInvitesAccept
summary: Accept Invite
description: |
Accept an invite and create a new user.
Since the user isn't created yet, the JWT token used in the authorization header is retrieved from the `/auth/user/emailpass/register` API route (or a provider other than `emailpass`). The user can then authenticate using the `/auth/user/emailpass` API route.
x-authenticated: false
x-authenticated: true
requestBody:
content:
application/json:
Expand Down Expand Up @@ -18091,12 +18099,15 @@ paths:
'500':
$ref: '#/components/responses/500_error'
x-workflow: acceptInviteWorkflow
security:
- cookie_auth: []
- jwt_token: []
/admin/invites/{id}:
get:
operationId: GetInvitesId
summary: Get an Invite
description: Retrieve an invite by its ID. You can expand the invite's relations or select the fields that should be returned.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -18139,11 +18150,15 @@ paths:
$ref: '#/components/responses/invalid_request_error'
'500':
$ref: '#/components/responses/500_error'
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
delete:
operationId: DeleteInvitesId
summary: Delete Invite
description: Delete an invite.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -18196,12 +18211,16 @@ paths:
'500':
$ref: '#/components/responses/500_error'
x-workflow: deleteInvitesWorkflow
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
/admin/invites/{id}/resend:
post:
operationId: PostInvitesIdResend
summary: Refresh Invite Token
description: Refresh the token of an invite.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -18245,6 +18264,10 @@ paths:
'500':
$ref: '#/components/responses/500_error'
x-workflow: refreshInviteTokensWorkflow
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
/admin/notifications:
get:
operationId: GetNotifications
Expand Down Expand Up @@ -41910,7 +41933,7 @@ paths:
operationId: GetUsers
summary: List Users
description: Retrieve a list of users. The users can be filtered by fields such as `id`. The users can also be sorted or paginated.
x-authenticated: false
x-authenticated: true
parameters:
- name: fields
in: query
Expand Down Expand Up @@ -42379,12 +42402,15 @@ paths:
$ref: '#/components/responses/invalid_request_error'
'500':
$ref: '#/components/responses/500_error'
security:
- cookie_auth: []
- jwt_token: []
/admin/users/me:
get:
operationId: GetUsersMe
summary: Get Logged-In User
description: Retrieve the logged-in user's details.
x-authenticated: false
x-authenticated: true
parameters:
- name: fields
in: query
Expand Down Expand Up @@ -42421,12 +42447,15 @@ paths:
$ref: '#/components/responses/invalid_request_error'
'500':
$ref: '#/components/responses/500_error'
security:
- cookie_auth: []
- jwt_token: []
/admin/users/{id}:
get:
operationId: GetUsersId
summary: Get a User
description: Retrieve a user by its ID. You can expand the user's relations or select the fields that should be returned.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -42469,11 +42498,14 @@ paths:
$ref: '#/components/responses/invalid_request_error'
'500':
$ref: '#/components/responses/500_error'
security:
- cookie_auth: []
- jwt_token: []
post:
operationId: PostUsersId
summary: Update a User
description: Update a user's details.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -42529,11 +42561,14 @@ paths:
'500':
$ref: '#/components/responses/500_error'
x-workflow: updateUsersWorkflow
security:
- cookie_auth: []
- jwt_token: []
delete:
operationId: DeleteUsersId
summary: Delete a User
description: Delete a user.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -42567,6 +42602,9 @@ paths:
'500':
$ref: '#/components/responses/500_error'
x-workflow: removeUserAccountWorkflow
security:
- cookie_auth: []
- jwt_token: []
/admin/workflows-executions:
get:
operationId: GetWorkflowsExecutions
Expand Down
12 changes: 10 additions & 2 deletions www/apps/api-reference/specs/admin/paths/admin_invites.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ get:
description: >-
Retrieve a list of invites. The invites can be filtered by fields such as
`id`. The invites can also be sorted or paginated.
x-authenticated: false
x-authenticated: true
parameters:
- name: fields
in: query
Expand Down Expand Up @@ -589,11 +589,15 @@ get:
$ref: ../components/responses/invalid_request_error.yaml
'500':
$ref: ../components/responses/500_error.yaml
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
post:
operationId: PostInvites
summary: Create Invite
description: Create a invite.
x-authenticated: false
x-authenticated: true
parameters:
- name: fields
in: query
Expand Down Expand Up @@ -657,3 +661,7 @@ post:
'500':
$ref: ../components/responses/500_error.yaml
x-workflow: createInvitesWorkflow
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ post:
header is retrieved from the `/auth/user/emailpass/register` API route (or a
provider other than `emailpass`). The user can then authenticate using the
`/auth/user/emailpass` API route.
x-authenticated: false
x-authenticated: true
requestBody:
content:
application/json:
Expand Down Expand Up @@ -72,3 +72,6 @@ post:
'500':
$ref: ../components/responses/500_error.yaml
x-workflow: acceptInviteWorkflow
security:
- cookie_auth: []
- jwt_token: []
12 changes: 10 additions & 2 deletions www/apps/api-reference/specs/admin/paths/admin_invites_{id}.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ get:
description: >-
Retrieve an invite by its ID. You can expand the invite's relations or
select the fields that should be returned.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -56,11 +56,15 @@ get:
$ref: ../components/responses/invalid_request_error.yaml
'500':
$ref: ../components/responses/500_error.yaml
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
delete:
operationId: DeleteInvitesId
summary: Delete Invite
description: Delete an invite.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -114,3 +118,7 @@ delete:
'500':
$ref: ../components/responses/500_error.yaml
x-workflow: deleteInvitesWorkflow
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ post:
operationId: PostInvitesIdResend
summary: Refresh Invite Token
description: Refresh the token of an invite.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -55,3 +55,7 @@ post:
'500':
$ref: ../components/responses/500_error.yaml
x-workflow: refreshInviteTokensWorkflow
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
5 changes: 4 additions & 1 deletion www/apps/api-reference/specs/admin/paths/admin_users.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ get:
description: >-
Retrieve a list of users. The users can be filtered by fields such as `id`.
The users can also be sorted or paginated.
x-authenticated: false
x-authenticated: true
parameters:
- name: fields
in: query
Expand Down Expand Up @@ -547,3 +547,6 @@ get:
$ref: ../components/responses/invalid_request_error.yaml
'500':
$ref: ../components/responses/500_error.yaml
security:
- cookie_auth: []
- jwt_token: []
5 changes: 4 additions & 1 deletion www/apps/api-reference/specs/admin/paths/admin_users_me.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ get:
operationId: GetUsersMe
summary: Get Logged-In User
description: Retrieve the logged-in user's details.
x-authenticated: false
x-authenticated: true
parameters:
- name: fields
in: query
Expand Down Expand Up @@ -48,3 +48,6 @@ get:
$ref: ../components/responses/invalid_request_error.yaml
'500':
$ref: ../components/responses/500_error.yaml
security:
- cookie_auth: []
- jwt_token: []
15 changes: 12 additions & 3 deletions www/apps/api-reference/specs/admin/paths/admin_users_{id}.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ get:
description: >-
Retrieve a user by its ID. You can expand the user's relations or select the
fields that should be returned.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -56,11 +56,14 @@ get:
$ref: ../components/responses/invalid_request_error.yaml
'500':
$ref: ../components/responses/500_error.yaml
security:
- cookie_auth: []
- jwt_token: []
post:
operationId: PostUsersId
summary: Update a User
description: Update a user's details.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -118,11 +121,14 @@ post:
'500':
$ref: ../components/responses/500_error.yaml
x-workflow: updateUsersWorkflow
security:
- cookie_auth: []
- jwt_token: []
delete:
operationId: DeleteUsersId
summary: Delete a User
description: Delete a user.
x-authenticated: false
x-authenticated: true
parameters:
- name: id
in: path
Expand Down Expand Up @@ -157,3 +163,6 @@ delete:
'500':
$ref: ../components/responses/500_error.yaml
x-workflow: removeUserAccountWorkflow
security:
- cookie_auth: []
- jwt_token: []
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
* operationId: DeleteInvitesId
* summary: Delete Invite
* description: Delete an invite.
* x-authenticated: false
* x-authenticated: true
* parameters:
* - name: id
* in: path
Expand Down Expand Up @@ -56,6 +56,10 @@
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: deleteInvitesWorkflow
* security:
* - api_token: []
* - cookie_auth: []
* - jwt_token: []
*
*/

Loading

0 comments on commit f266eb0

Please sign in to comment.