GET /api/v2/workspaces
Show workspace

Request headers

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Success response body

{
  "id": 1,
  "name": "Scrum Launch",
  "available_users_count": 30,
  "can_add_new_users": true,
  "can_invite_users_count": 29,
  "workspace_roles": [
    {
      "id": 1,
      "name": "super_admin",
      ,
      "users": [
        {
          "id": 1,
          "first_name": "Vadim",
          "last_name": "Kruchina",
          "email": "kruchina.vadim@gmail.com",
          "avatar_image": null,
          "invite_status": "acceped",
          "invite_id": 1
        }
      ]
    },
    {
      "id": 2,
      "name": "creative_admin",
      "users": []
    },
    {
      "id": 3,
      "name": "creator",
      "users": []
    },
    {
      "id": 4,
      "name": "editor",
      "users": [
        {
          "id": 2,
          "first_name": "Vadim",
          "last_name": "Kruchina",
          "email": "kruchina.vadim+1@gmail.com",
          "avatar_image": null,
          "invite_status": "pending",
          "invite_id": 1
        }
      ]
    }
  ]
}

PUT api/v2/workspaces
Update workspace. Last Update: 02/08/23

Request headers

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Request body example

For update name
{
  "workspace": {
    "name": "name"
  }
}
For update organization_type
{
  "workspace": {
    "organization_type": "ORGANIZATION_TYPE",
    "custom_organization_type": "CUSTOM_ORGANIZATION_TYPE"
  }
}

Success response body

{
  "id": 1,
  "name": "name"
}

Params

Param name Description
workspace
required

Validations:

  • Must be a Hash

workspace[name]
optional

Validations:

  • Must be a String

workspace[organization_type]
optional

Validations:

  • Must be one of: Public High School, Private High School, College/University, Club/Youth Sports, Other/Not Listed.

workspace[custom_organization_type]
optional

Validations:

  • Must be a String


GET api/v2/workspaces/can_use_site
Check workspace can use site?

Request headers

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Success response body

{
  "can_use_site": true
}

Errors

Code Description Metadata
forbidden
can_use_site: false