Skip to content
CrewhelmCrewhelmCrewhelm Docs

MCP Context

Manage fleet policy, capabilities, Skills, blueprints, and Briefs.

This reference is generated from Crewhelm’s authenticated MCP catalog and progressive operation schemas. Tool availability does not grant authority; every call is subject to the authenticated owner, approved OAuth scopes, and current control-plane policy.

Read tools

Section titled “Read tools”

Inspect state and obtain exact references without changing it.

crewhelm_inspect_context

Section titled “crewhelm_inspect_context”

Inspect Crewhelm context

Inspect fleet policy, capabilities, Skills, blueprints, and Briefs.

Attributes: read-only, non-destructive, idempotent, closed-world.

How to use this tool:

  1. Send {"request":"operations"} to list its subtools.
  2. Send {"request":"schema","name":"…"} for one subtool’s exact inputs.
  3. Send {"request":"execute","name":"…","input":{…}} to run it.
Subtool Purpose
inspect_fleet Inspect current fleet policy, capacity, retention, and execution defaults.
inspect_capabilities Inspect the available Agent capability modules and configuration schemas.
list_skills List available owner-local Skills.
inspect_skill Inspect one exact owner-local Skill package version.
list_blueprints List available owner-local Agent blueprints.
inspect_blueprint Inspect one exact Agent blueprint package version.
list_authoring_drafts List compact references for active authoring drafts owned by this MCP client.
list_briefs List compact Brief metadata without reading content.
inspect_brief Inspect current metadata for one exact Brief without reading its content.
inspect_brief_revision Inspect metadata for one exact immutable Brief revision.
read_brief Read the content of one exact immutable Brief revision.

inspect_fleet

Section titled “inspect_fleet”

Inspect current fleet policy, capacity, retention, and execution defaults.

No input fields.

View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

inspect_capabilities

Section titled “inspect_capabilities”

Inspect the available Agent capability modules and configuration schemas.

Input Required Type Details
id No string minimum length: 3; maximum length: 80; pattern: ^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 3,
      "maxLength": 80,
      "pattern": "^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$"
    }
  },
  "additionalProperties": false
}

list_skills

Section titled “list_skills”

List available owner-local Skills.

Input Required Type Details
cursor No string pattern: ^skill_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
limit No integer minimum: 1; maximum: 25; default: 25
name No string Return Skills whose names contain this value, case-insensitively. minimum length: 1; maximum length: 80; pattern: ^[a-z][a-z0-9-]*$
status No “active” | “retired” —
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "pattern": "^skill_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "name": {
      "description": "Return Skills whose names contain this value, case-insensitively.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "pattern": "^[a-z][a-z0-9-]*$"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "retired"
      ]
    }
  },
  "additionalProperties": false
}

inspect_skill

Section titled “inspect_skill”

Inspect one exact owner-local Skill package version.

Input Required Type Details
id Yes string pattern: ^skill_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
version No integer exclusive minimum: 0; maximum: 9007199254740991
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^skill_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

list_blueprints

Section titled “list_blueprints”

List available owner-local Agent blueprints.

Input Required Type Details
cursor No string pattern: ^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
limit No integer minimum: 1; maximum: 25; default: 25
name No string minimum length: 1; maximum length: 80; pattern: ^[a-z][a-z0-9-]*$
status No “active” | “retired” —
tag No string minimum length: 1; maximum length: 40
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "pattern": "^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "pattern": "^[a-z][a-z0-9-]*$"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "retired"
      ]
    },
    "tag": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    }
  },
  "additionalProperties": false
}

inspect_blueprint

Section titled “inspect_blueprint”

Inspect one exact Agent blueprint package version.

Input Required Type Details
id Yes string pattern: ^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
version No integer exclusive minimum: 0; maximum: 9007199254740991
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

list_authoring_drafts

Section titled “list_authoring_drafts”

List compact references for active authoring drafts owned by this MCP client.

No input fields.

View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_briefs

Section titled “list_briefs”

List compact Brief metadata without reading content.

