Authentication

Get current user session information

Changed on

Retrieves detailed information about the current authenticated user session, including project details, organization membership, and API key information if applicable. This endpoint is useful for verifying authentication status and retrieving contextual information about the authenticated user and their access privileges.

get/api/v3.1/auth/session/info

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/auth/session/info
  • Auth
    API key in header x-user-api-key

Response

Session is valid and active. Returns detailed information about the authenticated user, their project, and organization.

Example response

{
  "project": {
    "auto_id": 12345,
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "org_id": "550e8400-e29b-41d4-a716-446655440001",
    "name": "Production API",
    "email": "project-123@composio.dev",
    "nano_id": "pr_1a2b3c4d5e6f",
    "created_at": "2023-05-16T14:30:00.000Z",
    "updated_at": "2023-05-18T09:15:30.000Z",
    "webhook_url": "https://example.com/webhook",
    "event_webhook_url": "https://example.com/events",
    "webhook_secret": "whsec_a1b2c3d4e5f6g7h8i9j0",
    "triggers_enabled": true,
    "last_subscribed_at": "2023-05-17T10:00:00.000Z",
    "is_new_webhook": true,
    "webhook_version": "V2",
    "org": {
      "id": "ok_1a2b3c4d5e6f",
      "name": "Acme Corp",
      "plan": "BUSINESS"
    }
  },
  "api_key": {
    "auto_id": 7890,
    "id": "550e8400-e29b-41d4-a716-446655440003",
    "name": "Development Key",
    "project_id": "pr_1a2b3c4d5e6f",
    "org_member_id": "550e8400-e29b-41d4-a716-446655440002",
    "created_at": "2023-05-01T10:00:00.000Z",
    "updated_at": "2023-05-01T10:00:00.000Z",
    "key": "ak_a1b2c3d4e5f6g7h8i9j0"
  },
  "org_member": {
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "email": "user@example.com",
    "name": "John Doe",
    "role": "admin",
    "metadata": {
      "prefers_old_dashboard": false
    }
  }
}

Changes

  • 98956f31abf3Revision changes
    • info

      api operation id getV3_1AuthSessionInfo removed and replaced with getAuthSessionInfo

    • info

      api tag Session removed

    • info

      api tag User removed

  • 5356789d8d11Revision changes
    • warning

      removed the optional property // from the response with the status

    • info

      the endpoint scheme security ApiKeyAuth was removed from the API