Skip to content
Docs
Esc
↑↓navigate↵open⌘Jpreview

List team access defaults

Paginated settings for the Enterprise/Internal parent’s current live family, ordered by team name and ID. Requires parent admin authority. Team settings and connector reads respect credential permissions. Returns up to three configured team-account connector names per team; follow each connector cursor with listTeamExternalAccessTeamConnectors. No credentials, private account identities or provider requests.

GET/v1/teams/{teamId}/external-access/teams
Authorization
AuthorizationBearer token · headerrequired

Better Auth session, OAuth access token, OAuth client-credentials token, or sfm_ Space machine credential.

or
AuthorizationOAuth2 access token · headerrequired

OAuth 2.0 with explicit Spacefast capability scopes. Use the authorization-code flow for people and client credentials for machines.

Scopes:teams:read
Path parameters
teamIdstringrequired
min length 1
Query parameters
limitinteger

Page size.

min 1 · max 100 · default: 20
cursorstring

Opaque cursor from the previous page's nextCursor.

min length 1 · max length 4096
Responses
200

Response for status 200

$schemastring<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

dataobject[]required
Show properties
Array of object
idstringrequired
namestringrequired
slugstringrequired
parentTeamIdstring | nullrequired
spaceAccessobject | nullrequired

Null when the credential cannot read this team's settings.

Show properties
Any of:
object
newSpaceGrantPresetstringrequired
Allowed:privatepublic
privateSpacesOnlybooleanrequired
null
null
connectorsobjectrequired
Show properties
availablebooleanrequired
totalintegerrequired
min 0 · max 9007199254740991
itemsobject[]required

First three connector names with active team-owned accounts. Follow pagination for the rest. Excludes personal, visitor and revoked accounts; not provider health or data flow.

Show properties
Array of object
connectorstringrequired
accountsintegerrequired
max 9007199254740991
paginationobjectrequired
Show properties
nextCursorstring | nullrequired

Opaque cursor for the next page; null when there are no more results.

hasMorebooleanrequired

Whether another page exists after this one.

paginationobjectrequired
Show properties
nextCursorstring | nullrequired

Opaque cursor for the next page; null when there are no more results.

hasMorebooleanrequired

Whether another page exists after this one.

default

Problem details (RFC 9457). Any 4xx/5xx response is one application/problem+json document.

$schemastring<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

typestringrequired

Problem type URI resolving to the error docs page. The server derives it mechanically from code against the docs origin.

titlestringrequired

Short human-readable summary of the problem type. The server derives it mechanically from code.

statusintegerrequired

HTTP status code of this response, repeated in the body.

min -9007199254740991 · max 9007199254740991
detailstringrequired

Human-readable failure explanation for this occurrence.

codestringrequired

Stable snake_case error code naming the failed public contract.

pointerstring

RFC 6901 JSON Pointer into the failing request field, for example "/files/37/path", on validation failures.

detailsobject

Machine-readable context for the error code.

fixstring

One sentence on what to do about this error code, the same text as the type page. Read it before retrying.

suggestionsstring[]

Actionable recovery steps safe to show in dashboards, SDKs, and CLI output.

nextstring[]

Copy-pasteable commands or API requests an agent can run next.

requestIdstringrequired

The request id to quote when contacting support.

Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.spacefast.com/v1/teams/string/external-access/teams' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "$schema": "http://example.com",
  "data": [
    {
      "id": "string",
      "name": "string",
      "slug": "string",
      "parentTeamId": "string",
      "spaceAccess": {
        "newSpaceGrantPreset": "private",
        "privateSpacesOnly": true
      },
      "connectors": {
        "available": true,
        "total": 0,
        "items": [
          {
            "connector": "string",
            "accounts": 1
          }
        ],
        "pagination": {
          "nextCursor": "string",
          "hasMore": true
        }
      }
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}

Was this page helpful?