Skip to main content
PUT
/
v1
/
report
/
{id}
Update report
curl --request PUT \
  --url https://staging.api.us.aptlydone.com/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": "eead8242-f03e-4f1f-8556-1d329635b5ed",
  "tenantId": "3209867d-a9a6-4299-872c-468405794a4d",
  "link": "/reports/view/base64",
  "reportColumns": [
    {
      "columnName": "sourceType",
      "order": 1
    }
  ],
  "reportFilters": [
    {
      "filterKey": "sectionId",
      "filterValue": "{\"ids\": [\"12345\"]}"
    }
  ]
}'
{
  "statusCode": 200,
  "timestamp": "2025-06-24T08:51:31.061Z",
  "message": "Success",
  "data": {
    "id": "36465d55-4c47-4a35-bbf0-6357b07d1114",
    "reportId": "10001",
    "reportName": "Boehm LLC Status Report",
    "description": "Accusamus in aggero adnuo subseco stips stips.",
    "link": "/reports/view/base64",
    "reportType": "DECISIONS",
    "tenantId": "c606f480-aa81-4a05-af46-6b98edd4e18d",
    "ownerId": "369963fb-6258-4f31-af09-48a8982309f7",
    "ownerDetails": {
      "id": "c4d84ffa-cf92-4569-9fe6-e18cd9762790",
      "email": "[email protected]",
      "name": "Clay Kshlerin",
      "firstName": "Emmitt",
      "lastName": "Johnston",
      "mobilePhone": "500-353-7995",
      "isActive": true,
      "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/17.jpg",
      "positions": [
        {
          "id": "4b321b71-9bf0-42fe-af47-b4f66497769a",
          "positionName": "System Administrator",
          "autoProvisioned": true
        }
      ]
    },
    "currentTab": "Sharing",
    "createdBy": "2d981610-22bc-436e-9b57-a1af02662ca7",
    "updatedBy": "adea9375-26fc-4587-b1f9-e5fec7c2f9ec",
    "createdAt": "2025-06-23T09:10:07.573Z",
    "updatedAt": "2025-06-24T07:32:42.149Z",
    "status": "PUBLISHED",
    "reportColumns": [
      {
        "columnName": "sourceType",
        "order": 1
      }
    ],
    "reportFilters": [
      {
        "filterKey": "sectionId",
        "filterValue": "{\"ids\": [\"12345\"]}"
      }
    ],
    "permissions": [
      {
        "allowed": true,
        "relationship_key": "<string>"
      }
    ]
  }
}

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:

"eead8242-f03e-4f1f-8556-1d329635b5ed"

​
tenantId
string<uuid>

Tenant ID

Example:

"3209867d-a9a6-4299-872c-468405794a4d"

​
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:

"2025-06-24T08:51:31.061Z"

​
message
string
required

Response message

Example:

"Success"

​
data
object
required

Response data