Teams

Overview

Teams let you organize account members into groups with shared access to specific templates. Each team has members with assigned roles and a set of template access grants. Users can belong to multiple teams.

Team Object

The compact team representation returned in list endpoints:

{
  "id": 7,
  "name": "Legal Department",
  "description": "Handles all contract and NDA templates",
  "member_count": 5,
  "created_at": "2026-03-15T09:00:00Z"
}

The full team representation includes members and template access grants:

{
  "id": 7,
  "name": "Legal Department",
  "description": "Handles all contract and NDA templates",
  "member_count": 5,
  "created_at": "2026-03-15T09:00:00Z",
  "members": [
    {
      "id": 101,
      "email": "sarah@yourcompany.com",
      "first_name": "Sarah",
      "last_name": "Chen",
      "role": "admin",
      "added_at": "2026-03-15T09:00:00Z"
    },
    {
      "id": 102,
      "email": "james@yourcompany.com",
      "first_name": "James",
      "last_name": "Wilson",
      "role": "member",
      "added_at": "2026-03-15T09:05:00Z"
    },
    {
      "id": 103,
      "email": "maria@yourcompany.com",
      "first_name": "Maria",
      "last_name": "Garcia",
      "role": "member",
      "added_at": "2026-03-16T10:00:00Z"
    },
    {
      "id": 104,
      "email": "david@yourcompany.com",
      "first_name": "David",
      "last_name": "Park",
      "role": "member",
      "added_at": "2026-03-17T14:30:00Z"
    },
    {
      "id": 105,
      "email": "lisa@yourcompany.com",
      "first_name": "Lisa",
      "last_name": "Thompson",
      "role": "member",
      "added_at": "2026-03-18T08:15:00Z"
    }
  ],
  "template_accesses": [
    {
      "template_id": 201,
      "template_name": "Standard NDA",
      "access_level": "full",
      "granted_at": "2026-03-15T09:10:00Z"
    },
    {
      "template_id": 202,
      "template_name": "Employment Contract",
      "access_level": "full",
      "granted_at": "2026-03-15T09:10:00Z"
    },
    {
      "template_id": 205,
      "template_name": "Vendor Agreement",
      "access_level": "read_only",
      "granted_at": "2026-03-20T11:00:00Z"
    }
  ]
}

Member Roles

Role	Permissions
`admin`	Add/remove members, manage template access, edit team settings, delete team
`member`	View team templates, create submissions from team templates

List Teams

curl -X GET "https://spitshake.io/api/teams" \
  -H "X-Auth-Token: YOUR_API_TOKEN"

[
  {
    "id": 7,
    "name": "Legal Department",
    "description": "Handles all contract and NDA templates",
    "member_count": 5,
    "created_at": "2026-03-15T09:00:00Z"
  },
  {
    "id": 8,
    "name": "Sales Team",
    "description": "Proposals and order forms",
    "member_count": 12,
    "created_at": "2026-03-20T14:00:00Z"
  },
  {
    "id": 9,
    "name": "Human Resources",
    "description": "Onboarding and benefits documents",
    "member_count": 3,
    "created_at": "2026-04-01T08:00:00Z"
  }
]

Get Team

Retrieve the full team object including members and template accesses.

curl -X GET "https://spitshake.io/api/teams/7" \
  -H "X-Auth-Token: YOUR_API_TOKEN"

{
  "id": 7,
  "name": "Legal Department",
  "description": "Handles all contract and NDA templates",
  "member_count": 5,
  "created_at": "2026-03-15T09:00:00Z",
  "members": [
    {
      "id": 101,
      "email": "sarah@yourcompany.com",
      "first_name": "Sarah",
      "last_name": "Chen",
      "role": "admin",
      "added_at": "2026-03-15T09:00:00Z"
    },
    {
      "id": 102,
      "email": "james@yourcompany.com",
      "first_name": "James",
      "last_name": "Wilson",
      "role": "member",
      "added_at": "2026-03-15T09:05:00Z"
    },
    {
      "id": 103,
      "email": "maria@yourcompany.com",
      "first_name": "Maria",
      "last_name": "Garcia",
      "role": "member",
      "added_at": "2026-03-16T10:00:00Z"
    },
    {
      "id": 104,
      "email": "david@yourcompany.com",
      "first_name": "David",
      "last_name": "Park",
      "role": "member",
      "added_at": "2026-03-17T14:30:00Z"
    },
    {
      "id": 105,
      "email": "lisa@yourcompany.com",
      "first_name": "Lisa",
      "last_name": "Thompson",
      "role": "member",
      "added_at": "2026-03-18T08:15:00Z"
    }
  ],
  "template_accesses": [
    {
      "template_id": 201,
      "template_name": "Standard NDA",
      "access_level": "full",
      "granted_at": "2026-03-15T09:10:00Z"
    },
    {
      "template_id": 202,
      "template_name": "Employment Contract",
      "access_level": "full",
      "granted_at": "2026-03-15T09:10:00Z"
    },
    {
      "template_id": 205,
      "template_name": "Vendor Agreement",
      "access_level": "read_only",
      "granted_at": "2026-03-20T11:00:00Z"
    }
  ]
}

