Grepr Organizations API

Manage organization settings and configuration

Operations 3

GET /v1/organization Get Organization #
PUT /v1/organization Update Organization #
POST /v1/organization/sso-request Request SSO enablement #

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-organizations-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.

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

OpenAPI Specification

grepr-organizations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Grepr Organizations API
  version: 1.0.0
  description: 'Operations tagged Organizations 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 organization settings and configuration
  name: Organizations
paths:
  /v1/organization:
    get:
      description: Get the organization to which the authenticated user belongs.
      operationId: getOrganization
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Read'
          description: The organization for the authenticated user.
        '401':
          description: Unauthorized
        '404':
          description: Not Found
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Get Organization
      tags:
      - Organizations
    put:
      description: Update the organization to which the authenticated user belongs.
      operationId: updateOrganization
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicUpdate'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Read'
          description: The updated organization.
        '401':
          description: Unauthorized
        '404':
          description: Not Found
        '500':
          description: Internal Server Error
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Update Organization
      tags:
      - Organizations
  /v1/organization/sso-request:
    post:
      description: Sends a notification to the Grepr team requesting that SSO be enabled for the authenticated user's organization.
      operationId: requestSsoEnablement
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SsoEnablementRequest'
      responses:
        '204':
          description: SSO enablement request sent.
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '409':
          description: An SSO connection is already enabled for the organization, or a request has already been submitted.
        '500':
          description: Internal Server Error
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Request SSO enablement
      tags:
      - Organizations
components:
  schemas:
    ReadOrgConstraints:
      properties:
        maxAnthropicIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxDataWarehouseIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxDatadogApiKeysPerIntegration:
          format: int32
          minimum: 1
          type: integer
        maxDatadogIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxGeminiIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxGreprPipeIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxLiteLlmIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxMcpIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxNewRelicIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxOpenAiIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxOtlpIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxPipelines:
          format: int32
          minimum: 1
          type: integer
        maxPromotedAttributeColumns:
          format: int32
          minimum: 0
          type: integer
        maxPromotedTagColumns:
          format: int32
          minimum: 0
          type: integer
        maxPromotionPolicyEntriesPerList:
          format: int32
          minimum: 0
          type: integer
        maxS3DataWarehouseIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxS3VectorIndexIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxSplunkIntegrations:
          format: int32
          minimum: 1
          type: integer
        maxSumoIntegrations:
          format: int32
          minimum: 1
          type: integer
      type: object
    AccessConfig:
      properties:
        autoSignupEnabled:
          default: true
          type: boolean
      type: object
    Plan:
      properties:
        endDate:
          format: date-time
          type: string
        planChangeRequest:
          $ref: '#/components/schemas/PlanChangeRequest'
        startDate:
          format: date-time
          type: string
        type:
          enum:
          - TRIAL
          - FREE
          - INVOICE
          type: string
      required:
      - endDate
      - planChangeRequest
      - startDate
      - type
      type: object
    PlanChangeRequest:
      properties:
        date:
          format: date-time
          type: string
        type:
          enum:
          - TRIAL
          - FREE
          - INVOICE
          type: string
      required:
      - date
      - type
      type: object
    PublicUpdate:
      properties:
        accessConfig:
          $ref: '#/components/schemas/AccessConfig'
        comments:
          type: string
        plan:
          $ref: '#/components/schemas/Plan'
      required:
      - plan
      type: object
    SsoEnablementRequest:
      properties:
        comments:
          type: string
      type: object
    Read:
      properties:
        accessConfig:
          $ref: '#/components/schemas/AccessConfig'
        constraints:
          $ref: '#/components/schemas/ReadOrgConstraints'
        featureFlags:
          default: []
          items:
            enum:
            - DATADOG_BROWSER_LOGS_INTEGRATION
            - METRICS_SOURCE
            - S3_LOGS_FILE_SOURCE
            - PIPELINE_TEMPLATES
            - AI_WORKFLOWS
            - SEARCH_ICEBERG_SOURCE
            - MULTI_GROK_PARSER
            - AUTH0_SSO_CONNECTION
            - TRINO_QUERY_ENGINE
            - UNKNOWN
            type: string
          type: array
          uniqueItems: true
        name:
          type: string
        plan:
          $ref: '#/components/schemas/Plan'
        ssoConnectionEnabled:
          type: boolean
        ssoRequestedAt:
          format: date-time
          type: string
      required:
      - accessConfig
      - constraints
      - name
      - plan
      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