ArcGIS Online

App · 20 actions

Work with your organization's maps and data in Esri's ArcGIS Online: start a workflow on a new Survey123 response or a new or changed feature, query, add, update and delete features and their attachments, search items, users and groups, and turn addresses into locations and back.

Actions

ActionWhat it does
Add attachmentAttach a photo or file to a feature, up to 50 MB.
Add featureAdd a feature (a row) to a layer, with its field values and, for a layer of points, where it is.
Count featuresCount a layer's features, all of them or those matching the filters.
Delete attachmentDelete one attachment from a feature.
Delete featuresDelete features from a layer by their object IDs.
Find an addressTurn an address or place name into its latitude and longitude, with the address as ArcGIS standardizes it.
Find the address at a locationTurn a latitude and longitude into the nearest address.
Get featureRead one feature by its object ID, with all its fields and its location.
Get itemRead an item's details: title, type, owner, sharing, description, tags and address.
Get layer detailsRead a layer's fields (with each field's choices), what kind of shapes it holds, whether it can be edited, whether it keeps attachments and which fields record who changed what.
Get my accountSee who the API key acts as and in which organization.
Get userRead a user's profile: name, role and when they last signed in.
List attachmentsList the photos and files attached to a feature, with a link to each.
List group membersList who is in a group: its owner, its managers and its members.
List layers and tablesList the layers and tables a feature layer holds, with their IDs and kinds.
Query featuresGet a layer's features (its rows, such as Survey123 responses), filtered by a field value, a date range or an advanced filter, sorted and with only the fields you choose.
Search groupsFind groups in your organization by name, or list the groups you're in.
Search itemsFind maps, feature layers, Survey123 forms, apps and files in your organization, among your own items, in a group, or across public ArcGIS Online.
Search usersFind people in your organization by name, user name or email.
Update featureChange a feature's field values or move it.

Add attachment

Attach a photo or file to a feature, up to 50 MB.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.
Object IDobject_idnumberRequired
The feature's object ID, from 'Query features' or a trigger.
FilefiletextRequired
The file to attach: upload one, pick a file from an earlier step, or give a web address that leads to it.
File namefile_nametext
The name it's saved under. Defaults to the file's own name.

Outputs

attachment_idnumber
The new attachment's ID
global_idtext
Its global ID, empty if none
nametext
The name it was saved under
object_idnumber
The feature
sizenumber
Size in bytes
urltext
Its address
Example output
{
  "attachment_id": 8,
  "global_id": "{1A2B3C4D-5E6F-4A7B-8C9D-0E1F2A3B4C5D}",
  "name": "inspection.pdf",
  "object_id": 42,
  "size": 18234,
  "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0/42/attachments/8"
}

Add feature

Add a feature (a row) to a layer, with its field values and, for a layer of points, where it is.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.
Fieldsattributesobject
The values to set, one per field. A date field takes a date, a field with choices takes one of them. Fields left empty are left as they are.
Latitudelatitudenumber
Where the feature is, for a layer of points, such as 34.0572.From -90 to 90.
Longitudelongitudenumber
Where the feature is, for a layer of points, such as -117.1948.From -180 to 180.

Outputs

global_idtext
Its global ID, empty if the layer has none
layerobject
The layer the step used
object_idnumber
The new feature's object ID
successtrue/false
Always true once added
Example output
{
  "global_id": "{8F7A0C1E-2B4D-4E6F-9A1B-3C5D7E9F0A2B}",
  "layer": {
    "item_id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "name": "Service Requests",
    "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0"
  },
  "object_id": 43,
  "success": true
}

Count features

Count a layer's features, all of them or those matching the filters.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.
Only where fieldmatch_fieldtext
Keep only features whose value in this field matches Equals.
Equalsmatch_valuetext
The value to keep, picked from the values the field holds or typed. For a date field, every feature on that day matches.
Date fielddate_fieldtext
The date the From and To dates apply to.
Fromfrom_datedate
Only features on or after this date, in the date field.
Toto_datedate
Only features on or before this date, in the date field.
Advanced filterwheretext
A filter in ArcGIS's SQL style, combined with the filters above, for example STATUS = 'Open' AND PRIORITY >= 2.

Outputs

