Skip to content

Update externalDocs links in _search endpoint #4222

Open
@lcawl

Description

@lcawl

We received feedback that the external documentation link in https://www.elastic.co/docs/api/doc/elasticsearch-serverless/operation/operation-search is a link to “Remote Clusters”, which is not relevant for Serverless. "...Instead, it seems like the “External documentation” link should be pointing to this page on pagination instead..."
This information is generated from https://github.com/elastic/elasticsearch-specification/blob/main/specification/_global/search/SearchRequest.ts, in particular the @ext_doc_id.

Since the same specifications are used to generate both the elasticsearch-openapi.json and elasticsearch-serverless-openapi.json, ideally we can find a link that is applicable to both (the external documentation object can contain only a single link). Otherwise if there are lots of links like this that must be deployment-specific we might need to re-open #2297

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions