SHshorebird
enterprises

List the service accounts an enterprise and its organizations own.

By organization name and then account name, with their organizations, each with its first apps. The enterprise's own accounts have no organization (team_id is null) and come last. owner narrows the list, and total_count, to one kind of owner. Admins only.

get/enterprises/{enterpriseId}/service-accounts

Request

  • Base URL
    https://api.shorebird.dev/api/v1
  • Auth
    • HTTP bearer
    • or HTTP bearer

Query parameters

per_pageinteger

The number of items per page. These lists always page: without per_page a page holds 30. Values above 100 are treated as 100; values that are not a positive integer are treated as 30.

cursorstring

The next_cursor of the previous page. Opaque. An unreadable cursor is a 400 (invalid_cursor), and sending it with page a 400 (invalid_page).

pageinteger

The 1-based number of the page to read, instead of cursor. A value that is not a positive integer reads the first page.

owner'enterprise' | 'organization'

enterprise lists only the accounts the enterprise owns itself, and organization only those its organizations own. Left out, both. Any other value is a 400 (enterprise_service_account_owner_invalid).

sort'account' | '-account' | 'organization' | '-organization' | 'created_by' | '-created_by' | 'last_used' | '-last_used'

The column to sort by, ascending, or after a - descending, in place of the list's own order. Rows with no value in the column come last either way. Any other value is a 400 (enterprise_sort_invalid).

Response

One page of service accounts.

total_countinteger required

How many items the whole list holds.

next_cursorstring

The cursor of the next page; absent on the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.