cliDeterministic

Validate agent artifact

pipeline validate-agent-artifact

Validate an external coding agent artifact against the exact typed Agent Teams output contract before submission. This does not change work-order state. A validation failure returns structured issues and should be corrected before submit-agent-artifact.

Parameters

workspaceId

string

Optional with an API key, inferred from the key.

taskTyperequired

string

No description.

artifactrequired

object

Structured artifact produced from the claimed bundle.

Example

CLI commandbash

pipeline validate-agent-artifact \
  --task-type "campaign_strategy" \
  --artifact-json '{}'

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "validation": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "artifact": {
          "type": "object"
        },
        "issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "array"
              },
              "message": {
                "type": "string"
              }
            }
          }
        }
      },
      "required": [
        "success"
      ]
    }
  },
  "required": [
    "validation"
  ]
}

Exit codes

1: Invalid input or local configuration.
2: The API or tool returned an error.
3: Authentication failed.
4: A network request failed.