Link Search Menu Expand Document

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" : "718c172c-2d99-4baf-985b-67eaf216cef7",
      "created" : "2022-01-21T09:31:58.621501",
      "lastModified" : "2022-01-21T09:31:58.621501",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/718c172c-2d99-4baf-985b-67eaf216cef7",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/718c172c-2d99-4baf-985b-67eaf216cef7/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "e6211765-9711-4df8-982d-8a518380f57d",
      "created" : "2022-01-21T09:32:04.11193",
      "lastModified" : "2022-01-21T09:32:04.111931",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/e6211765-9711-4df8-982d-8a518380f57d",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/e6211765-9711-4df8-982d-8a518380f57d/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "273a14b0-de18-4025-ba0f-79bcad043288",
      "created" : "2022-01-21T09:32:04.273157",
      "lastModified" : "2022-01-21T09:32:04.273157",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/273a14b0-de18-4025-ba0f-79bcad043288",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/273a14b0-de18-4025-ba0f-79bcad043288/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "6c3823f5-3de5-41c3-9118-e7de102c8f6a",
      "created" : "2022-01-21T09:32:04.427467",
      "lastModified" : "2022-01-21T09:32:04.427468",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/6c3823f5-3de5-41c3-9118-e7de102c8f6a",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/6c3823f5-3de5-41c3-9118-e7de102c8f6a/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "a5d7e56e-20dc-4389-a6be-058c4844a515",
      "created" : "2022-01-21T09:32:36.949873",
      "lastModified" : "2022-01-21T09:32:36.949874",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/a5d7e56e-20dc-4389-a6be-058c4844a515",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/a5d7e56e-20dc-4389-a6be-058c4844a515/revoked",
          "type" : "PUT"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://catalog.matatika.com/api/workspaces/816dcc05-bf03-40c1-87bb-f11fb61b290b/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.

Request

Example Snippets

  • cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://catalog.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://catalog.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" : "718c172c-2d99-4baf-985b-67eaf216cef7",
      "created" : "2022-01-21T09:31:58.621501",
      "lastModified" : "2022-01-21T09:31:58.621501",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/718c172c-2d99-4baf-985b-67eaf216cef7",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/718c172c-2d99-4baf-985b-67eaf216cef7/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "e6211765-9711-4df8-982d-8a518380f57d",
      "created" : "2022-01-21T09:32:04.11193",
      "lastModified" : "2022-01-21T09:32:04.111931",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/e6211765-9711-4df8-982d-8a518380f57d",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/e6211765-9711-4df8-982d-8a518380f57d/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "273a14b0-de18-4025-ba0f-79bcad043288",
      "created" : "2022-01-21T09:32:04.273157",
      "lastModified" : "2022-01-21T09:32:04.273157",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]ika.com",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/273a14b0-de18-4025-ba0f-79bcad043288",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/273a14b0-de18-4025-ba0f-79bcad043288/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "6c3823f5-3de5-41c3-9118-e7de102c8f6a",
      "created" : "2022-01-21T09:32:04.427467",
      "lastModified" : "2022-01-21T09:32:04.427468",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/6c3823f5-3de5-41c3-9118-e7de102c8f6a",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/6c3823f5-3de5-41c3-9118-e7de102c8f6a/revoked",
          "type" : "PUT"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://catalog.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://catalog.matatika.com/api/invitations?email=support%2Bproductiontests2%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://catalog.matatika.com/api/invitations?email=support%2Bproductiontests2%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" : "957b9981-2e38-4a4d-9e60-f91261521103",
      "created" : "2022-01-21T09:32:19.301917",
      "lastModified" : "2022-01-21T09:32:19.301918",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "44e6fe08-97f3-4705-9330-8df1d3ef1224",
        "created" : "2022-01-21T09:32:16.00354",
        "lastModified" : "2022-01-21T09:32:16.003541",
        "alias" : "wgyhcmz",
        "name" : "SIT-Generated Workspace [2022-01-21T09:32:15.878841]",
        "repositoryUrl" : "https://github.com/MatatikaBytes/SIT-Generated-Workspace-2022-01-21T09-32-15-878841--wgyhcmz",
        "repositorySshUrl" : "[email protected]:MatatikaBytes/SIT-Generated-Workspace-2022-01-21T09-32-15-878841--wgyhcmz.git",
        "status" : "PROVISIONING"
      },
      "_links" : {
        "accept invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/957b9981-2e38-4a4d-9e60-f91261521103",
          "type" : "PATCH"
        }
      }
    }, {
      "id" : "464895fb-7ef3-4957-bc0b-19912c8aede3",
      "created" : "2022-01-21T09:32:08.343785",
      "lastModified" : "2022-01-21T09:32:08.343786",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "e7179202-15fb-4509-994b-b19fd2a627b3",
        "created" : "2022-01-21T09:32:04.927374",
        "lastModified" : "2022-01-21T09:32:04.927374",
        "alias" : "phhtrge",
        "name" : "SIT-Generated Workspace [2022-01-21T09:32:04.776513]",
        "repositoryUrl" : "https://github.com/MatatikaBytes/SIT-Generated-Workspace-2022-01-21T09-32-04-776513--phhtrge",
        "repositorySshUrl" : "[email protected]:MatatikaBytes/SIT-Generated-Workspace-2022-01-21T09-32-04-776513--phhtrge.git",
        "status" : "READY"
      },
      "_links" : {
        "accept invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/464895fb-7ef3-4957-bc0b-19912c8aede3",
          "type" : "PATCH"
        }
      }
    }, {
      "id" : "540cc041-7038-4018-bd6e-34877dacea19",
      "created" : "2022-01-21T09:32:29.933317",
      "lastModified" : "2022-01-21T09:32:29.933318",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "79ba3af3-2157-4da7-b878-10e520414d00",
        "created" : "2022-01-21T09:32:26.459856",
        "lastModified" : "2022-01-21T09:32:26.459857",
        "alias" : "jhroifb",
        "name" : "SIT-Generated Workspace [2022-01-21T09:32:26.337595]",
        "repositoryUrl" : "https://github.com/MatatikaBytes/SIT-Generated-Workspace-2022-01-21T09-32-26-337595--jhroifb",
        "repositorySshUrl" : "[email protected]:MatatikaBytes/SIT-Generated-Workspace-2022-01-21T09-32-26-337595--jhroifb.git",
        "status" : "PROVISIONING"
      },
      "_links" : {
        "accept invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/540cc041-7038-4018-bd6e-34877dacea19",
          "type" : "PATCH"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://catalog.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://catalog.matatika.com/api/workspaces/816dcc05-bf03-40c1-87bb-f11fb61b290b/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://catalog.matatika.com/api/workspaces/816dcc05-bf03-40c1-87bb-f11fb61b290b/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" : "718c172c-2d99-4baf-985b-67eaf216cef7",
      "created" : "2022-01-21T09:31:58.621501",
      "lastModified" : "2022-01-21T09:31:58.621501",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/718c172c-2d99-4baf-985b-67eaf216cef7",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/718c172c-2d99-4baf-985b-67eaf216cef7/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "e6211765-9711-4df8-982d-8a518380f57d",
      "created" : "2022-01-21T09:32:04.11193",
      "lastModified" : "2022-01-21T09:32:04.111931",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/e6211765-9711-4df8-982d-8a518380f57d",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/e6211765-9711-4df8-982d-8a518380f57d/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "273a14b0-de18-4025-ba0f-79bcad043288",
      "created" : "2022-01-21T09:32:04.273157",
      "lastModified" : "2022-01-21T09:32:04.273157",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/273a14b0-de18-4025-ba0f-79bcad043288",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/273a14b0-de18-4025-ba0f-79bcad043288/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "6c3823f5-3de5-41c3-9118-e7de102c8f6a",
      "created" : "2022-01-21T09:32:04.427467",
      "lastModified" : "2022-01-21T09:32:04.427468",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/6c3823f5-3de5-41c3-9118-e7de102c8f6a",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/6c3823f5-3de5-41c3-9118-e7de102c8f6a/revoked",
          "type" : "PUT"
        }
      }
    }, {
      "id" : "a5d7e56e-20dc-4389-a6be-058c4844a515",
      "created" : "2022-01-21T09:32:36.949873",
      "lastModified" : "2022-01-21T09:32:36.949874",
      "status" : "PENDING",
      "email" : "[email protected]",
      "creator" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@support+integrationtests+a7o91bel"
      },
      "workspace" : {
        "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
        "created" : "2022-01-21T09:31:55.256425",
        "lastModified" : "2022-01-21T09:31:55.256426",
        "alias" : "lbxpaaz",
        "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
        "repositoryUrl" : "DISABLED",
        "status" : "READY"
      },
      "_links" : {
        "delete invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/a5d7e56e-20dc-4389-a6be-058c4844a515",
          "type" : "DELETE"
        },
        "withdraw invitation" : {
          "href" : "https://catalog.matatika.com/api/invitations/a5d7e56e-20dc-4389-a6be-058c4844a515/revoked",
          "type" : "PUT"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://catalog.matatika.com/api/workspaces/816dcc05-bf03-40c1-87bb-f11fb61b290b/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://catalog.matatika.com/api/workspaces/816dcc05-bf03-40c1-87bb-f11fb61b290b/invitations' -i -X POST \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/hal+json; charset=ISO-8859-1' \
    -d '{
  "email" : "[email protected]"
}'
  • Python (requests)
