COcouchbase
AI Agent Memory Allowed CIDRs

List Organization Agent Memory Allowed CIDRs

Changed on

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.

get/v4/organizations/{organizationId}/aiServices/agentMemoryAllowedCidrs

Request

Query parameters

projectIdstring uuid
Example:ffffffff-aaaa-1414-eeee-000000000000

The GUID4 ID of the project.

clusterIdstring uuid

Filter to fetch appservices belonging to a particular cluster.

Filters by clusterId.

agentMemoryServerIdstring uuid

Filters results to CIDRs belonging to this agent memory server.

pageinteger

Sets the page you would like to view.

perPageinteger

Sets the number of results you would like to have on each page.

sortBystring[]

Sets the order of how you would like to sort the results and the key you would like to order by. Valid fields to sort the results are: cidr, agentMemoryServerName, createdAt.

sortDirection'asc' | 'desc'

The order in which the items will be sorted.

Response

Successfully listed the allowed CIDRs for the organization.

Example response

{
  "data": [
    {
      "cidr": "10.1.2.3/32",
      "agentMemoryServerId": "a1b2c3d4-0000-4e57-b1f9-90bc2dcfa001",
      "agentMemoryServerName": "support-bot-memory",
      "clusterId": "13d745eb-9861-4e1d-88f5-eaacfef416a2",
      "clusterName": "my-cluster",
      "projectId": "a3b2c1d0-0000-4e57-b1f9-90bc2dcfa001",
      "projectName": "my-project"
    }
  ],
  "cursor": {
    "pages": {
      "page": 2,
      "next": 3,
      "previous": 1,
      "last": 10,
      "perPage": 10,
      "totalItems": 10
    },
    "hrefs": {
      "first": "https://cloud.couchbase.com/v4/users?page=1&perPage=10",
      "last": "https://cloud.couchbase.com/v4/users?page=1&perPage=10",
      "previous": "https://cloud.couchbase.com/v4/users?page=1&perPage=10",
      "next": "https://cloud.couchbase.com/v4/users?page=1&perPage=10"
    }
  }
}

Changes