Delete a team member

DELETE

teams

{team_id}

members

{user_id}

Remove a team member

curl --request DELETE \
  --url https://api.superthread.com/v1/teams/{team_id}/members/{user_id}

{
  "removed_member": {
    "id": "u-dsu0j19",
    "email": "[email protected]",
    "email_confirmed": true,
    "first_name": "John",
    "last_name": "Smith",
    "display_name": "pete",
    "profile_image": "https://s3..../avatar.png",
    "thumbnail_image": "https://s3..../avatar.png",
    "color": "red",
    "status": "active",
    "teams": [
      {
        "archived": {
          "user_id": "uDsu0j19",
          "time_archived": 1608742037016
        },
        "id": "t-iwquhs1",
        "sub_domain": "apple",
        "team_name": "Apple Backend",
        "company_name": "Apple Inc",
        "email_domain": "apple.com",
        "creator_user_id": "u-dsu0j19",
        "time_created": 1608742037016,
        "time_updated": 1608742037016,
        "trashed": {
          "user_deleted": {
            "user_id": "uDsu0j19",
            "type": "user",
            "source": {
              "type": "oauth",
              "client_id": "oczapier",
              "import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
              "agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
              "email_addr": "[email protected]",
              "email_verified": false
            }
          },
          "time_deleted": 1608742037016
        },
        "logo": {
          "type": "image",
          "src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
          "id": "<string>",
          "blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
          "color": "black",
          "emoji": "thumbsup"
        },
        "subscription_plan_id": "free",
        "features": [
          {
            "id": "<string>",
            "enabled": true,
            "time_enabled": 1608742037016,
            "toggleable": true
          }
        ],
        "limits": [
          {
            "id": "<string>",
            "limit_value": "2"
          }
        ],
        "team_description": "Technology company",
        "role": "owner",
        "status": "active",
        "flags": [
          "ai0"
        ]
      }
    ],
    "time_created": 1608742037016,
    "time_updated": 1608742037016,
    "current_project": "<string>",
    "timezone_id": "America/Los_Angeles",
    "autodetect_timezone_id": true,
    "locale": "en",
    "transcription_keywords": [
      "<string>"
    ],
    "job_description": "software engineer",
    "role": "owner"
  }
}

Path Parameters

team_id

string

required

Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a "Workspace".

user_id

string

required

User ID is an alphanumerical string that identifies a user.

Response

removed team member

removed_member

User · object

Show child attributes

removed_member.id

string

Example:

"u-dsu0j19"

removed_member.email

string

Example:

"[email protected]"

removed_member.email_confirmed

boolean

Example:

true

removed_member.first_name

string

Example:

"John"

removed_member.last_name

string

Example:

"Smith"

removed_member.display_name

string

Example:

"pete"

removed_member.profile_image

string

Example:

"https://s3..../avatar.png"

removed_member.thumbnail_image

string

Example:

"https://s3..../avatar.png"

removed_member.color

enum<string>

Available options:

red,

darkred,

green,

darkgreen,

blue,

darkblue

Example:

"red"

removed_member.status

enum<string>

Available options:

active

removed_member.teams

object[]

Show child attributes

removed_member.teams.archived

object

Show child attributes

removed_member.teams.archived.user_id

string

Example:

"uDsu0j19"

removed_member.teams.archived.time_archived

integer<int64>

unix timestamp in seconds

Example:

1608742037016

removed_member.teams.id

string

Example:

"t-iwquhs1"

removed_member.teams.sub_domain

string

Example:

"apple"

removed_member.teams.team_name

string

Example:

"Apple Backend"

removed_member.teams.company_name

string

Example:

"Apple Inc"

removed_member.teams.email_domain

string

Example:

"apple.com"

removed_member.teams.creator_user_id

string

Example:

"u-dsu0j19"

removed_member.teams.time_created

integer<int64>

unix timestamp in seconds

Example:

1608742037016

removed_member.teams.time_updated

integer<int64>

unix timestamp in seconds

Example:

1608742037016

removed_member.teams.trashed

object

Show child attributes

removed_member.teams.trashed.user_deleted

Actor · object

describes a user or robot that created or updated a resource

Show child attributes

removed_member.teams.trashed.user_deleted.user_id

string

Example:

"uDsu0j19"

removed_member.teams.trashed.user_deleted.type

enum<string>

default:user

Available options:

user,

robot,

system

Example:

"user"

removed_member.teams.trashed.user_deleted.source

ActorSource · object

describes the source of an actor

Show child attributes

removed_member.teams.trashed.user_deleted.source.type

enum<string>

Available options:

oauth,

import,

email,

agent

Example:

"oauth"

removed_member.teams.trashed.user_deleted.source.client_id

string

client ID if the resource was created via oauth2 app

Example:

"oczapier"

removed_member.teams.trashed.user_deleted.source.import_id

string

import ID if the resource was created by an import

Example:

"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197"

removed_member.teams.trashed.user_deleted.source.agent_id

string

agent ID if the resource was created by an agent

Example:

"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197"

removed_member.teams.trashed.user_deleted.source.email_addr

string

email address if the resource was created via an email

Example:

"[email protected]"

removed_member.teams.trashed.user_deleted.source.email_verified

