Grepr

Grepr Teams API

Manage teams within your organization

GitHub OpenAPI

Operations 10

GET /v1/teams Get Teams #
POST /v1/teams Create team #
DELETE /v1/teams/{id} Delete team #
GET /v1/teams/{id} Get team by id #
PUT /v1/teams/{id} Update team #
GET /v1/teams/{id}/roles Get available roles for a team #
GET /v1/teams/{id}/users Get users in team #
POST /v1/teams/{id}/users Add users to a team #
DELETE /v1/teams/{id}/users/{userId} Removes a user from the team #
PUT /v1/teams/{id}/users/{userId}/roles Update roles for user in team #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/grepr/openapi/grepr-teams-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/grepr/json-schema/grepr-issue-schema.json
📊
JSONSchema
https://artifacts.apis.io/grepr/json-schema/grepr-template-schema.json
📊
JSONSchema
https://artifacts.apis.io/grepr/json-schema/grepr-create-issue-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/grepr/json-schema/grepr-search-issues-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/grepr/json-schema/grepr-read-job-schema.json
📊
JSONSchema
https://artifacts.apis.io/grepr/json-schema/grepr-update-issue-request-schema.json

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/grepr:grepr-teams-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

grepr-teams-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Grepr Teams API
  version: 1.0.0
  description: 'Operations tagged Teams across 2 of this provider''s published API definitions: grepr-openapi.json, grepr.json. Each path carries the servers of the definition it was published in.'
tags:
- description: Manage teams within your organization
  name: Teams
paths:
  /v1/teams:
    get:
      description: Get all the teams for the organization.
      operationId: listTeams
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ReadTeam'
                type: array
          description: The list of teams in the organization.
        '401':
          description: Unauthorized
        '404':
          description: Not Found
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Get Teams
      tags:
      - Teams
    post:
      operationId: createTeam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Update'
      responses:
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReadTeam'
          description: default response
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      tags:
      - Teams
      summary: Create team
      x-summary-source: derived
  /v1/teams/{id}:
    delete:
      operationId: deleteTeam
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        default:
          content:
            application/json: {}
          description: default response
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      tags:
      - Teams
      summary: Delete team
      x-summary-source: derived
    get:
      operationId: getTeamById
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReadTeam'
          description: default response
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      tags:
      - Teams
      summary: Get team by id
      x-summary-source: derived
    put:
      operationId: updateTeam
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Update'
      responses:
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReadTeam'
          description: default response
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      tags:
      - Teams
      summary: Update team
      x-summary-source: derived
  /v1/teams/{id}/roles:
    get:
      description: Returns the leader and member roles available for assignment in this team
      operationId: getTeamRoles
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/Role'
                type: array
          description: Team roles retrieved successfully
        '401':
          description: Unauthorized
        '404':
          description: Not Found
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Get available roles for a team
      tags:
      - Teams
  /v1/teams/{id}/users:
    get:
      operationId: getUsersInTeam
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      - in: query
        name: pageSize
        schema:
          default: 10
          format: int32
          minimum: 1
          type: integer
      - in: query
        name: page
        schema:
          default: 0
          format: int32
          minimum: 0
          type: integer
      responses:
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsersListInfos'
          description: default response
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      tags:
      - Teams
      summary: Get users in team
      x-summary-source: derived
    post:
      description: Add users to a team.
      operationId: addUsersToTeam
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UsersUpdate'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsersUpdate'
          description: The list of users and roles that were successfully assigned.
        '401':
          description: Unauthorized
        '404':
          description: Not Found
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Add users to a team
      tags:
      - Teams
  /v1/teams/{id}/users/{userId}:
    delete:
      description: Remove a user from the team.
      operationId: removeUserFromTeam
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      - in: path
        name: userId
        required: true
        schema:
          type: string
      responses:
        '204':
          description: User removed from team successfully
        '401':
          description: Unauthorized
        '404':
          description: Not Found
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Removes a user from the team
      tags:
      - Teams
  /v1/teams/{id}/users/{userId}/roles:
    put:
      operationId: updateRolesForUserInTeam
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      - in: path
        name: userId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RoleUpdate'
      responses:
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoleUpdate'
          description: default response
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      tags:
      - Teams
      summary: Update roles for user in team
      x-summary-source: derived
