AdamRMS API (1.0.0)
AdamRMS is a free, open source advanced Rental Management System for Theatre, AV & Broadcast. This is the API listing for the v1 API, which is currently in Production and active development. You can find out more about AdamRMS at https://adam-rms.com.
Permission Management
Manage user pemissions Requires server permission PERMISSIONS:EDIT:USER_POSITION
query Parameters
action required | string DELETE, EDIT or new |
users_userid required | string The ID of the user |
userPositions_id required | string The ID of the user's position |
Responses
Response samples
- 200
{- "result": true,
- "message": [ ]
}
Instance Permission Editor
Edit the permissions of a position
Requires Instance Permission BUSINESS:ROLES_AND_PERMISSIONS:EDIT
query Parameters
position required | number Position id |
removepermission | number Permission id to remove |
addpermission | number Permission id to add |
Responses
Response samples
- 200
1
AdamRMS Permission Editor
Edit the permissions of an AdamRMS position
Requires server permission PERMISSIONS:EDIT
query Parameters
position required | number Position id |
removepermission | number Permission id to remove |
addpermission | number Permission id to add |
Responses
Response samples
- 200
1
Archive an Asset
Archives an asset
Requires Instance Permission ASSETS:ARCHIVE
query Parameters
assets_id required | integer The ID of the asset to archive |
reason | string The reason for archiving the asset |
date | string <date> The date the asset was archived, usually today |
Responses
Response samples
- 200
- default
{- "result": true,
- "message": [ ]
}
Search for Assets
Performs a deep search for assets
query Parameters
projectid | integer a project_id to check if assets are available for |
public | boolean Determines what asset listing should be returns |
dates | string Two dates to check availability between, separated with a - |
instance_id required | integer the instance to search in |
page required | integer The page of results to return |
page_limit required | number The number of results to return per page |
sort required | string How to sort the results |
category | string The Asset Category to filter by |
keyword | string A keyword to search for |
manufacturer | string A manufacturer to filter by |
group | string An Asset Group to filter by |
showlinked | integer Whether to include linked assets |
showarchived | integer Whether to include archived assets |
tags | string Asset Tag(s) to search for |
html | string Whether to return a HTML card listing or JSON data |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": null
}
Edit an Asset Type's Definable Fields
Edits an asset type's definable fields
Requires Instance Permission ASSETS:ASSET_TYPES:EDIT
query Parameters
required | object The data to update the asset type's definable fields with |
Responses
Response samples
- 200
- default
{- "result": true,
- "message": [ ]
}
Get Asset Type Data
Gets data for an asset type
query Parameters
term required | integer The ID of the asset type to get data for |
Responses
Response samples
- 200
- default
{- "result": true,
- "assetType": {
- "assetTypes_id": 0,
- "assetTypes_name": "string",
- "assetCategories_id": 0,
- "assetTypes_productLink": "string",
- "manufacturers_id": 0,
- "assetTypes_description": "string",
- "assetTypes_definableFields": "string",
- "assetTypes_mass": 0,
- "assetTypes_inserted": "string",
- "assetTypes_value": "string",
- "assetTypes_dayRate": 0,
- "assetTypes_weekRate": 0
}
}
List Assets
Lists assets
query Parameters
term | string A search term to filter the list by |
page | integer The page number to get |
pageLimit | integer The number of items to get per page |
category | integer The ID of the asset category to filter by |
manufacturer | integer The ID of the manufacturer to filter by |
assetTypes_id | integer The ID of the asset type to filter by |
all | any Whether to get all linked assets |
abridgedList | boolean Whether to get file and flags & blocks |
Responses
Response samples
- 200
{- "result": true,
- "assets": [
- {
- "assets_id": 0,
- "assets_name": "string",
- "assetTypes_id": 0,
- "assetTypes_name": "string",
- "assetCategories_id": 0,
- "assetCategories_name": "string",
- "manufacturers_id": 0,
- "manufacturers_name": "string",
- "assets_description": "string",
- "assets_serialNumber": "string",
- "assets_barcode": "string",
- "assets_value": "string",
- "assets_dayRate": 0,
- "assets_weekRate": 0,
- "assets_monthRate": 0,
- "assets_yearRate": 0,
- "assets_mass": 0,
- "assets_productLink": "string",
- "assets_inserted": "string",
- "assets_updated": "string",
- "assets_deleted": "string",
- "assets_status": "string",
- "assets_flags": null
}
], - "pagination": 0
}
Create Asset From Type
Creates an asset from an asset type Requires Instance Permission 17 ASSETS:CREATE
query Parameters
required | object The data to create the asset from |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": {
- "assets_id": 0,
- "assets_tag": "string",
- "assetTypes_id": 0
}
}
Simple Asset Search Deprecated
Searches for assets by tag or name
Deprecated, use /assets/deepSearch.php instead
query Parameters
term | string The term to search for |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [
- {
- "tag": "string",
- "assets_id": 0,
- "assets_tag": "string",
- "assetTypes_name": "string",
- "assetTypes_id": 0,
- "assetCategories_name": "string",
- "assetCategoriesGroups_name": "string",
- "manufacturers_name": "string"
}
]
}
Asset Type Search
Searches for asset types by name or manufacturer
query Parameters
term | string The term to search for |
manufacturer | string The manufacturer to search for |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [
- {
- "assetTypes_name": "string",
- "assetTypes_id": 0,
- "assetCategories_name": "string",
- "assetCategoriesGroups_name": "string",
- "manufacturers_name": "string"
}
]
}
Get Swappable Assets
Gets a list of assets that can be swapped with the given asset assignment
query Parameters
assetsAssignments_id required | integer The ID of the asset assignment |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [
- {
- "assets_id": 0,
- "assets_tag": "string",
- "asset_definableFields_1": "string"
}
]
}
Assign Barcode
Assign a barcode to an asset
Requires Instance Permission ASSETS:ASSET_BARCODES:EDIT:ASSOCIATE_UNNASOCIATED_BARCODES_WITH_ASSETS
query Parameters
tag required | string The tag of the Asset to assign a barcode to |
required | number or boolean An ID of an existing barcode or false |
text | string the value of a new barcode |
type | string The Barcode type |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": {
- "type": null,
- "properties": null
}
}
Barcode Asset Search
Search for an Asset using a barcode
query Parameters
text required | string The barcode value |
type required | string The barcode type |
locationType | string What the location is |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": {
- "asset": { },
- "assetSuggest": { },
- "barcode": "string",
- "location": { }
}
}
Add Asset to Group
Add an asset to a group
Requires Instance Permission ASSETS:ASSET_GROUPS:EDIT:ASSETS_WITHIN_GROUP
query Parameters
assetGroups_id required | integer The group id |
assets_id required | integer The asset id |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [ ]
}
Remove Asset from Group
Remove an asset from a group
Requires Instance Permission ASSETS:ASSET_GROUPS:EDIT:ASSETS_WITHIN_GROUP
query Parameters
assetGroups_id required | integer The group id |
assets_id required | integer The asset id |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [ ]
}
Add Asset
Add an asset to a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT:ADD_ASSETS
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
maintenanceJobs_assets required | Array of arrays Maintenance Job Assets |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Change Block
Change the block status of a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT:ASSET_BLOCKS
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
maintenanceJobs_blockAssets required | boolean Maintenance Job Block |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Change Due Date
Change the due date of a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT:JOB_DUE_DATE
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
maintenanceJobs_timestamp_due required | string Maintenance Job Due Date |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Change Job Assigned
Change who a maintenance job is assigned to
Requires Instance Permission MAINTENANCE_JOBS:EDIT:USER_ASSIGNED_TO_JOB
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
users_userid required | number Who the maintenance job is assigned to |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Change Job Status
Change the status of a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT:STATUS
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
maintenanceJobsStatuses_id required | number Maintenance Job Status id |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Change Name
Change the name of a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT:NAME
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
maintenanceJobs_title required | string Maintenance Job Name |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Change Priority
Change the priority of a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT:JOB_PRIORITY
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
maintenanceJobs_priority required | number Maintenance Job Priority |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Remove Asset
Remove an asset from a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
assets_id required | number Asset ID |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Send Message
Send a message to a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT:ADD_MESSAGE_TO_JOB
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
maintenanceJobsMessages_text required | string Message |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Tag User
Tag a user to a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT:USERS_TAGGED_IN_JOB
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
users_userid required | number User ID |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Untag User
Untag a user from a maintenance job
Requires Instance Permission MAINTENANCE_JOBS:EDIT:USERS_TAGGED_IN_JOB
query Parameters
maintenanceJobs_id required | number Maintenance Job ID |
users_userid required | number User ID |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Change Description
Change the description of a project
Requires Instance Permission PROJECTS:EDIT:DESCRIPTION_AND_SUB_PROJECTS
query Parameters
projects_id required | number Project ID |
projects_description required | string Project Description |
Responses
Response samples
- 200
null
Change Project Dates
Change the start and end dates of a project
Requires Instance Permission PROJECTS:EDIT:DATES
query Parameters
projects_id required | number Project ID |
projects_dates_use_start required | string Start Date/Time |
projects_dates_use_end required | string End Date/Time |
Responses
Response samples
- 200
null
Change Project Deliver Dates
Change the start and end deliver dates of a project
Requires Instance Permission PROJECTS:EDIT:DATES
query Parameters
projects_id required | number Project ID |
projects_dates_deliver_start required | string Start Date/Time |
projects_dates_deliver_end required | string End Date/Time |
Responses
Response samples
- 200
null
Edit Note
Edit a project note
Requires Instance Permission PROJECTS:PROJECT_NOTES:EDIT:NOTES
query Parameters
projects_id required | number Project ID |
projectsNotes_id required | number Project Note Id |
projectsNotes_text required | string Project Note Text |
Responses
Response samples
- 200
null
New
Create a new project
Requires Instance Permission PROJECTS:CREATE
query Parameters
projects_name required | string Project Name |
projects_manager required | number Project Manager User ID |
projectsType_id required | number Project Type ID |
projects_parent_project_id | number Parent Project ID |
Responses
Response samples
- 200
null
Accept Vacant Role Application
Accept a vacant role application
Requires Instance Permission PROJECTS:PROJECT_CREW:VIEW:VIEW_AND_APPLY_FOR_CREW_ROLES
query Parameters
projectsVacantRolesApplications_id required | number Vacant Role Application ID |
Responses
Response samples
- 200
null
Reject Vacant Role Application
Reject a vacant role application
Requires Instance Permission PROJECTS:PROJECT_CREW:VIEW:VIEW_AND_APPLY_FOR_CREW_ROLES
query Parameters
projectsVacantRolesApplications_id required | number Vacant Role Application ID |
Responses
Response samples
- 200
null
Assign Asset to Project
Assign an asset to a project
Requires Instance Permission PROJECTS:PROJECT_ASSETS:CREATE:ASSIGN_AND_UNASSIGN
query Parameters
projects_id required | number Project ID |
assetGroups_id | number Asset Group ID |
assets_id | number Asset ID |
Responses
Response samples
- 200
null
Set Asset Assignment Comment
Set the comment for an asset assignment
Requires Instance Permission PROJECTS:PROJECT_ASSETS:EDIT:ASSIGNMNET_COMMENT
query Parameters
assetsAssignments required | Array of numbers Asset Assignment IDs |
assetsAssignments_comment required | string Comment |
Responses
Response samples
- 200
null
Set Asset Assignment Discount
Set the discount for an asset assignment
Requires Instance Permission PROJECTS:PROJECT_ASSETS:EDIT:DISCOUNT
query Parameters
assetsAssignments required | Array of numbers Asset Assignment IDs |
assetsAssignments_discount required | number Discount amount |
Responses
Response samples
- 200
null
Set Asset Assignment Price
Set the price for an asset assignment
Requires Instance Permission PROJECTS:PROJECT_ASSETS:EDIT:CUSTOM_PRICE
query Parameters
assetsAssignments required | Array of numbers Asset Assignment IDs |
assetsAssignments_customPrice required | number Price |
Responses
Response samples
- 200
null
Set Asset Assignment Status
Set the status for an asset assignment
Requires Instance Permission PROJECTS:PROJECT_ASSETS:EDIT:ASSIGNMENT_STATUS
query Parameters
assetsAssignments_status required | number Status |
assetsAssignments_id required | number Asset Assignment ID |
projects_id required | number Project ID |
status_is_order | boolean Whether the status is an ordering rather than a status |
Responses
Response samples
- 200
null
Set Asset Assignment Status using Barcode
Set the status for an asset assignment using a barcode
Requires Instance Permission PROJECTS:PROJECT_ASSETS:EDIT:ASSIGNMENT_STATUS
query Parameters
text required | string barcode value |
type required | string barcode type |
locationType required | enum Enum: "barcode" "asset" "Custom" location type |
projects_id required | number Project ID |
assetsAssignments_status required | number Status ID |
Responses
Response samples
- 200
null
Swap Asset Assignment
Swap an asset in a project
Requires Instance Permission PROJECTS:PROJECT_ASSETS:CREATE:ASSIGN_AND_UNASSIGN
query Parameters
assetsAssignments_id required | number Asset Assignment ID |
assets_id required | number Project ID |
Responses
Response samples
- 200
null
Unassign Asset
Unassign an asset from a project
Requires Instance Permission PROJECTS:PROJECT_ASSETS:CREATE:ASSIGN_AND_UNASSIGN
query Parameters
assetsAssignments required | Array of numbers Asset Assignment IDs |
assets_id required | number Asset ID |
projects_id | number Project ID |
Responses
Response samples
- 200
null
Add User to Instance
Add a user to an instance
Requires Instance Permission BUSINESS:USERS:CREATE:ADD_USER_BY_EMAIL
query Parameters
rolegroup required | number The instance position id |
rolename required | string The role name |
users required | Array of numbers The user ids |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [ ]
}
Edit User
Edit a user's role
Requires Instance Permission BUSINESS:USERS:EDIT:CHANGE_ROLE
query Parameters
userinstanceid required | number The userinstance id |
position required | number The user's position id |
label required | string The user's role label |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [ ]
}
Create Instance
Create a new instance
Requires server permission INSTANCES:CREATE
query Parameters
instances_name required | string The instance name |
instances_website required | string The instance website |
instances_email required | string The instance email |
instances_phone required | string The instance phone number |
role required | number The user's role id |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": {
- "instanceid": 0
}
}
Edit Asset Assignment Status
Edit an asset assignment status
Requires Instance Permission BUSINESS:BUSINESS_SETTINGS:EDIT
query Parameters
statusId required | integer The status id |
statusName required | string The status name |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [ ]
}
Create Asset Assignment Status
Create an asset assignment status
Requires Instance Permission BUSINESS:BUSINESS_SETTINGS:EDIT
query Parameters
statusName required | string The status name |
statusOrder required | integer The status order |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [ ]
}
Rollback CMS Page Content
Rollback a page content
Requires Instance Permission CMS:CMS_PAGES:EDIT
query Parameters
cmsPages_id required | integer The ID of the page |
change required | string The description of the change |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [ ]
}
Edit CMS Page Content
Edit a page content
Requires Instance Permission CMS:CMS_PAGES:EDIT
query Parameters
cmsPages_id required | integer The ID of the page |
pageData required | string The page data |
changelog required | string The description of the change |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
Set Custom Dashboard
Set a custom dashboard
Requires Instance Permission CMS:CMS_PAGES:EDIT:CUSTOM_DASHBOARDS
query Parameters
instancePositions_id required | number instance position for the dashboard |
cmsPages_id required | number The page id |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": [ ]
}
Get File
Get a file
query Parameters
f required | integer The file id |
s | string | boolean The file size |
d | boolean should a download be forced or should it be displayed in the browser? (if set it will download) |
r | boolean should the url be returned by the script as plain text or a redirect triggered? (if set it will redirect) |
e | boolean when should the link expire? Must be a string describing how long in words basically. If this file type has security features then it will default to 1 minute. |
Responses
Response samples
- 200
- default
{- "result": true,
- "response": { }
}
v1 notification endpoints
These endpoints are not accessible from the web, and are instead used internally.
Upload Success
Upload a file to S3
query Parameters
name required | string File Name |
size required | number File Size |
typeid required | number File Type ID |
subtype | number File Subtype |
orignalName required | string Original File Name |
public required | boolean Public File |
Responses
Response samples
- 200
{- "result": true,
- "response": { }
}