Create Team

curl -X POST "https://spitshake.io/api/teams" \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Finance Team",
    "description": "Invoice and payment document management"
  }'

{
  "id": 10,
  "name": "Finance Team",
  "description": "Invoice and payment document management",
  "member_count": 1,
  "created_at": "2026-04-08T15:00:00Z",
  "members": [
    {
      "id": 101,
      "email": "sarah@yourcompany.com",
      "first_name": "Sarah",
      "last_name": "Chen",
      "role": "admin",
      "added_at": "2026-04-08T15:00:00Z"
    }
  ],
  "template_accesses": []
}

{
  "error": "Team name is required and must be between 1 and 100 characters."
}

Update Team

curl -X PUT "https://spitshake.io/api/teams/10" \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Finance & Accounting",
    "description": "Invoice, payment, and audit document management"
  }'

{
  "id": 10,
  "name": "Finance & Accounting",
  "description": "Invoice, payment, and audit document management",
  "member_count": 1,
  "created_at": "2026-04-08T15:00:00Z"
}

Delete Team

Deleting a team removes all member associations and template access grants. It does not delete the members or templates themselves.

curl -X DELETE "https://spitshake.io/api/teams/10" \
  -H "X-Auth-Token: YOUR_API_TOKEN"

{
  "success": true,
  "message": "Team 'Finance & Accounting' has been deleted."
}

Add Member

curl -X POST "https://spitshake.io/api/teams/7/members" \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 106,
    "role": "member"
  }'

{
  "id": 106,
  "email": "alex@yourcompany.com",
  "first_name": "Alex",
  "last_name": "Rivera",
  "role": "member",
  "added_at": "2026-04-08T15:30:00Z"
}

{
  "error": "User alex@yourcompany.com is already a member of this team."
}

Update Member Role

curl -X PUT "https://spitshake.io/api/teams/7/members/102" \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "admin"
  }'

{
  "id": 102,
  "email": "james@yourcompany.com",
  "first_name": "James",
  "last_name": "Wilson",
  "role": "admin",
  "added_at": "2026-03-15T09:05:00Z"
}

Remove Member

curl -X DELETE "https://spitshake.io/api/teams/7/members/105" \
  -H "X-Auth-Token: YOUR_API_TOKEN"

{
  "success": true,
  "message": "User lisa@yourcompany.com has been removed from the team."
}

{
  "error": "Cannot remove the last admin from a team. Promote another member to admin first."
}

Grant Template Access

curl -X POST "https://spitshake.io/api/teams/7/template_accesses" \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": 210,
    "access_level": "full"
  }'

{
  "template_id": 210,
  "template_name": "Consulting Agreement",
  "access_level": "full",
  "granted_at": "2026-04-08T15:45:00Z"
}

Access Levels

Level	Create Submissions	View Submissions	Edit Template
`full`	Yes	Yes	Yes
`read_only`	No	Yes	No

Revoke Template Access

curl -X DELETE "https://spitshake.io/api/teams/7/template_accesses/205" \
  -H "X-Auth-Token: YOUR_API_TOKEN"

{
  "success": true,
  "message": "Template access for 'Vendor Agreement' has been revoked from this team."
}

Getting Started

Core Guides

Embedding

Features

Security & Compliance

Legal

Overview

Team Object

Member Roles

List Teams

Get Team

Create Team

Update Team

Delete Team

Add Member

Update Member Role

Remove Member

Grant Template Access

Access Levels

Revoke Template Access

​Overview

​Team Object

​Member Roles

​List Teams

​Get Team

​Create Team

​Update Team

​Delete Team

​Add Member

​Update Member Role

​Remove Member

​Grant Template Access

​Access Levels

​Revoke Template Access

Overview

Team Object

Member Roles

List Teams

Get Team

Create Team

Update Team

Delete Team

Add Member

Update Member Role

Remove Member

Grant Template Access

Access Levels

Revoke Template Access