Create a browser session

POST

/v1/sessions

curl -X POST 'https://api.embodiflow.io/v1/sessions' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
  -H 'Content-Type: application/json' \
  -d '{
    "kind": "email_password",
    "email": "user@example.com",
    "password": "string"
  }'

Authorization

Send a personal access token with every request.

Authorization: Bearer PAT

Authentication guide

Request body

Content-Typeapplication/json

kindstringrequired
Allowed values
email_password
emailstring (email)
passwordstring

Responses

Success

dataobjectrequired
- userobjectrequired
- membershipsarray<AuthMeMembershipSwaggerDto>required
- currentMembershipIdstring (uuid) | nullrequired
- csrfTokenstring
- mustRotatePasswordboolean
- mfaEnrollmentRequiredboolean
- mfaEnrollmentGraceExpiresAtstring | null
metaobjectrequired
- requestIdstring (uuid)required

Response example

{
  "data": {
    "user": {
      "id": "00000000-0000-0000-0000-000000000000",
      "email": "string",
      "displayName": "string",
      "avatarUrl": "string",
      "hasPassword": true,
      "status": "string",
      "lastLoginAt": "string",
      "emailVerifiedAt": "string"
    },
    "memberships": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "tenantId": "00000000-0000-0000-0000-000000000000",
        "tenant": {
          "id": "00000000-0000-0000-0000-000000000000",
          "slug": "string",
          "name": "string",
          "status": "string",
          "storageKey": "string"
        },
        "role": "string",
        "status": "string",
        "joinedAt": "string"
      }
    ],
    "currentMembershipId": "00000000-0000-0000-0000-000000000000",
    "csrfToken": "string",
    "mustRotatePassword": true,
    "mfaEnrollmentRequired": true,
    "mfaEnrollmentGraceExpiresAt": "string"
  },
  "meta": {
    "requestId": "00000000-0000-0000-0000-000000000000"
  }
}

Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1

curl -X POST 'https://api.embodiflow.io/v1/sessions' \ -H 'Authorization: Bearer $EMBODIFLOW_PAT' \ -H 'Content-Type: application/json' \ -d '{ "kind": "email_password", "email": "user@example.com", "password": "string" }'

{ "data": { "user": { "id": "00000000-0000-0000-0000-000000000000", "email": "string", "displayName": "string", "avatarUrl": "string", "hasPassword": true, "status": "string", "lastLoginAt": "string", "emailVerifiedAt": "string" }, "memberships": [ { "id": "00000000-0000-0000-0000-000000000000", "tenantId": "00000000-0000-0000-0000-000000000000", "tenant": { "id": "00000000-0000-0000-0000-000000000000", "slug": "string", "name": "string", "status": "string", "storageKey": "string" }, "role": "string", "status": "string", "joinedAt": "string" } ], "currentMembershipId": "00000000-0000-0000-0000-000000000000", "csrfToken": "string", "mustRotatePassword": true, "mfaEnrollmentRequired": true, "mfaEnrollmentGraceExpiresAt": "string" }, "meta": { "requestId": "00000000-0000-0000-0000-000000000000" } }