> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://akamai.ferndocs.com/demo-apis/api/data/arrays/put-arr/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://akamai.ferndocs.com/_mcp/server. # Test arrays PUT http://{hostname}/test-suite/v2/data/arr Content-Type: application/json This tests arrays. Reference: https://akamai.ferndocs.com/demo-apis/api/data/arrays/put-arr ## Request ### Query parameters - `param-mismatch` (integer, optional) — Raise an error because this description fails to detail each enum value. Values are `GROUCHO`, `CHICO`, and `HARPO`. Account for random other `LITERAL` value that may be in the description, which we may want to warn about separately. - `accountSwitchKey` (string, optional) — For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys). ### Body (application/json) This endpoint expects an object. - `arr-bool` (list of boolean, optional) — This is a bitmap, which is weird API design. - `arr-delim-inaccurate` (list of string, optional) — A list of comma-separated values. - `arr-desc-mismatch` (list of string, optional) — This is the outer description. - `arr-desc-misplaced` (list of string, optional) - `arr-desc-redundant` (list of string, optional) — This is the same description. - `arr-desc-verbose` (list of DataArrPutRequestBodyContentApplicationJsonSchemaArrDescVerboseItems, optional) — A list of comma-separated values. - `arr-enum-desc` (list of enum, optional) — Throw a warning if the component `items` is an enum. In that case, we don't want to log `str-enum-desc-unlisted` on the non-publishing description within the `items`. - Allowed values: `chico`, `groucho`, `harpo` - `arr-enum-desc-link` (list of enum, optional) — Don't throw the `str-enum-desc-unlisted` error because the link is included. See [Values link](https://techdocs.akamai.com/internal-ux-writing/reference/slug). - Allowed values: `chico`, `groucho`, `harpo` - `arr-max` (list of string, optional) — Array specifies `maxItems`. - `arr-min-items-high` (list of any, optional) — Array with `minItems > 1` should be flagged as a warning. - `arr-min-missing` (list of string, optional) — Array lacks `minItems`. - `arr-min-zero` (list of string, optional) — Array with `minItems:0` may be empty, noteworthy. - `arr-name-singular` (list of string, optional) — TBD not named plural. - `arr-poly` (DataArrPutRequestBodyContentApplicationJsonSchemaArrPoly, optional) — Arrays that may contain more than one type. Not bad, but complex for doc. - `arr-uniq-non` (list of string, optional) — Array specifies `uniqueItems: false`. - `threshold-max` (list of string, optional) — Array in sample data is too long. - `threshold-min` (list of string, optional) — Sample data is zero-length. ## Response ### 200 Successful response. - `arr-bool` (list of boolean, optional) — This is a bitmap, which is weird API design. - `arr-delim-inaccurate` (list of string, optional) — A list of comma-separated values. - `arr-desc-mismatch` (list of string, optional) — This is the outer description. - `arr-desc-misplaced` (list of string, optional) - `arr-desc-redundant` (list of string, optional) — This is the same description. - `arr-desc-verbose` (list of DataArrPutResponsesContentApplicationJsonSchemaArrDescVerboseItems, optional) — A list of comma-separated values. - `arr-enum-desc` (list of enum, optional) — Throw a warning if the component `items` is an enum. In that case, we don't want to log `str-enum-desc-unlisted` on the non-publishing description within the `items`. - Allowed values: `chico`, `groucho`, `harpo` - `arr-enum-desc-link` (list of enum, optional) — Don't throw the `str-enum-desc-unlisted` error because the link is included. See [Values link](https://techdocs.akamai.com/internal-ux-writing/reference/slug). - Allowed values: `chico`, `groucho`, `harpo` - `arr-max` (list of string, optional) — Array specifies `maxItems`. - `arr-min-items-high` (list of any, optional) — Array with `minItems > 1` should be flagged as a warning. - `arr-min-missing` (list of string, optional) — Array lacks `minItems`. - `arr-min-zero` (list of string, optional) — Array with `minItems:0` may be empty, noteworthy. - `arr-name-singular` (list of string, optional) — TBD not named plural. - `arr-poly` (DataArrPutResponsesContentApplicationJsonSchemaArrPoly, optional) — Arrays that may contain more than one type. Not bad, but complex for doc. - `arr-uniq-non` (list of string, optional) — Array specifies `uniqueItems: false`. - `threshold-max` (list of string, optional) — Array in sample data is too long. - `threshold-min` (list of string, optional) — Sample data is zero-length. ## Types ### DataArrPutRequestBodyContentApplicationJsonSchemaArrDescVerboseItems An object delimited by a comma. - `prop` (string, optional) ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPoly Arrays that may contain more than one type. Not bad, but complex for doc. - `objectAnyOf` (list of DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectAnyOfItems, optional) — Array that may contain strings or numbers. - `objectOneOf` (list of DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectOneOfItems, optional) — Array that may contain strings or numbers. - `scalarAnyOf` (list of DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyScalarAnyOfItems, optional) — Array that may contain strings or numbers. - `scalarOneOf` (list of DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyScalarOneOfItems, optional) — Array that may contain strings or numbers. ### DataArrPutResponsesContentApplicationJsonSchemaArrDescVerboseItems An object delimited by a comma. - `prop` (string, optional) ### DataArrPutResponsesContentApplicationJsonSchemaArrPoly Arrays that may contain more than one type. Not bad, but complex for doc. - `objectAnyOf` (list of DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectAnyOfItems, optional) — Array that may contain strings or numbers. - `objectOneOf` (list of DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectOneOfItems, optional) — Array that may contain strings or numbers. - `scalarAnyOf` (list of DataArrPutResponsesContentApplicationJsonSchemaArrPolyScalarAnyOfItems, optional) — Array that may contain strings or numbers. - `scalarOneOf` (list of DataArrPutResponsesContentApplicationJsonSchemaArrPolyScalarOneOfItems, optional) — Array that may contain strings or numbers. ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectAnyOfItems ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectOneOfItems ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyScalarAnyOfItems ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyScalarOneOfItems ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectAnyOfItems ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectOneOfItems ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyScalarAnyOfItems ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyScalarOneOfItems ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectAnyOfItems0 - `groucho` (string, required) — Groucho description. ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectAnyOfItems1 - `chico` (string, required) — Chico description. ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectAnyOfItems2 - `harpo` (string, required) — Harpo description. ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectOneOfItems0 Unconditional schema. - `groucho` (string, required) — Groucho description. ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectOneOfItems1 __Limited availability__ Conditional schema. - `chico` (string, required) — Chico description. ### DataArrPutRequestBodyContentApplicationJsonSchemaArrPolyObjectOneOfItems2 __Bot manager__ Conditional schema. - `harpo` (string, required) — Harpo description. ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectAnyOfItems0 - `groucho` (string, required) — Groucho description. ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectAnyOfItems1 - `chico` (string, required) — Chico description. ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectAnyOfItems2 - `harpo` (string, required) — Harpo description. ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectOneOfItems0 Unconditional schema. - `groucho` (string, required) — Groucho description. ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectOneOfItems1 __Limited availability__ Conditional schema. - `chico` (string, required) — Chico description. ### DataArrPutResponsesContentApplicationJsonSchemaArrPolyObjectOneOfItems2 __Bot manager__ Conditional schema. - `harpo` (string, required) — Harpo description. ## Examples **Request** ```json { "arr-bool": [], "arr-max": [ "GROUCHO", "CHICO", "HARPO" ], "arr-min-missing": [ "string" ], "arr-min-zero": [ "string" ], "arr-name-singular": [], "arr-uniq-non": [ "GROUCHO", "CHICO", "HARPO" ] } ``` **Response** ```json { "arr-bool": [], "arr-max": [ "GROUCHO", "CHICO", "HARPO" ], "arr-min-missing": [ "string" ], "arr-min-zero": [ "string" ], "arr-name-singular": [], "arr-poly": {}, "arr-uniq-non": [ "GROUCHO", "CHICO", "HARPO" ] } ``` **SDK Code** ```python import requests url = "http://{hostname}/test-suite/v2/data/arr" payload = { "arr-bool": [], "arr-max": ["GROUCHO", "CHICO", "HARPO"], "arr-min-missing": ["string"], "arr-min-zero": ["string"], "arr-name-singular": [], "arr-uniq-non": ["GROUCHO", "CHICO", "HARPO"] } headers = {"Content-Type": "application/json"} response = requests.put(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'http://{hostname}/test-suite/v2/data/arr'; const options = { method: 'PUT', headers: {'Content-Type': 'application/json'}, body: '{"arr-bool":[],"arr-max":["GROUCHO","CHICO","HARPO"],"arr-min-missing":["string"],"arr-min-zero":["string"],"arr-name-singular":[],"arr-uniq-non":["GROUCHO","CHICO","HARPO"]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "http://{hostname}/test-suite/v2/data/arr" payload := strings.NewReader("{\n \"arr-bool\": [],\n \"arr-max\": [\n \"GROUCHO\",\n \"CHICO\",\n \"HARPO\"\n ],\n \"arr-min-missing\": [\n \"string\"\n ],\n \"arr-min-zero\": [\n \"string\"\n ],\n \"arr-name-singular\": [],\n \"arr-uniq-non\": [\n \"GROUCHO\",\n \"CHICO\",\n \"HARPO\"\n ]\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("http://{hostname}/test-suite/v2/data/arr") http = Net::HTTP.new(url.host, url.port) request = Net::HTTP::Put.new(url) request["Content-Type"] = 'application/json' request.body = "{\n \"arr-bool\": [],\n \"arr-max\": [\n \"GROUCHO\",\n \"CHICO\",\n \"HARPO\"\n ],\n \"arr-min-missing\": [\n \"string\"\n ],\n \"arr-min-zero\": [\n \"string\"\n ],\n \"arr-name-singular\": [],\n \"arr-uniq-non\": [\n \"GROUCHO\",\n \"CHICO\",\n \"HARPO\"\n ]\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("http://{hostname}/test-suite/v2/data/arr") .header("Content-Type", "application/json") .body("{\n \"arr-bool\": [],\n \"arr-max\": [\n \"GROUCHO\",\n \"CHICO\",\n \"HARPO\"\n ],\n \"arr-min-missing\": [\n \"string\"\n ],\n \"arr-min-zero\": [\n \"string\"\n ],\n \"arr-name-singular\": [],\n \"arr-uniq-non\": [\n \"GROUCHO\",\n \"CHICO\",\n \"HARPO\"\n ]\n}") .asString(); ``` ```php request('PUT', 'http://{hostname}/test-suite/v2/data/arr', [ 'body' => '{ "arr-bool": [], "arr-max": [ "GROUCHO", "CHICO", "HARPO" ], "arr-min-missing": [ "string" ], "arr-min-zero": [ "string" ], "arr-name-singular": [], "arr-uniq-non": [ "GROUCHO", "CHICO", "HARPO" ] }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("http://{hostname}/test-suite/v2/data/arr"); var request = new RestRequest(Method.PUT); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"arr-bool\": [],\n \"arr-max\": [\n \"GROUCHO\",\n \"CHICO\",\n \"HARPO\"\n ],\n \"arr-min-missing\": [\n \"string\"\n ],\n \"arr-min-zero\": [\n \"string\"\n ],\n \"arr-name-singular\": [],\n \"arr-uniq-non\": [\n \"GROUCHO\",\n \"CHICO\",\n \"HARPO\"\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = [ "arr-bool": [], "arr-max": ["GROUCHO", "CHICO", "HARPO"], "arr-min-missing": ["string"], "arr-min-zero": ["string"], "arr-name-singular": [], "arr-uniq-non": ["GROUCHO", "CHICO", "HARPO"] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "http://{hostname}/test-suite/v2/data/arr")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```