Upload an outcome

{ "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

Authorization

string

header

required

Source-bound WorkOS API key or configured machine OIDC token. OIDC webhook management requires karsa:webhooks:manage.

Headers

Idempotency-Key

string

required

Stable source submission identifier, unique for this source and route

Required string length: 1 - 200

Example:

"01J9ZQ2YD15Y2YZ5H0W3J7D3E2"

Body

application/json

externalId

string

required

Required string length: 1 - 200

effectiveAt

string<date-time>

required

outcomeType

string

required

Required string length: 1 - 200

outcomeValue

string

required

Required string length: 1 - 500

sourceExternalId

string | null

Required string length: 1 - 200

changeReason

string | null

Required string length: 1 - 500

customerId

string | null

Required string length: 1 - 200

accountId

string | null

Required string length: 1 - 200

transactionId

string | null

Required string length: 1 - 200

documentId

string | null

Required string length: 1 - 200

Response

A new immutable version was appended to an existing identity

outcome

enum<string>

required

Available options:

CREATED,

VERSION_CREATED

resourceId

string

required

Minimum string length: 1

versionId

string

required

Minimum string length: 1

currentVersionId

string | null

required

Minimum string length: 1

Customers

Verifications

Accounts

Documents

Transactions

Sources

Outcomes

Screening

Controls

Requests

Webhooks

Authorizations

Headers

Body

Response