Grepr OpenAI Integration API
The OpenAI Integration API from Grepr — 3 operation(s) for openai integration.
The OpenAI Integration API from Grepr — 3 operation(s) for openai integration.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/grepr:grepr-openai-integration-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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: 3.2.0
info:
title: Grepr OpenAI Integration API
version: 1.0.0
description: 'Operations tagged OpenAI Integration 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:
- name: OpenAI Integration
paths:
/v1/integrations/openai:
get:
description: Get all OpenAI integrations for your organization. This will contain masked API keys if present.
operationId: list_13
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ItemsCollectionReadOpenAi'
description: Integrations retrieved successfully
'401':
description: Unauthorized
security:
- grepr-api-key: []
- grepr-oidc: []
summary: List all OpenAI integrations
tags:
- OpenAI Integration
post:
description: Creates an integration to connect to OpenAI.
operationId: create_11
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WriteOpenAi'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ReadOpenAi'
description: Integration created successfully
'401':
description: Unauthorized
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ReadOpenAi'
description: Integration already exists.
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Create an OpenAI integration
tags:
- OpenAI Integration
/v1/integrations/openai/{id}:
delete:
description: Deletes an OpenAI integration. This will delete the associated API key as well. No-op if already deleted.
operationId: delete_11
parameters:
- in: path
name: id
required: true
schema:
type: string
responses:
'204':
description: Integration deleted successfully
'401':
description: Unauthorized
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Delete an OpenAI integration
tags:
- OpenAI Integration
get:
description: Get an OpenAI integration by ID.
operationId: get_13
parameters:
- in: path
name: id
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ReadOpenAi'
description: Integration retrieved successfully
'401':
description: Unauthorized
'404':
description: Integration not found.
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Get an OpenAI integration
tags:
- OpenAI Integration
put:
description: Updates an OpenAI integration. The version should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.
operationId: update_9
parameters:
- in: path
name: id
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WriteOpenAi'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ReadOpenAi'
description: Integration updated successfully
'401':
description: Unauthorized
'404':
description: Integration not found.
'409':
description: Integration was modified or deleted concurrently.
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Update an OpenAI integration
tags:
- OpenAI Integration
/v1/integrations/openai/{id}/api-key:
put:
description: Creates an API key for an OpenAI integration if it doesn't exist and updates it otherwise. If the key is updated while the integration is being used by a pipeline, the new key will be picked at pipeline restart, rescaling or an update.
operationId: upsertApiKey_7
parameters:
- in: path
name: id
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SecretApi'
responses:
'204':
description: API key upserted successfully.
'401':
description: Unauthorized
'404':
description: Integration not found.
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Creates or updates an OpenAI integration API key
tags:
- OpenAI Integration
components:
schemas:
ReadOpenAi:
properties:
createdAt:
description: Timestamp when the integration was created.
format: date-time
readOnly: true
type: string
id:
description: The integration id
type: string
jobIds:
description: List of job IDs associated with the integration.
items:
description: List of job IDs associated with the integration.
type: string
type: array
uniqueItems: true
name:
description: Name of the integration.
example: my_integration
pattern: '[a-zA-Z0-9 _-]{1,128}'
type: string
organizationId:
description: Organization ID of the integration.
type: string
payload:
$ref: '#/components/schemas/OpenAi'
teamIds:
description: The team IDs that this integration is associated with.
items:
description: The team IDs that this integration is associated with.
type: string
type: array
uniqueItems: true
type:
description: The type of the integration. This is used to determine the payload type.
enum:
- openai
type: string
updatedAt:
description: Timestamp when the integration was last updated.
format: date-time
readOnly: true
type: string
version:
description: Version of the integration. Should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.
example: 0
format: int32
minimum: 0
type: integer
required:
- createdAt
- id
- jobIds
- name
- organizationId
- payload
- type
- updatedAt
- version
type: object
ItemsCollectionReadOpenAi:
properties:
items:
default: []
items:
$ref: '#/components/schemas/ReadOpenAi'
type: array
type: object
OpenAi:
description: The payload containing integration data.
properties:
apiKey:
description: Masked API key for OpenAI
example: '**************ey'
readOnly: true
type: string
supportsEmbedding:
description: Whether this provider offers an embeddings API and can back agent investigation memory.
readOnly: true
type: boolean
validateKeysOnSave:
default: true
description: Indicates whether to validate the API key when saving.
example: true
type: boolean
type: object
x-type:
type: openai
SecretApi:
description: Secret wrapper for API responses
properties:
secret:
description: The secret value
type: string
required:
- secret
type: object
WriteOpenAi:
properties:
name:
description: Name of the integration.
example: my_integration
pattern: '[a-zA-Z0-9 _-]{1,128}'
type: string
payload:
$ref: '#/components/schemas/OpenAi'
teamIds:
default: []
description: The team IDs that this integration is associated with.
items:
description: The team IDs that this integration is associated with.
type: string
type: array
uniqueItems: true
type:
description: The type of the integration. This is used to determine the payload type.
enum:
- openai
type: string
version:
description: Version of the integration. Should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.
example: 0
format: int32
minimum: 0
type: integer
required:
- name
- payload
- type
- version
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