Waiting for engine...
Skip to main content

Boomi Platform API Reference (1.0.0) - AccountGroupAccount

Toggle Pane
API docs by Redocly

License: Boomi API License and Rate Limits

Download OpenAPI Specification: Download

AccountGroupAccount

The Account Group Account object represents the linkage between an account and an account group. You can query, add, and remove accounts in an account group.

Note: To facilitate these operations on this object in an integration process, use the Platform Partner API connector instead of the Platform API connector.

Required Privileges

Read and Write access

  • API — Use the Boomi Platform API to access account data.
  • ACCOUNT_ADMIN — Account configuration and administration.

Creates an AccountGroupAccount object

Adds an account to an account group.

Authorizations:
basicAuth
Request Body schema:
optional
accountGroupId
string

The ID of the account group.

accountId
string

The ID of the account.

id
string

The object’s conceptual ID from which the account and account group IDs synthesizes.

Responses

Response Schema:
accountGroupId
string

The ID of the account group.

accountId
string

The ID of the account.

id
string

The object’s conceptual ID from which the account and account group IDs synthesizes.

Request samples

Content type
{
  • "accountId": "account-123456",
  • "accountGroupId": "fedcba98-7654-3210-fedc-ba9876543c210"
}

Response samples

Content type
{
  • "@type": "AccountGroupAccount",
  • "id": "gAb0Cd1Ef1Gh3Ij4Kl5Mn6Op7Qr8St9Uv0Wx9Yz8Zy7Xw6Vu5Ts4Rq3Po2Nm1Lk0Ji1H",
  • "accountGroupId": "fedcba98-7654-3210-fedc-ba9876543210",
  • "accountId": "account-123456"
}

Queries for an AccountGroupAccount object(s)

For general information about the structure of QUERY filters, their sample payloads, and how to handle the paged results, refer to Query filters and Query paging.

Authorizations:
basicAuth
Request Body schema:
optional

Possible properties include: accountGroupId, accountId

required
object
required
AccountGroupAccountSimpleExpression (object) or AccountGroupAccountGroupingExpression (object) (AccountGroupAccountExpression)
One of
operator
required
string
Enum: "EQUALS" "LIKE" "NOT_EQUALS" "IS_NULL" "IS_NOT_NULL" "BETWEEN" "GREATER_THAN" "GREATER_THAN_OR_EQUAL" "LESS_THAN" "LESS_THAN_OR_EQUAL" "CONTAINS" "NOT_CONTAINS"
property
required
string
Enum: "accountGroupId" "accountId"
argument
Array of strings

Responses

Response Schema:
numberOfResults
integer <int32>
queryToken
string

By default, the queryToken parameter is not available in the query response. It appears only when the query response contains more than 100 results. The maximum number of results returned per query is 100. To retrieve the next set of results, use the queryToken in the queryMore request.

Array of objects (AccountGroupAccount)

Request samples

Content type
Example
{
  • "QueryFilter": {
    • "expression": {
      }
    }
}

Response samples

Content type
{
  • "numberOfResults": 2,
  • "@type": "QueryResult",
  • "result": [
    • {
      },
    • {
      }
    ]
}

Retrieves additional results for an AccountGroupAccount query

To learn about using queryMore, refer to the topic Query paging.

Authorizations:
basicAuth
Request Body schema: text/plain
required
string

Responses

Response Schema:
numberOfResults
integer <int32>
queryToken
string

By default, the queryToken parameter is not available in the query response. It appears only when the query response contains more than 100 results. The maximum number of results returned per query is 100. To retrieve the next set of results, use the queryToken in the queryMore request.

Array of objects (AccountGroupAccount)

Response samples

Content type
{
  • "numberOfResults": 2,
  • "@type": "QueryResult",
  • "result": [
    • {
      },
    • {
      }
    ]
}

Deletes an AccountGroupAccount object

Removes an account from an account group.

Authorizations:
basicAuth
path Parameters
id
required
string

The object’s conceptual ID from which the account and account group IDs synthesizes.

Responses

Response samples

Content type
{
  • "message": "Access denied due to insufficient permissions."
}