Account Admins

get
Authorizations
AuthorizationstringRequired

API Token based authentication. Use format: Token token="your-api-key"

Query parameters
pageintegerOptional

Page number for pagination (defaults to 0)

sortstringOptional

Sort field (only 'name')

searchstringOptional

Search query to filter account admins

per_pagestringOptional

Number of results per page

sizestringOptional

Alternative to per_page parameter

Responses
200

Listing account admins

application/json
Responseobject
get
/api/v1/account_admins
GET /api/v1/account_admins HTTP/1.1
Host: REPLACE_ME
Authorization: YOUR_API_KEY
Accept: */*
200

Listing account admins

{
  "content": [
    {
      "id": 1,
      "name": "Test Admin",
      "canvas_user_id": "12345",
      "email": "[email protected]",
      "accounts": [
        {
          "id": 10,
          "name": "Domain Account 10"
        }
      ]
    }
  ],
  "page": {
    "number": 0,
    "size": 20,
    "totalElements": 1,
    "totalPages": 1
  }
}
post
Authorizations
AuthorizationstringRequired

API Token based authentication. Use format: Token token="your-api-key"

Body
canvas_user_idstringRequired

Canvas user ID

user_namestringRequired

Full name of the user

email_addressstringRequired

Email address of the user

account_idsstringRequired

Array of account IDs to associate with the user

Responses
post
/api/v1/account_admins
POST /api/v1/account_admins HTTP/1.1
Host: REPLACE_ME
Authorization: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 88

"canvas_user_id='text'&user_name='text'&email_address='text'&account_ids='text'"
201

Creating an account admin association

{
  "id": 1,
  "name": "Test Admin",
  "canvas_user_id": "12345",
  "email": "[email protected]",
  "accounts": [
    {
      "id": 12,
      "name": "Domain Account 12"
    }
  ]
}
delete
Authorizations
AuthorizationstringRequired

API Token based authentication. Use format: Token token="your-api-key"

Path parameters
idstringRequired
account_idintegerRequired
Responses
delete
/api/v1/account_admins/{id}/accounts/{account_id}
DELETE /api/v1/account_admins/{id}/accounts/{account_id} HTTP/1.1
Host: REPLACE_ME
Authorization: YOUR_API_KEY
Accept: */*
204

Deleting a specific account admin association

{}
delete
Authorizations
AuthorizationstringRequired

API Token based authentication. Use format: Token token="your-api-key"

Path parameters
idstringRequired
Responses
delete
/api/v1/account_admins/{id}
DELETE /api/v1/account_admins/{id} HTTP/1.1
Host: REPLACE_ME
Authorization: YOUR_API_KEY
Accept: */*
204

Deleting all account admin associations

{}

Last updated

Was this helpful?