Projects

Organize test environments

Interactions with projects

Get a list of projects

get

List projects and their sandboxes to which the API token has access.

Authorizations

Api-TokenstringRequired

Pass the API token in the Api-Token

Responses

200

Lists project attributes and inboxes of this project with their attributes.

permissions returns the permissions of the token for the project

application/json

idintegerOptional

namestringOptional

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

get/api/projects

curl -X GET https://mailtrap.io/api/projects \
  -H 'Authorization: Bearer YOUR_API_KEY'

[
  {
    "id": 2435,
    "name": "Viewer Project",
    "sandboxes": [],
    "permissions": {
      "can_read": true,
      "can_update": false,
      "can_destroy": false,
      "can_leave": true
    }
  },
  {
    "id": 2436,
    "name": "Admin Project",
    "share_links": {
      "admin": "https://localhost/projects/2436/share/QEVuQwEAYWN-NIhmrB8qX6ZWzToqdOE9dw1ylIfOQ-_fKwYAD_CCkhRzmAanker219x25PM75TBaHgx1I4dsv058hghY_Ewaa3Vt7ET1aeg3ufVcit919V4baPLzxV9JaRzXWSjK",
      "viewer": "https://localhost/projects/2436/share/QEVuQwEAYWN-NIhmrB8qX6ZWzToqdOE9dw1ylIfOQ-_fKwYAD_CCkhRzmAanker219x25PM7YSu12_li4QtOGl363syqCpKX7vlXvIub7b_V1BU2qypVHfspL7qfSIja0edd7hSh"
    },
    "sandboxes": [
      {
        "id": 3874,
        "name": "Admin Sandbox",
        "username": "f796d276ca4d13",
        "password": "293caeb0f100e4",
        "max_size": 0,
        "status": "active",
        "email_username": "bcf11679c1-ad3171",
        "email_username_enabled": false,
        "sent_messages_count": 316,
        "forwarded_messages_count": 0,
        "used": false,
        "forward_from_email_address": "a3343-i3874@forward.mailtrap.info",
        "project_id": 2436,
        "domain": "localhost",
        "pop3_domain": "localhost",
        "email_domain": "localhost",
        "emails_count": 0,
        "emails_unread_count": 0,
        "last_message_sent_at": null,
        "smtp_ports": [
          25,
          465,
          587,
          2525
        ],
        "pop3_ports": [
          1100,
          9950
        ],
        "max_message_size": 5242880,
        "permissions": {
          "can_read": true,
          "can_update": true,
          "can_destroy": true,
          "can_leave": false
        }
      }
    ],
    "permissions": {
      "can_read": true,
      "can_update": true,
      "can_destroy": true,
      "can_leave": true
    }
  }
]

Create project

post

The project name is min 2 characters and max 100 characters long.

Authorizations

Api-TokenstringRequired

Pass the API token in the Api-Token

Body

Responses

200

Returns project details

application/json

idintegerOptional

namestringOptional

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

post/api/projects

curl -X POST https://mailtrap.io/api/projects \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "project": {
      "name": "My New Project"
    }
  }'

{
  "id": 2388,
  "name": "My New Project",
  "share_links": {
    "admin": "https://localhost/projects/2388/share/QEVuQwEAS-hQfYV1hqw15p7p9VcsuCrASDQUkcuV_N5G-zdVBPrd58V8Ce09AUl-JGFEJsQbt-K6IzRIMhjpU7zxAnIo9QpB8mJwuOqBiottfwdDhgKO-ab7t7WDCyyoGeG5dLK_",
    "viewer": "https://localhost/projects/2388/share/QEVuQwEAS-hQfYV1hqw15p7p9VcsuCrASDQUkcuV_N5G-zdVBPrd58V8Ce09AUl-JGFEJsQbHDFqI6Mk2wRVlVSxLNMgI-3LnWpSSSyCSbjqkQRAMPVoTPYF7WcXfw4H_CwkAc4e"
  },
  "sandboxes": [],
  "permissions": {
    "can_read": true,
    "can_update": true,
    "can_destroy": true,
    "can_leave": false
  }
}

Get project by ID

get

Get the project and its sandboxes.

Authorizations

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

