Skip to content

List available forge templates

GET
/api/v1/forge/templates

Returns available forge templates filtered by type and/or domain. Includes public templates and, for Enterprise tenants, any private templates owned by the tenant.

Authorizations

Parameters

Query Parameters

template_type
Any of:
string

Filter by template type: ‘agent’ or ‘connector’

domain
Any of:
string

Filter by domain (e.g. ‘tiktok_marketing’, ‘accounting’)

Responses

200

Successful Response

Response for GET /api/v1/forge/templates.

Attributes: templates: List of matching forge templates. total: Total number of matching templates.

object
templates
required
Array<object>

A single forge template summary.

Attributes: id: Template UUID. template_type: ‘agent’ or ‘connector’. domain: Expertise domain (e.g. ‘tiktok_marketing’). display_name: Human-readable template name. quality_score: Template quality score (0.0-1.0). deployment_count: Number of times this template has been deployed. industries_served: List of industry tags. is_private: Whether this is a private enterprise template.

object
deployment_count
required
integer
display_name
required
string
domain
required
string
id
required
string
industries_served
required
Array<string>
is_private
required
boolean
quality_score
required
number
template_type
required
string
total
required
integer

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string