Grapes Knowledge Base Users Controllers API
The UsersControllers API from Grapes Knowledge Base — 3 operation(s) for userscontrollers.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/grapes-knowledge-base:grapes-knowledge-base-userscontrollers-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Grapes Users Controllers API
version: v1
security:
- Bearer: []
tags:
- name: UsersControllers
paths:
/api/{version}/organizations/{orgId}/users:
get:
tags:
- UsersControllers
operationId: GetUsers
parameters:
- name: orgId
in: path
required: true
schema:
type: string
- name: searchQuery
in: query
schema:
type: string
- name: Skip
in: query
schema:
type: integer
format: int32
- name: Take
in: query
schema:
type: integer
format: int32
- name: version
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
text/plain:
schema:
$ref: '#/components/schemas/UserDtoListItemResponse'
application/json:
schema:
$ref: '#/components/schemas/UserDtoListItemResponse'
text/json:
schema:
$ref: '#/components/schemas/UserDtoListItemResponse'
summary: Get users
x-summary-source: derived
/api/{version}/organizations/{orgId}/users/{id}:
get:
tags:
- UsersControllers
operationId: GetUserById
parameters:
- name: orgId
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
- name: version
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
text/plain:
schema:
$ref: '#/components/schemas/UserDtoItemResponse'
application/json:
schema:
$ref: '#/components/schemas/UserDtoItemResponse'
text/json:
schema:
$ref: '#/components/schemas/UserDtoItemResponse'
'404':
description: User not found
summary: Get user by id
x-summary-source: derived
put:
tags:
- UsersControllers
operationId: UpdateUser
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: orgId
in: path
required: true
schema:
type: string
- name: version
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateUserRequest'
text/json:
schema:
$ref: '#/components/schemas/UpdateUserRequest'
application/*+json:
schema:
$ref: '#/components/schemas/UpdateUserRequest'
responses:
'200':
description: OK
content:
text/plain:
schema:
$ref: '#/components/schemas/UserDtoItemResponse'
application/json:
schema:
$ref: '#/components/schemas/UserDtoItemResponse'
text/json:
schema:
$ref: '#/components/schemas/UserDtoItemResponse'
'400':
description: Validation failed
'404':
description: User not found
summary: Update user
x-summary-source: derived
/api/{version}/organizations/{orgId}/users/{id}/privileges:
get:
tags:
- UsersControllers
operationId: GetUserPrivileges
parameters:
- name: orgId
in: path
required: true
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
- name: version
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
text/plain:
schema:
$ref: '#/components/schemas/UserPrivilegesDtoItemResponse'
application/json:
schema:
$ref: '#/components/schemas/UserPrivilegesDtoItemResponse'
text/json:
schema:
$ref: '#/components/schemas/UserPrivilegesDtoItemResponse'
'404':
description: User not found
summary: Get user privileges
x-summary-source: derived
post:
tags:
- UsersControllers
operationId: UpdateUserPrevileges
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: orgId
in: path
required: true
schema:
type: string
- name: version
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateUserPrivilegesRequest'
text/json:
schema:
$ref: '#/components/schemas/UpdateUserPrivilegesRequest'
application/*+json:
schema:
$ref: '#/components/schemas/UpdateUserPrivilegesRequest'
responses:
'200':
description: OK
content:
text/plain:
schema:
$ref: '#/components/schemas/IActionResult'
application/json:
schema:
$ref: '#/components/schemas/IActionResult'
text/json:
schema:
$ref: '#/components/schemas/IActionResult'
'400':
description: Validation failed
'404':
description: User not found
summary: Update user previleges
x-summary-source: derived
components:
schemas:
UserDtoItemResponse:
type: object
properties:
item:
$ref: '#/components/schemas/UserDto'
links:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/HateoasLink'
additionalProperties: false
UserDto:
type: object
properties:
id:
type:
- string
- 'null'
login:
type:
- string
- 'null'
email:
type:
- string
- 'null'
firstName:
type:
- string
- 'null'
lastName:
type:
- string
- 'null'
favoriteLanguage:
type:
- string
- 'null'
defaultOrganizationId:
type:
- string
- 'null'
additionalProperties: false
UserPrivilegesDto:
type: object
properties:
defaultPrivileges:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/PrivilegeDto'
additionalProperties: false
UserPrivilegesDtoItemResponse:
type: object
properties:
item:
$ref: '#/components/schemas/UserPrivilegesDto'
links:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/HateoasLink'
additionalProperties: false
IActionResult:
type: object
additionalProperties: false
PermissionTypes:
enum:
- Role
- Right
type: string
HateoasLink:
type: object
properties:
relation:
type:
- string
- 'null'
uri:
type:
- string
- 'null'
method:
type:
- string
- 'null'
additionalProperties: false
UpdateUserRequest:
type: object
properties:
firstName:
type:
- string
- 'null'
lastName:
type:
- string
- 'null'
favoriteLanguage:
type:
- string
- 'null'
defaultOrganizationId:
type:
- string
- 'null'
additionalProperties: false
PrivilegeDto:
type: object
properties:
name:
type:
- string
- 'null'
type:
$ref: '#/components/schemas/PermissionTypes'
additionalProperties: false
UpdateUserPrivilegesRequest:
type: object
properties:
defaultPrivileges:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/PrivilegeDto'
additionalProperties: false
UserDtoListItemResponse:
type: object
properties:
items:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/UserDtoItemResponse'
totalCount:
type: integer
format: int32
additionalProperties: false
securitySchemes:
Bearer:
type: oauth2
description: "JWT Authorization header using the Bearer scheme. \n\n Enter 'Bearer' [space] and then your token in the text input below.\n\nExample: \"Bearer 1safsfsdfdfd\""
x-provenance:
method: harvested
publisher: Grapes Knowledge Base
source: https://api.data-grapes.com/swagger/v1/swagger.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)