boolean

whether the email sender was verified

Example:

false

removed_member.teams.trashed.time_deleted

integer<int64>

unix timestamp in seconds

Example:

1608742037016

removed_member.teams.logo

object

Show child attributes

removed_member.teams.logo.type

enum<string>

required

Available options:

image,

icon,

emoji

removed_member.teams.logo.src

string

required

Depending on the type this can be a URL, base64 image data, emoji unicode or an icon name

Example:

"data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="

removed_member.teams.logo.id

string

Unique identifier for the image (optional).

removed_member.teams.logo.blurhash

string

Example:

"LEHV6nWB2yk8pyoJadR*.7kCMdnj"

removed_member.teams.logo.color

string

Example:

"black"

removed_member.teams.logo.emoji

string

Emoji string ID

Example:

"thumbsup"

removed_member.teams.subscription_plan_id

string

Example:

"free"

removed_member.teams.features

object[]

Show child attributes

removed_member.teams.features.id

string

unique identifier for the feature

removed_member.teams.features.enabled

boolean

Example:

true

removed_member.teams.features.time_enabled

integer<int64>

unix timestamp in seconds

Example:

1608742037016

removed_member.teams.features.toggleable

boolean

Example:

true

removed_member.teams.limits

object[]

Show child attributes

removed_member.teams.limits.id

string

unique identifier for the limit

removed_member.teams.limits.limit_value

string

Example:

"2"

removed_member.teams.team_description

string

Example:

"Technology company"

removed_member.teams.role

enum<string>

Available options:

owner,

admin,

member,

guest,

guestReader

removed_member.teams.status

enum<string>

Available options:

active,

invited,

inactive,

imported

removed_member.teams.flags

string[]

list of feature flags enabled for the user in the team

removed_member.time_created

integer<int64>

unix timestamp in seconds

Example:

1608742037016

removed_member.time_updated

integer<int64>

unix timestamp in seconds

Example:

1608742037016

removed_member.current_project

string

removed_member.timezone_id

string

user's timezone

Example:

"America/Los_Angeles"

removed_member.autodetect_timezone_id

boolean | null

whether the user's timezone is automatically set by the superthread app

Example:

true

removed_member.locale

string

user's preferred locale

Example:

"en"

removed_member.transcription_keywords

string[]

removed_member.job_description

string

Example:

"software engineer"

removed_member.role

enum<string>

Available options:

owner,

admin,

member,

guest,

guestReader

Create a cardThis endpoint allows you to create a new card in a specified team workspace by providing a set of required and optional parameters. Key required fields include: - `title`: The name of the card - `list_id`: The ID of the list where the card will be placed - `board_id` or `sprint_id`: One of these fields must be provided to specify where the card belongs to The card's content has a character limit of 102400, and timestamps like `due_date` and `start_date` are specified as Unix timestamps in seconds. Enum fields include status (committed, started, completed, cancelled) and icon types (image, emoji, icon).

⌘I

Remove a team member

curl --request DELETE \
  --url https://api.superthread.com/v1/teams/{team_id}/members/{user_id}

{
  "removed_member": {
    "id": "u-dsu0j19",
    "email": "[email protected]",
    "email_confirmed": true,
    "first_name": "John",
    "last_name": "Smith",
    "display_name": "pete",
    "profile_image": "https://s3..../avatar.png",
    "thumbnail_image": "https://s3..../avatar.png",
    "color": "red",
    "status": "active",
    "teams": [
      {
        "archived": {
          "user_id": "uDsu0j19",
          "time_archived": 1608742037016
        },
        "id": "t-iwquhs1",
        "sub_domain": "apple",
        "team_name": "Apple Backend",
        "company_name": "Apple Inc",
        "email_domain": "apple.com",
        "creator_user_id": "u-dsu0j19",
        "time_created": 1608742037016,
        "time_updated": 1608742037016,
        "trashed": {
          "user_deleted": {
            "user_id": "uDsu0j19",
            "type": "user",
            "source": {
              "type": "oauth",
              "client_id": "oczapier",
              "import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
              "agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
              "email_addr": "[email protected]",
              "email_verified": false
            }
          },
          "time_deleted": 1608742037016
        },
        "logo": {
          "type": "image",
          "src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
          "id": "<string>",
          "blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
          "color": "black",
          "emoji": "thumbsup"
        },
        "subscription_plan_id": "free",
        "features": [
          {
            "id": "<string>",
            "enabled": true,
            "time_enabled": 1608742037016,
            "toggleable": true
          }
        ],
        "limits": [
          {
            "id": "<string>",
            "limit_value": "2"
          }
        ],
        "team_description": "Technology company",
        "role": "owner",
        "status": "active",
        "flags": [
          "ai0"
        ]
      }
    ],
    "time_created": 1608742037016,
    "time_updated": 1608742037016,
    "current_project": "<string>",
    "timezone_id": "America/Los_Angeles",
    "autodetect_timezone_id": true,
    "locale": "en",
    "transcription_keywords": [
      "<string>"
    ],
    "job_description": "software engineer",
    "role": "owner"
  }
}

Get started

Users

Cards

Projects

Notes

Pages

Comments

Boards

Sprints

Spaces

Search

Path Parameters

Response