nginx-proxy-manager-zh/backend/schema/paths/users/post.json
Jamie Curnow 4572b205c9
Openapi Schema improvements
- Return proper booleans in api responses
- Update jsonschemavalidation to latest draft
2024-10-10 15:53:11 +10:00

89 lines
2.1 KiB
JSON

{
"operationId": "createUser",
"summary": "Create a User",
"tags": ["Users"],
"security": [
{
"BearerAuth": ["users"]
}
],
"requestBody": {
"description": "User Payload",
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": false,
"required": ["name", "nickname", "email"],
"properties": {
"name": {
"$ref": "../../components/user-object.json#/properties/name"
},
"nickname": {
"$ref": "../../components/user-object.json#/properties/nickname"
},
"email": {
"$ref": "../../components/user-object.json#/properties/email"
},
"roles": {
"$ref": "../../components/user-object.json#/properties/roles"
},
"is_disabled": {
"$ref": "../../components/user-object.json#/properties/is_disabled"
},
"auth": {
"type": "object",
"description": "Auth Credentials",
"example": {
"type": "password",
"secret": "bigredhorsebanana"
}
}
}
}
}
}
},
"responses": {
"201": {
"description": "201 response",
"content": {
"application/json": {
"examples": {
"default": {
"value": {
"id": 2,
"created_on": "2020-01-30T09:41:04.000Z",
"modified_on": "2020-01-30T09:41:04.000Z",
"is_disabled": false,
"email": "jc@jc21.com",
"name": "Jamie Curnow",
"nickname": "James",
"avatar": "//www.gravatar.com/avatar/6193176330f8d38747f038c170ddb193?default=mm",
"roles": ["admin"],
"permissions": {
"id": 3,
"created_on": "2020-01-30T09:41:04.000Z",
"modified_on": "2020-01-30T09:41:04.000Z",
"user_id": 2,
"visibility": "user",
"proxy_hosts": "manage",
"redirection_hosts": "manage",
"dead_hosts": "manage",
"streams": "manage",
"access_lists": "manage",
"certificates": "manage"
}
}
}
},
"schema": {
"$ref": "../../components/user-object.json"
}
}
}
}
}
}