Skip to content

ListIntegrationAccounts

GET/api/v1/integrations/{integration}/accounts
curl \
-H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
"https://us.oblique.security/api/v1/integrations/{integration}/accounts"

Set OBLIQUE_API_KEY to your API key.

  • parentstringrequired

    The parent integration. May be integrations/- to list accounts across all integrations.

  • pageSizeinteger (int32)
  • pageTokenstring
  • filterstring

    Optional filter. Supports lookup by associated user:

    user="users/janedoe"

    A non-admin caller must set this to their own user to list their own integration accounts.

  • showDeletedboolean

    If true, the response will include deleted accounts.

200ListIntegrationAccountsResponse
  • integrationAccountsIntegrationAccount[]
    • namestring

      Assigned by Oblique.

    • createTimestring (date-time)read-only

      Create and update timestamps.

    • updateTimestring (date-time)read-only
    • deleteTimestring (date-time)read-only

      The time when the account record stopped being tracked by Oblique. May differ from the delete time of the account in the external system.

    • accountIdstringread-only

      The identifier the integration uses for this account (for example a Slack user ID). It is the account’s stable upsert key within the integration.

    • userstringread-only

      The directory user this account maps to, matched on an identity field (such as email) where possible. Empty when no authoritative user matches.

    • One of

      • slackSlackread-only
        • teamIdstringread-only

          The Slack team (workspace) the account belongs to.

        • emailstringread-only

          The account’s email, used to match a directory user.

        • isBotbooleanread-only

          Whether the account is a bot.

        • isDeletedbooleanread-only

          Whether the account is deactivated in Slack (disabled but still visible to the API).

        • workspaceRolestringread-only

          The account’s role in the workspace: “primary_owner”, “owner”, “admin” or “member”.

        • guestTypestringread-only
          Allowed values: SINGLE_CHANNEL, MULTI_CHANNEL

          Empty when the account is not a guest.

    • displayNamestringread-only

      Human-readable display name for this account, derived from the integration-specific profile.

  • nextPageTokenstring
StatusMeaning
400Malformed request
401Missing or invalid API key
403Not allowed for this API key
404Not found
429Too many requests
500Internal server error