Seekr

Seekr Files API

The Files API from Seekr — 14 operation(s) for files.

GitHub OpenAPI

Operations 16

GET /v1/flow/files List Files #
PUT /v1/flow/files File Upload #
GET /v1/flow/files/token-counts File Token Counts #
DELETE /v1/flow/files/{file_id} Delete File #
GET /v1/flow/files/{file_id} File Download #
PUT /v1/flow/bulk_files Bulk File Upload #
GET /v1/flow/files/{file_id}/content File Download Content #
POST /v1/flow/files/validate_metadata File Validate Metadata #
GET /v1/flow/files/{file_id}/vector-dbs Get File Vector Dbs #
GET /v1/flow/files/{file_id}/data-jobs Get File Data Jobs #
GET /v1/flow/files/{file_id}/derived-files Get File Derived Files #
PUT /v1/flow/files/{file_id}/rename Rename File #
GET /v1/flow/events/files/{file_id} Get File Events By Id #
POST /v1/files Route Files #
GET /v1/files/{file_id} Route Get File #
GET /v1/files/{file_id}/content Route Get File Content #

Documentation

📖
Documentation
https://docs.seekr.com/flow
📖
APIReference
https://docs.seekr.com/flow/reference/getting-started-with-your-api
📖
Authentication
https://artifacts.apis.io/seekr/authentication/seekr-authentication.yml
📖
Documentation
https://docs.seekr.com/flow/components/agents
📖
Documentation
https://docs.seekr.com/flow/components/explainability
📖
Documentation
https://docs.seekr.com/flow/sdk/getting-started

Specifications

⚙
OpenAPI
https://artifacts.apis.io/seekr/openapi/seekr-files-api-openapi.yml

Other Resources

🔗
Conventions
https://artifacts.apis.io/seekr/conventions/seekr-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/seekr/errors/seekr-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/seekr/data-model/seekr-data-model.yml

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/seekr:seekr-files-api"
All apis 
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.

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

seekr-files-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Seekr Files API
  contact:
    name: Seekr API Support
    url: http://www.seekr.com/contact
    email: contact@seekr.com
  termsOfService: http://www.seekr.com/support
  version: '1.0'
  description: 'Operations tagged Files across 2 of this provider''s published API definitions: seekr-llm-training-openapi-original.json, seekr-serving-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://flow.seekr.com
  description: SeekrBuild server base URL
tags:
- name: Files
paths:
  /v1/flow/files:
    get:
      tags:
      - Files
      summary: List Files
      operationId: list_files_v1_flow_files_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 1000
          minimum: 1
          default: 250
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      - name: sort_by
        in: query
        required: false
        schema:
          type: string
          pattern: ^(created_at|filename|type|bytes)$
          default: created_at
          title: Sort By
      - name: sort_order
        in: query
        required: false
        schema:
          type: string
          pattern: ^(asc|desc)$
          default: desc
          title: Sort Order
      - name: purpose
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            pattern: ^(ingestion|vector-ingestion|alignment|reinforcement-fine-tune|fine-tune|pre-train|preference-fine-tune)?$
          - type: 'null'
          title: Purpose
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileList'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - Files
      summary: File Upload
      description: Handle single file upload endpoint.
      operationId: file_upload_v1_flow_files_put
      security:
      - APIKeyHeader: []
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_file_upload_v1_flow_files_put'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileResponse'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/files/token-counts:
    get:
      tags:
      - Files
      summary: File Token Counts
      operationId: file_token_counts_v1_flow_files_token_counts_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: file_ids
        in: query
        required: true
        schema:
          type: array
          items:
            type: string
          title: File Ids
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema: {}
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/files/{file_id}:
    delete:
      tags:
      - Files
      summary: Delete File
      operationId: delete_file_v1_flow_files__file_id__delete
      security:
      - APIKeyHeader: []
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileDeleteResponse'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Files
      summary: File Download
      operationId: file_download_v1_flow_files__file_id__get
      security:
      - APIKeyHeader: []
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileResponse'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/bulk_files:
    put:
      tags:
      - Files
      summary: Bulk File Upload
      description: Handle bulk file upload with validation per file.
      operationId: bulk_file_upload_v1_flow_bulk_files_put
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_bulk_file_upload_v1_flow_bulk_files_put'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/FileResponse'
                type: array
                title: Response Bulk File Upload V1 Flow Bulk Files Put
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - APIKeyHeader: []
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/files/{file_id}/content:
    get:
      tags:
      - Files
      summary: File Download Content
      operationId: file_download_content_v1_flow_files__file_id__content_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema: {}
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/files/validate_metadata:
    post:
      tags:
      - Files
      summary: File Validate Metadata
      operationId: file_validate_metadata_v1_flow_files_validate_metadata_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AlignFileMetadataValidationReq'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema: {}
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - APIKeyHeader: []
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/files/{file_id}/vector-dbs:
    get:
      tags:
      - Files
      summary: Get File Vector Dbs
      operationId: get_file_vector_dbs_v1_flow_files__file_id__vector_dbs_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdList'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/files/{file_id}/data-jobs:
    get:
      tags:
      - Files
      summary: Get File Data Jobs
      operationId: get_file_data_jobs_v1_flow_files__file_id__data_jobs_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdList'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/files/{file_id}/derived-files:
    get:
      tags:
      - Files
      summary: Get File Derived Files
      operationId: get_file_derived_files_v1_flow_files__file_id__derived_files_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdList'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/files/{file_id}/rename:
    put:
      tags:
      - Files
      summary: Rename File
      operationId: rename_file_v1_flow_files__file_id__rename_put
      security:
      - APIKeyHeader: []
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileRenameRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileResponse'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/flow/events/files/{file_id}:
    get:
      tags:
      - Files
      summary: Get File Events By Id
      operationId: get_file_events_by_id_v1_flow_events_files__file_id__get
      security:
      - APIKeyHeader: []
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEventsResponse'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/files:
    post:
      summary: Route Files
      description: 'Handle file upload requests and save the files to the configured storage.


        Args:

        request (Request): The incoming HTTP request.


        Returns:

        JSONResponse: A JSON response containing the file metadata.


        Raises:

        JSONResponse: A JSON response with a 400 status code if the request is invalid,

        or a 500 status code if an error occurs during file saving.'
      operationId: route_files_v1_files_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-excluded: true
      tags:
      - Files
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/files/{file_id}:
    get:
      summary: Route Get File
      operationId: route_get_file_v1_files__file_id__get
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-excluded: true
      tags:
      - Files
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
  /v1/files/{file_id}/content:
    get:
      summary: Route Get File Content
      operationId: route_get_file_content_v1_files__file_id__content_get
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-excluded: true
      tags:
      - Files
    servers:
    - url: https://flow.seekr.com
      description: SeekrBuild server base URL
