API v2 - REST¶
OpenAPI 3.0 Schema
-
GET/api/v2/documents/¶ API endpoint that allows documents to be viewed or edited.
- Query Parameters
format (string) –
ordering (string) – Which field to use when ordering the results.
page (integer) – A page number within the paginated result set.
page_size (integer) – Number of results to return per page.
search (string) – A search term.
- Status Codes
200 OK –
-
POST/api/v2/documents/¶ Either create a single or many model instances in bulk using the Serializer’s many=True ability from Django REST >= 2.2.5.
The data can be represented by the serializer name (single or plural forms), dict or list.
Examples:
POST /dogs/ {
“name”: “Fido”, “age”: 2
}
POST /dogs/ {
- “dog”: {
“name”: “Lucky”, “age”: 3
}
}
POST /dogs/ {
- “dogs”: [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
}
POST /dogs/ [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
- Query Parameters
format (string) –
- Status Codes
-
PATCH/api/v2/documents/¶ API endpoint that allows documents to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/documents/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/documents/{id}/¶ API endpoint that allows documents to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this document.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/api/v2/documents/{id}/¶ Update one or more model instances.
If ENABLE_BULK_UPDATE is set, multiple previously-fetched records may be updated in a single call, provided their IDs.
If ENABLE_PATCH_ALL is set, multiple records may be updated in a single PATCH call, even without knowing their IDs.
WARNING: ENABLE_PATCH_ALL should be considered an advanced feature and used with caution. This feature must be enabled at the viewset level and must also be requested explicitly by the client via the “patch-all” query parameter.
This parameter can have one of the following values:
- true (or 1): records will be fetched and then updated in a transaction loop
The Model.save method will be called and model signals will run
This can be slow if there are too many signals or many records in the query
This is considered the more safe and default behavior
- query: records will be updated in a single query
The QuerySet.update method will be called and model signals will not run
This will be fast, but may break data constraints that are controlled by signals
This is considered unsafe but useful in certain situations
The server’s successful response to a patch-all request will NOT include any individual records. Instead, the response content will contain a “meta” object with an “updated” count of updated records.
Examples:
Update one dog:
PATCH /dogs/1/ {
‘fur’: ‘white’
}
Update many dogs by ID:
PATCH /dogs/ [
{‘id’: 1, ‘fur’: ‘white’}, {‘id’: 2, ‘fur’: ‘black’}, {‘id’: 3, ‘fur’: ‘yellow’}
]
Update all dogs in a query:
PATCH /dogs/?filter{fur.contains}=brown&patch-all=true {
‘fur’: ‘gold’
}
- Parameters
id (integer) – A unique integer value identifying this document.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PATCH/api/v2/documents/{id}/¶ API endpoint that allows documents to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this document.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/documents/{id}/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Parameters
id (integer) – A unique integer value identifying this document.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/documents/{id}/linked_resources/¶ API endpoint that allows documents to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this document.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/geoapps/¶ API endpoint that allows geoapps to be viewed or edited.
- Query Parameters
format (string) –
ordering (string) – Which field to use when ordering the results.
page (integer) – A page number within the paginated result set.
page_size (integer) – Number of results to return per page.
search (string) – A search term.
- Status Codes
200 OK –
-
POST/api/v2/geoapps/¶ Either create a single or many model instances in bulk using the Serializer’s many=True ability from Django REST >= 2.2.5.
The data can be represented by the serializer name (single or plural forms), dict or list.
Examples:
POST /dogs/ {
“name”: “Fido”, “age”: 2
}
POST /dogs/ {
- “dog”: {
“name”: “Lucky”, “age”: 3
}
}
POST /dogs/ {
- “dogs”: [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
}
POST /dogs/ [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
- Query Parameters
format (string) –
- Status Codes
-
PATCH/api/v2/geoapps/¶ API endpoint that allows geoapps to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/geoapps/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/geoapps/{id}/¶ API endpoint that allows geoapps to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this geo app.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/api/v2/geoapps/{id}/¶ Update one or more model instances.
If ENABLE_BULK_UPDATE is set, multiple previously-fetched records may be updated in a single call, provided their IDs.
If ENABLE_PATCH_ALL is set, multiple records may be updated in a single PATCH call, even without knowing their IDs.
WARNING: ENABLE_PATCH_ALL should be considered an advanced feature and used with caution. This feature must be enabled at the viewset level and must also be requested explicitly by the client via the “patch-all” query parameter.
This parameter can have one of the following values:
- true (or 1): records will be fetched and then updated in a transaction loop
The Model.save method will be called and model signals will run
This can be slow if there are too many signals or many records in the query
This is considered the more safe and default behavior
- query: records will be updated in a single query
The QuerySet.update method will be called and model signals will not run
This will be fast, but may break data constraints that are controlled by signals
This is considered unsafe but useful in certain situations
The server’s successful response to a patch-all request will NOT include any individual records. Instead, the response content will contain a “meta” object with an “updated” count of updated records.
Examples:
Update one dog:
PATCH /dogs/1/ {
‘fur’: ‘white’
}
Update many dogs by ID:
PATCH /dogs/ [
{‘id’: 1, ‘fur’: ‘white’}, {‘id’: 2, ‘fur’: ‘black’}, {‘id’: 3, ‘fur’: ‘yellow’}
]
Update all dogs in a query:
PATCH /dogs/?filter{fur.contains}=brown&patch-all=true {
‘fur’: ‘gold’
}
- Parameters
id (integer) – A unique integer value identifying this geo app.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PATCH/api/v2/geoapps/{id}/¶ API endpoint that allows geoapps to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this geo app.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/geoapps/{id}/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Parameters
id (integer) – A unique integer value identifying this geo app.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/geoapps/{id}/{field_name}/¶ Fetch related object(s), as if sideloaded (used to support link objects).
This method gets mapped to /<resource>/<pk>/<field_name>/ by DynamicRouter for all DynamicRelationField fields. Generally, this method probably shouldn’t be overridden.
An alternative implementation would be to generate reverse queries. For an exploration of that approach, see:
- Parameters
field_name (string) –
id (integer) – A unique integer value identifying this geo app.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/geostories/¶ API endpoint that allows geoapps to be viewed or edited.
- Query Parameters
format (string) –
ordering (string) – Which field to use when ordering the results.
page (integer) – A page number within the paginated result set.
page_size (integer) – Number of results to return per page.
search (string) – A search term.
- Status Codes
200 OK –
-
POST/api/v2/geostories/¶ Either create a single or many model instances in bulk using the Serializer’s many=True ability from Django REST >= 2.2.5.
The data can be represented by the serializer name (single or plural forms), dict or list.
Examples:
POST /dogs/ {
“name”: “Fido”, “age”: 2
}
POST /dogs/ {
- “dog”: {
“name”: “Lucky”, “age”: 3
}
}
POST /dogs/ {
- “dogs”: [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
}
POST /dogs/ [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
- Query Parameters
format (string) –
- Status Codes
-
PATCH/api/v2/geostories/¶ API endpoint that allows geoapps to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/geostories/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/geostories/{id}/¶ API endpoint that allows geoapps to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this geo story.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/api/v2/geostories/{id}/¶ Update one or more model instances.
If ENABLE_BULK_UPDATE is set, multiple previously-fetched records may be updated in a single call, provided their IDs.
If ENABLE_PATCH_ALL is set, multiple records may be updated in a single PATCH call, even without knowing their IDs.
WARNING: ENABLE_PATCH_ALL should be considered an advanced feature and used with caution. This feature must be enabled at the viewset level and must also be requested explicitly by the client via the “patch-all” query parameter.
This parameter can have one of the following values:
- true (or 1): records will be fetched and then updated in a transaction loop
The Model.save method will be called and model signals will run
This can be slow if there are too many signals or many records in the query
This is considered the more safe and default behavior
- query: records will be updated in a single query
The QuerySet.update method will be called and model signals will not run
This will be fast, but may break data constraints that are controlled by signals
This is considered unsafe but useful in certain situations
The server’s successful response to a patch-all request will NOT include any individual records. Instead, the response content will contain a “meta” object with an “updated” count of updated records.
Examples:
Update one dog:
PATCH /dogs/1/ {
‘fur’: ‘white’
}
Update many dogs by ID:
PATCH /dogs/ [
{‘id’: 1, ‘fur’: ‘white’}, {‘id’: 2, ‘fur’: ‘black’}, {‘id’: 3, ‘fur’: ‘yellow’}
]
Update all dogs in a query:
PATCH /dogs/?filter{fur.contains}=brown&patch-all=true {
‘fur’: ‘gold’
}
- Parameters
id (integer) – A unique integer value identifying this geo story.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PATCH/api/v2/geostories/{id}/¶ API endpoint that allows geoapps to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this geo story.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/geostories/{id}/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Parameters
id (integer) – A unique integer value identifying this geo story.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/geostories/{id}/{field_name}/¶ Fetch related object(s), as if sideloaded (used to support link objects).
This method gets mapped to /<resource>/<pk>/<field_name>/ by DynamicRouter for all DynamicRelationField fields. Generally, this method probably shouldn’t be overridden.
An alternative implementation would be to generate reverse queries. For an exploration of that approach, see:
- Parameters
field_name (string) –
id (integer) – A unique integer value identifying this geo story.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/groups/¶ API endpoint that allows gropus to be viewed or edited.
- Query Parameters
format (string) –
ordering (string) – Which field to use when ordering the results.
page (integer) – A page number within the paginated result set.
page_size (integer) – Number of results to return per page.
- Status Codes
200 OK –
-
POST/api/v2/groups/¶ Either create a single or many model instances in bulk using the Serializer’s many=True ability from Django REST >= 2.2.5.
The data can be represented by the serializer name (single or plural forms), dict or list.
Examples:
POST /dogs/ {
“name”: “Fido”, “age”: 2
}
POST /dogs/ {
- “dog”: {
“name”: “Lucky”, “age”: 3
}
}
POST /dogs/ {
- “dogs”: [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
}
POST /dogs/ [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
- Query Parameters
format (string) –
- Status Codes
-
PATCH/api/v2/groups/¶ API endpoint that allows gropus to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/groups/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/groups/{id}/¶ API endpoint that allows gropus to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this group profile.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/api/v2/groups/{id}/¶ Update one or more model instances.
If ENABLE_BULK_UPDATE is set, multiple previously-fetched records may be updated in a single call, provided their IDs.
If ENABLE_PATCH_ALL is set, multiple records may be updated in a single PATCH call, even without knowing their IDs.
WARNING: ENABLE_PATCH_ALL should be considered an advanced feature and used with caution. This feature must be enabled at the viewset level and must also be requested explicitly by the client via the “patch-all” query parameter.
This parameter can have one of the following values:
- true (or 1): records will be fetched and then updated in a transaction loop
The Model.save method will be called and model signals will run
This can be slow if there are too many signals or many records in the query
This is considered the more safe and default behavior
- query: records will be updated in a single query
The QuerySet.update method will be called and model signals will not run
This will be fast, but may break data constraints that are controlled by signals
This is considered unsafe but useful in certain situations
The server’s successful response to a patch-all request will NOT include any individual records. Instead, the response content will contain a “meta” object with an “updated” count of updated records.
Examples:
Update one dog:
PATCH /dogs/1/ {
‘fur’: ‘white’
}
Update many dogs by ID:
PATCH /dogs/ [
{‘id’: 1, ‘fur’: ‘white’}, {‘id’: 2, ‘fur’: ‘black’}, {‘id’: 3, ‘fur’: ‘yellow’}
]
Update all dogs in a query:
PATCH /dogs/?filter{fur.contains}=brown&patch-all=true {
‘fur’: ‘gold’
}
- Parameters
id (integer) – A unique integer value identifying this group profile.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PATCH/api/v2/groups/{id}/¶ API endpoint that allows gropus to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this group profile.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/groups/{id}/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Parameters
id (integer) – A unique integer value identifying this group profile.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/groups/{id}/managers/¶ API endpoint that allows gropus to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this group profile.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/groups/{id}/members/¶ API endpoint that allows gropus to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this group profile.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/groups/{id}/resources/¶ API endpoint that allows gropus to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this group profile.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/layers/¶ API endpoint that allows layers to be viewed or edited.
- Query Parameters
format (string) –
ordering (string) – Which field to use when ordering the results.
page (integer) – A page number within the paginated result set.
page_size (integer) – Number of results to return per page.
search (string) – A search term.
- Status Codes
200 OK –
-
POST/api/v2/layers/¶ Either create a single or many model instances in bulk using the Serializer’s many=True ability from Django REST >= 2.2.5.
The data can be represented by the serializer name (single or plural forms), dict or list.
Examples:
POST /dogs/ {
“name”: “Fido”, “age”: 2
}
POST /dogs/ {
- “dog”: {
“name”: “Lucky”, “age”: 3
}
}
POST /dogs/ {
- “dogs”: [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
}
POST /dogs/ [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
- Query Parameters
format (string) –
- Status Codes
-
PATCH/api/v2/layers/¶ API endpoint that allows layers to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/layers/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/layers/{id}/¶ API endpoint that allows layers to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this layer.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/api/v2/layers/{id}/¶ Update one or more model instances.
If ENABLE_BULK_UPDATE is set, multiple previously-fetched records may be updated in a single call, provided their IDs.
If ENABLE_PATCH_ALL is set, multiple records may be updated in a single PATCH call, even without knowing their IDs.
WARNING: ENABLE_PATCH_ALL should be considered an advanced feature and used with caution. This feature must be enabled at the viewset level and must also be requested explicitly by the client via the “patch-all” query parameter.
This parameter can have one of the following values:
- true (or 1): records will be fetched and then updated in a transaction loop
The Model.save method will be called and model signals will run
This can be slow if there are too many signals or many records in the query
This is considered the more safe and default behavior
- query: records will be updated in a single query
The QuerySet.update method will be called and model signals will not run
This will be fast, but may break data constraints that are controlled by signals
This is considered unsafe but useful in certain situations
The server’s successful response to a patch-all request will NOT include any individual records. Instead, the response content will contain a “meta” object with an “updated” count of updated records.
Examples:
Update one dog:
PATCH /dogs/1/ {
‘fur’: ‘white’
}
Update many dogs by ID:
PATCH /dogs/ [
{‘id’: 1, ‘fur’: ‘white’}, {‘id’: 2, ‘fur’: ‘black’}, {‘id’: 3, ‘fur’: ‘yellow’}
]
Update all dogs in a query:
PATCH /dogs/?filter{fur.contains}=brown&patch-all=true {
‘fur’: ‘gold’
}
- Parameters
id (integer) – A unique integer value identifying this layer.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PATCH/api/v2/layers/{id}/¶ API endpoint that allows layers to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this layer.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/layers/{id}/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Parameters
id (integer) – A unique integer value identifying this layer.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/layers/{id}/{field_name}/¶ Fetch related object(s), as if sideloaded (used to support link objects).
This method gets mapped to /<resource>/<pk>/<field_name>/ by DynamicRouter for all DynamicRelationField fields. Generally, this method probably shouldn’t be overridden.
An alternative implementation would be to generate reverse queries. For an exploration of that approach, see:
- Parameters
field_name (string) –
id (integer) – A unique integer value identifying this layer.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/maps/¶ API endpoint that allows maps to be viewed or edited.
- Query Parameters
format (string) –
ordering (string) – Which field to use when ordering the results.
page (integer) – A page number within the paginated result set.
page_size (integer) – Number of results to return per page.
search (string) – A search term.
- Status Codes
200 OK –
-
POST/api/v2/maps/¶ Either create a single or many model instances in bulk using the Serializer’s many=True ability from Django REST >= 2.2.5.
The data can be represented by the serializer name (single or plural forms), dict or list.
Examples:
POST /dogs/ {
“name”: “Fido”, “age”: 2
}
POST /dogs/ {
- “dog”: {
“name”: “Lucky”, “age”: 3
}
}
POST /dogs/ {
- “dogs”: [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
}
POST /dogs/ [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
- Query Parameters
format (string) –
- Status Codes
-
PATCH/api/v2/maps/¶ API endpoint that allows maps to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/maps/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/maps/{id}/¶ API endpoint that allows maps to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this map.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/api/v2/maps/{id}/¶ Update one or more model instances.
If ENABLE_BULK_UPDATE is set, multiple previously-fetched records may be updated in a single call, provided their IDs.
If ENABLE_PATCH_ALL is set, multiple records may be updated in a single PATCH call, even without knowing their IDs.
WARNING: ENABLE_PATCH_ALL should be considered an advanced feature and used with caution. This feature must be enabled at the viewset level and must also be requested explicitly by the client via the “patch-all” query parameter.
This parameter can have one of the following values:
- true (or 1): records will be fetched and then updated in a transaction loop
The Model.save method will be called and model signals will run
This can be slow if there are too many signals or many records in the query
This is considered the more safe and default behavior
- query: records will be updated in a single query
The QuerySet.update method will be called and model signals will not run
This will be fast, but may break data constraints that are controlled by signals
This is considered unsafe but useful in certain situations
The server’s successful response to a patch-all request will NOT include any individual records. Instead, the response content will contain a “meta” object with an “updated” count of updated records.
Examples:
Update one dog:
PATCH /dogs/1/ {
‘fur’: ‘white’
}
Update many dogs by ID:
PATCH /dogs/ [
{‘id’: 1, ‘fur’: ‘white’}, {‘id’: 2, ‘fur’: ‘black’}, {‘id’: 3, ‘fur’: ‘yellow’}
]
Update all dogs in a query:
PATCH /dogs/?filter{fur.contains}=brown&patch-all=true {
‘fur’: ‘gold’
}
- Parameters
id (integer) – A unique integer value identifying this map.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PATCH/api/v2/maps/{id}/¶ API endpoint that allows maps to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this map.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/maps/{id}/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Parameters
id (integer) – A unique integer value identifying this map.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/maps/{id}/layers/¶ API endpoint that allows maps to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this map.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/maps/{id}/local_layers/¶ API endpoint that allows maps to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this map.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/resources/¶ API endpoint that allows base resources to be viewed or edited.
- Query Parameters
format (string) –
ordering (string) – Which field to use when ordering the results.
page (integer) – A page number within the paginated result set.
page_size (integer) – Number of results to return per page.
search (string) – A search term.
- Status Codes
200 OK –
-
POST/api/v2/resources/¶ Either create a single or many model instances in bulk using the Serializer’s many=True ability from Django REST >= 2.2.5.
The data can be represented by the serializer name (single or plural forms), dict or list.
Examples:
POST /dogs/ {
“name”: “Fido”, “age”: 2
}
POST /dogs/ {
- “dog”: {
“name”: “Lucky”, “age”: 3
}
}
POST /dogs/ {
- “dogs”: [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
}
POST /dogs/ [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
- Query Parameters
format (string) –
- Status Codes
-
PATCH/api/v2/resources/¶ API endpoint that allows base resources to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/resources/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/resources/{id}/¶ API endpoint that allows base resources to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this resource base.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/api/v2/resources/{id}/¶ Update one or more model instances.
If ENABLE_BULK_UPDATE is set, multiple previously-fetched records may be updated in a single call, provided their IDs.
If ENABLE_PATCH_ALL is set, multiple records may be updated in a single PATCH call, even without knowing their IDs.
WARNING: ENABLE_PATCH_ALL should be considered an advanced feature and used with caution. This feature must be enabled at the viewset level and must also be requested explicitly by the client via the “patch-all” query parameter.
This parameter can have one of the following values:
- true (or 1): records will be fetched and then updated in a transaction loop
The Model.save method will be called and model signals will run
This can be slow if there are too many signals or many records in the query
This is considered the more safe and default behavior
- query: records will be updated in a single query
The QuerySet.update method will be called and model signals will not run
This will be fast, but may break data constraints that are controlled by signals
This is considered unsafe but useful in certain situations
The server’s successful response to a patch-all request will NOT include any individual records. Instead, the response content will contain a “meta” object with an “updated” count of updated records.
Examples:
Update one dog:
PATCH /dogs/1/ {
‘fur’: ‘white’
}
Update many dogs by ID:
PATCH /dogs/ [
{‘id’: 1, ‘fur’: ‘white’}, {‘id’: 2, ‘fur’: ‘black’}, {‘id’: 3, ‘fur’: ‘yellow’}
]
Update all dogs in a query:
PATCH /dogs/?filter{fur.contains}=brown&patch-all=true {
‘fur’: ‘gold’
}
- Parameters
id (integer) – A unique integer value identifying this resource base.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PATCH/api/v2/resources/{id}/¶ API endpoint that allows base resources to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this resource base.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/resources/{id}/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Parameters
id (integer) – A unique integer value identifying this resource base.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/resources/{id}/get_perms/¶ API endpoint that allows base resources to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this resource base.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/api/v2/resources/{id}/set_perms/¶ API endpoint that allows base resources to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this resource base.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/resources/approved/¶ API endpoint that allows base resources to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/resources/featured/¶ API endpoint that allows base resources to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/resources/published/¶ API endpoint that allows base resources to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/resources/resource_types/¶ API endpoint that allows base resources to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/schema/¶ OpenApi3 schema for this API. Format can be selected via content negotiation.
YAML: application/vnd.oai.openapi
JSON: application/vnd.oai.openapi+json
- Query Parameters
format (string) –
lang (string) –
- Status Codes
200 OK –
-
GET/api/v2/users/¶ API endpoint that allows users to be viewed or edited.
- Query Parameters
format (string) –
ordering (string) – Which field to use when ordering the results.
page (integer) – A page number within the paginated result set.
page_size (integer) – Number of results to return per page.
- Status Codes
200 OK –
-
POST/api/v2/users/¶ Either create a single or many model instances in bulk using the Serializer’s many=True ability from Django REST >= 2.2.5.
The data can be represented by the serializer name (single or plural forms), dict or list.
Examples:
POST /dogs/ {
“name”: “Fido”, “age”: 2
}
POST /dogs/ {
- “dog”: {
“name”: “Lucky”, “age”: 3
}
}
POST /dogs/ {
- “dogs”: [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
}
POST /dogs/ [
{“name”: “Fido”, “age”: 2}, {“name”: “Lucky”, “age”: 3}
]
- Query Parameters
format (string) –
- Status Codes
-
PATCH/api/v2/users/¶ API endpoint that allows users to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/users/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/users/{id}/¶ API endpoint that allows users to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/api/v2/users/{id}/¶ Update one or more model instances.
If ENABLE_BULK_UPDATE is set, multiple previously-fetched records may be updated in a single call, provided their IDs.
If ENABLE_PATCH_ALL is set, multiple records may be updated in a single PATCH call, even without knowing their IDs.
WARNING: ENABLE_PATCH_ALL should be considered an advanced feature and used with caution. This feature must be enabled at the viewset level and must also be requested explicitly by the client via the “patch-all” query parameter.
This parameter can have one of the following values:
- true (or 1): records will be fetched and then updated in a transaction loop
The Model.save method will be called and model signals will run
This can be slow if there are too many signals or many records in the query
This is considered the more safe and default behavior
- query: records will be updated in a single query
The QuerySet.update method will be called and model signals will not run
This will be fast, but may break data constraints that are controlled by signals
This is considered unsafe but useful in certain situations
The server’s successful response to a patch-all request will NOT include any individual records. Instead, the response content will contain a “meta” object with an “updated” count of updated records.
Examples:
Update one dog:
PATCH /dogs/1/ {
‘fur’: ‘white’
}
Update many dogs by ID:
PATCH /dogs/ [
{‘id’: 1, ‘fur’: ‘white’}, {‘id’: 2, ‘fur’: ‘black’}, {‘id’: 3, ‘fur’: ‘yellow’}
]
Update all dogs in a query:
PATCH /dogs/?filter{fur.contains}=brown&patch-all=true {
‘fur’: ‘gold’
}
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PATCH/api/v2/users/{id}/¶ API endpoint that allows users to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/api/v2/users/{id}/¶ Either delete a single or many model instances in bulk
DELETE /dogs/ {
- “dogs”: [
{“id”: 1}, {“id”: 2}
]
}
DELETE /dogs/ [
{“id”: 1}, {“id”: 2}
]
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/api/v2/users/{id}/groups/¶ API endpoint that allows users to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/api/v2/users/{id}/resources/¶ API endpoint that allows users to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
GET/mapstore/rest/resources/¶ Only Authenticate User perform CRUD Operations on Respective Data
- Query Parameters
format (string) –
- Status Codes
200 OK – No response body
-
POST/mapstore/rest/resources/¶ Only Authenticate User perform CRUD Operations on Respective Data
- Query Parameters
format (string) –
- Status Codes
201 Created – No response body
-
GET/mapstore/rest/resources/{id}/¶ Only Authenticate User perform CRUD Operations on Respective Data
- Parameters
id (integer) – A unique value identifying this map store resource.
- Query Parameters
format (string) –
- Status Codes
200 OK – No response body
-
PUT/mapstore/rest/resources/{id}/¶ Only Authenticate User perform CRUD Operations on Respective Data
- Parameters
id (integer) – A unique value identifying this map store resource.
- Query Parameters
format (string) –
- Status Codes
200 OK – No response body
-
PATCH/mapstore/rest/resources/{id}/¶ Only Authenticate User perform CRUD Operations on Respective Data
- Parameters
id (integer) – A unique value identifying this map store resource.
- Query Parameters
format (string) –
- Status Codes
200 OK – No response body
-
DELETE/mapstore/rest/resources/{id}/¶ Only Authenticate User perform CRUD Operations on Respective Data
- Parameters
id (integer) – A unique value identifying this map store resource.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body
-
GET/mapstore/rest/users/¶ API endpoint that allows users to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
POST/mapstore/rest/users/¶ API endpoint that allows users to be viewed or edited.
- Query Parameters
format (string) –
- Status Codes
-
GET/mapstore/rest/users/{id}/¶ API endpoint that allows users to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PUT/mapstore/rest/users/{id}/¶ API endpoint that allows users to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
PATCH/mapstore/rest/users/{id}/¶ API endpoint that allows users to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
200 OK –
-
DELETE/mapstore/rest/users/{id}/¶ API endpoint that allows users to be viewed or edited.
- Parameters
id (integer) – A unique integer value identifying this user.
- Query Parameters
format (string) –
- Status Codes
204 No Content – No response body