openapi: 3.0.0
info:
description: Agent-first API for runtime + developer control-plane operations (users, teams, agents, routines, context, workflows, integrations, and webhooks).
title: ArchAstro Platform Activity Feed API
version: v1
tags:
- name: Activity Feed
paths:
/api/v1/activity_feed:
get:
description: 'Returns a cursor-paginated list of activity feed entries visible to the
authenticated user. Entries are ordered from newest to oldest by default.
Use `before_cursor` to page backward and `after_cursor` to page forward.
Results are scoped to the caller''s app. All filter params are optional and
can be combined. Passing multiple values in an array filter returns entries
matching any of the supplied values (OR semantics).
Invalid `kind` or `level` values return a 400 error listing the accepted
values rather than being silently ignored.'
operationId: get_api_v1_activity_feed
parameters:
- description: Maximum number of entries to return per page. Defaults to 50; maximum is 100.
example: 1
in: query
name: limit
required: false
schema:
type: integer
- description: 'One or more entry kinds to include. Accepted values: routine_run, automation_run, thread_story, agent_quality_verdict, generic. Omit to return all kinds.'
example:
- string
in: query
name: kind
required: false
schema:
items:
type: string
type: array
- description: 'One or more severity levels to include. Accepted values: debug, info, warn, error, audit. Omit to return all levels.'
example:
- string
in: query
name: level
required: false
schema:
items:
type: string
type: array
- description: Opaque cursor from a previous response's `after_cursor` field. Returns entries newer than the cursor's position.
example: string
in: query
name: after_cursor
required: false
schema:
type: string
- description: Opaque cursor from a previous response's `before_cursor` field. Returns entries older than the cursor's position.
example: string
in: query
name: before_cursor
required: false
schema:
type: string
- description: Restrict results to entries associated with these agent IDs (`agt_...`). Accepts multiple values.
example:
- string
in: query
name: agent
required: false
schema:
items:
type: string
type: array
- description: Restrict results to entries associated with these organization IDs (`org_...`). Accepts multiple values.
example:
- string
in: query
name: org
required: false
schema:
items:
type: string
type: array
- description: Restrict results to entries associated with these team IDs (`tem_...`). Accepts multiple values.
example:
- string
in: query
name: team
required: false
schema:
items:
type: string
type: array
- description: Restrict results to entries associated with these thread IDs (`thr_...`). Accepts multiple values.
example:
- string
in: query
name: thread
required: false
schema:
items:
type: string
type: array
- description: Restrict results to entries that share this correlation group identifier. Useful for tracing a chain of related events.
example: string
in: query
name: correlation_id
required: false
schema:
type: string
responses:
'200':
content:
application/json:
schema:
description: Cursor-paginated list of activity feed entries.
example:
after_cursor: string
before_cursor: string
data:
- agent: agi_0aBcDeFgHiJkLmNoPqRsTu
app: dap_0aBcDeFgHiJkLmNoPqRsTu
attachments:
- {}
automation_run: atr_0aBcDeFgHiJkLmNoPqRsTu
content: The agent completed the task successfully.
correlation_id: 01234567-89ab-cdef-0123-456789abcdef
created_at: '2024-01-01T00:00:00Z'
id: afe_0aBcDeFgHiJkLmNoPqRsTu
kind: agent_step
level: info
metadata:
key: value
org: org_0aBcDeFgHiJkLmNoPqRsTu
routine_run: arr_0aBcDeFgHiJkLmNoPqRsTu
sandbox: string
session_record: ase_0aBcDeFgHiJkLmNoPqRsTu
team: tem_0aBcDeFgHiJkLmNoPqRsTu
thread: thr_0aBcDeFgHiJkLmNoPqRsTu
title: Example Title
updated_at: '2024-01-01T00:00:00Z'
user: usr_0aBcDeFgHiJkLmNoPqRsTu
has_more: true
properties:
after_cursor:
description: Opaque cursor to pass as `after_cursor` to retrieve the next newer page. Absent when no newer entries exist.
example: string
type: string
before_cursor:
description: Opaque cursor to pass as `before_cursor` to retrieve the next older page. Absent when no older entries exist.
example: string
type: string
data:
description: Array of activity feed entry objects for the current page, ordered newest first.
example:
- agent: agi_0aBcDeFgHiJkLmNoPqRsTu
app: dap_0aBcDeFgHiJkLmNoPqRsTu
attachments:
- {}
automation_run: atr_0aBcDeFgHiJkLmNoPqRsTu
content: The agent completed the task successfully.
correlation_id: 01234567-89ab-cdef-0123-456789abcdef
created_at: '2024-01-01T00:00:00Z'
id: afe_0aBcDeFgHiJkLmNoPqRsTu
kind: agent_step
level: info
metadata:
key: value
org: org_0aBcDeFgHiJkLmNoPqRsTu
routine_run: arr_0aBcDeFgHiJkLmNoPqRsTu
sandbox: string
session_record: ase_0aBcDeFgHiJkLmNoPqRsTu
team: tem_0aBcDeFgHiJkLmNoPqRsTu
thread: thr_0aBcDeFgHiJkLmNoPqRsTu
title: Example Title
updated_at: '2024-01-01T00:00:00Z'
user: usr_0aBcDeFgHiJkLmNoPqRsTu
items:
description: A single event record in an activity feed, capturing what happened, who caused it, and which resources were involved.
example:
agent: agi_0aBcDeFgHiJkLmNoPqRsTu
app: dap_0aBcDeFgHiJkLmNoPqRsTu
attachments:
- {}
automation_run: atr_0aBcDeFgHiJkLmNoPqRsTu
content: The agent completed the task successfully.
correlation_id: 01234567-89ab-cdef-0123-456789abcdef
created_at: '2024-01-01T00:00:00Z'
id: afe_0aBcDeFgHiJkLmNoPqRsTu
kind: agent_step
level: info
metadata:
key: value
org: org_0aBcDeFgHiJkLmNoPqRsTu
routine_run: arr_0aBcDeFgHiJkLmNoPqRsTu
sandbox: string
session_record: ase_0aBcDeFgHiJkLmNoPqRsTu
team: tem_0aBcDeFgHiJkLmNoPqRsTu
thread: thr_0aBcDeFgHiJkLmNoPqRsTu
title: Example Title
updated_at: '2024-01-01T00:00:00Z'
user: usr_0aBcDeFgHiJkLmNoPqRsTu
properties:
agent:
description: The agent that produced this event. Returns an agent ID (`agi_...`) by default, or an expanded agent object when the association is loaded. `null` if no agent is associated.
example: agi_0aBcDeFgHiJkLmNoPqRsTu
oneOf:
- description: An AI agent that can be configured with tools, routines, and skills, and invoked to handle conversations or tasks.
example:
acl:
add:
- actions:
- read
- write
principal: string
principal_type: user
grants:
- actions:
- read
- write
principal: string
principal_type: user
remove:
- principal: string
principal_type: user
app: dap_0aBcDeFgHiJkLmNoPqRsTu
created_at: '2024-01-01T00:00:00Z'
default_model: claude-3-7-sonnet-latest
email: user@example.com
id: agi_0aBcDeFgHiJkLmNoPqRsTu
identity: You are a helpful assistant that answers questions about ArchAstro products.
last_applied_template_config: cfg_0aBcDeFgHiJkLmNoPqRsTu
lookup_key: string
metadata:
key: value
name: Example Name
org: org_0aBcDeFgHiJkLmNoPqRsTu
org_name: Example Name
originator: deploy-pipeline
phone_number: '+15555550123'
sandbox: dsb_0aBcDeFgHiJkLmNoPqRsTu
source_solution:
solution:
category_keys:
- string
created_at: '2024-01-01T00:00:00Z'
description: An example description.
id: id_0aBcDeFgHiJkLmNoPqRsTu
kind: Solution
latest_solution: id_0aBcDeFgHiJkLmNoPqRsTu
latest_version: 1.0.0
lookup_key: string
metadata:
key: value
name: Example Name
org: org_0aBcDeFgHiJkLmNoPqRsTu
org_logo:
file: fil_0aBcDeFgHiJkLmNoPqRsTu
height: 600
media: med_0aBcDeFgHiJkLmNoPqRsTu
mime_type: application/json
refresh_url: https://example.com
url: https://example.com
width: 800
org_name: Example Name
org_slug: example-slug
owners:
- string
readme_url: https://example.com
solution_id: 01234567-89ab-cdef-0123-456789abcdef
solution_version: 1.2.0
tag_keys:
- string
template_kind: AgentTemplate
templates:
- description: An example description.
display_name: Example Name
id: id_0aBcDeFgHiJkLmNoPqRsTu
kind: AgentTemplate
lookup_key: string
name: Example Name
readme_url: https://example.com
virtual_path: string
updated_at: '2024-01-01T00:00:00Z'
upgrade_available: true
virtual_path: string
template:
created_at: '2024-01-01T00:00:00Z'
description: An example description.
display_name: Example Name
id: id_0aBcDeFgHiJkLmNoPqRsTu
kind: agent_tool_template
lookup_key: string
name: Example Name
updated_at: '2024-01-01T00:00:00Z'
virtual_path: string
team: tem_0aBcDeFgHiJkLmNoPqRsTu
updated_at: '2024-01-01T00:00:00Z'
user: usr_0aBcDeFgHiJkLmNoPqRsTu
properties:
acl:
description: Access control list for the agent. Contains a `grants` array where each entry specifies `principal_type`, `principal`, and `actions`. `null` when no ACL restrictions are applied and the agent is accessible to all members of its scope.
example:
add:
- actions:
- read
- write
principal: string
principal_type: user
grants:
- actions:
- read
- write
principal: string
principal_type: user
remove:
- principal: string
principal_type: user
properties:
add:
description: 'Patch mode: grants to add or merge into the existing list. Cannot be combined with `grants`.'
example:
- actions:
- read
- write
principal: string
principal_type: user
items:
description: A single access-control grant that pairs a principal with the set of actions it is allowed to perform.
example:
actions:
- read
- write
principal: string
principal_type: user
properties:
actions:
description: Array of action strings the principal is permitted to perform, e.g. `["read", "write"]`. Must contain at least one entry.
example:
- read
- write
items:
type: string
type: array
principal:
description: The identifier of the principal. A string ID for `"user"`, `"team"`, `"org"`, and `"agent"` types; one of `"admin"`, `"member"`, or `"viewer"` for `"org_role"`; omit entirely when `principal_type` is `"everyone"`.
example: string
type: string
principal_type:
description: The kind of principal receiving the grant. One of `"user"`, `"team"`, `"org"`, `"org_role"`, `"agent"`, or `"everyone"`.
example: user
type: string
required:
- actions
- principal_type
type: object
type: array
grants:
description: 'Replace mode: the complete new list of grants that replaces all existing entries. Send an empty array (`[]`) to clear all grants. Cannot be combined with `add` or `remove`.'
example:
- actions:
- read
- write
principal: string
principal_type: user
items:
description: A single access-control grant that pairs a principal with the set of actions it is allowed to perform.
example:
actions:
- read
- write
principal: string
principal_type: user
properties:
actions:
description: Array of action strings the principal is permitted to perform, e.g. `["read", "write"]`. Must contain at least one entry.
example:
- read
- write
items:
type: string
type: array
principal:
description: The identifier of the principal. A string ID for `"user"`, `"team"`, `"org"`, and `"agent"` types; one of `"admin"`, `"member"`, or `"viewer"` for `"org_role"`; omit entirely when `principal_type` is `"everyone"`.
example: string
type: string
principal_type:
description: The kind of principal receiving the grant. One of `"user"`, `"team"`, `"org"`, `"org_role"`, `"agent"`, or `"everyone"`.
example: user
type: string
required:
- actions
- principal_type
type: object
type: array
remove:
description: 'Patch mode: principals whose grants should be removed from the existing list. Cannot be combined with `grants`.'
example:
- principal: string
principal_type: user
items:
description: Identifies a principal to be removed from an access-control list.
example:
principal: string
principal_type: user
properties:
principal:
description: The identifier of the principal to remove. A string ID for `"user"`, `"team"`, `"org"`, and `"agent"` types; one of `"admin"`, `"member"`, or `"viewer"` for `"org_role"`. Omit when `principal_type` is `"everyone"`.
example: string
type: string
principal_type:
description: The kind of principal to remove. One of `"user"`, `"team"`, `"org"`, `"org_role"`, `"agent"`, or `"everyone"`.
example: user
type: string
required:
- principal_type
type: object
type: array
type: object
app:
description: ID of the application that owns this agent (`dap_...`).
example: dap_0aBcDeFgHiJkLmNoPqRsTu
type: string
created_at:
description: When the agent was created (ISO 8601).
example: '2024-01-01T00:00:00Z'
format: date-time
type: string
default_model:
description: Default LLM model identifier used by this agent when no model is specified at runtime (e.g. `"claude-3-7-sonnet-latest"`).
example: claude-3-7-sonnet-latest
type: string
email:
description: Email address provisioned for this agent. `null` if email delivery is not configured.
example: user@example.com
type: string
id:
description: Agent ID (`agi_...`).
example: agi_0aBcDeFgHiJkLmNoPqRsTu
type: string
identity:
description: System-level identity prompt that shapes the agent's persona and behavior.
example: You are a helpful assistant that answers questions about ArchAstro products.
type: string
last_applied_template_config:
description: ID of the AgentTemplate config (`cfg_...`) this agent was last provisioned or updated from. `null` for manually created agents.
example: cfg_0aBcDeFgHiJkLmNoPqRsTu
type: string
lookup_key:
description: Stable, user-defined identifier for this agent within the application. Unique per app.
example: string
type: string
metadata:
description: Arbitrary key-value metadata attached to the agent. Not interpreted by the platform.
example:
key: value
type: object
name:
description: Human-readable display name for the agent. `null` if not set.
example: Example Name
type: string
org:
description: ID of the organization this agent belongs to (`org_...`). `null` if the agent is not org-scoped.
example: org_0aBcDeFgHiJkLmNoPqRsTu
type: string
org_name:
description: Display name of the organization this agent belongs to. `null` when the agent is not org-scoped or when the org association was not preloaded.
example: Example Name
type: string
originator:
description: Free-form label identifying the source or author that created this agent (e.g. a username or pipeline name).
example: deploy-pipeline
type: string
phone_number:
description: Phone number provisioned for this agent. `null` if SMS is not configured.
example: '+15555550123'
type: string
sandbox:
description: ID of the sandbox environment this agent is scoped to (`dsb_...`). `null` in production deployments.
example: dsb_0aBcDeFgHiJkLmNoPqRsTu
type: string
source_solution:
description: Source Solution and AgentTemplate summary for agents provisioned from a Solution. Includes `upgrade_available`, `latest_version`, and `latest_solution` so you can render an upgrade badge without a separate dry-run call. `null` for hand-built agents and agents whose tracked template or parent Solution has been deleted. Populated only on single-agent GET responses, never on list endpoints.
example:
solution:
category_keys:
- string
created_at: '2024-01-01T00:00:00Z'
description: An example description.
id: id_0aBcDeFgHiJkLmNoPqRsTu
kind: Solution
latest_solution: id_0aBcDeFgHiJkLmNoPqRsTu
latest_version: 1.0.0
lookup_key: string
metadata:
key: value
name: Example Name
org: org_0aBcDeFgHiJkLmNoPqRsTu
org_logo:
file: fil_0aBcDeFgHiJkLmNoPqRsTu
height: 600
media: med_0aBcDeFgHiJkLmNoPqRsTu
mime_type: application/json
refresh_url: https://example.com
url: https://example.com
width: 800
org_name: Example Name
org_slug: example-slug
owners:
- string
readme_url: https://example.com
solution_id: 01234567-89ab-cdef-0123-456789abcdef
solution_version: 1.2.0
tag_keys:
- string
template_kind: AgentTemplate
templates:
- description: An example description.
display_name: Example Name
id: id_0aBcDeFgHiJkLmNoPqRsTu
kind: AgentTemplate
lookup_key: string
name: Example Name
readme_url: https://example.com
virtual_path: string
updated_at: '2024-01-01T00:00:00Z'
upgrade_available: true
virtual_path: string
template:
created_at: '2024-01-01T00:00:00Z'
description: An example description.
display_name: Example Name
id: id_0aBcDeFgHiJkLmNoPqRsTu
kind: agent_tool_template
lookup_key: string
name: Example Name
updated_at: '2024-01-01T00:00:00Z'
virtual_path: string
properties:
solution:
description: Summary of the parent Solution, including `upgrade_available`, `latest_version`, and `latest_solution` when a newer system-scoped version is available for the agent's org-scoped Solution.
example:
category_keys:
- string
created_at: '2024-01-01T00:00:00Z'
description: An example description.
id: id_0aBcDeFgHiJkLmNoPqRsTu
kind: Solution
latest_solution: id_0aBcDeFgHiJkLmNoPqRsTu
latest_version: 1.0.0
lookup_key: string
metadata:
key: value
name: Example Name
org: org_0aBcDeFgHiJkLmNoPqRsTu
org_logo:
file: fil_0aBcDeFgHiJkLmNoPqRsTu
height: 600
media: med_0aBcDeFgHiJkLmNoPqRsTu
mime_type: application/json
refresh_url: https://example.com
url: https://example.com
width: 800
org_name: Example Name
org_slug: example-slug
owners:
- string
readme_url: https://example.com
solution_id: 01234567-89ab-cdef-0123-456789abcdef
solution_version: 1.2.0
tag_keys:
- string
template_kind: AgentTemplate
templates:
- description: An exampl
# --- truncated at 32 KB (1048 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/archastro/refs/heads/main/openapi/archastro-activity-feed-api-openapi.yml