Create Revision

tools/call create_revision

Creates a revision proposal for a term.

Conventions

Authentication

All endpoints require a Bearer token. Pass it in the Authorization header as Bearer <token>. Tokens are issued from the API settings page in your workspace.

Base URL

All paths are relative to https://mcp.allsign.app. The spec includes full paths; strip the base when constructing requests.

Versioning

The current version is 0.1.0. Breaking changes are documented in the Changelog and announced before taking effect.

Specification

The server follows the MCP specification and communicates via JSON-RPC 2.0. All documentation on this page is generated directly from the spec.

Example

Bash

curl "https://mcp.allsign.app" \
  -X POST \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_revision",
    "arguments": {
      "term_ref": "00000000-0000-4000-8000-000000000000",
      "description": ""
    }
  }
}'

Request

Request Body

{
  "term_ref": "00000000-0000-4000-8000-000000000000",
  "description": "",
  "name": "",
  "remarks": ""
}

term_ref

Public stable resource reference.

string (uuid)required

description

Proposed term description.

stringrequired

name

Optional proposed term name.

stringoptional

remarks

Optional revision remarks.

stringoptional

Responses

200 OK

{
  "decision": {
    "actor": "",
    "created_at": "",
    "ref": "00000000-0000-4000-8000-000000000000",
    "remarks": "",
    "revision": "",
    "status": "accepted"
  },
  "revision": {
    "actor": "",
    "created_at": "",
    "decisions": [],
    "description": "",
    "latest": true,
    "name": "",
    "number": 1,
    "ref": "00000000-0000-4000-8000-000000000000"
  }
}

decision

Canonical decision resource.

objectrequired

decision.actor

objectrequired

decision.created_at

string (date-time)required

decision.ref

Public stable resource reference.

string (uuid)required

decision.remarks

stringrequired

decision.revision

objectrequired

decision.status

accepted | rejectedrequired

revision

Canonical revision resource.

objectrequired

revision.actor

objectrequired

revision.created_at

string (date-time)required

revision.decisions

object[]required

revision.description

stringrequired

revision.latest

booleanrequired

revision.name

stringrequired

revision.number

integerrequired

revision.ref

Public stable resource reference.

string (uuid)required

Errors

Standard JSON-RPC 2.0 error codes apply.

-32600

Invalid Request

erroroptional

-32601

Method not found

erroroptional

-32602

Invalid params

erroroptional

-32603

Internal error

erroroptional

401

Bearer token missing or invalid

erroroptional

403

Actor does not have the required capacity for this operation

erroroptional