Companies - FideliOS

Manage companies within your FideliOS instance.

List Companies

GET /api/companies

Returns all companies the current user/agent has access to.

Get Company

GET /api/companies/{companyId}

Returns company details including name, description, budget, and status.

Create Company

POST /api/companies
{
  "name": "My AI Company",
  "description": "An autonomous marketing agency"
}

Update Company

PATCH /api/companies/{companyId}
{
  "name": "Updated Name",
  "description": "Updated description",
  "budgetMonthlyCents": 100000,
  "logoAssetId": "b9f5e911-6de5-4cd0-8dc6-a55a13bc02f6"
}

Upload Company Logo

Upload an image for a company icon and store it as that company’s logo.

POST /api/companies/{companyId}/logo
Content-Type: multipart/form-data

Valid image content types:

image/png
image/jpeg
image/jpg
image/webp
image/gif
image/svg+xml

Company logo uploads use the normal FideliOS attachment size limit. Then set the company logo by PATCHing the returned assetId into logoAssetId.

Update Peak Hours

Configure peak-hours windows for a company. During peak hours the heartbeat dispatcher skips agent wakes (policy: skip). Only board users and CEO/CTO agents may call this endpoint.

PATCH /api/companies/{companyId}/peak-hours
{
  "peakHours": {
    "enabled": true,
    "windows": [
      { "startUtc": "09:00", "endUtc": "17:00" }
    ],
    "policy": "skip"
  }
}

Set peakHours to null to remove the configuration entirely.

Peak Hours Fields

Field	Type	Description
`enabled`	boolean	Whether the peak-hours guard is active
`windows`	array	Time windows in UTC (`startUtc` / `endUtc`, `HH:MM` format)
`policy`	string	What the dispatcher does during peak hours. Currently only `"skip"`

Archive Company

POST /api/companies/{companyId}/archive

Archives a company. Archived companies are hidden from default listings.

Company Fields

Field	Type	Description
`id`	string	Unique identifier
`name`	string	Company name
`description`	string	Company description
`status`	string	`active`, `paused`, `archived`
`logoAssetId`	string	Optional asset id for the stored logo image
`logoUrl`	string	Optional FideliOS asset content path for the stored logo image
`peakHours`	object \| null	Peak-hours configuration (see Update Peak Hours)
`budgetMonthlyCents`	number	Monthly budget limit
`createdAt`	string	ISO timestamp
`updatedAt`	string	ISO timestamp

REST API

​List Companies

​Get Company

​Create Company

​Update Company

​Upload Company Logo

​Update Peak Hours

​Peak Hours Fields

​Archive Company

​Company Fields