Skip to content
UltimateTeam.ai Docs

List available forge templates

GET
/api/v1/forge/templates
curl --request GET \
  --url https://api.ultimateteam.ai/api/v1/forge/templates \
  --header 'X-API-Key: <X-API-Key>'

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

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “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

Section titled “ Responses ”

200

Section titled “200”

Successful Response

Media typeapplication/json
ForgeTemplateListResponse

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

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

object
templates
required
Templates
Array<object>
ForgeTemplateItem

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
Deployment Count
integer
display_name
required
Display Name
string
domain
required
Domain
string
id
required
Id
string
industries_served
required
Industries Served
Array<string>
is_private
required
Is Private
boolean
quality_score
required
Quality Score
number
template_type
required
Template Type
string
total
required
Total
integer
Examplegenerated
{
  "templates": [
    {
      "deployment_count": 1,
      "display_name": "example",
      "domain": "example",
      "id": "example",
      "industries_served": [
        "example"
      ],
      "is_private": true,
      "quality_score": 1,
      "template_type": "example"
    }
  ],
  "total": 1
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}