Subusers API

Subusers

親アカウントに所属しているサブユーザリソースの管理を行うことができます。

List all Subusers for a parent [GET]

親アカウントに所属しているサブユーザの一覧取得
URI引数 必須 条件 説明
limit No number 結果を取得する件数を制限します。
Example: 20
offset No number 結果を取得する位置のオフセットを指定します。
Example: 1
username No string サブユーザのユーザ名
Example: John

Request

1
GET https://api.sendgrid.com/v3/subusers?username={username}&limit={limit}&offset={offset} HTTP/1.1

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
HTTP/1.1 200
[
  {
    "id": 1,
    "username": "Test@example.com",
    "email": "Test@example.com"
  },
  {
    "id": 2,
    "username": "John@example.com",
    "email": "John@example.com"
  }
]

Create Subuser [POST]

サブユーザの作成

Request

1
POST https://api.sendgrid.com/v3/subusers HTTP/1.1
Request Body
1
2
3
4
5
6
7
8
9
{
  "username": "John@example.com",
  "email": "John@example.com",
  "password": "johns_password",
  "ips": [
    "1.1.1.1",
    "2.2.2.2"
  ]
}

Response

1
2
3
4
5
6
7
8
9
10
HTTP/1.1 201
{
  "username": "John@example.com",
  "email": "John@example.com",
  "password": "johns_password",
  "ips": [
    "1.1.1.1",
    "2.2.2.2"
  ]
}

Enable/disable a subuser [PATCH]

サブユーザの有効化/無効化

Request

1
PATCH https://api.sendgrid.com/v3/subusers/{subuser_name} HTTP/1.1
Request Body
1
2
3
{
  "disabled": false
}

Response

1
HTTP/1.1 204

Delete a subuser [DELETE]

サブユーザの削除

Request

1
DELETE https://api.sendgrid.com/v3/subusers/{subuser_name} HTTP/1.1

Response

1
HTTP/1.1 204

Retrieve monitor settings [GET]

モニタ設定の取得
URI引数 必須 条件 説明
subuser_name Yes string サブユーザのユーザ名
Example: my_subuser

Request

1
GET https://api.sendgrid.com/v3/subusers/{subuser_name}/monitor HTTP/1.1

Response

1
2
3
4
5
HTTP/1.1 200
{
  "email": "test@example.com",
  "frequency": 500
}

Create monitor settings [POST]

モニタ設定の作成
URI引数 必須 条件 説明
subuser_name Yes string サブユーザのユーザ名
Example: my_subuser

Request

1
POST https://api.sendgrid.com/v3/subusers/{subuser_name}/monitor HTTP/1.1
Request Body
1
2
3
4
{
  "email": "test@example.com",
  "frequency": 500
}

Response

1
2
3
4
5
HTTP/1.1 200
{
  "email": "test@example.com",
  "frequency": 500
}

Update monitor settings [PUT]

モニタ設定の更新
URI引数 必須 条件 説明
subuser_name Yes string サブユーザのユーザ名
Example: my_subuser

Request

1
PUT https://api.sendgrid.com/v3/subusers/{subuser_name}/monitor HTTP/1.1
Request Body
1
2
3
4
{
  "email": "test@example.com",
  "frequency": 500
}

Response

1
2
3
4
5
HTTP/1.1 200
{
  "email": "test@example.com",
  "frequency": 500
}

Delete monitor settings [DELETE]

モニタ設定の削除
URI引数 必須 条件 説明
subuser_name Yes string サブユーザのユーザ名
Example: my_subuser

Request

1
DELETE https://api.sendgrid.com/v3/subusers/{subuser_name}/monitor HTTP/1.1

Response

1
HTTP/1.1 204

Retrieve Subuser Reputations [GET]

サブユーザのレピュテーション取得
URI引数 必須 条件 説明
usernames Yes string 文字列の配列。レピュテーションを取得するサブユーザのユーザ名。
Example: my_subuser

Request

1
GET https://api.sendgrid.com/v3/subusers/reputations?usernames={usernames} HTTP/1.1

Response

1
2
3
4
5
6
7
8
9
10
11
HTTP/1.1 200
[
  {
    "username": "user1",
    "reputation": 99.0
  },
  {
    "username": "user2",
    "reputation": 95.2
  }
]

Update IPs assigned to a subuser [PUT]

サブユーザに割り当てられているIPの更新
URI引数 必須 条件 説明
subuser_name Yes string サブユーザのユーザ名

Request

1
PUT https://api.sendgrid.com/v3/subusers/{subuser_name}/ips HTTP/1.1
Request Body
1
2
3
4
[
  "127.0.0.1",
  "127.0.0.2"
]

Response

1
2
3
4
5
6
7
HTTP/1.1 200
{
  "ips": [
    "127.0.0.1",
    "127.0.0.2"
  ]
}