Resources

Resources are the objects that Actionstep has made available to API clients. Each resource page defines properties and fields available for that resource. Below is a description of each section common to all of the resource pages.

Resource Location

The resource path to be appended to the base endpoint in order to act on this resource. For example:

/timerecords
Available Methods

The HTTP methods that Actionstep supports on the resource. These can also be queried by using the OPTIONS method on a resource.

OPTIONS /timerecords
Page Size & Max Page Size

Most resources exist as collections. As such, collections greater than the default or requested page size will be returned paged. Each resource defines the default page size and a max page size. The default page size cannot be adjusted but a custom page size can be requested as long as it doesn't exceed the max page size, which also cannot be adjusted. The default values are set in relation to the size of the resource objects requested.

Resource Attributes

A table describing the attributes of the resource. This table has the following columns:

FieldThe attribute name
DescriptionA short description of the attribute
FormatThe format that Actionstep requires the attribute value to be in when creating or updating resources. See Formats.
RequiredIndicates if the attribute is required when creating or updating a recourse.
Field TypeIndicates the type of attribute when requesting a resource. An attribute with the type "default" will be returned automatically with a resource request; whereas, an attributed with the type "additional" must be requested specifically if it is to be returned as part of the resource. A "link" type indicates that the attribute is found in the links attribute of the resource and relates to another resource. This relationship can be either one-to-one or one-to-many (represented by example values of "1" and "[1,2,3]" respectively).
NotesHelpful information - particularly in regard to required logic and constraints when creating or updating resources.
Link Templates

A table of resources, with its corresponding URL templates. The items in this table are primarily comprised of linked resources that are referenced in the resource object, or where the primary resource is referenced in additional resources.

Basically what this means is that the return data will contain a bunch of urls which you could use to programmatically request additional information linked to the returned data if needed.

Errors

A table of error codes that may be encountered. The primary field that is affected by the error is listed as well as a description of the conditions that exist on the field when setting it's value.

Formats

The following table is a list of formats that are used in this documentation to describe the form a value should take when creating and updating resources. Each format has a base type of either: string, number, boolean or null. Additionally, the string base type supports a length option. For example, "string(5)" denotes that the max length of the value is 5 characters.

FormatBase TypeExampleNotes
timestampstring"2014-12-28T17:23:14+12:00"
decimal(precision,length)number12.6Custom decimal number that doesn't conform to our other specified decimal formats.
currencynumber13.10Decimal number with a set precision of 2 and a set length of 10.
timenumber15.82Decimal number with a set precision of 2.
collectionstring"[1,2,3]"


booleanstring"T" or "F""T" indicates true and "F" indicated false.