Skip to content
FractalOps

Create Studio Template

POST
/v1/admin/studio/templates
curl --request POST \
  --url 'https://example.com/v1/admin/studio/templates?tenant_id=' \
  --header 'Content-Type: application/json' \
  --data '{ "template_id": "example", "title": "example", "agent_process_kind": "", "issue_scope": "", "work_scope": "", "handoff_scope": "", "target_surface": "portal", "provider": "daytona", "execution_plane": "daytona-sandbox", "contention_policy": "promote-stack-on-lock", "promotion_targets": [ "example" ], "allowed_write_policy": "report-only", "pr_submission_policy": "selective-agent-pr", "pr_submitter_agent_ids": [ "example" ], "pr_submission_pipeline": "codexgate-github-app-pr", "required_identity_shape": "named_agent_microsoft", "required_dataset_scope": [ "example" ], "required_connectors": [ "example" ], "ontology_roots": [ "example" ], "scoped_entity_kinds": [ "example" ], "visibility_policy": "group-topology", "default_wave_plan": [ "example" ], "default_agent_ids": [ "example" ], "conditional_agent_ids": [ "example" ], "extension_packs": { "additionalProperty": [ "example" ] }, "agent_specs": [ { "agent_id": "example", "alias": "example", "title": "example", "agent_nickname": "", "agent_process_kind": "", "role_key": "", "agent_tier": "core", "agent_pack": "", "avatar_style": "", "avatar_source": "", "avatar_license": "", "avatar_seed": "", "avatar_url": "", "provider": "daytona", "principal_type": "ai", "execution_profile": "browser-ui", "route_pack": [ "example" ], "escalation_chain": [ "example" ], "workload_groups": [ "example" ], "focus_entities": [ "example" ], "ignore_entities": [ "example" ], "scenario_phase": "", "persona_target": "", "next_goal": "", "handoff_target": "", "mission_brief": "", "oss_watchlist": [ "example" ], "test_tracks": [ { "track_id": "example", "role_key": "", "title": "", "route_path": "", "acceptance_checks": [ "example" ], "evidence_requirements": [ "example" ], "actor_suit_id": "", "actor_account_ref": "", "actor_credential_ref": "", "actor_entry_state": "", "a2a_handoff_targets": [ "example" ], "replay_focus": "", "issue_label": "" } ], "allowed_write_policy": "report-only", "pr_submission_policy": "selective-agent-pr", "pr_submission_allowed": false, "pr_submission_pipeline": "", "issue_scope": "", "issue_sink": "", "handoff_scope": "", "handoff_targets": [ "example" ], "capabilities": [ "example" ], "handoff_profile_keys": [ "example" ], "handoff_capabilities": [ "example" ], "skill_ids": [ "example" ], "mcp_server_ids": [ "example" ], "memory_namespace": "", "provision": true, "activation_reason": "default" } ] }'

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
tenant_id
Tenant Id
string
""

Header Parameters

