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

apiDeterministic

Get agent skill loadout

GET /api/agents/skills/effective-loadout

Resolve the effective role and task skill loadout for an external coding agent, including workspace overlays, provider SOPs, versions, hashes, required context, and MCP resource URIs. Never invokes hosted inference.

Parameters

workspaceId

string

Optional with API key auth, inferred from the key.

agentRolerequired

string

No description.

taskTyperequired

string

No description.

objective

string

No description.

Example

REST requestbash

curl -X GET "https://app.pipeline.help/api/agents/skills/effective-loadout?agentRole=scout&taskType=campaign_strategy" \
  -H "Authorization: Bearer $PIPELINE_API_KEY"

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "resolverVersion": {
      "type": "string"
    },
    "resolutionMode": {
      "type": "string"
    },
    "taskType": {
      "type": "string"
    },
    "role": {
      "type": "string"
    },
    "selected": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "providers": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "requiredContext": {
      "type": "object"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "estimatedSkillTokens": {
      "type": "number"
    },
    "estimatedInputTokens": {
      "type": "number"
    }
  },
  "required": [
    "resolverVersion",
    "resolutionMode",
    "taskType",
    "role",
    "selected",
    "providers",
    "requiredContext",
    "warnings"
  ]
}

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.