Events API
Retrieve and filter audit events for your graphiteConnect organization using the Events API.
Events API
The graphiteConnect Events API provides an audit trail of actions that have occurred within your organization. You can use this API to monitor user activity, investigate changes, and support compliance workflows.
Event Types
To see all possible event types in your graphiteConnect environment, call the event types endpoint:
GET /api/public/api/v1/users/events/typesAuthentication: Bearer JWT (OAuth 2.0)
This endpoint returns JSON data listing all available event type identifiers. Use these identifiers as values for the eventType filter parameter when querying events.
Example Request
curl --location 'https://poc.projectgraphite.com/api/public/api/v1/users/events/types' \
--header 'Authorization: Bearer <your_access_token>'Events API
GET /api/public/api/v1/users/eventsReturns events for your organization. Results are returned in JSON format.
Authentication: Bearer JWT (OAuth 2.0)
Query Parameters
| Parameter | Description |
|---|---|
eventType | Filter to a specific event type. Use values from GET /users/events/types. |
after | Only include events that occurred after this date (ISO 8601 format, e.g., 2024-01-01T00:00:00Z) |
before | Only include events that occurred before this date (ISO 8601 format) |
forUserId | Only include events involving a specific user. Use the _id field from the Users API to find user IDs. |
limit | Maximum number of results per page (max 1000) — see Pagination |
page | Page number (0-indexed) — see Pagination |
Example Request
Fetch all events of a specific type in a date range:
curl --location 'https://poc.projectgraphite.com/api/public/api/v1/users/events?eventType=profile_updated&after=2024-01-01T00:00:00Z&before=2024-02-01T00:00:00Z&limit=100&page=0' \
--header 'Authorization: Bearer <your_access_token>'Fetch all events for a specific user:
curl --location 'https://poc.projectgraphite.com/api/public/api/v1/users/events?forUserId=5d8aec25c25758d37debdc7a' \
--header 'Authorization: Bearer <your_access_token>'Pagination
Events APIs support pagination for organizations with high activity volumes. Use limit and page parameters, and check the total field in the response body to determine the full result count.
See Pagination for full details.
Related Documentation
- User Data — Find user IDs for the
forUserIdfilter - Pagination — Pagination query parameters
- Tasks API — Open tasks for supplier connections
Updated about 7 hours ago