Skills (LLM + API)

Skills are reusable building blocks — either an LLM prompt template or an HTTP API wrapper — that workflows compose into multi-step automation runs. Single-brace {variable} placeholders are interpolated at execution time; double-brace {{...}} patterns are ignored.

List Skills

GET /skills

Returns skills in your workspace, filtered by the query parameters below.

Query Parameters

Example

curl "https://be.graph8.com/api/v1/skills?runtime_type=llm&enabled=true" \
  -H "Authorization: Bearer $API_KEY"

Get Skill

GET /skills/{action_id}

Returns the full skill record, including llm_config (for LLM skills) or api_config (for API skills).

Path Parameters

Example

curl "https://be.graph8.com/api/v1/skills/sk_uuid" \
  -H "Authorization: Bearer $API_KEY"

Get Skill Variables

GET /skills/{action_id}/variables

Extracts the input variable names from a skill’s prompt or API template. Only single-brace {var} references are returned; {{...}} patterns are ignored.

Path Parameters

Response

{
  "action_id": "sk_uuid",
  "runtime_type": "llm",
  "variables": ["name", "company"],
  "total": 2
}

List Models

GET /skills/models

Returns the LLM models available for use in LLM skills.

Example

curl "https://be.graph8.com/api/v1/skills/models" \
  -H "Authorization: Bearer $API_KEY"

Response

{
  "models": [
    { "id": "gpt-4o", "provider": "openai", "label": "GPT-4o" },
    { "id": "claude-sonnet-4-5", "provider": "anthropic", "label": "..." }
  ],
  "total": 9
}

List Templates

GET /skills/templates

Returns built-in skill templates filtered to llm and api runtimes only.

Query Parameters

Example

curl "https://be.graph8.com/api/v1/skills/templates" \
  -H "Authorization: Bearer $API_KEY"

Response

{
  "actions": [
    { "id": "tpl_uuid", "name": "Summarize meeting", "runtime_type": "llm", "category": "summarization" }
  ],
  "total_count": 1
}

Create Skill

POST /skills → 201 Created

Creates a new skill. The required fields differ by runtime_type.

Request Body

llm_config fields

api_config fields

Example — LLM skill

curl -X POST "https://be.graph8.com/api/v1/skills" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summarize meeting",
    "description": "Summarize a meeting transcript into key points",
    "runtime_type": "llm",
    "object_type": "Meeting",
    "requires_approval": false,
    "llm_config": {
      "model": "claude-sonnet-4-5",
      "prompt_template": "Summarize: {transcript}",
      "temperature": 0.2
    }
  }'

Example — API skill

curl -X POST "https://be.graph8.com/api/v1/skills" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lookup zip",
    "runtime_type": "api",
    "api_config": {
      "endpoint": "https://api.example.com/zip/{zip}",
      "method": "GET",
      "headers": { "Authorization": "Bearer {api_key}" },
      "query_params": {},
      "body_template": ""
    }
  }'

Update Skill

PUT /skills/{action_id}

Partial update. Supply only the fields you want to change. The runtime_type field is silently dropped server-side — you cannot change a skill’s runtime after creation.

Path Parameters

Example

curl -X PUT "https://be.graph8.com/api/v1/skills/sk_uuid" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summarize meeting v2",
    "llm_config": { "temperature": 0.1 }
  }'

Validate Skill

POST /skills/validate

Validates a prompt template string or a full skill definition without saving. Returns extracted variables and any warnings.

Request Body

Two accepted shapes:

Template string validation:

{ "template": "Hello {name}" }

Full definition validation:

{ "runtime_type": "llm", "llm_config": { "model": "claude-sonnet-4-5", "prompt_template": "Hello {name}", "temperature": 0.2 } }

Example

curl -X POST "https://be.graph8.com/api/v1/skills/validate" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "template": "Hello {name}" }'

Response

{
  "valid": true,
  "variables": ["name"],
  "variable_count": 1,
  "warnings": []
}

Create Skill from Template

POST /skills/from-template → 201 Created

Creates a new skill from a built-in template, with optional overrides.

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/skills/from-template" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_uuid",
    "name": "My Skill",
    "overrides": { "llm_config": { "temperature": 0.5 } }
  }'

Create Skill from Workflow Node

POST /skills/from-node → 201 Created

Lifts an existing workflow action node into a standalone reusable skill. The source node must be of type action.

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/skills/from-node" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_uuid",
    "node_id": "n1",
    "name": "Draft reply skill"
  }'

Execute Skill

POST /skills/{action_id}/execute

Runs the skill with the provided input data. Use for testing and preview; production execution happens inside workflow runs.

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/skills/sk_uuid/execute" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_data": { "name": "Jane" },
    "triggered_by": "user_x",
    "trigger_type": "manual"
  }'