Search documentation
karat

+

K

User Documentation ↗

Link tracks

POST/api/gotham/v1/tracks/linkTracks
Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Links a Geotime Track with another Track, by ensuring that the Tracks have "pointers" to each other.

Query parameters

preview
boolean
optional

Represents a boolean value that restricts an endpoint to preview mode when set to true.

Request body

LinkTracksRequest
object

A request to link a Geotime Track to another Track

Hide child attributes

Hide child attributes

trackRid
string

Globally unique identifier for a Geotime Track. This is synonymous with a Gotham Identifier and contains information like SourceSystemId, CollectionId, SpecId and TrackId.

otherTrackRid
string

Globally unique identifier for a Geotime Track. This is synonymous with a Gotham Identifier and contains information like SourceSystemId, CollectionId, SpecId and TrackId.

Response body

EmptySuccessResponse
object

A successful response means that the Tracks have been linked.

Examples

Request

Copied!
1 2 3 4 5 curl -X POST \ -H "Content-type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/gotham/v1/tracks/linkTracks?preview=true" \ -d '[{"trackRid":"ri.gotham.1-1.geotime-track.foo.bar.baz.track0","otherTrackRid":"ri.gotham.1-1.geotime-track.foo.bar.baz.track1"}]'