Teams service

The Teams API allows you to manage teams. You can create teams, update their information, and retrieve team data. Additionally, you can check the availability of team names and retrieve a list of teams. This API provides essential functionalities for organizing and collaborating with your application, making it easier to manage teams and access relevant team data.

Swagger docs link:

https://api.metaproprotocol.com/ms/teams/docs

Returns a list of Teams

GET..//v1/teams

Query parameters

Response

200400404

Body

application/json

results*array of Team (object)

count*number

Request

JavaScriptCurlPython

const response = await fetch('..//v1/teams', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400404

{
  "results": [
    {
      "teamId": "1aea9899-3f43-4ea6-852a-dddddbbc48c5",
      "logo": "https://image.com/logo",
      "banner": "https://image.com/banner",
      "description": "Full team description",
      "name": "Team name",
      "website": "https://example-team-page.com",
      "createdBy": "d4be5783-5373-4cca-ac96-1021277c3336",
      "socialMedia": "https://facebook.com/my-profile",
      "createdAt": "2022-05-25T16:17:01.797Z",
      "updatedAt": "2022-05-25T16:17:01.797Z",
      "members": [
        {
          "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
          "userId": "abc123456"
        }
      ]
    }
  ],
  "count": 0
}

Create a team

POST..//v1/teams

Authorization

Authorization

Header parameters

Body

application/json

logostring

Example: "https://image.com/logo"

bannerstring

Example: "https://image.com/banner"

descriptionstring

Example: "Full team description"

name*string

Example: "Team name"

websitestring

Example: "https://example-team-page.com"

socialMediaarray of object

Example: "https://facebook.com/my-profile"

Response

200201400401403404

Body

application/json

teamId*string

Example: "1aea9899-3f43-4ea6-852a-dddddbbc48c5"

logostring

Example: "https://image.com/logo"

bannerstring

Example: "https://image.com/banner"

descriptionstring

Example: "Full team description"

name*string

Example: "Team name"

website*string

Example: "https://example-team-page.com"

createdBy*string

Example: "d4be5783-5373-4cca-ac96-1021277c3336"

socialMediaarray of object

Example: "https://facebook.com/my-profile"

createdAt*string (date-time)

Example: "2022-05-25T16:17:01.797Z"

updatedAt*string (date-time)

Example: "2022-05-25T16:17:01.797Z"

members*array of object

Request

JavaScriptCurlPython

const response = await fetch('..//v1/teams', {
    method: 'POST',
    headers: {
      "Authorization": "text",
      "x-account-wallet": "text",
      "x-account-userid": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "Team name"
    }),
});
const data = await response.json();

Response

200201400401403404

{
  "teamId": "1aea9899-3f43-4ea6-852a-dddddbbc48c5",
  "logo": "https://image.com/logo",
  "banner": "https://image.com/banner",
  "description": "Full team description",
  "name": "Team name",
  "website": "https://example-team-page.com",
  "createdBy": "d4be5783-5373-4cca-ac96-1021277c3336",
  "socialMedia": "https://facebook.com/my-profile",
  "createdAt": "2022-05-25T16:17:01.797Z",
  "updatedAt": "2022-05-25T16:17:01.797Z",
  "members": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "userId": "abc123456"
    }
  ]
}

Update a team

PATCH..//v1/teams/{teamId}

Authorization

Authorization

Path parameters

teamId*string

Example: "1aea9899-3f43-4ea6-852a-dddddbbc48c5"

Header parameters

Body

application/json

logostring

Example: "https://image.com/logo"

bannerstring

Example: "https://image.com/banner"

descriptionstring

Example: "Full team description"

namestring

Example: "Team name"

websitestring

Example: "https://example-team-page.com"

socialMediaarray of object

Example: "https://facebook.com/my-profile"

members*array of Members (object)

Response

200400401403404

Body

application/json

teamId*string

Example: "1aea9899-3f43-4ea6-852a-dddddbbc48c5"

logostring

Example: "https://image.com/logo"

bannerstring

Example: "https://image.com/banner"

descriptionstring

Example: "Full team description"

name*string

Example: "Team name"

website*string

