Pull tool definition (config-as-code)

{
  "contentHash": "a3f5c9d8e7b4f1a2c6d3e8b9f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9",
  "definition": {
    "config": {
      "retryCount": 3,
      "timeoutSeconds": 30,
      "enableLogging": true,
      "inputFormat": "json",
      "outputFormat": "csv"
    },
    "description": "Transforms incoming JSON data into CSV format with configurable retry and timeout settings.",
    "name": "DataTransformer",
    "parametersSchema": {
      "type": "object",
      "properties": {
        "retryCount": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10,
          "default": 3
        },
        "timeoutSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 120,
          "default": 30
        },
        "enableLogging": {
          "type": "boolean",
          "default": true
        }
      },
      "required": [
        "retryCount",
        "timeoutSeconds"
      ]
    },
    "toolType": "flow"
  },
  "lastModifiedSource": "dashboard",
  "toolId": "tool_9f8e7d6c5b4a3210",
  "updatedAt": "2024-06-10T16:45:00Z"
}

Return the canonical config-as-code definition and provenance for a tool by name — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live tool state, so it is accurate even immediately after a dashboard edit.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

namestringRequired>=1 character

Response

Canonical definition + provenance

contentHashstring

definitionobject

lastModifiedSourcestring or null

toolIdstring

updatedAtstring or null

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -G https://api.runtype.com/v1/tools/pull \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d name=DataTransformer