Input Required Type Details
cursor No string pattern: ^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
limit No integer minimum: 1; maximum: 25
name No string minimum length: 1; maximum length: 80; pattern: ^[A-Za-z0-9][A-Za-z0-9 ._-]*$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "pattern": "^[A-Za-z0-9][A-Za-z0-9 ._-]*$"
    }
  },
  "additionalProperties": false
}

inspect_brief

Section titled “inspect_brief”

Inspect current metadata for one exact Brief without reading its content.

Input Required Type Details
id Yes string pattern: ^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

inspect_brief_revision

Section titled “inspect_brief_revision”

Inspect metadata for one exact immutable Brief revision.

Input Required Type Details
brief Yes object | object | object Copy-ready Brief reference, summary, or create result returned by Crewhelm.
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "brief": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            },
            "revision": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 100
            }
          },
          "required": [
            "id",
            "revision"
          ],
          "additionalProperties": {}
        },
        {
          "type": "object",
          "properties": {
            "currentRevision": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 100
            },
            "id": {
              "type": "string",
              "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            }
          },
          "required": [
            "currentRevision",
            "id"
          ],
          "additionalProperties": {}
        },
        {
          "type": "object",
          "properties": {
            "brief": {
              "type": "object",
              "properties": {
                "currentRevision": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 100
                },
                "id": {
                  "type": "string",
                  "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                }
              },
              "required": [
                "currentRevision",
                "id"
              ],
              "additionalProperties": {}
            }
          },
          "required": [
            "brief"
          ],
          "additionalProperties": {}
        }
      ],
      "description": "Copy-ready Brief reference, summary, or create result returned by Crewhelm."
    }
  },
  "required": [
    "brief"
  ],
  "additionalProperties": false
}

read_brief

Section titled “read_brief”

Read the content of one exact immutable Brief revision.

Input Required Type Details
brief Yes object | object | object Copy-ready Brief reference, summary, or create result returned by Crewhelm.
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "brief": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            },
            "revision": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 100
            }
          },
          "required": [
            "id",
            "revision"
          ],
          "additionalProperties": {}
        },
        {
          "type": "object",
          "properties": {
            "currentRevision": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 100
            },
            "id": {
              "type": "string",
              "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            }
          },
          "required": [
            "currentRevision",
            "id"
          ],
          "additionalProperties": {}
        },
        {
          "type": "object",
          "properties": {
            "brief": {
              "type": "object",
              "properties": {
                "currentRevision": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 100
                },
                "id": {
                  "type": "string",
                  "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                }
              },
              "required": [
                "currentRevision",
                "id"
              ],
              "additionalProperties": {}
            }
          },
          "required": [
            "brief"
          ],
          "additionalProperties": {}
        }
      ],
      "description": "Copy-ready Brief reference, summary, or create result returned by Crewhelm."
    }
  },
  "required": [
    "brief"
  ],
  "additionalProperties": false
}

Write tools

Section titled “Write tools”

Preview or perform bounded changes under the required owner authority.

crewhelm_change_context

Section titled “crewhelm_change_context”

Change Crewhelm context

Preview fleet policy changes, draft configuration packages, or manage Briefs.

Attributes: write, destructive, idempotent, closed-world.

How to use this tool:

  1. Send {"request":"operations"} to list its subtools.
  2. Send {"request":"schema","name":"…"} for one subtool’s exact inputs.
  3. Send {"request":"execute","name":"…","input":{…}} to run it.
Subtool Purpose
preview_fleet_change Preview one bounded fleet policy patch without applying it.
apply_fleet_change Apply one bounded fleet policy patch against its exact current revision.
prepare_skill Create or replace a bounded Skill package draft for review.
retire_skill Preview or retire one exact Skill version.
prepare_blueprint Create or replace a bounded Agent blueprint package draft for review.
retire_blueprint Preview or retire one exact Agent blueprint version.
create_from_blueprint Preview or create a disabled Agent from one exact blueprint version.
preview_package Preview one Skill or Agent blueprint package draft and its confirmation digest.
apply_package Apply one confirmed Skill or Agent blueprint package draft.
discard_package_draft Discard one Skill or Agent blueprint package draft.
create_brief Create one bounded owner-provided text Brief.
revise_brief Create a new immutable revision of one exact Brief.
delete_brief Delete one exact unreferenced Brief revision.

