assign-user-as-a-group-admin.api.mdx

id	assign-user-as-a-group-admin
title	Assign user as a group admin
description	Assign user as a group admin.
sidebar_label	Assign user as a group admin
hide_title	true
hide_table_of_contents	true
api	description tags parameters requestBody responses method path servers security securitySchemes jsonRequestBodyExample info postman Assign user as a group admin. Groups in name schema required description path groupId type description example string The id of the group. 1234 true The id of the group. content application/json schema type properties required additionalProperties object userId type description example integer The ID of the user being assigned as an admin. 153 userId false 200 400 401 403 404 422 429 500 502 503 504 description content Request has been handled successfully. application/json schema type properties additionalProperties object success data type example boolean true type properties additionalProperties object message enum User has been assigned as an admin successfully. false false description content The request is missing required parameters or is invalid. application/json schema type properties additionalProperties object message type success type example string The request is missing required headers or is invalid type example string invalid_request type example boolean false false description content The request is unauthorized. application/json schema type properties additionalProperties object message type success type example string The request requires user authentication type example string unauthorized type example boolean false false description content Forbidden error. Can either be due to access token not being passed, having been expired or the caller trying to access a resource without enough permissions. application/json schema type properties additionalProperties object message type success type example string The server understood the request, but refuses to authorize it type example string forbidden type example boolean false false description content Not Found. The resource being accessed does not exist. application/json schema type properties additionalProperties object message type success type example string The requested resource could not be found type example string not_found type example boolean false false description content Validation Error. The request includes one or more invalid params. Please check the request params and try again. application/json schema type properties additionalProperties object message type success type example string The request was well-formed but was unable to be followed due to semantic errors type example string unprocessable_entity type example boolean false false description content Too many requests, please try again later. application/json schema type properties additionalProperties object message type success type example string Too many requests, please try again later type example string rate_limit_exceeded type example boolean false false description content Server Error. Something went wrong, try again later. application/json schema type properties additionalProperties object message type success type example string The server encountered an internal error and was unable to complete your request type example string internal_server_error type example boolean false false description content Invalid response from the upstream server application/json schema type properties additionalProperties object message type success type example string The server was acting as a gateway or proxy and received an invalid response from the upstream server type example string bad_gateway type example boolean false false description content The server is currently unable to handle the request due to a temporary overload or scheduled maintenance application/json schema type properties additionalProperties object message type success type example string The server is currently unable to handle the request due to a temporary overload or scheduled maintenance type example string service_unavailable type example boolean false false description content The server did not receive a timely response from the upstream server. application/json schema type properties additionalProperties object message type success type example string The server was acting as a gateway or proxy and did not receive a timely response from the upstream server type example string gateway_timeout type example boolean false false put /v1/groups/{groupId}/assignAsAdmin url description https://apis-prelive.quran.foundation/auth Pre-production Server url description https://apis.quran.foundation/auth Production Server x-auth-token x-client-id x-auth-token x-client-id type in name description apiKey header x-auth-token The JWT access token required for accessing the endpoints. type in name description apiKey header x-client-id Your client id userId 153 title version description User-related APIs 1.0.0 Quran.Foundation user-related APIs enable your app to seamlessly integrate with Quran.Foundation's user-centric features, providing access to personalized notes, bookmarks, goals, streaks, reading sessions, and more. This differentiates them from [content APIs](/docs/category/content-apis) that focus on non-user-specific resources like translations, tafsirs, and verses. ## How to get access We are using OAuth2 flows to authenticate and authorize requests. To get started, you need to [get an access token](/docs/tutorials/oidc/getting-started-with-oauth2#obtaining-oauth-20-client-credentials) to make requests to our APIs. Then follow the steps mentioned [here](/docs/tutorials/oidc/getting-started-with-oauth2). ## Pagination We are using cursor based pagination. The pagination query params consist of `first`,`after`, `before` and `last`. Example - `first: 10` will give you first 10 items - `first: 10, after: xyz` will give you first 10 items after the item with id `xyz` - `last: 10` will give you the last 10 items - `last: 10, before: xyz` will give you the last 10 items before the item with id `xyz` The only possible combinations are `first + after` or `last + before`. They should not be used together name description url header method body Assign user as a group admin content type Assign user as a group admin. text/plain path host query variable v1 groups :groupId assignAsAdmin {{baseUrl}} disabled description type value key false content type (Required) The id of the group. text/plain any groupId key value Content-Type application/json key value Accept application/json PUT mode raw options raw "" raw language json
sidebar_class_name	put api-method
info_path	docs/user_related_apis_versioned/1.0.0/user-related-apis
custom_edit_url

import ApiTabs from "@theme/ApiTabs"; import MimeTabs from "@theme/MimeTabs"; import ParamsItem from "@theme/ParamsItem"; import ResponseSamples from "@theme/ResponseSamples"; import SchemaItem from "@theme/SchemaItem"; import SchemaTabs from "@theme/SchemaTabs"; import DiscriminatorTabs from "@theme/DiscriminatorTabs"; import TabItem from "@theme/TabItem";

Assign user as a group admin

Assign user as a group admin.

Path Parameters

Request Body

Request has been handled successfully.

Schema

data object

The request is missing required parameters or is invalid.

Schema

The request is unauthorized.

Schema

Forbidden error. Can either be due to access token not being passed, having been expired or the caller trying to access a resource without enough permissions.

Schema

Not Found. The resource being accessed does not exist.

Schema

Validation Error. The request includes one or more invalid params. Please check the request params and try again.

Schema

Too many requests, please try again later.

Schema

Server Error. Something went wrong, try again later.

Schema

Invalid response from the upstream server

Schema

The server is currently unable to handle the request due to a temporary overload or scheduled maintenance

Schema

The server did not receive a timely response from the upstream server.

Schema