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

# CA Colombia API Documentation

> The CA Colombia API powers a Roblox roleplay platform with authentication, character management, in-game economy, banking, and real-time WebSocket events.

Welcome to the CA Colombia API — the backend service powering the CA Colombia roleplay platform. This documentation covers everything you need to integrate with the API: authenticating users, managing characters, handling an in-game economy, operating banks, and receiving real-time events over WebSocket.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Make your first API call in minutes — authenticate and retrieve a user profile.
  </Card>

  <Card title="Authentication" icon="lock" href="/authentication">
    Learn how cookie-based sessions and OAuth work with Discord and Roblox.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Full reference for every endpoint: requests, responses, and error codes.
  </Card>

  <Card title="WebSocket Guide" icon="bolt" href="/guides/websocket">
    Subscribe to real-time events for users and characters.
  </Card>
</CardGroup>

## What the API Provides

The CA Colombia API is organized around a set of core resources. Each resource maps directly to a feature in the platform:

<CardGroup cols={3}>
  <Card title="Users" icon="user" href="/concepts/users-and-providers">
    Linked Discord and Roblox identities for every player.
  </Card>

  <Card title="Characters" icon="person" href="/concepts/characters">
    In-game personas with biographical data, IDs, and approval workflows.
  </Card>

  <Card title="Economy" icon="coins" href="/concepts/economy">
    Per-character wallets tracking cash and bank balances.
  </Card>

  <Card title="Banking" icon="building-columns" href="/guides/banking">
    Create and manage banks and multi-account banking systems.
  </Card>

  <Card title="OAuth" icon="key" href="/guides/oauth-flow">
    Authenticate players via Discord or Roblox using an OAuth 2.0 flow.
  </Card>

  <Card title="Permissions" icon="shield" href="/concepts/permissions">
    Role-based access control governing what each caller can do.
  </Card>
</CardGroup>

## Getting Started

<Steps>
  <Step title="Connect your accounts">
    Authenticate via the Discord or Roblox OAuth flow to obtain a session. See the [OAuth Flow guide](/guides/oauth-flow) for step-by-step instructions.
  </Step>

  <Step title="Create a character">
    Use `POST /v1/users/{userId}/characters` to create your first in-game character. The character starts in **draft** status.
  </Step>

  <Step title="Submit for approval">
    Call `POST /v1/users/{userId}/characters/{characterId}/submit` to send the character to staff for review.
  </Step>

  <Step title="Go live">
    Once a staff member approves the character, the wallet activates and the character is ready to interact with the economy and banking system.
  </Step>
</Steps>

<Note>
  All API calls require a valid session cookie. See the [Authentication](/authentication) page to understand how sessions are issued and refreshed automatically.
</Note>