Teams

>>>

GET /api/v3/teams
List of teams

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": 2,
    "name": "team",
    "member_roles_count": 3,
    "admin_roles_count": 1,
    "users": [
      {
        "id": 1,
        "email": "vincent_muller@ferry.co",
        "first_name": "Dianna",
        "last_name": "Morar",
        "avatar_image": null,
        "status_role": "member"
      },
      ...
    ]
  },
  ...
]

Params

Param name Description
name
optional

Name of team for search

Validations:

  • Must be a String
sort_by
optional

Validations:

  • Must be one of: asc, desc.
sort_type
optional

Validations:

  • Must be one of: created_at, name.
>>>

GET /api/v3/teams/workspace_list
List of workspace teams

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": 2,
    "name": "team",
    "member_roles_count": 3,
    "admin_roles_count": 1,
    "users": [
      {
        "id": 1,
        "email": "vincent_muller@ferry.co",
        "first_name": "Dianna",
        "last_name": "Morar",
        "avatar_image": null,
        "status_role": "member"
      },
      ...
    ]
  },
  ...
]

Params

Param name Description
name
optional

Name of team for search

Validations:

  • Must be a String
sort_by
optional

Validations:

  • Must be one of: asc, desc.
sort_type
optional

Validations:

  • Must be one of: created_at, name.
>>>

POST /api/v3/teams
Create workspace team

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 ↑

{
  "user_emails": [
    "sample_email@gmail.com",
    ...
  ],
  "team": {
    "name": "team"
  }
}

Success response body ↑

{
  "id": 2,
  "name": "team",
  "member_roles_count": 3,
  "admin_roles_count": 1,
  "users": [
    {
      "id": 1,
      "email": "vincent_muller@ferry.co",
      "first_name": "Dianna",
      "last_name": "Morar",
      "avatar_image": null,
      "status_role": "member"
    },
    ...
  ]
}

Params

Param name Description
user_emails
optional

user_emails for inviting to team

Validations:

  • Must be an array of String
team
required

Validations:

  • Must be a Hash
team[name]
required

Name of team

Validations:

  • Must be a String
>>>

PUT /api/v3/teams/:id
Update workspace team

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": 2,
  "name": "updated_team"
}

Params

Param name Description
id
required

ID of current team

Validations:

  • Must be a Integer
team
required

Validations:

  • Must be a Hash
team[name]
required

Name of team

Validations:

  • Must be a String
>>>

DELETE /api/v3/teams/:id
Delete workspace team

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 ↑

{
  success: true
}

Params

Param name Description
id
required

ID of current team

Validations:

  • Must be a Integer
>>>

GET /api/v3/teams/list_for_sharing
List for sharing

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": "team",
    "share_with_team": true
  },
  ...
]

Params

Param name Description
type
optional

type of sharing object

Validations:

  • Must be one of: presets, media_files, folders, preset_folders.
id
optional

ID of sharing object

Validations:

  • Must be a Integer
>>>

GET /api/v3/teams/social_accounts_list_for_sharing
List for sharing social accounts

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": "team",
    "share_with_team": true
  },
  ...
]

Params

Param name Description
type
optional

type of sharing object

Validations:

  • Must be one of: twitter_accounts, facebook_pages, instagram_accounts.
id
optional

ID of sharing object

Validations:

  • Must be a Integer