Cloudflare.User (Cloudflare v0.5.0)

Copy Markdown View Source

User

Edit User

PATCH /user

Edit part of your user details.

Responses

200 Edit User response

Data is at body["result"]

{
  "betas": [
    "*string*"
  ],
  "country": "*string*",
  "first_name": "*string*",
  "has_business_zones": "*boolean*",
  "has_enterprise_zones": "*boolean*",
  "has_pro_zones": "*boolean*",
  "id": "*string*",
  "last_name": "*string*",
  "organizations": [
    {
      "id": "*string*",
      "name": "*string*",
      "permissions": [
        null
      ],
      "roles": [
        "*string*"
      ],
      "status": "*string*"
    }
  ],
  "suspended": "*boolean*",
  "telephone": "*string*",
  "two_factor_authentication_enabled": "*boolean*",
  "two_factor_authentication_locked": "*boolean*",
  "zipcode": "*string*"
}
4XX Edit User response failure
{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}

User Details

GET /user

Responses

200 User Details response

Data is at body["result"]

{
  "betas": [
    "*string*"
  ],
  "country": "*string*",
  "first_name": "*string*",
  "has_business_zones": "*boolean*",
  "has_enterprise_zones": "*boolean*",
  "has_pro_zones": "*boolean*",
  "id": "*string*",
  "last_name": "*string*",
  "organizations": [
    {
      "id": "*string*",
      "name": "*string*",
      "permissions": [
        null
      ],
      "roles": [
        "*string*"
      ],
      "status": "*string*"
    }
  ],
  "suspended": "*boolean*",
  "telephone": "*string*",
  "two_factor_authentication_enabled": "*boolean*",
  "two_factor_authentication_locked": "*boolean*",
  "zipcode": "*string*"
}
4XX User Details response failure
{
  "errors": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "documentation_url": "*string*",
      "message": "*string*",
      "source": {
        "pointer": "*string*"
      }
    }
  ],
  "result": {},
  "success": "*boolean*"
}

List user tenants

GET /users/tenants

Retrieves list of tenants the authenticated user / method has access to.

Responses

200 The request has succeeded.

Data is at body["result"]

[
  {
    "create_time": "*string*",
    "id": "*string*",
    "meta": {
      "flags": null,
      "managed_by": "*string*"
    },
    "name": "*string*",
    "parent": {
      "id": "*string*",
      "name": "*string*"
    },
    "profile": {
      "business_address": "*string*",
      "business_email": "*string*",
      "business_name": "*string*",
      "business_phone": "*string*",
      "external_metadata": "*string*"
    }
  }
]
4XX An unexpected error response.
{
  "errors": [
    {
      "code": "*integer*",
      "message": "*string*"
    }
  ],
  "messages": [
    {
      "code": "*integer*",
      "message": "*string*"
    }
  ],
  "result": {},
  "success": "*boolean*"
}

Summary

Functions

client(opts \\ [])

path_for(id, opts \\ [])

@spec path_for(term(), [{:action, String.t()}]) :: String.t()

show(opts \\ [])

@spec show(opts :: Restlax.Resource.action_options()) ::
  {:ok, map()} | {:error, term()}

show!(opts \\ [])

@spec show!(opts :: Restlax.Resource.action_options()) :: map() | no_return()

update(body, opts \\ [])

@spec update(
  body :: Restlax.Resource.action_body(),
  opts :: Restlax.Resource.action_options()
) ::
  {:ok, map()} | {:error, term()}

update!(body, opts \\ [])

@spec update!(
  body :: Restlax.Resource.action_body(),
  opts :: Restlax.Resource.action_options()
) ::
  map() | no_return()