Accept hub Terms of Service

curl --request POST \
  --url https://api.member.dev/api/v1/contact-auth/me/hubs/{hub_id}/tos/accept \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "attributes": {
      "contact_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "hub_id": "<string>",
      "notification_prefs": {},
      "team_id": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "ban_reason": "<string>",
      "banned_at": "2023-11-07T05:31:56Z",
      "last_seen_at": "2023-11-07T05:31:56Z",
      "onboarded_at": "2023-11-07T05:31:56Z",
      "role": "<string>",
      "tos_acceptance_required": false,
      "tos_accepted_at": "2023-11-07T05:31:56Z",
      "tos_accepted_version": "<string>",
      "welcome_email_sent": false
    },
    "id": "<string>",
    "type": "<string>",
    "links": {
      "self": "<string>"
    },
    "meta": {},
    "relationships": {}
  },
  "included": [
    "<unknown>"
  ],
  "links": {
    "self": "<string>"
  },
  "meta": {}
}

hub-memberships

Accept hub Terms of Service

Accept the Terms of Service for this hub.

Version-aware acceptance: stamps tos_accepted_at and records the current TOS version. A repeat call with the already-current version is a no-op (returns 200 with the existing timestamp). After an admin bumps the TOS version with require_acceptance=True, the next call re-stamps tos_accepted_at and re-emits TosAccepted.

Returns 401 when no valid contact JWT is present (enforced by get_current_contact dependency).

Returns 404 when the contact has no hub_memberships row for this hub, when the hub does not exist, or when the hub’s TOS gate is not enabled (enumeration-safe: the caller cannot distinguish these cases).

Emits TosAccepted on each acceptance (initial or re-acceptance after a version bump).

POST

api

contact-auth

hubs

{hub_id}

tos

Accept hub Terms of Service

curl --request POST \
  --url https://api.member.dev/api/v1/contact-auth/me/hubs/{hub_id}/tos/accept \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "attributes": {
      "contact_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "hub_id": "<string>",
      "notification_prefs": {},
      "team_id": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "ban_reason": "<string>",
      "banned_at": "2023-11-07T05:31:56Z",
      "last_seen_at": "2023-11-07T05:31:56Z",
      "onboarded_at": "2023-11-07T05:31:56Z",
      "role": "<string>",
      "tos_acceptance_required": false,
      "tos_accepted_at": "2023-11-07T05:31:56Z",
      "tos_accepted_version": "<string>",
      "welcome_email_sent": false
    },
    "id": "<string>",
    "type": "<string>",
    "links": {
      "self": "<string>"
    },
    "meta": {},
    "relationships": {}
  },
  "included": [
    "<unknown>"
  ],
  "links": {
    "self": "<string>"
  },
  "meta": {}
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

hub_id

string

required

Response

Successful Response

data

JsonApiResource[HubMembershipAttributes] · object

required

Show child attributes

included

any[] | null

links

JsonApiLinks · object

Show child attributes