---
title: "Invoke Endpoint"
method: POST
path: "/v1/invoke"
tags: ["semantic-router"]
---

# Invoke Endpoint

`POST /v1/invoke`

## Request

- Base URL: `https://app.teetra.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.teetra.com/v1/invoke`
- Auth: none declared

HTTP endpoint executing Warrant Semantic DNS invoke pipeline.

## Request body

- InvokeRequest: Payload schema for invoke API endpoint.
  - `intent` string, required: Natural language intent or action description
  - `domain` string, nullable: Explicit target domain name (e.g. 'neemio.com')
  - `params` object, nullable: Query/path/body parameters for target adapter route
  - `feedback` object, nullable: Client satisfaction and retry feedback
  - `consumer_id` string, nullable: Consumer identity subject for trial session tracking
  - `auth_token` string, nullable: Verified consumer authentication token (WAT or OAuth 2.1)
  - `is_trial` boolean: Designate request as a trial session call

## Response `200`

Successful Response

- InvokeResult: Typed execution result or targeted conversion referral payload.
  - `status` string, required: Execution status: 'success', 'conversion_referral', 'discovery', 'no_match', 'error'
  - `success` boolean, required: Whether invocation executed successfully
  - `status_code` integer, required: HTTP status code from adapter or proxy layer
  - `data` unknown
  - `adapter_id` string, nullable: Matched target adapter identifier
  - `domain` string, nullable: Resolved enrollee domain
  - `route_id` string, nullable: Matched route allow list identifier
  - `path` string, nullable: Target endpoint path invoked
  - `method` string, nullable: Target HTTP method
  - `candidate_tools` CandidateTool[]: Bounded surface candidates (<= 5 tools per intent category)
    - `route_id` string, required
    - `adapter_id` string, required
    - `domain` string, required
    - `path_pattern` string, required
    - `method` string, required
    - `description` string, required
    - `intent_category` string, required
    - `is_verified` boolean, required
    - `semantic_similarity` number, required
    - `telemetry_weight` number, required
    - `final_score` number, required
    - `input_schema` object, nullable
    - `output_schema` object, nullable
    - `upstream_url` string
  - `discovery_list` object[]: Structured discovery list returned on collision arbitration tie
  - `referral` object, nullable: Targeted conversion referral payload (e.g. on trial budget exhaustion)
  - `offer` object, nullable: Structured conversion offer block
  - `metadata` object: Resolution routing diagnostics and telemetry metadata
  - `circuit_state` string, nullable: Circuit breaker state: CLOSED, OPEN, HALF_OPEN
  - `action_hash` string, nullable: Matched action content hash for confirmation
  - `message` string, nullable: Human readable outcome summary

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/teetra/apis/warrant.md) · [All operations](https://skmtc.dev/teetra/apis/warrant/llms.txt) · [OpenAPI document](https://skmtc.dev/teetra/apis/warrant/revisions/a33505db716f?raw)