Teams

Read the teams the authenticated user belongs to, with their role. Requires the teams.read scope. Only your own teams are ever returned.

The team model

  • Name
    id
    Type
    string
    Description
    Opaque team id, e.g. team_8Hk2.
  • Name
    name
    Type
    string
    Description
    Team name.
  • Name
    role
    Type
    string
    Description
    Your role on the team, e.g. owner or member.
  • Name
    member_count
    Type
    integer
    Description
    Number of members.

GET/v1/teams

List teams

Use this to discover which team a token can act as before bidding or reading trades.

Request

GET
/v1/teams
curl https://api.mygrainexchange.com/v1/teams \
  -H "Authorization: Bearer {token}"

GET/v1/teams/:id

Get a team

Returns 404 for any team you do not belong to.

Request

GET
/v1/teams/team_8Hk2
curl https://api.mygrainexchange.com/v1/teams/team_8Hk2 \
  -H "Authorization: Bearer {token}"

Was this page helpful?