LINE Liff API

The liff API from LINE — 2 operation(s) for liff.

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /liff/v1/apps Create a LIFF app on a channel · Create LIFF app #
Ask an LLM
“How do I add a new LIFF app to my channel?”
“Can I set the scopes and bot link prompt when creating a LIFF app?”
Tell an agent
Create a LIFF app with view {view}.
Add a new LIFF app with view {view}, description {description} and scopes {scope}.
GET /liff/v1/apps List all LIFF apps on a channel · Get all LIFF apps #
Ask an LLM
“Which LIFF apps are added to my LINE channel?”
“Can I see the settings of every LIFF app on this channel?”
Tell an agent
List all LIFF apps on my channel.
Show every LIFF app and its view settings.
PUT /liff/v1/apps/{liffId} Update an existing LIFF app's settings · Update LIFF app from a channel #
Ask an LLM
“How do I change the endpoint URL of a LIFF app I already created?”
“Can I update an existing LIFF app's bot prompt setting?”
Tell an agent
Update LIFF app {liffId} to use view {view}.
Change the description of existing LIFF app {liffId} to {description}.
DELETE /liff/v1/apps/{liffId} Delete a LIFF app from a channel · Delete LIFF app from a channel #
Ask an LLM
“How do I remove a LIFF app from my channel?”
“What happens when I delete a LIFF app by its ID?”
Tell an agent destructive · confirm first
Delete LIFF app {liffId}.
Remove LIFF app {liffId} from the channel.

Documentation

Specifications

Other Resources

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/line:line-liff-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

line-liff-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: server Liff API
  version: 1.0.0
  description: LIFF Server API.
servers:
- url: https://api.line.me/
security:
- Bearer: []
tags:
- name: liff
paths:
  /liff/v1/apps:
    post:
      operationId: addLIFFApp
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#add-liff-app
      summary: Create LIFF app
      tags:
      - liff
      description: Adding the LIFF app to a channel
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddLiffAppRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddLiffAppResponse'
              example:
                liffId: '{liffId}'
        '400':
          description: 'This status code means one of the following:

            - The request contains an invalid value.

            - The maximum number of LIFF apps that can be added to the channel has been reached.

            '
        '401':
          description: 'Authentication failed.


            '
    get:
      operationId: getAllLIFFApps
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#get-all-liff-apps
      summary: Get all LIFF apps
      description: Gets information on all the LIFF apps added to the channel.
      tags:
      - liff
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAllLiffAppsResponse'
              example:
                apps:
                - liffId: '{liffId}'
                  view:
                    type: full
                    url: https://example.com/myservice
                  description: Happy New York
                  permanentLinkPattern: concat
                - liffId: '{liffId}'
                  view:
                    type: tall
                    url: https://example.com/myservice2
                  features:
                    ble: true
                    qrCode: true
                  permanentLinkPattern: concat
                  scope:
                  - profile
                  - chat_message.write
                  botPrompt: none
        '401':
          description: 'Authentication failed.

            '
        '404':
          description: 'There is no LIFF app on the channel.




            '
  /liff/v1/apps/{liffId}:
    parameters:
    - name: liffId
      in: path
      required: true
      description: ID of the LIFF app to be updated
      schema:
        type: string
    put:
      operationId: updateLIFFApp
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#update-liff-app
      summary: Update LIFF app from a channel
      description: Update LIFF app settings
      tags:
      - liff
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateLiffAppRequest'
        required: true
      responses:
        '200':
          description: OK
        '400':
          description: 'The request contains an invalid value.

            '
        '401':
          description: 'Authentication failed.

            '
        '404':
          description: 'This status code means one of the following:

            - The specified LIFF app does not exist.

            - The specified LIFF app has been added to another channel.

            '
    delete:
      operationId: deleteLIFFApp
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#delete-liff-app
      summary: Delete LIFF app from a channel
      description: Deletes a LIFF app from a channel.
      tags:
      - liff
      responses:
        '200':
          description: OK
        '401':
          description: 'Authentication failed.

            '
        '404':
          description: 'This status code means one of the following:

            - The specified LIFF app does not exist.

            - The specified LIFF app has been added to another channel.


            '
