List audit entries with filters, newest first

GET

/api/v1/workspaces/{workspace}/audit

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://reputecast.example.com/api/v1/workspaces/acme-newsletter/audit?actorType=user&category=sending&result=allowed&range=24h&limit=50"

  req, _ := http.NewRequest("GET", url, nil)

  req.Header.Add("Authorization", "Bearer <token>")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

const url = 'https://reputecast.example.com/api/v1/workspaces/acme-newsletter/audit?actorType=user&category=sending&result=allowed&range=24h&limit=50';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://reputecast.example.com/api/v1/workspaces/acme-newsletter/audit?actorType=user&category=sending&result=allowed&range=24h&limit=50' \
  --header 'Authorization: Bearer <token>'

Permission: audit:view

Authorizations

bearer

Parameters

Path Parameters

workspace

required

Workspace slug

string

/^[a-z0-9][a-z0-9-]{1,62}$/

Workspace slug

Query Parameters

Target name, target id, request id or actor name

string

<= 200 characters

Target name, target id, request id or actor name

actorType

string

Allowed values: user api_key mcp_agent system

actor

Actor id

string

Actor id

action

Action group (routing) or action (routing.updated)

string

<= 80 characters

Action group (routing) or action (routing.updated)

category

A group of actions, as in the action filter

string

Allowed values: sending routing audience team settings integrations transactional scoring digests polls ai earn verification placement website grow products commerce sms push whatsapp agency

A group of actions, as in the action filter

result

string

Allowed values: allowed denied error

range

string

default: 7d

Allowed values: 24h 7d 30d 90d all

since

Overrides range

string format: date-time

Overrides range

until

string format: date-time

cursor

string

<= 200 characters

limit

integer format: int64

default: 50 >= 1 <= 200

Responses

200

application/json

object

actionGroups

required

Array<string>

actors

required

Array<object>

object

required

string

name

required

string

type

required

string

categories

required

Array<object>

object

groups

required

Array<string>

key

required

string

label

required

string

items

required

Array<object>

object

action

required

string

actor

required

object

avatarColor

string

label

required

string

name

required

string

role

string

type

required

string

Allowed values: user api_key mcp_agent system

changes

required

boolean

required

string

occurredAt

required

string format: date-time

reason

string

requestId

string

result

required

string

Allowed values: allowed denied error

source

required

object

channel

required

string

detail

string

summary

required

string

target

required

string

targetId

required

string

targetName

required

string

targetType

required

string

nextCursor

string

retentionDays

required

integer format: int32

stream

required

object

delivered

required

integer format: int64

enabled

required

boolean

failingSince

string format: date-time

hasSecret

required

boolean

host

string

lastError

string

lastOkAt

string format: date-time

url

string

total

required

integer format: int64

Example

{
  "items": [
    {
      "actor": {
        "type": "user"
      },
      "result": "allowed"
    }
  ]
}

default

Error

application/problem+json

object

code

Stable error code, e.g. permission_denied

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object>

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

helpers

Members who hold the missing permission

Array<string>

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

meta

object

key

additional properties

permission

The missing permission key

string

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}