FileMage Gateway (1.9)

Download OpenAPI specification:Download

FileMage Gateway provides a simple API to configure storage endpoints, users, and keys. Please note that all urls must end in a trailing slash, and the Content-Type header must be set to application/json.

Authentication

api_key

After registering an administrator account, go to the settings page to create a API key. Include this token in all calls to the API.

Example:

curl http://api.filemage.io/users/ -H "filemage-api-token: 43fb7437e3f231e481b262ca6d4de0c0"

Security Scheme Type API Key
Header parameter name: filemage-api-token

Endpoints

Create and manage storage endpoints.

List endpoints

Return a list of endpoint names and corresponding endpoint IDs.

Authorizations:

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create endpoint

Create a new endpoint using provided settings.

Authorizations:
Request Body schema: application/json

Endpoint configuration. Check cloud provider specific schemas for config parameters.

One of
id
integer

ID of returned endpoint.

name
string

Name of returned endpoint.

object

Settings specific to the Azure Blob Storage endpoint types.

Responses

Request samples

Content type
application/json
Example
{
  • "id": 0,
  • "name": "string",
  • "config": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "fields": [
    ]
}

Get endpoint

Return detailed endpoint settings of specified endpoint.

Authorizations:
path Parameters
id
required
integer

ID of endpoint to return

Responses

Response samples

Content type
application/json
Example
{
  • "id": 0,
  • "name": "string",
  • "config": {
    }
}

Update endpoint

Update settings of existing endpoint.

Authorizations:
path Parameters
id
required
integer

ID of endpoint to update

Request Body schema: application/json

Endpoint configuration. Check cloud provider specific schemas for config parameters.

One of
id
integer

ID of returned endpoint.

name
string

Name of returned endpoint.

object

Settings specific to the Azure Blob Storage endpoint types.

Responses

Request samples

Content type
application/json
Example
{
  • "id": 0,
  • "name": "string",
  • "config": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "fields": [
    ]
}

Delete endpoint

Authorizations:
path Parameters
id
required
integer

ID of endpoint to delete

Responses

Users

Create and manage user accounts.

List users

Return list of all active users.

Authorizations:

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create user

Authorizations:
Request Body schema: application/json

User settings

username
string

Username.

password
string

Password.

endpointId
integer

ID of endpoint to associate with user.

disabled
boolean

Password authentication disabled.

object

Specify path, and permission level of user home directory

Array of objects (Permission)

Additional folder permissions assigned to the user.

Responses

Request samples

Content type
application/json
{
  • "username": "string",
  • "password": "string",
  • "endpointId": 0,
  • "disabled": true,
  • "home": {
    },
  • "permissions": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0
}

Get user

Return detailed user settings including SSH keys.

Authorizations:
path Parameters
id
required
integer

ID of user to return

Responses