Create an index - AIMP Documentation

cURL

curl --request POST \
  --url https://{baseUrl}/{version}/projects/{projectId}/indexes \
  --header 'content-type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "indexName": "<string>",
  "mappings": {},
  "indexClass": "STANDARD",
  "sourceProjectId": "<string>",
  "sourceIndexName": "<string>",
  "sourceProjectApiKey": "<string>"
}
'

import requests

url = "https://{baseUrl}/{version}/projects/{projectId}/indexes"

payload = {
    "indexName": "<string>",
    "mappings": {},
    "indexClass": "STANDARD",
    "sourceProjectId": "<string>",
    "sourceIndexName": "<string>",
    "sourceProjectApiKey": "<string>"
}
headers = {
    "content-type": "<content-type>",
    "x-api-key": "<x-api-key>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'content-type': '<content-type>', 'x-api-key': '<x-api-key>'},
  body: JSON.stringify({
    indexName: '<string>',
    mappings: {},
    indexClass: 'STANDARD',
    sourceProjectId: '<string>',
    sourceIndexName: '<string>',
    sourceProjectApiKey: '<string>'
  })
};

fetch('https://{baseUrl}/{version}/projects/{projectId}/indexes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{baseUrl}/{version}/projects/{projectId}/indexes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'indexName' => '<string>',
    'mappings' => [
        
    ],
    'indexClass' => 'STANDARD',
    'sourceProjectId' => '<string>',
    'sourceIndexName' => '<string>',
    'sourceProjectApiKey' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "content-type: <content-type>",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{baseUrl}/{version}/projects/{projectId}/indexes"

	payload := strings.NewReader("{\n  \"indexName\": \"<string>\",\n  \"mappings\": {},\n  \"indexClass\": \"STANDARD\",\n  \"sourceProjectId\": \"<string>\",\n  \"sourceIndexName\": \"<string>\",\n  \"sourceProjectApiKey\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("content-type", "<content-type>")
	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{baseUrl}/{version}/projects/{projectId}/indexes")
  .header("content-type", "<content-type>")
  .header("x-api-key", "<x-api-key>")
  .body("{\n  \"indexName\": \"<string>\",\n  \"mappings\": {},\n  \"indexClass\": \"STANDARD\",\n  \"sourceProjectId\": \"<string>\",\n  \"sourceIndexName\": \"<string>\",\n  \"sourceProjectApiKey\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{baseUrl}/{version}/projects/{projectId}/indexes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["content-type"] = '<content-type>'
request["x-api-key"] = '<x-api-key>'
request.body = "{\n  \"indexName\": \"<string>\",\n  \"mappings\": {},\n  \"indexClass\": \"STANDARD\",\n  \"sourceProjectId\": \"<string>\",\n  \"sourceIndexName\": \"<string>\",\n  \"sourceProjectApiKey\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "projectId": "<string>",
  "indexName": "<string>",
  "mappings": {},
  "numDocs": 123,
  "cloneSourceInfo": {
    "sourceProjectId": "<string>",
    "sourceIndexName": "<string>",
    "sourceIndexVersionId": "<string>"
  },
  "indexStatus": "CREATING",
  "indexClass": "STANDARD"
}

POST

/

projects

/

{projectId}

/

indexes

cURL

curl --request POST \
  --url https://{baseUrl}/{version}/projects/{projectId}/indexes \
  --header 'content-type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "indexName": "<string>",
  "mappings": {},
  "indexClass": "STANDARD",
  "sourceProjectId": "<string>",
  "sourceIndexName": "<string>",
  "sourceProjectApiKey": "<string>"
}
'

import requests

url = "https://{baseUrl}/{version}/projects/{projectId}/indexes"

payload = {
    "indexName": "<string>",
    "mappings": {},
    "indexClass": "STANDARD",
    "sourceProjectId": "<string>",
    "sourceIndexName": "<string>",
    "sourceProjectApiKey": "<string>"
}
headers = {
    "content-type": "<content-type>",
    "x-api-key": "<x-api-key>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'content-type': '<content-type>', 'x-api-key': '<x-api-key>'},
  body: JSON.stringify({
    indexName: '<string>',
    mappings: {},
    indexClass: 'STANDARD',
    sourceProjectId: '<string>',
    sourceIndexName: '<string>',
    sourceProjectApiKey: '<string>'
  })
};

fetch('https://{baseUrl}/{version}/projects/{projectId}/indexes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{baseUrl}/{version}/projects/{projectId}/indexes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'indexName' => '<string>',
    'mappings' => [
        
    ],
    'indexClass' => 'STANDARD',
    'sourceProjectId' => '<string>',
    'sourceIndexName' => '<string>',
    'sourceProjectApiKey' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "content-type: <content-type>",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{baseUrl}/{version}/projects/{projectId}/indexes"

	payload := strings.NewReader("{\n  \"indexName\": \"<string>\",\n  \"mappings\": {},\n  \"indexClass\": \"STANDARD\",\n  \"sourceProjectId\": \"<string>\",\n  \"sourceIndexName\": \"<string>\",\n  \"sourceProjectApiKey\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("content-type", "<content-type>")
	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{baseUrl}/{version}/projects/{projectId}/indexes")
  .header("content-type", "<content-type>")
  .header("x-api-key", "<x-api-key>")
  .body("{\n  \"indexName\": \"<string>\",\n  \"mappings\": {},\n  \"indexClass\": \"STANDARD\",\n  \"sourceProjectId\": \"<string>\",\n  \"sourceIndexName\": \"<string>\",\n  \"sourceProjectApiKey\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{baseUrl}/{version}/projects/{projectId}/indexes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["content-type"] = '<content-type>'
request["x-api-key"] = '<x-api-key>'
request.body = "{\n  \"indexName\": \"<string>\",\n  \"mappings\": {},\n  \"indexClass\": \"STANDARD\",\n  \"sourceProjectId\": \"<string>\",\n  \"sourceIndexName\": \"<string>\",\n  \"sourceProjectApiKey\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "projectId": "<string>",
  "indexName": "<string>",
  "mappings": {},
  "numDocs": 123,
  "cloneSourceInfo": {
    "sourceProjectId": "<string>",
    "sourceIndexName": "<string>",
    "sourceIndexVersionId": "<string>"
  },
  "indexStatus": "CREATING",
  "indexClass": "STANDARD"
}

Headers

content-type

string

default:application/json

required

x-api-key

string

required

Project API Key.

Path Parameters

projectId

string

required

Project ID.

Body

application/json

indexName

string

required

Index name must be unique within a project and the supported maximum length is 52.

mappings

object

Show child attributes

indexClass

enum<string>

default:STANDARD

Index class.

Available options:

STANDARD,

INFREQUENT_ACCESS

sourceProjectId

string

sourceIndexName

string

sourceProjectApiKey

string

Response

202 - application/json

Created index

projectId

string

Project ID.

indexName

string

Index name.

mappings

object

Show child attributes

numDocs

integer

Total number of documents.

cloneSourceInfo

object

Clone source information.

Show child attributes

indexStatus

enum<string>

Status

Available options:

CREATING,

ACTIVE,

DELETING

indexClass

enum<string>

default:STANDARD

Index class.

Available options:

STANDARD,

INFREQUENT_ACCESS