Schema
Alter the schema fields of your Engine.
Before you begin, familiarize yourself with the schema design principles within the API Overview .
Authentication
For authentication, the Schema endpoint requires...
A Host Identifier : [HOST_IDENTIFIER]
The name of your Engine : [ENGINE]
A Private API Key : [PRIVATE_API_KEY]
curl -X GET 'https://[HOST_IDENTIFIER].api.swiftype.com/api/as/v1/engines/[ENGINE]/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer [PRIVATE_API_KEY]'
List Schema
GET
/api/as/v1/engines/{ENGINE_NAME}/schema
curl -X GET 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxxxxxx'
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number"
}
No Java example available, showing cURL
curl -X GET 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxxxxxx'
No Java example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number"
}
No Node example available, showing cURL
curl -X GET 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxxxxxx'
No Node example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number"
}
No Ruby example available, showing cURL
curl -X GET 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxxxxxx'
No Ruby example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number"
}
No Python example available, showing cURL
curl -X GET 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxxxxxx'
No Python example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number"
}
No Javascript example available, showing cURL
curl -X GET 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxxxxxx'
No Javascript example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number"
}
Update Schema
Adjusting your schema begins a reindex of your data. Your schema can not be changed during a reindex.
When updating a Schema, you can either...
Updates an Existing Schema
POST
/api/as/v1/engines/{ENGINE_NAME}/schema
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_km": "text"
}'
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "text"
}
No Java example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_km": "text"
}'
No Java example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "text"
}
No Node example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_km": "text"
}'
No Node example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "text"
}
No Ruby example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_km": "text"
}'
No Ruby example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "text"
}
No Python example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_km": "text"
}'
No Python example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "text"
}
No Javascript example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_km": "text"
}'
No Javascript example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "text"
}
Creates a new Schema Field
You may have up to 64 fields.
Fields cannot be named: external_id, engine_id, highlight, or, and, not, any, all, none.
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_mi": "number"
}
'
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number" ,
"square_mi" : "number"
}
No Java example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_mi": "number"
}
'
No Java example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number" ,
"square_mi" : "number"
}
No Node example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_mi": "number"
}
'
No Node example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number" ,
"square_mi" : "number"
}
No Ruby example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_mi": "number"
}
'
No Ruby example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number" ,
"square_mi" : "number"
}
No Python example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_mi": "number"
}
'
No Python example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number" ,
"square_mi" : "number"
}
No Javascript example available, showing cURL
curl -X POST 'https://host-2376rb.api.swiftype.com/api/as/v1/engines/national-parks-demo/schema' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer private-xxxxxxxxxxxxxxxx' \
-d '{
"square_mi": "number"
}
'
No Javascript example available, showing cURL
{
"description" : "text" ,
"nps_link" : "text" ,
"states" : "text" ,
"title" : "text" ,
"visitors" : "number" ,
"world_heritage_site" : "text" ,
"location" : "geolocation" ,
"acres" : "number" ,
"date_established" : "date" ,
"square_km" : "number" ,
"square_mi" : "number"
}
Errors
If one field fails validation then the entire set will fail.
Name indicates the name of the field. Type indicates the type of the field.
400 Error Message Solution "Type is not included in the list" The allowed types are: text , number , date , geolocation ". Ensure that no spaces are included and only one of the four types is present. Watch out for integer , which will not work - expects number . "Engine is reindexing." You may proceed with Schema changes once reindexing is complete. Time varies based on size of Engine. "Name cannot contain whitespace" Can not contain any whitespace characters like 'my field'
"Name cannot have a leading underscore" Can not start with a leading underscore like '_myfield'
. "Name cannot contain more than 64 characters" Very long field names are not allowed. "Name cannot be a reserved field (external_id, engine_id, highlight, or, and, not, any, all, none)" These field names are reserved for your safety :). For example, trying to define an 'all'
filter for a field called 'all'
would be very difficult to understand. "Name can only contain lowercase letters, numbers, and underscores" No dashes, capitals, strange characters or other such silliness! "Name must contain a lowercase letter" You can not have a field with only capital letters. "Name must be unique" Each field name must be unique.
What's Next?
The Schema endpoint is how you adjust your foundational data model. Now that you know how to make Schema changes via the API, you may be interested in exploring deeper into Indexing Documents . Alternatively, you may be into some of the deeper analytics presented by Curations and Clickthrough .
Stuck? Looking for help? Contact support or check out the App Search community forum !