countnumber
How many features match
layerobject
The layer the step used
wheretext
The filter ArcGIS ran
Example output
{
  "count": 128,
  "layer": {
    "item_id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "name": "Service Requests",
    "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0"
  },
  "where": "status = 'Open'"
}

Delete attachment

Delete one attachment from a feature.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.
Object IDobject_idnumberRequired
The feature's object ID, from 'Query features' or a trigger.
Attachment IDattachment_idnumberRequired
The attachment's ID, from 'List attachments'.

Outputs

attachment_idnumber
The attachment deleted
deletedtrue/false
Always true once deleted
object_idnumber
The feature
Example output
{
  "attachment_id": 8,
  "deleted": true,
  "object_id": 42
}

Delete features

Delete features from a layer by their object IDs.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.
Object IDsobject_idslistRequired
The object IDs of the features to delete, up to 100.

Outputs

countnumber
How many were deleted
deleted_idslist
The object IDs deleted
failedlist
Features ArcGIS refused to delete
layerobject
The layer the step used
Example output
{
  "count": 1,
  "deleted_ids": [
    43
  ],
  "failed": [],
  "layer": {
    "item_id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "name": "Service Requests",
    "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0"
  }
}

Find an address

Turn an address or place name into its latitude and longitude, with the address as ArcGIS standardizes it.

Inputs

AddressaddresstextRequired
The address or place, as someone would write it.
Countrycountrytext
Only matches in this country, by its code, such as USA or GB.
Resultsmax_resultsnumber
How many matches to return, best first, 1 to 20. Defaults to 1.From 1 to 20. Default: 1.
Keep the resultskeep_resultstrue/false
Turn on if you'll save the result (in a layer, a spreadsheet, a record). Esri's terms require it for saved results; it needs an API key and uses your organization's credits.Default: false.

Outputs

bestobject
The best match, or null
countnumber
How many matched
foundtrue/false
Whether anything matched
matcheslist
Every match, best first
Example output
{
  "best": {
    "address": "380 New York St, Redlands, CA, 92373, USA",
    "city": "Redlands",
    "country": "United States",
    "country_code": "USA",
    "county": "San Bernardino County",
    "latitude": 34.057241819826,
    "longitude": -117.194835113918,
    "match_type": "PointAddress",
    "postal_code": "92373",
    "region": "California",
    "score": 100,
    "short_address": "380 New York St",
    "street": "380 New York St"
  },
  "count": 1,
  "found": true,
  "matches": [
    {
      "address": "380 New York St, Redlands, CA, 92373, USA",
      "city": "Redlands",
      "country": "United States",
      "country_code": "USA",
      "county": "San Bernardino County",
      "latitude": 34.057241819826,
      "longitude": -117.194835113918,
      "match_type": "PointAddress",
      "postal_code": "92373",
      "region": "California",
      "score": 100,
      "short_address": "380 New York St",
      "street": "380 New York St"
    }
  ]
}

Find the address at a location

Turn a latitude and longitude into the nearest address.

Inputs

LatitudelatitudenumberRequired
The spot's latitude, such as 34.0572.From -90 to 90.
LongitudelongitudenumberRequired
The spot's longitude, such as -117.1948.From -180 to 180.
Keep the resultskeep_resultstrue/false
Turn on if you'll save the result (in a layer, a spreadsheet, a record). Esri's terms require it for saved results; it needs an API key and uses your organization's credits.Default: false.

Outputs

foundtrue/false
Whether an address was found
placeobject
The address, or null
Example output
{
  "found": true,
  "place": {
    "address": "380 New York St, Redlands, CA, 92373, USA",
    "city": "Redlands",
    "country": "United States",
    "country_code": "USA",
    "county": "San Bernardino County",
    "latitude": 34.057241819826,
    "longitude": -117.194835113918,
    "match_type": "PointAddress",
    "postal_code": "92373",
    "region": "California",
    "short_address": "380 New York St",
    "street": "380 New York St"
  }
}

Get feature

Read one feature by its object ID, with all its fields and its location.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.
Object IDobject_idnumberRequired
The feature's object ID, from 'Query features' or a trigger.
Locationgeometrytext
How each feature's location is returned. Defaults to latitude and longitude.One of: none (Leave it out), location (Latitude and longitude), geojson (Full shape (GeoJSON)). Default: location.

