Remove a member from a team
Takes a person out of a team. Removing someone who isn't in it returns the team unchanged.
Scope: people:write · Plan: Pro and Enterprise in live mode; every plan in test mode.
AuthorizationBearer <token>Send Authorization: Bearer <token> on every request. The token is one of:
| Prefix | What it is | Where it may be used |
|---|---|---|
agoo_sk_live_ | Secret key, live mode | Your servers only |
agoo_sk_test_ | Secret key, test mode | Your servers only |
agoo_pk_live_ | Publishable key, live mode | Browsers and apps: create pre-registrations and bookings, read public booking types (with their intake questions) and their free slots, read the visit types open for pre-registration with their public forms. Never lists people. |
agoo_pk_test_ | Publishable key, test mode | As above, in test mode |
Admins create keys in Console → Developers → API keys and choose each key's scopes. A key is shown once. Never put a secret key in a URL, a browser or a mobile app.
Scope: people:write
team_id*stringThe team's ID.
^team_[0-7][0-9a-hjkmnp-tv-z]{25}$"team_01m4r6y616e1b973vj50h0643y"person_id*stringThe person's ID.
^person_[0-7][0-9a-hjkmnp-tv-z]{25}$"person_01kjsesxm0e4zbyvkr7bcfxbfg"The team, with its members.
application/json- response
A team: who a visitor comes to see when it isn't one person, and who a waiting visitor is passed to.
id*TeamIdA team ID (TypeID with the team prefix).
^team_[0-7][0-9a-hjkmnp-tv-z]{25}$"team_01m4r6y616e1b973vj50h0643y"name*stringlength <= 80"Finance"site_id*|The site the team is at. null: every site.
^site_[0-7][0-9a-hjkmnp-tv-z]{25}$lead_id*|The person who leads the team, if you name one.
^person_[0-7][0-9a-hjkmnp-tv-z]{25}$visitors_can_choose*booleanVisitors may choose this team at the kiosk and on your visitor pages.
archived*booleanAn archived team takes no new visits; its past visits keep its name.
members*array<>created_at*stringdate-timeupdated_at*stringdate-timecurl -X DELETE 'https://api.agoo.ardent.africa/v1/teams/team_01m4r6y616e1b973vj50h0643y/members/person_01kjsesxm0e4zbyvkr7bcfxbfg'{ "id": "team_01m4r6y616e1b973vj50h0643y", "name": "Finance", "site_id": "string", "lead_id": "string", "visitors_can_choose": true, "archived": true, "members": [ { "id": "person_01kjsesxm0e4zbyvkr7bcfxbfg", "name": "string", "job_title": "string", "active": true } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}Add members to a team POST
Adds people to a team. People already in it stay as they are. A team's members are the ones told about a visit for the team, and any of them can take it. **Scope:** `people:write` · **Plan:** Pro and Enterprise in live mode; every plan in test mode.
List visits GET
Returns visits, newest first. Combine filters to answer everyday questions: - Who is on site now: `status=checked_in&site_id=…` - Today's expected guests: `status=expected&expected_after=…&expected_before=…` - A host's visitors: `host_id=…` In live mode, visits created before your plan's visitor history are left out. They're kept, not deleted, and come back if you move to a plan with a longer history. Visits that are still `expected`, `awaiting_approval` or `checked_in` are always included. **Scope:** `visits:read` · **Plan:** Pro and Enterprise in live mode; every plan in test mode.