---
title: "Set OpenSearch ACL configuration"
method: POST
path: "/project/{project}/service/{service_name}/opensearch/acl"
tags: ["Service:_OpenSearch"]
---

# Set OpenSearch ACL configuration

`POST /project/{project}/service/{service_name}/opensearch/acl`

## Path parameters

- `project` string, required
- `service_name` string, required

## Request body

- ServiceOpenSearchAclSetRequestBody — ServiceOpenSearchAclSetRequestBody
  - `opensearch_acl_config` object, required — OpenSearch ACL configuration
    - `acls` object[], required — List of OpenSearch ACLs
      - `rules` object[], required — OpenSearch rules
        - `index` string, required — OpenSearch index pattern
        - `permission` 'deny' | 'admin' | 'read' | 'readwrite' | 'write', required — OpenSearch permission
      - `username` string, required — Username
    - `enabled` boolean, required — Enable OpenSearch ACLs. When disabled authenticated service users have unrestricted access.

## Response `200`

Response

- ServiceOpenSearchAclSetResponse — ServiceOpenSearchAclSetResponse
  - `errors` object[] — List of errors occurred during request processing
    - `message` string, required — Printable error message
    - `more_info` string — URL to the documentation of the error
    - `status` integer, required — HTTP error status code
  - `message` string — Printable result of the request
  - `opensearch_acl_config` object, required — OpenSearch ACL configuration
    - `acls` object[], required — List of OpenSearch ACLs
      - `rules` object[], required — OpenSearch rules
        - `index` string, required — OpenSearch index pattern
        - `permission` 'deny' | 'admin' | 'read' | 'readwrite' | 'write', required — OpenSearch permission
      - `username` string, required — Username
    - `enabled` boolean, required — Enable OpenSearch ACLs. When disabled authenticated service users have unrestricted access.

---

[API](https://skmtc.net/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.net/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aiven/aiven-api-documentation/revisions/ecaeabf1da31/schema)