preview_fleet_change

Section titled “preview_fleet_change”

Preview one bounded fleet policy patch without applying it.

Input Required Type Details
expectedRevision Yes integer exclusive minimum: 0; maximum: 9007199254740991
patch Yes object —
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "expectedRevision": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "patch": {
      "type": "object",
      "properties": {
        "capacity": {
          "type": "object",
          "properties": {
            "maxAgents": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            },
            "maxConcurrentRuns": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            },
            "maxConnections": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            }
          },
          "additionalProperties": false,
          "description": "Fleet resource capacity within Crewhelm's internal safety ceilings."
        },
        "execution": {
          "type": "object",
          "properties": {
            "maxDurationSeconds": {
              "type": "integer",
              "minimum": 1,
              "maximum": 3600,
              "description": "Maximum wall-clock seconds for one run."
            },
            "maxModelTokens": {
              "type": "integer",
              "minimum": 1,
              "maximum": 16384,
              "description": "Maximum model output tokens for one run."
            },
            "maxToolCalls": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100,
              "description": "Maximum integration tool executions for one run."
            },
            "maxTurns": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "description": "Maximum model turns for one run."
            }
          },
          "additionalProperties": false,
          "description": "Fleet-wide per-run ceilings; lower Agent-specific limits still win. execution.maxToolCalls cannot exceed integrations.maxCallsPerRun; raise both in the same patch when needed."
        },
        "integrations": {
          "type": "object",
          "properties": {
            "callsPerDay": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000000,
              "description": "New maximum integration executions across the fleet in a rolling day."
            },
            "callsPerThirtyDays": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000000,
              "description": "New maximum integration executions across the fleet in a rolling thirty-day window."
            },
            "duplicateToolCallLimit": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "description": "New maximum executions of identical tool arguments within one run; bounds accidental loops."
            },
            "maxCallsPerRun": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "description": "New maximum integration executions across all tools in one run. It must be at least execution.maxToolCalls and maxCallsPerToolPerRun."
            },
            "maxCallsPerToolPerRun": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "description": "New maximum executions of one granted integration tool in one run. It cannot exceed integrations.maxCallsPerRun."
            },
            "maxConcurrencyPerGrant": {
              "type": "integer",
              "minimum": 1,
              "maximum": 16,
              "description": "New maximum simultaneous executions using one tool grant."
            }
          },
          "additionalProperties": false,
          "description": "Integration usage and loop controls."
        },
        "retention": {
          "type": "object",
          "properties": {
            "inboxSeconds": {
              "type": "integer",
              "minimum": 3600,
              "maximum": 31536000
            },
            "runSeconds": {
              "type": "integer",
              "minimum": 3600,
              "maximum": 31536000
            }
          },
          "additionalProperties": false,
          "description": "Run-detail and operational-inbox retention in seconds."
        },
        "schedules": {
          "type": "object",
          "properties": {
            "minimumIntervalSeconds": {
              "type": "integer",
              "minimum": 60,
              "maximum": 604800,
              "description": "New minimum interval in seconds for recurring Agent schedules."
            }
          },
          "additionalProperties": false,
          "description": "Recurring schedule controls."
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "expectedRevision",
    "patch"
  ],
  "additionalProperties": false
}

apply_fleet_change

Section titled “apply_fleet_change”

Apply one bounded fleet policy patch against its exact current revision.

