---
title: "Company Activity"
method: POST
path: "/margot/actions/company_activity"
tags: ["margot"]
---

# Company Activity

`POST /margot/actions/company_activity`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/margot/actions/company_activity`
- Auth: HTTP bearer

Task rollup + recent agent runs for one of the caller's companies.

## Request body

- MargotActionRequest: Common request body for every Margot action. Identity comes from the request: on a customer ticket Parahelp's tool fills it from the ticket's requester (never from the message text), on a team call the teammate names the founder. The backend resolves `external_id` (our `user.id`) or a unique `email` to the account server-side; it never trusts a company/conglomerate id from the body.
  - `external_id` string, nullable: The founder's NanoCorp user id (external_id on the helpdesk contact).
  - `email` string, nullable: The founder's email. Used as a fallback identity and a cross-check.
  - `company` string, nullable: Optional company name/handle hint, resolved against the caller's own companies.
  - `limit` integer, nullable: Optional row limit for list actions.

## Response `200`

Successful Response

- CompanyActivityResponse
  - `found` boolean
  - `company` CompanySummary: Customer-safe view of one of the caller's companies.
    - `name` string, required
    - `handle` string, required
    - `status` string, required
    - `custom_domain` string, nullable
    - `custom_domain_verified` boolean
  - `task_summary` object
  - `total_tasks` integer
  - `recent_runs` RunSummary[]
    - `run_type` string, nullable
    - `status` string, required
    - `created_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) - [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nanocorp/apis/nanocorp-api/revisions/291bb76b720b?raw)