CoreStack

CoreStack Identity API

User, Tenants & Roles Management

GitHub OpenAPI

Operations 41

GET /tenants List Tenant #
POST /tenants Create Tenant #
DELETE /tenants/{tenant_id} Delete Tenant #
GET /tenants/{tenant_id} Get Tenant #
PUT /tenants/{tenant_id} Update Tenant #
GET /tenants/{tenant_id}/name_change_history Get Tenant Name Change History #
GET /tenants/{tenant_id}/roles List Roles by Tenant #
GET /tenants/{tenant_id}/users List Users by Tenant #
PUT /users/change_password/{user_id} Change Password #
PUT /users/change_time_zone/{user_id} Change Timezone #
POST /users/create Create User #
DELETE /users/delete/{user_id} Delete User #
GET /users/filter-options List Users #
GET /users/filter-options-light List Users #
POST /users/forget_password/{user_id} Forget Password #
GET /users/list List Users #
POST /users/notification/report Send notification report email #
POST /users/notifications/{user_id}/{tenant_id} Check notification status #
PUT /users/profile/active-tenant Update active tenant for a user #
GET /users/profile/{user_id} View User Profile #
POST /users/resend_token/{user_id} Resend User Token for Activation #
POST /users/reset_password Reset Password #
POST /users/summary/batch User Batch #
PUT /users/update/{user_id} Update User #
GET /users/view/{user_id} Describe User #
GET /users/{tenant_id}/notification_message List notification message #
POST /users/{user_id}/activate_user/{auth_token} Activate User #
POST /users/{user_id}/verify_user/{auth_token} Verify User #
GET /v1/master_accounts/{master_account_id}/roles List Roles by Master Account #
GET /v1/master_accounts/{master_account_id}/tenants Tenant List by Master Account #
POST /v1/roles/summary/batch Role Batch #
POST /v1/user/verify/{access_key} Auth0 User Verification #
POST /v1/user/{user_id}/password_reset Reset Password for Auth0 User #
POST /v1/user_delegation/master_accounts/{master_account_id}/rules Create User Delegation #
POST /v1/user_delegation/master_accounts/{master_account_id}/rules/batch Batch User Delegation #
DELETE /v1/user_delegation/master_accounts/{master_account_id}/rules/item/{rule_id} Delete User Delegation #
PUT /v1/user_delegation/master_accounts/{master_account_id}/rules/item/{rule_id} Update User Delegation #
POST /v1/user_delegation/master_accounts/{master_account_id}/rules/list List User Delegation #
GET /v1/user_delegation/master_accounts/{master_account_id}/rules/refresh Refresh User Delegation #
GET /v1/user_delegation/report/{user_id} Get User Delegation Report #
POST /v1/users/invite Invite User #

Documentation

📖
Documentation
https://docs.corestack.io/docs/corestack-api-modules
📖
APIReference
https://docs.corestack.io/reference
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/authentication/corestack-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/openapi/corestack-identity-api-openapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/conventions/corestack-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/errors/corestack-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/data-model/corestack-data-model.yml

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/corestack-identity-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 email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

corestack-identity-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: CoreStack External Identity API
  version: 1.0.0
  termsOfService: http://corestack.io/
  license:
    name: CoreStack Inc License
    url: http://corestack.io/licenses/LICENSE-2.0.html
  description: User, Tenants & Roles Management
servers:
- url: /
tags:
- name: Identity
  description: User, Tenants & Roles Management
