AgenTrux Auth Kratos API

The auth-kratos API from AgenTrux — 2 operation(s) for auth-kratos.

Operations 2

POST /auth/kratos/webhook Kratos Webhook #
POST /auth/kratos/logout-webhook Kratos Logout Webhook #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/agentrux-com:agentrux-com-auth-kratos-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

agentrux-com-auth-kratos-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AgenTrux Auth Kratos API
  version: 0.1.0
tags:
- name: auth-kratos
paths:
  /auth/kratos/webhook:
    post:
      tags:
      - auth-kratos
      summary: Kratos Webhook
      operationId: kratos_webhook_auth_kratos_webhook_post
      parameters:
      - name: X-Request-ID
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Request-Id
      - name: X-Kratos-Hook-Signature
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Kratos-Hook-Signature
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KratosWebhookPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Kratos Webhook Auth Kratos Webhook Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /auth/kratos/logout-webhook:
    post:
      tags:
      - auth-kratos
      summary: Kratos Logout Webhook
      description: 'Kratos `after.logout` hook (Phase 1.7c).


        Kratos session が logout された際、 AgenTrux sessions.revoked_at を更新して

        対応する console session (ast_) を失効させる。 idempotent (再送 OK)。


        payload.kratos_session_id があれば session 単位 revoke、 なければ identity_id

        経由で同 user の全 session を revoke (logout-all シナリオ)。'
      operationId: kratos_logout_webhook_auth_kratos_logout_webhook_post
      parameters:
      - name: X-Request-ID
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Request-Id
      - name: X-Kratos-Hook-Signature
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Kratos-Hook-Signature
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KratosLogoutWebhookPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Kratos Logout Webhook Auth Kratos Logout Webhook Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    KratosLogoutWebhookPayload:
      properties:
        flow:
          type: string
          const: logout
          title: Flow
        kratos_session_id:
          anyOf:
          - type: string
            maxLength: 128
            minLength: 8
          - type: 'null'
          title: Kratos Session Id
          description: Kratos session ID (logged out)
        identity_id:
          anyOf:
          - type: string
            maxLength: 128
            minLength: 8
          - type: 'null'
          title: Identity Id
          description: Kratos identity ID (logout 元、 session_id 不在時 fallback)
      type: object
      required:
      - flow
      title: KratosLogoutWebhookPayload
      description: 'Kratos `after.logout` hook payload (Phase 1.7c、 2026-05-17 追加).


        SSOT: docs/04_design/auth/idp_replacement.md §4-3-A (after.logout 拡張)

        Kratos が logout flow 完了時に AgenTrux に通知する。 payload shape は

        Kratos config の body template に依存するため、 弱依存 (両 field optional)

        で受け取り、 caller は session_id 優先 → identity_id fallback。'
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    KratosWebhookPayload:
      properties:
        flow:
          type: string
          enum:
          - registration
          - login
          - settings
          - verification
          title: Flow
          description: webhook の種別 (registration|login)
        identity_id:
          type: string
          maxLength: 128
          minLength: 8
          title: Identity Id
        flow_id:
          type: string
          maxLength: 128
          minLength: 8
          title: Flow Id
        email:
          type: string
          format: email
          title: Email
        schema_id:
          type: string
          maxLength: 64
          minLength: 1
          title: Schema Id
        idp:
          anyOf:
          - type: string
            enum:
            - google
            - entraid
            - apple
            - github
          - type: 'null'
          title: Idp
        subject:
          anyOf:
          - type: string
            maxLength: 255
            minLength: 1
          - type: 'null'
          title: Subject
        email_verified:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Email Verified
        display_name:
          anyOf:
          - type: string
            maxLength: 200
            minLength: 1
          - type: 'null'
          title: Display Name
        phone:
          anyOf:
          - type: string
            maxLength: 32
            minLength: 1
          - type: 'null'
          title: Phone
      type: object
      required:
      - flow
      - identity_id
      - flow_id
      - email
      - schema_id
      title: KratosWebhookPayload
      description: Kratos の body template で AgenTrux に送られる JSON 形 (Phase 1.3 拡張).
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError