FLflorafauna-ai
Projects

Create an agent browser session for a project

Changed on

Mints a one-shot sign-in link for an agent that has its own browser (for example Claude Code Desktop or Cowork with WebMCP). Opening the link signs the agent in as the credential's user and lands on the project canvas with FLORA's in-page WebMCP tools enabled, so the agent can drive the canvas directly. The link is consumed on first visit and the session it grants lasts session_hours (1–24, default 8) and acts as the user — treat it as a secret. The session acts as the whole user, so only OAuth credentials and API keys created before per-workspace permissions existed may create one; keys that carry a permission map are refused with 403 forbidden.

post/projects/{projectId}/agent-session

Request

  • Base URL
    https://app.flora.ai/api/v1
  • URL
    https://app.flora.ai/api/v1/projects/{projectId}/agent-session
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Project identifier

Example:prj_abc123

Request body

session_hoursinteger

How long the browser session minted by the link lasts, in hours (1–24, default 8).

Response

Agent session link created.

project_idstring required

Project identifier

workspace_idstring required

Workspace identifier

urlstring uri required

One-shot sign-in link. Opening it in a browser signs the agent in as the credential's user and lands on the project canvas with WebMCP enabled. It is consumed on first visit; navigate within the tab rather than reloading it.

canvas_urlstring uri required

Project canvas URL

expires_atstring date-time required

When the browser session minted by the link expires

session_hoursinteger required

Session length the link grants

Example response

{
  "project_id": "prj_abc123",
  "workspace_id": "ws_abc123"
}

Changes

  • a8351619f225Revision changes
    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

  • e54130373b10Revision changes
    • info

      endpoint added