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	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`	`Member`		The invitation creator
`workspace`	`Workspace`		The invitation target workspace

{
  "_embedded" : {
    "invitations" : [ {
      "id" : "aa7f6a1d-78b3-4a9a-900c-54ec2e0fecc5",
      "created" : "2024-12-16T09:59:47.855599",
      "lastModified" : "2024-12-16T09:59:47.855599",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/aa7f6a1d-78b3-4a9a-900c-54ec2e0fecc5",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/aa7f6a1d-78b3-4a9a-900c-54ec2e0fecc5/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "004776dc-e927-4553-a18e-ba9e8f1be0b1",
      "created" : "2024-12-16T09:59:43.893647",
      "lastModified" : "2024-12-16T09:59:43.893648",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/004776dc-e927-4553-a18e-ba9e8f1be0b1",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/004776dc-e927-4553-a18e-ba9e8f1be0b1/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "7fab562e-03ac-41b5-b732-a7dc4a6fafb5",
      "created" : "2024-12-16T09:59:47.530929",
      "lastModified" : "2024-12-16T09:59:47.530929",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/7fab562e-03ac-41b5-b732-a7dc4a6fafb5",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/7fab562e-03ac-41b5-b732-a7dc4a6fafb5/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "1602aeec-91e9-4345-b82f-6a07986bf9fb",
      "created" : "2024-12-16T09:59:47.697124",
      "lastModified" : "2024-12-16T09:59:47.697124",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/1602aeec-91e9-4345-b82f-6a07986bf9fb",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/1602aeec-91e9-4345-b82f-6a07986bf9fb/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "c55d1ccc-7d23-4b2a-97a8-8a17f37dfb24",
      "created" : "2024-12-16T09:59:51.398531",
      "lastModified" : "2024-12-16T09:59:51.398531",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/c55d1ccc-7d23-4b2a-97a8-8a17f37dfb24",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/c55d1ccc-7d23-4b2a-97a8-8a17f37dfb24/revoked",
          "type" : "PUT"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/workspaces/a775583d-02f9-4f5a-a636-63c87748d47d/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

View all sent invitations

GET

/api/invitations

Returns all invitations sent by the authenticated user profile.

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations' -i -X GET \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json'

Python (requests)

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" : "aa7f6a1d-78b3-4a9a-900c-54ec2e0fecc5",
      "created" : "2024-12-16T09:59:47.855599",
      "lastModified" : "2024-12-16T09:59:47.855599",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/aa7f6a1d-78b3-4a9a-900c-54ec2e0fecc5",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/aa7f6a1d-78b3-4a9a-900c-54ec2e0fecc5/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "004776dc-e927-4553-a18e-ba9e8f1be0b1",
      "created" : "2024-12-16T09:59:43.893647",
      "lastModified" : "2024-12-16T09:59:43.893648",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/004776dc-e927-4553-a18e-ba9e8f1be0b1",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/004776dc-e927-4553-a18e-ba9e8f1be0b1/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "7fab562e-03ac-41b5-b732-a7dc4a6fafb5",
      "created" : "2024-12-16T09:59:47.530929",
      "lastModified" : "2024-12-16T09:59:47.530929",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/7fab562e-03ac-41b5-b732-a7dc4a6fafb5",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/7fab562e-03ac-41b5-b732-a7dc4a6fafb5/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "1602aeec-91e9-4345-b82f-6a07986bf9fb",
      "created" : "2024-12-16T09:59:47.697124",
      "lastModified" : "2024-12-16T09:59:47.697124",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/1602aeec-91e9-4345-b82f-6a07986bf9fb",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/1602aeec-91e9-4345-b82f-6a07986bf9fb/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.

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations?email=sit%2Bprod%2B2%40matatika.com' -i -X GET \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json'

Python (requests)

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" : "69027028-dd2f-4604-8482-38b211d406ba",
      "created" : "2024-12-16T09:59:48.933951",
      "lastModified" : "2024-12-16T09:59:48.933951",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "625632a4-717f-4844-9135-50c9633d3875",
        "created" : "2024-12-16T09:59:48.384746",
        "lastModified" : "2024-12-16T09:59:48.384746",
        "alias" : "lkoshgm",
        "name" : "SIT-Generated Workspace [2024-12-16T09:59:48.285328]",
        "domains" : [ ],
        "deploymentSecret" : "supdoqehnffnktmdvlmuduregjvhsz",
        "appProperties" : { },
        "status" : "PROVISIONING",
        "managed" : true
      },
      "_links" : {
        "accept invitation" : {
          "href" : "https://app.matatika.com/api/invitations/69027028-dd2f-4604-8482-38b211d406ba",
          "type" : "PATCH"
        }
      }
    }, {
      "id" : "d64e9d33-bbdb-4ece-a274-d09f3eb75b53",
      "created" : "2024-12-16T09:59:49.832181",
      "lastModified" : "2024-12-16T09:59:49.832182",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "6461b651-3545-4d2f-8f78-37202c5234dc",
        "created" : "2024-12-16T09:59:49.285983",
        "lastModified" : "2024-12-16T09:59:49.285983",
        "alias" : "oibuodh",
        "name" : "SIT-Generated Workspace [2024-12-16T09:59:49.179672]",
        "domains" : [ ],
        "deploymentSecret" : "nkzdpawraqndejoinyvxbtcgeyeunw",
        "appProperties" : { },
        "status" : "PROVISIONING",
        "managed" : true
      },
      "_links" : {
        "accept invitation" : {
          "href" : "https://app.matatika.com/api/invitations/d64e9d33-bbdb-4ece-a274-d09f3eb75b53",
          "type" : "PATCH"
        }
      }
    }, {
      "id" : "ed573bdb-ced1-466e-b303-73008b0cc08a",
      "created" : "2024-12-16T09:59:50.691357",
      "lastModified" : "2024-12-16T09:59:50.691357",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "6c08b5db-2b00-4359-8833-5000ca66982e",
        "created" : "2024-12-16T09:59:50.199067",
        "lastModified" : "2024-12-16T09:59:50.199067",
        "alias" : "ovaghnk",
        "name" : "SIT-Generated Workspace [2024-12-16T09:59:50.097997]",
        "domains" : [ ],
        "deploymentSecret" : "bfpaqqvamcgxpissmdcjnzxxtapqpm",
        "appProperties" : { },
        "status" : "PROVISIONING",
        "managed" : true
      },
      "_links" : {
        "accept invitation" : {
          "href" : "https://app.matatika.com/api/invitations/ed573bdb-ced1-466e-b303-73008b0cc08a",
          "type" : "PATCH"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/[email protected]"
    }
  },
  "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}

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/workspaces/a775583d-02f9-4f5a-a636-63c87748d47d/invitations' -i -X GET \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/workspaces/a775583d-02f9-4f5a-a636-63c87748d47d/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" : "aa7f6a1d-78b3-4a9a-900c-54ec2e0fecc5",
      "created" : "2024-12-16T09:59:47.855599",
      "lastModified" : "2024-12-16T09:59:47.855599",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/aa7f6a1d-78b3-4a9a-900c-54ec2e0fecc5",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/aa7f6a1d-78b3-4a9a-900c-54ec2e0fecc5/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "004776dc-e927-4553-a18e-ba9e8f1be0b1",
      "created" : "2024-12-16T09:59:43.893647",
      "lastModified" : "2024-12-16T09:59:43.893648",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/004776dc-e927-4553-a18e-ba9e8f1be0b1",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/004776dc-e927-4553-a18e-ba9e8f1be0b1/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "7fab562e-03ac-41b5-b732-a7dc4a6fafb5",
      "created" : "2024-12-16T09:59:47.530929",
      "lastModified" : "2024-12-16T09:59:47.530929",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/7fab562e-03ac-41b5-b732-a7dc4a6fafb5",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/7fab562e-03ac-41b5-b732-a7dc4a6fafb5/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "1602aeec-91e9-4345-b82f-6a07986bf9fb",
      "created" : "2024-12-16T09:59:47.697124",
      "lastModified" : "2024-12-16T09:59:47.697124",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/1602aeec-91e9-4345-b82f-6a07986bf9fb",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/1602aeec-91e9-4345-b82f-6a07986bf9fb/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "c55d1ccc-7d23-4b2a-97a8-8a17f37dfb24",
      "created" : "2024-12-16T09:59:51.398531",
      "lastModified" : "2024-12-16T09:59:51.398531",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "workspace" : {
        "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
        "created" : "2024-12-16T09:59:42.567912",
        "lastModified" : "2024-12-16T09:59:42.567913",
        "alias" : "recvned",
        "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
        "domains" : [ ],
        "repositoryUrl" : "DISABLED",
        "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
        "appProperties" : { },
        "status" : "READY",
        "managed" : true
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://app.matatika.com/api/invitations/c55d1ccc-7d23-4b2a-97a8-8a17f37dfb24",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://app.matatika.com/api/invitations/c55d1ccc-7d23-4b2a-97a8-8a17f37dfb24/revoked",
          "type" : "PUT"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/workspaces/a775583d-02f9-4f5a-a636-63c87748d47d/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}

Request

Body

Invitation resource.

{
  "email" : "[email protected]"
}

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/workspaces/a775583d-02f9-4f5a-a636-63c87748d47d/invitations' -i -X POST \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json' \
    -d '{
  "email" : "[email protected]"
}'

Python (requests)

import requests

url = "https://app.matatika.com/api/workspaces/a775583d-02f9-4f5a-a636-63c87748d47d/invitations"

data = {
  "email" : "[email protected]"
}
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

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations/4f55d526-8be0-4198-b955-76d714e85edf' -i -X PATCH \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/invitations/4f55d526-8be0-4198-b955-76d714e85edf"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Invitation with HAL links.

{
  "id" : "4f55d526-8be0-4198-b955-76d714e85edf",
  "created" : "2024-12-16T09:59:53.332053",
  "lastModified" : "2024-12-16T09:59:54.082273579",
  "status" : "ACCEPTED",
  "email" : "[email protected]",
  "creator" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@sit+prod"
  },
  "workspace" : {
    "id" : "a775583d-02f9-4f5a-a636-63c87748d47d",
    "created" : "2024-12-16T09:59:42.567912",
    "lastModified" : "2024-12-16T09:59:42.567913",
    "alias" : "recvned",
    "name" : "Test Workspace [2024-12-16T09:59:42.564313085]",
    "domains" : [ ],
    "repositoryUrl" : "DISABLED",
    "deploymentSecret" : "vfvnzmmuonhonasjpvjmnxmkpfnlpp",
    "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}

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations/aba0ab73-5eb6-46da-b913-a0a09e66522e' -i -X DELETE \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/invitations/aba0ab73-5eb6-46da-b913-a0a09e66522e"

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}

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/invitations/aba0ab73-5eb6-46da-b913-a0a09e66522e/revoked' -i -X PUT \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/invitations/aba0ab73-5eb6-46da-b913-a0a09e66522e/revoked"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

No response body provided.