Graphiant

Graphiant Groups API

The Groups API from Graphiant — 9 operation(s) for groups.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 12

POST /v1/groups/{id}/enterprises Create groups by id enterprises #
POST /v1/groups/{id}/members Create groups by id members #
GET /v1/groups/{id}/members Get groups by id members #
PUT /v1/groups Replace groups #
GET /v1/groups Get groups #
DELETE /v1/groups/{id} Delete groups by id #
PATCH /v1/groups/{id} Update groups by id #
DELETE /v1/groups/{id}/enterprises/{enterpriseId} Delete groups by id enterprises by enterprise id #
DELETE /v1/groups/{id}/members/{memberId} Delete groups by id members by member id #
POST /v1/groups/{id}/members/delete Create groups by id members delete #
GET /v1/groups/enterprises Get groups enterprises #
GET /v1/groups/root Get groups root #

Documentation

📖
Documentation
https://docs.graphiant.com/docs/graphiant-portal-rest-api
📖
APIReference
https://docs.graphiant.com/apidocs
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/authentication/graphiant-authentication.yml

Specifications

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

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/errors/graphiant-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/conventions/graphiant-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/data-model/graphiant-data-model.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/mcp/graphiant-tool-crosswalk.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/graphiant-groups-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.

GitHub Google LinkedIn

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

OpenAPI Specification

graphiant-groups-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Graphiant Groups API
  version: 1.0.0
  description: Graphiant API documentation.
servers:
- url: https://api.graphiant.com
security:
- jwtAuth: []
tags:
- name: Groups
paths:
  /v1/groups/{id}/enterprises:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: id
        in: path
        required: true
        description: ''
        schema:
          type: string
          example: example string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1GroupsIdEnterprisesPostRequest'
      responses:
        '204':
          description: No Content
      description: Associate group with additional enterprises to enable cross-enterprise access and management.
      tags:
      - Groups
      summary: Create groups by id enterprises
      x-summary-source: derived
      operationId: postV1GroupsByIdEnterprises
      x-operation-id-source: derived
  /v1/groups/{id}/members:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: id
        in: path
        required: true
        description: ''
        schema:
          type: string
          example: example string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1GroupsIdMembersPostRequest'
      responses:
        '204':
          description: No Content
      description: Add multiple users to a group by their global IDs.
      tags:
      - Groups
      summary: Create groups by id members
      x-summary-source: derived
      operationId: postV1GroupsByIdMembers
      x-operation-id-source: derived
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: id
        in: path
        required: true
        description: ''
        schema:
          type: string
          example: example string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GroupsIdMembersGetResponse'
      description: Get all members of a specific group.
      tags:
      - Groups
      summary: Get groups by id members
      x-summary-source: derived
      operationId: getV1GroupsByIdMembers
      x-operation-id-source: derived
  /v1/groups:
    put:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1GroupsPutRequest'
      responses:
        '204':
          description: No Content
      description: Create a new group with and set permissions. Set group's enterprise management capabilities (msp only).
      tags:
      - Groups
      summary: Replace groups
      x-summary-source: derived
      operationId: putV1Groups
      x-operation-id-source: derived
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GroupsGetResponse'
      description: Get all groups in the enterprise.
      tags:
      - Groups
      summary: Get groups
      x-summary-source: derived
      operationId: getV1Groups
      x-operation-id-source: derived
  /v1/groups/{id}:
    delete:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: id
        in: path
        required: true
        description: ''
        schema:
          type: string
          example: example string
      responses:
        '204':
          description: No Content
      description: Delete a group and remove all member associations and enterprise relationships. Replace with a different group if specified.
      tags:
      - Groups
      summary: Delete groups by id
      x-summary-source: derived
      operationId: deleteV1GroupsById
      x-operation-id-source: derived
    patch:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: id
        in: path
        required: true
        description: ''
        schema:
          type: string
          example: example string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1GroupsIdPatchRequest'
      responses:
        '204':
          description: No Content
      description: Update group information.
      tags:
      - Groups
      summary: Update groups by id
      x-summary-source: derived
      operationId: patchV1GroupsById
      x-operation-id-source: derived
  /v1/groups/{id}/enterprises/{enterpriseId}:
    delete:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: enterpriseId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      - name: id
        in: path
        required: true
        description: ''
        schema:
          type: string
          example: example string
      responses:
        '204':
          description: No Content
      description: Remove group's association with a specific enterprise, revoking cross-enterprise access.
      tags:
      - Groups
      summary: Delete groups by id enterprises by enterprise id
      x-summary-source: derived
      operationId: deleteV1GroupsByIdEnterprisesByEnterpriseId
      x-operation-id-source: derived
  /v1/groups/{id}/members/{memberId}:
    delete:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: id
        in: path
        required: true
        description: ''
        schema:
          type: string
          example: example string
      - name: memberId
        in: path
        required: true
        description: ''
        schema:
          type: string
          example: example string
      responses:
        '204':
          description: No Content
      description: Remove a specific user from a group by member ID.
      tags:
      - Groups
      summary: Delete groups by id members by member id
      x-summary-source: derived
      operationId: deleteV1GroupsByIdMembersByMemberId
      x-operation-id-source: derived
  /v1/groups/{id}/members/delete:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: id
        in: path
        required: true
        description: ''
        schema:
          type: string
          example: example string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1GroupsIdMembersDeletePostRequest'
      responses:
        '204':
          description: No Content
      description: Remove multiple users from a group by their member IDs.
      tags:
      - Groups
      summary: Create groups by id members delete
      x-summary-source: derived
      operationId: postV1GroupsByIdMembersDelete
      x-operation-id-source: derived
  /v1/groups/enterprises:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GroupsEnterprisesGetResponse'
      description: Get all enterprise-level groups.
      tags:
      - Groups
      summary: Get groups enterprises
      x-summary-source: derived
      operationId: getV1GroupsEnterprises
      x-operation-id-source: derived
  /v1/groups/root:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GroupsRootGetResponse'
      description: Get all root-level groups.
      tags:
      - Groups
      summary: Get groups root
      x-summary-source: derived
      operationId: getV1GroupsRoot
      x-operation-id-source: derived
