Geta.Team Geta.Team
FR Log in Start now
API

Geta.Team, inside your own product

Follow the workspaces you created for your clients from your own backend, and hear of every event: ready, payment failed, suspended, deleted. A clean REST API, signed webhooks, and documentation you can try right in your browser.

Read the documentationTry the interactive reference
Free with your Geta.Team account. Create your keys in the dashboard.
Why the API

What it brings to your business

Everything a business needs to put AI employees in front of its own clients.

Your clients’ workspaces, at a glance

Their status, their address and their invitation, from your own backend, whenever you need them.

Your brand, end to end

Each workspace carries your white label: your name, your colors, your logo. Your client sees your offer.

Act on payment issues

When a payment fails or a workspace is suspended, your backend hears of it at once, with the link to pay.

Every event, as it happens

Ready, payment failed, suspended, deleted: signed webhooks, retried for 24 hours if your server is down.

Secure by design

Keys shown once and stored as fingerprints, allowed IP addresses required, read-only or read-write keys, rate limits, an alert email for every new key.

Built on standards

JSON over HTTPS, an OpenAPI 3.1 file to import in Postman or Insomnia, or to generate a client in your language.

How it works

Up and running in three steps

From your dashboard to your backend.

1

Create a key

In your dashboard, with the IP addresses of your servers and its access: read-only or read-write.

Account · API
2

Call the API

List your workspaces, or get one, from your own backend.

GET /v1/workspaces
3

Hear of every event

Give us your https address: each event reaches you, signed with your secret.

workspace.ready
A few lines of code

Follow your workspaces in one call

A key, one call, a JSON answer. A read-only key is enough to follow your workspaces.

  • One base URL: https://dash.geta.team/api/v1
  • Errors a program can read: a status and a code
  • 120 requests a minute per key
  • Keys limited to your servers’ IP addresses
# Check your key
curl https://dash.geta.team/api/v1/me \
  -H "Authorization: Bearer $GETA_API_KEY"

# List your clients’ workspaces
curl https://dash.geta.team/api/v1/workspaces \
  -H "Authorization: Bearer $GETA_API_KEY"

# Get one workspace
curl https://dash.geta.team/api/v1/workspaces/77 \
  -H "Authorization: Bearer $GETA_API_KEY"
Everything you need

The documentation, one click away

Guides in English and French, an interactive reference, and the OpenAPI file.

Documentation

Authentication, errors, limits, every call with its fields and answers.

Read the guides →

Interactive reference

Every call, with code samples in your language and a button to try it with your key.

Open the reference →

Webhooks

The events, their content, and how to check their signature in Node, Python or PHP.

Set up webhooks →

OpenAPI file

The whole API in OpenAPI 3.1: import it in Postman, Insomnia or a client generator.

Download the file →

Put Geta.Team in your product

Create your first API key in your dashboard, then follow your clients’ workspaces in one call.

Create my API keyRead the documentation