Grepr Files API

The Files API from Grepr — 1 operation(s) for files.

Operations 1

POST /v1/files/upload/presigned-url Generate a presigned URL for uploading a file #

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-files-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-files-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Grepr Files API
  version: 1.0.0
  description: 'Operations tagged Files 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: Files
paths:
  /v1/files/upload/presigned-url:
    post:
      description: Generates a presigned URL that allows the client to upload a file directly. The file will be automatically deleted after 24 hours.
      operationId: generatePresignedUrl
      parameters:
      - in: query
        name: fileSizeBytes
        required: true
        schema:
          format: int64
          minimum: 1
          type: integer
      - description: 'File format. Valid values: json, plaintext'
        in: query
        name: format
        required: true
        schema:
          enum:
          - json
          - plaintext
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PresignedUploadUrlResponse'
          description: Presigned URL generated successfully
        '400':
          description: Invalid parameters (file too large, unsupported format, etc.)
        '401':
          description: Unauthorized
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Generate a presigned URL for uploading a file
      tags:
      - Files
components:
  schemas:
    PresignedUploadUrlResponse:
      description: Presigned URL for uploading a file
      properties:
        expiresAt:
          description: Timestamp when the presigned URL expires
          example: '2024-01-15T10:30:00Z'
          type: string
        orgId:
          description: Organization ID that owns this upload
          example: org-123
          type: string
        presignedUrl:
          description: Presigned URL that can be used to upload files
          example: https://grepr-pipeline-uploads.s3.amazonaws.com/org-123/upload-456/file.json?X-Amz-Algorithm=...
          type: string
        uploadId:
          description: Unique identifier for this upload. Pass it as the uploadId of a grepr-uploaded-log-file-source to read the uploaded file.
          example: 3f2b8c1e-9a4d-4e7b-8c2a-1d5e6f7a8b9c
          pattern: '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}'
          type: string
      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