---
title: "List Organization Agent Memory Allowed CIDRs"
method: GET
path: "/v4/organizations/{organizationId}/aiServices/agentMemoryAllowedCidrs"
tags: ["AI Agent Memory Allowed CIDRs"]
---

# List Organization Agent Memory Allowed CIDRs

`GET /v4/organizations/{organizationId}/aiServices/agentMemoryAllowedCidrs`

## Request

- Base URL: `https://cloudapi.cloud.couchbase.com`
- URL: `https://cloudapi.cloud.couchbase.com/v4/organizations/{organizationId}/aiServices/agentMemoryAllowedCidrs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/docs/v4/organizations/:organizationId/aiServices/agentMemoryAllowedCidrs/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists every allowed CIDR across the organization's agent memory servers that the caller has access to.

Use the `projectId`, `clusterId`, and `agentMemoryServerId` query parameters to narrow the results.
Each entry carries the project, cluster, and agent memory server the CIDR belongs to.

In order to access this endpoint, the provided API key must have at least one of the following roles:
- Organization Owner
- Project Creator
- Project Owner
- Project Manager
- Project Viewer
- Database Data Reader/Writer
- Database Data Reader
- Cluster Owner
- Cluster Data Writer
- Cluster Data Viewer

To learn more, see [Organization, Project, and Database Access Overview](https://docs.couchbase.com/cloud/organizations/organization-projects-overview.html).

## Query parameters

- `projectId` string, uuid
- `clusterId` string, uuid: Filter to fetch appservices belonging to a particular cluster.
- `agentMemoryServerId` string, uuid
- `page` integer
- `perPage` integer
- `sortBy` string[]
- `sortDirection` 'asc' | 'desc'

## Response `200`

Successfully listed the allowed CIDRs for the organization.

- ListOrganizationAgentMemoryAllowedCidrsResponse
  - `data` OrganizationAgentMemoryAllowedCidrData[], required: The allowed CIDRs across the organization's agent memory servers that the caller has access to. Empty if the query matched no entries.
    - `cidr` string, required: The allowed IPv4 CIDR block.
    - `agentMemoryServerId` string, uuid, required: The GUID4 ID of the agent memory server this CIDR belongs to.
    - `agentMemoryServerName` string, required: The name of the agent memory server.
    - `clusterId` string, uuid, required: The GUID4 ID of the cluster the agent memory server is deployed against.
    - `clusterName` string, required: The name of the cluster.
    - `projectId` string, uuid, required: The GUID4 ID of the project the agent memory server belongs to.
    - `projectName` string: The name of the project. Omitted if the project has been deleted.
    - `createdAt` string, date-time, required: The time the CIDR was added to the allowlist.
    - `createdByUserId` string, required: The ID of the user who added the CIDR.
    - `createdByUserName` string: The display name of the user who added the CIDR. Omitted if the user no longer exists.
  - `cursor` Cursor, required
    - `pages` Pages, required
      - `page` integer, required: Current page of results, starting from page 1.
      - `next` integer: Number of the next page of results. Not set on the last page.
      - `previous` integer: Number of the previous page of results. Not set on the first page.
      - `last` integer, required: Number of the last page of results.
      - `perPage` integer, required: Number of items displayed in each page.
      - `totalItems` integer, required: Total items found by the given query.
    - `hrefs` Hrefs, required
      - `first` string, uri, required: The base URL, endpoint, and path parameters required to fetch the first page of results.
      - `last` string, uri, required: The base URL, endpoint, and path parameters required to fetch the last page of results.
      - `previous` string, uri, required: The base URL, endpoint, and path parameters required to fetch the previous page of results. Empty if there is no previous page.
      - `next` string, uri, required: The base URL, endpoint, and path parameters required to fetch the next page of results. Empty if there is no next page.

## Other responses

- `400`: Returned when we are unable to decode the recevied payload.
- `401`: The client does not have the valid credentials to access this resource.
- `403`: The client does not have the necessary permissions to access this resource.
- `404`: The requested resource was not found.
- `429`: Returned when the client exceeds the rate limit for the given APIKey.
- `500`: An unexpected error occurred in the server while processing this request.

## Changes

- **2026-10-19** `a5e88bcf71cb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/changes/v4/organizations/:organizationId/aiServices/agentMemoryAllowedCidrs/get.md)

---

[API](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api.md) - [All operations](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/revisions/a5e88bcf71cb?raw)