Teamspaces

A MASV Team is a way to organize users, security, and access. A Teamspace organizes a subset of Team users into a group for a project, client, department, and so on. With a Teamspace, a MASV Owner or Admin can:

• Control access to files sent to specific Portals.
• Create as many Teamspaces as needed per Team.
• Combine with Tags for an extra level of project tracking and billing.
• See Transfer History and billing in the MASV Web App for each Teamspace.

Create Teamspace

Method	Route
POST	/v1/teams/{team_id}/spaces

Headers

Name	Type	Required	Description
X-API-KEY	String	Yes	API key
Content-Type	String	Yes	Must be application/json

URL parameters

Name	Type	Required	Description
team_id	String	Yes	The ID of the Team to own the Teamspace

Body

Name	Type	Required	Description
name	String	Yes	Name of the Teamspace to create
member_ids	String[]	No	Membership ID(s) of Team members to add to the Teamspace

Request

curl -d '{"name": "$NAME", "member_ids": ["$M1_MEMBERSHIP_ID"]}' \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -X POST https://api.massive.app/v1/teams/$TEAM_ID/spaces

Response

Returns 201 Created:

{
  "id": "01E8TP2TJCTDNW11G67NKHQW5J",
  "name": "Marketing-space",
  "members": [
    {
      "id": "01H6CTJJJ19PVMR0J0JXGFK96D",
      "name": "Jim Halpert",
      "user_id": "01H6CTJJHQAKKWJ50Y635NNEPD"
    }
  ]
}

Get Teamspace

Method	Route
GET	/v1/spaces/{space_id}

Headers

Name	Type	Required	Description
X-API-KEY	String	Yes	API key

Request

curl -H "X-API-KEY: $API_KEY" \
  -X GET https://api.massive.app/v1/spaces/$SPACE_ID

Response

Returns 200 OK with the Teamspace object including its members.

List Teamspaces

Method	Route
GET	/v1.1/teams/{team_id}/spaces

Headers

Name	Type	Required	Description
X-API-KEY	String	Yes	API key

Query parameters

Name	Type	Required	Description
page	Integer	No	Page number. Default: 0
limit	Integer	No	Maximum records to fetch (50 max). Default: 50

Request

curl -H "X-API-KEY: $API_KEY" \
  -X GET https://api.massive.app/v1.1/teams/$TEAM_ID/spaces

Response

Returns 200 OK with a paginated list of Teamspaces.

Update Teamspace

Method	Route
PUT	/v1/spaces/{space_id}

Headers

Name	Type	Required	Description
X-API-KEY	String	Yes	API key
Content-Type	String	Yes	Must be application/json

Body

Name	Type	Required	Description
name	String	Yes	A new name for the Teamspace

Request

curl -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -X PUT https://api.massive.app/v1/spaces/$SPACE_ID \
  -d '{"name": "$NAME"}'

Response

Returns 200 OK with the updated Teamspace object.

Delete Teamspace

Method	Route
DELETE	/v1/spaces/{space_id}

Request

curl -X DELETE \
  -H "X-API-KEY: $API_KEY" \
  https://api.massive.app/v1/spaces/$SPACE_ID

Response

Returns 204 No Content.

List Teamspace packages

Method	Route
GET	/v1.1/spaces/{space_id}/packages

Headers

Name	Type	Required	Description
X-API-KEY	String	Yes	API key

Query parameters

Name	Type	Required	Description
page	Integer	No	Page number. Default: 0
limit	Integer	No	Maximum records (1–100)
sort	String	No	Sort ascending (fieldname) or descending (-fieldname)
status	String	No	Filter by state: new, finalized, expired, archived. Default: finalized, expired
name	String	No	Filter by package name (partial match)
sender	String	No	Filter by sender email
tags	String	No	Comma-separated tag IDs
created_at_start	String	No	Filter by creation date (YYYY-MM-DD)
created_at_end	String	No	Filter by creation date (YYYY-MM-DD)

Request

curl -H "X-API-KEY: $API_KEY" \
  -X GET "https://api.massive.app/v1.1/spaces/$SPACE_ID/packages?page=1&tags=engineering,marketing"

Response

Returns 200 OK with an array of package objects.

Add Team members to Teamspace

While Team Owners and Admins already have read and write access to all Teamspaces, Team members need to be added to access a Teamspace. A Team member can be added to multiple Teamspaces.

Method	Route
POST	/v1/spaces/{space_id}/members

Headers

Name	Type	Required	Description
X-API-KEY	String	Yes	API key
Content-Type	String	Yes	Must be application/json

Body

Name	Type	Required	Description
member_ids	String[]	Yes	Membership ID(s) of Team members to add

Request

curl -d '{"member_ids": ["$M1_MEMBERSHIP_ID"]}' \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -X POST https://api.massive.app/v1/spaces/$SPACE_ID/members

Response

Returns 201 Created with an array of Teamspace membership objects.

List Teamspace members

Method	Route
GET	/v1/spaces/{space_id}/members

Request

curl -H "X-API-KEY: $API_KEY" \
  -X GET https://api.massive.app/v1/spaces/$SPACE_ID/members

Response

Returns 200 OK with an array of Teamspace membership objects.

Remove members from Teamspace

Method	Route
DELETE	/v1/spaces/{space_id}/members/{teamspace_membership_id}

Request

curl -X DELETE \
  -H "X-API-KEY: $API_KEY" \
  https://api.massive.app/v1/spaces/$SPACE_ID/members/$TEAMSPACE_MEMBERSHIP_ID

Response

Returns 204 No Content.