---
title: "GroupMetadataSubscribe subscribes to a group metadata updates (types.or it can also retrieve the history)"
method: POST
path: "/protocol/v1/GroupMetadataSubscribe"
tags: ["ProtocolService"]
---

# GroupMetadataSubscribe subscribes to a group metadata updates (types.or it can also retrieve the history)

`POST /protocol/v1/GroupMetadataSubscribe`

## Request body

- TypesGroupMetadataSubscribeRequest
  - `group_pk` string, byte
  - `since` string, byte
  - `until` string, byte
  - `go_backwards` boolean

## Response `200`

A successful response.(streaming responses)

- object
  - `result` TypesGroupMetadataEvent
    - `event_context` TypesEventContext
      - `id` string, byte
      - `parent_ids` string[]
      - `group_pk` string, byte
    - `metadata` TypesGroupMetadata
      - `event_type` 'EventTypeUndefined' | 'EventTypeGroupMemberDeviceAdded' | 'EventTypeGroupDeviceSecretAdded' | 'EventTypeAccountGroupJoined' | 'EventTypeAccountGroupLeft' | 'EventTypeAccountContactRequestDisabled' | 'EventTypeAccountContactRequestEnabled' | 'EventTypeAccountContactRequestReferenceReset' | 'EventTypeAccountContactRequestOutgoingEnqueued' | 'EventTypeAccountContactRequestOutgoingSent' | 'EventTypeAccountContactRequestIncomingReceived' | 'EventTypeAccountContactRequestIncomingDiscarded' | 'EventTypeAccountContactRequestIncomingAccepted' | 'EventTypeAccountContactBlocked' | 'EventTypeAccountContactUnblocked' | 'EventTypeContactAliasKeyAdded' | 'EventTypeMultiMemberGroupAliasResolverAdded' | 'EventTypeMultiMemberGroupInitialMemberAnnounced' | 'EventTypeMultiMemberGroupAdminRoleGranted' | 'EventTypeGroupMetadataPayloadSent'
      - `payload` string, byte
      - `sig` string, byte
    - `event` string, byte
  - `error` RuntimeStreamError
    - `grpc_code` integer
    - `http_code` integer
    - `message` string
    - `http_status` string
    - `details` ProtobufAny[]
      - `type_url` string
      - `value` string, byte

## Other responses

- `default` — An unexpected error response

---

[API](https://skmtc.net/bump-sh-examples/apis/bertyprotocol-proto.md) · [All operations](https://skmtc.net/bump-sh-examples/apis/bertyprotocol-proto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bump-sh-examples/bertyprotocol-proto/versions/45fdd5adbf46/schema)