Deep Insight Endpoints

The deep-insight endpoints expose fine-grained information extracted from source code analysis: functions, classes, Django ORM models, HTTP endpoints, contributors, and security patterns. Every endpoint on this page requires the operations bearer token. See Authentication.

JSON values on this page are illustrative response shapes, not live inventory totals. Counts, contributor activity, and extracted properties depend on the current enrichment snapshot; use the API response as the source of truth.

Common tasks

Goal	Request	Useful parameters
Find complex functions to review	`GET /api/functions`	`repo`, `min_complexity`, `limit`.
Inspect a model’s fields	`GET /api/models/{model_name}/fields`	`repo` when names are shared.
Triage security findings	`GET /api/security`	`repo`, `severity`, `limit`.

All deep-insight endpoints

List Functions

GET /api/functions

Returns functions extracted from Python and JavaScript source files across all repositories.

Query Parameters

Parameter	Type	Default	Description
`repo`	string	—	Filter to a specific repository name.
`name`	string	—	Filter by function name substring.
`min_complexity`	integer	—	Only functions with complexity >= this value.
`limit`	integer	`50`	Maximum results to return (max 500).

Examples

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/functions?min_complexity=15&limit=20"

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/functions?repo=forwardlane-backend&limit=100"

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/functions?name=authenticate"

Response

{
  "items": [
    {
      "name": "validate_portfolio_allocation",
      "repo": "forwardlane-backend",
      "file_path": "apps/portfolios/validators.py",
      "args": ["allocation_data", "user", "strict"],
      "decorators": ["@transaction.atomic"],
      "docstring": "Validate that portfolio allocations sum to 100% and respect risk limits.",
      "line_count": 87,
      "complexity": 22
    }
  ],
  "total": 18420,
  "limit": 50
}

List Classes

GET /api/classes

Returns class definitions extracted from source files.

Query Parameters

Parameter	Type	Default	Description
`repo`	string	—	Filter to a specific repository.
`name`	string	—	Filter by class name substring.
`limit`	integer	`50`	Maximum results to return.

Example

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/classes?repo=forwardlane-backend&name=Serializer&limit=30"

Response

{
  "items": [
    {
      "name": "PortfolioSerializer",
      "repo": "forwardlane-backend",
      "file_path": "apps/portfolios/serializers.py",
      "bases": ["ModelSerializer"],
      "method_count": 8,
      "docstring": "Serializer for the Portfolio model with nested asset data.",
      "line_count": 112
    }
  ],
  "total": 4210,
  "limit": 50
}

List Django Models

GET /api/models

Returns Django ORM model classes discovered across all repositories.

Query Parameters

Parameter	Type	Default	Description
`repo`	string	—	Filter to a specific repository.
`name`	string	—	Filter by model name substring.
`limit`	integer	`50`	Maximum results to return.

Example

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/models?repo=forwardlane-backend"

Response

{
  "items": [
    {
      "name": "Portfolio",
      "repo": "forwardlane-backend",
      "file_path": "apps/portfolios/models.py",
      "field_count": 18,
      "has_meta": true,
      "docstring": "Represents a client's investment portfolio."
    }
  ],
  "total": 312,
  "limit": 50
}

Get Model Fields

GET /api/models/{model_name}/fields

Returns all field definitions for a specific Django model. Use the repo query parameter to disambiguate when the same model name exists in multiple repositories.

Path Parameters

Parameter	Type	Description
`model_name`	string	The Django model class name (e.g. `Portfolio`).

Query Parameters

Parameter	Type	Description
`repo`	string	Narrow to a specific repository when the model name is ambiguous.

Example

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/models/Portfolio/fields?repo=forwardlane-backend"

Response

{
  "model": "Portfolio",
  "repo": "forwardlane-backend",
  "fields": [
    {
      "name": "id",
      "field_type": "AutoField",
      "nullable": false,
      "indexed": true,
      "has_default": false,
      "fk_target": null
    },
    {
      "name": "user",
      "field_type": "ForeignKey",
      "nullable": false,
      "indexed": true,
      "has_default": false,
      "fk_target": "auth.User"
    },
    {
      "name": "name",
      "field_type": "CharField",
      "nullable": false,
      "indexed": false,
      "has_default": false,
      "fk_target": null
    },
    {
      "name": "risk_level",
      "field_type": "IntegerField",
      "nullable": true,
      "indexed": false,
      "has_default": true,
      "fk_target": null
    }
  ],
  "field_count": 18
}

List API Endpoints

GET /api/endpoints

