> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aventure.vc/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aventure.vc/_mcp/server.

# Create entity operating status

POST https://api.aventure.vc/v1/entities/{entityId}/operating-status
Content-Type: application/json

Requires EntityMutation.operatingStatus plus ProvenanceSource query parameters. LLM-authored writes should send sourceType=llm, sourceDetail such as web-search:https://example.com/source, agentChassis, and agentModel. actorType is optional only at the HTTP/OpenAPI layer because the web boundary infers actorType=agent from that complete pair or actorType=employee from authenticated employee metadata before the domain factory and persistence write lane enforce actor context. Terminal statuses create numberOfEmployees=0 at asOfDate/default yesterday and deactivate website URLs. Closed and terminal Acquired do not deactivate attached person joins; those joins remain current because isCurrent describes the title association. The response emits PERSON_ASSOCIATION_END_DATE_RECOMMENDED and callers should update each attached person association endDate with a closing-date estimate.

Reference: https://docs.aventure.vc/api-reference/a-venture-api/entity-maintenance/create-operating-status

## Authentication

- `Authorization` header (bearer token, required) — User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key
- `X-API-Key` header (required) — Admin API key for system-to-system write operations

## Request

### Path parameters

- `entityId` (string, required) — Canonical entity UUID

### Query parameters

- `sourceType` (enum, required) — Write provenance source type.
  - Allowed values: `requestChangeForm`, `newsArticle`, `blogArticle`, `firstPartyWebsite`, `relatedPartyWebsite`, `thirdPartyWebsite`, `llm`, `aventureStaff`
- `sourceDetail` (string, required) — Source detail or reviewer reference for the write.
- `sourceProvider` (string, optional) — Provider name for provider-native IDs or slugs.
- `sourceProviderId` (string, optional) — Provider-native source ID.
- `sourceProviderSlug` (string, optional) — Provider-native source slug.
- `actorType` (enum, optional) — Actor type; inferred as agent when agentChassis and agentModel are supplied, or as employee from an authenticated user JWT session.
  - Allowed values: `agent`, `employee`
- `agentChassis` (string, optional) — Agent chassis token for agent-authored writes.
- `agentModel` (string, optional) — Agent model id for agent-authored writes.
- `asOfDate` (date, optional) — Terminal status date for the employee-count zero side effect. Person association endDate estimates are separate association writes.

### Body (application/json)

- `allowSuspectedShellStrip` (boolean, optional, nullable) — Allow intentional money-like text without a currency marker; prefer --from-file.
- `defaultCurrency` (string, optional, nullable) — Default operating currency.
- `foundedYear` (integer, optional, nullable) — Year founded.
- `nameAlias` (list of object, optional, nullable) — Alternative or former names used for search and display. When supplied, the list replaces existing aliases.
  - `name` (string, required) — Alternate name text
  - `displayable` (boolean, optional, nullable) — Show this alias in public name displays.
  - `type` (enum, optional, nullable) — Alias type classification
    - Allowed values: `alternativeDba`, `relatedLegal`
- `nameBrand` (string, optional, nullable) — Brand name. For Product or Service records, this must name a distinct offering and must not exactly match the joined provider entity. If an eponymous offering has no distinct product-line brand, use a descriptor/category such as Consumer Sedans or Light Industrial Vehicles instead.
- `nameLegal` (string, optional, nullable) — Legal name.
- `newSlug` (string, optional, nullable) — Preferred detail-update slug rename field. Omit on create; when slug is also sent both fields must normalize to the same value.
- `operatingStatus` (enum, optional, nullable) — Operating status. Required on create; omitted update values preserve existing status. Use Acquired Subsidiary when an acquired entity still operates; use Acquired only when it is terminal, folded, or closed. Closed and terminal Acquired keep attached person joins current; update association endDate separately with a closing-date estimate.
  - Allowed values: `Operating`, `Acquired`, `Acquired Subsidiary`, `Closed`, `Inactive`
- `slug` (string, optional, nullable) — Entity URL slug. Create may omit it when the server can derive one; detail updates may rename through this field or newSlug. Company-class slugs are one shared namespace and must end with the HQ location suffix (brand-city-state-country); a held slug returns 409. Product and Service slugs derive from nameBrand, stay scoped to the provider pair, and may repeat across providers; reusing a slug under the same provider or one held by a non-product entity returns 409.
- `status` (object, optional, nullable) — Visibility and verification flags; omitted update fields preserve existing values.
  - `isFeatured` (boolean, optional, nullable) — Set whether this entity is editorially featured
  - `isHidden` (boolean, optional, nullable) — Set whether this entity is hidden from public list and detail views. Create default is true when omitted.
  - `isVerified` (boolean, optional, nullable) — Set whether this entity has passed editorial verification
  - `showOnSitemap` (boolean, optional, nullable) — Set whether this entity is included in the public sitemap. Create default is false when omitted.