Outputs

featureobject
One feature: its fields by name (dates as ISO 8601, choices by name), then latitude and longitude, or geometry as GeoJSON
layerobject
The layer the step used
object_idnumber
Its object ID
Example output
{
  "feature": {
    "CreationDate": "2026-10-28T15:04:11Z",
    "EditDate": "2026-10-28T15:04:11Z",
    "description": "Deep pothole in the right lane",
    "latitude": 34.0572418,
    "longitude": -117.1948351,
    "objectid": 42,
    "request_type": "Pothole",
    "status": "Open"
  },
  "layer": {
    "item_id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "name": "Service Requests",
    "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0"
  },
  "object_id": 42
}

Get item

Read an item's details: title, type, owner, sharing, description, tags and address. For a Survey123 form, also the layer its answers are saved in.

Inputs

ItemitemtextRequired
The item's ID, or the address of its page.

Outputs

itemobject
The item
Example output
{
  "item": {
    "access": "org",
    "created": "2025-03-02T17:20:00Z",
    "description": "Potholes, graffiti and streetlights reported through the city's form.",
    "id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "item_page": "https://www.arcgis.com/home/item.html?id=4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "modified": "2026-10-28T15:04:11Z",
    "owner": "gis_admin_cityofx",
    "snippet": "Requests reported by residents",
    "survey_layer_url": "",
    "tags": [
      "311",
      "requests"
    ],
    "title": "Service Requests",
    "type": "Feature Service",
    "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer",
    "views": 1532
  }
}

Get layer details

Read a layer's fields (with each field's choices), what kind of shapes it holds, whether it can be edited, whether it keeps attachments and which fields record who changed what.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.

Outputs

layerobject
The layer
Example output
{
  "layer": {
    "can_add": true,
    "can_delete": true,
    "can_update": true,
    "capabilities": [
      "Create",
      "Delete",
      "Query",
      "Update",
      "Editing"
    ],
    "editor_tracking": {
      "created_field": "CreationDate",
      "creator_field": "Creator",
      "edited_field": "EditDate",
      "editor_field": "Editor"
    },
    "fields": [
      {
        "choices": [
          "Open",
          "Closed"
        ],
        "editable": true,
        "label": "Status",
        "name": "status",
        "required": false,
        "type": "choice"
      }
    ],
    "geometry_type": "point",
    "has_attachments": true,
    "item_id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "kind": "layer",
    "layer_id": 0,
    "max_record_count": 2000,
    "name": "Service Requests",
    "object_id_field": "objectid",
    "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0"
  }
}

Get my account

See who the API key acts as and in which organization. Without a key, says the connection reads public data only.

Inputs

None.

Outputs

organizationobject
The organization, or null without a key
signed_intrue/false
Whether an API key is connected
userobject
The user the key acts as, or null without a key
Example output
{
  "organization": {
    "id": "abc123XYZ",
    "name": "City of X GIS",
    "url": "https://cityofx.maps.arcgis.com"
  },
  "signed_in": true,
  "user": {
    "access": "org",
    "created": "2024-01-15T09:00:00Z",
    "description": "",
    "email": "jsmith@cityofx.gov",
    "full_name": "Jo Smith",
    "last_login": "2026-10-29T13:45:00Z",
    "role": "org_publisher",
    "user_type": "creatorUT",
    "username": "jsmith_cityofx"
  }
}

Get user

Read a user's profile: name, role and when they last signed in.

Inputs

User nameusernametextRequired
Their ArcGIS user name.

Outputs

userobject
An ArcGIS user
Example output
{
  "user": {
    "access": "org",
    "created": "2024-01-15T09:00:00Z",
    "description": "",
    "email": "jsmith@cityofx.gov",
    "full_name": "Jo Smith",
    "last_login": "2026-10-29T13:45:00Z",
    "role": "org_publisher",
    "user_type": "creatorUT",
    "username": "jsmith_cityofx"
  }
}

List attachments

List the photos and files attached to a feature, with a link to each.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.
Object IDobject_idnumberRequired
The feature's object ID, from 'Query features' or a trigger.

Outputs

