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

# API Introduction

> Programmatic access to GC AI for workflow automation

<Info>
  **Private Beta.** The GC AI API is currently in private beta. To request access, contact your account representative.
</Info>

## Overview

The GC AI External API allows you to integrate GC AI's legal AI capabilities into your workflows and applications. Perfect for:

* **Workflow automation** with tools like Zapier, Make, or n8n
* **Custom integrations** in your internal tools
* **Batch processing** of legal questions
* **Chatbots and assistants** powered by legal AI

## Current Limitations

The API is currently single-turn only. Each request is independent. Multi-turn conversations are not yet supported.

## Base URL

All API requests should be made to:

```
https://app.gc.ai/api/external/v1
```

## Authentication

All requests require an API key in the `Authorization` header:

```bash theme={null}
Authorization: gcai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

<Note>
  GC AI supports two scopes: **organization** and **personal**. Learn [which to use and how to govern them](/api-reference/concepts/api-keys).
</Note>

### Getting an API Key

Which scope you create depends on whether the integration belongs to the company or to a person (see [API Keys](/api-reference/concepts/api-keys)).

**For a company-owned integration (organization key):** an org admin opens **Settings → API → Organization API Keys** and clicks **+ Create API Key**. This needs no org-wide policy change.

**For an individual's own access (personal key):**

1. An org admin opens **Settings → API** and enables **Allow team to create personal API keys** (User API Keys Policy).
2. Each user opens **Settings → API → Personal API Keys** and clicks **+ Create API Key**.

Either way, copy and securely store the key. It is only shown once.

<Warning>
  Keep your API key secure. Anyone with your API key can make requests on behalf of your organization.
</Warning>

## Quick Start

Here's a simple example using curl:

```bash theme={null}
curl -X POST https://app.gc.ai/api/external/v1/chat/completions \
  -H "Authorization: gcai_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What are the key terms to look for in a software license agreement?",
    "file_ids": ["123e4567-e89b-12d3-a456-426614174000"]
  }'
```

Response:

```json theme={null}
{
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "kind": "chat/completions",
  "status": "succeeded",
  "result": {
    "result": "When reviewing a software license agreement, key terms to examine include:\n\n1. **License Grant** - Understand the scope of rights granted...",
    "chat_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "error": null,
  "created_at": "2026-04-30T20:00:00.000Z",
  "completed_at": "2026-04-30T20:00:02.000Z"
}
```

## Usage

Usage is tracked and viewable in the GC AI app under **Settings → API → View Usage**.

The API is free to test during the limited Beta period.

### Rate Limits

There are currently no strict rate limits, but we ask that you:

* Avoid excessive concurrent requests
* Contact us for high-volume use cases

## Support

For API support, reach out to your account representative.