Input Required Type Details
expectedRevision Yes integer exclusive minimum: 0; maximum: 9007199254740991
patch Yes object —
requestKey No string Optional retry identity. Omit it on the ordinary happy path. minimum length: 1; maximum length: 128; pattern: ^[A-Za-z0-9._~-]+$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "expectedRevision": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "patch": {
      "type": "object",
      "properties": {
        "capacity": {
          "type": "object",
          "properties": {
            "maxAgents": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            },
            "maxConcurrentRuns": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            },
            "maxConnections": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            }
          },
          "additionalProperties": false,
          "description": "Fleet resource capacity within Crewhelm's internal safety ceilings."
        },
        "execution": {
          "type": "object",
          "properties": {
            "maxDurationSeconds": {
              "type": "integer",
              "minimum": 1,
              "maximum": 3600,
              "description": "Maximum wall-clock seconds for one run."
            },
            "maxModelTokens": {
              "type": "integer",
              "minimum": 1,
              "maximum": 16384,
              "description": "Maximum model output tokens for one run."
            },
            "maxToolCalls": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100,
              "description": "Maximum integration tool executions for one run."
            },
            "maxTurns": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "description": "Maximum model turns for one run."
            }
          },
          "additionalProperties": false,
          "description": "Fleet-wide per-run ceilings; lower Agent-specific limits still win. execution.maxToolCalls cannot exceed integrations.maxCallsPerRun; raise both in the same patch when needed."
        },
        "integrations": {
          "type": "object",
          "properties": {
            "callsPerDay": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000000,
              "description": "New maximum integration executions across the fleet in a rolling day."
            },
            "callsPerThirtyDays": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000000,
              "description": "New maximum integration executions across the fleet in a rolling thirty-day window."
            },
            "duplicateToolCallLimit": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "description": "New maximum executions of identical tool arguments within one run; bounds accidental loops."
            },
            "maxCallsPerRun": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "description": "New maximum integration executions across all tools in one run. It must be at least execution.maxToolCalls and maxCallsPerToolPerRun."
            },
            "maxCallsPerToolPerRun": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "description": "New maximum executions of one granted integration tool in one run. It cannot exceed integrations.maxCallsPerRun."
            },
            "maxConcurrencyPerGrant": {
              "type": "integer",
              "minimum": 1,
              "maximum": 16,
              "description": "New maximum simultaneous executions using one tool grant."
            }
          },
          "additionalProperties": false,
          "description": "Integration usage and loop controls."
        },
        "retention": {
          "type": "object",
          "properties": {
            "inboxSeconds": {
              "type": "integer",
              "minimum": 3600,
              "maximum": 31536000
            },
            "runSeconds": {
              "type": "integer",
              "minimum": 3600,
              "maximum": 31536000
            }
          },
          "additionalProperties": false,
          "description": "Run-detail and operational-inbox retention in seconds."
        },
        "schedules": {
          "type": "object",
          "properties": {
            "minimumIntervalSeconds": {
              "type": "integer",
              "minimum": 60,
              "maximum": 604800,
              "description": "New minimum interval in seconds for recurring Agent schedules."
            }
          },
          "additionalProperties": false,
          "description": "Recurring schedule controls."
        }
      },
      "additionalProperties": false
    },
    "requestKey": {
      "description": "Optional retry identity. Omit it on the ordinary happy path.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9._~-]+$"
    }
  },
  "required": [
    "expectedRevision",
    "patch"
  ],
  "additionalProperties": false
}

prepare_skill

Section titled “prepare_skill”

Create or replace a bounded Skill package draft for review.

