Zum Inhalt
Für Agenten

group_member_add

Add Group Member

Markdown Tools als JSON

Beschreibung

Adds user to group. Idempotent: a re-add returns the existing row unchanged. Refuses to add a user from a different account.

Zugriff

Zugriffsprofil: gated. Module: none. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja
group_id string Ja Group prefix ID (grp_…).
user string Ja User prefix ID or @handle.

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "group_id": {
      "type": "string",
      "description": "Group prefix ID (grp_…)."
    },
    "user": {
      "type": "string",
      "description": "User prefix ID or @handle."
    }
  },
  "required": [
    "account_id",
    "group_id",
    "user"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "group_id": {
      "type": "string"
    },
    "user_id": {
      "type": "string"
    },
    "added": {
      "type": "boolean",
      "description": "false when the user was already a member."
    }
  },
  "required": [
    "group_id",
    "user_id",
    "added"
  ],
  "type": "object"
}
Seiten