Profiles

Profiles are individual consumers of the Meltano Cloud 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" : "sit+prod@matatika.com",
  "handle" : "@sit+prod",
  "email" : "sit+prod@matatika.com",
  "_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"
    }
  }
}

Requests

View all profiles

GET /api/profiles

Returns all profiles under the authenticated user account.

Examples

cURL
Python (requests)

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

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" : "sit+prod@matatika.com",
      "handle" : "@sit+prod",
      "email" : "sit+prod@matatika.com",
      "_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

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/profiles/auth0%7C5eb0327cbfd7490bff55feeb' -i -X GET

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" : "sit+prod@matatika.com",
  "handle" : "@sit+prod",
  "email" : "sit+prod@matatika.com",
  "_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}

Body

Profile resource.

{
  "name" : "SIT-Generated Profile [2026-04-23T13:09:58.935244686]",
  "phone" : "91631295122",
  "email" : "sit+mqkjzs1i@matatika.com"
}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/profiles/auth0%7C69ea1a260cf008039b6c6d81' -i -X PUT \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "SIT-Generated Profile [2026-04-23T13:09:58.935244686]",
  "phone" : "91631295122",
  "email" : "sit+mqkjzs1i@matatika.com"
}'

import requests

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

data = {
  "name" : "SIT-Generated Profile [2026-04-23T13:09:58.935244686]",
  "phone" : "91631295122",
  "email" : "sit+mqkjzs1i@matatika.com"
}
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|69ea1a260cf008039b6c6d81",
  "name" : "SIT-Generated Profile [2026-04-23T13:09:58.935244686]",
  "handle" : "@sit-generatedprofile[2026-04-23t13:09:58.070022911]",
  "phone" : "91631295122",
  "email" : "sit+mqkjzs1i@matatika.com",
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://app.matatika.com/api/profiles/auth0%7C69ea1a260cf008039b6c6d81"
    },
    "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 Meltano Cloud will initially load with for a given profile. The default workspace setting persists only for the profile that sets it.

Body

Profile resource.

{
  "defaultWorkspace" : {
    "id" : "b5bad208-c176-4c21-9b07-da950187e91a"
  }
}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/profiles/auth0%7C5eb0327cbfd7490bff55feeb' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -d '{
  "defaultWorkspace" : {
    "id" : "b5bad208-c176-4c21-9b07-da950187e91a"
  }
}'

import requests

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

data = {
  "defaultWorkspace" : {
    "id" : "b5bad208-c176-4c21-9b07-da950187e91a"
  }
}
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" : "sit+prod@matatika.com",
  "handle" : "@sit+prod",
  "email" : "sit+prod@matatika.com",
  "defaultWorkspace" : {
    "name" : "Test Workspace [2026-04-23T13:09:50.980761903]",
    "id" : "b5bad208-c176-4c21-9b07-da950187e91a"
  },
  "_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"
    }
  }
}

Objects​

Profile​

Requests​

View all profiles​

Examples

Response​

View a profile​

Prerequisites​

Examples

Response​

Create or update profile​

Prerequisites​

Body​

Examples

Response​

Set a workspace as default​

Prerequisites​

Body​

Examples

Response​

Objects

Profile

Requests

View all profiles

Response

View a profile

Prerequisites

Response

Create or update profile

Prerequisites

Body

Response

Set a workspace as default

Prerequisites

Body

Response