Invitations

Invitations allow access to private workspaces. When an invitation is created, an email containing an access link to the workspace will be sent to the recipient. Invitations can be sent to email addresses under the allowed domains configured for a workspace.

Objects

Invitation

Path	JSON Type	Format	Description
`id`	`string`	Version 4 UUID	The invitation ID
`created`	`string`	ISO 8601 timestamp	The instant the invitation was created
`lastModified`	`string`	ISO 8601 timestamp	The instant the invitation was last modified
`status`	`string`	Invitation Status	The invitation status
`email`	`string`	Email address	The invitation target email address
`creator`	`object`	`Member`	The invitation creator
`workspace`	`object`	`Workspace`	The invitation target workspace

{
  "_embedded" : {
    "invitations" : [ {
      "id" : "a121542c-970a-44ab-a75d-af06b7ed7699",
      "created" : "2026-04-23T13:15:58.751395",
      "lastModified" : "2026-04-23T13:15:58.751396",
      "status" : "PENDING",
      "email" : "sit+invited1@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/a121542c-970a-44ab-a75d-af06b7ed7699",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/a121542c-970a-44ab-a75d-af06b7ed7699/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "22e8e4d5-1fc7-4acd-a622-e9d034fa869d",
      "created" : "2026-04-23T13:15:58.827131",
      "lastModified" : "2026-04-23T13:15:58.827132",
      "status" : "PENDING",
      "email" : "sit+invited2@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/22e8e4d5-1fc7-4acd-a622-e9d034fa869d",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/22e8e4d5-1fc7-4acd-a622-e9d034fa869d/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "698c4c95-6639-4a2b-8fb3-71a27d033550",
      "created" : "2026-04-23T13:15:58.906687",
      "lastModified" : "2026-04-23T13:15:58.906688",
      "status" : "PENDING",
      "email" : "sit+invited3@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/698c4c95-6639-4a2b-8fb3-71a27d033550",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/698c4c95-6639-4a2b-8fb3-71a27d033550/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "3b8f491d-2c12-454f-aa3d-aeb797e605c9",
      "created" : "2026-04-23T13:16:01.305612",
      "lastModified" : "2026-04-23T13:16:01.305612",
      "status" : "PENDING",
      "email" : "sit+prod+2@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/3b8f491d-2c12-454f-aa3d-aeb797e605c9",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/3b8f491d-2c12-454f-aa3d-aeb797e605c9/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "061e2e73-b334-46e9-a6ac-158085c3bf8f",
      "created" : "2026-04-23T13:15:58.456531",
      "lastModified" : "2026-04-23T13:15:58.456531",
      "status" : "PENDING",
      "email" : "sit+test@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/061e2e73-b334-46e9-a6ac-158085c3bf8f",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/061e2e73-b334-46e9-a6ac-158085c3bf8f/revoked",
          "type" : "PUT"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/workspaces/94231300-c0ae-4956-bc27-3546887551dd/invitations?page=0&size=20"
    }
  },
  "page" : {
    "size" : 20,
    "totalElements" : 5,
    "totalPages" : 1,
    "number" : 0
  }
}

Formats

Invitation Status

string

Value	Description
`ACCEPTED`	The invitation has been accepted by the recipient
`PENDING`	The invitation has been sent to the recipient and is awaiting acceptance
`REVOKED`	The invitation has been revoked and can no longer be accepted

Requests

View all sent invitations

GET /api/invitations

Returns all invitations sent by the authenticated user profile.

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations' -i -X GET

import requests

url = "https://app.matatika.com/api/invitations"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("GET", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Invitation collection with HAL links.

{
  "_embedded" : {
    "invitations" : [ {
      "id" : "a121542c-970a-44ab-a75d-af06b7ed7699",
      "created" : "2026-04-23T13:15:58.751395",
      "lastModified" : "2026-04-23T13:15:58.751396",
      "status" : "PENDING",
      "email" : "sit+invited1@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/a121542c-970a-44ab-a75d-af06b7ed7699",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/a121542c-970a-44ab-a75d-af06b7ed7699/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "22e8e4d5-1fc7-4acd-a622-e9d034fa869d",
      "created" : "2026-04-23T13:15:58.827131",
      "lastModified" : "2026-04-23T13:15:58.827132",
      "status" : "PENDING",
      "email" : "sit+invited2@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/22e8e4d5-1fc7-4acd-a622-e9d034fa869d",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/22e8e4d5-1fc7-4acd-a622-e9d034fa869d/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "698c4c95-6639-4a2b-8fb3-71a27d033550",
      "created" : "2026-04-23T13:15:58.906687",
      "lastModified" : "2026-04-23T13:15:58.906688",
      "status" : "PENDING",
      "email" : "sit+invited3@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/698c4c95-6639-4a2b-8fb3-71a27d033550",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/698c4c95-6639-4a2b-8fb3-71a27d033550/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "061e2e73-b334-46e9-a6ac-158085c3bf8f",
      "created" : "2026-04-23T13:15:58.456531",
      "lastModified" : "2026-04-23T13:15:58.456531",
      "status" : "PENDING",
      "email" : "sit+test@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/061e2e73-b334-46e9-a6ac-158085c3bf8f",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/061e2e73-b334-46e9-a6ac-158085c3bf8f/revoked",
          "type" : "PUT"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/invitations{?email}",
      "templated" : true
    }
  },
  "page" : {
    "size" : 20,
    "totalElements" : 4,
    "totalPages" : 1,
    "number" : 0
  }
}

View all received invitations

GET /api/invitations?email={user-email}

Returns all invitations received by the authenticated user profile.

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations?email=sit%2Bprod%2B2%40matatika.com' -i -X GET

import requests

url = "https://app.matatika.com/api/invitations?email=sit%2Bprod%2B2%40matatika.com"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("GET", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Invitation collection with HAL links.

{
  "_embedded" : {
    "invitations" : [ {
      "id" : "51288936-c752-487a-b2eb-3ca8c4c68029",
      "created" : "2026-04-23T13:16:00.631443",
      "lastModified" : "2026-04-23T13:16:00.631444",
      "status" : "PENDING",
      "email" : "sit+prod+2@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "79169867-5e55-4910-a6d0-51f07c6ae3aa",
        "created" : "2026-04-23T13:16:00.211279",
        "lastModified" : "2026-04-23T13:16:00.211279",
        "alias" : "tlytazm",
        "name" : "SIT-Generated Workspace [2026-04-23T13:16:00.183102163]",
        "domains" : [ ],
        "deploymentSecret" : "xyidjhdhkawcbsxeuroragpvkdhngh",
        "appProperties" : { },
        "status" : "PROVISIONING",
        "managed" : true
      },
      "_links" : {
        "accept invitation" : {
          "href" : "https://app.matatika.com/api/invitations/51288936-c752-487a-b2eb-3ca8c4c68029",
          "type" : "PATCH"
        }
      }
    }, {
      "id" : "ac8e4156-4f55-4f9a-8622-46f4f32b43c9",
      "created" : "2026-04-23T13:15:59.517932",
      "lastModified" : "2026-04-23T13:15:59.517933",
      "status" : "PENDING",
      "email" : "sit+prod+2@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "04fc5184-fc6b-4c81-8145-7481059f0266",
        "created" : "2026-04-23T13:15:59.09551",
        "lastModified" : "2026-04-23T13:15:59.09551",
        "alias" : "dkssvng",
        "name" : "SIT-Generated Workspace [2026-04-23T13:15:59.070212783]",
        "domains" : [ ],
        "deploymentSecret" : "ebcjeakvlcmdlgoygvndprdbjmgffh",
        "appProperties" : { },
        "status" : "PROVISIONING",
        "managed" : true
      },
      "_links" : {
        "accept invitation" : {
          "href" : "https://app.matatika.com/api/invitations/ac8e4156-4f55-4f9a-8622-46f4f32b43c9",
          "type" : "PATCH"
        }
      }
    }, {
      "id" : "01ab05cc-c970-4a29-afc3-6606c0f15b88",
      "created" : "2026-04-23T13:16:00.079508",
      "lastModified" : "2026-04-23T13:16:00.079509",
      "status" : "PENDING",
      "email" : "sit+prod+2@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "964f27ec-318a-4f49-8638-b887a2b71ba4",
        "created" : "2026-04-23T13:15:59.646202",
        "lastModified" : "2026-04-23T13:15:59.646202",
        "alias" : "dcayoxj",
        "name" : "SIT-Generated Workspace [2026-04-23T13:15:59.620222917]",
        "domains" : [ ],
        "deploymentSecret" : "raiocapqnbkeyeaxwgjjljduvkfvft",
        "appProperties" : { },
        "status" : "PROVISIONING",
        "managed" : true
      },
      "_links" : {
        "accept invitation" : {
          "href" : "https://app.matatika.com/api/invitations/01ab05cc-c970-4a29-afc3-6606c0f15b88",
          "type" : "PATCH"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/invitations?email=sit+prod+2@matatika.com"
    }
  },
  "page" : {
    "size" : 20,
    "totalElements" : 3,
    "totalPages" : 1,
    "number" : 0
  }
}

View all invitations to a workspace

GET /api/workspaces/{workspace-id}/invitations

As a workspace owner...

Returns all active invitations to the workspace {workspace-id}.

As a workspace member...

Returns all active invitations to the workspace {workspace-id} sent by the authenticated user profile.

Prerequisites

The user must be a member of the workspace {workspace-id}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/workspaces/94231300-c0ae-4956-bc27-3546887551dd/invitations' -i -X GET

import requests

url = "https://app.matatika.com/api/workspaces/94231300-c0ae-4956-bc27-3546887551dd/invitations"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("GET", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Invitation collection with HAL links.

{
  "_embedded" : {
    "invitations" : [ {
      "id" : "a121542c-970a-44ab-a75d-af06b7ed7699",
      "created" : "2026-04-23T13:15:58.751395",
      "lastModified" : "2026-04-23T13:15:58.751396",
      "status" : "PENDING",
      "email" : "sit+invited1@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/a121542c-970a-44ab-a75d-af06b7ed7699",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/a121542c-970a-44ab-a75d-af06b7ed7699/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "22e8e4d5-1fc7-4acd-a622-e9d034fa869d",
      "created" : "2026-04-23T13:15:58.827131",
      "lastModified" : "2026-04-23T13:15:58.827132",
      "status" : "PENDING",
      "email" : "sit+invited2@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/22e8e4d5-1fc7-4acd-a622-e9d034fa869d",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/22e8e4d5-1fc7-4acd-a622-e9d034fa869d/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "698c4c95-6639-4a2b-8fb3-71a27d033550",
      "created" : "2026-04-23T13:15:58.906687",
      "lastModified" : "2026-04-23T13:15:58.906688",
      "status" : "PENDING",
      "email" : "sit+invited3@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/698c4c95-6639-4a2b-8fb3-71a27d033550",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/698c4c95-6639-4a2b-8fb3-71a27d033550/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "3b8f491d-2c12-454f-aa3d-aeb797e605c9",
      "created" : "2026-04-23T13:16:01.305612",
      "lastModified" : "2026-04-23T13:16:01.305612",
      "status" : "PENDING",
      "email" : "sit+prod+2@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/3b8f491d-2c12-454f-aa3d-aeb797e605c9",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/3b8f491d-2c12-454f-aa3d-aeb797e605c9/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "061e2e73-b334-46e9-a6ac-158085c3bf8f",
      "created" : "2026-04-23T13:15:58.456531",
      "lastModified" : "2026-04-23T13:15:58.456531",
      "status" : "PENDING",
      "email" : "sit+test@matatika.com",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "sit+prod@matatika.com",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "94231300-c0ae-4956-bc27-3546887551dd",
        "created" : "2026-04-23T13:15:52.798245",
        "lastModified" : "2026-04-23T13:15:52.798245",
        "alias" : "fxshczw",
        "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/061e2e73-b334-46e9-a6ac-158085c3bf8f",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/061e2e73-b334-46e9-a6ac-158085c3bf8f/revoked",
          "type" : "PUT"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/workspaces/94231300-c0ae-4956-bc27-3546887551dd/invitations?page=0&size=20"
    }
  },
  "page" : {
    "size" : 20,
    "totalElements" : 5,
    "totalPages" : 1,
    "number" : 0
  }
}

Create an invitation to a workspace

POST /api/workspaces/{workspace-id}/invitations

Creates an invitation to the workspace {workspace-id}.

Prerequisites

The user must be a member of the workspace {workspace-id}

Body

Invitation resource.

{
  "email" : "sit+TEST@matatika.com"
}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/workspaces/94231300-c0ae-4956-bc27-3546887551dd/invitations' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "email" : "sit+TEST@matatika.com"
}'

import requests

url = "https://app.matatika.com/api/workspaces/94231300-c0ae-4956-bc27-3546887551dd/invitations"

data = {
  "email" : "sit+TEST@matatika.com"
}
headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("POST", url, headers=headers, data=data)

print(response.text.encode('utf8'))

Response

202 Accepted

No response body provided.

Accept an invitation

PATCH /api/invitations/{invitation-id}

Accepts the invitation {invitation-id}.

Prerequisites

Workspace {workspace-id} must exist
Invitation {invitation-id} must exist for the authenticated user profile

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations/15d14f02-3543-4d28-b77f-8108e3eb4d94' -i -X PATCH \
    -H 'Content-Type: application/json'

import requests

url = "https://app.matatika.com/api/invitations/15d14f02-3543-4d28-b77f-8108e3eb4d94"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("PATCH", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Invitation with HAL links.

{
  "id" : "15d14f02-3543-4d28-b77f-8108e3eb4d94",
  "created" : "2026-04-23T13:16:02.008887",
  "lastModified" : "2026-04-23T13:16:02.651600003",
  "status" : "ACCEPTED",
  "email" : "sit+prod+2@matatika.com",
  "creator" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "sit+prod@matatika.com",
    "handle" : "@sit+prod"
  },
  "workspace" : {
    "id" : "94231300-c0ae-4956-bc27-3546887551dd",
    "created" : "2026-04-23T13:15:52.798245",
    "lastModified" : "2026-04-23T13:15:52.798245",
    "alias" : "fxshczw",
    "name" : "Test Workspace [2026-04-23T13:15:52.796293258]",
    "domains" : [ ],
    "repositoryUrl" : "DISABLED",
    "deploymentSecret" : "smqumpwyletbsbnbssurwkjccagrco",
    "appProperties" : { },
    "status" : "READY",
    "managed" : true
  }
}

Delete an invitation

DELETE /api/invitations/{invitation-id}

Deletes a pending or revoked invitation {invitation-id}.

Prerequisites

The authenticated user must be the owner of workspace the invitation belongs to
or the authenticated user must have sent the invitation {invitation-id}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations/3c6b87a1-e143-43ee-a08a-ca778f72c95f' -i -X DELETE

import requests

url = "https://app.matatika.com/api/invitations/3c6b87a1-e143-43ee-a08a-ca778f72c95f"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("DELETE", url, headers=headers)

print(response.text.encode('utf8'))

Response

204 No Content

No response body provided.

Withdraw an invitation

PUT /api/invitations/{invitation-id}/revoked

Withdraws the pending or accepted invitation {invitation-id}.

Prerequisites

The authenticated user must be the owner of workspace the invitation belongs to
or the authenticated user must have sent the invitation {invitation-id}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations/3c6b87a1-e143-43ee-a08a-ca778f72c95f/revoked' -i -X PUT \
    -H 'Content-Type: application/json'

import requests

url = "https://app.matatika.com/api/invitations/3c6b87a1-e143-43ee-a08a-ca778f72c95f/revoked"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("PUT", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

No response body provided.

Objects​

Invitation​

Formats​

Invitation Status​

Requests​

View all sent invitations​

Examples

Response​

View all received invitations​

Examples

Response​

View all invitations to a workspace​

Prerequisites​

Examples

Response​

Create an invitation to a workspace​

Prerequisites​

Body​

Examples

Response​

Accept an invitation​

Prerequisites​

Examples

Response​

Delete an invitation​

Prerequisites​

Examples

Response​

Withdraw an invitation​

Prerequisites​

Examples

Response​

Objects

Invitation

Formats

Invitation Status

Requests

View all sent invitations

Response

View all received invitations

Response

View all invitations to a workspace

Prerequisites

Response

Create an invitation to a workspace

Prerequisites

Body

Response

Accept an invitation

Prerequisites

Response

Delete an invitation

Prerequisites

Response

Withdraw an invitation

Prerequisites

Response