DEdefaulr
GroupMemberships

List group memberships

Changed on

List the documents that have been shared with groups the authenticated user belongs to, along with the associated group membership records.

post/groupMemberships.list

Request

  • Base URL
    https://app.getoutline.com/api
  • URL
    https://app.getoutline.com/api/groupMemberships.list
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://app.getoutline.com/oauth/authorize
      Token URL: https://app.getoutline.com/oauth/token scopes: read, write

Request body

offsetnumber
limitnumber
groupIdstring uuid

Filter to memberships for a specific group.

Example request

{
  "limit": 25
}

Response

OK

Example response

{
  "data": {
    "groupMemberships": [
      {
        "createdBy": {
          "name": "Jane Doe"
        }
      }
    ],
    "groups": [
      {
        "name": "Engineering",
        "memberCount": 11
      }
    ],
    "documents": [
      {
        "title": "Welcome to Acme Inc",
        "icon": "🎉",
        "text": "…",
        "urlId": "hDYep1TPAM",
        "createdBy": {
          "name": "Jane Doe"
        },
        "updatedBy": {
          "name": "Jane Doe"
        },
        "deletedBy": {
          "name": "Jane Doe"
        }
      }
    ]
  },
  "pagination": {
    "limit": 25
  },
  "policies": [
    {
      "abilities": {
        "read": true,
        "update": true,
        "delete": false
      }
    }
  ]
}

Changes

  • 5ddf01ffba84Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      response property data/documents/items/url deprecated

  • c09b7940e788Revision changes
    • info

      added the optional property /// to the response with the status