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|6a21dc7aa1db2e036a222942",
  "name" : "sit+prod@meltano.com",
  "handle" : "@sit+prod1",
  "email" : "sit+prod@meltano.com",
  "workingAccount" : {
    "company" : "Test Company",
    "id" : "auth0|6a21dc7aa1db2e036a222942"
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://app.matatika.com/api/profiles/auth0%7C6a21dc7aa1db2e036a222942"
    },
    "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|6a21dc7aa1db2e036a222942",
      "name" : "sit+prod@meltano.com",
      "handle" : "@sit+prod1",
      "email" : "sit+prod@meltano.com",
      "workingAccount" : {
        "company" : "Test Company",
        "id" : "auth0|6a21dc7aa1db2e036a222942"
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://app.matatika.com/api/profiles/auth0%7C6a21dc7aa1db2e036a222942"
        },
        "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%7C6a21dc7aa1db2e036a222942' -i -X GET

import requests

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

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|6a21dc7aa1db2e036a222942",
  "name" : "sit+prod@meltano.com",
  "handle" : "@sit+prod1",
  "email" : "sit+prod@meltano.com",
  "workingAccount" : {
    "company" : "Test Company",
    "id" : "auth0|6a21dc7aa1db2e036a222942"
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://app.matatika.com/api/profiles/auth0%7C6a21dc7aa1db2e036a222942"
    },
    "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-06-10T07:13:56.040374044]",
  "phone" : "52432053169",
  "email" : "sit+7tjahxgk@meltano.com"
}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/profiles/auth0%7C6a290eb31ce7627f41f2430e' -i -X PUT \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "SIT-Generated Profile [2026-06-10T07:13:56.040374044]",
  "phone" : "52432053169",
  "email" : "sit+7tjahxgk@meltano.com"
}'

import requests

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

data = {
  "name" : "SIT-Generated Profile [2026-06-10T07:13:56.040374044]",
  "phone" : "52432053169",
  "email" : "sit+7tjahxgk@meltano.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|6a290eb31ce7627f41f2430e",
  "name" : "SIT-Generated Profile [2026-06-10T07:13:56.040374044]",
  "handle" : "@sit-generatedprofile[2026-06-10t07:13:55.349968451]",
  "phone" : "52432053169",
  "email" : "sit+7tjahxgk@meltano.com",
  "workingAccount" : {
    "id" : "auth0|6a290eb31ce7627f41f2430e"
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://app.matatika.com/api/profiles/auth0%7C6a290eb31ce7627f41f2430e"
    },
    "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" : "1f4dd699-ecb3-4e7f-ab8c-3c077ad51272"
  }
}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/profiles/auth0%7C6a21dc7aa1db2e036a222942' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -d '{
  "defaultWorkspace" : {
    "id" : "1f4dd699-ecb3-4e7f-ab8c-3c077ad51272"
  }
}'

import requests

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

data = {
  "defaultWorkspace" : {
    "id" : "1f4dd699-ecb3-4e7f-ab8c-3c077ad51272"
  }
}
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|6a21dc7aa1db2e036a222942",
  "name" : "sit+prod@meltano.com",
  "handle" : "@sit+prod1",
  "email" : "sit+prod@meltano.com",
  "defaultWorkspace" : {
    "name" : "Test Workspace [2026-06-10T07:13:48.250417991]",
    "id" : "1f4dd699-ecb3-4e7f-ab8c-3c077ad51272"
  },
  "workingAccount" : {
    "company" : "Test Company",
    "id" : "auth0|6a21dc7aa1db2e036a222942"
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://app.matatika.com/api/profiles/auth0%7C6a21dc7aa1db2e036a222942"
    },
    "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