Skip to content

Backup Approver Associations

A Backup Approver Association represents the relationship of a delegated approver to a range of specific dates. Approval responsibilities are delegated to a backup approver.

Operations

Fetching a list of Backup Approver Associations

Request

The index endpoint only returns backup approver associations that are visible to the user. Backup approver associations are only visible to account members.

This endpoint returns structured Backup Approver Association objects. As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array and will be indexed by ID in the backup_approver_associations top-level JSON key. Please see our Response Format section for more information.

Query
includestring

Any of the below associations can be included in your request by providing the include param, e.g. include=association1,association2.

  • approver (User) - The user who would normally approve time.
  • backup_approver (User) - The user who will be approving time in place of the normal approver.
onlystring

Allows you to request one or more resources directly by ID. Multiple IDs can be supplied in a comma separated list, like GET /api/v1/workspaces.json?only=5,6,7.

pageinteger, (int32)
Default:1
per_pageinteger, (int32), <= 200
Default:20
GET
/backup_approver_associations
curl -i -X GET \
  'https://api.mavenlink.com/api/v1/backup_approver_associations?include=string&only=string&page=1&per_page=20'

Responses

A list of Backup Approver Associations have been retrieved.

Bodyapplication/json
countinteger, (int32)
metaobject
resultsArray of objects
backup_approver_associationsobject
usersobject
Response
{
  "count": 0,
  "meta": {
    "count": 0,
    "page_count": 0,
    "page_number": 0,
    "page_size": 0
  },
  "results": [
    {
      "key": "string",
      "id": "string"
    }
  ],
  "backup_approver_associations": {
    "property1": {
      "approver_id": "string",
      "backup_approver_id": "string",
      "end_date": "2019-08-24T14:15:22Z",
      "start_date": "2019-08-24T14:15:22Z"
    },
    "property2": {
      "approver_id": "string",
      "backup_approver_id": "string",
      "end_date": "2019-08-24T14:15:22Z",
      "start_date": "2019-08-24T14:15:22Z"
    }
  },
  "users": {
    "property1": {
      "abbreviated_timezone": "string",
      "account_membership_id": "string",
      "bio": "string",
      "city": "string",
      "classification": "string",
      "country": "string",
      "custom_field_value_ids": [
        "string"
      ],
      "email_address": "string",
      "external_reference_ids": [
        "string"
      ],
      "full_name": "string",
      "headline": "string",
      "last_site_activity": "2019-08-24T14:15:22Z",
      "manager_id": "string",
      "photo_path": "string",
      "role_id": "string",
      "skill_ids": [
        "string"
      ],
      "skill_membership_ids": [
        "string"
      ],
      "state": "string",
      "website": "string",
      "work_sample_ids": [
        "string"
      ]
    },
    "property2": {
      "abbreviated_timezone": "string",
      "account_membership_id": "string",
      "bio": "string",
      "city": "string",
      "classification": "string",
      "country": "string",
      "custom_field_value_ids": [
        "string"
      ],
      "email_address": "string",
      "external_reference_ids": [
        "string"
      ],
      "full_name": "string",
      "headline": "string",
      "last_site_activity": "2019-08-24T14:15:22Z",
      "manager_id": "string",
      "photo_path": "string",
      "role_id": "string",
      "skill_ids": [
        "string"
      ],
      "skill_membership_ids": [
        "string"
      ],
      "state": "string",
      "website": "string",
      "work_sample_ids": [
        "string"
      ]
    }
  }
}