Accounts API


List all accounts

GET /accounts

Parameters

name
required: false
Name of an account (fuzzy partial-name case-insensitive matching)
name_exactly
required: false
Name of an account (exact matching)
user_id
required: false
User ID of a User that belongs to an account
support_plan
required: false
Support plan of accounts
billing_plan_support
required: false
Billing plan support of accounts
legacy_id
required: false
Support plan of accounts

Request

          Accept: application/json
          Content-Type: application/json
          
            
          {
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "accounts": [
              {
                "id": "819096e1-f0d1-4726-a221-467eeee57b81",
                "account_notes": "https://api.engineyard.com/accounts-notes.819096e1-f0d1-4726-a221-467eeee57b81",
                "account_trial": null,
                "addons": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/addons",
                "addresses": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/addresses",
                "applications": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/applications",
                "billable": true,
                "billing_plan_support": "standard",
                "billing_required": false,
                "billing_signup_url": null,
                "canceled_at": null,
                "cancellation": null,
                "cancelled_at": null,
                "created_at": "2018-05-29T10:56:40+00:00",
                "database_services": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/database-services",
                "emergency_contact": null,
                "environments": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/environments",
                "features": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/features",
                "finalized": true,
                "logical_databases": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/logical-databases",
                "memberships": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/memberships",
                "name": "account-819096e1-f0d1-4726-a221-467eeee57b81",
                "owners": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/owners",
                "plan": null,
                "providers": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/providers",
                "rds_management_web_uri": "https://example.org/accounts/152/database_services",
                "referrals": null,
                "referrer_account": null,
                "requests": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/requests",
                "server_alerts": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/server-alerts",
                "signup_via": "classic",
                "ssl_certificates": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/ssl-certificates",
                "support_plan": "standard",
                "support_trial": null,
                "support_trial_status": "NA",
                "updated_at": "2018-05-29T10:56:40+00:00",
                "users": "https://api.engineyard.com/accounts/819096e1-f0d1-4726-a221-467eeee57b81/users"
              }
            ]
          }
            
          








List all accounts for a given user

GET /users/:user_id/accounts

Parameters

name
required: false
Name of an account
user_id
required: false
User ID of a User that belongs to an account
support_plan
required: false
Support plan of accounts
billing_plan_support
required: false
Billing plan support of accounts
legacy_id
required: false
Support plan of accounts

Request

          Accept: application/json
          Content-Type: application/json
          
            
          {
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "accounts": [
              {
                "id": "be10453c-5893-4336-bff0-dc4e6cbe5b9f",
                "account_notes": "https://api.engineyard.com/accounts-notes.be10453c-5893-4336-bff0-dc4e6cbe5b9f",
                "account_trial": null,
                "addons": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/addons",
                "addresses": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/addresses",
                "applications": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/applications",
                "billable": true,
                "billing_plan_support": "standard",
                "billing_required": false,
                "billing_signup_url": null,
                "canceled_at": null,
                "cancellation": null,
                "cancelled_at": null,
                "created_at": "2018-05-29T10:56:42+00:00",
                "database_services": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/database-services",
                "emergency_contact": null,
                "environments": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/environments",
                "features": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/features",
                "finalized": true,
                "logical_databases": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/logical-databases",
                "memberships": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/memberships",
                "name": "account-be10453c-5893-4336-bff0-dc4e6cbe5b9f",
                "owners": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/owners",
                "plan": null,
                "providers": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/providers",
                "rds_management_web_uri": "https://example.org/accounts/153/database_services",
                "referrals": null,
                "referrer_account": null,
                "requests": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/requests",
                "server_alerts": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/server-alerts",
                "signup_via": "classic",
                "ssl_certificates": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/ssl-certificates",
                "support_plan": "standard",
                "support_trial": null,
                "support_trial_status": "NA",
                "updated_at": "2018-05-29T10:56:42+00:00",
                "users": "https://api.engineyard.com/accounts/be10453c-5893-4336-bff0-dc4e6cbe5b9f/users"
              }
            ]
          }
            
          








Show an account

GET /accounts/:account_id

Request

          Accept: application/json
          Content-Type: application/json
          
            
          {
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "account": {
              "id": "998593cc-e08e-4064-9862-30178dd89977",
              "account_notes": "https://api.engineyard.com/accounts-notes.998593cc-e08e-4064-9862-30178dd89977",
              "account_trial": null,
              "addons": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/addons",
              "addresses": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/addresses",
              "applications": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/applications",
              "billable": true,
              "billing_plan_support": "standard",
              "billing_required": false,
              "billing_signup_url": null,
              "canceled_at": null,
              "cancellation": null,
              "cancelled_at": null,
              "created_at": "2018-05-29T10:56:44+00:00",
              "database_services": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/database-services",
              "emergency_contact": null,
              "environments": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/environments",
              "features": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/features",
              "finalized": true,
              "logical_databases": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/logical-databases",
              "memberships": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/memberships",
              "name": "account-998593cc-e08e-4064-9862-30178dd89977",
              "owners": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/owners",
              "plan": null,
              "providers": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/providers",
              "rds_management_web_uri": "https://example.org/accounts/154/database_services",
              "referrals": null,
              "referrer_account": null,
              "requests": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/requests",
              "server_alerts": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/server-alerts",
              "signup_via": "classic",
              "ssl_certificates": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/ssl-certificates",
              "support_plan": "standard",
              "support_trial": null,
              "support_trial_status": "NA",
              "updated_at": "2018-05-29T10:56:44+00:00",
              "users": "https://api.engineyard.com/accounts/998593cc-e08e-4064-9862-30178dd89977/users"
            }
          }
            
          








Update account's emergency contact

PUT /accounts/:account_id

Parameters

name
required: false
scope: account
Name of the account
emergency_contact
required: false
scope: account
My Emergency Contact

Request

          Accept: application/json
          Content-Type: application/json
          
            
          {
            "account": {
              "emergency_contact": "My New Emergency Contact"
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "account": {
              "id": "5db8af7e-2054-40b6-b852-15fe4b0ca1de",
              "account_notes": "https://api.engineyard.com/accounts-notes.5db8af7e-2054-40b6-b852-15fe4b0ca1de",
              "account_trial": null,
              "addons": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/addons",
              "addresses": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/addresses",
              "applications": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/applications",
              "billable": true,
              "billing_plan_support": "standard",
              "billing_required": false,
              "billing_signup_url": null,
              "canceled_at": null,
              "cancellation": null,
              "cancelled_at": null,
              "created_at": "2018-05-29T10:56:45+00:00",
              "database_services": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/database-services",
              "emergency_contact": "My New Emergency Contact",
              "environments": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/environments",
              "features": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/features",
              "finalized": true,
              "logical_databases": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/logical-databases",
              "memberships": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/memberships",
              "name": "account-5db8af7e-2054-40b6-b852-15fe4b0ca1de",
              "owners": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/owners",
              "plan": null,
              "providers": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/providers",
              "rds_management_web_uri": "https://example.org/accounts/155/database_services",
              "referrals": null,
              "referrer_account": null,
              "requests": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/requests",
              "server_alerts": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/server-alerts",
              "signup_via": "classic",
              "ssl_certificates": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/ssl-certificates",
              "support_plan": "standard",
              "support_trial": null,
              "support_trial_status": "NA",
              "updated_at": "2018-05-29T10:56:47+00:00",
              "users": "https://api.engineyard.com/accounts/5db8af7e-2054-40b6-b852-15fe4b0ca1de/users"
            }
          }