Skip to content
Quikstik Developers

Declare a departure point

POST
/conditions/points
curl --request POST \
  --url https://quikstik-core.fly.dev/conditions/points \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --data '{ "name": "example", "lat": 1, "lon": 1, "tz": "example" }'

Session, or an operator key scoped conditions.write held by an Admin/Owner. With an x-idempotency-key, a retry returns the point already made (200) instead of a 409. A departure is placed at the point whose name appears in the departure’s meeting-point name (case-insensitive; the longest matching name wins).

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
x-tenant-id
required
string format: uuid

Tenant identifier (UUID).

Authn/authz semantics are intentionally TBD for this contract slice; this header exists to keep the contract explicitly multi-tenant from day 0.

x-idempotency-key
string
>= 1 characters

When present, a retry returns the row already made under this key.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
name
required
string
>= 1 characters
lat
required
number
>= -90 <= 90
lon
required
number
>= -180 <= 180
tz
required
string

Example generated

{
  "name": "example",
  "lat": 1,
  "lon": 1,
  "tz": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

Idempotent replay — the point already made under this key.

Media typeapplication/json
object
id
required
string format: uuid
name
required
string
lat
required
number
>= -90 <= 90
lon
required
number
>= -180 <= 180
tz
required

IANA zone

string

Example 

{
  "tz": "America/New_York"
}

201

Section titled “201”

Created.

Media typeapplication/json
object
id
required
string format: uuid
name
required
string
lat
required
number
>= -90 <= 90
lon
required
number
>= -180 <= 180
tz
required

IANA zone

string

Example 

{
  "tz": "America/New_York"
}

401

Section titled “401”

Missing or invalid session bearer token

Media typeapplication/json
object
reason
required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example 

{
  "reason": "sold_out"
}

403

Section titled “403”

The session’s effect authority does not cover this operation

Media typeapplication/json
object
reason
required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example 

{
  "reason": "sold_out"
}

409

Section titled “409”

A point with this name already exists for the tenant (already_exists).

422

Section titled “422”

invalid_body, name_required, lat_out_of_range, lon_out_of_range or unknown_time_zone.

503

Section titled “503”

No durable backend is wired for this operation (fail-closed)

Media typeapplication/json
object
reason
required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example 

{
  "reason": "sold_out"
}