Skip to main content
POST
Create template

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Request model for creating or updating a crew template.

name
string
required

Human-readable template name.

crew_config
CrewConfig · object
required

The full crew configuration to save.

description
string
default:""

Optional description.

tags
string[]

Tags for categorization.

variables
TemplateVariable · object[]

Declared inputs the template's tasks expect. Empty list preserves the legacy free-form task_input behavior.

is_shared
boolean
default:false

Whether this template is visible to all users.

Response

Successful Response

Response model for a crew template returned from the API.

id
string
required
name
string
required
description
string
required
crew_config
CrewConfig · object
required

Configuration model for a CrewAI crew with agents and tasks.

tags
string[]
required
is_shared
boolean
required
created_by
string
required
updated_by
string
required
created_at
string
required
updated_at
string
required
variables
TemplateVariable · object[]
lint_warnings
string[]

Authoring-time warnings about drift between the declared variables and the {placeholders} referenced by tasks. Surfaced on create or update. Usually empty on read.