Popular Endpoints | Resolver Knowledge Base

fields

formulas

objectTypes

objectTypeRoles

lifecycle

relationshipTypes

reports

user

fields

Retrieve, create, update, or delete fields individually or retrieve the fields added to an object type.

Field Types

Field Type	Description
0	Text
1	Numeric
2	Date & Time
3	Single Select List
4	Attachment
5	Multi Select List
6	Image Attachment

GET /object/field

Retrieve all fields in the org or narrow your search by field name or ID.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/field?includeFieldOptions=false'

Parameters

Name	Parameter Type	Data Type	Description	Required
searchText	query	string	Keyword(s) that will narrow the search results.	No
ids	query	string	The internal ID of the specific field you want to retrieve. Leaving this field blank will retrieve all fields in the org.	No
includeFieldOptions	query	boolean	If true, the response will include select list options.	No

Example Response Body

{
  "data": [
    {
      "id": 12732,
      "name": "Abbreviation",
      "nameKey": "app:field:name:371a4976-61bb-4040-bcb9-3107abf6c375",
      "uniqueName": "ABBREVIATI",
      "type": 0,
      "longName": "",
      "longNameKey": "app:field:longName:a029dee3-4a5e-4a17-aa01-96b909b7512e",
      "pii": false,
      "created": "2017-11-29T21:23:16.057Z",
      "modified": null,
      "org": 46,
      "properties": {
        "maxCharLength": 32,
        "multipleLines": false,
        "maximumCharacters": 10
      },
      "defaultSelection": null,
      "nextFieldOptionOrdinal": 0,
      "externalRefId": "c5b27c1e-137f-42a8-b07c-764d9ad8a0f5"
    }

Success Response

200 OK

POST /object/field

Create a new field.

Curl Request

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' -d '{  "name": "New Field",  "type": 0,  "longName": "string",  "pii": true,  "properties": {},  "defaultSelection": 0,  "externalRefId": "string" }' 'https://YOUR_ENVIRONMENT.resolver.com/object/field'

Body Parameters

Name	Parameter Type	Data Type	Description	Required
name	body	string	The name of the new field.	Yes
type	body	integer	The type of field, represented by a number. See the Field Types table above for a list of types.	Yes
longName	body	string	The longer name of the field, if any, which may include additional details.	No
pii	body	boolean	This is for internal use only.	No
properties	body	dimension	Additional configuration options for the field, depending on the type (e.g., maximum and minimum characters on a text field).	No
defaultSelection	body	number	An unused parameter. Disregard.	No
externalRefId	body	string	The external reference ID of the new field.	No

Example Body Parameter

{
  "name": "string",
  "type": 0,
  "longName": "string",
  "pii": true,
  "properties": {},
  "defaultSelection": 0,
  "externalRefId": "string"
}

Example Response

{
  "id": 87977
}

Success Response

200 OK

PUT /object/field/{id}

Update an existing field.

Curl Request

curl -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' -d '{  "name": "Updated Field",  "longName": "string",  "uniqueName": "string",  "properties": {},  "defaultSelection": 0,  "externalRefId": "string",  "type": 0 }' 'https://YOUR_ENVIRONMENT.resolver.com/object/field/87977'

Parameters

Name	Parameter Type	Data Type	Description	Required
id	double	path	The internal ID of the field you want to modify.	Yes
externalRefId	string	path	The external reference ID of the field you want to modify.	No
name	body	string	The name of the field.	No
longName	body	string	The longer name of the field, if any, which may include additional details.	No
uniqueName	body	string	The field's unique identifier in Core. Changing a component's unique name is not recommended as it can break other components that reference it.	No
properties	body	dimension	Additional configuration options for the field, depending on the type (e.g., maximum or minimum characters for a text field).	No
defaultSelection	body	number	An unused parameter. Disregard.	No
externalRefId	body	string	The external reference ID of the new field.	No
type	body	integer	The type of field, represented by a number. See the Field Types table above for a list of types.	No

Example Body Parameter

{
  "name": "string",
  "longName": "string",
  "uniqueName": "string",
  "properties": {},
  "defaultSelection": 0,
  "externalRefId": "string",
  "type": 0
}

Success Response

204 No Content

DELETE /object/field/{id}

Delete a field from the org.

Curl Request

curl -X DELETE --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/field/87977'

Parameters

Name	Parameter Type	Data Type	Description	Required
id	path	integer	The internal ID of the field you want to delete.	Yes

Success Response

204 No Content

GET /object/objectType/{objectTypeId}/field

Retrieves a list of fields added to an object type.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_TOKEN' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType/4164/field?includeFieldOptions=true'

Parameters

Name	Parameter Type	Data Type	Description	Required
objectTypeId	path	double	The internal ID of the object type you wish to retrieve the fields from.	Yes
includeFieldOptions	path	boolean	If true, the response will include options for select list fields.	No

Success Response

200 OK

Example Response Body

[
  {
    "id": 12848,
    "name": "Attachments",
    "nameKey": "app:field:name:ec4736a3-7a14-4864-884f-923618905a57",
    "uniqueName": "ATTACHMENT",
    "type": 4,
    "longName": "(File Link Only)",
    "longNameKey": "app:field:longName:4aa16f16-7623-4c4e-8498-04917ad90450",
    "pii": false,
    "created": "2017-11-29T21:23:16.057Z",
    "modified": "2018-08-16T21:10:46.106Z",
    "org": 46,
    "properties": {
      "maxCharLength": 32,
      "multipleLines": false,
      "attachmentType": 1
    },
    "defaultSelection": null,
    "nextFieldOptionOrdinal": 0,
    "externalRefId": "fadedfd1-40ec-4a55-aaca-3eee65cb71f4",
    "options": []
  }

formulas

Retrieve the formulas added to an object type as well as their ranges.

GET /object/objectType/{objectTypeId}/formulas

Retrieve all formulas added to an object type.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType/4176/formulas'

Parameters

Name	Parameter Type	Data Type	Description	Required
objectTypeId	path	double	The internal ID of the object type you wish to retrieve the formulas from.	Yes

Success Response

200 OK

Example Response Body

{
  "data": [
    {
      "id": 7739,
      "name": "Avg Response Time",
      "nameKey": "app:formula:name:56f853e6-87e2-46d4-a49c-f1cbaec35422",
      "script": "RTIME",
      "format": null,
      "formatStyle": 0,
      "rangeStyle": 0,
      "objectTypeId": 4176,
      "type": 1,
      "created": "2018-09-12T19:18:23.608Z",
      "modified": "2018-09-12T19:19:41.660Z",
      "org": 46,
      "externalRefId": "c49b63e0-b86a-4d00-a725-c9fed2ee594e",
      "transitionId": null
    }

GET /object/objectType/{objectTypeId}/formulas/{formulaId}/ranges

Retrieve all ranges added to a formula.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer eyJhbGciOiJLTVMiLCJ0eXAiOiJKV1QifQ.eyJzZXNzaW9uIjoiNjkwYTg1YmYtYjgzMS00ZGU4LTkyNjMtNWE1ZjZkYTNkODk1IiwiX3B1cnBvc2UiOiJsb2dpbiIsImV4cCI6MTYwNTMwOTQ4MCwiaWF0IjoxNjA1MjkxNDgwfQ.AQICAHjkCdIHAV_V5K9y0iCicRyqb7QKMNNwPg2yLDYQ53MvegFUwgfIZBih0JYHRqIuvaV9AAABETCCAQ0GCSqGSIb3DQEHBqCB_zCB_AIBADCB9gYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAwjJ-3NoJ8jG59X6KsCARCAgcgvQr8kQPEeYqCwYARIwYO1sUCtPLYsYBVDMKRWzwlNaF9OK-x2gi6ik5wz8fXVu5KjFxZKiRPVI_AlKixb5z6BP5Ep13TXX5-n2A6By985RqqczKzcg6AztZHh-oFZhTKuYxGMI40y7s1D-zFcJUQKKZorpbKC69cvGHKhhncNGAM0J0BiHPhTe2Noys0_BZcZoRgq_6ctBsUSKgBEIsJg7Eq5mHVxusBXYqpNhkI1qC0GQ6T2xdCmGpfrTvztmfreXcNet3zFow' 'https://alpha.staging.resolver.com/object/objectType/4176/formulas/7739/ranges'

Parameters

Name	Parameter Type	Data Type	Description	Required
objectTypeId	path	double	The internal ID of the object type you wish to retrieve the formulas from.	Yes
formulaId	path	double	The internal ID of the formula.	Yes

Success Response

200 OK

Example Response Body

[
  {
    "id": 24458,
    "name": "Low",
    "nameKey": "app:formulaRange:name:f7d91803-7b58-4dc8-86a7-8bbb8b0dd493",
    "formulaId": 7739,
    "maximum": 33,
    "color": "#6FB93A",
    "created": "2018-09-12T19:18:23.608Z",
    "modified": null,
    "org": 46,
    "externalRefId": "f28b7b46-4b60-4db8-b633-6d6ecdf5d11a"
  },
  {
    "id": 23497,
    "name": "Medium",
    "nameKey": "app:formulaRange:name:7ce9fe35-d0d2-40a9-9d72-45935923c05f",
    "formulaId": 7739,
    "maximum": 66,
    "color": "#F8E71C",
    "created": "2018-09-12T19:18:23.608Z",
    "modified": null,
    "org": 46,
    "externalRefId": "343609f8-d7bf-4744-977b-c0b481d85848"
  },
  {
    "id": 23882,
    "name": "High",
    "nameKey": "app:formulaRange:name:689f6a8d-fed9-4e2d-90e6-34929ff94cf5",
    "formulaId": 7739,
    "maximum": 100,
    "color": "#D0021B",
    "created": "2018-09-12T19:18:23.608Z",
    "modified": null,
    "org": 46,
    "externalRefId": "84319b13-8257-4270-ae4a-8994abb65df3"
  }
]

objectTypes

Retrieve object type details, as well as create, modify, or delete object types.

GET /object/objectType

Retrieves a list of all the object types in the org, along with their external reference IDs and internal IDs.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType'

Parameters

Name	Parameter Type	Data Type	Description	Required
id	query	string	The internal ID of the specific object type you want retrieve, if any. Leaving this field blank will retrieve all object types in the org.	No

Example Response Body

{
      "id": 4198,
      "name": "Incident Type",
      "pluralName": "Incident Types",
      "description": "",
      "monogram": "IT",
      "nameKey": "app:objectType:name:989fb792-4483-486d-a521-9c7ef22f906c",
      "descriptionKey": "app:objectType:description:709504f2-b2ca-4ea4-b9bd-d8afa7226b00",
      "pluralNameKey": "app:objectType:pluralName:d81eae66-8b4a-45b0-a3e1-91b541f44012",
      "monogramKey": "app:objectType:monogram:004b4b8e-d039-4481-af44-98ff2ea16294",
      "color": "#2f6ccb",
      "objectLifeCycleId": 4934,
      "externalRefId": "IncidentType",
      "created": "2017-11-29T21:23:16.057Z",
      "modified": "2019-01-25T16:24:40.300Z",
      "nextElement": 34,
      "org": 46,
      "assessment": false,
      "anchor": null,
      "anchorRelationship": null,
      "dataDefinitionId": null
    }

Success Response

200 OK

POST /object/objectType

Creates a new object type.

Curl Request

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' -d '{  "name": "New Object Type",  "monogram": "NOT" }' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType'

Parameters

Name	Parameter Type	Data Type	Description	Required
name	body	string	The name of the object type.	Yes
monogram	body	string	The one to three letter monogram of the object type.	Yes
color	body	string	The color of the object type monogram.	No
description	body	string	The description of the object type.	No
pluralName	body	string	The plural name of the object type.	No
externalRefId	body	string	The external reference ID of the object type.	No
assessment	body	boolean	If true, creates an assessment object type.	No

Example Body Parameter

{
  "name": "string",
  "monogram": "string",
  "color": "string",
  "description": "string",
  "pluralName": "string",
  "externalRefId": "string",
  "assessment": false
}

Example Response

{
  "id": 15739
}

Success Response

200 OK

PUT /object/objectType/{id}

Updates an existing object type.

Curl Request

curl -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_TOKEN' -d '{  "name": "OBT" }' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType/15739'

Parameters

Name	Parameter Type	Data Type	Description	Required
id	path	double	The internal ID of the specific object type you want to modify.	Yes
externalRefId	path	string	The external reference ID of the object type you want to modify.	No
name	body	string	The name of the object type.	No
monogram	body	string	The one to three letter monogram of the object type.	No
color	body	string	The color of the object type monogram.	No
description	body	string	The description of the object type.	No
pluralName	body	string	The plural name of the object type.	No
externalRefId	body	string	The external reference ID of the object type.	No
assessment	body	boolean	If true, creates an assessment object type.	No

Example Body Parameter

{
  "name": "string",
  "monogram": "string",
  "color": "string",
  "description": "string",
  "pluralName": "string",
  "externalRefId": "string",
  "assessment": false
}

Success Response

204 No Content

DELETE /object/objectType/{id}

Deletes an object type.

Curl Request

curl -X DELETE --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType/15739'

Parameters

Name	Parameter Type	Data Type	Description	Required
id	path	double	The internal ID of the specific object type you want to delete.	Yes

Success Response

204 No Content

objectTypeRoles

Retrieve, add, modify, or delete roles added to object types.

GET /object/objectType/{objectTypeId}/role

Retrieves the roles added to an object type.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType/4188/role'

Parameters

Name	Parameter Type	Data Type	Description	Required
objectTypeId	path	double	The internal ID of the object type you want to retrieve roles from.	Yes

Success Response

200 OK

Example Response Body

[
  {
    "id": 2620,
    "name": "Control Owner",
    "description": "Compliance Management, Risk Management",
    "nameKey": "app:role:name:c03c11e4-062b-4913-94ae-b79362cbc294",
    "descriptionKey": "app:role:description:6bc5e50f-cb43-4b27-a7e4-aada7eead96c",
    "isGlobal": false,
    "created": "2017-12-15T06:28:05.748Z",
    "modified": "2019-10-25T18:38:14.796Z",
    "org": 46,
    "externalRefId": "619ec9fd-b624-44c6-aa56-15c32bee1820",
    "canPerformSearch": true,
    "canQuickCreate": true,
    "canGetHelp": true,
    "canSearchArchive": true
  },
  {
    "id": 2637,
    "name": "Reviewed By",
    "description": "",
    "nameKey": "app:role:name:3beca149-9ba5-4d37-8135-eb6c4e0462b2",
    "descriptionKey": "app:role:description:24af4bc4-53a8-467b-9349-f174276c3ab9",
    "isGlobal": false,
    "created": "2018-03-15T02:53:27.270Z",
    "modified": "2019-10-25T18:38:14.796Z",
    "org": 46,
    "externalRefId": "a5655e05-ec0b-475e-b1f7-495872ece72f",
    "canPerformSearch": true,
    "canQuickCreate": true,
    "canGetHelp": true,
    "canSearchArchive": true
  }
]

POST /object/objectType/{objectTypeId}/role

Add a role to an object type.

Curl Request

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' -d '{  "roleIds": [    4037  ] }' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType/10317/role'

Parameters

Name	Parameter Type	Data Type	Description	Required
objectTypeId	path	double	The internal ID of the object type you want to add the role to.	Yes
roleIds	body	roleIds	The internal ID of the role you want to add to the object type.	Yes

Success Response

200 OK

Example Response Body

[
  {
    "id": 7112,
    "object_type_id": 10317,
    "role_id": 4038,
    "org": 46
  }
]

DELETE /object/objectType/{objectTypeId}/role/{roleId}

Delete a role from an object type.

curl -X DELETE --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType/10317/role/4038'

Parameters

Name	Parameter Type	Data Type	Description	Required
objectTypeId	path	double	The internal ID of the object type you want to add the role to.	Yes
roleId	path	double	The internal ID of the role you want to delete from the object type.	Yes

Success Response

204 No Content

lifecycle

Retrieve, modify, or delete object type workflows.

GET /object/objectType/{objectTypeId}/objectLifeCycle

Retrieve all workflows and workflow states for an object type.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType/6020/objectLifeCycle?includeStates=true'

Parameters

Name	Parameter Type	Data Type	Description	Required
objectTypeId	path	double	The object type you want to retrieve the workflows for.	Yes
includeStates	query	boolean	If true, the response will include workflow states.	No

Success Response

200 OK

Example Response Body

{
  "data": [
    {
      "id": 7421,
      "name": "GS Injury",
      "type": 1,
      "nameKey": "app:objectLifeCycle:name:c25dbe52-f46e-4d2c-b620-7ddc99df0855",
      "description": null,
      "descriptionKey": "app:objectLifeCycle:description:2a1d0022-a65f-4421-b526-035dbb4bed6e",
      "created": "2019-04-24T15:36:06.804Z",
      "modified": "2019-04-24T15:36:06.804Z",
      "org": 46,
      "nextStateOrdinal": 1,
      "externalRefId": "2cce6a45-5392-4916-8254-14dea960749e",
      "objectTypeId": 6020,
      "states": [
        {
          "id": 29660,
          "objectLifeCycleId": 7421,
          "name": "Creation",
          "stateCategoryId": null,
          "nameKey": "app:objectLifeCycleState:name:b7de667d-d379-4c92-81cb-f537024277be",
          "color": "#0fc0fc",
          "ordinal": -1,
          "created": "2019-04-24T15:36:06.804Z",
          "modified": null,
          "org": 46,
          "creation": true,
          "externalRefId": "0f7bd9e8-106f-4e3b-8cbb-ea66d31165ee"
        },
        {
          "id": 29661,
          "objectLifeCycleId": 7421,
          "name": "Draft",
          "stateCategoryId": 1,
          "nameKey": "app:objectLifeCycleState:name:9c839e30-e2df-4a7d-bfc4-cad50dc560a9",
          "color": "#0fc0fc",
          "ordinal": 0,
          "created": "2019-04-24T15:36:06.804Z",
          "modified": null,
          "org": 46,
          "creation": false,
          "externalRefId": "6867d477-9b7b-42bb-a223-157e604c5bfc"
        },
        {
          "id": 29662,
          "objectLifeCycleId": 7421,
          "name": "Active",
          "stateCategoryId": 2,
          "nameKey": "app:objectLifeCycleState:name:47a6cc00-bbc0-47c7-97dc-058e42a066fe",
          "color": "#0fc0fc",
          "ordinal": 1,
          "created": "2019-04-24T15:36:06.804Z",
          "modified": null,
          "org": 46,
          "creation": false,
          "externalRefId": "78e2b3af-bc6c-4ba1-b0fa-a85b8e752c53"
        },
        {
          "id": 29663,
          "objectLifeCycleId": 7421,
          "name": "Archived",
          "stateCategoryId": 3,
          "nameKey": "app:objectLifeCycleState:name:1bf39775-6d9a-4d32-aff9-4a77313b52f0",
          "color": "#0fc0fc",
          "ordinal": 2,
          "created": "2019-04-24T15:36:06.804Z",
          "modified": null,
          "org": 46,
          "creation": false,
          "externalRefId": "d04afd5e-ab5b-4d23-8022-509f909f8b0b"
        }
      ]
    }
  ]
}

relationshipTypes

Retrieve, add, modify, or delete relationships and references.

GET /object/objectType/{objectTypeId}/relationship

Retrieve all relationships for an object type, with the option to references and/or details of linked object types.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/objectType/6130/relationship?inverse=true&includeObjectTypes=false'

Parameters

Name	Parameter Type	Data Type	Description	Required
objectTypeId	path	double	The internal ID of the object type you want to retrieve the relationships from.	Yes
inverse	query	boolean	If true, the response will also include references.	No
includeObjectTypes	query	boolean	If true, the response will also include linked object type details.	No

Success Response

200 OK

Example Response Body

{
  "outgoing": [
    {
      "id": 5186,
      "name": "Risks",
      "longName": "",
      "referenceName": "Assets",
      "nameKey": "app:relationship:name:d9611d04-738d-4c4e-afc8-36def232b0ee",
      "longNameKey": "app:relationship:longName:c2cde73a-6f9a-4513-912c-66462606e4af",
      "referenceNameKey": "app:relationship:referenceName:5e3a69dc-62b5-4001-8a39-3d71c88dac8b",
      "objectTypeId": 4180,
      "objectTypeGroupId": 3593,
      "maximumAllowedEdges": 0,
      "created": "2017-11-29T21:23:16.057Z",
      "modified": null,
      "org": 46,
      "externalRefId": "Asset-Risk"
    },
    {
      "id": 5185,
      "name": "Attachments",
      "longName": "",
      "referenceName": "",
      "nameKey": "app:relationship:name:bfbe7cda-3a52-4108-94de-e04ec56f4887",
      "longNameKey": "app:relationship:longName:ce992ea0-7839-406a-9d61-3f2cd50ade6c",
      "referenceNameKey": "app:relationship:referenceName:bcac4669-4421-4599-9f5f-c6195e155fbb",
      "objectTypeId": 4180,
      "objectTypeGroupId": 3584,
      "maximumAllowedEdges": 0,
      "created": "2018-11-22T22:42:51.857Z",
      "modified": "2018-11-22T22:43:28.918Z",
      "org": 46,
      "externalRefId": "Asset-Attachment"
    }
  ],
  "incoming": [
    {
      "id": 5247,
      "name": "Key Assets",
      "longName": "",
      "referenceName": "Locations",
      "nameKey": "app:relationship:name:e78b742d-ef08-4159-bec4-9d122c856231",
      "longNameKey": "app:relationship:longName:a08ff317-4b35-4d0c-89a7-a2aebbf43b36",
      "referenceNameKey": "app:relationship:referenceName:be1ac710-7bc5-4434-98db-0af3b3fca41d",
      "objectTypeId": 4211,
      "objectTypeGroupId": 3595,
      "maximumAllowedEdges": 0,
      "created": "2017-11-29T21:23:16.057Z",
      "modified": "2018-03-19T02:48:33.106Z",
      "org": 46,
      "externalRefId": "Location-Asset"
    },

reports

Retrieve, modify, add, or delete reports, filters, and/or parameters.

Report Component Types

Type	Element
1	Free Form Text
2	Table
3	Pie/Half-Pie Chart
4	Heat Map
5	Bar/Column Chart
6	N/A (Unsupported elements)
7	Repeatable Forms
8	Page Break

Table Column Types

Type	Element
1	Field
2	Relationship
3	Formula
4	Role
5	Property
6	Attachment Field
7	Workflow State

GET /object/report

Retrieve all reports within the org.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/report'

Success Response

200 OK

Example Response Body

{
  "data": [
    {
      "id": 9017,
      "name": "Risks & Controls By Location",
      "description": "",
      "nameKey": "app:report:name:820c6f98-b82d-496f-9df2-2e2da44a866f",
      "descriptionKey": "app:report:description:231e091c-296b-43bf-a2d9-91a5eca5913b",
      "objectTypeId": 4211,
      "created": "2019-12-09T19:06:56.042Z",
      "modified": "2019-12-09T19:14:58.577Z",
      "org": 46,
      "externalRefId": "8e197f22-774f-459f-b9a1-a087055c1fb7",
      "nextReportComponentOrdinal": 0,
      "type": 1,
      "showArchiveData": false,
      "nestloop": "org"
    }

GET /object/{reportId}/filter

Retrieve a report's filters.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOU_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/report/2203/filter'

Parameters

Name	Parameter Type	Data Type	Description	Required
reportId	path	double	The internal ID of the report you want to retrieve filters from.	Yes

Success Response

200 OK

Example Response Body

[
  {
    "id": 2159,
    "reportId": 2203,
    "type": 1,
    "elementId": 12739,
    "objectTypeId": 4207,
    "subtype": 2,
    "created": "2017-12-13T22:02:47.788Z",
    "modified": null,
    "org": 46,
    "externalRefId": "1cc5eeee-8f0d-4030-8823-8052d23fdc3e",
    "columnFilter": false,
    "required": false
  },
  {
    "id": 2165,
    "reportId": 2203,
    "type": 1,
    "elementId": 12805,
    "objectTypeId": 4197,
    "subtype": 3,
    "created": "2017-12-13T22:02:47.788Z",
    "modified": null,
    "org": 46,
    "externalRefId": "23933d1b-f991-43ce-8a76-59a41f1b3a93",
    "columnFilter": false,
    "required": false
  }
]

GET /object/report/{reportId}/reportComponents

Retrieve a list of components (tables, pie charts, etc.) on a report.

Curl Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: bearer YOUR_API_KEY' 'https://YOUR_ENVIRONMENT.resolver.com/object/report/2203/reportComponents'

Parameters

Name	Parameter Type	Data Type	Description	Required
reportId	path	double	The internal ID of the report you want to retrieve components from.	Yes

Success Response

200 OK

Example Response

{
  "data": [
    {
      "id": 6177,
      "reportId": 2262,
      "reportDataDefinitionId": null,
      "componentDataDefinitionId": null,
      "displayProperties": {},
      "showTotals": false,
      "allData": true,
      "libraryData": true,
      "content": "The report outlines all requirements that are not applicable to the organization. If a requirement becomes applicable, click on the requirement below and click **Reassess Applicability** to submit the requirement for review by the Compliance Team. ",
      "contentKey": "app:reportComponent:content:b9eab3e2-1d6a-4d56-82cb-cb4297c18208",
      "xAxisLabel": null,
      "xAxisLabelKey": null,
      "yAxisLabel": null,
      "yAxisLabelKey": null,
      "groupByType": null,
      "groupByRelationshipId": null,
      "groupByObjectTypeId": null,
      "type": 1,
      "subtype": 1,
      "ordinal": 0,
      "created": "2018-11-22T16:06:42.749Z",
      "modified": "2018-11-22T16:07:52.337Z",
      "org": 46,
      "externalRefId": "351e1f17-a258-4f80-86ad-e231b59d4b87",
      "showColoredCellsAsOvals": false,
      "dataProperties": {
        "forms": {},
        "columns": [],
        "parameters": [],
        "subtype": 1,
        "componentDataDefinitionId": null,
        "reportDataDefinitionId": null,
        "showTotals": false,
        "content": "The report outlines all requirements that are not applicable to the organization. If a requirement becomes applicable, click on the requirement below and click **Reassess Applicability** to submit the requirement for review by the Compliance Team. ",
        "contentKey": "app:reportComponent:content:b9eab3e2-1d6a-4d56-82cb-cb4297c18208",
        "xAxisLabel": null,
        "xAxisLabelKey": null,
        "yAxisLabel": null,
        "yAxisLabelKey": null,
        "groupById": null,
        "groupByType": null,
        "showColoredCellsAsOvals": false
      }
    },
    {
      "id": 6258,
      "reportId": 2262,
      "reportDataDefinitionId": 7420,
      "componentDataDefinitionId": 7355,
      "displayProperties": {},
      "showTotals": false,
      "allData": false,
      "libraryData": true,
      "content": "",
      "contentKey": null,
      "xAxisLabel": null,
      "xAxisLabelKey": null,
      "yAxisLabel": null,
      "yAxisLabelKey": null,
      "groupByType": null,
      "groupByRelationshipId": null,
      "groupByObjectTypeId": null,
      "type": 1,
      "subtype": 2,
      "ordinal": 1,
      "created": "2018-11-22T15:53:01.001Z",
      "modified": "2018-11-22T16:08:13.652Z",
      "org": 46,
      "externalRefId": "7eb77b61-30a7-4fa2-aa3d-817e41fe2f83",
      "showColoredCellsAsOvals": false,
      "dataProperties": {
        "enabledForms": {
          "": false
        },
        "forms": {
          "": 7358
        },
        "columns": [
          {
            "id": 19180,
            "componentId": 6258,
            "nodeId": 51077,
            "type": 1,
            "ordinal": 3,
            "subtype": 0,
            "identifier": 12549,
            "objectTypeId": 4227,
            "created": "2018-11-22T16:08:13.652Z",
            "modified": null,
            "org": 46,
            "externalRefId": "249fa322-af5c-40e3-9865-531a1984cd62",
            "readOnly": false,
            "path": "",
            "pathAnchor": 4227
          },
            ],
        "parameters": [],
        "titles": {},
        "subtype": 2,
        "componentDataDefinitionId": 7355,
        "reportDataDefinitionId": 7420,
        "showTotals": false,
        "content": "",
        "contentKey": null,
        "xAxisLabel": null,
        "xAxisLabelKey": null,
        "yAxisLabel": null,
        "yAxisLabelKey": null,
        "groupById": null,
        "groupByType": null,
        "showColoredCellsAsOvals": false
      }
    }
  ]
}

user

Get user id often utilized for multi-factor authentication (MFA) user reset

To retrieve a user ID:

Click theicon in the top bar > Swagger Docs in the Tools section.
Click on any of the topics to open the API in a new browser tab.
From the user section, click Get /user/users to open the parameters.
In the search field, input the user’s email address.
Click Try it out!
In the Response Body section, locate the User ID next to “id:”