Machine-facing endpoint reference

Contracts for submitting payloads, polling jobs, and receiving delivery state.

Vectorlane exposes a narrow HTTP surface for batch submissions, signed webhook delivery, and status retrieval. The reference below covers the public contract used by partner services and internal automation clients.

POST
/v2/jobs

Create a new ingestion job with a signed payload reference and metadata envelope.

{
  "profile": "delivery-batch",
  "region": "eu-central",
  "payload_ref": "rv://bucket/job-2024-09",
  "callback_url": "https://client.example/webhooks/vectorlane"
}
GET
/v2/jobs/{id}

Fetch processing state, validation notes, and completion timestamps.

  • States: queued, validating, processing, delivered, failed
  • Responses are JSON and cache-disabled
  • Polling interval recommendation: 20-60 seconds
POST
/v2/webhooks/test

Validate signature verification and endpoint reachability before production use.

  • Uses the same HMAC envelope as live callbacks
  • Returns a verification event id for audit logging
  • Available to named technical contacts only

Status codes

Most integrations only need four outcomes.

200Request accepted or resource fetched successfully.
202Job accepted for asynchronous validation and processing.
401Credential pair missing, revoked, or outside the assigned scope.
422Envelope shape is valid but payload metadata is incomplete.