Sign in
business_access_invite

Accept or decline an invite/request

Accept or decline invites or requests.

patch/businesses/invites

Request body

Example request

{
  "invites": [
    {
      "action": {
        "asset_id_to_permissions": {
          "549760723247": [
            "ANALYST"
          ],
          "549760723248": [
            "ANALYST",
            "ADMIN"
          ],
          "809944451643622187": [
            "PROFILE_PUBLISHER"
          ]
        }
      }
    }
  ]
}

Response

The request has succeeded.

Example response

{
  "items": [
    {
      "exception": {
        "code": 403,
        "invite_or_request_id": "383791336903426391",
        "message": "You hit the maximum number of pending invites allowed.",
        "users_or_partner_ids": [
          "businessMember0101",
          "business+member@business.com"
        ]
      },
      "invite": {
        "id": "383791336903426391",
        "user": {
          "email": "business0101@business.com",
          "id": "549755885175",
          "username": "business0101"
        }
      }
    }
  ]
}

Changes

Changed in 4 of the 29 revisions of this API.1412

  • v5b698c180678a147See the full diff
    • ▲

      the items/items/invite response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • ●

      removed the optional property items/items/invite/id from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property items/items/invite/invite_data from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property items/items/invite/is_received_invite from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property items/items/invite/user from the response with the 200 status

      response-optional-property-removed

    • ○

      added the new BIZ_PINNER_LIST_SHARER enum value to the request property invites/items/action/asset_id_to_permissions/additionalProperties/items/

      request-property-enum-value-added

    • ○

      added the non-success response with the status 400

      response-non-success-status-added

    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

    • ○

      added the non-success response with the status 429

      response-non-success-status-added

    • ○

      added BaseInviteDataResponse to the items/items/invite response property allOf list for the response status 200

      response-property-all-of-added

    This revision also has 182 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • v543134ca41f181See the full diff
    • ○

      added the new CONSUMER_USER enum value to the request property invites/items/action/asset_id_to_permissions/additionalProperties/items/

      request-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • v510f9eba4ad973See the full diff
    • ○

      added the new CATALOGS_VIEWER enum value to the request property invites/items/action/asset_id_to_permissions/additionalProperties/items/

      request-property-enum-value-added

    • ○

      added the new FINANCE_EDIT enum value to the request property invites/items/action/asset_id_to_permissions/additionalProperties/items/

      request-property-enum-value-added

    • ○

      added the new FINANCE_VIEW enum value to the request property invites/items/action/asset_id_to_permissions/additionalProperties/items/

      request-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • v5f9321315766f1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog