# account authorizations — NCM API

Beta. Maps each user in an account to their NetCloud Manager role, which controls the features and functionality they can reach. Read and update only: list every authorization, fetch one by ID, or change a user's role. For tenant-wide rather than per-account roles, see tenant authorizations.

Base URL: https://api.cradlepointecm.com

### GET /api/v3/beta/account_authorizations

api_v3_beta_account_authorizations_list

Return a list of account authorizations

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| filter[role] | query | string | no |  |
| filter[user] | query | string | no |  |
| page[after] | query | string | no | Cursor for next page. |
| page[before] | query | string | no | Cursor for prior page. |
| page[size] | query | integer | no | Number of results to return per page. |
| search | query | string | no | The search query param performs a case insensitive substring search on a set of fields. <br> A record matches if any search field matches the search text. <br>If the search param doesn't include a field list, the server selects the fields. <br>Example:<ul><li>Search by substring: `search=substring1,substring2` </li><li>Search by field(s) and substring: `search[fieldA,fieldB]=substring1,substring2,substring3` </li><ul> |
| sort | query | string | no | Which field to use when ordering the results. |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/v3/beta/account_authorizations" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

```json
{
  "links": {
    "next": null,
    "prev": null
  },
  "data": [
    {
      "type": "account_authorizations",
      "id": "11992548",
      "attributes": {
        "role": "no_access"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "muU8o4fXj1IKwzuq"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "35065"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/11992548"
      }
    },
    {
      "type": "account_authorizations",
      "id": "11983179",
      "attributes": {
        "role": "read_only_user"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "AV20vjGeLxHvUz1k"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "35065"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/11983179"
      }
    },
    {
      "type": "account_authorizations",
      "id": "11960726",
      "attributes": {
        "role": "no_access"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "xaqY5j9vtwCmpKmm"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "35065"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/11960726"
      }
    },
    {
      "type": "account_authorizations",
      "id": "11777990",
      "attributes": {
        "role": "administrator"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "038Bd0s1O9tzah0g"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "35065"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/11777990"
      }
    },
    {
      "type": "account_authorizations",
      "id": "12069672",
      "attributes": {
        "role": "administrator"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "YAxyGfNUofpmZ9US"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "35065"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/12069672"
      }
    },
    {
      "type": "account_authorizations",
      "id": "12094610",
      "attributes": {
        "role": "no_access"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "RyGDWX1TxzAbhudA"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "35065"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/12094610"
      }
    },
    {
      "type": "account_authorizations",
      "id": "11882552",
      "attributes": {
        "role": "full_access_user"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "vOAwbFAMbagtevl9"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "36023"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/11882552"
      }
    },
    {
      "type": "account_authorizations",
      "id": "11882550",
      "attributes": {
        "role": "read_only_user"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "ZrUD6zA71bgQJ2Eq"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "36023"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/11882550"
      }
    },
    {
      "type": "account_authorizations",
      "id": "11822756",
      "attributes": {
        "role": "read_only_user"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "AzTbfmCmAvnb5Q5R"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "36023"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/11822756"
      }
    },
    {
      "type": "account_authorizations",
      "id": "11990571",
      "attributes": {
        "role": "read_only_user"
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "cqyqg7tckTMpHuZ5"
          }
        },
        "account": {
          "data": {
            "type": "accounts",
            "id": "84906"
          }
        }
      },
      "links": {
        "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/11990571"
      }
    }
  ],
  "meta": {
    "pagination": {
      "before": null,
      "after": null
    }
  }
}
```

### GET /api/v3/beta/account_authorizations/{id}

api_v3_beta_account_authorizations_retrieve

Get a single account authorization resource

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### PUT /api/v3/beta/account_authorizations/{id}

api_v3_beta_account_authorizations_update

Update an existing account authorization

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Request body**

**Example request**

```bash
curl -X PUT "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

```json
{
  "data": {
    "type": "account_authorizations",
    "id": "11983179",
    "attributes": {
      "role": "no_access"
    },
    "relationships": {
      "user": {
        "data": {
          "type": "users",
          "id": "AV20vjGeLxHvUz1k"
        }
      },
      "account": {
        "data": {
          "type": "accounts",
          "id": "35065"
        }
      }
    },
    "links": {
      "self": "https://api.cradlepointecm.com/api/v3/beta/account_authorizations/11983179"
    }
  }
}
```