components:
  schemas:
    v1GroupsIdMembersDeletePostRequest:
      type: object
      properties:
        memberIds:
          type: array
          items:
            type: string
            example: example string
            description: ' (required)'
      additionalProperties: false
      required:
      - memberIds
    commonPermissions:
      type: object
      properties:
        assetManager:
          type: string
          example: ENUM_VALUE
        b2b:
          type: string
          example: ENUM_VALUE
        b2bSecurityProfileExternal:
          type: string
          example: ENUM_VALUE
        billingAndInvoicing:
          type: string
          example: ENUM_VALUE
        compliance:
          type: string
          example: ENUM_VALUE
        developerTools:
          type: string
          example: ENUM_VALUE
        gateway:
          type: string
          example: ENUM_VALUE
        globalServices:
          type: string
          example: ENUM_VALUE
        insights:
          type: string
          example: ENUM_VALUE
        licensing:
          type: string
          example: ENUM_VALUE
        logs:
          type: string
          example: ENUM_VALUE
        monitoringAndTroubleshooting:
          type: string
          example: ENUM_VALUE
        networkConfiguration:
          type: string
          example: ENUM_VALUE
        orderStatus:
          type: string
          example: ENUM_VALUE
        reports:
          type: string
          example: ENUM_VALUE
        safetyAndSecurity:
          type: string
          example: ENUM_VALUE
        servicePolicies:
          type: string
          example: ENUM_VALUE
        support:
          type: string
          example: ENUM_VALUE
        userAndTenantManagement:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    googleProtobufTimestamp:
      type: object
      properties:
        nanos:
          type: integer
          format: int32
          example: 123
        seconds:
          type: integer
          format: int64
          example: 1234567891011
      additionalProperties: false
    v1GroupsIdMembersPostRequest:
      type: object
      properties:
        memberIds:
          type: array
          items:
            type: string
            example: example string
            description: ' (required)'
        replaceExisting:
          type: boolean
          example: true
      additionalProperties: false
      required:
      - memberIds
    iamEnterprisePermissions:
      type: object
      properties:
        groupType:
          type: string
          example: ENUM_VALUE
          description: ' (required)'
        permissions:
          $ref: '#/components/schemas/commonPermissions'
      additionalProperties: false
    v1GroupsGetResponse:
      type: object
      properties:
        groups:
          type: array
          items:
            $ref: '#/components/schemas/iamGroup'
      additionalProperties: false
    v1GroupsRootGetResponse:
      type: object
      properties:
        groups:
          type: array
          items:
            $ref: '#/components/schemas/iamGroup'
      additionalProperties: false
    v1GroupsIdMembersGetResponse:
      type: object
      properties:
        users:
          type: array
          items:
            $ref: '#/components/schemas/commonUser'
      additionalProperties: false
    commonUser:
      type: object
      properties:
        email:
          type: string
          example: example string
        enterpriseId:
          type: integer
          format: int64
          example: 1234567891011
        firstName:
          type: string
          example: example string
        lastActiveAt:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        lastName:
          type: string
          example: example string
        mfaFactor:
          type: string
          example: example string
        phoneNumber:
          type: string
          example: example string
        timeZone:
          type: string
          example: example string
        userId:
          type: string
          example: example string
        verified:
          type: boolean
          example: true
      additionalProperties: false
    iamGroup:
      type: object
      properties:
        description:
          type: string
          example: example string
        enterpriseIds:
          type: array
          items:
            type: integer
            format: int64
            example: 1234567891011
        enterprisePermissions:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/iamEnterprisePermissions'
        groupType:
          type: string
          example: ENUM_VALUE
        id:
          type: string
          example: example string
        name:
          type: string
          example: example string
        permissions:
          $ref: '#/components/schemas/commonPermissions'
        timeWindowEnd:
          type: integer
          format: int64
          example: 1234567891011
        timeWindowStart:
          type: integer
          format: int64
          example: 1234567891011
      additionalProperties: false
    v1GroupsPutRequest:
      type: object
      properties:
        description:
          type: string
          example: example string
          description: ' (required)'
        groupId:
          type: string
          example: example string
          description: Only supply if enterprise uses an idp
        groupType:
          type: string
          example: ENUM_VALUE
        managesEnterprises:
          type: boolean
          example: true
        name:
          type: string
          example: example string
          description: ' (required)'
        permissions:
          $ref: '#/components/schemas/commonPermissions'
        timeWindowEnd:
          type: integer
          format: int64
          example: 1234567891011
        timeWindowStart:
          type: integer
          format: int64
          example: 1234567891011
      additionalProperties: false
      required:
      - description
      - name
    v1GroupsIdPatchRequest:
      type: object
      properties:
        description:
          type: string
          example: example string
        displayName:
          type: string
          example: example string
        groupType:
          type: string
          example: ENUM_VALUE
        permissions:
          $ref: '#/components/schemas/commonPermissions'
        timeWindowEnd:
          type: integer
          format: int64
          example: 1234567891011
        timeWindowStart:
          type: integer
          format: int64
          example: 1234567891011
      additionalProperties: false
    v1GroupsEnterprisesGetResponse:
      type: object
      properties:
        groups:
          type: array
          items:
            $ref: '#/components/schemas/iamGroup'
      additionalProperties: false
    v1GroupsIdEnterprisesPostRequest:
      type: object
      properties:
        enterpriseIds:
          type: array
          items:
            type: integer
            format: int64
            example: 1234567891011
            description: ' (required)'
      additionalProperties: false
      required:
      - enterpriseIds
  securitySchemes:
    jwtAuth:
      type: apiKey
      in: header
      name: authorization
      description: Use `Bearer <token>`