project_idinteger · int64 · min: 1Required

Unique project ID

Example: 4032

Responses

200

Returns project details

application/json

idintegerOptional

namestringOptional

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

get/api/projects/{project_id}

curl -X GET https://mailtrap.io/api/projects/{project_id} \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": 2388,
  "name": "My New Project",
  "share_links": {
    "admin": "https://localhost/projects/2388/share/QEVuQwEAS-hQfYV1hqw15p7p9VcsuCrASDQUkcuV_N5G-zdVBPrd58V8Ce09AUl-JGFEJsQbt-K6IzRIMhjpU7zxAnIo9QpB8mJwuOqBiottfwdDhgKO-ab7t7WDCyyoGeG5dLK_",
    "viewer": "https://localhost/projects/2388/share/QEVuQwEAS-hQfYV1hqw15p7p9VcsuCrASDQUkcuV_N5G-zdVBPrd58V8Ce09AUl-JGFEJsQbHDFqI6Mk2wRVlVSxLNMgI-3LnWpSSSyCSbjqkQRAMPVoTPYF7WcXfw4H_CwkAc4e"
  },
  "sandboxes": [],
  "permissions": {
    "can_read": true,
    "can_update": true,
    "can_destroy": true,
    "can_leave": false
  }
}

Delete project

delete

Delete project and its sandboxes.

Authorizations

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

project_idinteger · int64 · min: 1Required

Unique project ID

Example: 4032

Responses

200

Returns id of the deleted project.

application/json

idintegerOptional

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

delete/api/projects/{project_id}

curl -X DELETE https://mailtrap.io/api/projects/{project_id} \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": 4046
}

Update project

patch

Update project name. The project name is min 2 characters and max 100 characters long.

Authorizations

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

project_idinteger · int64 · min: 1Required

Unique project ID

Example: 4032

Body

Responses

200

Returns updated project details

application/json

idintegerOptional

namestringOptional

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

patch/api/projects/{project_id}

curl -X PATCH https://mailtrap.io/api/projects/{project_id} \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "project": {
      "name": "Updated Project Name"
    }
  }'

{
  "id": 2436,
  "name": "Admin Project",
  "share_links": {
    "admin": "https://localhost/projects/2436/share/QEVuQwEAYWN-NIhmrB8qX6ZWzToqdOE9dw1ylIfOQ-_fKwYAD_CCkhRzmAanker219x25PM75TBaHgx1I4dsv058hghY_Ewaa3Vt7ET1aeg3ufVcit919V4baPLzxV9JaRzXWSjK",
    "viewer": "https://localhost/projects/2436/share/QEVuQwEAYWN-NIhmrB8qX6ZWzToqdOE9dw1ylIfOQ-_fKwYAD_CCkhRzmAanker219x25PM7YSu12_li4QtOGl363syqCpKX7vlXvIub7b_V1BU2qypVHfspL7qfSIja0edd7hSh"
  },
  "sandboxes": [
    {
      "id": 3874,
      "name": "Admin Sandbox",
      "username": "f796d276ca4d13",
      "password": "293caeb0f100e4",
      "max_size": 0,
      "status": "active",
      "email_username": "bcf11679c1-ad3171",
      "email_username_enabled": false,
      "sent_messages_count": 316,
      "forwarded_messages_count": 0,
      "used": false,
      "forward_from_email_address": "a3343-i3874@forward.mailtrap.info",
      "project_id": 2436,
      "domain": "localhost",
      "pop3_domain": "localhost",
      "email_domain": "localhost",
      "emails_count": 0,
      "emails_unread_count": 0,
      "last_message_sent_at": null,
      "smtp_ports": [
        25,
        465,
        587,
        2525
      ],
      "pop3_ports": [
        1100,
        9950
      ],
      "max_message_size": 5242880,
      "permissions": {
        "can_read": true,
        "can_update": true,
        "can_destroy": true,
        "can_leave": false
      }
    }
  ],
  "permissions": {
    "can_read": true,
    "can_update": true,
    "can_destroy": true,
    "can_leave": true
  }
}

PreviousSend Test Emails NextSandboxes

Last updated 1 hour ago

Was this helpful?