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
`workingAccount`	`object`	`Account`	The profile working account under which new workspaces are created

{
  "id" : "auth0|6a205ea86a76a69d8a3babcb",
  "name" : "sit@meltano.com",
  "handle" : "@sit1",
  "email" : "sit@meltano.com",
  "workingAccount" : {
    "company" : "Test Company",
    "id" : "auth0|6a205ea86a76a69d8a3babcb"
  },
  "_links" : {
    "self" : {
      "href" : "https://staging.meltano.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb"
    },
    "workspaces" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "new workspace" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "set working account" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb/working-account"
    }
  }
}

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://staging.meltano.com:443/api/profiles' -i -X GET

import requests

url = "https://staging.meltano.com:443/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|6a46cbb368f75f9bdcc7f135",
      "name" : "SIT-Generated Profile [2026-07-02T20:36:03.165814483]",
      "handle" : "@sit-generatedprofile[2026-07-02t20:36:03.165814483]",
      "phone" : "49548510235",
      "email" : "sit+aunendkc@meltano.com",
      "workingAccount" : {
        "id" : "auth0|6a46cbb368f75f9bdcc7f135"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a46cbb368f75f9bdcc7f135"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a46cbb368f75f9bdcc7f135/working-account"
        }
      }
    }, {
      "id" : "auth0|6a4fbcc5278951250d7a2ccf",
      "name" : "sit+new+wytodeizge@meltano.com",
      "handle" : "@sit+new+wytodeizge",
      "email" : "sit+new+wytodeizge@meltano.com",
      "workingAccount" : {
        "id" : "auth0|6a4fbcc5278951250d7a2ccf"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a4fbcc5278951250d7a2ccf"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a4fbcc5278951250d7a2ccf/working-account"
        }
      }
    }, {
      "id" : "auth0|6a46cbb79550d2cd3f9e2c10",
      "name" : "SIT-Generated Profile [2026-07-02T20:36:08.154620648]",
      "handle" : "@sit-generatedprofile[2026-07-02t20:36:07.362876107]",
      "phone" : "96089301701",
      "email" : "sit+sxjugznq@meltano.com",
      "workingAccount" : {
        "id" : "auth0|6a46cbb79550d2cd3f9e2c10"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a46cbb79550d2cd3f9e2c10"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a46cbb79550d2cd3f9e2c10/working-account"
        }
      }
    }, {
      "id" : "auth0|6a51a08b4073206a925b46b4",
      "name" : "SIT-Generated Profile [2026-07-11T01:46:50.884438182]",
      "handle" : "@sit-generatedprofile[2026-07-11t01:46:50.884438182]",
      "phone" : "27179561097",
      "email" : "sit+xysxgrrw@meltano.com",
      "workingAccount" : {
        "id" : "auth0|6a51a08b4073206a925b46b4"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a51a08b4073206a925b46b4"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a51a08b4073206a925b46b4/working-account"
        }
      }
    }, {
      "id" : "auth0|6a4b9dc237a2699cb00fb336",
      "name" : "agupta+6jul@meltano.com",
      "handle" : "@agupta+6jul",
      "email" : "agupta+6jul@meltano.com",
      "defaultWorkspace" : {
        "name" : "7jul",
        "id" : "192d3804-1b28-4228-9f3f-361147816f78"
      },
      "workingAccount" : {
        "id" : "auth0|6a4b9dc237a2699cb00fb336"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a4b9dc237a2699cb00fb336"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a4b9dc237a2699cb00fb336/working-account"
        }
      }
    }, {
      "id" : "auth0|68c0af529b55aaeb0d543882",
      "name" : "sit+new+zcpbyjynhg@matatika.com",
      "handle" : "@sit+new+zcpbyjynhg",
      "email" : "sit+new+zcpbyjynhg@matatika.com",
      "workingAccount" : {
        "company" : "Test Company (updated)",
        "id" : "ztoop-nzwvm"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c0af529b55aaeb0d543882"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c0af529b55aaeb0d543882/working-account"
        }
      }
    }, {
      "id" : "auth0|68c353141c552fdb672fe92e",
      "name" : "sit+new+surscdwwxf@matatika.com",
      "handle" : "@sit+new+surscdwwxf",
      "email" : "sit+new+surscdwwxf@matatika.com",
      "workingAccount" : {
        "company" : "Test Company (updated)",
        "id" : "ztoop-nzwvm"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c353141c552fdb672fe92e"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c353141c552fdb672fe92e/working-account"
        }
      }
    }, {
      "id" : "auth0|68c3decf6385ad2e579c2b77",
      "name" : "sit+new+keejivkeks@matatika.com",
      "handle" : "@sit+new+keejivkeks",
      "email" : "sit+new+keejivkeks@matatika.com",
      "workingAccount" : {
        "company" : "Test Company (updated)",
        "id" : "ztoop-nzwvm"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c3decf6385ad2e579c2b77"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c3decf6385ad2e579c2b77/working-account"
        }
      }
    }, {
      "id" : "auth0|68c43ede76223c2fde33487d",
      "name" : "sit+new+kahecpezpx@matatika.com",
      "handle" : "@sit+new+kahecpezpx",
      "email" : "sit+new+kahecpezpx@matatika.com",
      "workingAccount" : {
        "company" : "Test Company (updated)",
        "id" : "ztoop-nzwvm"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c43ede76223c2fde33487d"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c43ede76223c2fde33487d/working-account"
        }
      }
    }, {
      "id" : "auth0|68b82d7c3facd4bb2601200f",
      "name" : "sit+new+iycjjeeuoo@matatika.com",
      "handle" : "@sit+new+iycjjeeuoo",
      "email" : "sit+new+iycjjeeuoo@matatika.com",
      "workingAccount" : {
        "company" : "Test Company (updated)",
        "id" : "ztoop-nzwvm"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68b82d7c3facd4bb2601200f"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68b82d7c3facd4bb2601200f/working-account"
        }
      }
    }, {
      "id" : "auth0|68c420d38b9e3d8bc46f81a2",
      "name" : "sit+new+ziuhqosxpq@matatika.com",
      "handle" : "@sit+new+ziuhqosxpq",
      "email" : "sit+new+ziuhqosxpq@matatika.com",
      "workingAccount" : {
        "company" : "Test Company (updated)",
        "id" : "ztoop-nzwvm"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c420d38b9e3d8bc46f81a2"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c420d38b9e3d8bc46f81a2/working-account"
        }
      }
    }, {
      "id" : "auth0|68c45265ddae45d0eca5a99c",
      "name" : "sit+new+zkyevqchzr@matatika.com",
      "handle" : "@sit+new+zkyevqchzr",
      "email" : "sit+new+zkyevqchzr@matatika.com",
      "workingAccount" : {
        "company" : "Test Company (updated)",
        "id" : "ztoop-nzwvm"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c45265ddae45d0eca5a99c"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C68c45265ddae45d0eca5a99c/working-account"
        }
      }
    }, {
      "id" : "auth0|690b61801877c996c0b20cbc",
      "name" : "sit+new+ijdzpfynzh@matatika.com",
      "handle" : "@sit+new+ijdzpfynzh",
      "email" : "sit+new+ijdzpfynzh@matatika.com",
      "defaultWorkspace" : {
        "name" : "Matatika SIT-Generated Workspace",
        "id" : "20dd18dd-c918-4168-bf09-42df35a6ca10"
      },
      "workingAccount" : {
        "company" : "Test Company (updated)",
        "id" : "ztoop-nzwvm"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C690b61801877c996c0b20cbc"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C690b61801877c996c0b20cbc/working-account"
        }
      }
    }, {
      "id" : "auth0|5f0c0941920eff00199c5a61",
      "name" : "sit+new@matatika.com",
      "handle" : "@sit+new",
      "email" : "sit+new@matatika.com",
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C5f0c0941920eff00199c5a61"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C5f0c0941920eff00199c5a61/working-account"
        }
      }
    }, {
      "id" : "auth0|6a612d2a569e32dbfc50a3ad",
      "name" : "SIT-Generated Profile [2026-07-22T20:50:50.104622768]",
      "handle" : "@sit-generatedprofile[2026-07-22t20:50:50.104622768]",
      "phone" : "69979994899",
      "email" : "sit+kgnqumiy@meltano.com",
      "workingAccount" : {
        "company" : "Another Company",
        "id" : "f281b01c-9aa3-4c64-a9cd-33125aeda3ff"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a612d2a569e32dbfc50a3ad"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a612d2a569e32dbfc50a3ad/working-account"
        }
      }
    }, {
      "id" : "auth0|6a6b8317e9acfe709351ce78",
      "name" : "SIT-Generated Profile [2026-07-30T17:00:07.447887705]",
      "handle" : "@sit-generatedprofile[2026-07-30t17:00:07.447887705]",
      "phone" : "80112028634",
      "email" : "sit+zfcmwagk@meltano.com",
      "workingAccount" : {
        "company" : "Another Company",
        "id" : "b57a1142-82fa-4965-8680-3a145a51c1c8"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a6b8317e9acfe709351ce78"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a6b8317e9acfe709351ce78/working-account"
        }
      }
    }, {
      "id" : "auth0|6a727e2ab152a8fb1c7e96b4",
      "name" : "sit+new+xqynmigpld@meltano.com",
      "handle" : "@sit+new+xqynmigpld",
      "email" : "sit+new+xqynmigpld@meltano.com",
      "workingAccount" : {
        "id" : "auth0|6a727e2ab152a8fb1c7e96b4"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a727e2ab152a8fb1c7e96b4"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a727e2ab152a8fb1c7e96b4/working-account"
        }
      }
    }, {
      "id" : "google-oauth2|111754646392742988397",
      "name" : "Aaron Phethean",
      "handle" : "@aaronphethean",
      "email" : "aphethean@matatika.com",
      "workingAccount" : {
        "company" : "Aaron Phethean Account",
        "id" : "google-oauth2|111754646392742988397"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/google-oauth2%7C111754646392742988397"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "new workspace" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/google-oauth2%7C111754646392742988397/working-account"
        }
      }
    }, {
      "id" : "auth0|6a46e632d3c1845e2a0e6240",
      "name" : "SIT-Generated Profile [2026-07-02T22:29:06.403265977]",
      "handle" : "@sit-generatedprofile[2026-07-02t22:29:06.403265977]",
      "phone" : "56607772944",
      "email" : "sit+ugpijzvz@meltano.com",
      "workingAccount" : {
        "company" : "Another Company",
        "id" : "293b347a-f7ae-43c3-b04d-04c02985abc8"
      },
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a46e632d3c1845e2a0e6240"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a46e632d3c1845e2a0e6240/working-account"
        }
      }
    }, {
      "id" : "auth0|6a72e27a37708922d6b7d37d",
      "name" : "ekalra+i@meltano.com",
      "handle" : "@ekalra+i",
      "email" : "ekalra+i@meltano.com",
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/profiles"
        },
        "update edit profile" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a72e27a37708922d6b7d37d"
        },
        "workspaces" : {
          "href" : "https://staging.meltano.com/api/workspaces"
        },
        "set working account" : {
          "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a72e27a37708922d6b7d37d/working-account"
        }
      }
    } ]
  },
  "_links" : {
    "first" : {
      "href" : "https://staging.meltano.com/api/profiles?page=0&size=20"
    },
    "self" : {
      "href" : "https://staging.meltano.com/api/profiles?page=0&size=20"
    },
    "next" : {
      "href" : "https://staging.meltano.com/api/profiles?page=1&size=20"
    },
    "last" : {
      "href" : "https://staging.meltano.com/api/profiles?page=50&size=20"
    }
  },
  "page" : {
    "size" : 20,
    "totalElements" : 1020,
    "totalPages" : 51,
    "number" : 0
  }
}

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://staging.meltano.com:443/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb' -i -X GET

