{
"outcome": "VERSION_CREATED",
"resourceId": "account_resource_example_01",
"versionId": "account_version_example_02",
"currentVersionId": "account_version_example_02"
}{
"type": "https://karsa.app/problems/invalid-request",
"title": "Ingestion Rejected",
"status": 400,
"detail": "The request did not match the ingestion schema",
"code": "INVALID_REQUEST",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/authentication-required",
"title": "Ingestion Rejected",
"status": 401,
"detail": "A source-bound bearer credential is required",
"code": "AUTHENTICATION_REQUIRED",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/resource-not-found",
"title": "Ingestion Rejected",
"status": 404,
"detail": "A referenced source resource was not found",
"code": "RESOURCE_NOT_FOUND",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/source-identity-conflict",
"title": "Ingestion Rejected",
"status": 409,
"detail": "The source identity is already bound",
"code": "SOURCE_IDENTITY_CONFLICT",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/future-effective-at",
"title": "Ingestion Rejected",
"status": 422,
"detail": "Future-effective scheduling is not supported",
"code": "FUTURE_EFFECTIVE_AT",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/rate-limited",
"title": "Ingestion Rejected",
"status": 429,
"detail": "The ingestion source exceeded its configured rate",
"code": "RATE_LIMITED",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/ingestion-internal-error",
"title": "Ingestion Unavailable",
"status": 500,
"detail": "The ingestion request could not be completed",
"code": "INGESTION_INTERNAL_ERROR",
"requestId": "req_example_01"
}Accounts
Update an account
Updates supplied mutable fields and appends a complete immutable account snapshot. Stable Karsa and source identifiers, accountKind, and accountType are not replaceable.
PUT
/
api
/
ingestion
/
accounts
/
{accountId}
{
"outcome": "VERSION_CREATED",
"resourceId": "account_resource_example_01",
"versionId": "account_version_example_02",
"currentVersionId": "account_version_example_02"
}{
"type": "https://karsa.app/problems/invalid-request",
"title": "Ingestion Rejected",
"status": 400,
"detail": "The request did not match the ingestion schema",
"code": "INVALID_REQUEST",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/authentication-required",
"title": "Ingestion Rejected",
"status": 401,
"detail": "A source-bound bearer credential is required",
"code": "AUTHENTICATION_REQUIRED",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/resource-not-found",
"title": "Ingestion Rejected",
"status": 404,
"detail": "A referenced source resource was not found",
"code": "RESOURCE_NOT_FOUND",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/source-identity-conflict",
"title": "Ingestion Rejected",
"status": 409,
"detail": "The source identity is already bound",
"code": "SOURCE_IDENTITY_CONFLICT",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/future-effective-at",
"title": "Ingestion Rejected",
"status": 422,
"detail": "Future-effective scheduling is not supported",
"code": "FUTURE_EFFECTIVE_AT",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/rate-limited",
"title": "Ingestion Rejected",
"status": 429,
"detail": "The ingestion source exceeded its configured rate",
"code": "RATE_LIMITED",
"requestId": "req_example_01"
}{
"type": "https://karsa.app/problems/ingestion-internal-error",
"title": "Ingestion Unavailable",
"status": 500,
"detail": "The ingestion request could not be completed",
"code": "INGESTION_INTERNAL_ERROR",
"requestId": "req_example_01"
}Authorizations
Source-bound WorkOS API key or configured machine OIDC token. OIDC webhook management requires karsa:webhooks:manage.
Headers
Stable source submission identifier, unique for this source and route
Required string length:
1 - 200Example:
"01J9ZQ2YD15Y2YZ5H0W3J7D3E2"
Path Parameters
Required string length:
1 - 200Body
application/json
Required string length:
1 - 500Required string length:
1 - 200Required string length:
1 - 200Hide child attributes
Hide child attributes
Required string length:
1 - 500Required string length:
1 - 200Maximum array length:
25Required string length:
1 - 200Maximum array length:
25Required string length:
1 - 200Hide child attributes
Hide child attributes
Required string length:
1 - 500Required string length:
1 - 200Required string length:
1 - 200Required string length:
1 - 500Hide child attributes
Hide child attributes
Required string length:
1 - 500Required string length:
1 - 500Required string length:
1 - 200Required string length:
1 - 200Required string length:
1 - 200Required string length:
1 - 200Hide child attributes
Hide child attributes
Required string length:
1 - 500Required string length:
1 - 500Required string length:
1 - 200Required string length:
1 - 200Required string length:
1 - 200Required string length:
1 - 200Hide child attributes
Hide child attributes
Available options:
NAICS, NACE, ISIC, MCC, OTHER Required string length:
1 - 500Required string length:
1 - 80Required string length:
1 - 500Hide child attributes
Hide child attributes
Required string length:
1 - 200Required string length:
1 - 500Required string length:
1 - 200Required string length:
1 - 500