{"openapi":"3.1.0","info":{"title":"MMAT Studio API","description":"Бакеты рабочих сред, системы, ноды и изолированные запуски. Bearer-ключи привязаны к аккаунту MMAT. POST создания, actions и runs требуют Idempotency-Key; изменения данных — expected_version.","version":"1.0.0"},"servers":[{"url":"https://mmat-studio-api.staging.app.mmat.tech"}],"paths":{"/api/v1/health":{"get":{"tags":["Service"],"summary":"Health","operationId":"health_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/me":{"get":{"tags":["Service"],"summary":"Me","operationId":"me_api_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"StudioBearer":[]}]}},"/api/v1/catalog":{"get":{"tags":["Service"],"summary":"Get Catalog","operationId":"get_catalog_api_v1_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"StudioBearer":[]}]}},"/api/v1/buckets":{"get":{"tags":["Buckets"],"summary":"List Buckets","operationId":"list_buckets_api_v1_buckets_get","security":[{"StudioBearer":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["Buckets"],"summary":"Create Bucket","operationId":"create_bucket_api_v1_buckets_post","security":[{"StudioBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BucketCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/buckets/{bucket_id}":{"get":{"tags":["Buckets"],"summary":"Get Bucket","operationId":"get_bucket_api_v1_buckets__bucket_id__get","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Buckets"],"summary":"Update Bucket","operationId":"update_bucket_api_v1_buckets__bucket_id__patch","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BucketUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Buckets"],"summary":"Delete Bucket","operationId":"delete_bucket_api_v1_buckets__bucket_id__delete","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/buckets/{bucket_id}/versions":{"get":{"tags":["Buckets"],"summary":"Bucket Versions","operationId":"bucket_versions_api_v1_buckets__bucket_id__versions_get","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/buckets/{bucket_id}/actions":{"post":{"tags":["Buckets"],"summary":"Bucket Action","operationId":"bucket_action_api_v1_buckets__bucket_id__actions_post","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Action"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/buckets/{bucket_id}/memory":{"get":{"tags":["Bucket files"],"summary":"Memory","operationId":"memory_api_v1_buckets__bucket_id__memory_get","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Bucket files"],"summary":"Put Memory","operationId":"put_memory_api_v1_buckets__bucket_id__memory_put","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/buckets/{bucket_id}/files/{filename}":{"get":{"tags":["Bucket files"],"summary":"Get File","operationId":"get_file_api_v1_buckets__bucket_id__files__filename__get","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}},{"name":"filename","in":"path","required":true,"schema":{"type":"string","title":"Filename"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Bucket files"],"summary":"Put File","operationId":"put_file_api_v1_buckets__bucket_id__files__filename__put","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}},{"name":"filename","in":"path","required":true,"schema":{"type":"string","title":"Filename"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Bucket files"],"summary":"Delete File","operationId":"delete_file_api_v1_buckets__bucket_id__files__filename__delete","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}},{"name":"filename","in":"path","required":true,"schema":{"type":"string","title":"Filename"}},{"name":"expected_version","in":"query","required":true,"schema":{"type":"integer","minimum":1,"title":"Expected Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/buckets/{bucket_id}/runs":{"post":{"tags":["Runs"],"summary":"Run Bucket","operationId":"run_bucket_api_v1_buckets__bucket_id__runs_post","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BucketRun"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Runs"],"summary":"Bucket Runs","operationId":"bucket_runs_api_v1_buckets__bucket_id__runs_get","security":[{"StudioBearer":[]}],"parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/systems":{"get":{"tags":["Systems"],"summary":"Systems","operationId":"systems_api_v1_systems_get","security":[{"StudioBearer":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["Systems"],"summary":"Create System","operationId":"create_system_api_v1_systems_post","security":[{"StudioBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/systems/{system_id}":{"get":{"tags":["Systems"],"summary":"Get System","operationId":"get_system_api_v1_systems__system_id__get","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Systems"],"summary":"Patch System","operationId":"patch_system_api_v1_systems__system_id__patch","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Systems"],"summary":"Delete System","operationId":"delete_system_api_v1_systems__system_id__delete","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/systems/{system_id}/actions":{"post":{"tags":["Systems"],"summary":"System Action","operationId":"system_action_api_v1_systems__system_id__actions_post","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Action"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/systems/{system_id}/graph":{"get":{"tags":["Nodes"],"summary":"Get Graph","operationId":"get_graph_api_v1_systems__system_id__graph_get","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Nodes"],"summary":"Put Graph","operationId":"put_graph_api_v1_systems__system_id__graph_put","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/systems/{system_id}/nodes":{"get":{"tags":["Nodes"],"summary":"Get Nodes","operationId":"get_nodes_api_v1_systems__system_id__nodes_get","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Nodes"],"summary":"Put Nodes","operationId":"put_nodes_api_v1_systems__system_id__nodes_put","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodesUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/systems/{system_id}/runs":{"post":{"tags":["Runs"],"summary":"Run System","operationId":"run_system_api_v1_systems__system_id__runs_post","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreate"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Runs"],"summary":"System Runs","operationId":"system_runs_api_v1_systems__system_id__runs_get","security":[{"StudioBearer":[]}],"parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}":{"get":{"tags":["Runs"],"summary":"Get Run","operationId":"get_run_api_v1_runs__run_id__get","security":[{"StudioBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/stop":{"post":{"tags":["Runs"],"summary":"Stop Run","operationId":"stop_run_api_v1_runs__run_id__stop_post","security":[{"StudioBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/nodes/{node_id}":{"get":{"tags":["Runs"],"summary":"Run Node","operationId":"run_node_api_v1_runs__run_id__nodes__node_id__get","security":[{"StudioBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"node_id","in":"path","required":true,"schema":{"type":"string","title":"Node Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/events":{"get":{"tags":["Runs"],"summary":"Events","operationId":"events_api_v1_runs__run_id__events_get","security":[{"StudioBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"after_seq","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"After Seq"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":400,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/artifacts/{index}":{"get":{"tags":["Files"],"summary":"Artifact","operationId":"artifact_api_v1_runs__run_id__artifacts__index__get","security":[{"StudioBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"index","in":"path","required":true,"schema":{"type":"integer","title":"Index"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/nodes/{node_id}/artifacts/{index}":{"get":{"tags":["Files"],"summary":"Node Artifact","operationId":"node_artifact_api_v1_runs__run_id__nodes__node_id__artifacts__index__get","security":[{"StudioBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"node_id","in":"path","required":true,"schema":{"type":"string","title":"Node Id"}},{"name":"index","in":"path","required":true,"schema":{"type":"integer","title":"Index"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/skills":{"get":{"tags":["Skills"],"summary":"Skills","operationId":"skills_api_v1_skills_get","security":[{"StudioBearer":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["Skills"],"summary":"Create Skill","operationId":"create_skill_api_v1_skills_post","security":[{"StudioBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/skills/{skill_id}":{"get":{"tags":["Skills"],"summary":"Skill","operationId":"skill_api_v1_skills__skill_id__get","security":[{"StudioBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Skills"],"summary":"Update Skill","operationId":"update_skill_api_v1_skills__skill_id__patch","security":[{"StudioBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Skills"],"summary":"Archive Skill","operationId":"archive_skill_api_v1_skills__skill_id__delete","security":[{"StudioBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/skills/{skill_id}/versions":{"get":{"tags":["Skills"],"summary":"Skill Versions","operationId":"skill_versions_api_v1_skills__skill_id__versions_get","security":[{"StudioBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/skills/{skill_id}/export":{"get":{"tags":["Skills"],"summary":"Export Skill","operationId":"export_skill_api_v1_skills__skill_id__export_get","security":[{"StudioBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/skills/{skill_id}/actions":{"post":{"tags":["Skills"],"summary":"Skill Action","operationId":"skill_action_api_v1_skills__skill_id__actions_post","security":[{"StudioBearer":[]}],"parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Action"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Action":{"properties":{"action":{"type":"string","enum":["activate","freeze","archive","restore","duplicate","template","trash"],"title":"Action"}},"additionalProperties":false,"type":"object","required":["action"],"title":"Action"},"BucketCreate":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"description":{"type":"string","maxLength":4000,"title":"Description","default":""},"profile":{"additionalProperties":true,"type":"object","title":"Profile"},"files":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":31,"title":"Files"},"memory":{"type":"string","maxLength":131072,"title":"Memory","default":""}},"additionalProperties":false,"type":"object","required":["name"],"title":"BucketCreate"},"BucketRun":{"properties":{"prompt":{"type":"string","maxLength":30000,"minLength":1,"title":"Prompt"},"input_text":{"type":"string","maxLength":200000,"title":"Input Text","default":""},"mode":{"type":"string","enum":["read_only","read_write"],"title":"Mode","default":"read_write"},"expected_version":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Expected Version"}},"additionalProperties":false,"type":"object","required":["prompt"],"title":"BucketRun"},"BucketUpdate":{"properties":{"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"},"name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Description"},"profile":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Profile"},"files":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":31},{"type":"null"}],"title":"Files"},"memory":{"anyOf":[{"type":"string","maxLength":131072},{"type":"null"}],"title":"Memory"}},"additionalProperties":false,"type":"object","required":["expected_version"],"title":"BucketUpdate"},"Edge":{"properties":{"source":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,80}$","title":"Source"},"target":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,80}$","title":"Target"},"id":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9_-]{1,160}$"},{"type":"null"}],"title":"Id"},"branch":{"anyOf":[{"type":"string","enum":["true","false"]},{"type":"null"}],"title":"Branch"}},"additionalProperties":false,"type":"object","required":["source","target"],"title":"Edge"},"GraphUpdate":{"properties":{"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"},"graph":{"additionalProperties":true,"type":"object","title":"Graph"}},"additionalProperties":false,"type":"object","required":["expected_version","graph"],"title":"GraphUpdate"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Node":{"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,80}$","title":"Id"},"kind":{"type":"string","enum":["input","agent","condition","merge","output"],"title":"Kind"},"label":{"type":"string","maxLength":200,"title":"Label","default":""},"prompt":{"type":"string","maxLength":30000,"title":"Prompt","default":""},"bucket_id":{"anyOf":[{"type":"string","pattern":"^env_[a-f0-9]{32}$"},{"type":"null"}],"title":"Bucket Id"},"mode":{"type":"string","enum":["read_only","read_write"],"title":"Mode","default":"read_write"},"overrides":{"items":{"type":"string"},"type":"array","maxItems":5,"title":"Overrides"},"model":{"type":"string","enum":["gpt-5.4","gpt-4.1-mini"],"title":"Model","default":"gpt-5.4"},"timeout_seconds":{"type":"integer","maximum":900.0,"minimum":15.0,"title":"Timeout Seconds","default":180},"skills":{"items":{"type":"string"},"type":"array","maxItems":12,"title":"Skills"},"skill_settings":{"additionalProperties":true,"type":"object","title":"Skill Settings"},"skill_versions":{"additionalProperties":true,"type":"object","title":"Skill Versions"},"connections":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":1,"title":"Connections"},"config":{"additionalProperties":true,"type":"object","title":"Config"}},"additionalProperties":false,"type":"object","required":["id","kind"],"title":"Node"},"NodesUpdate":{"properties":{"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"},"nodes":{"items":{"$ref":"#/components/schemas/Node"},"type":"array","maxItems":40,"title":"Nodes"},"edges":{"items":{"$ref":"#/components/schemas/Edge"},"type":"array","maxItems":160,"title":"Edges"}},"additionalProperties":false,"type":"object","required":["expected_version","nodes"],"title":"NodesUpdate"},"RunCreate":{"properties":{"input_text":{"type":"string","maxLength":200000,"title":"Input Text","default":""},"node_id":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9_-]{1,80}$"},{"type":"null"}],"title":"Node Id"}},"additionalProperties":false,"type":"object","title":"RunCreate"},"SkillCreate":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"description":{"type":"string","maxLength":1500,"minLength":1,"title":"Description"},"instructions":{"type":"string","maxLength":30000,"minLength":3,"title":"Instructions"},"input_schema":{"additionalProperties":true,"type":"object","title":"Input Schema"},"output_format":{"type":"string","maxLength":4000,"title":"Output Format","default":""},"example_input":{"type":"string","maxLength":12000,"title":"Example Input","default":""},"required_actions":{"items":{"type":"string"},"type":"array","maxItems":1,"title":"Required Actions"},"required_tools":{"items":{"type":"string"},"type":"array","maxItems":0,"title":"Required Tools"}},"additionalProperties":false,"type":"object","required":["name","description","instructions"],"title":"SkillCreate"},"SkillUpdate":{"properties":{"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"},"name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":1500,"minLength":1},{"type":"null"}],"title":"Description"},"instructions":{"anyOf":[{"type":"string","maxLength":30000,"minLength":3},{"type":"null"}],"title":"Instructions"},"input_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input Schema"},"output_format":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Output Format"},"example_input":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Example Input"},"required_actions":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":1},{"type":"null"}],"title":"Required Actions"},"required_tools":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":0},{"type":"null"}],"title":"Required Tools"}},"additionalProperties":false,"type":"object","required":["expected_version"],"title":"SkillUpdate"},"SystemCreate":{"properties":{"name":{"type":"string","maxLength":180,"minLength":1,"title":"Name"},"description":{"type":"string","maxLength":4000,"title":"Description","default":""},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","title":"Color","default":"#dc7359"},"template":{"type":"string","enum":["empty","basic"],"title":"Template","default":"empty"}},"additionalProperties":false,"type":"object","required":["name"],"title":"SystemCreate"},"SystemUpdate":{"properties":{"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"},"name":{"anyOf":[{"type":"string","maxLength":180,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Description"},"color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}],"title":"Color"}},"additionalProperties":false,"type":"object","required":["expected_version"],"title":"SystemUpdate"},"TextUpdate":{"properties":{"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"},"content":{"type":"string","maxLength":131072,"title":"Content"}},"additionalProperties":false,"type":"object","required":["expected_version","content"],"title":"TextUpdate"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"StudioBearer":{"type":"http","scheme":"bearer"}}}}