Profiles

Profiles are individual consumers of the Matatika service. A profile is automatically created for a user when they first access the app, or accept an invitation to a workspace from an existing member via email.

Objects

Profile

Path	JSON Type	Format	Description
`id`	`string`	Version 4 UUID	The profile ID
`name`	`string`	The full name of the person or entity represented by this profile
`handle`	`string`	The unique `@`-prefixed handle for this profile (generated and read-only)
`phone`	`string`	Phone number	The profile phone number
`email`	`string`	Email address	The profile email address
`defaultWorkspace`	`object`	`Workspace`	The profile default workspace

{
  "id" : "auth0|5eb0327cbfd7490bff55feeb",
  "name" : "[email protected]",
  "handle" : "@sit+prod",
  "email" : "[email protected]",
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://app.matatika.com/api/profiles/auth0%7C5eb0327cbfd7490bff55feeb"
    },
    "workspaces" : {
      "href" : "https://app.matatika.com/api/workspaces"
    },
    "new workspace" : {
      "href" : "https://app.matatika.com/api/workspaces"
    }
  }
}

View all profiles

GET

/api/profiles

Returns all profiles under the authenticated user account.

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/profiles' -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/profiles"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Profile collection with HAL links.

{
  "_embedded" : {
    "profiles" : [ {
      "id" : "auth0|5eb0327cbfd7490bff55feeb",
      "name" : "[email protected]",
      "handle" : "@sit+prod",
      "email" : "[email protected]",
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://app.matatika.com/api/profiles/auth0%7C5eb0327cbfd7490bff55feeb"
        },
        "workspaces" : {
          "href" : "https://app.matatika.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://app.matatika.com/api/workspaces"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    }
  }
}

View a profile

GET

/api/profiles/{profile-id}

Returns the profile {profile-id}.

Prerequisites

Profile {profile-id} must exist under the authenticated user account

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/profiles/auth0%7C5eb0327cbfd7490bff55feeb' -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/profiles/auth0%7C5eb0327cbfd7490bff55feeb"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Profile with HAL links.

{
  "id" : "auth0|5eb0327cbfd7490bff55feeb",
  "name" : "[email protected]",
  "handle" : "@sit+prod",
  "email" : "[email protected]",
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://app.matatika.com/api/profiles/auth0%7C5eb0327cbfd7490bff55feeb"
    },
    "workspaces" : {
      "href" : "https://app.matatika.com/api/workspaces"
    },
    "new workspace" : {
      "href" : "https://app.matatika.com/api/workspaces"
    }
  }
}

Create or update profile

PUT

/api/profiles/{profile-id}

Creates or updates the user profile.

Prerequisites

The authentication subject must match the profile ID {profile-id}

Request

Body

Profile resource.

{
  "name" : "SIT-Generated Profile [2025-01-30T17:09:47.930957]",
  "phone" : "96240254747",
  "email" : "[email protected]"
}

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/profiles/auth0%7C679bb25b6bb38e4274f411f1' -i -X PUT \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "SIT-Generated Profile [2025-01-30T17:09:47.930957]",
  "phone" : "96240254747",
  "email" : "[email protected]"
}'

Python (requests)

import requests

url = "https://app.matatika.com/api/profiles/auth0%7C679bb25b6bb38e4274f411f1"

data = {
  "name" : "SIT-Generated Profile [2025-01-30T17:09:47.930957]",
  "phone" : "96240254747",
  "email" : "[email protected]"
}
headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK / 201 Created

Profile with HAL links.

{
  "id" : "auth0|679bb25b6bb38e4274f411f1",
  "name" : "SIT-Generated Profile [2025-01-30T17:09:47.930957]",
  "handle" : "@sit-generatedprofile[2025-01-30t17:09:47.069008]",
  "phone" : "96240254747",
  "email" : "[email protected]",
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://app.matatika.com/api/profiles/auth0%7C679bb25b6bb38e4274f411f1"
    },
    "workspaces" : {
      "href" : "https://app.matatika.com/api/workspaces"
    },
    "new workspace" : {
      "href" : "https://app.matatika.com/api/workspaces"
    }
  }
}

Set a workspace as default

PATCH

/api/profiles/{profile-id}

Sets a default workspace for the profile {profile-id}.

Prerequisites

The authentication subject must match the profile ID {profile-id}

A workspace can be set as default, which defines the environment the Matatika app will initially load for a given profile. The default workspace setting persists only for the profile that sets it.

Request

Body

Profile resource.

{
  "defaultWorkspace" : {
    "id" : "89007bf4-a597-47db-9d34-0902b604fe59"
  }
}

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/profiles/auth0%7C5eb0327cbfd7490bff55feeb' -i -X PATCH \
    -H 'Accept: application/json, application/javascript, text/javascript, text/json' \
    -H 'Content-Type: application/json' \
    -d '{
  "defaultWorkspace" : {
    "id" : "89007bf4-a597-47db-9d34-0902b604fe59"
  }
}'

Python (requests)

import requests

url = "https://app.matatika.com/api/profiles/auth0%7C5eb0327cbfd7490bff55feeb"

data = {
  "defaultWorkspace" : {
    "id" : "89007bf4-a597-47db-9d34-0902b604fe59"
  }
}
headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Profile with HAL links.

{
  "id" : "auth0|5eb0327cbfd7490bff55feeb",
  "name" : "[email protected]",
  "handle" : "@sit+prod",
  "email" : "[email protected]",
  "defaultWorkspace" : {
    "name" : "Test Workspace [2025-01-30T17:09:39.857195177]",
    "id" : "89007bf4-a597-47db-9d34-0902b604fe59"
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://app.matatika.com/api/profiles/auth0%7C5eb0327cbfd7490bff55feeb"
    },
    "workspaces" : {
      "href" : "https://app.matatika.com/api/workspaces"
    },
    "new workspace" : {
      "href" : "https://app.matatika.com/api/workspaces"
    }
  }
}