Resources are the objects that Actionstep has made available to API clients. Each resource page defines properties and fields available to for that resource. Below is a description of each section common to all of the properties defined in each pageresource pages.
Resource Location
The resource path to be appended to the base endpoint in order to act on this resource. For example:
...
A table describing the attributes of the resource. This table has the following columns:
| Field | The attribute name |
|---|---|
| Description | A short description of the attribute |
| Format | The format that Actionstep requires the attribute value to be in when creating or updating resources. See Formats. |
| Required | Indicates if the attribute is required when creating or updating a recourse. |
| Field Type | Indicates 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). |
| Notes | Helpful 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.
...
The following table is a list of formats and format options 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 and or null. Additionally, any the string base type may be followed by supports a length option: i.e. . For example, "string(<55) This " denotes that the max length of the value must be less than 5 characters. Similarly a format of "string(>5)" would denote that the value of the attribute must be greater than is 5 characters.
| Format | Base Type | Example | Notes |
|---|---|---|---|
| timestamp | string | "2014-12-28T17:23:14+12:00" |
| decimal(precision,length) | number | 12.6 | Custom decimal number that doesn't conform to our other specified decimal formats. |
| currency | number | 13.10 | Decimal number with a set precision of 2 and a set length of 10. |
| time | number | 15.82 | Decimal number with a set precision of 2. |
| collection | string | "[1,2,3]" |
...
| boolean | string | "T" or "F" | "T" indicates true and "F" indicated false. |