mirror of
				https://github.com/NginxProxyManager/nginx-proxy-manager.git
				synced 2025-11-03 17:13:33 +00:00 
			
		
		
		
	Moved v3 code from NginxProxyManager/nginx-proxy-manager-3 to NginxProxyManager/nginx-proxy-manager
This commit is contained in:
		
							
								
								
									
										65
									
								
								backend/embed/api_docs/paths/users/userID/auth/post.json
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										65
									
								
								backend/embed/api_docs/paths/users/userID/auth/post.json
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,65 @@
 | 
			
		||||
{
 | 
			
		||||
	"operationId": "setPassword",
 | 
			
		||||
	"summary": "Set a User's password",
 | 
			
		||||
	"tags": ["Users"],
 | 
			
		||||
	"parameters": [
 | 
			
		||||
		{
 | 
			
		||||
			"in": "path",
 | 
			
		||||
			"name": "userID",
 | 
			
		||||
			"schema": {
 | 
			
		||||
				"oneOf": [
 | 
			
		||||
					{
 | 
			
		||||
						"type": "integer",
 | 
			
		||||
						"minimum": 1
 | 
			
		||||
					},
 | 
			
		||||
					{
 | 
			
		||||
						"type": "string",
 | 
			
		||||
						"pattern": "^me$"
 | 
			
		||||
					}
 | 
			
		||||
				]
 | 
			
		||||
			},
 | 
			
		||||
			"required": true,
 | 
			
		||||
			"description": "Numeric ID of the user or 'me' to set yourself",
 | 
			
		||||
			"example": 1
 | 
			
		||||
		}
 | 
			
		||||
	],
 | 
			
		||||
	"requestBody": {
 | 
			
		||||
		"description": "Credentials to set",
 | 
			
		||||
		"required": true,
 | 
			
		||||
		"content": {
 | 
			
		||||
			"application/json": {
 | 
			
		||||
				"schema": "{{schema.SetAuth}}"
 | 
			
		||||
			}
 | 
			
		||||
		}
 | 
			
		||||
	},
 | 
			
		||||
	"responses": {
 | 
			
		||||
		"200": {
 | 
			
		||||
			"description": "200 response",
 | 
			
		||||
			"content": {
 | 
			
		||||
				"application/json": {
 | 
			
		||||
					"schema": {
 | 
			
		||||
						"required": ["result"],
 | 
			
		||||
						"properties": {
 | 
			
		||||
							"result": {
 | 
			
		||||
								"$ref": "#/components/schemas/UserAuthObject"
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					},
 | 
			
		||||
					"examples": {
 | 
			
		||||
						"default": {
 | 
			
		||||
							"value": {
 | 
			
		||||
								"result": {
 | 
			
		||||
									"id": 2,
 | 
			
		||||
									"user_id": 3,
 | 
			
		||||
									"type": "password",
 | 
			
		||||
									"created_on": 1648422222,
 | 
			
		||||
									"modified_on": 1648423979
 | 
			
		||||
								}
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					}
 | 
			
		||||
				}
 | 
			
		||||
			}
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										60
									
								
								backend/embed/api_docs/paths/users/userID/delete.json
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										60
									
								
								backend/embed/api_docs/paths/users/userID/delete.json
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,60 @@
 | 
			
		||||
{
 | 
			
		||||
	"operationId": "deleteUser",
 | 
			
		||||
	"summary": "Delete a User",
 | 
			
		||||
	"tags": [
 | 
			
		||||
		"Users"
 | 
			
		||||
	],
 | 
			
		||||
	"parameters": [
 | 
			
		||||
		{
 | 
			
		||||
			"in": "path",
 | 
			
		||||
			"name": "userID",
 | 
			
		||||
			"schema": {
 | 
			
		||||
				"type": "integer",
 | 
			
		||||
				"minimum": 1
 | 
			
		||||
			},
 | 
			
		||||
			"required": true,
 | 
			
		||||
			"description": "Numeric ID of the user",
 | 
			
		||||
			"example": 1
 | 
			
		||||
		}
 | 
			
		||||
	],
 | 
			
		||||
	"responses": {
 | 
			
		||||
		"200": {
 | 
			
		||||
			"description": "200 response",
 | 
			
		||||
			"content": {
 | 
			
		||||
				"application/json": {
 | 
			
		||||
					"schema": {
 | 
			
		||||
						"$ref": "#/components/schemas/DeletedItemResponse"
 | 
			
		||||
					},
 | 
			
		||||
					"examples": {
 | 
			
		||||
						"default": {
 | 
			
		||||
							"value": {
 | 
			
		||||
								"result": true
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					}
 | 
			
		||||
				}
 | 
			
		||||
			}
 | 
			
		||||
		},
 | 
			
		||||
		"400": {
 | 
			
		||||
			"description": "400 response",
 | 
			
		||||
			"content": {
 | 
			
		||||
				"application/json": {
 | 
			
		||||
					"schema": {
 | 
			
		||||
						"$ref": "#/components/schemas/DeletedItemResponse"
 | 
			
		||||
					},
 | 
			
		||||
					"examples": {
 | 
			
		||||
						"default": {
 | 
			
		||||
							"value": {
 | 
			
		||||
								"result": null,
 | 
			
		||||
								"error": {
 | 
			
		||||
									"code": 400,
 | 
			
		||||
									"message": "You cannot delete yourself!"
 | 
			
		||||
								}
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					}
 | 
			
		||||
				}
 | 
			
		||||
			}
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										60
									
								
								backend/embed/api_docs/paths/users/userID/get.json
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										60
									
								
								backend/embed/api_docs/paths/users/userID/get.json
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,60 @@
 | 
			
		||||
{
 | 
			
		||||
	"operationId": "getUser",
 | 
			
		||||
	"summary": "Get a user object by ID or 'me'",
 | 
			
		||||
	"tags": ["Users"],
 | 
			
		||||
	"parameters": [
 | 
			
		||||
		{
 | 
			
		||||
			"in": "path",
 | 
			
		||||
			"name": "userID",
 | 
			
		||||
			"schema": {
 | 
			
		||||
				"anyOf": [
 | 
			
		||||
					{
 | 
			
		||||
						"type": "integer",
 | 
			
		||||
						"minimum": 1
 | 
			
		||||
					},
 | 
			
		||||
					{
 | 
			
		||||
						"type": "string",
 | 
			
		||||
						"pattern": "^me$"
 | 
			
		||||
					}
 | 
			
		||||
				]
 | 
			
		||||
			},
 | 
			
		||||
			"required": true,
 | 
			
		||||
			"description": "Numeric ID of the user or 'me' to get yourself",
 | 
			
		||||
			"example": 1
 | 
			
		||||
		}
 | 
			
		||||
	],
 | 
			
		||||
	"responses": {
 | 
			
		||||
		"200": {
 | 
			
		||||
			"description": "200 response",
 | 
			
		||||
			"content": {
 | 
			
		||||
				"application/json": {
 | 
			
		||||
					"schema": {
 | 
			
		||||
						"required": ["result"],
 | 
			
		||||
						"properties": {
 | 
			
		||||
							"result": {
 | 
			
		||||
								"$ref": "#/components/schemas/UserObject"
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					},
 | 
			
		||||
					"examples": {
 | 
			
		||||
						"default": {
 | 
			
		||||
							"value": {
 | 
			
		||||
								"result": {
 | 
			
		||||
									"id": 1,
 | 
			
		||||
									"name": "Jamie Curnow",
 | 
			
		||||
									"nickname": "James",
 | 
			
		||||
									"email": "jc@jc21.com",
 | 
			
		||||
									"created_on": 1578010100,
 | 
			
		||||
									"modified_on": 1578010105,
 | 
			
		||||
									"gravatar_url": "https://www.gravatar.com/avatar/6193176330f8d38747f038c170ddb193?d=mm&r=pg&s=128",
 | 
			
		||||
									"is_disabled": false,
 | 
			
		||||
									"capabilities": ["full-admin"]
 | 
			
		||||
								}
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					}
 | 
			
		||||
				}
 | 
			
		||||
			}
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										107
									
								
								backend/embed/api_docs/paths/users/userID/put.json
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										107
									
								
								backend/embed/api_docs/paths/users/userID/put.json
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,107 @@
 | 
			
		||||
{
 | 
			
		||||
	"operationId": "updateUser",
 | 
			
		||||
	"summary": "Update an existing User",
 | 
			
		||||
	"tags": ["Users"],
 | 
			
		||||
	"parameters": [
 | 
			
		||||
		{
 | 
			
		||||
			"in": "path",
 | 
			
		||||
			"name": "userID",
 | 
			
		||||
			"schema": {
 | 
			
		||||
				"anyOf": [
 | 
			
		||||
					{
 | 
			
		||||
						"type": "integer",
 | 
			
		||||
						"minimum": 1
 | 
			
		||||
					},
 | 
			
		||||
					{
 | 
			
		||||
						"type": "string",
 | 
			
		||||
						"pattern": "^me$"
 | 
			
		||||
					}
 | 
			
		||||
				]
 | 
			
		||||
			},
 | 
			
		||||
			"required": true,
 | 
			
		||||
			"description": "Numeric ID of the user or 'me' to update yourself",
 | 
			
		||||
			"example": 1
 | 
			
		||||
		}
 | 
			
		||||
	],
 | 
			
		||||
	"requestBody": {
 | 
			
		||||
		"description": "User details to update",
 | 
			
		||||
		"required": true,
 | 
			
		||||
		"content": {
 | 
			
		||||
			"application/json": {
 | 
			
		||||
				"schema": "{{schema.UpdateUser}}"
 | 
			
		||||
			}
 | 
			
		||||
		}
 | 
			
		||||
	},
 | 
			
		||||
	"responses": {
 | 
			
		||||
		"200": {
 | 
			
		||||
			"description": "200 response",
 | 
			
		||||
			"content": {
 | 
			
		||||
				"application/json": {
 | 
			
		||||
					"schema": {
 | 
			
		||||
						"required": ["result"],
 | 
			
		||||
						"properties": {
 | 
			
		||||
							"result": {
 | 
			
		||||
								"$ref": "#/components/schemas/UserObject"
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					},
 | 
			
		||||
					"examples": {
 | 
			
		||||
						"default": {
 | 
			
		||||
							"value": {
 | 
			
		||||
								"result": {
 | 
			
		||||
									"id": 1,
 | 
			
		||||
									"name": "Jamie Curnow",
 | 
			
		||||
									"nickname": "James",
 | 
			
		||||
									"email": "jc@jc21.com",
 | 
			
		||||
									"created_on": 1578010100,
 | 
			
		||||
									"modified_on": 1578010110,
 | 
			
		||||
									"gravatar_url": "https://www.gravatar.com/avatar/6193176330f8d38747f038c170ddb193?d=mm&r=pg&s=128",
 | 
			
		||||
									"is_disabled": false,
 | 
			
		||||
									"capabilities": ["full-admin"]
 | 
			
		||||
								}
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					}
 | 
			
		||||
				}
 | 
			
		||||
			}
 | 
			
		||||
		},
 | 
			
		||||
		"400": {
 | 
			
		||||
			"description": "400 response",
 | 
			
		||||
			"content": {
 | 
			
		||||
				"application/json": {
 | 
			
		||||
					"schema": {
 | 
			
		||||
						"required": ["error"],
 | 
			
		||||
						"properties": {
 | 
			
		||||
							"result": {
 | 
			
		||||
								"nullable": true
 | 
			
		||||
							},
 | 
			
		||||
							"error": {
 | 
			
		||||
								"$ref": "#/components/schemas/ErrorObject"
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					},
 | 
			
		||||
					"examples": {
 | 
			
		||||
						"duplicateemail": {
 | 
			
		||||
							"value": {
 | 
			
		||||
								"result": null,
 | 
			
		||||
								"error": {
 | 
			
		||||
									"code": 400,
 | 
			
		||||
									"message": "A user already exists with this email address"
 | 
			
		||||
								}
 | 
			
		||||
							}
 | 
			
		||||
						},
 | 
			
		||||
						"nodisable": {
 | 
			
		||||
							"value": {
 | 
			
		||||
								"result": null,
 | 
			
		||||
								"error": {
 | 
			
		||||
									"code": 400,
 | 
			
		||||
									"message": "You cannot disable yourself!"
 | 
			
		||||
								}
 | 
			
		||||
							}
 | 
			
		||||
						}
 | 
			
		||||
					}
 | 
			
		||||
				}
 | 
			
		||||
			}
 | 
			
		||||
		}
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
		Reference in New Issue
	
	Block a user