diff --git a/src/api/public/apidocs-new/OBS-v2.10.50.yaml b/src/api/public/apidocs-new/OBS-v2.10.50.yaml index 14ec3d6ff04..1da4f7f9bc4 100644 --- a/src/api/public/apidocs-new/OBS-v2.10.50.yaml +++ b/src/api/public/apidocs-new/OBS-v2.10.50.yaml @@ -73,6 +73,8 @@ paths: $ref: 'paths/person_register.yaml' /person/{login}/token: $ref: 'paths/person_login_token.yaml' + /person/{login}/token/{id}: + $ref: 'paths/person_login_token_id.yaml' /request: $ref: 'paths/request.yaml' diff --git a/src/api/public/apidocs-new/paths/person_login_token_id.yaml b/src/api/public/apidocs-new/paths/person_login_token_id.yaml new file mode 100644 index 00000000000..0bc440bc33c --- /dev/null +++ b/src/api/public/apidocs-new/paths/person_login_token_id.yaml @@ -0,0 +1,53 @@ +delete: + summary: Delete a token of a person. + description: Delete a token of the specified person. + parameters: + - $ref: '../components/parameters/login.yaml' + - in: path + name: id + schema: + type: string + required: true + description: Id of the token to be removed. + example: 3 + responses: + '200': + description: | + OK. The request has succeeded. + + XML Schema used for body validation: [status.xsd](../schema/status.xsd) + content: + application/xml; charset=utf-8: + schema: + $ref: '../components/schemas/api_response.yaml' + example: + code: ok + summary: Ok + '401': + $ref: '../components/responses/unauthorized.yaml' + '403': + description: | + Forbidden. + + XML Schema used for body validation: [status.xsd](../schema/status.xsd) + content: + application/xml; charset=utf-8: + schema: + $ref: '../components/schemas/api_response.yaml' + example: + code: update_user_not_authorized + summary: 'You are not authorized to update this User.' + '404': + description: | + Not Found. + + XML Schema used for body validation: [status.xsd](../schema/status.xsd) + content: + application/xml; charset=utf-8: + schema: + $ref: '../components/schemas/api_response.yaml' + example: + code: not_found + summary: "Couldn't find Token with 'id'=33 [WHERE `tokens`.`user_id` = ?]" + tags: + - Person