Skip to content
FractalOps

Cleanup Studio Run

POST
/v1/admin/studio/runs/{run_id}/cleanup
curl --request POST \
  --url 'https://example.com/v1/admin/studio/runs/example/cleanup?tenant_id='

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
run_id
required
Run Id
string
>= 1 characters

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

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
StudioRunOut
object
run_id
Run Id
string
""
run_key
Run Key
string
""
template_id
Template Id
string
default: agentsquad
agent_process_kind
Agent Process Kind
string
""
proposal_id
Proposal Id
string
""
proposal_key
Proposal Key
string
""
project_slug
Project Slug
string
""
scenario_key
Scenario Key
string
""
scenario_title
Scenario Title
string
""
scenario_phase
Scenario Phase
string
""
persona_target
Persona Target
string
""
next_goal
Next Goal
string
""
handoff_target
Handoff Target
string
""
performance_note
Performance Note
string
""
status
Status
string
""
canary_login_ok
Canary Login Ok
boolean
default_agent_ids
Default Agent Ids
Array<string>
extension_packs
Extension Packs
object
key
additional properties
Array<string>
created_accounts
Created Accounts
Array<object>
object
key
additional properties
string
sessions
Sessions
Array<object>
StudioAgentSessionOut
object
session_id
Session Id
string
""
claude_session_id
Claude Session Id
string
""
run_id
Run Id
string
""
template_id
Template Id
string
default: agentsquad
agent_id
Agent Id
string
""
alias
Alias
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
agent_provider_profile_id
Agent Provider Profile Id
string
""
agent_provider
Agent Provider
string
""
agent_model
Agent Model
string
""
agent_effort
Agent Effort
string
""
runtime_endpoint
Runtime Endpoint
string
""
agent_endpoint
Agent Endpoint
string
""
runtime_credential_secret_ref
Runtime Credential Secret Ref
string
""
agent_credential_secret_ref
Agent Credential Secret Ref
string
""
runtime_credential_status
Runtime Credential Status
string
""
agent_credential_status
Agent Credential Status
string
""
runtime_binding_mode
Runtime Binding Mode
string
""
agent_binding_mode
Agent Binding Mode
string
""
runtime_credential_scope
Runtime Credential Scope
string
""
agent_credential_scope
Agent Credential Scope
string
""
runtime_endpoint_binding
Runtime Endpoint Binding
string
""
agent_endpoint_binding
Agent Endpoint Binding
string
""
runtime_cliproxy_centralized
Runtime Cliproxy Centralized
boolean
agent_cliproxy_centralized
Agent Cliproxy Centralized
boolean
status
Status
string
default: idle
current_route
Current Route
string
""
current_step
Current Step
string
""
subject_key
Subject Key
string
""
user_principal_name
User Principal Name
string
""
last_heartbeat_at
Last Heartbeat At
string
""
last_report_at
Last Report At
string
""
last_progress_at
Last Progress At
string
""
last_controller_intervention_at
Last Controller Intervention At
string
""
controller_intervention_count
Controller Intervention Count
integer
0
controller_state
Controller State
string
default: active
last_controller_summary
Last Controller Summary
string
""
last_controller_message
Last Controller Message
string
""
last_controller_outcome
Last Controller Outcome
string
""
live_status
Live Status
string
""
queue_reason_code
Queue Reason Code
string
""
current_activity
Current Activity
string
""
current_tool_name
Current Tool Name
string
""
current_route_hint
Current Route Hint
string
""
scenario_key
Scenario Key
string
""
scenario_title
Scenario Title
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>
performance_note
Performance Note
string
""
hud_intent
Hud Intent
string
""
hud_route
Hud Route
string
""
hud_proof
Hud Proof
string
""
hud_live
Hud Live
string
""
hud_recover
Hud Recover
string
""
last_event_at
Last Event At
string
""
last_transcript_path
Last Transcript Path
string
""
last_stdout_excerpt
Last Stdout Excerpt
string
""
agent_final_response
Agent Final Response
string
""
agent_final_response_excerpt
Agent Final Response Excerpt
string
""
last_assistant_message
Last Assistant Message
string
""
last_assistant_message_excerpt
Last Assistant Message Excerpt
string
""
continuation_count
Continuation Count
integer
0
continuity_mode
Continuity Mode
string
default: fresh
session_policy
Session Policy
string
default: resume
parent_run_id
Parent Run Id
string
""
parent_session_id
Parent Session Id
string
""
source_run_id
Source Run Id
string
""
source_session_id
Source Session Id
string
""
source_execution_session_id
Source Execution Session Id
string
""
source_workspace_id
Source Workspace Id
string
""
source_claude_session_id_present
Source Claude Session Id Present
boolean
continuity_reason
Continuity Reason
string
""
continuity_provider_result
Continuity Provider Result
string
""
summary_artifact_ref
Summary Artifact Ref
string
""
last_valid_progress_at
Last Valid Progress At
string
""
task_lineage_key
Task Lineage Key
string
""
project_scoped_lineage_key
Project Scoped Lineage Key
string
""
prompt_contract_version
Prompt Contract Version
string
""
hook_health
Hook Health
string
default: unknown
session_file_present
Session File Present
boolean
first_tool_name
First Tool Name
string
""
first_tool_family
First Tool Family
string
""
first_tool_status
First Tool Status
string
""
observed_tool_names
Observed Tool Names
Array<string>
last_tool_failure_name
Last Tool Failure Name
string
""
last_tool_failure_route
Last Tool Failure Route
string
""
last_tool_failure_summary
Last Tool Failure Summary
string
""
last_tool_failure_excerpt
Last Tool Failure Excerpt
string
""
last_tool_failure_at
Last Tool Failure At
string
""
launch_contract_status
Launch Contract Status
string
""
launch_contract_violation_reason
Launch Contract Violation Reason
string
""
needs_intervention
Needs Intervention
boolean
next_retry_at
Next Retry At
string
""
execution_workspace_id
Execution Workspace Id
string
""
execution_session_id
Execution Session Id
string
""
execution_attempt_id
Execution Attempt Id
string
""
bridge_host_id
Bridge Host Id
string
""
execution_workspace_url
Execution Workspace Url
string
""
execution_workspace_name
Execution Workspace Name
string
""
execution_workspace_status
Execution Workspace Status
string
""
execution_workspace_scope
Execution Workspace Scope
string
""
execution_provider
Execution Provider
string
default: daytona
agent_execution_worktree_path
Agent Execution Worktree Path
string
""
agent_assembly_worktree_path
Agent Assembly Worktree Path
string
""
agent_observation_worktree_path
Agent Observation Worktree Path
string
""
agent_owned_repository_key
Agent Owned Repository Key
string
""
agent_owned_repository_worktree_path
Agent Owned Repository Worktree Path
string
""
agent_assigned_repository_path
Agent Assigned Repository Path
string
""
agent_writable_repository_keys
Agent Writable Repository Keys
Array<string>
agent_writable_repository_slugs
Agent Writable Repository Slugs
Array<string>
project_repository_bindings
Project Repository Bindings
Array<object>
object
key
additional properties
any
source_ref_repos
Source Ref Repos
Array<object>
object
key
additional properties
any
project_source_ref_repos
Project Source Ref Repos
Array<object>
object
key
additional properties
any
dokploy_preview_id
Dokploy Preview Id
string
""
dokploy_preview_url
Dokploy Preview Url
string
""
dokploy_deployment_id
Dokploy Deployment Id
string
""
proof_target_url
Proof Target Url
string
""
preview_lifecycle_state
Preview Lifecycle State
string
""
proof_status
Proof Status
string
""
blocker_code
Blocker Code
string
""
latest_report_type
Latest Report Type
string
""
latest_report_status
Latest Report Status
string
""
latest_report_code
Latest Report Code
string
""
latest_report_message
Latest Report Message
string
""
followup_task_id
Followup Task Id
string
""
followup_task_url
Followup Task Url
string
""
active_thread_id
Active Thread Id
string
""
dialogue_target_agent_id
Dialogue Target Agent Id
string
""
pixel_state
Pixel State
string
default: idle
mailbox_count
Mailbox Count
integer
0
execution_mode
Execution Mode
string
default: shared_browser_only
armory_profile_id
Armory Profile Id
string
""
armory_bundle_ids
Armory Bundle Ids
Array<string>
armory_mcp_server_ids
Armory Mcp Server Ids
Array<string>
armory_skill_ids
Armory Skill Ids
Array<string>
armory_policy_ids
Armory Policy Ids
Array<string>
armory_manifest_path
Armory Manifest Path
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
""
request_id
Request Id
string
""
artifact_ref
Artifact Ref
string
""
artifact_refs
Artifact Refs
Array<string>
screenshot_refs
Screenshot Refs
Array<string>
video_refs
Video Refs
Array<string>
trace_refs
Trace Refs
Array<string>
branch_name
Branch Name
string
""
pr_url
Pr Url
string
""
scope_directive
StudioAgentScopeDirectiveOut
object
next_best_route
Next Best Route
string
""
must_verify
Must Verify
Array<string>
must_ignore
Must Ignore
Array<string>
coverage_gap
Coverage Gap
Array<string>
frontier_refs
Frontier Refs
Array<string>
join_confidence
Join Confidence
string
default: unknown
execution_plane
Execution Plane
string
""
contention_policy
Contention Policy
string
""
promotion_target
Promotion Target
string
""
why_now
Why Now
string
""
skip_reason
Skip Reason
string
""
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
""
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
""
hud
StudioAgentHudOut
object
intent_key
Intent Key
string
""
route
Route
string
""
launch
Launch
string
""
catalog
Catalog
Array<string>
proof
Proof
string
""
recover
Recover
string
""
done
Done
string
""
live
Live
string
""
ontology_roots
Ontology Roots
Array<string>
agent_roster
Agent Roster
Array<object>
StudioAgentOut
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
""
principal_type
Principal Type
string
default: ai
subject_key
Subject Key
string
""
user_principal_name
User Principal Name
string
""
identity_binding_mode
Identity Binding Mode
string
""
route_pack
Route Pack
Array<string>
allowed_write_policy
Allowed Write Policy
string
default: report-only
allowed_write_prefix
Allowed Write Prefix
string
""
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
""
escalation_chain
Escalation Chain
Array<string>
state
State
string
default: idle
last_report_at
Last Report At
string
""
last_message
Last Message
string
""
blocker_code
Blocker Code
string
""
secret_lease_ref
Secret Lease Ref
string
""
scope_directive
StudioAgentScopeDirectiveOut
object
next_best_route
Next Best Route
string
""
must_verify
Must Verify
Array<string>
must_ignore
Must Ignore
Array<string>
coverage_gap
Coverage Gap
Array<string>
frontier_refs
Frontier Refs
Array<string>
join_confidence
Join Confidence
string
default: unknown
execution_plane
Execution Plane
string
""
contention_policy
Contention Policy
string
""
promotion_target
Promotion Target
string
""
why_now
Why Now
string
""
skip_reason
Skip Reason
string
""
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
""
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
""
hud
StudioAgentHudOut
object
intent_key
Intent Key
string
""
route
Route
string
""
launch
Launch
string
""
catalog
Catalog
Array<string>
proof
Proof
string
""
recover
Recover
string
""
done
Done
string
""
live
Live
string
""
ontology_roots
Ontology Roots
Array<string>
secret_lease_refs
Secret Lease Refs
Array<string>
prompt_secret_refs
Prompt Secret Refs
Array<string>
preferred_agent_ids
Preferred Agent Ids
Array<string>
operator_notes
Operator Notes
string
""
preflight
Preflight
object
key
additional properties
any
execution_task_id
Execution Task Id
string
""
execution_task_url
Execution Task Url
string
""
studio_task_id
Studio Task Id
string
""
studio_task_url
Studio Task Url
string
""
primary_work_surface_url
Primary Work Surface Url
string
""
Example
{
  "run_id": "",
  "run_key": "",
  "template_id": "agentsquad",
  "agent_process_kind": "",
  "proposal_id": "",
  "proposal_key": "",
  "project_slug": "",
  "scenario_key": "",
  "scenario_title": "",
  "scenario_phase": "",
  "persona_target": "",
  "next_goal": "",
  "handoff_target": "",
  "performance_note": "",
  "status": "",
  "canary_login_ok": false,
  "sessions": [
    {
      "session_id": "",
      "claude_session_id": "",
      "run_id": "",
      "template_id": "agentsquad",
      "agent_id": "",
      "alias": "",
      "agent_nickname": "",
      "agent_process_kind": "",
      "role_key": "",
      "agent_tier": "core",
      "agent_pack": "",
      "avatar_style": "",
      "avatar_source": "",
      "avatar_license": "",
      "avatar_seed": "",
      "avatar_url": "",
      "provider": "daytona",
      "agent_provider_profile_id": "",
      "agent_provider": "",
      "agent_model": "",
      "agent_effort": "",
      "runtime_endpoint": "",
      "agent_endpoint": "",
      "runtime_credential_secret_ref": "",
      "agent_credential_secret_ref": "",
      "runtime_credential_status": "",
      "agent_credential_status": "",
      "runtime_binding_mode": "",
      "agent_binding_mode": "",
      "runtime_credential_scope": "",
      "agent_credential_scope": "",
      "runtime_endpoint_binding": "",
      "agent_endpoint_binding": "",
      "runtime_cliproxy_centralized": false,
      "agent_cliproxy_centralized": false,
      "status": "idle",
      "current_route": "",
      "current_step": "",
      "subject_key": "",
      "user_principal_name": "",
      "last_heartbeat_at": "",
      "last_report_at": "",
      "last_progress_at": "",
      "last_controller_intervention_at": "",
      "controller_intervention_count": 0,
      "controller_state": "active",
      "last_controller_summary": "",
      "last_controller_message": "",
      "last_controller_outcome": "",
      "live_status": "",
      "queue_reason_code": "",
      "current_activity": "",
      "current_tool_name": "",
      "current_route_hint": "",
      "scenario_key": "",
      "scenario_title": "",
      "scenario_phase": "",
      "persona_target": "",
      "next_goal": "",
      "handoff_target": "",
      "mission_brief": "",
      "performance_note": "",
      "hud_intent": "",
      "hud_route": "",
      "hud_proof": "",
      "hud_live": "",
      "hud_recover": "",
      "last_event_at": "",
      "last_transcript_path": "",
      "last_stdout_excerpt": "",
      "agent_final_response": "",
      "agent_final_response_excerpt": "",
      "last_assistant_message": "",
      "last_assistant_message_excerpt": "",
      "continuation_count": 0,
      "continuity_mode": "fresh",
      "session_policy": "resume",
      "parent_run_id": "",
      "parent_session_id": "",
      "source_run_id": "",
      "source_session_id": "",
      "source_execution_session_id": "",
      "source_workspace_id": "",
      "source_claude_session_id_present": false,
      "continuity_reason": "",
      "continuity_provider_result": "",
      "summary_artifact_ref": "",
      "last_valid_progress_at": "",
      "task_lineage_key": "",
      "project_scoped_lineage_key": "",
      "prompt_contract_version": "",
      "hook_health": "unknown",
      "session_file_present": false,
      "first_tool_name": "",
      "first_tool_family": "",
      "first_tool_status": "",
      "last_tool_failure_name": "",
      "last_tool_failure_route": "",
      "last_tool_failure_summary": "",
      "last_tool_failure_excerpt": "",
      "last_tool_failure_at": "",
      "launch_contract_status": "",
      "launch_contract_violation_reason": "",
      "needs_intervention": false,
      "next_retry_at": "",
      "execution_workspace_id": "",
      "execution_session_id": "",
      "execution_attempt_id": "",
      "bridge_host_id": "",
      "execution_workspace_url": "",
      "execution_workspace_name": "",
      "execution_workspace_status": "",
      "execution_workspace_scope": "",
      "execution_provider": "daytona",
      "agent_execution_worktree_path": "",
      "agent_assembly_worktree_path": "",
      "agent_observation_worktree_path": "",
      "agent_owned_repository_key": "",
      "agent_owned_repository_worktree_path": "",
      "agent_assigned_repository_path": "",
      "dokploy_preview_id": "",
      "dokploy_preview_url": "",
      "dokploy_deployment_id": "",
      "proof_target_url": "",
      "preview_lifecycle_state": "",
      "proof_status": "",
      "blocker_code": "",
      "latest_report_type": "",
      "latest_report_status": "",
      "latest_report_code": "",
      "latest_report_message": "",
      "followup_task_id": "",
      "followup_task_url": "",
      "active_thread_id": "",
      "dialogue_target_agent_id": "",
      "pixel_state": "idle",
      "mailbox_count": 0,
      "execution_mode": "shared_browser_only",
      "armory_profile_id": "",
      "armory_manifest_path": "",
      "allowed_write_policy": "report-only",
      "pr_submission_policy": "selective-agent-pr",
      "pr_submission_allowed": false,
      "pr_submission_pipeline": "",
      "request_id": "",
      "artifact_ref": "",
      "branch_name": "",
      "pr_url": "",
      "scope_directive": {
        "next_best_route": "",
        "join_confidence": "unknown",
        "execution_plane": "",
        "contention_policy": "",
        "promotion_target": "",
        "why_now": "",
        "skip_reason": "",
        "pr_submission_policy": "selective-agent-pr",
        "pr_submission_allowed": false,
        "pr_submission_pipeline": "",
        "test_tracks": [
          {
            "role_key": "",
            "title": "",
            "route_path": "",
            "actor_suit_id": "",
            "actor_account_ref": "",
            "actor_credential_ref": "",
            "actor_entry_state": "",
            "replay_focus": "",
            "issue_label": ""
          }
        ],
        "hud": {
          "intent_key": "",
          "route": "",
          "launch": "",
          "proof": "",
          "recover": "",
          "done": "",
          "live": ""
        }
      }
    }
  ],
  "agent_roster": [
    {
      "agent_nickname": "",
      "agent_process_kind": "",
      "role_key": "",
      "agent_tier": "core",
      "agent_pack": "",
      "principal_type": "ai",
      "subject_key": "",
      "user_principal_name": "",
      "identity_binding_mode": "",
      "allowed_write_policy": "report-only",
      "allowed_write_prefix": "",
      "pr_submission_policy": "selective-agent-pr",
      "pr_submission_allowed": false,
      "pr_submission_pipeline": "",
      "issue_scope": "",
      "issue_sink": "",
      "handoff_scope": "",
      "memory_namespace": "",
      "state": "idle",
      "last_report_at": "",
      "last_message": "",
      "blocker_code": "",
      "secret_lease_ref": "",
      "scope_directive": {
        "next_best_route": "",
        "join_confidence": "unknown",
        "execution_plane": "",
        "contention_policy": "",
        "promotion_target": "",
        "why_now": "",
        "skip_reason": "",
        "pr_submission_policy": "selective-agent-pr",
        "pr_submission_allowed": false,
        "pr_submission_pipeline": "",
        "test_tracks": [
          {
            "role_key": "",
            "title": "",
            "route_path": "",
            "actor_suit_id": "",
            "actor_account_ref": "",
            "actor_credential_ref": "",
            "actor_entry_state": "",
            "replay_focus": "",
            "issue_label": ""
          }
        ],
        "hud": {
          "intent_key": "",
          "route": "",
          "launch": "",
          "proof": "",
          "recover": "",
          "done": "",
          "live": ""
        }
      }
    }
  ],
  "operator_notes": "",
  "execution_task_id": "",
  "execution_task_url": "",
  "studio_task_id": "",
  "studio_task_url": "",
  "primary_work_surface_url": ""
}

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": {}
    }
  ]
}