Returns HTTP endpoints discovered via Django URL configuration parsing.

Query Parameters

Parameter	Type	Default	Description
`repo`	string	—	Filter to a specific repository.
`limit`	integer	`50`	Maximum results to return.

Example

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/endpoints?repo=forwardlane-backend&limit=50"

Response

{
  "items": [
    {
      "path": "/api/v1/portfolios/",
      "repo": "forwardlane-backend",
      "http_method": "GET",
      "view_name": "portfolio-list",
      "url_pattern": "^api/v1/portfolios/$"
    },
    {
      "path": "/api/v1/portfolios/{id}/",
      "repo": "forwardlane-backend",
      "http_method": "GET",
      "view_name": "portfolio-detail",
      "url_pattern": "^api/v1/portfolios/(?P<id>[^/.]+)/$"
    }
  ],
  "total": 1847,
  "limit": 50
}

List Contributors

GET /api/contributors

Returns Git contributors with activity statistics across all repositories.

Query Parameters

Parameter	Type	Default	Description
`min_commits`	integer	—	Only contributors with at least this many total commits.
`min_repos`	integer	—	Only contributors active in at least this many repos.
`limit`	integer	`50`	Maximum results to return.

Examples

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/contributors?min_commits=100&limit=20"

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/contributors?min_repos=5"

Response

{
  "items": [
    {
      "name": "Alex Chen",
      "email": "alex@forwardlane.com",
      "total_commits": 2341,
      "repos_count": 23,
      "first_seen": "2019-04-01T09:00:00Z",
      "last_seen": "2024-11-14T16:45:00Z"
    }
  ],
  "total": 47,
  "limit": 50
}

List Security Patterns

GET /api/security

Returns static-analysis findings for security-relevant code patterns.

Query Parameters

Parameter	Type	Default	Description
`repo`	string	—	Filter to a specific repository.
`severity`	string	—	Filter by severity: `high`, `medium`, `low`.
`limit`	integer	`50`	Maximum results to return.

Examples

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/security?severity=high"

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/security?repo=forwardlane-backend"

Response

{
  "items": [
    {
      "type": "hardcoded_secret",
      "repo": "fl-legacy-service",
      "file_path": "config/settings_dev.py",
      "severity": "high",
      "description": "Hardcoded API key found in configuration file"
    },
    {
      "type": "sql_injection_risk",
      "repo": "forwardlane-backend",
      "file_path": "apps/reports/queries.py",
      "severity": "medium",
      "description": "Raw SQL string formatting detected — use parameterized queries"
    },
    {
      "type": "eval_usage",
      "repo": "fl-scripting",
      "file_path": "scripts/data_transform.py",
      "severity": "medium",
      "description": "Use of eval() with potentially untrusted input"
    }
  ],
  "total": 84,
  "limit": 50
}

High-severity findings should be reviewed and remediated promptly. These patterns are detected statically and may include false positives, but all high severity items warrant manual review.

Deep Stats

GET /api/deep-stats

Returns node-type counts for all deep-insight entities. Useful for understanding the scale of analyzed code across the graph.

Example

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  https://api.agentic.forwardlane.com/api/deep-stats

Response

{
  "functions": 18420,
  "classes": 4210,
  "models": 312,
  "model_fields": 4840,
  "endpoints": 1847,
  "contributors": 47,
  "security_patterns": 84,
  "source_files": 9830,
  "test_cases": 6930,
  "dependencies": 2140,
  "config_files": 893,
  "repositories": 131,
  "total_nodes": 22104,
  "total_edges": 75735
}

​Deep Insight Endpoints

​Common tasks

​All deep-insight endpoints

​List Functions

​Query Parameters

​Examples

​Response

​List Classes

​Query Parameters

​Example

​Response

​List Django Models

​Query Parameters

​Example

​Response

​Get Model Fields

​Path Parameters

​Query Parameters

​Example

​Response

​List API Endpoints

​Query Parameters

​Example

​Response

​List Contributors

​Query Parameters

​Examples

​Response

​List Security Patterns

​Query Parameters

​Examples

​Response

​Deep Stats

​Example

​Response

Deep Insight Endpoints

Common tasks

All deep-insight endpoints

List Functions

Query Parameters

Examples

Response

List Classes

Query Parameters

Example

Response

List Django Models

Query Parameters

Example

Response

Get Model Fields

Path Parameters

Query Parameters

Example

Response

List API Endpoints

Query Parameters

Example

Response

List Contributors

Query Parameters

Examples

Response

List Security Patterns

Query Parameters

Examples

Response

Deep Stats

Example

Response