Input Required Type Details
expectedVersion No integer exclusive minimum: 0; maximum: 9007199254740991
id No string pattern: ^skill_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
package Yes object A UTF-8 package up to 128 KiB with one required SKILL.md file.
repairVersion No integer exclusive minimum: 0; maximum: 9007199254740991
requestKey No string Optional retry identity. Omit it on the ordinary happy path. minimum length: 1; maximum length: 128; pattern: ^[A-Za-z0-9._~-]+$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "expectedVersion": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "id": {
      "type": "string",
      "pattern": "^skill_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "package": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "minLength": 1,
          "maxLength": 320
        },
        "files": {
          "minItems": 1,
          "maxItems": 64,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "content": {
                "type": "string",
                "maxLength": 65536
              },
              "path": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240,
                "description": "SKILL.md or a relative path under assets/, references/, or scripts/."
              }
            },
            "required": [
              "content",
              "path"
            ],
            "additionalProperties": false,
            "description": "One UTF-8 Skill file up to 64 KiB. Binary assets are not accepted."
          }
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "pattern": "^[a-z][a-z0-9-]*$"
        },
        "provenance": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "const": "authored"
                }
              },
              "required": [
                "kind"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "commit": {
                  "type": "string",
                  "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$"
                },
                "kind": {
                  "type": "string",
                  "const": "repository"
                },
                "source": {
                  "type": "string",
                  "maxLength": 2048,
                  "format": "uri",
                  "description": "HTTPS attribution URL without credentials, query, or fragment."
                }
              },
              "required": [
                "commit",
                "kind",
                "source"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "const": "web"
                },
                "source": {
                  "type": "string",
                  "maxLength": 2048,
                  "format": "uri",
                  "description": "HTTPS attribution URL without credentials, query, or fragment."
                }
              },
              "required": [
                "kind",
                "source"
              ],
              "additionalProperties": false
            }
          ]
        }
      },
      "required": [
        "description",
        "files",
        "name",
        "provenance"
      ],
      "additionalProperties": false,
      "description": "A UTF-8 package up to 128 KiB with one required SKILL.md file."
    },
    "repairVersion": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "requestKey": {
      "description": "Optional retry identity. Omit it on the ordinary happy path.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9._~-]+$"
    }
  },
  "required": [
    "package"
  ],
  "additionalProperties": false
}

retire_skill

Section titled “retire_skill”

Preview or retire one exact Skill version.

Input Required Type Details
expectedVersion Yes integer exclusive minimum: 0; maximum: 9007199254740991
id Yes string pattern: ^skill_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
confirm No boolean Leave false to preview. Repeat the unchanged operation with true to apply it. default: false
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "expectedVersion": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "id": {
      "type": "string",
      "pattern": "^skill_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "confirm": {
      "default": false,
      "description": "Leave false to preview. Repeat the unchanged operation with true to apply it.",
      "type": "boolean"
    }
  },
  "required": [
    "expectedVersion",
    "id"
  ],
  "additionalProperties": false
}

prepare_blueprint

Section titled “prepare_blueprint”

Create or replace a bounded Agent blueprint package draft for review.

