agent-search

Create an Agent Search job for reconnectable SSE streaming

post/agent-search/jobs

Request

  • Base URL: https://api.fed10.ai/api
  • URL: https://api.fed10.ai/api/agent-search/jobs
  • Auth: API key in header Authorization

Request body

querystring required

Search query

searchContextobject

Prior search context for refinement

use_enhancerboolean

Auto-expand terse queries

template_slugstring

Prompt template slug to apply

template_variablesobject

Prompt template variable values

conversation_idstring

Existing conversation ID to resume

resolved_action_idstring

Resolved pending-action ID for a model-authored follow-up without a new visible user turn

connection_replayboolean

Resume the original request after integration setup without persisting a duplicate user turn

persist_conversationboolean

Persist the turn in Smart Search history; must be false for fingerprint-bound requests

conversation_surface'smart_search' | 'embedded'

Surface of a new durable conversation; embedded chats are excluded from main history

read_onlyboolean

Restrict this request to non-mutating agent tools; required for fingerprint-bound requests

expected_context_fingerprintstring

Fail closed unless live company context matches a prior authenticated receipt; requires read_only=true and persist_conversation=false and forbids conversation, project, document, attachment, CRM, and briefing context

fast_modeboolean

Brief answer mode - concise answers with lighter analysis (compat alias for answer_depth=brief)

answer_depth'brief' | 'detailed' | 'deep'

Answer style: brief triage, detailed analysis (default), or deep dive on the deep-analysis model. Takes precedence over fast_mode.

provider'claude' | 'openai'

Selected model provider. Defaults to Claude for existing clients.

provider_recovery_attemptedboolean

Marks the one user-authorized retry on the alternate provider.

provider_recovery_turn_idstring

Assistant recovery-prompt turn replaced by the authorized retry.

project_idstring

Vault project ID for project-scoped context

project_idsstring[]

Vault project IDs for multi-project scoped context (maximum 10)

reference_doc_idsstring[]

Reference document IDs to inject into the search context

office_idinteger

Active CRM office ID

office_namestring

Active CRM office display name

office_contextstring

CRM office page sub-context

client_datestring

Browser-local date formatted YYYY-MM-DD

client_timezonestring

Browser IANA timezone

Example request

{
  "messages": [
    {
      "role": "user"
    }
  ],
  "conversation_surface": "smart_search",
  "answer_depth": "brief",
  "provider": "claude",
  "briefing_context": {
    "stream": "fed10",
    "regulation_scan_statuses": [
      "new"
    ]
  }
}

Response

Created

job_idstring required

Created job ID

conversation_idstring nullable

Conversation associated with the job; null for non-persisted runs

backend_git_shastring nullable

Backend revision serving the created job

Changes

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