components:
  schemas:
    AlignmentFileType:
      type: string
      enum:
      - html
      - md
      - rst
      - rtf
      - txt
      - xml
      - json
      - jsonl
      - csv
      - doc
      - docx
      - pdf
      - ppt
      - pptx
      title: AlignmentFileType
    FileResponse:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          const: file
          title: Object
        created_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Created At
        type:
          anyOf:
          - $ref: '#/components/schemas/TrainingFileType'
          - $ref: '#/components/schemas/AlignmentFileType'
          - type: 'null'
          title: Type
        purpose:
          anyOf:
          - $ref: '#/components/schemas/FilePurpose'
          - type: 'null'
        filename:
          anyOf:
          - type: string
          - type: 'null'
          title: Filename
        bytes:
          anyOf:
          - type: integer
          - type: 'null'
          title: Bytes
        created_by:
          anyOf:
          - type: string
          - type: 'null'
          title: Created By
        original_file_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Original File Id
        deleted:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Deleted
      additionalProperties: true
      type: object
      required:
      - id
      - object
      title: FileResponse
      description: Files API response type
    Body_file_upload_v1_flow_files_put:
      properties:
        purpose:
          $ref: '#/components/schemas/FilePurpose'
        files:
          type: string
          contentMediaType: application/octet-stream
          title: Files
        vector_database_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Vector Database Id
      type: object
      required:
      - purpose
      - files
      title: Body_file_upload_v1_flow_files_put
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    GetEventsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Event'
          type: array
          title: Data
      type: object
      required:
      - data
      title: GetEventsResponse
    FileDeleteResponse:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          const: file
          title: Object
        deleted:
          type: boolean
          title: Deleted
      additionalProperties: true
      type: object
      required:
      - id
      - object
      - deleted
      title: FileDeleteResponse
    FileRenameRequest:
      properties:
        new_filename:
          type: string
          title: New Filename
      type: object
      required:
      - new_filename
      title: FileRenameRequest
    EventStatus:
      type: string
      enum:
      - Inactive
      - Pending
      - Active
      - Failed
      - Started
      - Success
      - Uploading
      - Completed
      - Deleted
      - Cancelled
      - Queued
      - Running
      title: EventStatus
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    AlignFileMetadataValidationReq:
      properties:
        purpose:
          type: string
          title: Purpose
        suffix:
          type: string
          title: Suffix
        size:
          type: integer
          title: Size
      additionalProperties: true
      type: object
      required:
      - purpose
      - suffix
      - size
      title: AlignFileMetadataValidationReq
    FileList:
      properties:
        object:
          anyOf:
          - type: string
            const: list
          - type: 'null'
          title: Object
        data:
          anyOf:
          - items:
              $ref: '#/components/schemas/FileResponse'
            type: array
          - type: 'null'
          title: Data
      additionalProperties: true
      type: object
      title: FileList
    FilePurpose:
      type: string
      enum:
      - reinforcement-fine-tune
      - fine-tune
      - preference-fine-tune
      - pre-train
      - alignment
      title: FilePurpose
    Body_bulk_file_upload_v1_flow_bulk_files_put:
      properties:
        purpose:
          $ref: '#/components/schemas/FilePurpose'
        files:
          items:
            type: string
            contentMediaType: application/octet-stream
          type: array
          title: Files
      type: object
      required:
      - purpose
      - files
      title: Body_bulk_file_upload_v1_flow_bulk_files_put
    EventType:
      type: string
      enum:
      - Files
      - Finetune
      - Deployments
      - Alignment
      title: EventType
    TrainingFileType:
      type: string
      enum:
      - jsonl
      - parquet
      - pt
      title: TrainingFileType
    Event:
      properties:
        id:
          type: integer
          title: Id
        type:
          $ref: '#/components/schemas/EventType'
        type_id:
          type: string
          title: Type Id
        status:
          $ref: '#/components/schemas/EventStatus'
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - type
      - type_id
      - status
      - created_at
      title: Event
    IdList:
      properties:
        object:
          type: string
          const: list
          title: Object
          default: list
        data:
          items:
            type: string
          type: array
          title: Data
      additionalProperties: true
      type: object
      required:
      - data
      title: IdList
      description: Generic response model for a list of resource IDs.
    ValidationError_2:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      description: Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.
      in: header
      name: Authorization
x-refined-from:
- seekr-llm-training-openapi-original.json
- seekr-serving-openapi-original.json