Browse Source

Add docs

tags/v1.1.4
Maxim Filippov 5 years ago
parent
commit
08c6aeeed7
1 changed files with 31 additions and 18 deletions
  1. +31
    -18
      docs/Admin-API.md

+ 31
- 18
docs/Admin-API.md View File

@@ -7,20 +7,27 @@ Authentication is required and the user must be an admin.
### List users

- Method `GET`
- Params:
- `page`: **integer** page number
- `page_size`: **integer** number of users per page (default is `50`)
- Response:

```JSON
[
{
"page_size": integer,
"count": integer,
"users": [
{
"deactivated": bool,
"id": integer,
"nickname": string
"deactivated": bool,
"id": integer,
"nickname": string
},
...
]
]
}
```

## `/api/pleroma/admin/users/search?query={query}&local={local}`
## `/api/pleroma/admin/users/search?query={query}&local={local}&page={page}&page_size={page_size}`

### Search users by name or nickname

@@ -28,17 +35,23 @@ Authentication is required and the user must be an admin.
- Params:
- `query`: **string** search term
- `local`: **bool** whether to return only local users
- `page`: **integer** page number
- `page_size`: **integer** number of users per page (default is `50`)
- Response:

```JSON
[
{
"page_size": integer,
"count": integer,
"users": [
{
"deactivated": bool,
"id": integer,
"nickname": string
"deactivated": bool,
"id": integer,
"nickname": string
},
...
]
]
}
```

## `/api/pleroma/admin/user`
@@ -70,9 +83,9 @@ Authentication is required and the user must be an admin.

```JSON
{
"deactivated": bool,
"id": integer,
"nickname": string
"deactivated": bool,
"id": integer,
"nickname": string
}
```

@@ -102,8 +115,8 @@ Authentication is required and the user must be an admin.

```JSON
{
"is_moderator": bool,
"is_admin": bool
"is_moderator": bool,
"is_admin": bool
}
```

@@ -119,8 +132,8 @@ Note: Available `:permission_group` is currently moderator and admin. 404 is ret

```JSON
{
"is_moderator": bool,
"is_admin": bool
"is_moderator": bool,
"is_admin": bool
}
```



Loading…
Cancel
Save