places

Start Places Search

post/api/places/search/start

Request

  • Base URL
    https://platform.verbiflow.com/api/bridge
  • URL
    https://platform.verbiflow.com/api/bridge/api/places/search/start
  • Auth
    • HTTP bearer and API key in header x-flage-org-id
    • or HTTP bearer and API key in header x-flage-org-slug

Request body

contract_version'places-search.v2' required
limitinteger

Maximum places returned across all queries.

locationstring nullable

Optional provider location hint; whitespace-only values are omitted.

queriesstring[] required

Provider-neutral place queries; values are stripped and empty values rejected.

Response

Successful Response

artifact_idstring required

Immutable result artifact identity.

execution_contract_digeststring required

Digest of the executable operation contract.

execution_idstring required

Customer-credit accounting execution identity.

failedboolean required

Whether the terminal state is failed.

finishedboolean required

Whether the job reached a terminal state.

generation_idstring required

Immutable durable generation identity.

job_idstring required

Durable job identity.

operation_keystring required

Stable logical operation identity.

phasestring required

Current producer phase.

progress_currentinteger required

Completed progress units.

progress_totalinteger required

Total admitted progress units.

request_digeststring required

Digest of the canonical public request.

result_kind'places_search' required
semantic_fingerprintstring required

Digest of request and runtime semantics.

source_digeststring nullable required

Managed source digest when supplied.

status'queued' | 'running' | 'blocked' | 'completed' | 'failed' required

Current durable job lifecycle state.

Changes

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