Fulcra

Fulcra Files API

The files API from Fulcra — 8 operation(s) for files.

GitHub OpenAPI

Operations 12

GET /input/v1/file Return a list of file upload inputs #
POST /input/v1/file Create a file upload input #
DELETE /input/v1/file/{input_id} Delete a file upload input #
GET /input/v1/file/{input_id} Return a file upload input #
GET /input/v1/file/{input_id}/download Download a file upload input #
POST /input/v1/file/{input_id}/restore Restore an archived file upload input #
GET /input/v1/file_upload Return a list of file upload inputs #
POST /input/v1/file_upload Create a file upload input #
DELETE /input/v1/file_upload/{input_id} Delete a file upload input #
GET /input/v1/file_upload/{input_id} Return a file upload input #
GET /input/v1/file_upload/{input_id}/download Download a file upload input #
POST /input/v1/file_upload/{input_id}/restore Restore an archived file upload input #

Specifications

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

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/fulcradynamics-com/json-schema/fulcradynamics-com-fulcra-file-upload-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/fulcradynamics-com/json-schema/fulcradynamics-com-create-file-upload-request-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/fulcradynamics-com/json-schema/fulcradynamics-com-list-file-upload-response-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/fulcradynamics-com/json-schema/fulcradynamics-com-create-file-upload-response-body-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/fulcradynamics-com:fulcradynamics-com-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

fulcradynamics-com-files-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: contact@fulcradynamics.com
    name: Fulcra Dynamics
    url: https://www.fulcradynamics.com/
  description: REST API for interacting with the Fulcra Platform and Data Store
  termsOfService: https://www.fulcradynamics.com/legal/terms-of-use
  title: Fulcra Life Files API
  version: 1.0.0
servers:
- url: https://api.fulcradynamics.com
  description: Fulcra Life API
security:
- bearerAuth: []
tags:
- name: Files
paths:
  /input/v1/file:
    get:
      operationId: input-v1-file-get-file-upload-inputs
      parameters:
      - explode: false
        in: query
        name: path
        schema:
          default: /
          type: string
      - explode: false
        in: query
        name: name
        schema:
          type: string
      - explode: false
        in: query
        name: state
        schema:
          default:
          - created
          - uploaded
          items:
            enum:
            - created
            - uploaded
            - archived
            - deleted
            type: string
          type:
          - array
          - 'null'
      - explode: false
        in: query
        name: include_archived
        schema:
          default: false
          deprecated: true
          type: boolean
      - explode: false
        in: query
        name: include_deleted
        schema:
          default: false
          deprecated: true
          type: boolean
      - explode: false
        in: query
        name: start_time
        schema:
          format: date-time
          type: string
      - explode: false
        in: query
        name: end_time
        schema:
          format: date-time
          type: string
      - explode: false
        in: query
        name: fulcra_userid
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFileUploadResponseBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Return a list of file upload inputs
      tags:
      - Files
    post:
      operationId: input-v1-file-create-file-upload-input
      parameters:
      - in: header
        name: origin
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFileUploadRequestBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateFileUploadResponseBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Create a file upload input
      tags:
      - Files
  /input/v1/file/{input_id}:
    delete:
      operationId: input-v1-file-delete-file-upload-input
      responses:
        '204':
          description: No Content
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Delete a file upload input
      tags:
      - Files
    get:
      operationId: input-v1-file-get-file-upload-input
      parameters:
      - explode: false
        in: query
        name: fulcra_userid
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulcraFileUploadInput'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Return a file upload input
      tags:
      - Files
  /input/v1/file/{input_id}/download:
    get:
      operationId: input-v1-file-download-file-upload-input
      parameters:
      - explode: false
        in: query
        name: fulcra_userid
        schema:
          type: string
      responses:
        '200':
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Download a file upload input
      tags:
      - Files
  /input/v1/file/{input_id}/restore:
    post:
      operationId: input-v1-file-restore-file-upload-input
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulcraFileUploadInput'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Restore an archived file upload input
      tags:
      - Files
  /input/v1/file_upload:
    get:
      deprecated: true
      operationId: input-v1-file_upload-get-file-upload-inputs
      parameters:
      - explode: false
        in: query
        name: path
        schema:
          default: /
          type: string
      - explode: false
        in: query
        name: name
        schema:
          type: string
      - explode: false
        in: query
        name: state
        schema:
          default:
          - created
          - uploaded
          items:
            enum:
            - created
            - uploaded
            - archived
            - deleted
            type: string
          type:
          - array
          - 'null'
      - explode: false
        in: query
        name: include_archived
        schema:
          default: false
          deprecated: true
          type: boolean
      - explode: false
        in: query
        name: include_deleted
        schema:
          default: false
          deprecated: true
          type: boolean
      - explode: false
        in: query
        name: start_time
        schema:
          format: date-time
          type: string
      - explode: false
        in: query
        name: end_time
        schema:
          format: date-time
          type: string
      - explode: false
        in: query
        name: fulcra_userid
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFileUploadResponseBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Return a list of file upload inputs
      tags:
      - Files
    post:
      deprecated: true
      operationId: input-v1-file_upload-create-file-upload-input
      parameters:
      - in: header
        name: origin
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFileUploadRequestBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateFileUploadResponseBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Create a file upload input
      tags:
      - Files
  /input/v1/file_upload/{input_id}:
    delete:
      deprecated: true
      operationId: input-v1-file_upload-delete-file-upload-input
      responses:
        '204':
          description: No Content
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Delete a file upload input
      tags:
      - Files
    get:
      deprecated: true
      operationId: input-v1-file_upload-get-file-upload-input
      parameters:
      - explode: false
        in: query
        name: fulcra_userid
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulcraFileUploadInput'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Return a file upload input
      tags:
      - Files
  /input/v1/file_upload/{input_id}/download:
    get:
      deprecated: true
      operationId: input-v1-file_upload-download-file-upload-input
      parameters:
      - explode: false
        in: query
        name: fulcra_userid
        schema:
          type: string
      responses:
        '200':
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Download a file upload input
      tags:
      - Files
  /input/v1/file_upload/{input_id}/restore:
    post:
      deprecated: true
      operationId: input-v1-file_upload-restore-file-upload-input
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulcraFileUploadInput'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Restore an archived file upload input
      tags:
      - Files