import requests

url = "https://staging.meltano.com:443/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb"

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|6a205ea86a76a69d8a3babcb",
  "name" : "sit@meltano.com",
  "handle" : "@sit1",
  "email" : "sit@meltano.com",
  "workingAccount" : {
    "company" : "Test Company",
    "id" : "auth0|6a205ea86a76a69d8a3babcb"
  },
  "_links" : {
    "self" : {
      "href" : "https://staging.meltano.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb"
    },
    "workspaces" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "new workspace" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "set working account" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb/working-account"
    }
  }
}

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-08-06T14:21:41.983442878]",
  "phone" : "22278495143",
  "email" : "sit+g2rd7gc2@meltano.com"
}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://staging.meltano.com:443/api/profiles/auth0%7C6a749875e2096defc96a85a2' -i -X PUT \
    -H 'Content-Type: application/json' \
    -d '{
  "name" : "SIT-Generated Profile [2026-08-06T14:21:41.983442878]",
  "phone" : "22278495143",
  "email" : "sit+g2rd7gc2@meltano.com"
}'

import requests

url = "https://staging.meltano.com:443/api/profiles/auth0%7C6a749875e2096defc96a85a2"

data = {
  "name" : "SIT-Generated Profile [2026-08-06T14:21:41.983442878]",
  "phone" : "22278495143",
  "email" : "sit+g2rd7gc2@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|6a749875e2096defc96a85a2",
  "name" : "SIT-Generated Profile [2026-08-06T14:21:41.983442878]",
  "handle" : "@sit-generatedprofile[2026-08-06t14:21:41.314256791]",
  "phone" : "22278495143",
  "email" : "sit+g2rd7gc2@meltano.com",
  "workingAccount" : {
    "id" : "auth0|6a749875e2096defc96a85a2"
  },
  "_links" : {
    "self" : {
      "href" : "https://staging.meltano.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a749875e2096defc96a85a2"
    },
    "workspaces" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "new workspace" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "set working account" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a749875e2096defc96a85a2/working-account"
    }
  }
}

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" : "d852eed7-bda4-4a02-9051-21d5a1f333fe"
  }
}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://staging.meltano.com:443/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -d '{
  "defaultWorkspace" : {
    "id" : "d852eed7-bda4-4a02-9051-21d5a1f333fe"
  }
}'

