🗃️Endpoints - Les tags

Lister les tags du Spot

List tags

GEThttps://openapi.meltingspot.io/v1/tags

Query parameters

Response

200400

Tags returned successfully

Body

application/json

items*array of TagApiResponse (object)

The items found

total*integer

The total number of items found

Request

JavaScriptCurlPython

const response = await fetch('https://openapi.meltingspot.io/v1/tags', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "emoji": "text"
    }
  ]
}

Créer un tag

Create a tag

POSThttps://openapi.meltingspot.io/v1/tags

Body

application/json

name*string

Name of the tag

emojistring

Emoji of the tag

Response

201400

The tag has been successfully created

Body

application/json

id*string

The id of the tag.

name*string

The name of the tag.

emojistring

The emoji of the tag

order*integer

The order of the tag.

Request

JavaScriptCurlPython

const response = await fetch('https://openapi.meltingspot.io/v1/tags', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text"
    }),
});
const data = await response.json();

Response

201

{
  "id": "text",
  "name": "text",
  "emoji": "text"
}

Récupérer un tag

Get a tag

GEThttps://openapi.meltingspot.io/v1/tags/{tagId}

Path parameters

tagId*string

The id of the tag

Response

200400404

Tag found and returned successfully

Body

application/json

id*string

The id of the tag.

name*string

The name of the tag.

emojistring

The emoji of the tag

order*integer

The order of the tag.

Request

JavaScriptCurlPython

const response = await fetch('https://openapi.meltingspot.io/v1/tags/{tagId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "id": "text",
  "name": "text",
  "emoji": "text"
}

Supprimer un tag

Delete a tag

DELETEhttps://openapi.meltingspot.io/v1/tags/{tagId}

Path parameters

tagId*string

The id of the tag

Response

204400404

Tag successfully deleted

Request

JavaScriptCurlPython

const response = await fetch('https://openapi.meltingspot.io/v1/tags/{tagId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Modifier un tag

Update a tag

PUThttps://openapi.meltingspot.io/v1/tags/{tagId}

Path parameters

tagId*string

The id of the tag

Body

application/json

namestring

The name of the tag

emojinullable string

The emoji of the tag

Response

200400404

Tag successfully updated

Body

application/json

id*string

The id of the tag.

name*string

The name of the tag.

emojistring

The emoji of the tag

order*integer

The order of the tag.

Request

JavaScriptCurlPython

const response = await fetch('https://openapi.meltingspot.io/v1/tags/{tagId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "id": "text",
  "name": "text",
  "emoji": "text"
}

Assigner un tag à plusieurs membres

Assign spot members to a tag

POSThttps://openapi.meltingspot.io/v1/tags/{tagId}/spotMembers~bulkAssign

Path parameters

tagId*string

The id of the tag

Body

application/json

spotMemberIds*array of string

The ids of the spotMembers to assign to the tag

Response

204400

Spot members successfully assigned

Request

JavaScriptCurlPython

const response = await fetch('https://openapi.meltingspot.io/v1/tags/{tagId}/spotMembers~bulkAssign', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "spotMemberIds": [
        "text"
      ]
    }),
});
const data = await response.json();

Désassigner un tag de plusieurs membres

Unassign spot members to a tag

POSThttps://openapi.meltingspot.io/v1/tags/{tagId}/spotMembers~bulkUnassign

Path parameters

tagId*string

The id of the tag

Body

application/json

spotMemberIds*array of string

The ids of the spotMembers to unassign to the tag

Response

204400

Spot members successfully unassigned

Request

JavaScriptCurlPython

const response = await fetch('https://openapi.meltingspot.io/v1/tags/{tagId}/spotMembers~bulkUnassign', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "spotMemberIds": [
        "text"
      ]
    }),
});
const data = await response.json();

Lister les membres assignés à un tag

List Tagged members

GEThttps://openapi.meltingspot.io/v1/tags/{tagId}/spotMembers

Path parameters

tagId*string

The id of the tag

Query parameters

Response

200400

Tagged members returned successfully

Body

application/json

items*array of SpotMemberApiResponse (object)

The items found

total*integer

The total number of items found

Request

JavaScriptCurlPython

const response = await fetch('https://openapi.meltingspot.io/v1/tags/{tagId}/spotMembers', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "items": [
    {
      "id": "text",
      "spotId": "text",
      "userId": "text",
      "email": "text",
      "title": "text",
      "role": "Member",
      "status": "Accepted",
      "firstname": "text",
      "lastname": "text",
      "warnings": 0
    }
  ]
}

Créer plusieurs tags

Create multiple tags

POSThttps://openapi.meltingspot.io/v1/tags~bulkCreate

Body

application/json

name*string

Name of the tag

emojistring

Emoji of the tag

Response

201400413

Tags has been successfully created

Body

application/json

created*array of TagApiResponse (object)

The tags that were created.

failed*array of CreateTagApiBody (object)

The tags that failed to be created.

Request

JavaScriptCurlPython

const response = await fetch('https://openapi.meltingspot.io/v1/tags~bulkCreate', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {
        "name": "text"
      }
    ]),
});
const data = await response.json();

Response

201

{
  "created": [
    {
      "id": "text",
      "name": "text",
      "emoji": "text"
    }
  ],
  "failed": [
    {
      "name": "text",
      "emoji": "text"
    }
  ]
}