Skip to main content
PUT
/
v1
/
report
/
{id}
Update report
curl --request PUT \
  --url https://staging.api.us.aptlydone.com/report/v1/report/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reportName": "Updated Status Report",
  "reportType": "DECISIONS",
  "description": "Updated report description",
  "status": "PUBLISHED",
  "ownerId": "1bca8c92-c2a3-4291-987e-9ff3e075a685",
  "tenantId": "b6ac0ce7-9377-4706-8f78-d14cef629487",
  "link": "/reports/view/base64",
  "reportColumns": [
    {
      "columnName": "sourceType",
      "order": 1
    }
  ],
  "reportFilters": [
    {
      "filterKey": "sectionId",
      "filterValue": "{\"ids\": [\"12345\"]}"
    }
  ]
}
'
{
  "statusCode": 200,
  "timestamp": "2026-01-08T06:33:03.221Z",
  "message": "Success",
  "data": {
    "id": "f53b4ff5-0351-4241-9ba0-ae5420f85ad6",
    "reportId": "10001",
    "reportName": "Feest, Hermiston and Konopelski Status Report",
    "reportType": "DECISIONS",
    "tenantId": "690a229f-9560-4962-81d0-d9cd7df8fa21",
    "ownerId": "d1ded054-fbad-46b4-9099-23f96194d507",
    "createdAt": "2026-01-07T20:36:33.769Z",
    "updatedAt": "2026-01-08T01:44:45.168Z",
    "status": "PUBLISHED",
    "reportColumns": [
      {
        "columnName": "sourceType",
        "order": 1
      }
    ],
    "reportFilters": [
      {
        "filterKey": "sectionId",
        "filterValue": "{\"ids\": [\"12345\"]}"
      }
    ],
    "description": "Charisma alii denego trans vacuus dolorum iusto arbitro utor.",
    "link": "/reports/view/base64",
    "ownerDetails": {
      "positions": [
        {
          "id": "3ee531e0-be0f-4219-9661-c46daced9885",
          "positionName": "System Administrator",
          "tenantId": "687f6049-1513-49c5-ad28-701bba50d5ab",
          "isScimProvisioned": false
        }
      ],
      "id": "18461bfe-7f70-4cb4-b215-f401510ba4c2",
      "name": "Alejandro Larkin I",
      "displayName": "Mrs. Wilma Abernathy III",
      "profileImageUrl": "https://avatars.githubusercontent.com/u/63050314",
      "positionIds": [
        "b5cae4e5-a002-454e-aa21-02e613cd6566"
      ],
      "email": "[email protected]",
      "mobilePhone": "836.502.4243 x34159",
      "primaryOrganizationId": "d248c1d1-bfb9-4e8e-a4cf-59e1c2b1d788",
      "manager": {
        "id": "c109a3ab-be10-44bd-b071-baf8a3165e05",
        "name": "Ms. Claudia Runolfsson",
        "displayName": "Dean Streich IV",
        "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/14.jpg"
      },
      "roles": [
        {
          "tenantRoleId": "440dc298-ae80-4164-952c-996181c2ce17",
          "roleName": "Administrator"
        }
      ],
      "groups": [
        {
          "groupId": "b243aa1f-7969-4256-8613-e28144ece727",
          "groupTypeId": "e033d810-a8d4-4c0c-8373-a43e0e620057"
        }
      ],
      "primaryOrganization": {
        "id": "cf437311-15fe-49a6-88cc-f71a697a52f4",
        "groupName": "Engineering Department",
        "tenantGroupTypeId": "36609c08-5917-4e39-8b17-8b7ad6e0e06e",
        "tenantGroupTypeName": "Organization",
        "displayName": "Engineering Department",
        "legalName": "Engineering Department Inc.",
        "baseCurrency": "USD",
        "decisionsCount": 42,
        "delegationsCount": 10
      }
    },
    "currentTab": "Sharing",
    "createdBy": "15ba396c-17cf-4962-8bd9-bc5b4515a6b8",
    "updatedBy": "36d22df2-1936-4e96-953f-bbfd4d7f0572",
    "permissions": [
      {
        "relationship_key": "<string>",
        "allowed": true
      }
    ]
  }
}

Authorizations

ā€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

ā€‹
id
string
required

Body

application/json
ā€‹
reportName
string

Report name

Example:

"Updated Status Report"

ā€‹
reportType
enum<string>

Report type

Available options:
DECISIONS,
DELEGATIONS,
ACTIONS,
DOCUMENTS,
USERS,
POSITIONS,
GROUPS,
MATRICES
Example:

"DECISIONS"

ā€‹
description
string

Report description

Example:

"Updated report description"

ā€‹
status
enum<string>

Report status

Available options:
PUBLISHED,
ARCHIVED,
DELETED,
DRAFT
Example:

"PUBLISHED"

ā€‹
ownerId
string<uuid>

Owner ID

Example:

"1bca8c92-c2a3-4291-987e-9ff3e075a685"

ā€‹
tenantId
string<uuid>

Tenant ID

Example:

"b6ac0ce7-9377-4706-8f78-d14cef629487"

ā€‹
link
string

Link to the report

Example:

"/reports/view/base64"

ā€‹
reportColumns
object[]

Report columns (existing will be updated, new will be added, missing will be removed)

ā€‹
reportFilters
object[]

Report filters (existing will be updated, new will be added, missing will be removed)

Response

200 - application/json

Report updated successfully

ā€‹
statusCode
number
required

HTTP Status code

Example:

200

ā€‹
timestamp
string
required

Timestamp of the response

Example:

"2026-01-08T06:33:03.221Z"

ā€‹
message
string
required

Response message

Example:

"Success"

ā€‹
data
object
required

Response data