Permissions

Manage user or token permissions

put

Manage user or token permissions. For this endpoint, you should send an array of objects (in JSON format) as the body of the request. If you send a combination of resource_type and resource_id that already exists, the permission is updated. If the combination doesn't exist, the permission is created.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

account_access_idinteger · int64 · min: 1Required

Unique account access ID

Example: 5142

Body

application/json

Responses

200

Returns message about successful update of permissions.

application/json

messagestringOptional

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

404

Returns not found error message

application/json

put

/api/account_accesses/{account_access_id}/permissions/bulk

cURLNode.jsPHPPythonC#Java

curl -X PUT https://mailtrap.io/api/account_accesses/{account_access_id}/permissions/bulk \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "permissions": [
      {"resource_id": "3281", "resource_type": "account", "access_level": "viewer"}
    ]
  }'

{
  "message": "Permissions have been updated!"
}

Get resources

get

Get all resources in your account (Sandboxes, Projects, Domains, Email Campaigns, Billing and Account itself) to which the token has admin access.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

Pass the API token in the Api-Token

Responses

200

Returns the resources nested according to their hierarchy.

• access_level in this response represents the access level of the token used to make the request.

application/json

Nested resource tree for permission management. type values include account, project, sandbox, domain, email_template_permission_scope, email_campaign_permission_scope, and others.

idintegerOptional

namestringOptional

typestringOptional

access_levelintegerOptional

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

get

/api/permissions/resources

cURLNode.jsPHPPythonC#Java

curl -X GET https://mailtrap.io/api/permissions/resources \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

[
  {
    "id": 1774100,
    "name": "Account",
    "type": "account",
    "access_level": 100,
    "resources": [
      {
        "id": 1774100,
        "name": "Templates",
        "type": "email_template_permission_scope",
        "access_level": 100,
        "resources": []
      },
      {
        "id": 2550469,
        "name": "My Project",
        "type": "project",
        "access_level": 100,
        "resources": [
          {
            "id": 4117907,
            "name": "My Sandbox",
            "type": "sandbox",
            "access_level": 100,
            "resources": []
          }
        ]
      }
    ]
  }
]