Apply Ingest Credential
PUT/api/v1/orgs/:org/ingest-credentials/:credential
Create an ingest credential and mint its token, or change what it binds.
If-None-Match: * creates it and answers 201 with the token, once.
If-Match: <etag> updates its orgs, default org and listeners and keeps its
token. A credential id is unique across every org, so creating one another org
holds answers 409 credential_id_taken. A binding the receiver could not
hold answers 422 invalid_binding with a field error for each problem. A write
another one got to first answers 412 where its precondition no longer holds, else
409 conflict, and changes nothing.
Request
Responses
- 200
- 401
- 403
- 422
- default
Successful Response
No valid session: the credentials are missing, invalid or expired, or the account behind them is disabled or blocked
Refused: the session lacks the action this route checks, or its account must replace an issued password first. A SCIM route answers a refused action in the RFC 7644 error envelope
Validation Error
Problem details (RFC 9457)