Example: "https://example-team-page.com"

createdBy*string

Example: "d4be5783-5373-4cca-ac96-1021277c3336"

socialMediaarray of object

Example: "https://facebook.com/my-profile"

createdAt*string (date-time)

Example: "2022-05-25T16:17:01.797Z"

updatedAt*string (date-time)

Example: "2022-05-25T16:17:01.797Z"

members*array of object

Request

JavaScriptCurlPython

const response = await fetch('..//v1/teams/{teamId}', {
    method: 'PATCH',
    headers: {
      "Authorization": "text",
      "x-account-wallet": "text",
      "x-account-userid": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "members": [
        {}
      ]
    }),
});
const data = await response.json();

Response

200400401403404

{
  "teamId": "1aea9899-3f43-4ea6-852a-dddddbbc48c5",
  "logo": "https://image.com/logo",
  "banner": "https://image.com/banner",
  "description": "Full team description",
  "name": "Team name",
  "website": "https://example-team-page.com",
  "createdBy": "d4be5783-5373-4cca-ac96-1021277c3336",
  "socialMedia": "https://facebook.com/my-profile",
  "createdAt": "2022-05-25T16:17:01.797Z",
  "updatedAt": "2022-05-25T16:17:01.797Z",
  "members": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "userId": "abc123456"
    }
  ]
}

Returns a Team data

GET..//v1/teams/{nameOrId}

Path parameters

nameOrId*string

Response

200400404

Body

application/json

teamId*string

Example: "1aea9899-3f43-4ea6-852a-dddddbbc48c5"

logostring

Example: "https://image.com/logo"

bannerstring

Example: "https://image.com/banner"

descriptionstring

Example: "Full team description"

name*string

Example: "Team name"

website*string

Example: "https://example-team-page.com"

createdBy*string

Example: "d4be5783-5373-4cca-ac96-1021277c3336"

socialMediaarray of object

Example: "https://facebook.com/my-profile"

createdAt*string (date-time)

Example: "2022-05-25T16:17:01.797Z"

updatedAt*string (date-time)

Example: "2022-05-25T16:17:01.797Z"

members*array of object

Request

JavaScriptCurlPython

const response = await fetch('..//v1/teams/{nameOrId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400404

{
  "teamId": "1aea9899-3f43-4ea6-852a-dddddbbc48c5",
  "logo": "https://image.com/logo",
  "banner": "https://image.com/banner",
  "description": "Full team description",
  "name": "Team name",
  "website": "https://example-team-page.com",
  "createdBy": "d4be5783-5373-4cca-ac96-1021277c3336",
  "socialMedia": "https://facebook.com/my-profile",
  "createdAt": "2022-05-25T16:17:01.797Z",
  "updatedAt": "2022-05-25T16:17:01.797Z",
  "members": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "userId": "abc123456"
    }
  ]
}

Checks name availability

GET..//v1/teams/{name}/availability

Path parameters

name*string

Example: "Team name"

Response

200400

Body

application/json

isAvailable*boolean

Request

JavaScriptCurlPython

const response = await fetch('..//v1/teams/{name}/availability', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "isAvailable": false
}

Returns a list of requested teams

GET..//v1/teams-search/{searchText}

Path parameters

searchText*string

Query parameters

Response

200400404

Body

application/json

results*array of Team (object)

count*number

Request

JavaScriptCurlPython

const response = await fetch('..//v1/teams-search/{searchText}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400404

{
  "results": [
    {
      "teamId": "1aea9899-3f43-4ea6-852a-dddddbbc48c5",
      "logo": "https://image.com/logo",
      "banner": "https://image.com/banner",
      "description": "Full team description",
      "name": "Team name",
      "website": "https://example-team-page.com",
      "createdBy": "d4be5783-5373-4cca-ac96-1021277c3336",
      "socialMedia": "https://facebook.com/my-profile",
      "createdAt": "2022-05-25T16:17:01.797Z",
      "updatedAt": "2022-05-25T16:17:01.797Z",
      "members": [
        {
          "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
          "userId": "abc123456"
        }
      ]
    }
  ],
  "count": 0
}