Upload a screening disposition

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

screeningObservationId

string

required

Required string length: 1 - 200

sourceDisposition

string

required

Required string length: 1 - 200

normalizedDisposition

enum<string>

required

Available options:

CLOSED,

INVESTIGATE,

REQUEST_EVIDENCE,

ESCALATED,

REPORTED,

APPROVED,

REJECTED,

OTHER

reason

string

required

Required string length: 1 - 5000

actorExternalId

string

required

Required string length: 1 - 200

actorType

string

required

Required string length: 1 - 200

occurredAt

string<date-time>

required

effectiveAt

string<date-time>

required

providerDetails

object | null

Hide child attributes

providerDetails.{key}

any

Response

The identical source disposition already exists

outcome

enum<string>

required

Available options:

CREATED,

EXISTING

resourceId

string

required

Minimum string length: 1

observedAt

string<date-time>

required

Customers

Verifications

Accounts

Documents

Transactions

Sources

Outcomes

Screening

Controls

Requests

Webhooks

Authorizations

Headers

Body

Response