GET /api/v1/serverless/projects/security/{id}/link-candidates

The response contains the list of projects which can be linked to the specified Security project in a cross-project search configuration.

Path parameters

  • id string Required

    The ID of the project

    Format should match the following pattern: ^[a-z0-9]{32}$.

Query parameters

  • type string

    The type of projects to return as link candidates.

  • csp string

    The Cloud Service Provider to filter the link candidate projects by.

  • region string

    The region to filter the link candidate projects by.

  • name string

    The project name to filter the link candidates by.

  • alias string

    The project alias to filter the link candidates by.

Responses

  • 200 application/json

    The requested link candidate projects

    Hide response attribute Show response attribute object
    • items array[object] Required

      The linked candidates.

      Hide items attributes Show items attributes object
      • id string Required

        ID of the project.

        Format should match the following pattern: ^[a-z0-9]{32}$.

      • name string Required

        Descriptive name for a project.

        Minimum length is 1, maximum length is 255.

      • alias string Required

        A custom domain label compatible with RFC-1035 standards. Derived from the project name by default.

        Minimum length is 1, maximum length is 50. Format should match the following pattern: ^[a-zA-Z]{1}(?:[a-zA-Z0-9-]*[a-zA-Z0-9]{1})?$.

      • type string Required

        The type of the linked project

        Values are elasticsearch, observability, security, or workplaceai.

      • csp string Required
      • region string Required

        Unique human-readable identifier for a region in Elastic Cloud.

  • 404 application/json

    Not Found

    Hide response attribute Show response attribute object
    • errors array[object] Required

      An error response returned by the API.

      Hide errors attributes Show errors attributes object
      • message string Required

        A human-readable message of the error.

      • code string Required

        An identifier for this type of error.

GET /api/v1/serverless/projects/security/{id}/link-candidates
curl \
 --request GET 'https://api.elastic-cloud.com/api/v1/serverless/projects/security/{id}/link-candidates' \
 --header "Authorization: $API_KEY"