---
title: "overlane task payload"
description: "Show the rendered payload sections of a task you hold"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.overlane.app/llms.txt
> Use this file to discover all available pages before exploring further.

# overlane task payload

{/* Generated by apps/docs/scripts/generate.mjs (CLI pages from the command registry in packages/cli). Do not edit; run `pnpm --filter @overlane/docs gen`. */}

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

```sh
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

```sh
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.

```json
{
  "$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](/cli/#exit-codes) for the status the process returns.

Source: https://docs.overlane.app/cli/task-payload/index.mdx