Section titled “Header Parameters”
X-FractalOps-Tenant-Id
Any of:
string
x-pomerium-jwt-assertion
Any of:
string

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
StudioTemplateIn
object
template_id
required
Template Id
string
title
required
Title
string
agent_process_kind
Agent Process Kind
string
""
issue_scope
Issue Scope
string
""
work_scope
Work Scope
string
""
handoff_scope
Handoff Scope
string
""
target_surface
Target Surface
string
default: portal
provider
Provider
string
default: daytona
execution_plane
Execution Plane
string
default: daytona-sandbox
contention_policy
Contention Policy
string
default: promote-stack-on-lock
promotion_targets
Promotion Targets
Array<string>
allowed_write_policy
Allowed Write Policy
string
default: report-only
pr_submission_policy
Pr Submission Policy
string
default: selective-agent-pr
pr_submitter_agent_ids
Pr Submitter Agent Ids
Array<string>
pr_submission_pipeline
Pr Submission Pipeline
string
default: codexgate-github-app-pr
required_identity_shape
Required Identity Shape
string
default: named_agent_microsoft
required_dataset_scope
Required Dataset Scope
Array<string>
required_connectors
Required Connectors
Array<string>
ontology_roots
Ontology Roots
Array<string>
scoped_entity_kinds
Scoped Entity Kinds
Array<string>
visibility_policy
Visibility Policy
string
default: group-topology
default_wave_plan
Default Wave Plan
Array<string>
default_agent_ids
Default Agent Ids
Array<string>
conditional_agent_ids
Conditional Agent Ids
Array<string>
extension_packs
Extension Packs
object
key
additional properties
Array<string>
agent_specs
Agent Specs
Array<object>
StudioTemplateAgentOut
object
agent_id
required
Agent Id
string
alias
required
Alias
string
title
required
Title
string
agent_nickname
Agent Nickname
string
""
agent_process_kind
Agent Process Kind
string
""
role_key
Role Key
string
""
agent_tier
Agent Tier
string
default: core
agent_pack
Agent Pack
string
""
avatar_style
Avatar Style
string
""
avatar_source
Avatar Source
string
""
avatar_license
Avatar License
string
""
avatar_seed
Avatar Seed
string
""
avatar_url
Avatar Url
string
""
provider
Provider
string
default: daytona
principal_type
Principal Type
string
default: ai
execution_profile
Execution Profile
string
default: browser-ui
route_pack
Route Pack
Array<string>
escalation_chain
Escalation Chain
Array<string>
workload_groups
Workload Groups
Array<string>
focus_entities
Focus Entities
Array<string>
ignore_entities
Ignore Entities
Array<string>
scenario_phase
Scenario Phase
string
""
persona_target
Persona Target
string
""
next_goal
Next Goal
string
""
handoff_target
Handoff Target
string
""
mission_brief
Mission Brief
string
""
oss_watchlist
Oss Watchlist
Array<string>
test_tracks
Test Tracks
Array<object>
StudioAgentRoleTestTrackOut
object
track_id
required
Track Id
string
role_key
Role Key
string
""
title
Title
string
""
route_path
Route Path
string
""
acceptance_checks
Acceptance Checks
Array<string>
evidence_requirements
Evidence Requirements
Array<string>
actor_suit_id
Actor Suit Id
string
""
actor_account_ref
Actor Account Ref
string
""
actor_credential_ref
Actor Credential Ref
string
""
actor_entry_state
Actor Entry State
string
""
a2a_handoff_targets
A2A Handoff Targets
Array<string>
replay_focus
Replay Focus
string
""
issue_label
Issue Label
string
""
allowed_write_policy
Allowed Write Policy
string
default: report-only
pr_submission_policy
Pr Submission Policy
string
default: selective-agent-pr
pr_submission_allowed
Pr Submission Allowed
boolean
pr_submission_pipeline
Pr Submission Pipeline
string
""
issue_scope
Issue Scope
string
""
issue_sink
Issue Sink
string
""
handoff_scope
Handoff Scope
string
""
handoff_targets
Handoff Targets
Array<string>
capabilities
Capabilities
Array<string>
handoff_profile_keys
Handoff Profile Keys
Array<string>
handoff_capabilities
Handoff Capabilities
Array<string>
skill_ids
Skill Ids
Array<string>
mcp_server_ids
Mcp Server Ids
Array<string>
memory_namespace
Memory Namespace
string
""
provision
Provision
boolean
default: true
activation_reason
Activation Reason
string
default: default

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
StudioTemplateOut
object
template_id
required
Template Id
string
title
required
Title
string
agent_process_kind
Agent Process Kind
string
""
issue_scope
Issue Scope
string
""
work_scope
Work Scope
string
""
handoff_scope
Handoff Scope
string
""
target_surface
Target Surface
string
default: portal
provider
Provider
string
default: daytona
execution_plane
Execution Plane
string
default: daytona-sandbox
contention_policy
Contention Policy
string
default: promote-stack-on-lock
promotion_targets
Promotion Targets
Array<string>
allowed_write_policy
Allowed Write Policy
string
default: report-only
pr_submission_policy
Pr Submission Policy
string
default: selective-agent-pr
pr_submitter_agent_ids
Pr Submitter Agent Ids
Array<string>
pr_submission_pipeline
Pr Submission Pipeline
string
default: codexgate-github-app-pr
required_identity_shape
Required Identity Shape
string
default: named_agent_microsoft
required_dataset_scope
Required Dataset Scope
Array<string>
required_connectors
Required Connectors
Array<string>
ontology_roots
Ontology Roots
Array<string>
scoped_entity_kinds
Scoped Entity Kinds
Array<string>
visibility_policy
Visibility Policy
string
default: group-topology
default_wave_plan
Default Wave Plan
Array<string>
default_agent_ids
Default Agent Ids
Array<string>
conditional_agent_ids
Conditional Agent Ids
Array<string>
extension_packs
Extension Packs
object
key
additional properties
Array<string>
agent_specs
Agent Specs
Array<object>
StudioTemplateAgentOut
object
agent_id
required
Agent Id
string
alias
required
Alias
string
title
required
Title
string
agent_nickname
Agent Nickname
string
""
agent_process_kind
Agent Process Kind
string
""
role_key
Role Key
string
""
agent_tier
Agent Tier
string
default: core
agent_pack
Agent Pack
string
""
avatar_style
Avatar Style
string
""
avatar_source
Avatar Source
string
""
avatar_license
Avatar License
string
""
avatar_seed
Avatar Seed
string
""
avatar_url
Avatar Url
string
""
provider
Provider
string
default: daytona
principal_type
Principal Type
string
default: ai
execution_profile
Execution Profile
string
default: browser-ui
route_pack
Route Pack
Array<string>
escalation_chain
Escalation Chain
Array<string>
workload_groups
Workload Groups
Array<string>
focus_entities
Focus Entities
Array<string>
ignore_entities
Ignore Entities
Array<string>
scenario_phase
Scenario Phase
string
""
persona_target
Persona Target
string
""
next_goal
Next Goal
string
""
handoff_target
Handoff Target
string
""
mission_brief
Mission Brief
string
""
oss_watchlist
Oss Watchlist
Array<string>
test_tracks
Test Tracks
Array<object>
StudioAgentRoleTestTrackOut
object
track_id
required
Track Id
string
role_key
Role Key
string
""
title
Title
string
""
route_path
Route Path
string
""
acceptance_checks
Acceptance Checks
Array<string>
evidence_requirements
Evidence Requirements
Array<string>
actor_suit_id
Actor Suit Id
string
""
actor_account_ref
Actor Account Ref
string
""
actor_credential_ref
Actor Credential Ref
string
""
actor_entry_state
Actor Entry State
string
""
a2a_handoff_targets
A2A Handoff Targets
Array<string>
replay_focus
Replay Focus
string
""
issue_label
Issue Label
string
""
allowed_write_policy
Allowed Write Policy
string
default: report-only
pr_submission_policy
Pr Submission Policy
string
default: selective-agent-pr
pr_submission_allowed
Pr Submission Allowed
boolean
pr_submission_pipeline
Pr Submission Pipeline
string
""
issue_scope
Issue Scope
string
""
issue_sink
Issue Sink
string
""
handoff_scope
Handoff Scope
string
""
handoff_targets
Handoff Targets
Array<string>
capabilities
Capabilities
Array<string>
handoff_profile_keys
Handoff Profile Keys
Array<string>
handoff_capabilities
Handoff Capabilities
Array<string>
skill_ids
Skill Ids
Array<string>
mcp_server_ids
Mcp Server Ids
Array<string>
memory_namespace
Memory Namespace
string
""
provision
Provision
boolean
default: true
activation_reason
Activation Reason
string
default: default
Example
{
  "agent_process_kind": "",
  "issue_scope": "",
  "work_scope": "",
  "handoff_scope": "",
  "target_surface": "portal",
  "provider": "daytona",
  "execution_plane": "daytona-sandbox",
  "contention_policy": "promote-stack-on-lock",
  "allowed_write_policy": "report-only",
  "pr_submission_policy": "selective-agent-pr",
  "pr_submission_pipeline": "codexgate-github-app-pr",
  "required_identity_shape": "named_agent_microsoft",
  "visibility_policy": "group-topology",
  "agent_specs": [
    {
      "agent_nickname": "",
      "agent_process_kind": "",
      "role_key": "",
      "agent_tier": "core",
      "agent_pack": "",
      "avatar_style": "",
      "avatar_source": "",
      "avatar_license": "",
      "avatar_seed": "",
      "avatar_url": "",
      "provider": "daytona",
      "principal_type": "ai",
      "execution_profile": "browser-ui",
      "scenario_phase": "",
      "persona_target": "",
      "next_goal": "",
      "handoff_target": "",
      "mission_brief": "",
      "test_tracks": [
        {
          "role_key": "",
          "title": "",
          "route_path": "",
          "actor_suit_id": "",
          "actor_account_ref": "",
          "actor_credential_ref": "",
          "actor_entry_state": "",
          "replay_focus": "",
          "issue_label": ""
        }
      ],
      "allowed_write_policy": "report-only",
      "pr_submission_policy": "selective-agent-pr",
      "pr_submission_allowed": false,
      "pr_submission_pipeline": "",
      "issue_scope": "",
      "issue_sink": "",
      "handoff_scope": "",
      "memory_namespace": "",
      "provision": true,
      "activation_reason": "default"
    }
  ]
}

422

Section titled “422”

Validation Error

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