components:
  schemas:
    ReadUser:
      properties:
        email:
          description: The email associated with the user.
          type: string
        id:
          description: The id associated with the user.
          type: string
        name:
          description: The name of the user.
          type: string
        roles:
          default: []
          description: The roles associated with this user.
          items:
            $ref: '#/components/schemas/Role'
          type: array
          uniqueItems: true
        teamIds:
          description: The teams that this user is a member of.
          items:
            description: The teams that this user is a member of.
            type: string
          type: array
          uniqueItems: true
      required:
      - roles
      - teamIds
      type: object
    UsersListInfos:
      properties:
        limit:
          format: int32
          type: integer
        members:
          $ref: '#/components/schemas/ItemsCollectionReadUser'
        start:
          format: int32
          type: integer
        total:
          format: int32
          type: integer
      type: object
    ItemsCollectionReadUser:
      properties:
        items:
          default: []
          items:
            $ref: '#/components/schemas/ReadUser'
          type: array
      type: object
    Update:
      properties:
        name:
          maxLength: 100
          minLength: 0
          type: string
      required:
      - name
      type: object
    ReadTeam:
      properties:
        id:
          type: string
        leaderRoleId:
          type: string
        memberRoleId:
          type: string
        name:
          type: string
        userCount:
          format: int32
          type: integer
      required:
      - id
      - leaderRoleId
      - memberRoleId
      - name
      type: object
    UsersUpdate:
      properties:
        leaderUserIds:
          default: []
          items:
            type: string
          type: array
        memberUserIds:
          default: []
          items:
            type: string
          type: array
      required:
      - leaderUserIds
      - memberUserIds
      type: object
    Role:
      properties:
        builtin:
          default: false
          description: Whether this is a built-in role
          readOnly: true
          type: boolean
        createdAt:
          description: When the role was created (null for system roles)
          format: date-time
          type: string
        createdBy:
          description: Who created the role (null for system roles)
          type: string
        description:
          description: Description of the role
          type: string
        effect:
          default: allow
          description: 'The effect of this role''s permissions: ''allow'' or ''deny''. Defaults to ''allow'' for standard roles.'
          readOnly: true
          type: string
        id:
          description: The id of the role.
          type: string
        name:
          description: The user-facing name of the role.
          type: string
        permissionIds:
          default: []
          description: Permission IDs assigned to this role (empty for system roles)
          items:
            description: Permission IDs assigned to this role (empty for system roles)
            type: string
          type: array
          uniqueItems: true
      required:
      - description
      - id
      - name
      - permissionIds
      type: object
    RoleUpdate:
      properties:
        roleIds:
          items:
            type: string
          maxItems: 2147483647
          minItems: 1
          type: array
      required:
      - roleIds
      type: object
  securitySchemes:
    grepr-api-key:
      in: header
      name: GREPR-API-KEY
      type: apiKey
    grepr-oidc:
      bearerFormat: JWT
      openIdConnectUrl: https://grepr-prod.us.auth0.com/.well-known/openid-configuration
      type: openIdConnect
x-refined-from:
- grepr-openapi.json
- grepr.json
x-tagGroups:
- name: Integrations
  tags:
  - Grepr-hosted Data Warehouse Integration
  - External S3 Data Warehouse Integration
  - Datadog Integration
  - New Relic Integration
  - Splunk Integration
  - Sumo Logic Integration
  - OpenTelemetry Integration
- name: Pipelines
  tags:
  - Jobs
  - Templates
  - Datasets
  - Status Metrics
  - External Triggers
  - Job Actions
  - Triggers
- name: Pipeline Components
  tags:
  - Operations
  - Transforms
  - Sources
  - Sinks
- name: Administration
  tags:
  - Users
  - Teams
  - Roles
  - Permission
  - Invitations
  - Activity Logs
- name: Organization
  tags:
  - Organizations
  - Access Configuration
  - Grepr API Key
  - Service Accounts
  - Signup
- name: Query & Analysis
  tags:
  - Job Anomalies
  - Grok Parsing
  - Query Parsing
  - Validation
- name: System
  tags:
  - Manifest