capabilities

Execute a capability

Execute a Strale capability. Two patterns:

  1. Direct execution: Provide capability_slug and inputs to execute a specific capability.
  2. Semantic matching: Provide task as a natural language description — the system finds and executes the best matching capability.

Free-tier capabilities (iban-validate, email-validate, dns-lookup, json-repair, url-to-markdown) work without authentication.

For long-running capabilities (>10s), the response has status: "pending" with a transaction_id. Poll GET /v1/transactions/{id} until status is completed or failed.

Supports Idempotency-Key header for safe retries.

post/v1/do

Request

  • Base URL: https://api.strale.io
  • URL: https://api.strale.io/v1/do
  • Auth: one of:
    • HTTP bearer
    • none

Request body

taskstring

Natural language task description. The system finds the best matching capability.

capability_slugstring

Direct capability slug to execute.

inputsobject

Capability-specific input fields.

max_price_centsinteger

Maximum price willing to pay (EUR cents). Required for authenticated requests to paid capabilities.

timeout_secondsinteger

Max execution time (1-60, default 30).

dry_runboolean

If true, returns matched capability without executing.

Example request

{
  "task": "Validate this IBAN: DE89370400440532013000",
  "capability_slug": "iban-validate",
  "inputs": {
    "iban": "DE89370400440532013000"
  }
}

Response

Capability executed successfully (synchronous).

free_tierboolean

True for unauthenticated free-tier calls.

usageobject

Free-tier usage counter (unauthenticated only).

upgradeobject

Upgrade prompt with paid capability examples (free-tier only).

Changes

No recorded changes to this operation across all 1 revision of this API.