Change login access
curl --request PUT \
--url https://api.pomerado.ai/v1/logins/{id}/access \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"grantee": {
"type": "team"
}
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({grantee: {type: 'team'}})
};
fetch('https://api.pomerado.ai/v1/logins/{id}/access', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/logins/{id}/access"
payload = { "grantee": { "type": "team" } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"login_id": "<string>",
"creator": {
"user_id": "<string>",
"name": "<string>",
"email": "<string>",
"former": true
},
"team": "use",
"members": [
{
"user_id": "<string>",
"name": "<string>",
"email": "<string>",
"former": true,
"level": "use"
}
]
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Login access
Change login access
Gives one member or the whole team access to a Business team’s saved login, or removes it.
PUT
/
v1
/
logins
/
{id}
/
access
Change login access
curl --request PUT \
--url https://api.pomerado.ai/v1/logins/{id}/access \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"grantee": {
"type": "team"
}
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({grantee: {type: 'team'}})
};
fetch('https://api.pomerado.ai/v1/logins/{id}/access', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/logins/{id}/access"
payload = { "grantee": { "type": "team" } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"login_id": "<string>",
"creator": {
"user_id": "<string>",
"name": "<string>",
"email": "<string>",
"former": true
},
"team": "use",
"members": [
{
"user_id": "<string>",
"name": "<string>",
"email": "<string>",
"former": true,
"level": "use"
}
]
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Details
Details
- A member can get use, edit or manage; the whole team, use or edit. A level of null removes access.
- No one can change the access of the login’s creator, an Owner or an Admin.
- Removing someone’s last access stops their unfinished jobs on the login.
- Only the Dashboard makes the change, for someone who manages the login. Elsewhere this returns a dashboard_url to the login’s Share menu.
- Callers: an API key, an MCP OAuth token or a Dashboard session.
-
Permission:
logins:manage. - Effect: Creates or changes something.
-
Errors:
not_found,login_access_required,team_unavailable,access_fixed,grantee_not_member,team_level_not_allowed, and the errors any request can get.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
a saved login ID: login_ and 32 lowercase hex digits
Example:
"login_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
Body
application/json
Response
On the Dashboard: who has access now; Elsewhere: the Share menu
- Option 1
- Option 2
Who created it, and so manages it; null for a login saved before teams existed
Show child attributes
Show child attributes
The whole team's level, later joiners included; null when the team has none
Available options:
use, edit Each member's own level. Every Owner and Admin manages it whatever this lists
Show child attributes
Show child attributes