---
title: Unblock Reserve Slots
slug: fourkites-api-reference/unblock-reserve-slots
icon: {"apiMethod":"PUT"}
createdAt: 2024-08-28T14:47:01.000Z
---
Use this API to unblock the reserved slots in Appointment Manager.
For more Error Responses, [click here](https://docs.fourkites.com/api-reference/unblock-reserve-slots#TQmEN).
:::hint{type="info"}
### Rate Limit
**60 requests per minute**
:::
:::hint{type="info"}
### Format Supported
**JSON**
:::
:::hint{type="info"}
### Authenticated Resource
**API Key**
:::
For more information on Authentication, [click here](https://docs.fourkites.com/api-reference/authentication).
:::hint{type="success"}
To reserve a slot or to generate `reserveSlotId`, [click here](https://docs.fourkites.com/api-reference/reserve-slots).
:::
:::ApiMethodV2
```json
{
"name": "Production",
"method": "PUT",
"url": "https://api.fourkites.com/api/v1/unblock_reserve_slot",
"description": "",
"tab": "examples",
"examples": {
"languages": [
{
"id": "An044DS1JD1OqDotv9nuL",
"language": "curl",
"code": "curl --location --request PUT 'https://api.fourkites.com/api/v1/unblock_reserve_slot' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"reserveSlotId\": 1539865\n}'",
"customLabel": ""
},
{
"id": "60NfsUHcOomVPjiKTXAyQ",
"language": "java",
"code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"reserveSlotId\\\": 1539865\\n}\");\nRequest request = new Request.Builder()\n .url(\"https://api.fourkites.com/api/v1/unblock_reserve_slot\")\n .method(\"PUT\", body)\n .addHeader(\"Content-Type\", \"application/json\")\n .addHeader(\"apikey\", \"REPLACE_KEY_VALUE\")\n .build();\nResponse response = client.newCall(request).execute();",
"customLabel": ""
},
{
"id": "W_JKrznKtXrBm4zyR1h23",
"language": "javascript",
"code": "var settings = {\n \"url\": \"https://api.fourkites.com/api/v1/unblock_reserve_slot\",\n \"method\": \"PUT\",\n \"timeout\": 0,\n \"headers\": {\n \"Content-Type\": \"application/json\",\n \"apikey\": \"REPLACE_KEY_VALUE\"\n },\n \"data\": JSON.stringify({\n \"reserveSlotId\": 1539865\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});",
"customLabel": ""
},
{
"id": "OdyAs2AJfzJkEdInjYCof",
"language": "swift",
"code": "import Foundation\n#if canImport(FoundationNetworking)\nimport FoundationNetworking\n#endif\n\nvar semaphore = DispatchSemaphore (value: 0)\n\nlet parameters = \"{\\n \\\"reserveSlotId\\\": 1539865\\n}\"\nlet postData = parameters.data(using: .utf8)\n\nvar request = URLRequest(url: URL(string: \"https://api.fourkites.com/api/v1/unblock_reserve_slot\")!,timeoutInterval: Double.infinity)\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"Content-Type\")\nrequest.addValue(\"REPLACE_KEY_VALUE\", forHTTPHeaderField: \"apikey\")\n\nrequest.httpMethod = \"PUT\"\nrequest.httpBody = postData\n\nlet task = URLSession.shared.dataTask(with: request) { data, response, error in \n guard let data = data else {\n print(String(describing: error))\n semaphore.signal()\n return\n }\n print(String(data: data, encoding: .utf8)!)\n semaphore.signal()\n}\n\ntask.resume()\nsemaphore.wait()\n",
"customLabel": ""
},
{
"id": "HCrwR1Wr6maNA-UUDpPUP",
"language": "go",
"code": "package main\n\nimport (\n \"fmt\"\n \"strings\"\n \"net/http\"\n \"io/ioutil\"\n)\n\nfunc main() {\n\n url := \"https://api.fourkites.com/api/v1/unblock_reserve_slot\"\n method := \"PUT\"\n\n payload := strings.NewReader(`{\n \"reserveSlotId\": 1539865\n}`)\n\n client := &http.Client {\n }\n req, err := http.NewRequest(method, url, payload)\n\n if err != nil {\n fmt.Println(err)\n return\n }\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"apikey\", \"REPLACE_KEY_VALUE\")\n\n res, err := client.Do(req)\n if err != nil {\n fmt.Println(err)\n return\n }\n defer res.Body.Close()\n\n body, err := ioutil.ReadAll(res.Body)\n if err != nil {\n fmt.Println(err)\n return\n }\n fmt.Println(string(body))\n}",
"customLabel": ""
},
{
"id": "DEDL8BfQ_ZD-tXDQ0RGgU",
"language": "csharp",
"code": "var client = new RestClient(\"https://api.fourkites.com/api/v1/unblock_reserve_slot\");\nclient.Timeout = -1;\nvar request = new RestRequest(Method.PUT);\nrequest.AddHeader(\"Content-Type\", \"application/json\");\nrequest.AddHeader(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar body = @\"{\" + \"\\n\" +\n@\" \"\"reserveSlotId\"\": 1539865\" + \"\\n\" +\n@\"}\";\nrequest.AddParameter(\"application/json\", body, ParameterType.RequestBody);\nIRestResponse response = client.Execute(request);\nConsole.WriteLine(response.Content);",
"customLabel": ""
},
{
"id": "WrcrmkhgVZ2mmmO-Hp8IN",
"language": "ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.fourkites.com/api/v1/unblock_reserve_slot\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Put.new(url)\nrequest[\"Content-Type\"] = \"application/json\"\nrequest[\"apikey\"] = \"REPLACE_KEY_VALUE\"\nrequest.body = JSON.dump({\n \"reserveSlotId\": 1539865\n})\n\nresponse = https.request(request)\nputs response.read_body\n",
"customLabel": ""
},
{
"id": "EgaBwTqxoN4OBm2K4iqOz",
"language": "python",
"code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.fourkites.com\")\npayload = json.dumps({\n \"reserveSlotId\": 1539865\n})\nheaders = {\n 'Content-Type': 'application/json',\n 'apikey': 'REPLACE_KEY_VALUE'\n}\nconn.request(\"PUT\", \"/api/v1/unblock_reserve_slot\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))",
"customLabel": ""
}
],
"selectedLanguageId": "An044DS1JD1OqDotv9nuL"
},
"results": {
"languages": [
{
"id": "fv3TrzBYP1o7ab955tGW-",
"language": "200",
"customLabel": "",
"code": "{\n \"code\":200,\n \"message\":\"Unblocked Reserve slot successfully\",\n \"request_id\":\"cr24nh7r816353h819l0\"\n}"
},
{
"id": "MACiugBZi2XXwx9Kei3cT",
"language": "400",
"customLabel": "",
"code": "{\n \"code\":400,\n \"error\":{\n \"message\":\"Invalid Request Params\",\n \"code\":400,\n \"errors\":[\n {\n \"domain\":\"oas\",\n \"reason\":\"Reserved Slot Appointment not found\",\n \"message\":\"Invalid Request Params\"\n }\n ]\n },\n \"request_id\":\"cr24nj7r816353h819lg\"\n} "
}
],
"selectedLanguageId": "fv3TrzBYP1o7ab955tGW-"
},
"request": {
"pathParameters": [],
"queryParameters": [],
"headerParameters": [],
"bodyDataParameters": [
{
"name": "reserveSlotId",
"kind": "required",
"type": "string",
"description": "The ID that can be generated by passing the Reserve Slot API."
}
],
"formDataParameters": []
},
"currentNewParameter": {
"label": "Body Parameter",
"value": "bodyDataParameters"
},
"autoGeneratedAnchorSlug": "production",
"legacyHash": "Mbe7pTyDUEnjOcS4m-z3G"
}
```
:::
:::ApiMethodV2
```json
{
"name": "Staging",
"method": "PUT",
"url": "https://api.fourkites.com/api/v1/unblock_reserve_slot",
"description": "",
"tab": "examples",
"examples": {
"languages": [
{
"id": "An044DS1JD1OqDotv9nuL",
"language": "curl",
"code": "curl --location --request PUT 'https://api-staging.fourkites.com/api/v1/unblock_reserve_slot' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"reserveSlotId\": 1539865\n}'",
"customLabel": ""
},
{
"id": "60NfsUHcOomVPjiKTXAyQ",
"language": "java",
"code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"reserveSlotId\\\": 1539865\\n}\");\nRequest request = new Request.Builder()\n .url(\"https://api-staging.fourkites.com/api/v1/unblock_reserve_slot\")\n .method(\"PUT\", body)\n .addHeader(\"Content-Type\", \"application/json\")\n .addHeader(\"apikey\", \"REPLACE_KEY_VALUE\")\n .build();\nResponse response = client.newCall(request).execute();",
"customLabel": ""
},
{
"id": "W_JKrznKtXrBm4zyR1h23",
"language": "javascript",
"code": "var settings = {\n \"url\": \"https://api-staging.fourkites.com/api/v1/unblock_reserve_slot\",\n \"method\": \"PUT\",\n \"timeout\": 0,\n \"headers\": {\n \"Content-Type\": \"application/json\",\n \"apikey\": \"REPLACE_KEY_VALUE\"\n },\n \"data\": JSON.stringify({\n \"reserveSlotId\": 1539865\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});",
"customLabel": ""
},
{
"id": "OdyAs2AJfzJkEdInjYCof",
"language": "swift",
"code": "import Foundation\n#if canImport(FoundationNetworking)\nimport FoundationNetworking\n#endif\n\nvar semaphore = DispatchSemaphore (value: 0)\n\nlet parameters = \"{\\n \\\"reserveSlotId\\\": 1539865\\n}\"\nlet postData = parameters.data(using: .utf8)\n\nvar request = URLRequest(url: URL(string: \"https://api-staging.fourkites.com/api/v1/unblock_reserve_slot\")!,timeoutInterval: Double.infinity)\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"Content-Type\")\nrequest.addValue(\"REPLACE_KEY_VALUE\", forHTTPHeaderField: \"apikey\")\n\nrequest.httpMethod = \"PUT\"\nrequest.httpBody = postData\n\nlet task = URLSession.shared.dataTask(with: request) { data, response, error in \n guard let data = data else {\n print(String(describing: error))\n semaphore.signal()\n return\n }\n print(String(data: data, encoding: .utf8)!)\n semaphore.signal()\n}\n\ntask.resume()\nsemaphore.wait()\n",
"customLabel": ""
},
{
"id": "HCrwR1Wr6maNA-UUDpPUP",
"language": "go",
"code": "package main\n\nimport (\n \"fmt\"\n \"strings\"\n \"net/http\"\n \"io/ioutil\"\n)\n\nfunc main() {\n\n url := \"https://api-staging.fourkites.com/api/v1/unblock_reserve_slot\"\n method := \"PUT\"\n\n payload := strings.NewReader(`{\n \"reserveSlotId\": 1539865\n}`)\n\n client := &http.Client {\n }\n req, err := http.NewRequest(method, url, payload)\n\n if err != nil {\n fmt.Println(err)\n return\n }\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"apikey\", \"REPLACE_KEY_VALUE\")\n\n res, err := client.Do(req)\n if err != nil {\n fmt.Println(err)\n return\n }\n defer res.Body.Close()\n\n body, err := ioutil.ReadAll(res.Body)\n if err != nil {\n fmt.Println(err)\n return\n }\n fmt.Println(string(body))\n}",
"customLabel": ""
},
{
"id": "DEDL8BfQ_ZD-tXDQ0RGgU",
"language": "csharp",
"code": "var client = new RestClient(\"https://api-staging.fourkites.com/api/v1/unblock_reserve_slot\");\nclient.Timeout = -1;\nvar request = new RestRequest(Method.PUT);\nrequest.AddHeader(\"Content-Type\", \"application/json\");\nrequest.AddHeader(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar body = @\"{\" + \"\\n\" +\n@\" \"\"reserveSlotId\"\": 1539865\" + \"\\n\" +\n@\"}\";\nrequest.AddParameter(\"application/json\", body, ParameterType.RequestBody);\nIRestResponse response = client.Execute(request);\nConsole.WriteLine(response.Content);",
"customLabel": ""
},
{
"id": "WrcrmkhgVZ2mmmO-Hp8IN",
"language": "ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api-staging.fourkites.com/api/v1/unblock_reserve_slot\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Put.new(url)\nrequest[\"Content-Type\"] = \"application/json\"\nrequest[\"apikey\"] = \"REPLACE_KEY_VALUE\"\nrequest.body = JSON.dump({\n \"reserveSlotId\": 1539865\n})\n\nresponse = https.request(request)\nputs response.read_body\n",
"customLabel": ""
},
{
"id": "EgaBwTqxoN4OBm2K4iqOz",
"language": "python",
"code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api-staging.fourkites.com\")\npayload = json.dumps({\n \"reserveSlotId\": 1539865\n})\nheaders = {\n 'Content-Type': 'application/json',\n 'apikey': 'REPLACE_KEY_VALUE'\n}\nconn.request(\"PUT\", \"/api/v1/unblock_reserve_slot\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))",
"customLabel": ""
}
],
"selectedLanguageId": "An044DS1JD1OqDotv9nuL"
},
"results": {
"languages": [
{
"id": "fv3TrzBYP1o7ab955tGW-",
"language": "200",
"customLabel": "",
"code": "{\n \"code\":200,\n \"message\":\"Unblocked Reserve slot successfully\",\n \"request_id\":\"cr24nh7r816353h819l0\"\n}"
},
{
"id": "MACiugBZi2XXwx9Kei3cT",
"language": "400",
"customLabel": "",
"code": "{\n \"code\":400,\n \"error\":{\n \"message\":\"Invalid Request Params\",\n \"code\":400,\n \"errors\":[\n {\n \"domain\":\"oas\",\n \"reason\":\"Reserved Slot Appointment not found\",\n \"message\":\"Invalid Request Params\"\n }\n ]\n },\n \"request_id\":\"cr24nj7r816353h819lg\"\n} "
}
],
"selectedLanguageId": "fv3TrzBYP1o7ab955tGW-"
},
"request": {
"pathParameters": [],
"queryParameters": [],
"headerParameters": [],
"bodyDataParameters": [
{
"name": "reserveSlotId",
"kind": "required",
"type": "string",
"description": "The ID that can be generated by passing the Reserve Slot API."
}
],
"formDataParameters": []
},
"currentNewParameter": {
"label": "Body Parameter",
"value": "bodyDataParameters"
},
"autoGeneratedAnchorSlug": "staging",
"legacyHash": "Va7zRfmLbPgdOrRLRau3G"
}
```
:::
### Error Responses
| **Action** | **Response Message** |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Invalid Auth** | \{"message": "Invalid authentication credentials"} |
| **Appointment already booked on reserve slot** | \{
"code":400,
"error":\{
"message":"Invalid Request Params",
"code":400,
"errors":\[
\{
"domain":"oas",
"reason":"Already an appointment is booked in the reserved slot",
"message":"Invalid Request Params"
}
]
},
"request\_id":"cr24o6nr816353h819rg"
} |
| **Recurring Reserved Slot Id is passed** | \{
"code":400,
"error":\{
"message":"Invalid Request Params",
"code":400,
"errors":\[
\{
"domain":"oas",
"reason":"Recurring Reserved Slot Appointment cannot be unblocked",
"message":"Invalid Request Params"
}
]
},
"request\_id":"cr24qivr816353h81ag0"
} |