import requests

url = "https://staging.meltano.com:443/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb"

data = {
  "defaultWorkspace" : {
    "id" : "d852eed7-bda4-4a02-9051-21d5a1f333fe"
  }
}
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|6a205ea86a76a69d8a3babcb",
  "name" : "sit@meltano.com",
  "handle" : "@sit1",
  "email" : "sit@meltano.com",
  "defaultWorkspace" : {
    "name" : "Test Workspace [2026-08-06T14:21:34.121398791]",
    "id" : "d852eed7-bda4-4a02-9051-21d5a1f333fe"
  },
  "workingAccount" : {
    "company" : "Test Company",
    "id" : "auth0|6a205ea86a76a69d8a3babcb"
  },
  "_links" : {
    "self" : {
      "href" : "https://staging.meltano.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb"
    },
    "workspaces" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "new workspace" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "set working account" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb/working-account"
    }
  }
}

Set the working account for a profile

PUT /api/profiles/{profile-id}/working-account/{account-id}

Sets the working account {account-id} for the profile {profile-id}.

Prerequisites

Profile {profile-id} must exist
Account {account-id} must exist
The authentication subject must match the profile ID {profile-id}
The profile {profile-id} must be an owner of the account {account-id}

Examples

cURL
Python (requests)

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://staging.meltano.com:443/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb/working-account/auth0%7C6a46cbb368f75f9bdcc7f135' -i -X PUT \
    -H 'Content-Type: application/json'

import requests

url = "https://staging.meltano.com:443/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb/working-account/auth0%7C6a46cbb368f75f9bdcc7f135"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Profile with HAL links.

{
  "id" : "auth0|6a205ea86a76a69d8a3babcb",
  "name" : "sit@meltano.com",
  "handle" : "@sit1",
  "email" : "sit@meltano.com",
  "workingAccount" : {
    "id" : "auth0|6a46cbb368f75f9bdcc7f135"
  },
  "_links" : {
    "self" : {
      "href" : "https://staging.meltano.com/api/profiles"
    },
    "update edit profile" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb"
    },
    "workspaces" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "new workspace" : {
      "href" : "https://staging.meltano.com/api/workspaces"
    },
    "set working account" : {
      "href" : "https://staging.meltano.com/api/profiles/auth0%7C6a205ea86a76a69d8a3babcb/working-account"
    }
  }
}

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​

Set the working account for a profile​

Prerequisites​

Examples

Response​

See Also​

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

Set the working account for a profile

Prerequisites

Response

See Also