openapi: 3.1.0
info:
  title: Guru Analytics Groups API
  version: 1.0.0
  description: 'REST API for accessing and managing Guru data programmatically. Supports

    cards, collections, folders, announcements, search, people, groups, tags,

    templates, comments, verifiers, and answers. Authentication is via OAuth 2.0

    (recommended) or API tokens.

    '
  contact:
    name: Guru Developer Network
    url: https://developer.getguru.com
servers:
- url: https://api.getguru.com/api/v1
  description: Guru production API
security:
- basicAuth: []
- bearerAuth: []
tags:
- name: Groups
paths:
  /groups:
    get:
      summary: List user groups
      operationId: listGroups
      tags:
      - Groups
      responses:
        '200':
          description: List of groups.
  /groups/members:
    get:
      summary: List group members
      operationId: listGroupMembers
      tags:
      - Groups
      responses:
        '200':
          description: List of group members.
  /groups/collections:
    get:
      summary: List group collection access
      operationId: listGroupCollections
      tags:
      - Groups
      responses:
        '200':
          description: List of collections.
  /groups/create-member:
    post:
      summary: Add user group member
      operationId: createGroupMember
      tags:
      - Groups
      responses:
        '201':
          description: Member added.
  /groups/delete-member:
    delete:
      summary: Delete user group member
      operationId: deleteGroupMember
      tags:
      - Groups
      responses:
        '204':
          description: Member removed.
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: API token authentication via HTTP Basic.
    bearerAuth:
      type: http
      scheme: bearer
      description: OAuth 2.0 bearer token.