> For the complete documentation index, see [llms.txt](https://docs.tokensource.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tokensource.com/context.md).

# Context

TokenSource context management provides a flexible framework for managing AI assistant behaviors and capabilities within the financial services ecosystem. This system implements a primary association between contexts and AI assistants, with optional linking to specific objectives or projects.

## Core Architecture

### Primary Context-Assistant Association

The system establishes a direct relationship between contexts and AI assistants, ensuring:

* Each AI assistant maintains a default context that defines its base behavior and knowledge domain
* Contexts contain specific rules, constraints, and knowledge bases tailored to financial operations
* Multiple assistants can share standardized contexts for consistent behavior across services
* Context definitions include specialized knowledge for payment processing, compliance, and security protocols

### Secondary Context-Objective Association

The system supports dynamic context assignment to objectives through:

* Flexible context switching based on project phases or requirements
* Optional linking between contexts and specific project objectives
* Support for multiple assistant personalities within a single project
* Dynamic context adaptation for different stages of financial workflows

**Base Path:** `/v1/contexts`

## Get All Contexts

**Method:** `GET`\
**Endpoint:** `https://api.tokensource.com/v1/contexts`\
**Description:** Retrieves all contexts for the authenticated user.

**Response (200 OK):**

```json
{
  "status": 200,
  "data": [
    {
      "id": 1,
      "name": "Context A",
      "instructionCommentary": "Instructions for context A",
      "apiVersion": "v1",
      "authenticationMethod": "Bearer Token",
      "responseFormat": "JSON",
      "userId": 1
    }
  ]
}
```

## Get Context by ID

**Method:** `GET`\
**Endpoint:** `https://api.tokensource.com/v1/contexts/{id}`\
**Description:** Retrieves a specific context by its ID.

**Parameters:**

* `id` (integer, required)

**Response (200 OK):**

```json
{
  "status": 200,
  "data": {
    "id": 1,
    "name": "Context A",
    "instructionCommentary": "Instructions for context A",
    "apiVersion": "v1",
    "authenticationMethod": "Bearer Token",
    "responseFormat": "JSON",
    "userId": 1,
    "components": [
      { "id": 1, "name": "Component X" },
      { "id": 2, "name": "Component Y" }
    ]
  }
}
```

**Response (404 Not Found):**

```json
{
  "status": 404,
  "message": "Context not found"
}
```

## Create Context

**Method:** `POST`\
**Endpoint:** `https://api.tokensource.com/v1/contexts`\
**Description:** Creates a new context.

**Request Body:**

```json
{
  "name": "Context B",
  "instructionCommentary": "Instructions for context B",
  "apiVersion": "v2",
  "authenticationMethod": "API Key",
  "responseFormat": "XML"
}
```

**Response (201 Created):**

```json
{
  "status": 201,
  "data": {
    "id": 2,
    "name": "Context B",
    "instructionCommentary": "Instructions for context B",
    "apiVersion": "v2",
    "authenticationMethod": "API Key",
    "responseFormat": "XML",
    "userId": 1
  }
}
```

## Update Context

**Method:** `PUT`\
**Endpoint:** `https://api.tokensource.com/v1/contexts/{id}`\
**Description:** Updates an existing context.

**Parameters:**

* `id` (integer, required)

**Request Body:**

```json
{
  "name": "Context A Updated",
  "instructionCommentary": "Updated instructions",
  "apiVersion": "v1.1",
  "authenticationMethod": "OAuth 2.0",
  "responseFormat": "JSON"
}
```

**Response (200 OK):**

```json
{
  "status": 200,
  "message": "Context updated successfully"
}
```

## Delete Context

**Method:** `DELETE`\
**Endpoint:** `https://api.tokensource.com/v1/contexts/{id}`\
**Description:** Deletes a context.

**Parameters:**

* `id` (integer, required)

**Response (200 OK):**

```json
{
  "status": 200,
  "message": "Context deleted successfully"
}
```

## Generate and Save Context

**Method:** `POST`\
**Endpoint:** `https://api.tokensource.com/v1/contexts/generate`\
**Description:** Generates and saves a new context.

**Request Body:**

```json
{
  "input": "Some input text for context generation",
  "categoryId": 1
}
```

**Response (201 Created):**

```json
{
  "status": 201,
  "message": "Context generated and saved successfully"
}
```

## Related Endpoints

### Get All Components

**Method:** `GET`\
**Endpoint:** `https://api.tokensource.com/v1/contexts/components`\
(Refer to the Components section for the response format.)

### Get All Categories

**Method:** `GET`\
**Endpoint:** `https://api.tokensource.com/v1/contexts/categories`\
(Refer to the Categories section for the response format.)