{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a background job to set deployment records for a given cluster.\nPerforms validation and permission checks synchronously, returning rejected\ndeployments immediately, then enqueues a background job for the actual\ndeployment updates. Use the companion GET endpoint to poll for job status.","properties":{"path":{"type":"object","properties":{"org":{"type":"string","description":"The organization name. The name is not case sensitive."},"cluster":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-zA-Z0-9._-]+$","description":"The cluster name."}},"required":["org","cluster"],"additionalProperties":false},"body":{"type":"object","properties":{"logical_environment":{"type":"string","description":"The stage of the deployment.","minLength":1,"maxLength":128},"physical_environment":{"type":"string","description":"The physical region of the deployment.","maxLength":128},"deployments":{"type":"array","description":"The list of deployments to record.","maxItems":5000,"items":{"type":"object","properties":{"name":{"type":"string","description":"The name of the artifact.","minLength":1,"maxLength":256},"digest":{"type":"string","description":"The hex encoded digest of the artifact.","minLength":71,"maxLength":71,"pattern":"^sha256:[a-f0-9]{64}$"},"version":{"type":"string","description":"The artifact version.","maxLength":100,"examples":["1.2.3"]},"status":{"type":"string","description":"The deployment status of the artifact.","default":"deployed","enum":["deployed","decommissioned"]},"deployment_name":{"type":"string","description":"The unique identifier for the deployment represented by the new record.\n","minLength":1,"maxLength":256},"github_repository":{"type":"string","description":"The name of the GitHub repository associated with the artifact.","maxLength":100,"pattern":"^[A-Za-z0-9.\\-_]+$","examples":["my-github-repo"]},"tags":{"type":"object","description":"Key-value pairs to tag the deployment record.","additionalProperties":{"type":"string"}},"runtime_risks":{"type":"array","description":"A list of runtime risks associated with the deployment.","maxItems":4,"uniqueItems":true,"items":{"type":"string","enum":["critical-resource","internet-exposed","lateral-movement","sensitive-data"]}}},"required":["name","deployment_name","digest"]}}},"required":["logical_environment","deployments"],"examples":[{"logical_environment":"prod","physical_environment":"pacific-east","deployments":[{"name":"awesome-image","digest":"sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72","version":"2.1.0","status":"deployed","deployment_name":"deployment-pod","tags":{"owning-team":"platform"},"runtime_risks":["sensitive-data"]}]}]}},"required":["path","body"],"additionalProperties":false},"name":"Create a cluster deployment records job","id":"github.orgs.create-cluster-deployment-records-job","example":{"path":{"org":"example","cluster":"example"},"body":{"logical_environment":"prod","physical_environment":"pacific-east","deployments":[{"name":"awesome-image","digest":"sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72","version":"2.1.0","status":"deployed","deployment_name":"deployment-pod","tags":{"owning-team":"platform"},"runtime_risks":["sensitive-data"]}]}},"maxRequests":1,"summary":false}}