Apps

Important

The API is a work in progress. GET requests have been implemented in the current version, but POST, UPDATE, and DELETE support is not yet complete.

Get list of applications

Description

This endpoint returns a list of all applications existing on the specified domain.

Request

GET /liveforms/api/domains/{domain}/apps

Parameter

Description

domain

The name of a domain

Response

Possible HTTP response codes:

Code

Description

200 OK

Success

401 UNAUTHORIZED

The username/password used for authentication was invalid.

404 NOT FOUND

The specified domain does not exist.

500 SERVER ERROR

The request failed due to an internal server error.

If the request is successful, a JSON (default) or XML payload will be returned containing the requested information.

Example JSON response

{
   "title": "Applications",
   "link": {
      "rel": "self",
      "href": "/liveforms/api/domains/demo/apps"
   },
   "entry": [{
      "id": "1",
      "name": "App 1",
      "description": "This is a demo app",
      "link": [{
            "rel": "self",
            "href": "/liveforms/api/domains/demo/apps/1"
         },
         {
            "rel": "forms",
            "href": "/liveforms/api/domains/demo/apps/1/forms"
         },
         {
            "rel": "flows",
            "href": "/liveforms/api/domains/demo/apps/1/flows"
         }
      ]
   }]
}

Example XML response

<?xml version="1.0" encoding="UTF-8"?>
<feed>
   <title>Applications</title>
   <link rel="self" href="/liveforms/api/domains/demo/apps"/>
   <entry>
      <id>1</id>
      <name>App 1</name>
      <description>This is a demo app</description>
      <link rel="self" href="/liveforms/api/domains/demo/apps/1"/>
      <link rel="forms" href="/liveforms/api/domains/demo/apps/1/forms"/>
      <link rel="flows" href="/liveforms/api/domains/demo/apps/1/flows"/>
   </entry>
</feed>

Get application by ID

Description

This endpoint returns information representing the requested application provided the authenticated user has access to it.

Request

URL

GET /liveforms/api/domains/{domain}/apps/{application_id}

Parameter

Description

domain

The name of a valid domain which the authenticated user has access to.

application_id

The id of an application in the domain.

Response

Possible HTTP response codes:

Code

Description

200 OK

Success

401 UNAUTHORIZED

The username/password used for authentication was invalid.

403 FORBIDDEN

The authenticated user does not have permission to access this application.

404 NOT FOUND

The domain or application does not exist.

500 SERVER ERROR

The request failed due to an internal server error.

If the request is successful, a JSON (default) or XML payload will be returned containing the requested information.

Example JSON response

{
   "id": "1",
   "name": "App 1",
   "description": "This is a demo application",
   "link": [{
         "rel": "self",
         "href": "/liveforms/api/domains/demo/apps/1"
      },
      {
         "rel": "forms",
         "href": "/liveforms/api/domains/demo/apps/1/forms"
      },
      {
         "rel": "flows",
         "href": "/liveforms/api/domains/demo/apps/1/flows"
      }
   ]
}

Example XML response

<?xml version="1.0" encoding="UTF-8"?>
<entry>
   <id>1</id>
   <name>App 1</name>
   <description>This is a demo app</description>
   <link rel="self" href="/liveforms/api/domains/demo/apps/1"/>
   <link rel="forms" href="/liveforms/api/domains/demo/apps/1/forms"/>
   <link rel="flows" href="/liveforms/api/domains/demo/apps/1/flows"/>
</entry>