API reference/mGIS Analytics
POSTstatefulexact public snapshot

Add or delete column in a given Dataset on mGIS engine

/updateStructure

Performs operation like add and delete for columns on the given dataset table.

Exact public source snapshot

This operation is retained because its version-labelled public specification differs structurally from another generation. It is comparison evidence, not a promise of current support, compatibility, entitlement, or availability.

Call the operation

POSThttps://mgis-api.mappls.com/updateStructure?datasetNme=test&operation=add&updateColumns=%5B%7B%22name%22%3A%22id%22%2C%22type%22%3A%22int%22%2C%22defaultValue%22%3A55%7D%5D
Base URLhttps://mgis-api.mappls.com/
Authenticationbearer
Journey rolecommand
Content typesNo request body

Parameters

NameLocationTypeDescriptionExample
datasetNmerequired
querystring

dataset Name.

test
operationrequired
querystring

only two possible operation add or delete.

add
updateColumnsrequired
querystring

an array of objects which contain column name , its type and default value. example [{"name":"id","type":"int","defaultValue":55}]

[{"name":"id","type":"int","defaultValue":55}]

Build your request in eight languages

Change source-backed examples once, validate required inputs, and copy the synchronized cURL, JavaScript, Python, Java, C#, Go, PHP, or Ruby request. Credentials remain environment references, and this page never sends a provider request.

Local request composerCode stays local · fixtures are explicit
POSTRequest inputs
3 editable · 0 protected
Generated in eight languages
Environment-backed credentials
POSThttps://mgis-api.mappls.com/updateStructure?datasetNme=test&operation=add&updateColumns=%5B%7B%22name%22%3A%22id%22%2C%22type%22%3A%22int%22%2C%22defaultValue%22%3A55%7D%5D
Credential-free sandboxExecute this contract without a provider call
How fixtures work
Generated from your inputs
curl --request POST \
  --url 'https://mgis-api.mappls.com/updateStructure?datasetNme=test&operation=add&updateColumns=%5B%7B%22name%22%3A%22id%22%2C%22type%22%3A%22int%22%2C%22defaultValue%22%3A55%7D%5D' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_ACCESS_TOKEN}"

Credential-safe by constructionSet MAPPLS_ACCESS_TOKEN only in your trusted runtime. Code generation stays local. Sandbox execution sends only bounded fixture inputs to this developer platform and never reads a credential or calls Mappls.

Send a production-shaped request

Examples use environment-backed access tokens, explicit timeouts where supported, status checks, and JSON bodies derived from the source schema. Replace sample identifiers and coordinates with values from your application.

POST /updateStructure
curl --request POST \
  --url 'https://mgis-api.mappls.com/updateStructure?datasetNme=test&operation=add&updateColumns=%5B%7B%22name%22%3A%22id%22%2C%22type%22%3A%22int%22%2C%22defaultValue%22%3A55%7D%5D' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Responses

200

OK

400

Bad Request, User made an error while creating a valid request.

401

Unauthorized, accesscode is not valid for the request

500

Internal Server Error, the request caused an error in our systems.

200 response fields

FieldTypeDescriptionExample
message
string

If everything goes ok then user receives a message indicating that structure updated successfully on mGIS platform

Structure updated successfully
Response example
{
  "message": "Structure updated successfully"
}

Operate it safely

command

This operation creates or triggers durable state. Supply an idempotency strategy and persist the returned identifier before continuing.

Keep credentials and raw tokens out of source, client bundles, prompts, and logs.Record the operation ID, status, latency, retry count, and source contract version in traces.Classify 4xx responses before retrying; back off and add jitter for retryable 5xx or transport failures.Persist resource identifiers and apply commands exactly once in effect across retries and event replay.

Contract provenance

Source file
mappls-developer-platform/data/corpus/public-api-contracts/mapmyindia-mgis-apis/docs/v1/custom/sat-apis.yml
SHA-256
15348c512128c6a43cfaf8fb29f24a78551008d1ee356cb76baa85a2724a65a8
Normalization
Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.