🗃️Endpoints - Les tags

Lister les tags du Spot

List tags

get

/v1/tags

Query parameters

pageinteger | nullable

The page number in a paginated set of results

limitinteger | nullable

The limit of results to be returned per page

name[eq]string

Get a tag by a specific name

name[contains]string

Get a tag that contains this name

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://openapi.meltingspot.io/v1/tags'

200

400

200

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

Tags returned successfully

Créer un tag

Create a tag

post

/v1/tags

Body

namestringrequired

Name of the tag

emojistring

Emoji of the tag

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/tags' \
  --header 'Content-Type: application/json' \
  --data '{"name":"text"}'

201

400

201

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

The tag has been successfully created

Récupérer un tag

Get a tag

get

/v1/tags/{tagId}

Path parameters

tagIdstringrequired

The id of the tag

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://openapi.meltingspot.io/v1/tags/{tagId}'

200

400

404

200

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

Tag found and returned successfully

Supprimer un tag

Delete a tag

delete

/v1/tags/{tagId}

Path parameters

tagIdstringrequired

The id of the tag

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://openapi.meltingspot.io/v1/tags/{tagId}'

204

400

404

204

No body

Tag successfully deleted

Modifier un tag

Update a tag

put

/v1/tags/{tagId}

Path parameters

tagIdstringrequired

The id of the tag

Body

namestring

The name of the tag

emojistring | nullable

The emoji of the tag

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://openapi.meltingspot.io/v1/tags/{tagId}' \
  --header 'Content-Type: application/json'

200

400

404

200

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

Tag successfully updated

Assigner un tag à plusieurs membres

Assign spot members to a tag

post

/v1/tags/{tagId}/spotMembers~bulkAssign

Path parameters

tagIdstringrequired

The id of the tag

Body

spotMemberIdsstring[]required

The ids of the spotMembers to assign to the tag

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/tags/{tagId}/spotMembers~bulkAssign' \
  --header 'Content-Type: application/json' \
  --data '{"spotMemberIds":[null]}'

204

400

204

No body

Spot members successfully assigned

Désassigner un tag de plusieurs membres

Unassign spot members to a tag

post

/v1/tags/{tagId}/spotMembers~bulkUnassign

Path parameters

tagIdstringrequired

The id of the tag

Body

spotMemberIdsstring[]required

The ids of the spotMembers to unassign to the tag

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/tags/{tagId}/spotMembers~bulkUnassign' \
  --header 'Content-Type: application/json' \
  --data '{"spotMemberIds":[null]}'

204

400

204

No body

Spot members successfully unassigned

Lister les membres assignés à un tag

List Tagged members

get

/v1/tags/{tagId}/spotMembers

Path parameters

tagIdstringrequired

The id of the tag

Query parameters

pageinteger | nullable

The page number in a paginated set of results

limitinteger | nullable

The limit of results to be returned per page

email[in]string[]

The emails of spot member to include in the result

firstname[in]string[]

The firstnames of spot member to include in the result

lastname[in]string[]

The lastnames of spot member to include in the result

role[in]string · enum[]

The roles of spot member to include in the result

registrationDate[before]integer

Spot members where registration date is before a specific date (Unix timestamp format)

registrationDate[after]integer

Spot members where registration date is after a specific date (Unix timestamp format)

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://openapi.meltingspot.io/v1/tags/{tagId}/spotMembers'

200

400

200

{
  "total": 1,
  "items": [
    {
      "id": "text",
      "spotId": "text",
      "userId": "text",
      "email": "text",
      "title": "text",
      "customRoleId": "text",
      "firstname": "text",
      "lastname": "text",
      "warnings": 1,
      "role": "Member",
      "status": "Accepted",
      "embedBaseUrls": {
        "default": "text",
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Tagged members returned successfully

Créer plusieurs tags

Create multiple tags

post

/v1/tags~bulkCreate

Body

namestringrequired

Name of the tag

emojistring

Emoji of the tag

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://openapi.meltingspot.io/v1/tags~bulkCreate' \
  --header 'Content-Type: application/json' \
  --data '[{"name":"text"}]'

201

400

413

201

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

Tags has been successfully created