Accepts or declines an invitation to work on the specified project.


GET http(s)://hostname/api/user/replyInvitation

Request Parameters

Header field
Type Value
string Required. A valid access token from a registered MT-EQuAl account. The access token must have been issued on behalf of the current user.

Request parameters Type Value
hash string Required. The hash code associated with the request.

action {accepted,declined} Required. accepted: to accept the invitation; declined otherwise.


On success, the HTTP status code in the response header is 200 (OK) and the response is structured in JSON as follow:

  "header": {
    "date": "Date and time of the response generation process",
    "description": "Description of the invoked method or error message",
    "status": "status/error code"
  "result": {
    "role": "The type of role",
    "project": "The project identifier",
    "user": "The user identifier",
    "role_status": "The status of the role",
    "hash": "The new hash code associated to this role"

On error, the header status and description fields contain the error code and message, respectively.


curl -X GET "https://hostname/api/user/replyInvitation?hash=9a9e42e071b4e1247b45ec8c4bd45887&action=accepted" -H "X-Api-Key: {user access token}"
	"header": {
		"date": "Wednesday, 2016-06-08 12:00:44 Europe\/Paris",
		"description": "Accepts or declines an invitation to work on the specified project.",
		"status": "200"
	"result": {
       "role": "evaluator",
       "project": 8,
       "user": 3,
       "role_status": "accepted",
       "hash": "9a9e42e071b4e1247b45ec8c4bd45887"