⚠️ This documentation pertains to a preview endpoint. This feature is not yet ready for API consumption and may change.
For inquiries or feedback, please contact us at Glean.

Read teams

post/teams

Read the details of the teams with the given IDs.

SecurityBearerAuth
Request
header Parameters
X-Glean-Auth-Type
string

Auth type being used to access the endpoint (should be non-empty only for global tokens).

X-Scio-Actas
string <email>

Email address of a user on whose behalf the request is intended to be made (should be non-empty only for global tokens).

Request Body schema: application/json
required

Teams request

ids
Array of strings

The IDs of the teams to retrieve.

includeFields
Array of strings

List of teams fields to return that aren't returned by default

Items Value: "TEAMS_DETAILS"
Responses
200

OK

Response Schema: application/json
errors
Array of strings

A list of IDs that could not be found.

Array of objects (Team)

A Team and a deep copy of all its members for each ID in the request

400

Invalid request

401

Not Authorized

429

Too Many Requests

Request samples
application/json
{
  • "ids": [
    • "abc123"
    ]
}
Response samples
application/json
{
  • "results": [
    • {
      • "relatedObjects": {
        • "property1": {
          • "objects": [
            • {
              • "id": "string",
              • "metadata": {
                • "name": null
                }
              }
            ]
          },
        • "property2": {
          • "objects": [
            • {
              • "id": "string",
              • "metadata": {
                • "name": null
                }
              }
            ]
          }
        },
      • "permissions": {
        • "write": {
          • "scopeType": "GLOBAL",
          • "create": true,
          • "update": true,
          • "delete": true
          }
        },
      • "id": "string",
      • "name": "string",
      • "description": "string",
      • "businessUnit": "string",
      • "department": "string",
      • "photoUrl": "string",
      • "bannerUrl": "string",
      • "externalLink": "http://example.com",
      • "members": [
        • {
          • "person": {
            • "name": "George Clooney",
            • "obfuscatedId": "abc123"
            },
          • "relationship": "MEMBER",
          • "customRelationshipStr": "string",
          • "joinDate": "2019-08-24T14:15:22Z"
          }
        ],
      • "memberCount": 0,
      • "emails": [
        • {
          • "email": "user@example.com",
          • "type": "PRIMARY",
          • "isUserGenerated": true
          }
        ],
      • "datasourceProfiles": [
        • {
          • "datasource": "github",
          • "handle": "string",
          • "url": "string",
          • "nativeAppUrl": "string",
          • "isUserGenerated": true
          }
        ],
      • "datasource": "string",
      • "createdFrom": "string",
      • "lastUpdatedAt": "2019-08-24T14:15:22Z",
      • "status": "PROCESSED",
      • "canBeDeleted": true,
      • "loggingId": "string"
      }
    ],
  • "errors": [
    • "string"
    ]
}