Skip to content

Menu

API reference · Origins and routes

Which origin each hostname of the zone goes to

GET/v1/orgs/{org}/zones/{zone}/routes

Permission: origins.origins.read
Operation: origins.routes.list

Parameters

Name	In	Type	Required	Notes
`org`	path	string	yes	for example `"org_01h455vb4pex5vsknk084sn02q"`
`zone`	path	string	yes	for example `"zone_01h455vb4pex5vsknk084sn02q"`
`x-obhut-management-assignment`	header	string	no	Select one staff assignment. Direct membership remains the default. Bound API tokens use their stored source and ignore this selector. For example `"masg_01h455vb4pex5vsknk084sn02q"`

Response 200

Field	Type	Required	Notes
`items`	array of object	yes
`items[].hostnameId`	string	yes	for example `"hostname_01h455vb4pex5vsknk084sn02q"`
`items[].zoneId`	string	yes	for example `"zone_01h455vb4pex5vsknk084sn02q"`
`items[].originId`	string	yes	for example `"origin_01h455vb4pex5vsknk084sn02q"`
`items[].revision`	string	yes	Opaque revision: dot-joined counters.
`items[].createdAt`	string (date-time)	yes	UTC, ISO 8601.
`items[].updatedAt`	string (date-time)	yes	UTC, ISO 8601.

Request shaped from the schemas

curl

curl 'https://api.obhut.io/v1/orgs/org_01h455vb4pex5vsknk084sn02q/zones/zone_01h455vb4pex5vsknk084sn02q/routes' \
  -H "Authorization: Bearer $OBHUT_TOKEN"

Response 200

{
  "items": [
    {
      "hostnameId": "hostname_01h455vb4pex5vsknk084sn02q",
      "zoneId": "zone_01h455vb4pex5vsknk084sn02q",
      "originId": "origin_01h455vb4pex5vsknk084sn02q",
      "revision": "string",
      "createdAt": "2026-01-01T12:00:00.000Z",
      "updatedAt": "2026-01-01T12:00:00.000Z"
    }
  ]
}