---
title: "POST /ListMemberships"
method: POST
path: "/ListMemberships"
---

# POST /ListMemberships

`POST /ListMemberships`

Returns a paginated list of membership summaries for the specified agent space within an application.

## Request body

- object
  - `applicationId` string, required — Application identifier.
  - `agentSpaceId` string, required — Unique identifier of the agent space.
  - `memberType` 'USER' | 'ALL' — Filter for member type in list operations.
  - `maxResults` integer — Maximum results for pagination.
  - `nextToken` string — Pagination token.

## Response `200`

Success

- ListMembershipsResponse — Response structure for listing members associated to an agent space.
  - `membershipSummaries` MembershipSummary[], required — The list of membership summaries.
    - `membershipId` string, required — The unique identifier of the membership.
    - `applicationId` string, required — The unique identifier of the application.
    - `agentSpaceId` string, required — The unique identifier of the agent space.
    - `memberType` 'USER', required — The type of member.
    - `config` object — The configuration for the membership.
      - `user` object — The user configuration for the membership.
        - `role` 'MEMBER' — The role assigned to the user. Currently, only MEMBER is supported.
    - `metadata` object — The metadata for the member.
      - `user` object — The user metadata for the member.
        - `username` string, required — The username of the user.
        - `email` string, required — The email address of the user.
    - `createdAt` string, date-time, required — The date and time the membership was created, in UTC format.
    - `updatedAt` string, date-time, required — The date and time the membership was last updated, in UTC format.
    - `createdBy` string, required — The identifier of the entity that created the membership.
    - `updatedBy` string, required — The identifier of the entity that last updated the membership.
  - `nextToken` string — A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.

---

[API](https://skmtc.net/aws/apis/securityagent.md) · [All operations](https://skmtc.net/aws/apis/securityagent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/securityagent/versions/cad56717d636/schema)