Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.

apiDeterministic

Validate agent artifact

POST /api/agents/work-orders/external/validate

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

REST requestbash

curl -X POST "https://app.pipeline.help/api/agents/work-orders/external/validate" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"taskType":"campaign_strategy","artifact":{}}'

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

HTTP errors

401: Missing or invalid API key.
403: Authenticated but not permitted for the workspace or resource.
404: The requested resource was not found.