design.registerRevision

TOOLtools/call

Scopes

read:designregister:design_revisions

Also needs claim:design_requests, and a live claim, when changeRequestId is given.

Inputs

idempotencyKeystringRequired
componentIdstringRequired
parentRevisionIdstring
changeRequestIdstring
claimGenerationinteger
registrationKeystringRequired
manifestobjectRequired

Returns

The Design operation's result. A call returns content[0].text with the JSON result and structuredContent.result with the same value.

Listed when

The key has Design access and the tool's scope.

Request

{
  "jsonrpc": "2.0",
  "id": "example_design_registerRevision",
  "method": "tools/call",
  "params": {
    "name": "design.registerRevision",
    "arguments": {
      "idempotencyKey": "retry-1",
      "componentId": "<componentId>",
      "registrationKey": "<registrationKey>",
      "manifest": {
        "brief": "<brief>",
        "promptVersion": "<promptVersion>",
        "bundleVersion": "<bundleVersion>",
        "bundleHash": "<bundleHash>",
        "model": {
          "provider": "<provider>",
          "name": "<name>",
          "version": "<version>",
          "settingsHash": "<settingsHash>"
        },
        "repoRef": {
          "repository": "<repository>",
          "ref": "<ref>"
        },
        "commit": "<commit>",
        "previews": [
          {
            "key": "<key>",
            "viewport": {
              "width": 1,
              "height": 1,
              "deviceScaleFactor": 0.1
            },
            "state": "<state>",
            "theme": "<theme>",
            "fileId": "<fileId>",
            "sha256": "<sha256>",
            "width": 1,
            "height": 1,
            "alt": "<alt>"
          }
        ],
        "inspectionLayers": [
          {
            "previewKey": "<previewKey>",
            "kind": "original",
            "fileId": "<fileId>",
            "sha256": "<sha256>"
          }
        ]
      }
    }
  }
}

Endpoint

POST https://www.specifywork.com/api/mcp

Authorization: Bearer <agent key>, a key that starts with sw_agent.