Create a track

1min
POST
http://{base_url}/core/api/v1/mts/smart-phone/tracks
This API can return both 201/202 response based on defaultStart value, if true then 202 response will be returned, else 201 response will be returned. Only in case of 202 response, callback will be sent
Header Parameters
X-COREOS-REQUEST-ID
string
*
X-COREOS-TID
string
*
X-COREOS-ACCESS
string
*
X-COREOS-USERINFO
string
X-COREOS-APP-ID
string
*
Body Parameters
body
SmartPhoneCreateTrackRequestBody
Description
Create a track request body
contextId
string
*
externalRefId
string
defaultStart
boolean
expiry
string
callback
Callback3P
Responses
201
Successful operation
CreateTrackSuccessResponse
error
object
data
object
202
Successful operation
CreateTrackSuccessResponse
error
object
data
object
400
Bad request - The server is unable to process the request due to something that is perceived to be a client error.
Error3PResponse
error
Error3P
*
401
Unauthorized -  The client's identity is unknown to the server. Verify that you are accessing the correct tenant and that your client ID and client secret are valid on that Tenant.
Error3PResponse
error
Error3P
*
404
Not found - The server can not find the requested resource.
Error3PResponse
error
Error3P
*
503
Server error - The server is not ready to handle the request. This could be due to maintenance downtime or system resource constraints.
Error3PResponse
error
Error3P
*
Curl
JS
Ruby
Python
curl --location --globoff 'http://{base_url}/core/api/v1/mts/smart-phone/tracks' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "contextId": "",
  "callback": {
    "url": ""
  }
}'
curl --location --globoff 'http://{base_url}/core/api/v1/mts/smart-phone/tracks' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "contextId": "",
  "callback": {
    "url": ""
  }
}'
Responses
201
202
400
401
404
503
// Successful operation 
{
  "error": {},
  "data": {
    "trackId": "mts:track:497cff90-a8b4-e4cc-0083-b2b16071ba1a",
    "trackName": ""
  }
}
// Successful operation 
{
  "error": {},
  "data": {
    "trackId": "mts:track:497cff90-a8b4-e4cc-0083-b2b16071ba1a",
    "trackName": ""
  }
}
﻿
﻿
Updated 20 Sep 2024
Did this page help you?
Update Track API by trackName
Fetch tracking status API by contextId