components:
  schemas:
    LiffView:
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#add-liff-app
      type: object
      required:
      - type
      - url
      properties:
        type:
          description: 'Size of the LIFF app view. Specify one of these values:

            - compact

            - tall

            - full

            '
          type: string
          enum:
          - compact
          - tall
          - full
        url:
          type: string
          format: uri
          description: 'Endpoint URL. This is the URL of the web app that implements the LIFF app

            (e.g. https://example.com).

            Used when the LIFF app is launched using the LIFF URL.

            The URL scheme must be https. URL fragments (#URL-fragment) can''t be specified.

            '
        moduleMode:
          type: boolean
          description: '`true` to use the LIFF app in modular mode.

            When in modular mode, the action button in the header is not displayed.

            '
    LiffScope:
      type: string
      enum:
      - openid
      - email
      - profile
      - chat_message.write
      description: 'Array of scopes required for some LIFF SDK methods to function.

        The default value is `["profile", "chat_message.write"]`.


        '
    UpdateLiffView:
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#update-liff-app
      type: object
      properties:
        type:
          description: 'Size of the LIFF app view. Specify one of these values:

            - compact

            - tall

            - full

            '
          type: string
          enum:
          - compact
          - tall
          - full
        url:
          type: string
          format: uri
          description: 'Endpoint URL. This is the URL of the web app that implements the LIFF app

            (e.g. https://example.com).

            Used when the LIFF app is launched using the LIFF URL.

            The URL scheme must be https. URL fragments (#URL-fragment) can''t be specified.

            '
        moduleMode:
          type: boolean
          description: '`true` to use the LIFF app in modular mode.

            When in modular mode, the action button in the header is not displayed.

            '
    UpdateLiffAppRequest:
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#add-liff-app
      type: object
      properties:
        view:
          $ref: '#/components/schemas/UpdateLiffView'
        description:
          type: string
          description: 'Name of the LIFF app.


            The LIFF app name can''t include "LINE" or similar strings, or inappropriate strings.

            '
        features:
          $ref: '#/components/schemas/LiffFeatures'
        permanentLinkPattern:
          type: string
          description: 'How additional information in LIFF URLs is handled. Specify `concat`.

            '
        scope:
          type: array
          items:
            $ref: '#/components/schemas/LiffScope'
        botPrompt:
          $ref: '#/components/schemas/LiffBotPrompt'
    LiffFeatures:
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#get-all-liff-apps
      type: object
      properties:
        ble:
          type: boolean
          description: '`true` if the LIFF app supports Bluetooth® Low Energy for LINE Things. `false` otherwise.

            '
        qrCode:
          type: boolean
          description: '`true` to use the 2D code reader in the LIFF app. false otherwise. The default value is `false`.

            '
          default: false
    LiffBotPrompt:
      type: string
      description: "Specify the setting for bot link feature with one of the following values:\n\n`normal`: Display the option to add the LINE Official Account as a friend in the channel consent screen.\n`aggressive`: Display a screen with the option to add the LINE Official Account as a friend after the channel consent screen.\n`none`: Don't display the option to add the LINE Official Account as a friend.\n  The default value is none.\n"
      enum:
      - normal
      - aggressive
      - none
    LiffApp:
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#get-all-liff-apps
      type: object
      properties:
        liffId:
          type: string
          description: LIFF app ID
        view:
          $ref: '#/components/schemas/LiffView'
        description:
          type: string
          description: Name of the LIFF app
        features:
          $ref: '#/components/schemas/LiffFeatures'
        permanentLinkPattern:
          type: string
          description: 'How additional information in LIFF URLs is handled. concat is returned.

            '
        scope:
          type: array
          items:
            $ref: '#/components/schemas/LiffScope'
        botPrompt:
          $ref: '#/components/schemas/LiffBotPrompt'
    AddLiffAppRequest:
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#add-liff-app
      type: object
      required:
      - view
      properties:
        view:
          $ref: '#/components/schemas/LiffView'
        description:
          type: string
          description: 'Name of the LIFF app.


            The LIFF app name can''t include "LINE" or similar strings, or inappropriate strings.

            '
        features:
          $ref: '#/components/schemas/LiffFeatures'
        permanentLinkPattern:
          type: string
          description: 'How additional information in LIFF URLs is handled. Specify `concat`.

            '
        scope:
          type: array
          items:
            $ref: '#/components/schemas/LiffScope'
        botPrompt:
          $ref: '#/components/schemas/LiffBotPrompt'
    GetAllLiffAppsResponse:
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#get-all-liff-apps
      type: object
      properties:
        apps:
          type: array
          items:
            $ref: '#/components/schemas/LiffApp'
    AddLiffAppResponse:
      externalDocs:
        url: https://developers.line.biz/en/reference/liff-server/#add-liff-app
      type: object
      required:
      - liffId
      properties:
        liffId:
          type: string
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      description: Channel access token