overlane task payload | Overlane Docs

Prints the sections the service renders for the task’s current lease holder: guardrails, rules, skills, task, code map, memory and checkpoint, with their token counts. The request proves the lease with its fencing token, which overlane task status shows.

Usage

overlane task payload task-id --fencing-token N

Arguments

Argument	Required	Description
`task-id`	yes	The task ID from `overlane task list`

Flags

Flag	Type	Required	Default	Description
`--fencing-token`	string	yes		The current lease’s fencing token

Examples

overlane task payload task-12 --fencing-token 3
overlane task payload task-12 --fencing-token 3 --json

Behavior

Effect: read (changes nothing).
Needs credentials: yes. Uses the network: yes.
Supports --dry-run: no. Accepts --force: no.
Machine-readable description: overlane schema task payload.

Result

With --json (the default when stdout is not a terminal) the command prints this JSON Schema’s shape on stdout.

{
  "$ref": "#/$defs/CapsulePayload",
  "$defs": {
    "CapsulePayload": {
      "type": "object",
      "properties": {
        "capsuleId": {
          "type": "string",
          "minLength": 1
        },
        "builderVersion": {
          "type": "string",
          "minLength": 1
        },
        "inputDigest": {
          "type": "string",
          "pattern": "^sha256:[0-9a-f]{64}$"
        },
        "totalTokens": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "prefixTokens": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "sections": {
          "minItems": 1,
          "maxItems": 8,
          "type": "array",
          "items": {
            "$ref": "#/$defs/PayloadSection"
          }
        }
      },
      "required": [
        "capsuleId",
        "builderVersion",
        "inputDigest",
        "totalTokens",
        "prefixTokens",
        "sections"
      ],
      "additionalProperties": false
    },
    "PayloadSection": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "enum": [
            "guardrails",
            "rules",
            "skills",
            "codemap",
            "memory",
            "task",
            "checkpoint"
          ]
        },
        "ref": {
          "type": "string",
          "pattern": "^overlane:\\/\\/payload\\/[A-Za-z0-9_-]+\\/[a-z]+$"
        },
        "digest": {
          "type": "string",
          "pattern": "^sha256:[0-9a-f]{64}$"
        },
        "tokens": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "stability": {
          "type": "string",
          "enum": [
            "project",
            "task",
            "turn"
          ]
        },
        "content": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "ref",
        "digest",
        "tokens",
        "stability",
        "content"
      ],
      "additionalProperties": false
    }
  }
}

See exit codes for the status the process returns.