Create Issuer
/extensions/roboinvestor/{graph_id}/operations/create-issuerPart of RoboInvestor.
Add a company the fund holds or follows that keeps its books elsewhere. The issuer is an entity in this graph: securities attach to it with create-security, and its reports with ingest-report. A company that shares a report in from its own graph gets its entity from the share, so it needs no issuer created here.
Idempotency: supply an Idempotency-Key header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
Authentication
Authenticate in any one of these ways — not all of them:
- API key in the
X-API-Keyheader. - Bearer token in the
Authorizationheader.
Path parameters
| Name | Type | Description |
|---|---|---|
graph_idrequired | string | Graph Id Constraints: matches |
Header parameters
| Name | Type | Description |
|---|---|---|
Idempotency-Keyoptional | string | Idempotency-Key |
Request body
Required, application/json.
| Field | Type | Description |
|---|---|---|
namerequired | string | The company's name. Constraints: at least 1 character |
legal_nameoptional | string | Its legal name, when different. |
leioptional | string | Legal Entity Identifier, if it has one. |
cikoptional | string | SEC Central Index Key, if it has one. |
tax_idoptional | string | Tax identifier (an EIN in the United States). |
entity_typeoptional | string | Legal form, e.g. |
industryoptional | string | Industry, as free text. |
websiteoptional | string | The company's website. |
Example request
curl -X POST "https://api.robosystems.ai/extensions/roboinvestor/{graph_id}/operations/create-issuer" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
-H "Idempotency-Key: <Idempotency-Key>" \
-H "Content-Type: application/json" \
-d '{
"legal_name": "Acme Company, Inc.",
"name": "Acme Co",
"tax_id": "12-3456789"
}'Responses
200 Successful Response
| Field | Type | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
operationrequired | string | Kebab-case operation name | ||||||||||||||||||||||||
operationIdrequired | string | op_-prefixed ULID for audit and SSE correlation | ||||||||||||||||||||||||
statusrequired | string | Operation lifecycle state One of: | ||||||||||||||||||||||||
resultoptional | IssuerResponse | Command-specific result payload IssuerResponse fields
| ||||||||||||||||||||||||
atrequired | string | ISO-8601 UTC timestamp | ||||||||||||||||||||||||
createdByoptional | string | User ID that initiated the operation | ||||||||||||||||||||||||
idempotentReplayoptional | boolean | True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions. Default: |
| Status | Meaning |
|---|---|
| 400 | Invalid request |
| 401 | Authentication required |
| 403 | Access denied |
| 404 | Resource not found |
| 409 | Idempotency-Key conflict — key reused with different body |
| 422 | Validation error |
| 429 | Rate limit exceeded |
| 500 | Internal server error |