Input Required Type Details
expectedVersion No integer exclusive minimum: 0; maximum: 9007199254740991
id No string pattern: ^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
package Yes object A bounded, untrusted Agent blueprint package. Parameters use {{name}} tokens.
requestKey No string Optional retry identity. Omit it on the ordinary happy path. minimum length: 1; maximum length: 128; pattern: ^[A-Za-z0-9._~-]+$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "expectedVersion": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "id": {
      "type": "string",
      "pattern": "^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "package": {
      "type": "object",
      "properties": {
        "agent": {
          "type": "object",
          "properties": {
            "capabilities": {
              "minItems": 1,
              "maxItems": 16,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "configuration": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 2048
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "number"
                                  },
                                  {
                                    "type": "boolean"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "maxLength": 2048
                                    },
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "boolean"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "additionalProperties": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "maxLength": 2048
                                    },
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "boolean"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            ]
                          }
                        },
                        {
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 80
                          },
                          "additionalProperties": {
                            "anyOf": [
                              {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "number"
                                  },
                                  {
                                    "type": "boolean"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "maxLength": 2048
                                    },
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "boolean"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                },
                                "additionalProperties": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "maxLength": 2048
                                    },
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "boolean"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            ]
                          }
                        }
                      ]
                    }
                  },
                  "id": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 80,
                    "pattern": "^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$"
                  },
                  "schemaVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000
                  }
                },
                "required": [
                  "configuration",
                  "id",
                  "schemaVersion"
                ],
                "additionalProperties": false
              },
              "description": "One to 16 unique capability modules sorted in canonical ID order."
            },
            "executionLimits": {
              "type": "object",
              "properties": {
                "integrations": {
                  "type": "object",
                  "properties": {
                    "duplicateToolCallLimit": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 100
                    },
                    "maxCallsPerRun": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 100
                    },
                    "maxCallsPerToolPerRun": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 100
                    }
                  },
                  "required": [
                    "duplicateToolCallLimit",
                    "maxCallsPerRun",
                    "maxCallsPerToolPerRun"
                  ],
                  "additionalProperties": false,
                  "description": "Optional Agent-specific per-Run integration ceilings; fleet ceilings still win."
                },
                "maxDurationSeconds": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 3600
                },
                "maxModelTokens": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 1000000
                },
                "maxToolCalls": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 100
                },
                "maxTurns": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 100
                }
              },
              "required": [
                "maxDurationSeconds",
                "maxModelTokens",
                "maxToolCalls",
                "maxTurns"
              ],
              "additionalProperties": false
            },
            "instructions": {
              "type": "string",
              "minLength": 1,
              "maxLength": 8192
            },
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            }
          },
          "required": [
            "capabilities",
            "instructions",
            "name"
          ],
          "additionalProperties": false
        },
        "description": {
          "type": "string",
          "minLength": 1,
          "maxLength": 320
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "pattern": "^[a-z][a-z0-9-]*$"
        },
        "parameters": {
          "maxItems": 16,
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "default": {
                    "type": "string",
                    "maxLength": 1024
                  },
                  "description": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 40,
                    "pattern": "^[a-z][a-z0-9-]*$"
                  },
                  "type": {
                    "type": "string",
                    "const": "string"
                  }
                },
                "required": [
                  "description",
                  "name",
                  "type"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "default": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "description": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160
                  },
                  "maximum": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "minimum": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 40,
                    "pattern": "^[a-z][a-z0-9-]*$"
                  },
                  "type": {
                    "type": "string",
                    "const": "integer"
                  }
                },
                "required": [
                  "description",
                  "name",
                  "type"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "default": {
                    "type": "boolean"
                  },
                  "description": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 40,
                    "pattern": "^[a-z][a-z0-9-]*$"
                  },
                  "type": {
                    "type": "string",
                    "const": "boolean"
                  }
                },
                "required": [
                  "description",
                  "name",
                  "type"
                ],
                "additionalProperties": false
              }
            ]
          }
        },
        "provenance": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "const": "authored"
                }
              },
              "required": [
                "kind"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "commit": {
                  "type": "string",
                  "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$"
                },
                "kind": {
                  "type": "string",
                  "const": "repository"
                },
                "source": {
                  "type": "string",
                  "maxLength": 2048,
                  "format": "uri",
                  "description": "HTTPS attribution URL without credentials, query, or fragment."
                }
              },
              "required": [
                "commit",
                "kind",
                "source"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "const": "web"
                },
                "source": {
                  "type": "string",
                  "maxLength": 2048,
                  "format": "uri",
                  "description": "HTTPS attribution URL without credentials, query, or fragment."
                }
              },
              "required": [
                "kind",
                "source"
              ],
              "additionalProperties": false
            }
          ]
        },
        "publisher": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            },
            "url": {
              "type": "string",
              "maxLength": 2048,
              "format": "uri"
            }
          },
          "required": [
            "name"
          ],
          "additionalProperties": false
        },
        "schemaVersion": {
          "type": "number",
          "const": 1
        },
        "tags": {
          "maxItems": 12,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40,
            "pattern": "^[a-z][a-z0-9-]*$"
          }
        }
      },
      "required": [
        "agent",
        "description",
        "name",
        "parameters",
        "provenance",
        "publisher",
        "schemaVersion",
        "tags"
      ],
      "additionalProperties": false,
      "description": "A bounded, untrusted Agent blueprint package. Parameters use {{name}} tokens."
    },
    "requestKey": {
      "description": "Optional retry identity. Omit it on the ordinary happy path.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9._~-]+$"
    }
  },
  "required": [
    "package"
  ],
  "additionalProperties": false
}

retire_blueprint

Section titled “retire_blueprint”

Preview or retire one exact Agent blueprint version.

