Add connection admin
- OpenAPI 3.1.0 document: https://api.rollstack.com/public/v1/openapi.json
- The whole reference in Markdown: https://docs.rollstack.com/llms-full.txt
- An index of the reference: https://docs.rollstack.com/llms.txt
PUT https://api.rollstack.com/public/v1/connections/{type}/{id}/admins/{userId}
Makes an active member an admin of a connection. Only its owner may.
Requires the connections:write scope.
Operation ID: setConnectionAdmin.
Path parameters
type(string, required): The data source the connection reads from:Tableau,Looker,Metabase,PowerBI,Lightdash,Omni,SigmaorSalesforce, or theSnowflake,DatabricksorBigQuerydata warehouse. Endpoints that act on a connection take it in their path, with the connection'sid. One ofTableau,Looker,Metabase,PowerBI,Lightdash,Omni,Sigma,Salesforce,Snowflake,Databricks,BigQuery.id(string, required): Unique identifier for the connection, fromlistConnections, which also returns itstype.userId(integer, required): The member to act on, by theiridfromlistMembers. ForremoveConnectionUser, one of the connection's users, as listed bylistConnectionUsers. ForsetConnectionAdmin, any active member of your organization except the connection's owner. ForremoveConnectionAdmin, one of the connection's admins, as listed inadminsbygetConnection, except its owner.
Headers
Idempotency-Key(string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.
Request body, required
application/json
role(string, required): The role to give the member on the connection. Onlyadminis accepted: admins manage the connection's users and can change its settings and credentials, while only the owner can delete the connection or add and remove admins. Ownership can be transferred only in the app. Being an admin doesn't make them one of the connection's users: add them withaddConnectionUserstoo if they need access of their own. One ofadmin.
Response 200
Success
application/json
userId(number, required): The member who is now an admin of the connection, as theiridinlistMembers.role(string, required): The member's role on the connection, alwaysadminhere. Admins manage the connection's users, settings and credentials. The other role,owner, belongs to the connection's owner, who can also delete the connection and choose its admins; it can't be given through the API. One ofowner,admin.