---
title: "Create a synchronous discovery read receipt"
method: POST
path: "/queries"
tags: ["Search"]
---

# Create a synchronous discovery read receipt

`POST /queries`

## Request

- Base URL: `https://zephior.com/api/v1`
- URL: `https://zephior.com/api/v1/queries`
- Auth: none required

Returns a signed, deterministic synchronous public read receipt with a Location header. No background job or stored query is created. Existing Idempotency-Key headers remain accepted; resolving the receipt reads current published resources across replicas and restarts.

## Headers

- `Idempotency-Key` string, required

## Request body

- QueryJobRequest
  - `query` string, required
  - `locale` 'en' | 'de' | 'fr'

## Response `202`

Query accepted and available at the Location URI

- DiscoveryJob
  - `id` string, uuid, required
  - `status` 'completed', required
  - `createdAt` string, date-time, required
  - `completedAt` string, date-time, required
  - `query` string, required
  - `locale` 'en' | 'de' | 'fr', required
  - `result` SearchResult[], required
    - `id` string, required
    - `title` string, required
    - `summary` string, required
    - `primaryKeyword` string, required
    - `searchIntent` string, required: The user task or decision this resource is designed to answer.
    - `collection` 'insights' | 'solutions' | 'industries' | 'compare' | 'glossary', required
    - `service` 'ziva' | 'zelius' | 'ai-engineering' | 'workflow-automation', required
    - `author` string, required
    - `locale` 'en' | 'de' | 'fr', required
    - `published` string, date, required
    - `modified` string, date, required
    - `url` string, uri, required
    - `relevance` integer, required
  - `location` string, uri

## Other responses

- `400`: Invalid request or query parameter.
- `429`: Public API rate limit exceeded.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/zephior/apis/zephior-public-discovery-api.md) · [All operations](https://skmtc.dev/zephior/apis/zephior-public-discovery-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zephior/apis/zephior-public-discovery-api/revisions/3d7585b2bd5a?raw)