attachmentslist
The attachments
countnumber
How many
layerobject
The layer the step used
object_idnumber
The feature
Example output
{
  "attachments": [
    {
      "content_type": "image/jpeg",
      "id": 7,
      "keywords": "photo",
      "name": "pothole.jpg",
      "size": 248951,
      "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0/42/attachments/7"
    }
  ],
  "count": 1,
  "layer": {
    "item_id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "name": "Service Requests",
    "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0"
  },
  "object_id": 42
}

List group members

List who is in a group: its owner, its managers and its members.

Inputs

GroupgrouptextRequired
The group. Pick one of yours, or give its ID.

Outputs

countnumber
How many people
memberslist
Everyone in the group
ownertext
The owner's user name
Example output
{
  "count": 2,
  "members": [
    {
      "role": "owner",
      "username": "gis_admin_cityofx"
    },
    {
      "role": "member",
      "username": "jsmith_cityofx"
    }
  ],
  "owner": "gis_admin_cityofx"
}

List layers and tables

List the layers and tables a feature layer holds, with their IDs and kinds.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.

Outputs

countnumber
How many
layerslist
Its layers and tables
service_urltext
The feature service's address
titletext
The item's title, empty for a pasted address
Example output
{
  "count": 1,
  "layers": [
    {
      "geometry_type": "point",
      "id": 0,
      "kind": "layer",
      "name": "Requests",
      "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0"
    }
  ],
  "service_url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer",
  "title": "Service Requests"
}

Query features

Get a layer's features (its rows, such as Survey123 responses), filtered by a field value, a date range or an advanced filter, sorted and with only the fields you choose.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.
Only where fieldmatch_fieldtext
Keep only features whose value in this field matches Equals.
Equalsmatch_valuetext
The value to keep, picked from the values the field holds or typed. For a date field, every feature on that day matches.
Date fielddate_fieldtext
The date the From and To dates apply to.
Fromfrom_datedate
Only features on or after this date, in the date field.
Toto_datedate
Only features on or before this date, in the date field.
Advanced filterwheretext
A filter in ArcGIS's SQL style, combined with the filters above, for example STATUS = 'Open' AND PRIORITY >= 2.
Fieldsfieldslist
The fields each feature includes. Leave empty for all of them.
Sort byorder_bytext
The field to sort by. Defaults to the order features were added.
Orderordertext
Ascending or descending. Defaults to ascending.One of: asc (Ascending (A to Z, oldest first, smallest first)), desc (Descending (Z to A, newest first, largest first)). Default: asc.
Locationgeometrytext
How each feature's location is returned. Defaults to latitude and longitude.One of: none (Leave it out), location (Latitude and longitude), geojson (Full shape (GeoJSON)). Default: location.
Limitlimitnumber
How many features to return, 1 to 2000. Defaults to 100.From 1 to 2000. Default: 100.
Skipoffsetnumber
How many matching features to skip first, for paging.At least 0.

Outputs

countnumber
How many were returned
featureslist
The features
has_moretrue/false
Whether more features match than were returned
layerobject
The layer the step used
wheretext
The filter ArcGIS ran
Example output
{
  "count": 1,
  "features": [
    {
      "CreationDate": "2026-10-28T15:04:11Z",
      "EditDate": "2026-10-28T15:04:11Z",
      "description": "Deep pothole in the right lane",
      "latitude": 34.0572418,
      "longitude": -117.1948351,
      "objectid": 42,
      "request_type": "Pothole",
      "status": "Open"
    }
  ],
  "has_more": false,
  "layer": {
    "item_id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "name": "Service Requests",
    "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0"
  },
  "where": "status = 'Open'"
}

Search groups

Find groups in your organization by name, or list the groups you're in.

Inputs

Search forquerytext
Words in the group's title or description.
Only my groupsonly_minetrue/false
Only groups the API key's account belongs to.Default: false.
Limitlimitnumber
How many groups to return, 1 to 100. Defaults to 20.From 1 to 100. Default: 20.

Outputs

countnumber
How many are in this page
groupslist
The groups found
totalnumber
How many match in all
Example output
{
  "count": 1,
  "groups": [
    {
      "access": "org",
      "created": "2024-02-01T10:00:00Z",
      "id": "9b2f0d7e3a914c1e5ab0f1d84e4b9c6a",
      "owner": "gis_admin_cityofx",
      "snippet": "Maps and layers for public works crews",
      "title": "Field crews"
    }
  ],
  "total": 1
}