paths:
  /tenants:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListTenantResponse'
      summary: List Tenant
      description: There can be multiple tenants within a CoreStack account. List all tenants the user is mapped under a CoreStack account. If there are 3 tenants and user performing this operation has access to only 2 tenants then only those 2 tenants will be returned.
      operationId: listTenant
      security:
      - auth_token: []
      tags:
      - Identity
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TenantCreateResponse'
      summary: Create Tenant
      description: Creates a new tenant under a CoreStack account. There can be multiple tenants within a CoreStack account.
      operationId: createTenant
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTenantRequest'
        required: true
  /tenants/{tenant_id}:
    delete:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Removed
          content:
            application/json:
              schema:
                type: boolean
      summary: Delete Tenant
      description: Delete a tenant by its Id. Cannot undo this action, so be cautious when performing this operation. Use updateTenant to make the tenant as suspended if required.
      operationId: deleteTenant
      parameters:
      - name: tenant_id
        in: path
        required: true
        description: Id of the tenant to be deleted.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTenantResponse'
      summary: Get Tenant
      description: Retrieve a tenant by its Id.  If you're unsure of the tenant_id, use listTenant operation to list all tenants under a CoreStack account and fetch the needed tenant_id.
      operationId: getTenant
      parameters:
      - name: tenant_id
        in: path
        required: true
        description: Specify the tenant ID. This is a unique ID and can be retrieved using the List Tenants API.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
    put:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TenantUpdateResponse'
      summary: Update Tenant
      description: Update a tenant's status, description & metadata using its id. No operation can be performed when a tenant is made suspended.
      operationId: updateTenant
      parameters:
      - name: tenant_id
        in: path
        required: true
        description: Id of the CoreStack account under which the tenant to be updated.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateTenantRequest'
        required: true
  /tenants/{tenant_id}/name_change_history:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Name change history retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NameChangeHistoryResponse'
      summary: Get Tenant Name Change History
      description: Retrieve the name change history for a tenant.
      operationId: getTenantNameChangeHistory
      parameters:
      - name: tenant_id
        in: path
        required: true
        description: Id of the tenant to retrieve name change history for.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
  /tenants/{tenant_id}/roles:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoleListResponse'
      summary: List Roles by Tenant
      description: This GET method is used to retrieve the list of Roles available within a specific tenant.
      operationId: ListRoles
      parameters:
      - name: tenant_id
        in: path
        required: true
        description: Specify the tenant ID. This is a unique ID and can be retrieved using the List Tenants API.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
  /tenants/{tenant_id}/users:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserTenantResponseList'
      summary: List Users by Tenant
      description: List all users within a tenant.
      operationId: ListTenantUser
      parameters:
      - name: tenant_id
        in: path
        required: true
        description: Specify the tenant ID. This is a unique ID and can be retrieved using the List Tenants API.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
  /users/change_password/{user_id}:
    parameters:
    - name: user_id
      in: path
      required: true
      schema:
        type: string
    put:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChangePasswordResponse'
      summary: Change Password
      description: Update the password of the user. This password will be used for login to portal and it will not affect the Access Key / Secret Key associated with the user. Cannot update password of another user within the same CoreStack account. Can be updated for the user associated with Access Key / Secret Key
      operationId: ChangePassword
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangePasswordRequest'
        required: true
  /users/change_time_zone/{user_id}:
    parameters:
    - name: user_id
      in: path
      required: true
      schema:
        type: string
    put:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChangeTimezoneResponse'
      summary: Change Timezone
      description: Update the timezone settings of the user. In CoreStack portal, wherever the datatime is shown it is converted to the timezone set to the user. Cannot update timezone of another user within the same CoreStack account. Can be updated for the user associated with Access Key / Secret Key
      operationId: ChangeTimezone
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeTimezoneRequest'
        required: true
  /users/create:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '201':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserCreateResponse'
      summary: Create User
      description: Creates an user within a CoreStack account and assign different roles for different tenants. There can be multiple tenants within a CoreStack account. User will be created at the account level and mapped to multiple tenants as needed.
      operationId: CreateUser
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserCreateRequest'
        required: true
  /users/delete/{user_id}:
    parameters:
    - name: user_id
      in: path
      required: true
      schema:
        type: string
    delete:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Removed
          content:
            application/json:
              schema:
                type: boolean
      summary: Delete User
      description: Deletes the User from CoreStack system. This operation cannot be undone.
      operationId: DeleteUser
      security:
      - auth_token: []
      tags:
      - Identity
  /users/filter-options:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilterOptions'
      summary: List Users
      description: List all tenants, cloud providers and cloud accounts available within a CoreStack account.
      operationId: ListUserFilterOptions
      security:
      - auth_token: []
      tags:
      - Identity
  /users/filter-options-light:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilterOptionsLight'
      summary: List Users
      description: List all tenants with limited details within a CoreStack account.
      operationId: ListUserFilterOptionsLight
      security:
      - auth_token: []
      tags:
      - Identity
  /users/forget_password/{user_id}:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Forgotten
          content:
            application/json:
              schema:
                type: boolean
      summary: Forget Password
      description: Forget the password of the user. This password will be used for login to portal and it will not affect the Access Key / Secret Key associated with the user
      operationId: ForgetPassword
      parameters:
      - name: user_id
        in: path
        required: true
        description: User Id fetched from List User API
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ForgetPasswordRequest'
        required: true
  /users/list:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserResponseList'
      summary: List Users
      description: List all users within a CoreStack account.
      operationId: ListUser
      parameters:
      - description: Specify the master account id
        name: master_account_id
        in: query
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
  /users/notification/report:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationReportResponse'
      summary: Send notification report email
      description: Send a notification email for a shared report
      operationId: NotificationReport
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NotificationReportRequest'
        required: true
  /users/notifications/{user_id}/{tenant_id}:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountUserNotificationsResponse'
      summary: Check notification status
      description: Check Notification status for user
      operationId: CountUserNotifications
      parameters:
      - name: user_id
        in: path
        required: true
        description: Id of user
        schema:
          type: string
      - name: tenant_id
        in: path
        required: true
        description: Id of active tenant
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
  /users/profile/active-tenant:
    put:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserProfileActiveTenantResponse'
      summary: Update active tenant for a user
      description: Sets the active tenant for the user
      operationId: UserProfileActiveTenant
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserProfileActiveTenantRequest'
        required: true
  /users/profile/{user_id}:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileResponse'
      summary: View User Profile
      description: Describes an User by ID. This provides detailed information about a user profile
      operationId: UserProfile
      parameters:
      - name: user_id
        in: path
        required: true
        description: User Id fetched from List User API
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
  /users/resend_token/{user_id}:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResendTokenResponse'
      summary: Resend User Token for Activation
      description: Resend User Activation Link
      operationId: ResendTokenUser
      parameters:
      - name: user_id
        in: path
        required: true
        description: Id of user
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - Identity
  /users/reset_password:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResetPasswordResponse'
      summary: Reset Password
      description: Reset the password of the user.This password will be used for login to portal and it will not affect the Access Key / Secret Key associated with the user
      operationId: UsersResetPassword
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResetPasswordRequest'
        required: true
  /users/summary/batch:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserSummaryBatchResponse'
      summary: User Batch
      description: User Summary Batch
      operationId: UserSummaryBatch
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchRequest'
        required: true
  /users/update/{user_id}:
    parameters:
    - name: user_id
      in: path
      required: true
      schema:
        type: string
    put:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserUpdateResponse'
      summary: Update User
      description: Updates a user and their role assignment in multiple tenants.
      operationId: UpdateUser
      security:
      - auth_token: []
      tags:
      - Identity
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserUpdateRequest'
        required: true
  /users/view/{user_id}:
    parameters:
    - name: user_id
      in: path
      required: true
      schema:
        type: string
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserDescribeResponse'
      summary: Describe User
      description: Describes an User by ID. This provides detailed information about a user
      operationId: DescribeUser
      security:
      - auth_token: []
      tags:
      - Identity
  /users/{tenant_id}/notification_message:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationMessageResponse'
      summary: List notification message
      description: This GET method is used to retrieve the Notification, Message a specific tenant.
      operationId: NotificationMessageResource
      parameters:
      - name: tenant_id
        in: path
        required: true
        description: Specify the tenant ID. This is a unique ID and can be retrieved using the List Tenants API.
        schema:
          type: string
      - description: 'Specify the action name. Allowed values: view_notifications, if require to fetch data with filter wise use view_notifications'
        name: action
        in: query
        schema:
          type: string
          enum:
          - view_notifications
      - description: Specify value for display, if require to fetch data for filter wise use read, unread,all
        name: display
        in: q

# --- truncated at 32 KB (109 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/openapi/corestack-identity-api-openapi.yml