import requests

url = "https://catalog.matatika.com/api/workspaces/816dcc05-bf03-40c1-87bb-f11fb61b290b/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://catalog.matatika.com/api/invitations/c4e9ad8f-35b0-4b16-b129-f9e139ec4e17' -i -X PATCH \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json'
  • Python (requests)
import requests

url = "https://catalog.matatika.com/api/invitations/c4e9ad8f-35b0-4b16-b129-f9e139ec4e17"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Invitation with HAL links.

{
  "id" : "c4e9ad8f-35b0-4b16-b129-f9e139ec4e17",
  "created" : "2022-01-21T09:32:38.731993",
  "lastModified" : "2022-01-21T09:32:39.522938",
  "status" : "ACCEPTED",
  "email" : "[email protected]",
  "creator" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@support+integrationtests+a7o91bel"
  },
  "workspace" : {
    "id" : "816dcc05-bf03-40c1-87bb-f11fb61b290b",
    "created" : "2022-01-21T09:31:55.256425",
    "lastModified" : "2022-01-21T09:31:55.256426",
    "alias" : "lbxpaaz",
    "name" : "Test Workspace [2022-01-21T09:31:55.252723]",
    "repositoryUrl" : "DISABLED",
    "status" : "READY"
  }
}

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://catalog.matatika.com/api/invitations/5ec4b94c-a2d3-4d17-b84c-71fff41cc3ef' -i -X DELETE \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json'
  • Python (requests)
import requests

url = "https://catalog.matatika.com/api/invitations/5ec4b94c-a2d3-4d17-b84c-71fff41cc3ef"

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://catalog.matatika.com/api/invitations/5ec4b94c-a2d3-4d17-b84c-71fff41cc3ef/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://catalog.matatika.com/api/invitations/5ec4b94c-a2d3-4d17-b84c-71fff41cc3ef/revoked"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

No response body provided.