- `typeRecord` (string, optional, nullable) — Concrete entity type such as Company, Investment Firm, Product, or Service. Product and Service records always pair with a current productService provider relationship: creates write the join atomically via productServiceProviderId, the sole provider join cannot be removed or re-pointed, and moving an offering to a different provider means delete and recreate.

## Response

### 200

OK

- `allowSuspectedShellStrip` (boolean, optional, nullable) — Allow intentional money-like text without a currency marker; prefer --from-file.
- `defaultCurrency` (string, optional, nullable) — Default operating currency.
- `foundedYear` (integer, optional, nullable) — Year founded.
- `nameAlias` (list of object, optional, nullable) — Alternative or former names used for search and display. When supplied, the list replaces existing aliases.
  - `name` (string, required) — Alternate name text
  - `displayable` (boolean, optional, nullable) — Show this alias in public name displays.
  - `type` (enum, optional, nullable) — Alias type classification
    - Allowed values: `alternativeDba`, `relatedLegal`
- `nameBrand` (string, optional, nullable) — Brand name. For Product or Service records, this must name a distinct offering and must not exactly match the joined provider entity. If an eponymous offering has no distinct product-line brand, use a descriptor/category such as Consumer Sedans or Light Industrial Vehicles instead.
- `nameLegal` (string, optional, nullable) — Legal name.
- `newSlug` (string, optional, nullable) — Preferred detail-update slug rename field. Omit on create; when slug is also sent both fields must normalize to the same value.
- `operatingStatus` (enum, optional, nullable) — Operating status. Required on create; omitted update values preserve existing status. Use Acquired Subsidiary when an acquired entity still operates; use Acquired only when it is terminal, folded, or closed. Closed and terminal Acquired keep attached person joins current; update association endDate separately with a closing-date estimate.
  - Allowed values: `Operating`, `Acquired`, `Acquired Subsidiary`, `Closed`, `Inactive`
- `slug` (string, optional, nullable) — Entity URL slug. Create may omit it when the server can derive one; detail updates may rename through this field or newSlug. Company-class slugs are one shared namespace and must end with the HQ location suffix (brand-city-state-country); a held slug returns 409. Product and Service slugs derive from nameBrand, stay scoped to the provider pair, and may repeat across providers; reusing a slug under the same provider or one held by a non-product entity returns 409.
- `status` (object, optional, nullable) — Visibility and verification flags; omitted update fields preserve existing values.
  - `isFeatured` (boolean, optional, nullable) — Set whether this entity is editorially featured
  - `isHidden` (boolean, optional, nullable) — Set whether this entity is hidden from public list and detail views. Create default is true when omitted.
  - `isVerified` (boolean, optional, nullable) — Set whether this entity has passed editorial verification
  - `showOnSitemap` (boolean, optional, nullable) — Set whether this entity is included in the public sitemap. Create default is false when omitted.
- `typeRecord` (string, optional, nullable) — Concrete entity type such as Company, Investment Firm, Product, or Service. Product and Service records always pair with a current productService provider relationship: creates write the join atomically via productServiceProviderId, the sole provider join cannot be removed or re-pointed, and moving an offering to a different provider means delete and recreate.

## Examples

**Request**

```json
{}
```

**Response**

```json
{
  "allowSuspectedShellStrip": true,
  "defaultCurrency": "USD",
  "foundedYear": 2020,
  "nameAlias": [
    {
      "name": "Bun",
      "displayable": true,
      "type": "alternativeDba"
    }
  ],
  "nameBrand": "Spec Test Entity",
  "nameLegal": "Spec Test Entity LLC",
  "newSlug": "spec-test-entity-inc",
  "operatingStatus": "Operating",
  "slug": "spec-test-entity-llc",
  "status": {
    "isFeatured": true,
    "isHidden": true,
    "isVerified": true,
    "showOnSitemap": true
  },
  "typeRecord": "Company"
}
```

**SDK Code**

```python
import requests

url = "https://api.aventure.vc/v1/entities/entityId/operating-status"

querystring = {"actorType":"agent","agentChassis":"codex-cli","sourceDetail":"aventure.vc","sourceProvider":"TechCrunch","sourceProviderId":"tc-2026-05-20-example-round","sourceProviderSlug":"example-round","sourceType":"requestChangeForm"}

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers, params=querystring)

print(response.json())
```

```javascript
const url = 'https://api.aventure.vc/v1/entities/entityId/operating-status?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};

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

```go
package main

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

func main() {

	url := "https://api.aventure.vc/v1/entities/entityId/operating-status?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

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

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.aventure.vc/v1/entities/entityId/operating-status?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.aventure.vc/v1/entities/entityId/operating-status?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.aventure.vc/v1/entities/entityId/operating-status?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm', [
  'body' => '{}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.aventure.vc/v1/entities/entityId/operating-status?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.aventure.vc/v1/entities/entityId/operating-status?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```