Input Required Type Details
expectedVersion Yes integer exclusive minimum: 0; maximum: 9007199254740991
id Yes string pattern: ^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
confirm No boolean Leave false to preview. Repeat the unchanged operation with true to apply it. default: false
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "expectedVersion": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "id": {
      "type": "string",
      "pattern": "^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "confirm": {
      "default": false,
      "description": "Leave false to preview. Repeat the unchanged operation with true to apply it.",
      "type": "boolean"
    }
  },
  "required": [
    "expectedVersion",
    "id"
  ],
  "additionalProperties": false
}

create_from_blueprint

Section titled “create_from_blueprint”

Preview or create a disabled Agent from one exact blueprint version.

Input Required Type Details
id Yes string pattern: ^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
parameters No object default: [object Object]
version No integer exclusive minimum: 0; maximum: 9007199254740991
confirm No boolean Leave false to preview. Repeat the unchanged operation with true to apply it. default: false
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^blueprint_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "parameters": {
      "default": {},
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40,
        "pattern": "^[a-z][a-z0-9-]*$"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 1024
          },
          {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "confirm": {
      "default": false,
      "description": "Leave false to preview. Repeat the unchanged operation with true to apply it.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

preview_package

Section titled “preview_package”

Preview one Skill or Agent blueprint package draft and its confirmation digest.

Input Required Type Details
draft Yes object —
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "draft": {
      "type": "object",
      "properties": {
        "digest": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "id": {
          "type": "string",
          "pattern": "^mcp_draft_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
        },
        "kind": {
          "type": "string",
          "enum": [
            "agent-blueprint-package",
            "skill-package"
          ]
        },
        "revision": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "digest",
        "id",
        "kind",
        "revision"
      ],
      "additionalProperties": {}
    }
  },
  "required": [
    "draft"
  ],
  "additionalProperties": false
}

apply_package

Section titled “apply_package”

Apply one confirmed Skill or Agent blueprint package draft.

Input Required Type Details
draft Yes object —
expectedConfirmationDigest Yes string pattern: ^[0-9a-f]{64}$
requestKey No string Optional retry identity. Omit it on the ordinary happy path. minimum length: 1; maximum length: 128; pattern: ^[A-Za-z0-9._~-]+$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "draft": {
      "type": "object",
      "properties": {
        "digest": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "id": {
          "type": "string",
          "pattern": "^mcp_draft_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
        },
        "kind": {
          "type": "string",
          "enum": [
            "agent-blueprint-package",
            "skill-package"
          ]
        },
        "revision": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "digest",
        "id",
        "kind",
        "revision"
      ],
      "additionalProperties": {}
    },
    "expectedConfirmationDigest": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$"
    },
    "requestKey": {
      "description": "Optional retry identity. Omit it on the ordinary happy path.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9._~-]+$"
    }
  },
  "required": [
    "draft",
    "expectedConfirmationDigest"
  ],
  "additionalProperties": false
}

discard_package_draft

Section titled “discard_package_draft”

Discard one Skill or Agent blueprint package draft.

Input Required Type Details
draft Yes object —
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "draft": {
      "type": "object",
      "properties": {
        "digest": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "id": {
          "type": "string",
          "pattern": "^mcp_draft_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
        },
        "kind": {
          "type": "string",
          "enum": [
            "agent-blueprint-package",
            "skill-package"
          ]
        },
        "revision": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "digest",
        "id",
        "kind",
        "revision"
      ],
      "additionalProperties": {}
    }
  },
  "required": [
    "draft"
  ],
  "additionalProperties": false
}

create_brief

Section titled “create_brief”

Create one bounded owner-provided text Brief.

Input Required Type Details
content Yes string UTF-8 text without control characters, unpaired surrogates, or a leading BOM; maximum 32768 encoded bytes. minimum length: 1; maximum length: 32768
mediaType Yes “application/json” | “text/markdown” | “text/plain” —
name Yes string minimum length: 1; maximum length: 80; pattern: ^[A-Za-z0-9][A-Za-z0-9 ._-]*$
requestKey No string Optional retry identity. Omit it on the ordinary happy path. minimum length: 1; maximum length: 128; pattern: ^[A-Za-z0-9._~-]+$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32768,
      "description": "UTF-8 text without control characters, unpaired surrogates, or a leading BOM; maximum 32768 encoded bytes."
    },
    "mediaType": {
      "type": "string",
      "enum": [
        "application/json",
        "text/markdown",
        "text/plain"
      ]
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "pattern": "^[A-Za-z0-9][A-Za-z0-9 ._-]*$"
    },
    "requestKey": {
      "description": "Optional retry identity. Omit it on the ordinary happy path.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9._~-]+$"
    }
  },
  "required": [
    "content",
    "mediaType",
    "name"
  ],
  "additionalProperties": false
}

