List a team's activity - Spacefast Docs

List a team's activity

Returns the activity events recorded against one team, its Spaces included, newest first. Page with cursor. since is raised to the team’s plan audit retention window when it reaches back further. The caller needs teams:read on the team.

GET /v1/teams/{teamId}/activity

Authorization

Authorization Bearer token · header required

Authorization: Bearer <token> with an API key (sfa_ prefix), an OAuth access token, a session token, or a Space machine credential (sfm_ prefix).

or

Authorization OAuth2 access token · header required

OAuth 2.0 with Spacefast scopes. People use the authorization code flow; machines use client credentials.

Scopes:

teams:read

Path parameters

teamId string required
min length 1

Query parameters

limit integer required
min 1 · max 100 · default: 20

cursor string
min length 1 · max length 4096

spaceId string
min length 1

actorType string
Allowed: user, api_key, partner_token, oauth_client, anonymous_claim, system

actorId string
min length 1

code string
min length 1

since string
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:.\d+)?)?(?:Z))$

until string
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:.\d+)?)?(?:Z))$

Responses

200 Response for status 200

$schema string
Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

data object[] required

Array of object

Any of:

actor object required

min length 1

code string required
Event code from the platform taxonomy, such as space.created.

message string required
One sentence naming what happened, safe to show to a person.

details object | any required
Fields specific to this event code. Null when the code carries none. Never a secret or a variable value.

Any of:

createdAt string required
ISO 8601 timestamp when the event was recorded.

matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:.\d+)?)?(?:Z))$

pagination object required

Any of:

default Error

Every 4xx and 5xx response is one RFC 9457 problem document served as application/problem+json.

$schema string
Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

type string required
URL of the documentation page for this error. Derived from code.

title string required
Human-readable name of the error type. Derived from code.

status integer required
HTTP status of the response, repeated in the body.

min -9007199254740991 · max 9007199254740991

detail string required
What went wrong in this request.

code string required
Stable snake_case error code. Match on this, not on detail.

pointer string
RFC 6901 JSON Pointer to the request field or batch entry that failed, for example /files/37/path. Present on validation failures.

details object
Machine-readable context keyed by the error code.

suggestions string[]

Recovery steps safe to show to a person.

next string[]
Commands or API requests to run next, usable as written.

requestId string required
ID of this request, from the X-Request-Id header or generated. Quote it when contacting support.

Try it

Server

Base URL https://api.spacefast.com
Custom base URL Overrides the selected server when set.