Developer API Reference

Update Record API

Update your record info.

Root

https://api.ttskit.com/v1

Route

/record

Request Type

PUT

Request Headers

Below are the list of Accepted Request Headers if you are trying to Update Project Info.

Request Header	Value	Required
X-Master-Key	<API_KEY>	Yes

X-Master-Key Required

You will need this Key to access mostly any API end-point on TTSKit. You could find the key on the API Key page.

Query String Parameters

Query String Parameter	Value	Required
recordId	<Record Id>	Yes
name	<Project Name>	Yes

recordId Required

recordId is required to your Record Id.

name Required

Name is a required parameter which sets the Record Name. You cannot set a name more than 200 characters.

Code Samples

cURL
Java
JavaScript (ES6)
Python 3
Ruby

curl -v\
    -H 'X-Master-key: <YOUR_API_KEY>' \
    -d '{"recordId": <RECORD_ID>, "name": "<RECORD_NAME>"}' \
    --request PUT \
    https://api.ttskit.com/v1/record

    HttpPut put = new HttpPut("https://api.ttskit.com/v1/record");

    List<NameValuePair> urlParameters = new ArrayList<>();
    urlParameters.add(new BasicNameValuePair("recordId", "<RECORD_ID>"));
    urlParameters.add(new BasicNameValuePair("name", "<RECORD_NAME>"));

    put.addHeader("X-Master-Key", "<YOUR_API_KEY>");
    put.setEntity(new UrlEncodedFormEntity(urlParameters));

    try (CloseableHttpClient httpClient = HttpClients.createDefault();
            CloseableHttpResponse response = httpClient.execute(put)) {

        System.out.println(EntityUtils.toString(response.getEntity()));
    }

let req = new XMLHttpRequest();

req.onreadystatechange = () => {
    if (req.readyState == XMLHttpRequest.DONE) {
        console.log(req.responseText);
    }
};

req.open("PUT", "https://api.ttskit.com/v1/record", true);
req.setRequestHeader("X-Master-Key", "<YOUR_API_KEY>");
req.send(JSON.stringify({"recordId": <RECORD_ID>, "name": "<RECORD_NAME>"}));

import requests
url = 'https://api.ttskit.com/v1/record'
headers = {
    'X-Master-Key': '<YOUR_API_KEY>'
}
data = {
    'recordId': <RECORD_ID>,
    'name': '<RECORD_NAME>'
}

req = requests.put(url, json=data, headers=headers)
print(req.text)

require 'net/http'
require 'json'

uri = URI("https://api.ttskit.com/v1/record")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
req = Net::HTTP::Put.new(uri)
req['X-Master-Key'] = '<YOUR_API_KEY>'
req.body = {recordId: <RECORD_ID>, name: '<RECORD_NAME>'}.to_json


http.request(req)
end

puts res.body

Request Response

Success Status Code: 200

{
    "code": 200,
    "message": "Success.",
    "status": "success",
    "project": {
        "id": 99,
        "name": "Project Name",
        "desc": "Project Description"
        ...
    }
}

Error Status Code: 400, 401, 402, 403

{
    "code": 400,
    "message": "<Error Message>",
    "subMessage": "<Error Message Detail>",
    "status": "error"
}

For more information on the error codes & errors you might possibly encounter, refer to the below section.

Error Reference

400 Bad Request
401 UnAuthorized
402 Payment Required
404 Not Found

Invalid Route

To solve this issue, simply provide the correct Route.

Ensure your data complies with data constraints

You can refer to "subMessage" for more details.

You need to pass X-Master-Key in the header

You'll encounter this error if you are not passing the X-Master-Key header which is required to authenticate your request. In-order to fix this, pass the X-Master-Key header with a value of the API Key which you can find on the API Keys page.

The Id does not belong to your account

X-Master-Key passed does not have permission to read the project.

Currently, The API is only supported for premium users. Upgrade to Premium plan https://ttskit.com/pricing to use these features

You need to upgrade your account to the Premium Plan to use these features.

Rcord not found.

Check if the Id is valid and belongs to your account.

DEVELOPERS API REFERENCE (v1.0)