List Studio Templates

GET

/v1/admin/studio/templates

curl --request GET \
  --url 'https://example.com/v1/admin/studio/templates?tenant_id='

Parameters

Query Parameters

tenant_id

Tenant Id

string

""

Header Parameters

X-FractalOps-Tenant-Id

Any of:

string

string

null

null

x-pomerium-jwt-assertion

Any of:

string

string

null

null

Responses

200

Successful Response

Media typeapplication/json

Response List Studio Templates V1 Admin Studio Templates Get

Array<object>

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

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

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}