# Are there canonical names for API endpoints?

**URL:** <https://discuss.elastic.co/t/are-there-canonical-names-for-api-endpoints/84180>\
**Category:** Elasticsearch\
**Created:** [May 1, 2017, 8:19pm UTC](https://discuss.elastic.co/t/are-there-canonical-names-for-api-endpoints/84180 "2017-05-01T20:19:17Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![MerelyAPseudonym](https://avatars.discourse-cdn.com/v4/letter/m/977dab/32.png) [@MerelyAPseudonym](https://discuss.elastic.co/u/MerelyAPseudonym)\
**Post date:** [May 1, 2017, 8:19pm UTC](https://discuss.elastic.co/t/are-there-canonical-names-for-api-endpoints/84180/1 "2017-05-01T20:19:17Z")

</div>

Hi all,

Does each endpoint of Elasticsearch’s API have a canonical name? For example, let’s take the “PUT mapping API” described [here](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/indices-put-mapping.html). I’ve found two candidate names in the source code:

- [`indices.put_mapping`](https://github.com/elastic/elasticsearch/blob/v5.3.2/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_mapping.json#L2)
- [`indices:admin/mapping/put`](https://github.com/elastic/elasticsearch/blob/v5.3.2/core/src/main/java/org/elasticsearch/action/admin/indices/mapping/put/PutMappingAction.java#L30)

I'm wondering about all this because I'd like to be precise when discussing or documenting Elasticsearch clients and the server features that they may or may not support.

---

<div class="post-metadata">

**Author:** ![nik9000](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/nik9000/32/44947_2.png) [@nik9000](https://discuss.elastic.co/u/nik9000)\
**Post date:** [May 1, 2017, 8:38pm UTC](https://discuss.elastic.co/t/are-there-canonical-names-for-api-endpoints/84180/2 "2017-05-01T20:38:04Z")

</div>

Not really. We talk about them using the name of the action class. So the on you are linking we'd call "put mapping".

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\
**Post date:** [May 29, 2017, 8:47pm UTC](https://discuss.elastic.co/t/are-there-canonical-names-for-api-endpoints/84180/3 "2017-05-29T20:47:41Z")

</div>

This topic was automatically closed 28 days after the last reply. New replies are no longer allowed.