---
title: "List Agent Composer Templates"
method: GET
path: "/agents/templates/acl"
tags: ["/agents"]
---

# List Agent Composer Templates

`GET /agents/templates/acl`

## Request

- Base URL: `https://api.contextual.ai/v1`
- URL: `https://api.contextual.ai/v1/agents/templates/acl`
- Auth: HTTP bearer

Retrieve a list of all available Agent Composer Templates.

## Response `200`

Successful Response

- ListACLTemplatesResponse
  - `templates` ACLTemplateEntry[]: List of available Agent Composer templates.
    - `id` string, required: Unique identifier for the Agent Composer template
    - `name` string, required: Display name of the template
    - `description` string, required: Description of what this template is for
    - `badges` string[], nullable: Optional badge identifiers for UI presentation (e.g., 'dynamic-agent')
    - `template_name` string, required: The DB template name to use (e.g., 'finance', 'default')
    - `acl_config_name` 'default_query' | 'datastore_search' | 'web_search' | 'meta_queries' | 'structured_unstructured_search' | 'default_query_fine_grained' | 'conditional' | 'instant_search_test' | 'root_cause_analysis', required

## Changes

- **2026-10-16** `4abdda722de9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/contextualai/apis/endpoints/changes/agents/templates/acl/get.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) - [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/contextualai/apis/endpoints/revisions/4abdda722de9?raw)