---
title: "Get service ClientIntents by filter"
method: POST
path: "/access-graph/client-intents"
tags: ["access graph"]
---

# Get service ClientIntents by filter

`POST /access-graph/client-intents`

Get service ClientIntents by filter

## Request body

- object
  - `clusterIds` string[]
  - `featureFlags` InputFeatureFlags
    - `enableFindingsV2` boolean
    - `enableIAMIntentsSuggestions` boolean
    - `enableInternetIntentsSuggestions` boolean
    - `enableNetworkPoliciesInAccessGraph` boolean
    - `isCloudSecurityEnabled` boolean
    - `isCloudServicesDetectionEnabled` boolean
    - `useClientIntentsV2` boolean
    - `useTypedIntentsCTE` boolean
  - `filter` InputServiceFilter, required — Service filter
    - `clusterIds` string[]
    - `environmentIds` string[]
    - `integrationIds` string[]
    - `namespaceIds` string[]
    - `search` string
    - `serviceIds` string[]
    - `serviceType` object
  - `lastSeenAfter` string, date-time

## Response `200`

Get service ClientIntents by filter

- ClientIntentsFileRepresentation[]
  - `content` string, required
  - `fileName` string, required
  - `namespacedFileName` string, required
  - `rows` ClientIntentsRow[], required
    - `calledServerId` string
    - `diff` 'ADDED' | 'REMOVED'
    - `text` string, required
  - `service` object, required
    - `id` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `408` — Request Timeout
- `409` — Conflict
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `default`

## Changes

> 33 revisions in range; 1 could not be searched.

- **2025-04-16** `6b4369907cb8` — 3 info
  - added the new optional request property `featureFlags/enableIAMIntentsSuggestions`
  - added the new optional request property `featureFlags/enableInternetIntentsSuggestions`
  - added the non-success response with the status `408`
- **2024-12-30** `060fb77ea989` — 3 info
  - added the new optional request property `featureFlags/enableFindingsV2`
  - added the new optional request property `featureFlags/useTypedIntentsCTE`
  - added the required property `items/namespacedFileName` to the response with the `200` status
- **2024-12-08** `9e71135dff58` — 1 info
  - added the new optional request property `featureFlags/useClientIntentsV2`
- **2024-12-02** `aabf75d38bc6` — 1 info
  - endpoint added
- **2023-01-25** `059555a56f3f` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/otterize/apis/otterize-api-server/changes/access-graph/client-intents/post.md)

---

[API](https://skmtc.dev/otterize/apis/otterize-api-server.md) · [All operations](https://skmtc.dev/otterize/apis/otterize-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/otterize/otterize-api-server/revisions/ec9167824493/schema)