Task activity
Read-only. Auto-logged change history. Written by the application, never by a caller.
The object#
| Field | Type | Description |
|---|---|---|
| idread-only | integer | NolaPro id. |
| teamprojecttaskid | integer | Teamprojecttaskid. Id only - teamprojecttask is read-only or has no code key. |
| teamprojectid | integer | Reference to teamprojects, by id. Write either this or teamproject. |
| teamproject | string(30) | Code for the referenced teamproject, instead of the id. |
| genuserid | integer | Genuserid. Id only - genuser is read-only or has no code key. |
| action | string(50) | The code this resource is keyed by. Matching is case insensitive. |
| source | string(20) | Where the change came from (screen or process that made it). |
| fieldname | string(50) | Field that changed. |
| oldvalue | string(255) | Value before the change. |
| newvalue | string(255) | Value after the change. |
| detail | text | Detail. Stored as text, no practical length limit. |
| entrydate | string | When the record was created. |
| cancel | boolean | Cancelled. NolaPro cancels rather than deletes, so a cancelled row is still readable. |
Endpoints#
GET/teamprojectactivity
200403
List task activity.
Requires scope projects:read.
Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| genuserid | query | string | Restrict to one genuserid. |
| cancel | query | string | Defaults to false. Pass true or any. |
| teamprojectid | query | string | Filter to one . |
| teamprojecttaskid | query | string | Filter to one task. |
| include | query | string | Comma-separated extras to embed. Only custom_fields is available: the extra fields this install has defined on the record. Off by default, and an unrecognised value is refused rather than ignored. See Conventions. |
When it fails
| Status | Code | Meaning |
|---|---|---|
| 403 | insufficient_scope | Token lacks read scope. |
curl \ 'https://acme.nolapro.com/!/api/v2/teamprojectactivity' \ -H 'Authorization: Bearer $NP_TOKEN'
$ch = curl_init('https://acme.nolapro.com/!/api/v2/teamprojectactivity'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('NP_TOKEN')], CURLOPT_RETURNTRANSFER => true, ]); $res = json_decode(curl_exec($ch), true);
import os, requests r = requests.get( "https://acme.nolapro.com/!/api/v2/teamprojectactivity", headers={"Authorization": f"Bearer {os.environ['NP_TOKEN']}"}, ) r.raise_for_status()
const res = await fetch( 'https://acme.nolapro.com/!/api/v2/teamprojectactivity', { method: 'GET', headers: { Authorization: `Bearer ${process.env.NP_TOKEN}` }, } ); const data = await res.json();
using System.Net.Http.Json; var token = Environment.GetEnvironmentVariable("NP_TOKEN"); using var http = new HttpClient(); http.DefaultRequestHeaders.Add("Authorization", "Bearer " + token); var res = await http.GetAsync( "https://acme.nolapro.com/!/api/v2/teamprojectactivity"); res.EnsureSuccessStatusCode();
GET/teamprojectactivity/{id}
200404
Retrieve one record.
Requires scope projects:read.
Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| idrequired | path | integer | The record id. |
| include | query | string | Comma-separated extras to embed. Only custom_fields is available: the extra fields this install has defined on the record. Off by default, and an unrecognised value is refused rather than ignored. See Conventions. |
When it fails
| Status | Code | Meaning |
|---|---|---|
| 404 | not_found | No record with that id. |
curl \ 'https://acme.nolapro.com/!/api/v2/teamprojectactivity/104' \ -H 'Authorization: Bearer $NP_TOKEN'
$ch = curl_init('https://acme.nolapro.com/!/api/v2/teamprojectactivity/104'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('NP_TOKEN')], CURLOPT_RETURNTRANSFER => true, ]); $res = json_decode(curl_exec($ch), true);
import os, requests r = requests.get( "https://acme.nolapro.com/!/api/v2/teamprojectactivity/104", headers={"Authorization": f"Bearer {os.environ['NP_TOKEN']}"}, ) r.raise_for_status()
const res = await fetch( 'https://acme.nolapro.com/!/api/v2/teamprojectactivity/104', { method: 'GET', headers: { Authorization: `Bearer ${process.env.NP_TOKEN}` }, } ); const data = await res.json();
using System.Net.Http.Json; var token = Environment.GetEnvironmentVariable("NP_TOKEN"); using var http = new HttpClient(); http.DefaultRequestHeaders.Add("Authorization", "Bearer " + token); var res = await http.GetAsync( "https://acme.nolapro.com/!/api/v2/teamprojectactivity/104"); res.EnsureSuccessStatusCode();
Response 200
{
"teamprojecttaskid": 104,
"teamprojectid": 104,
"teamproject": "Example teamproject",
"action": "Example action",
"source": "Example source",
"fieldname": "Example fieldname"
}