> ## Documentation Index
> Fetch the complete documentation index at: https://docs.file.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# About the fileAI API

> Explore the core capabilities of the fileAI API

Our fileAI API is organized around REST and uses standard HTTP methods (POST, GET, PATCH) to interact with resource objects. It uses JSON as the primary data format, and all requests should have a Content-Type of application/json.

## Key Features

These API endpoints are the building blocks for all your file ingestion needs. They can be used individually or in conjunction to create powerful end-to-end workflows.

<CardGroup cols={2}>
  <Card title="File Upload & Management" icon="cloud-arrow-up" iconType="solid" href="/docs-api/upload">
    Upload, retrieve and manage files in various formats in fileAI (includes sources, citations, location data and more)
  </Card>

  <Card title="Smart File Processing" icon="wand-magic-sparkles" iconType="solid">
    Proprietary AI OCR with cross-file extraction and custom AI schemas
  </Card>

  <Card title="Dynamic AI Schemas" icon="diagram-project" iconType="solid" href="/docs-user-guide/core/ai-schemas">
    Auto-generated data structures that adapt to your files, fetch cross-file data (coming soon) and online data all in one workflow
  </Card>

  <Card title="Enterprise Ready" icon="shield-check" iconType="solid">
    Secure, scalable, and built for production workloads (SOCII, ISO27001)
  </Card>

  <Card title="Easy Integration" icon="code" iconType="solid">
    RESTful API with callback URLs for real-time updates
  </Card>

  <Card title="Health Check Endpoint" icon="heart-pulse" iconType="solid">
    Quickly verify system status and availability
  </Card>
</CardGroup>

Our fileAI API is organized around REST and uses standard HTTP methods (POST, GET, PATCH) to interact with resource objects. It uses JSON as the primary data format, and all requests should have a Content-Type of application/json.

## Prerequisites for using the fileAI API

Before using our API, please ensure you complete the following prerequisites:

<CardGroup cols={2}>
  <Card title="You must have a fileAI account" icon="user-plus" iconType="solid">
    To use our API endpoints, you need to sign up or login [here](https://orion.file.ai/en/sign-up). Both self-serve and enterprise accounts are supported.
  </Card>

  <Card title="You must have an API Key" icon="key" iconType="solid">
    After creating your fileAI account, you can generate your API Key.
  </Card>
</CardGroup>

<Card title="You must verify an AI Schema" icon="shield-check">
  fileAI suggests extraction and data fetch schemas. Confirm or edit these in the UI to call them directly via MCP.
</Card>

### **How to get an API token**

1. Go to **API Keys**
2. Click **Create API Key**
3. Name the token, set expiration and permission
4. Click **Generate API Key**
5. Token will be shown, click **Copy & Close**

<Note>
  Note: Only admins can create API keys.
</Note>

***

### **How to authorize an API token**

1. Once you have your API key, go to the API documentation page:

<Note>
  [https://api.orion.file.ai/prod/v1/docs/swagger-ui](https://api.orion.file.ai/prod/v1/docs/swagger-ui)
</Note>

2. Click the Authorize button on the right of this page (the green Authorize button with lock icon)
3. Enter your API Key under <u>Value</u>
4. Click <u>Authorize</u> to start making authenticated requests directly from the documentation

<Note>
  If you need any further assistance, please reach out to our team at [support@file.ai](mailto:support@file.ai)
</Note>