revise_brief

Section titled “revise_brief”

Create a new immutable revision of one exact Brief.

Input Required Type Details
content Yes string UTF-8 text without control characters, unpaired surrogates, or a leading BOM; maximum 32768 encoded bytes. minimum length: 1; maximum length: 32768
mediaType Yes “application/json” | “text/markdown” | “text/plain” —
brief Yes object | object | object Copy-ready Brief reference, summary, or create result returned by Crewhelm.
requestKey No string Optional retry identity. Omit it on the ordinary happy path. minimum length: 1; maximum length: 128; pattern: ^[A-Za-z0-9._~-]+$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32768,
      "description": "UTF-8 text without control characters, unpaired surrogates, or a leading BOM; maximum 32768 encoded bytes."
    },
    "mediaType": {
      "type": "string",
      "enum": [
        "application/json",
        "text/markdown",
        "text/plain"
      ]
    },
    "brief": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            },
            "revision": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 100
            }
          },
          "required": [
            "id",
            "revision"
          ],
          "additionalProperties": {}
        },
        {
          "type": "object",
          "properties": {
            "currentRevision": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 100
            },
            "id": {
              "type": "string",
              "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            }
          },
          "required": [
            "currentRevision",
            "id"
          ],
          "additionalProperties": {}
        },
        {
          "type": "object",
          "properties": {
            "brief": {
              "type": "object",
              "properties": {
                "currentRevision": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 100
                },
                "id": {
                  "type": "string",
                  "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                }
              },
              "required": [
                "currentRevision",
                "id"
              ],
              "additionalProperties": {}
            }
          },
          "required": [
            "brief"
          ],
          "additionalProperties": {}
        }
      ],
      "description": "Copy-ready Brief reference, summary, or create result returned by Crewhelm."
    },
    "requestKey": {
      "description": "Optional retry identity. Omit it on the ordinary happy path.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9._~-]+$"
    }
  },
  "required": [
    "content",
    "mediaType",
    "brief"
  ],
  "additionalProperties": false
}

delete_brief

Section titled “delete_brief”

Delete one exact unreferenced Brief revision.

Input Required Type Details
brief Yes object | object | object Copy-ready Brief reference, summary, or create result returned by Crewhelm.
requestKey No string Optional retry identity. Omit it on the ordinary happy path. minimum length: 1; maximum length: 128; pattern: ^[A-Za-z0-9._~-]+$
View exact JSON Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "brief": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            },
            "revision": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 100
            }
          },
          "required": [
            "id",
            "revision"
          ],
          "additionalProperties": {}
        },
        {
          "type": "object",
          "properties": {
            "currentRevision": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 100
            },
            "id": {
              "type": "string",
              "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            }
          },
          "required": [
            "currentRevision",
            "id"
          ],
          "additionalProperties": {}
        },
        {
          "type": "object",
          "properties": {
            "brief": {
              "type": "object",
              "properties": {
                "currentRevision": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 100
                },
                "id": {
                  "type": "string",
                  "pattern": "^brief_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                }
              },
              "required": [
                "currentRevision",
                "id"
              ],
              "additionalProperties": {}
            }
          },
          "required": [
            "brief"
          ],
          "additionalProperties": {}
        }
      ],
      "description": "Copy-ready Brief reference, summary, or create result returned by Crewhelm."
    },
    "requestKey": {
      "description": "Optional retry identity. Omit it on the ordinary happy path.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9._~-]+$"
    }
  },
  "required": [
    "brief"
  ],
  "additionalProperties": false
}