List activities
GET /activities. Parameters, permissions, request and response schemas.
GET /activities
List activities. Requires the REST read token ability. The bearer token selects the Team; a supplied team_id cannot switch tenants. Additional role, entity-policy and plan requirements vary by operation.
Authentication
Use a team API key as Authorization: Bearer YOUR_API_KEY. The token ability and the user’s role must both allow this operation. See authentication.
{
"ability": "read",
"team": "Token-bound Team",
"authorization": "Additional role, entity-policy and plan requirements vary by operation."
}Parameters
| Name | Location | Required | Description |
|---|---|---|---|
subject_type | query | Yes | Subject Type. |
subject_id | query | Yes | Subject Id. |
period | query | No | Period. |
per_page | query | No | Per Page. |
sort | query | No | Sort. |
subject_type
{
"type": "string",
"enum": [
"goal",
"tag",
"experiment",
"idea",
"insight",
"learning",
"observation",
"page",
"audience",
"project",
"team",
"user",
"variation",
"activity",
"comment",
"form",
"form_question",
"form_response",
"form_answer",
"form_step",
"form_response_summary",
"project_lookup"
]
}subject_id
{
"type": "integer",
"minimum": 1
}period
{
"type": "string",
"maxLength": 50
}per_page
{
"type": "integer",
"minimum": 1,
"maximum": 100
}sort
{
"type": [
"string",
"null"
],
"enum": [
"id",
"-id",
"created_at",
"-created_at",
null
]
}Example request
curl --request GET 'https://api.example.test/api/activities?subject_type=goal&subject_id=101' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Accept: application/json'Examples use fictional data. Replace resource IDs and the API host with your environment’s values.
Responses
200
Paginated set of ActivityResource
Content type: application/json.
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"log_name": {
"type": [
"string",
"null"
]
},
"description": {
"type": "string"
},
"subject_type": {
"type": [
"string",
"null"
]
},
"subject_id": {
"type": [
"integer",
"null"
]
},
"event": {
"type": [
"string",
"null"
]
},
"causer_type": {
"type": [
"string",
"null"
]
},
"causer_id": {
"type": [
"integer",
"null"
]
},
"properties": {
"description": "JSON object or array. Object keys depend on the provider, form question, or configuration being stored.",
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "array",
"items": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "null"
}
]
},
"batch_uuid": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"subject": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"log_name": {
"type": [
"string",
"null"
]
},
"description": {
"type": "string"
},
"subject_type": {
"type": [
"string",
"null"
]
},
"event": {
"type": [
"string",
"null"
]
},
"subject_id": {
"type": [
"integer",
"null"
]
},
"causer_type": {
"type": [
"string",
"null"
]
},
"causer_id": {
"type": [
"integer",
"null"
]
},
"properties": {
"description": "JSON object or array. Object keys depend on the provider, form question, or configuration being stored.",
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "array",
"items": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "null"
}
]
},
"batch_uuid": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"id",
"log_name",
"description",
"subject_type",
"event",
"subject_id",
"causer_type",
"causer_id",
"properties",
"batch_uuid",
"created_at",
"updated_at"
],
"title": "Activity",
"description": "Relationships"
},
{
"type": "null"
}
]
},
"causer": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"log_name": {
"type": [
"string",
"null"
]
},
"description": {
"type": "string"
},
"subject_type": {
"type": [
"string",
"null"
]
},
"event": {
"type": [
"string",
"null"
]
},
"subject_id": {
"type": [
"integer",
"null"
]
},
"causer_type": {
"type": [
"string",
"null"
]
},
"causer_id": {
"type": [
"integer",
"null"
]
},
"properties": {
"description": "JSON object or array. Object keys depend on the provider, form question, or configuration being stored.",
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "array",
"items": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "null"
}
]
},
"batch_uuid": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"id",
"log_name",
"description",
"subject_type",
"event",
"subject_id",
"causer_type",
"causer_id",
"properties",
"batch_uuid",
"created_at",
"updated_at"
],
"title": "Activity"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"log_name",
"description",
"subject_type",
"subject_id",
"event",
"causer_type",
"causer_id",
"properties",
"batch_uuid",
"created_at",
"updated_at"
],
"title": "ActivityResource"
}
},
"links": {
"type": "object",
"properties": {
"first": {
"type": [
"string",
"null"
]
},
"last": {
"type": [
"string",
"null"
]
},
"prev": {
"type": [
"string",
"null"
]
},
"next": {
"type": [
"string",
"null"
]
}
},
"required": [
"first",
"last",
"prev",
"next"
]
},
"meta": {
"type": "object",
"properties": {
"current_page": {
"type": "integer",
"minimum": 1
},
"from": {
"type": [
"integer",
"null"
],
"minimum": 1
},
"last_page": {
"type": "integer",
"minimum": 1
},
"links": {
"type": "array",
"description": "Generated paginator links.",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"label": {
"type": "string"
},
"active": {
"type": "boolean"
}
},
"required": [
"url",
"label",
"active"
]
}
},
"path": {
"type": [
"string",
"null"
],
"description": "Base path for paginator generated URLs."
},
"per_page": {
"type": "integer",
"description": "Number of items shown per page.",
"minimum": 0
},
"to": {
"type": [
"integer",
"null"
],
"description": "Number of the last item in the slice.",
"minimum": 1
},
"total": {
"type": "integer",
"description": "Total number of items being paginated.",
"minimum": 0
}
},
"required": [
"current_page",
"from",
"last_page",
"links",
"path",
"per_page",
"to",
"total"
]
}
},
"required": [
"data",
"links",
"meta"
]
}{
"data": [
{
"id": 101,
"log_name": null,
"description": "Show the expected delivery date before payment.",
"subject_type": null,
"subject_id": null,
"event": null,
"causer_type": null,
"causer_id": null,
"properties": null,
"batch_uuid": null,
"created_at": null,
"updated_at": null
}
],
"links": {
"first": null,
"last": null,
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": null,
"last_page": 1,
"links": [
{
"url": null,
"label": "example",
"active": true
}
],
"path": null,
"per_page": 1,
"to": null,
"total": 1
}
}401
Unauthenticated
Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Error overview."
}
},
"required": [
"message"
]
}{
"message": "The request could not be completed."
}403
Authorization error
Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Error overview."
}
},
"required": [
"message"
]
}{
"message": "The request could not be completed."
}404
Not found
Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Error overview."
}
},
"required": [
"message"
]
}{
"message": "The request could not be completed."
}422
Validation error
Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Errors overview."
},
"errors": {
"type": "object",
"description": "A detailed description of each field that failed validation.",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"required": [
"message",
"errors"
]
}{
"message": "The request could not be completed.",
"errors": {
"name": [
"The name field is required."
]
}
}429
Rate limit exceeded. Honor Retry-After before retrying.
Response headers:
{
"Retry-After": {
"description": "Seconds before retrying.",
"schema": {
"type": "integer"
}
}
}Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "Too Many Attempts."
}
},
"required": [
"message"
]
}{
"message": "Too Many Attempts."
}See API conventions for error handling, rate limits, pagination, and uploads.