Skip to navigation
API ReferenceOrganizations

Join Labs

Joins AgentMail Labs for the whole organization, which turns on every feature in Labs for every inbox. Joining again has no effect. There is no leave on the API; an organization admin can leave in the console under Settings, then Labs.

Join only when your organization has decided to. Get Labs reads the same for an organization that never joined and one whose admin left Labs on purpose, so don’t join just because enabled is false.

Requires an organization-scoped API key with no permissions restriction, and a verified organization. API keys see the change within five minutes. Where Labs isn’t offered (available is false on Get Labs), joining returns 403.

CLI:

agentmail organizations join-labs

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

This endpoint returns an object.
enabledboolean
Whether the organization is in AgentMail Labs.
enabled_atdatetime or null

Time at which the organization joined Labs. null when it is not in Labs.

availableboolean

Whether Labs is offered in this deployment. Labs is available in US production (api.agentmail.to), not yet in EU production (api.agentmail.eu).

Errors

400
Validation Error
403
Organization Forbidden Error
409
Conflict Error