components:
  schemas:
    CreateFileUploadResponseBody:
      additionalProperties: false
      properties:
        file:
          $ref: '#/components/schemas/FulcraFileUploadInput'
        url:
          type: string
      required:
      - file
      - url
      type: object
    FulcraFileUploadInput:
      additionalProperties: false
      properties:
        archived_at:
          format: date-time
          type:
          - string
          - 'null'
        created_at:
          format: date-time
          type: string
        deleted_at:
          format: date-time
          type:
          - string
          - 'null'
        fulcra_userid:
          type: string
        id:
          type: string
        last_scanned:
          format: date-time
          type:
          - string
          - 'null'
        name:
          type: string
        path:
          type: string
        restored_from_id:
          type: string
        scan_state:
          type: string
        size:
          format: int64
          type: integer
        source_data_types:
          items:
            $ref: '#/components/schemas/FulcraFileUploadDataType'
          type:
          - array
          - 'null'
        source_id:
          type:
          - string
          - 'null'
        source_name:
          type:
          - string
          - 'null'
        state:
          type: string
        uploaded_at:
          format: date-time
          type:
          - string
          - 'null'
      required:
      - id
      - fulcra_userid
      - created_at
      - state
      - scan_state
      - last_scanned
      - name
      - path
      - size
      - source_name
      - source_id
      - source_data_types
      - deleted_at
      - uploaded_at
      - archived_at
      - restored_from_id
      type: object
    FulcraFileUploadDataType:
      additionalProperties: false
      properties:
        data_type:
          type: string
        state:
          type: string
      required:
      - data_type
      - state
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        detail:
          description: A human-readable explanation specific to this occurrence of the problem.
          examples:
          - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
          - array
          - 'null'
        instance:
          description: A URI reference that identifies the specific occurrence of the problem.
          examples:
          - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
          - 400
          format: int64
          type: integer
        title:
          description: A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
          examples:
          - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
          - https://example.com/errors/example
          format: uri
          type: string
      type: object
    ListFileUploadResponseBody:
      additionalProperties: false
      properties:
        files:
          items:
            $ref: '#/components/schemas/FulcraFileUploadInput'
          type:
          - array
          - 'null'
        folders:
          items:
            type: string
          type:
          - array
          - 'null'
      required:
      - folders
      - files
      type: object
    CreateFileUploadRequestBody:
      additionalProperties: false
      properties:
        content_length:
          format: int64
          type: integer
        content_type:
          type: string
        name:
          type: string
        path:
          type: string
      required:
      - name
      - path
      - content_type
      - content_length
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT