Useful intelligence
needs a clear contract.
Explore a proposed data model and integration approach. All API examples are illustrative; no hosted endpoints or credentials are provisioned by this website.
Connect to a workflow.
Preserve the evidence.
Inputs
Agree supported sources, coordinate systems, timestamps, payload sizes, licensing, and quality requirements.
Processing
Track ingestion and analysis as explicit jobs, with validation failures visible to the caller.
Outputs
Return source-linked findings, uncertainty, review requirements, and traceable identifiers.
Actions
Route proposed tasks through an authenticated, authorized review boundary before any external execution.
An observation needs
more than a file name.
| Field | Meaning | Validation expectation |
|---|---|---|
observation_id | Stable source identifier. | Unique and traceable to the original input. |
asset_id | Known site or equipment reference. | Exists in the authorized asset scope. |
observed_at | When the measurement was acquired. | Explicit timezone; not confused with upload time. |
source | Sensor, provider, file, and permitted use. | Documented provenance and compatible rights. |
measurement | Bands, units, resolution, and processing level. | Suitable for the intended task. |
quality | Coverage, missing values, and relevant limitations. | Passes the task-specific intake gate. |
Proposed inputs may include GeoTIFF observations, CSV operational records, and GeoJSON boundaries. Actual format support would be agreed and tested during integration.
A request is a job.
A finding is a reviewable result.
# Illustrative only. This endpoint does not exist.
curl https://api.neuriya.example/v1/analysis-jobs \
-H "Authorization: Bearer $NEURIYA_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: inspection-example-001" \
-d '{
"asset_id": "SOL-04",
"observation_id": "synthetic-survey-2026-10-14",
"task": "inspection-priority",
"require_human_review": true
}' {
"status": "review_required",
"finding_id": "finding-example-004",
"observation_id": "synthetic-survey-2026-10-14",
"observed_signal": "localized thermal contrast",
"interpretation": "targeted inspection may be justified",
"alternative_explanations": [
"reflection",
"temporary shading"
],
"confidence": {
"kind": "illustrative_evidence_score",
"value": 83,
"calibrated_probability": false
},
"physical_verification": "pending"
}api.neuriya.example deliberately identifies non-production documentation. No SDK installation or production access is available here.Keep the handoff
explicit and recoverable.
Proposed event lifecycle
- observation.accepted — the intake contract passed.
- analysis.completed — results are ready for review.
- finding.reviewed — a qualified reviewer recorded a decision.
- inspection.created — an authorized task was created.
- outcome.recorded — field evidence was attached.
Expected delivery safeguards
A production integration should define signed events, timestamp checks, idempotency keys, retry backoff, deduplication, and a dead-letter process.
Events should carry identifiers and permitted context. Sensitive data and credentials should not be embedded in URLs or unneeded logs.
These are proposed integration requirements, not implemented services in this website.
Tell the caller
what needs to change.
| Example status | Meaning | Expected handling |
|---|---|---|
| 400 · Invalid input | The payload does not meet the agreed schema. | Return the invalid fields and a trace identifier. |
| 403 · Outside scope | The caller lacks permission for the asset or operation. | Stop processing; request an authorized scope. |
| 422 · Unsuitable observation | The data cannot support this analysis task. | Explain the quality or compatibility issue. |
| 429 · Usage limit | The agreed processing allowance has been reached. | Provide a documented retry or quota path. |
| 503 · Processing unavailable | A dependency or processing worker is unavailable. | Preserve job state and retry safely. |
Agree the contract
before connecting the systems.
- Choose one analysis task and one operational consumer.
- Confirm data rights, sensor suitability, and ground truth.
- Specify authentication, asset authorization, and retention.
- Agree delivery timing and failure behavior.
- Establish a human-review and escalation policy.
- Measure full workflow latency and cost.
Bring a sample schema.
Keep sensitive files private.
Use the inquiry composer to describe your sources and integration goals. Secure transfer and access boundaries belong in the pilot design.
Scope an integration