Search items

Find maps, feature layers, Survey123 forms, apps and files in your organization, among your own items, in a group, or across public ArcGIS Online.

Inputs

Search forquerytext
Words to look for in titles, tags and descriptions.
Typeitem_typetext
Only items of this type. Defaults to any type.One of: any (Any type), feature_layer (Feature layers), survey (Survey123 forms), web_map (Web maps), app (Apps), dashboard (Dashboards), story (StoryMaps), csv (CSV files), excel (Excel files), pdf (PDF files). Default: any.
Search inscopetext
Where to look. Your organization by default, or all of public ArcGIS Online without an API key.One of: organization (My organization (the default with an API key)), mine (Only items I own), public (Everything public on ArcGIS Online (the default without a key)).
Groupgrouptext
Only items shared with this group.
Sortsorttext
The order of the results. Defaults to recently changed first.One of: modified (Recently changed first), created (Newest first), title (Title, A to Z), views (Most viewed first). Default: modified.
Limitlimitnumber
How many items to return, 1 to 100. Defaults to 20.From 1 to 100. Default: 20.
Start atstartnumber
The 'next_start' of an earlier search, for the next page.From 1 to 10000.

Outputs

countnumber
How many are in this page
itemslist
The items found
next_startnumber
Start at for the next page, null on the last
totalnumber
How many match in all
Example output
{
  "count": 1,
  "items": [
    {
      "access": "org",
      "created": "2025-03-02T17:20:00Z",
      "description": "Potholes, graffiti and streetlights reported through the city's form.",
      "id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
      "item_page": "https://www.arcgis.com/home/item.html?id=4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
      "modified": "2026-10-28T15:04:11Z",
      "owner": "gis_admin_cityofx",
      "snippet": "Requests reported by residents",
      "tags": [
        "311",
        "requests"
      ],
      "title": "Service Requests",
      "type": "Feature Service",
      "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer",
      "views": 1532
    }
  ],
  "next_start": null,
  "total": 1
}

Search users

Find people in your organization by name, user name or email.

Inputs

Search forquerytext
A name, user name or email. Leave empty for everyone.
Limitlimitnumber
How many users to return, 1 to 100. Defaults to 20.From 1 to 100. Default: 20.

Outputs

countnumber
How many are in this page
totalnumber
How many match in all
userslist
The users found
Example output
{
  "count": 1,
  "total": 1,
  "users": [
    {
      "access": "org",
      "created": "2024-01-15T09:00:00Z",
      "description": "",
      "email": "jsmith@cityofx.gov",
      "full_name": "Jo Smith",
      "last_login": "2026-10-29T13:45:00Z",
      "role": "org_publisher",
      "user_type": "creatorUT",
      "username": "jsmith_cityofx"
    }
  ]
}

Update feature

Change a feature's field values or move it. Only the fields you fill in change.

Inputs

Feature layerlayertextRequired
The feature layer: pick one of your organization's, or paste its address, its item ID or a Survey123 form's item ID.
Layerlayer_idtext
Which of its layers or tables. Leave empty for the first one.
Object IDobject_idnumberRequired
The feature's object ID, from 'Query features' or a trigger.
Fieldsattributesobject
The values to set, one per field. A date field takes a date, a field with choices takes one of them. Fields left empty are left as they are.
Latitudelatitudenumber
Where the feature is, for a layer of points, such as 34.0572.From -90 to 90.
Longitudelongitudenumber
Where the feature is, for a layer of points, such as -117.1948.From -180 to 180.

Outputs

layerobject
The layer the step used
object_idnumber
The feature changed
successtrue/false
Always true once changed
updated_fieldslist
The fields set
Example output
{
  "layer": {
    "item_id": "4c1e5ab0f1d84e4b9c6a8b2f0d7e3a91",
    "name": "Service Requests",
    "url": "https://services.arcgis.com/abc123/arcgis/rest/services/Requests/FeatureServer/0"
  },
  "object_id": 42,
  "success": true,
  "updated_fields": [
    "status"
  ]
}

On this page